 |
HP OpenVMS System Management Utilities Reference
Manual
SET/STARTUP
Names the site-independent startup command procedure to be associated
with a parameter file for subsequent bootstrap operations.
Format
SET/STARTUP file-spec
Parameter
file-spec
The file specification of a startup command procedure on the system
disk (maximum of 31 characters). The initial site-independent startup
command procedure (as named in the software distribution kit) is
SYS$SYSTEM:STARTUP.COM.
Example
|
SYSGEN> SET/STARTUP SYS$SYSTEM:XSTARTUP.COM
|
This command assigns SYS$SYSTEM:XSTARTUP.COM as the current
site-independent startup command procedure.
SHARE (VAX Only)
On VAX systems, connects a processor to a multiport memory unit already
initialized by this or another processor. The number and name of the
specified multiport memory unit must be those of an initialized unit,
or an error condition results.
Use of the SHARE command requires the CMKRNL privilege.
Format
SHARE MPMn MPM-name
Parameters
MPMn
Specifies the number on the front panel of the multiport memory unit
being connected.
MPM-name
Specifies the name of the multiport memory unit as indicated in a
previous SHARE/INITIALIZE command.
Qualifiers
/MAXCEFCLUSTERS=max-cef
Specifies the maximum number of common event flag clusters that the
processor can create in the multiport memory unit. The default is no
limit.
/MAXGBLSECTIONS=max-gbl
Specifies the maximum number of global sections that the processor can
create in the multiport memory unit. The default is no limit.
/MAXMAILBOXES=max-mail
Specifies the maximum number of mailboxes the processor can create in
the multiport memory unit. The default is no limit.
Example
|
SYSGEN> SHARE MPM1 SHR_MEM_1
|
This command connects a multiport memory unit. Because no qualifiers
are specified, defaults apply to all the parameters.
The unit with a 1 on the front panel must be initialized with the name
SHR_MEM_1 for the command to work.
SHARE/INITIALIZE (VAX Only)
On VAX systems, initializes a multiport memory unit and connects it to
the processor on which SYSGEN is running.
Use of the SHARE/INITIALIZE command requires the CMKRNL privilege.
Format
SHARE/INITIALIZE MPMn MPM-name
Parameters
MPMn
Specifies the number on the front panel of the multiport memory unit
being connected.
MPM-name
Specifies the name by which the multiport memory unit is to be known to
systems using it. The MPM-name is a 1 to 15 alphanumeric character
string that may contain dollar signs ($) and underscores (_).
Qualifiers
/CEFCLUSTERS=cef
Specifies the total number of common event flag clusters permitted in
the multiport memory unit. The cef value is an integer with a
default of 32.
/GBLSECTIONS=gbl
Specifies the total number of global sections permitted in the
multiport memory unit. The gbl value is an integer with a
default of 32.
/MAILBOXES=mail
Specifies the total number of mailboxes permitted in the multiport
memory unit. The mail value is an integer with a default of 32.
/MAXCEFCLUSTERS=max-cef
Specifies the maximum number of common event flag clusters that the
processor can create in the multiport memory unit. The default is no
limit.
/MAXGBLSECTIONS=max-gbl
Specifies the maximum number of global sections that the processor can
create in the multiport memory unit. The default is no limit.
/MAXMAILBOXES=max-mail
Specifies the maximum number of mailboxes the processor can create in
the multiport memory unit. The default is no limit.
/POOLBCOUNT=block-cnt
Specifies the number of blocks allocated to the multiport memory unit's
dynamic pool. The block-cnt value is an integer with a default
of 128.
/POOLBSIZE=block-size
Specifies the size of each block in the dynamic pool. The
block-size value is an integer with a default of 128 bytes.
/PRQCOUNT=prq-cnt
Specifies the number of interprocessor request blocks (PRQs) allocated.
The prq-cnt value is an integer with a default of 64.
Description
If the specified multiport memory unit is already initialized and
connected to other active processors, the gbl, mail, cef,
block-cnt, block-size, and prq-cnt parameter values are
ignored, and the unit is simply connected to the processor.
Example
|
SYSGEN> SHARE MPM1 SHR_MEM_1/INITIALIZE -
SYSGEN> /GBLSECTIONS=128/MAILBOXES=64/CEFCLUSTERS=0
|
This command initializes a multiport memory unit with defaults on all
but the gbl, mail, and cef parameters. In this
example, assume that the number of the multiport memory unit as it
appears on the front panel is 1, and the unit name is SHR_MEM_1.
SHOW
Displays the values of system parameters in the SYSGEN work area, plus
the default, minimum, and maximum values of the parameters and their
units of measure.
Format
SHOW parameter-name
Parameter
parameter-name
Specifies the name of a system parameter. If you enter a period (.), it
is interpreted as a request for the system parameter specified in the
last SET parameter-name or SHOW parameter-name command.
Beginning in OpenVMS Version 8.2, specifies OBSOLETE in the Units
column for any specified parameter that is obsolete.
Qualifiers
/ACP
Specifies that all ACP parameter values are displayed.
/ALL
Specifies that all parameter values other than SPECIAL parameter values
are displayed.
/BI
Specifies that device addresses that are currently mapped in the I/O
space for the VAXBI bus are displayed.
/CLUSTER
Specifies that all CLUSTER parameter values are displayed.
/DYNAMIC
Specifies that all DYNAMIC parameter values are displayed.
/GEN
Specifies that all GEN parameter values are displayed.
/HEX
Specifies that the values of parameters be displayed in hexadecimal
representation. Specify the /HEX system parameter name or the parameter
type. If you specify the /HEX qualifier with the /NAMES qualifier, /HEX
is ignored.
/JOB
Specifies that all JOB parameter values are displayed.
/LGI
Specifies that all LGI parameter values are displayed.
/MAJOR
Specifies that all MAJOR parameter values are displayed.
/MULTIPROCESSING
Specifies that all MULTIPROCESSING parameters are displayed.
/NAMES
Specifies that the names of all parameters are displayed.
/OBSOLETE
Specifies that the names of all obsolete parameters are displayed.
/PQL
Specifies that all PQL parameter values are displayed.
/RMS
Specifies that all RMS parameter values are displayed.
/SCS
Specifies that all SCS parameter values are displayed.
/SPECIAL
Specifies that all parameter values reserved for HP use are displayed.
/STARTUP
Specifies that the name of the current site-independent startup command
procedure is displayed.
/SYS
Specifies that all SYS parameter values are displayed.
/TTY
Specifies that all terminal parameter values are displayed.
/XMI[=BIindex]
Specifies that device addresses that are currently mapped in the I/O
space for the XMI bus are displayed. The /XMI qualifier also displays
node and nexus numbers and generic names of all processors, adapters,
VAXBI adapters, memory controllers, and interconnection devices such as
the NI.
Use of the SHOW/XMI=BIindex command requires the CMEXEC privilege.
Description
Parameter values are displayed in decimal unless the /HEX qualifier is
specified. Note that ASCII values are displayed in ASCII by default.
When parameter names are abbreviated on a VAX platform, the first
parameter matching the abbreviation is selected for display. No
ambiguity checks are made. On an Alpha or I64 platform, all parameters
whose names match the abbreviation are printed.
For example, a specification of SHOW GBL on a VAX system displays only
the GBLSECTIONS parameter. To display the GBLPAGFIL parameter, you must
specify SHOW GBLPAGF (to avoid further ambiguity with the GBLPAGES
parameter). On an Alpha or I64 system, the same SHOW GBL command
displays GBLSECTIONS, GBLPAGES, and GBLPAGFIL.
You can enter a period (.) to indicate that you want to work with the
system parameter that was specified in the last SET parameter-name or
SHOW parameter-name command.
Examples
#1 |
SYSGEN> SHOW GBLSECTIONS
Parameter Name Current Default Minimum Maximum Unit Dynamic
GBLSECTIONS 100 40 20 -1 Sections
SYSGEN> SET . 110
SYSGEN> SHOW .
Parameter Name Current Default Minimum Maximum Unit Dynamic
GBLSECTIONS 110 40 20 -1 Sections
|
|
In this example, the user first displays the values of the GBLSECTIONS
parameter and then refers to the parameter with a period to set its
current value to 110. The next SHOW command also uses the period
notation to obtain confirmation that the change occurred.
On a VAX system, the command in this example produces the following
output:
Parameters in use: Active
Parameter Name Current Default Minimum Maximum Unit Dynamic
ACP_MULTIPLE 0 1 0 1 Boolean D
ACP_SHARE 1 1 0 1 Boolean
ACP_MAPCACHE 52 8 1 -1 Pages D
ACP_HDRCACHE 138 128 2 -1 Pages D
ACP_DIRCACHE 138 80 2 -1 Pages D
ACP_DINDXCACHE 37 25 2 -1 Pages D
ACP_WORKSET 0 0 0 -1 Pages D
ACP_FIDCACHE 64 64 0 -1 File-Ids D
ACP_EXTCACHE 64 64 0 -1 Extents D
ACP_EXTLIMIT 300 300 0 1000 Percent/10 D
ACP_QUOCACHE 130 64 0 -1 Users D
ACP_SYSACC 4 8 0 -1 Directories D
ACP_MAXREAD 32 32 1 64 Blocks D
ACP_WINDOW 7 7 1 -1 Pointers D
ACP_WRITEBACK 1 1 0 1 Boolean D
ACP_DATACHECK 2 2 0 3 Bit-mask D
ACP_BASEPRIO 8 8 4 31 Priority D
ACP_SWAPFLGS 14 15 0 15 Bit-mask D
ACP_XQP_RES 1 1 0 1 Boolean
ACP_REBLDSYSD 0 1 0 1 Boolean
|
The command in this example produces a hexadecimal display of the
values of the ACP system parameters, as follows:
Parameters in use: Active
Parameter Name Current Default Minimum Maximum Unit Dynamic
ACP_MULTIPLE 00000000 00000001 00000000 00000001 Boolean D
ACP_SHARE 00000001 00000001 00000000 00000001 Boolean
ACP_MAPCACHE 00000034 00000008 00000001 FFFFFFFF Pages D
ACP_HDRCACHE 0000008A 00000080 00000002 FFFFFFFF Pages D
ACP_DIRCACHE 0000008A 00000050 00000002 FFFFFFFF Pages D
ACP_DNDXCACHE 00000025 00000019 00000002 FFFFFFFF Pages D
ACP_WORKSET 00000000 00000000 00000000 FFFFFFFF Pages D
ACP_FIDCACHE 00000040 00000040 00000000 FFFFFFFF File-Ids D
ACP_EXTCACHE 00000040 00000040 00000000 FFFFFFFF Extents D
ACP_EXTLIMIT 0000012C 0000012C 00000000 000003E8 Percent/10 D
ACP_QUOCACHE 00000082 00000040 00000000 FFFFFFFF Users D
ACP_SYSACC 00000004 00000008 00000000 FFFFFFFF Directories D
ACP_MAXREAD 00000020 00000020 00000001 00000040 Blocks D
ACP_WINDOW 00000007 00000007 00000001 FFFFFFFF Pointers D
ACP_WRITEBACK 00000001 00000001 00000000 00000001 Boolean D
ACP_DATACHECK 00000002 00000002 00000000 00000003 Bit-mask D
ACP_BASEPRIO 00000008 00000008 00000004 0000001F Priority D
ACP_SWAPFLGS 0000000E 0000000F 00000000 0000000F Bit-mask D
ACP_XQP_RES 00000001 00000001 00000000 00000001 Boolean
ACP_REBLDSYSD 00000000 00000001 00000000 00000001 Boolean
|
On an Alpha or I64 system, the command in this example produces output
similar to the following:
Parameters in use: Active
Parameter Name Current Default Min. Max. Unit Dynamic
-------------- ------- ------- ------- ------- ---- -------
PQL_DASTLM 24 24 -1 -1 Ast D
PQL_MASTLM 4 4 -1 -1 Ast D
PQL_DBIOLM 32 32 -1 -1 I/O D
PQL_MBIOLM 4 4 -1 -1 I/O D
PQL_DBYTLM 65536 65536 -1 -1 Bytes D
PQL_MBYTLM 1024 1024 -1 -1 Bytes D
PQL_DCPULM 0 0 -1 -1 10Ms D
PQL_MCPULM 0 0 -1 -1 10Ms D
PQL_DDIOLM 32 32 -1 -1 I/O D
PQL_MDIOLM 4 4 -1 -1 I/O D
PQL_DFILLM 128 128 -1 -1 Files D
PQL_MFILLM 2 2 -1 -1 Files D
PQL_DPGFLQUOTA 65536 65536 -1 -1 Pagelets D
internal value 4096 4096 0 -1 Pages D
PQL_MPGFLQUOTA 2048 2048 -1 -1 Pagelets D
internal value 128 128 128 -1 Pages D
PQL_DPRCLM 32 32 -1 -1 Processes D
PQL_MPRCLM 0 0 -1 -1 Processes D
PQL_DTQELM 16 16 -1 -1 Timers D
PQL_MTQELM 0 0 -1 -1 Timers D
PQL_DWSDEFAULT 2000 2000 -1 -1 Pagelets
internal value 125 125 0 -1 Pages
PQL_MWSDEFAULT 2000 2000 -1 -1 Pagelets
internal value 125 125 125 -1 Pages
PQL_DWSQUOTA 4000 4000 -1 -1 Pagelets D
internal value 250 250 0 -1 Pages D
PQL_MWSQUOTA 4000 4000 -1 -1 Pagelets D
internal value 250 250 250 -1 Pages D
PQL_DWSEXTENT 12000 12000 -1 -1 Pagelets D
internal value 750 750 0 -1 Pages D
PQL_MWSEXTENT 4000 4000 -1 -1 Pagelets D
internal value 250 250 250 -1 Pages D
PQL_DENQLM 64 64 -1 -1 Locks D
PQL_MENQLM 4 4 -1 -1 Locks D
PQL_DJTQUOTA 1024 1024 -1 -1 Bytes D
PQL_MJTQUOTA 0 0 -1 -1 Bytes D
|
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
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 or I64 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:
- Modify your site-independent STARTUP.COM file to invoke the command
file specified with the /OUTPUT qualifier instead of entering an
AUTOCONFIGURE ALL command.
- 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-2002 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-2002 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
|
|