Document revision date: 30 March 2001

## OpenVMS System Management Utilities Reference Manual

Previous | Contents | Index

## SHOW/ADAPTER (VAX Only)

> On VAX systems, displays all the nexus numbers and generic names on the adapter.

> Use of the SHOW/ADAPTER command requires the CMEXEC privilege.

### Format

> SHOW/ADAPTER

### Parameters

> None.

### Qualifiers

> None.

### Example

    SYSGEN>  SHOW/ADAPTER

> The following example is a sample display produced by the SYSGEN SHOW/ADAPTER command:

>     CPU Type: 11/780

>      Nexus Generic Name or Description
>        1   16K memory, non-interleaved
>        3   UB0
>        8   MB0
>        9   MB1

## SHOW/BUS (VAX Only)

> On VAX systems, displays all the nexus numbers and generic names on the adapter. On Alpha systems, use the SYSMAN command IO SHOW BUS.

> Use of the SHOW/BUS command requires the CMEXEC privilege.

### Format

> SHOW/BUS

### Parameters

> None.

### Qualifiers

> None.

## SHOW/CONFIGURATION (VAX Only)

> On VAX systems, displays information about the device configuration.

> Use of the SHOW/CONFIGURATION command requires the CMEXEC privilege.

### Format

> SHOW/CONFIGURATION

### Parameters

> None.

### Qualifiers

> #### /ADAPTER=nexus

> Specifies the number of MASSBUS or UNIBUS adapters to be displayed. The nexus value can be expressed as an integer or with one of the generic names listed by the SYSGEN command SHOW/ADAPTER.

> #### /COMMAND_FILE

> Specifies that SYSGEN formats all the device data into CONNECT/ADAPTER=adapter-spec commands and writes the commands in an output file you specify. In this way, you can completely reconfigure a system for UNIBUS devices without the use of the SYSGEN command AUTOCONFIGURE.

> #### /OUTPUT=file-spec

> Specifies the file specification of an optional output file. If you specify the /OUTPUT qualifier but omit the file type, the default is .LIS. However, if you specify the /COMMAND_FILE and /OUTPUT qualifiers together, the default file type for the output file is .COM.

### Description

> The SHOW/CONFIGURATION command shows devices by name, number of units, nexus number, and adapter type, as well as by control and status register (CSR) and vector addresses. You can specify an output file with the /OUTPUT qualifier.

> Note that you can remove a device from the middle of the floating addresses without completely redoing jumpers to the CSR and vector addresses of the remaining devices by following these steps:

> 1. Modify your site-independent STARTUP.COM file to invoke the command file specified with the /OUTPUT qualifier instead of entering an AUTOCONFIGURE ALL command.
> 2. Enter the SHOW/CONFIGURATION/COMMAND_FILE/OUTPUT command to format and save the device data. If you must bring the system down for service and remove a board, SYS$SYSTEM:STARTUP.COM invokes your output file as a command procedure when the system reboots, and the system automatically configures UNIBUS devices and MASSBUS devices for you.

> Remember that a new version of SYS$SYSTEM:STARTUP.COM is provided with each major release, so you would need to repeat any modifications you have made to SYS$SYSTEM:STARTUP.COM after you install the new version.

> Note Although this technique can offer a convenient short-term solution, use AUTOCONFIGURE ALL when possible.

###

#### Examples

#1
    SYSGEN> SHOW/CONFIGURATION

> This command displays the current system I/O database. The following example illustrates a typical display produced by this command on VS3100 and 6000-400 systems:

>      System CSR and Vectors on 23-OCT-2000 16:39:28.74
>      Name: OPA  Units: 1  Nexus:0    (410)
>      Name: PKB  Units: 1  Nexus:0    (410)
>      Name: TTA  Units: 4  Nexus:0    (410)
>      Name: PKA  Units: 1  Nexus:0    (410)
>      Name: ESA  Units: 3  Nexus:0    (410)
>      Name: GCA  Units: 1  Nexus:0    (410)

>      System CSR and Vectors on 23-OCT-2000 16:31:47.12
>      Name: PAA  Units: 1  Nexus:48   (CI )
>      Name: PAB  Units: 1  Nexus:64   (CI )
>      Name: PAC  Units: 1  Nexus:64   (CI )
>      Name: PAD  Units: 1  Nexus:176  (CI )
>      Name: FXA  Units: 2  Nexus:192  (GXM)
>      Name: ETA  Units: 3  Nexus:213  (BVP)
>      Name: PAE  Units: 1  Nexus:228  (CI )
>      Name: PBA  Units: 1  Nexus:237  (BVP)
>      Name: TXA  Units: 16 Nexus:211  (DMB)

