[Digital logo]
[HR]

OpenVMS System Management Utilities Reference Manual


Previous | Contents

IO CONNECT (Alpha Only)

On Alpha systems, connects a hardware device and loads its driver, if the driver is not already loaded. On VAX systems, use the SYSGEN command CONNECT.

You must have CMKRNL and SYSLCK privileges to use the IO CONNECT command.


Format

IO CONNECT device-name[:]


PARAMETERS

device-name[:]

Specifies the name of the hardware device to be connected. The device name requires the following format:
    device-type controller unit-number 

For example, in the designation LPA0, LP is a line printer on controller A at unit number 0. If you use the /NOADAPTER qualifier, the device is the software to be loaded.


QUALIFIERS

/ADAPTER=tr_number
/NOADAPTER (default)

Specifies the nexus number of the adapter to which the specified device is connected. It is a nonnegative 32-bit integer. The /NOADAPTER qualifier indicates that the device is not associated with any particular hardware. The /NOADAPTER qualifier is compatible with the /DRIVER_NAME qualifier only.

/CSR=csr_address

Specifies the CSR address for the device being configured. This address must be specified in hexadecimal. You must precede the CSR address with %X. The CSR address is a quadword value that is loaded into IDB$Q_CSR without any interpretation by SYSMAN. This address can be physical or virtual, depending on the specific device being connected:

This qualifier is required if /ADAPTER=tr_number is specified.

/DRIVER_NAME=filespec

Specifies the name of the device driver that you are loading. If you do not specify this qualifier, SYSMAN obtains the default in the same way that the SYSGEN default name is determined. For example, if you want to load the Digital-supplied SYS$ELDRIVER.EXE, the prefix SYS$ must be present. Without the SYS$, SYSMAN looks for ELDRIVER.EXE in SYS$LOADABLE_IMAGES. This implementation separates the user device driver namespace from the Digital-supplied device driver namespace.

/LOG=(ALL,CRB,DDB,DPT,IDB,SB,UCB)
/NOLOG (default)

Controls whether SYSMAN displays the addresses of the specified control blocks. The default value for the /LOG qualifier is /LOG=ALL. If /LOG=UCB is specified, a message similar to the following is displayed:
%SYSMAN-I-IOADDRESS, the UCB is located at address 805AB000 

/MAX_UNITS=maximum-number-of-units

Specifies the maximum number of units the driver can support. The default is specified in the driver prologue table (DPT) of the driver. If the number is not specified in the DPT, the default is 8. This number must be greater than or equal to the number of units specified by /NUM_UNITS. This qualifier is optional.

/NUM_UNITS=number-of-units

Specifies the number of units to be created. The starting device number is the number specified in the device name parameter. For example, the first device in DKA0 is 0. Subsequent devices are numbered sequentially. The default is 1. This qualifier is optional.

/NUM_VEC=vector-count

Specifies the number of vectors for this device. The default vector count is 1. The /NUM_VEC qualifier is optional. This qualifier should be used only when using the /VECTOR_SPACING qualifier. When using the /NUM_VEC qualifier, you must also use the /VECTOR qualifier to supply the base vector.

/SYS_ID=number-of-remote-system

Indicates the SCS system ID of the remote system to which the device is to be connected. It is a 64-bit integer; you must specify the remote system number in hexadecimal. The default is the local system. This qualifier is optional.

/VECTOR=(vector-address,...)

Specifies the interrupt vectors for the device or lowest vector. This is either a byte offset into the SCB of the interrupt vector for directly vectored interrupts or a byte offset into the ADP vector table for indirectly vectored interrupts. The values must be longword aligned. To specify the vector address in octal or hexadecimal, precede the address with %O or %X, respectively. The /VECTOR qualifier is required when you use the /ADAPTER=tr_number qualifier or the /NUM_VEC=vector-count qualifier. You can list up to 64 vectors.

/VECTOR_SPACING=number-of-bytes-between-vectors

Specifies the spacing between vectors. Specify the amount as a multiple of 16 bytes. The default is 16. You must specify both the base vector with /VECTOR and the number of vectors with /NUM_VEC. This qualifier is optional.

DESCRIPTION

The IO CONNECT command connects a hardware device and loads its driver, if the driver is not already loaded. VAX system managers use the SYSGEN command CONNECT. You must have CMKRNL and SYSLCK privileges to use the IO CONNECT command.