#2
    SYSGEN> SHOW/CONFIGURATION/COMMAND_FILE/OUTPUT=CONFIG.COM

> This command formats all device data into CONNECT/ADAPTER=adapter-spec commands and writes the commands to the command file CONFIG.COM. The following example is a typical command file produced by this command:

>     $ RUN SYS$SYSTEM:SYSGEN
>     AUTOCONFIGURE 4
>     AUTOCONFIGURE 5
>     CONNECT DMA0 /ADAP=8 /CSR=%O777440 /VECT=%O210 /NUMV=01 /DRIVER=DMDRIVER
>     CONNECT DMA1 /ADAP=8 /CSR=%O777440 /VECT=%O210 /NUMV=01 /DRIVER=DMDRIVER
>     CONNECT LPA0 /ADAP=8 /CSR=%O777514 /VECT=%O200 /NUMV=01 /DRIVER=LPDRIVER
>     CONNECT DYA0 /ADAP=8 /CSR=%O777170 /VECT=%O264 /NUMV=01 /DRIVER=DYDRIVER
>     CONNECT DYA1 /ADAP=8 /CSR=%O777170 /VECT=%O264 /NUMV=01 /DRIVER=DYDRIVER
>     CONNECT XMA0 /ADAP=8 /CSR=%O760070 /VECT=%O300 /NUMV=02 /DRIVER=XMDRIVER
>     CONNECT XMB0 /ADAP=8 /CSR=%O760100 /VECT=%O310 /NUMV=02 /DRIVER=XMDRIVER
>     CONNECT XMC0 /ADAP=8 /CSR=%O760110 /VECT=%O320 /NUMV=02 /DRIVER=XMDRIVER
>     CONNECT TTA0 /ADAP=8 /CSR=%O760130 /VECT=%O330 /NUMV=02 /DRIVER=DZDRIVER
>     CONNECT TTA1 /ADAP=8 /CSR=%O760130 /VECT=%O330 /NUMV=02 /DRIVER=DZDRIVER
>     CONNECT TTA2 /ADAP=8 /CSR=%O760130 /VECT=%O330 /NUMV=02 /DRIVER=DZDRIVER
>     .
>     .
>     .
>     CONNECT TTF7 /ADAP=8 /CSR=%O760200 /VECT=%O400 /NUMV=02 /DRIVER=DZDRIVER

## SHOW/DEVICE (VAX Only)

> On VAX systems, displays full information about 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 Alpha systems, use the SYSMAN command IO SHOW DEVICE.

> Use of the SHOW/DEVICE command requires the CMEXEC privilege.

### Format

> SHOW/DEVICE =device-driver

### Parameters

> None.

### Qualifiers

> None.

### Description

> The SHOW/DEVICE command specifies that the following information be displayed about the specified device driver:

> Driver | Name of the driver
> Start | Starting address of the driver
> End | Ending address 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

> By default, if you omit the driver name, information is displayed for all device drivers loaded into the system.

### Example

    SYSGEN>  SHOW/DEVICE=DBDRIVER

> This command displays the following information about the DBDRIVER:

>     __Driver_____Start____End____Dev___DDB______CRB______IDB_____Unit__UCB___
>     DBDRIVER   80082390 80082A7E
>                                  DBA 80000848 800988C0 80098920
>                                                                   0 8000087C
>                                                                   1 8008A4F0
>                                                                   2 8008A590
>                                                                   5 8008A630
>                                                                   7 8008A6D00

## SHOW/DRIVER (VAX Only)

> On VAX systems, displays the starting and ending address of the specified device driver loaded into the system.

### Format

> SHOW/DRIVER =device-driver

### Parameters

> None.

### Qualifiers

> None.

### Description

> If you omit the driver name, SHOW/DRIVER displays the starting and ending address of all device drivers loaded into the system. All addresses are in hexadecimal and are virtual.

> Use of the SHOW/DRIVER command requires the CMEXEC privilege.

> The SHOW/DRIVER command displays the following information about the specified device driver:

> Driver | Name of the device driver
> Start | Starting address of the device driver
> End | Ending address of the device driver

### Example

    SYSGEN>  SHOW/DRIVER

> This command displays the starting and ending addresses of all drivers, as follows:

>     __Driver_____Start____End___
>     RTTDRIVER  800C1060 800C1960
>     NETDRIVER  800BAFD0 800BD4B0
>     TMDRIVER   800B3950 800B4BF0
>     DRDRIVER   800B2950 800B3290
>     DDDRIVER   800B1740 800B2060
>     DLDRIVER   800B0D10 800B15A0
>     DMDRIVER   800B0070 800B0990
>     LCDRIVER   800AFC50 800AFFB0
>     YCDRIVER   800AED20 800AF3E0
>     XGDRIVER   800AC3F0 800AE9E0
>     XDDRIVER   800AA5A0 800AC380
>     DZDRIVER   800A4F30 800A59B0
>     XMDRIVER   800A3E10 800A4A50
>     DYDRIVER   800A3300 800A3C30
>     LPDRIVER   800A2E90 800A3300
>     DBDRIVER   800DE7A0 800DEFB7
>     TTDRIVER   800DC770 800DE79B
>     OPERATOR   80001650 80001F8B
>     NLDRIVER   80001626 80001D20
>     MBDRIVER   800015FC 80001CBE

## SHOW/STARTUP

> Displays the name of the current site-independent startup command procedure.

### Format

> SHOW/STARTUP

### Parameters

> None.

### Qualifiers

> None.

### Example

    SYSGEN>  SHOW/STARTUP
    Startup command file = SYS$SYSTEM:STARTUP.COM

> This command displays the name of the site-independent startup command procedure.

## SHOW/TURBOCHANNEL (VAX Only)

> On VAX systems, displays the nexus number of a device on the TURBOchannel.

### Format

> SHOW/TURBOCHANNEL

### Parameters

> None.

### Qualifiers

> None.

### Example

    SYSGEN>  SHOW/TURBOCHANNEL

> The following example is a sample display produced by the SHOW/TURBOCHANNEL command:

>     TURBOCHANNEL: Device Name       Nexus Number        TC Slot
>                   PMAQT-AA          00000000            00000001

## SHOW/UNIBUS (VAX Only)

> On VAX systems, displays the addresses in UNIBUS I/O space that can be addressed.

> Use of the SHOW/UNIBUS command requires the CMKRNL privilege.

### Format

> SHOW/UNIBUS

### Parameters

> None.

### Qualifier

> #### /ADAPTER=nexus

> Specifies that the address of the specified UNIBUS adapter is to be displayed. The nexus value specifies the number of the UNIBUS adapter. It can be expressed as an integer or as one of the names listed by the SYSGEN command SHOW/ADAPTER.

### Description

> The SHOW/UNIBUS command reads all device registers. For some controllers, the result might be reading a character out of a buffer or some other undesired action. Therefore, use the SHOW/UNIBUS command only when you debug a UNIBUS configuration. On a system with more than one UNIBUS adapter, the command shows only the address of the first UNIBUS adapter.

> Note Never use the SHOW/UNIBUS command on a running system. Use of this command is valid only during a conversational bootstrap.

### Example

    SYSGEN>  SHOW/UNIBUS/ADAPTER=4

> This command displays the available addresses for nexus 4, as follows:

>     **UNIBUS map for nexus #4 on 30-JUN-2000  14:19:38.00 **

>     Address 760070 (8001F838) responds with value 9B6E (hex)
>     Address 760072 (8001F83A) responds with value 0340 (hex)
>     Address 760074 (8001F83C) responds with value 403C (hex)
>     Address 760076 (8001F83E) responds with value 0240 (hex)
>     Address 760100 (8001F840) responds with value 8000 (hex)
>     Address 760102 (8001F842) responds with value 0340 (hex)
>     Address 760104 (8001F844) responds with value 7DAC (hex)
>     Address 760106 (8001F846) responds with value 000A (hex)
>     Address 760110 (8001F848) responds with value 8000 (hex)
>     Address 760112 (8001F84A) responds with value 0340 (hex)
>     Address 760114 (8001F84C) responds with value AD5C (hex)
>     Address 760116 (8001F84E) responds with value 000A (hex)
>     Address 760130 (8001F858) responds with value 9B6E (hex)
>     Address 760132 (8001F85A) responds with value 030D (hex)
>     Address 760134 (8001F85C) responds with value FF00 (hex)
>     Address 760136 (8001F85E) responds with value CECE (hex)
>     Address 760140 (8001F860) responds with value 4060 (hex)
>     Address 760142 (8001F862) responds with value 0761 (hex)
>     Address 760144 (8001F864) responds with value FF00 (hex)
>     .
>     .
>     .

## TERMINAL

> Modifies the Ctrl/C, Ctrl/O, Ctrl/Y, and Ctrl/Z echo strings on a systemwide basis.