Examples

  1. SYSMAN> IO CONNECT DKA0:/DRIVER_NAME=SYS$DKDRIVER/CSR=%X80AD00- 
    /ADAPTER=4/NUM_VEC=3/VECTOR_SPACING=%X10/VECTOR=%XA20/LOG 
     
    %SYSMAN-I-IOADDRESS, the CRB is located at address 805AEC40 
    %SYSMAN-I-IOADDRESS, the DDB is located at address 805AA740 
    %SYSMAN-I-IOADDRESS, the DPT is located at address 80D2A000 
    %SYSMAN-I-IOADDRESS, the IDB is located at address 805AEE80 
    %SYSMAN-I-IOADDRESS, the SB is located at address 80417F80 
    %SYSMAN-I-IOADDRESS, the UCB is located at address 805B68C0 
    

    The command in this example connects device DKA0, loads driver SYS$DKDRIVER, and specifies the following:
    The /LOG qualifier displays the addresses of all control blocks, as shown.
  2. SYSMAN> IO CONNECT DKA0:/DRIVER_NAME=SYS$DKDRIVER/CSR=%X80AD00- 
    /ADAPTER=4/VECTOR=(%XA20,%XA30,%XA40)/LOG=(CRB,DPT,UCB) 
     
    %SYSMAN-I-IOADDRESS, the CRB is located at address 805AEC40 
    %SYSMAN-I-IOADDRESS, the DPT is located at address 80D2A000 
    %SYSMAN-I-IOADDRESS, the UCB is located at address 805B68C0 
    

    The command in this example connects device DKA0, loads driver SYS$DKDRIVER, and specifies the following:
    The /LOG qualifier displays the addresses of the channel request block (CRB), the driver prologue table (DPT), and the unit control block (UCB).
  3. SYSMAN> IO CONNECT FTA0:/DRIVER=SYS$FTDRIVER/NOADAPTER/LOG=(ALL) 
     
    %SYSMAN-I-IOADDRESS, the CRB is located at address 805AEC40 
    %SYSMAN-I-IOADDRESS, the DDB is located at address 805AA740 
    %SYSMAN-I-IOADDRESS, the DPT is located at address 80D2A000 
    %SYSMAN-I-IOADDRESS, the IDB is located at address 805AEE80 
    %SYSMAN-I-IOADDRESS, the SB is located at address 80417F80 
    %SYSMAN-I-IOADDRESS, the UCB is located at address 805B68C0 
    

    The command in this example connects pseudoterminal FTA0, loads driver SYS$FTDRIVER, and uses the /NOADAPTER qualifier to indicate that FTA0 is not an actual hardware device. The /LOG=(ALL) qualifier displays the addresses of all control blocks, as shown.

    For more information about loading and configuing device drivers, refer to Writing OpenVMS Alpha Device Drivers in C.


    IO LOAD (Alpha Only)

    On Alpha systems, loads an I/O driver. On VAX systems, use the SYSGEN command LOAD.

    You must have CMKRNL and SYSLCK privileges to use the IO LOAD command.


    Format

    IO LOAD filespec


    PARAMETERS

    filespec

    Specifies the file name of the driver to be loaded. This parameter is required.

    QUALIFIERS

    /LOG=(ALL,DPT)

    Controls whether SYSMAN displays information about drivers that have been loaded. The default value for the /LOG qualifier is /LOG=ALL. The driver prologue table (DPT) address is displayed when either /LOG=DPT or /LOG=ALL is specified.

    DESCRIPTION

    The IO LOAD command loads an I/O driver. VAX system managers use the SYSGEN command LOAD. You must have CMKRNL and SYSLCK privileges to use the IO LOAD command.

    Example

    SYSMAN> IO LOAD/LOG SYS$DKDRIVER
    %SYSMAN-I-IOADDRESS, the DPT is located at address 80D5A000
    

    This example loads device SYS$DKDRIVER and displays the address of the driver prologue table (DPT).


    IO REBUILD (Alpha Only)

    On Alpha systems, rebuilds device configuration tables in preparation for using the IO AUTOCONFIGURE command to reconfigure the system.

    You must have CMKRNL privilege to use the IO REBUILD command.


    Format

    IO REBUILD


    PARAMETERS

    None.

    QUALIFIERS

    /VERIFY

    Causes SYSMAN to read and process the files SYS$SYSTEM:SYS$USER_CONFIG.DAT and SYS$SYSTEM:CONFIG.DAT, but not to apply the files to the I/O database. Messages will be displayed for any errors that are encountered. This command can be used by developers to test new changes to SYS$SYSTEM:SYS$USER_CONFIG.DAT without modifying the current system.

    DESCRIPTION

    The IO REBUILD command rebuilds the system's device configuration tables by reading and parsing the SYS$SYSTEM:SYS$USER_CONFIG.DAT and SYS$SYSTEM:SYS$CONFIG.DAT files.

    To debug modifications to the SYS$SYSTEM:SYS$USER_CONFIG.DAT file, you can use the IO REBUILD and IO AUTOCONFIGURE commands to load drivers without having to reboot. Once you load a driver for an adapter, however, you cannot reload it without rebooting the system.


    Example

    SYSMAN> IO REBUILD
    SYSMAN>  IO AUTOCONFIGURE
     
    

    The first command in this example rebuilds device configuration tables. The second command reads the device configuration tables and loads drivers for newly defined drivers.


    IO SET EXCLUDE (Alpha Only)

    On Alpha systems, sets the permanent exclusion list to be used when configuring devices automatically.

    Format

    IO SET EXCLUDE = (device_name)


    PARAMETERS

    (device_name)

    Specifies the device type to be excluded from automatic configuration. Use valid device names or mnemonics that indicate the devices to be included in the permanent exclusion list. You can specify wildcards.

    QUALIFIERS

    None.

    DESCRIPTION

    Sets the permanent exclusion list to be used when configuring devices.

    Example

    SYSMAN> IO SET EXCLUDE=(DKC500,DKD*)
    

    This example specifies that DKC500 and all DKD devices are not to be autoconfigured.

    Refer to the /SELECT qualifier for additional examples that show how to specify device names.


    IO SET PREFIX (Alpha Only)

    On Alpha systems, sets the prefix list that is used to manufacture the IOGEN Configuration Building Module (ICBM) names.

    Format

    IO SET PREFIX =icbm_prefix


    PARAMETERS

    icbm_prefix

    Specifies ICBM prefixes. These prefixes are used by the IO AUTOCONFIGURE command to build ICBM image names.

    QUALIFIERS

    None.

    DESCRIPTION

    The IO SET PREFIX command sets the prefix list which is used to manufacture ICBM names.

    Example

    SYSMAN> IO SET PREFIX=(SYS$,PSI$,VME_)
    

    This example specifies the prefix names used by IO AUTOCONFIGURE to build the ICBM names. The prefixes are SYS$, PSI$, and VME_.


    IO SHOW BUS (Alpha Only)

    On Alpha systems, lists all the buses, node numbers, bus names, TR numbers, and base CSR addresses on the system. This display exists primarily for internal engineering support. On VAX systems, use the SYSGEN command SHOW/BUS.

    PARAMETERS

    None.

    QUALIFIERS

    None.

    DESCRIPTION

    The IO SHOW BUS command lists all the buses, node numbers, bus names, TR numbers, and base CSR addresses. This display exists primarily for internal engineering support. You must have CMKRNL privilege to use IO SHOW BUS.

    Example

    SYSMAN> IO SHOW BUS
    _Bus__________Node_TR#__Name____________Base CSR__________ 
    LSB           0    1    EV3 4MB        FFFFFFFF86FA0000 
    LSB           6    1    MEM            FFFFFFFF86FC4000 
    LSB           7    1    MEM            FFFFFFFF86FCA000 
    LSB           8    1    IOP            FFFFFFFF86FD0000 
        XZA XMI-SCSI  0    3    XZA-SCSI       0000008001880000 
        XZA XMI-SCSI  1    3    XZA-SCSI       0000008001880000 
        XZA XMI-SCSI  0    4    XZA-SCSI       0000008001900000 
        XZA XMI-SCSI  1    4    XZA-SCSI       0000008001900000 
      XMI           4    2    LAMB           0000008001A00000 
        DEMNA         0    5    Generic XMI    0000008001E80000 
        DEMNA         0    6    Generic XMI    0000008001F00000 
    

    This example is from a DEC 7000 Model 600. Displays vary among different Alpha systems.

    The indentation levels are deliberate in this display. They indicate the hierarchy of the adapter control blocks in the system. The column titles in the display have the following meanings:

    Column Titles Meaning
    Bus Identity of the bus
    Node Index into the associated bus array; the bus slot
    TR# Nexus number of the adapter to which the specified device is connected
    Name Name of the device
    Base CSR Base CSR address of the device

    On Alpha systems, you can use the SDA command CLUE CONFIG to display additional information including hardware adapters and devices. This command is documented in the OpenVMS Alpha System Dump Analyzer Utility Manual.

    For more information about loading and configuing device drivers, refer to Writing OpenVMS Alpha Device Drivers in C.


    IO SHOW DEVICE (Alpha Only)

    On Alpha systems, displays information on device drivers loaded into the system, the devices connected to them, and their I/O databases. All addresses are in hexadecimal and are virtual. On VAX systems, use the SYSGEN command SHOW/DEVICE.

    Format

    IO SHOW DEVICE


    PARAMETERS

    None.

    QUALIFIERS

    None.

    DESCRIPTION

    The IO SHOW DEVICE command displays information on the device drivers loaded into the system, the devices connected to them, and their I/O databases.

    The IO SHOW DEVICE command specifies that the following information be displayed about the specified device driver:
    Driver Name of the driver
    Dev Name of each device connected to the driver
    DDB Address of the device's device data block
    CRB Address of the device's channel request block
    IDB Address of the device's interrupt dispatch block
    Unit Number of each unit on the device
    UCB Address of each unit's unit control block

    All addresses are in hexadecimal and are virtual.

    Refer to A Comparison of System Management on OpenVMS AXP and OpenVMS VAX¹ and the OpenVMS System Manager's Manual for additional information about SYSMAN.


    Example

    SYSMAN> IO SHOW DEVICE
    

    The following is a sample display produced by the IO SHOW DEVICE command:

    __Driver________Dev_DDB______CRB______IDB______Unit_UCB_____ 
    SYS$FTDRIVER    
                    FTA 802CE930 802D1250 802D04C0 
                                                     0 801C3710 
    SYS$EUDRIVER    
                    EUA 802D0D80 802D1330 802D0D10 
                                                     0 801E35A0 
    SYS$DKDRIVER    
                    DKI 802D0FB0 802D0F40 802D0E60 
                                                     0 801E2520 
    SYS$PKADRIVER   
                    PKI 802D1100 802D13A0 802D1090 
                                                     0 801E1210 
    SYS$TTDRIVER    
    OPERATOR        
    NLDRIVER        
    

    SYS$TTDRIVER, OPERATOR, and NLDRIVER do not have devices associated with them.


    Note

    ¹ This manual has been archived but is available in PostScript and DECW$BOOK (Bookreader) formats on the OpenVMS Documentation CD-ROM. A printed book can be ordered through DECdirect (800-354-4825).


    IO SHOW EXCLUDE (Alpha Only)

    On Alpha systems, displays the permanent exclusion list used in the autoconfiguration of devices.

    Format

    IO SHOW EXCLUDE


    PARAMETERS

    None.

    QUALIFIERS

    None.

    DESCRIPTION

    The IO SHOW EXCLUDE command displays the permanent exclusion list on the console. This list is used in the autoconfiguration of devices.

    Example

    SYSMAN> IO SHOW EXCLUDE
    %SYSMAN-I-IOEXCLUDE, the current permanent exclusion list is: DKC500,DKD*
    

    This example shows the permanent exclusion list used in the autoconfiguration of devices; the current list contains DKC500 and all DKD devices.


    IO SHOW PREFIX (Alpha Only)

    On Alpha systems, displays the current prefix list used in the manufacture of IOGEN Configuration Building Module (ICBM) names.

    Format

    IO SHOW PREFIX


    PARAMETERS

    None.

    QUALIFIERS

    None.

    DESCRIPTION

    The IO SHOW PREFIX command displays the current prefix list on the console. This list is used by the IO AUTOCONFIGURE command to build ICBM names.

    Example

    SYSMAN> IO SHOW PREFIX
    %SYSMAN-I-IOPREFIX, the current prefix list is: SYS$,PSI$,VME_
    

    This example shows the prefixes used by IO AUTOCONFIGURE to build ICBM names.


    LICENSE LOAD

    Activates licenses registered in the LICENSE database.

    Requires CMKRNL, SYSNAM, and SYSPRV privileges.


    Note

    Except for the number of status messages returned, the following commands are functionally equivalent:
    SYSMAN> LICENSE LOAD
    $ LICENSE LOAD
    

    To see all the status messages on remote nodes for the DCL command, you can use the following SYSMAN command:

    SYSMAN> DO LICENSE LOAD
    


    Format

    LICENSE LOAD product


    PARAMETER

    product

    Specifies the name of the product whose license you want to activate.

    QUALIFIERS

    /DATABASE=filespec

    Specifies the location of the LICENSE database. The default file specification is SYS$COMMON:[SYSEXE]LMF$LICENSE.LDB. Using the /DATABASE qualifier is not necessary if you use the default LICENSE database name and location.

    /PRODUCER=string

    Specifies the name of the company that owns the product for which you have a license. Use this qualifier only if the product is from a company other than Digital.

    DESCRIPTION

    You can use the LICENSE LOAD command to activate licenses on multiple systems and on nonlocal systems in the system management environment. The SYSMAN LICENSE commands are a subset of the License Management Facility (LMF) commands. For more information about the LMF, see the OpenVMS License Management Utility Manual.

    Example

    SYSMAN> LICENSE LOAD FORTRAN 
    

    This example activates the license for Digital Fortran for OpenVMS. Because the license is for a Digital product, the command does not include the /PRODUCER qualifier.


    LICENSE UNLOAD

    Deactivates licenses registered in the LICENSE database.

    Requires CMKRNL, SYSNAM, and SYSPRV privileges.


    Format

    LICENSE UNLOAD [product]


    PARAMETER

    product

    Specifies the name of the product whose license you want to deactivate. If you enter the LICENSE UNLOAD command without specifying a product name, the system deactivates all available registered licenses.

    QUALIFIER

    /PRODUCER=string

    Specifies the name of the company that owns the product for which you have a license. Use this qualifier only if the product is from a company other than Digital.

    DESCRIPTION

    You can use the LICENSE UNLOAD command to deactivate licenses on multiple systems and on nonlocal systems in the system management environment. The SYSMAN LICENSE commands are a subset of the License Management Facility (LMF) commands. For more information about the LMF, see the OpenVMS License Management Utility Manual.

    Example

    SYSMAN> LICENSE UNLOAD FORTRAN 
    

    This command deactivates the license for DEC Fortran for OpenVMS. Because the license is for a Digital product, the command does not include the /PRODUCER qualifier.


    PARAMETERS DISABLE CHECKS

    Bypasses validation of parameter values. SYSMAN parameter validation ensures that the parameters fall within the defined minimum and maximum values specified in the PARAMETERS SET command.

    Format

    PARAMETERS DISABLE CHECKS


    PARAMETERS

    None.

    QUALIFIERS

    None.

    DESCRIPTION

    The PARAMETERS DISABLE CHECKS command enables you to override minimum and maximum values established for system parameters. SYSMAN does parameter checks by default. If you attempt to set parameter values outside the allowable limits when checks are enabled, the operating system issues an error message. By disabling checks you can set parameter values regardless of the minimum and maximum limits.

    Note

    Range checks are enabled by default because Digital suggests that systems operate within these minimum and maximum values. Setting parameters outside these limits can result in system failures or hangs.


    Example

    SYSMAN> SET ENVIRONMENT/CLUSTER
    SYSMAN> SET PROFILE/DEFAULT=SYS$SYSTEM/PRIVILEGES=CMEXEC 
    SYSMAN> PARAMETERS SET MAXPROCESSCNT 10
    %SMI-E-OUTRANGE, parameter is out of range 
    SYSMAN> PARAMETERS DISABLE CHECKS
    SYSMAN> PARAMETERS SET MAXPROCESSCNT 10 
    

    In this example, the initial attempt to set MAXPROCESSCNT below the minimum fails because range checks are enabled. However, once range checks are disabled, the PARAMETERS SET MAXPROCESSCNT command succeeds.


    Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]

    [HR]

      6048P055.HTM
      OSSG Documentation
      26-NOV-1996 12:43:43.95
    

    Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

    Legal