### Format

> TERMINAL/ECHO

### Parameters

> None.

### Qualifiers

> None.

### Description

> Before entering the TERMINAL command, edit the file SYSGTTSTR.MSG in SYS$EXAMPLES. The file contains detailed instructions for the editing procedure.

> When you enter the TERMINAL command after editing the file, the modifications you have specified are carried out.

## USE

> Initializes the SYSGEN work area with system parameter values and the name of the site-independent startup command procedure, overwriting existing values. The initial values of the SYSGEN work area when the utility is invoked are the active values.

> Specify the source for both the parameter values and the procedure name. They can be retrieved from a parameter file, the current system parameter file on disk, the active system in memory, or the default list.

### Format

> USE file-spec

### Parameter

> #### file-spec

> The file specification of a system parameter file from which data is to be retrieved. You can use the SYSGEN command WRITE to create the parameter file. The default file type is .PAR.

> In place of a file specification, you can specify one of the following keywords:

> > #### CURRENT

> > Specifies that source information is to be retrieved from the current system parameter file on disk.

> > On VAX systems, the system parameter file is SYS$SYSTEM:VAXVMSSYS.PAR.

> > On Alpha systems, the system parameter file is SYS$SYSTEM:ALPHAVMSSYS.PAR.

> > #### ACTIVE

> > Specifies that source information is to be retrieved from the active system in memory.

> > #### DEFAULT

> > Specifies that source information is to be retrieved from the default list. The USE DEFAULT command initializes the SYSGEN work area with parameter values that are built into SYSGEN; these values allow the operating system to boot on any standard configuration.

> > To avoid starting all layered products on a system that is not tuned for them, possibly causing the system to hang, set the STARTUP_P1 system parameter as follows:

> >     SYSGEN> SET STARTUP_P1 "MIN"

### Qualifiers

> None.

###

#### Examples

#1
    SYSGEN> USE SYS$SYSTEM:SPECIAL

> This command uses the existing parameter file SYS$SYSTEM:SPECIAL.PAR.

#2
    SYSGEN> USE DEFAULT

    SYSGEN> SET STARTUP_P1 "MIN"

> The first command initializes the SYSGEN work area with default parameter values. The second command sets the STARTUP_P1 system parameter to "minimum."

## WRITE

> Writes the system parameter values and the name of the site-independent startup command procedure from the SYSGEN work area to a parameter file, the current system parameter file on disk, or the active system in memory.

### Format

> WRITE file-spec

### Parameter

> #### file-spec

> The file specification of a new parameter file to be created. The default file type is .PAR.

> In place of a file specification, you can specify one of the following keywords:

> > #### CURRENT

> > Specifies that source information is to be written to the current system parameter file on disk.

> > On VAX systems, the system parameter file is SYS$SYSTEM:VAXVMSSYS.PAR.

> > On Alpha systems, the system parameter file is SYS$SYSTEM:ALPHAVMSSYS.PAR.

> > Use of the WRITE CURRENT command requires the SYSPRV privilege.

> > #### ACTIVE

> > Specifies that source information is to be written to the active system in memory. (Only the dynamic parameter values are written to the active system.)

> > Use of the WRITE ACTIVE command requires the CMKRNL privilege.

### Qualifiers

> None.

### Description

> On VAX systems, the implementation of security auditing within SYSGEN has altered the reporting of modifications to the system parameter file VAXVMSSYS.PAR. System managers can receive notification of a change to the file by setting up an access control list (ACL) on the file to signal such an event, as in the following example:

>     $ SET SECURITY/ACL=(ALARM=SECURITY,ACCESS=WRITE+FAILURE+SUCCESS)-
>     _$ SYS$SYSTEM:VAXVMSSYS.PAR

> For more information about setting ACLs, refer to the OpenVMS User's Manual and the OpenVMS Guide to System Security.

> On Alpha systems, both the WRITE ACTIVE and WRITE CURRENT commands send a message to OPCOM and log the event.

###

#### Examples

#1
    SYSGEN> WRITE SYS$SYSTEM:SPECIAL

> This command creates a new parameter specification file, SYS$SYSTEM:SPECIAL.PAR.

#2
    SYSGEN> WRITE CURRENT

> On VAX systems, this command modifies the current system parameter file on disk, VAXVMSSYS.PAR.

> On Alpha systems, this command modifies the current system parameter file on disk, ALPHAVMSSYS.PAR.

Previous | Next | Contents | Index

| privacy and legal statement |
6048PRO_063.HTML