 |
HP OpenVMS System Management Utilities Reference
Manual
SET CIRCUIT
Sets the circuit management priority value.
Note
If a circuit is closed, it is deleted. This means that the management
settings for that circuit are also deleted.
If the circuit is opened again, it has the default values for its
management settings.
|
Format
SET CIRCUIT nodename
Parameter
nodename[,...]
Names a circuit or circuits to specific nodes, which you can use
wildcards to specify. You can qualify each node name with additional
parameters to uniquely identify a single circuit.
Qualifiers
/EXCLUDE=(nodename[/PORT=portname[/RSTATION=n]][,...])
Allows you to exclude a specific circuit to a node. If multiple
circuits to the same node exist, you can use the /PORT and /RSTATION
qualifiers to uniquely identify the circuit.
/PORT=portname[/RSTATION=n]
If multiple circuits to the same node exist, you can use the /PORT and
/RSTATION qualifiers to uniquely identify the circuit. You can use the
/RSTATION qualifier only in conjunction with the /PORT qualifier.
Example
|
SCACP> SET CIRCUIT CLUIO1 /PORT=PIB0 /PRI=10
|
The command in this example sets the priority of the circuit to node
CLUIO1 through PIB0 to 10. You need to use the /PORT qualifier if
multiple circuits to node CLUI01 exist and only the circuit through
PIB0 is meant to have its priority raised.
SET LAN_DEVICE
Sets device management priority parameter.
Format
SET LAN_DEVICE landevicename
Parameter
landevicename[...,]
Includes specific LAN devices, which you can use wildcards to specify.
Use the /EXCLUDE qualifier to exclude LAN devices.
Use the SHOW LAN_DEVICE command to display device names.
Qualifiers
/EXCLUDE=(landevicename1[,...])
Excludes one or more specific LAN devices, which you can use wildcards
to specify.
/PRIORITY=n
Sets the management priority value for the selected devices. n
can be a value between -128 and +127. Suggested values are:
2 to cause devices to be preferred
-2 to exclude devices
Note
Starting with OpenVMS Version 7.3-2, a channel whose priority is -128
is not used for cluster communications. The priority of a channel is
the sum of the management priority assigned to the local LAN device and
the channel itself. Therefore, you can assign any combination of
channel and LAN device management priority values to achieve a total of
-128.
|
Caution
If you set the priority of all devices to -128, you will totally
disable use of the LAN for cluster communication. This can cause the
system to CLUEXIT.
|
Example
|
SCACP> SET LAN_DEVICE/PRIORITY=3 EWA
|
The command in this example sets the management priority for device EWA
to 3.
SET PORT
Sets a port management priority value.
Format
SET PORT portname
Parameter
portname[,...]
Specifies SCA port names, in which you can include wildcards.
Use the /EXCLUDE qualifier to exclude specific ports.
Use the SHOW PORT command to display all ports available on your system.
Qualifiers
/EXCLUDE=(portname[,...])
Excludes specific ports from the operation.
/PRIORITY=n
Sets the management priority value for the selected ports. n
can be any value between -128 and +127.
Examples
| #1 |
SCACP> SET PORT PEA0/PRIORITY=5
|
The command in this example sets the management priority for the PEA0
port to 5.
| #2 |
SCACP> SET PORT PEA0 /PRIORITY=5 /EXCLUDE=PEA0
|
The command in this example sets all ports with the exception of PEA0
to a management priority of 5.
SET TRACE
SET TRACE sets or modifies PEDRIVER tracing parameters.
Note
This command is reserved for use by HP Services and OpenVMS Engineering
only. Trace commands and output are subject to change from release to
release.
|
Format
SET TRACE nodename
Parameter
nodename[,...]
Includes channels and VCs to specific nodes, which you can use
wildcards to specify. Each node name can be accompanied by optional
qualifiers to specify local and remote device names.
If no local or remote device name is specified, all channels associated
with the specified node are included, as well as the VC to the
specified node.
Use the SHOW CHANNEL command to display node names and local and remote
device names.
Qualifiers
/AFTER=n
After the trace stop condition has been satisfied, continue tracing for
n events, and then stop. If you do not specify /AFTER, tracing
does not continue after the trace stop event. n can be any
value between 0 and FFFFFFF.
/DEFAULT
Sets the trace context back to the default settings, which are:
trace all channels and VCs
/AFTER=0
/EVENT=default settings
/STOP
/SIZE=512
|
/EVENT=(event1[,...])
Enables tracing on specific events, which you can use wildcards to
specify. The default is a subset of the events, which includes most
errors and state changes when the system parameter SYSTEM_CHECK is set
to 0. The default is "all events included" when SYSTEM_CHECK
is set to 1.
Use the SHOW TRACE/CONTEXT command to display event names.
/EXCLUDE=(nodename[/LOCAL_DEVICE=landevicename]
[/REMOTEDEVICE=landevicename][,...])
Excludes VCs or channels, or both, to specific nodes, which you can use
wildcards to specify. Each node name can be accompanied by optional
qualifiers to specify local and remote device names. If no local or
remote device name is specified, the VC and all channels associated
with the specified node are excluded.
/LOCAL_DEVICE=(landevicename[,...])
Includes specific LAN devices that identify the local end of the
channel. You can use wildcards to specify LAN devices.
/REMOTE_DEVICE=(landevicename[,...])
Includes specific LAN devices that identify the remote end of the
channel; you can use wildcards to specify LAN devices.
Use the SHOW LAN_DEVICE command to display device names.
/STOP=(event1[,...])
Stops tracing on specific events, which you can use wildcards to
specify. The default is "no events included."
Use the SHOW TRACE/CONTEXT command to display event names.
/SIZE=n
Specifies a trace buffer size of n bytes to be used by PEDRIVER for
each trace buffer: one for global PEDRIVER use, one for each selected
channel, and one for each selected VC. n can be any value
between 0 and FFFFFFF.
Examples
| #1 |
SCACP> SET TRACE/EVENT=CC_STATE/SIZE=1000
|
The command in this example specifies that the trace buffers for each
channel, VC, and the global buffer each be 1000 bytes in length.
| #2 |
SCACP> SET TRACE/EVENT=* NODE10/LOCAL=EWA,NODE20
|
The command in this example specifies that all events are to be
recorded; when applicable to a particular node, however, only channels
and VCs to nodes NODE10 and NODE20 are to be included.
| #3 |
SCACP> SET TRACE/EVENT=(ALL,NOTIMER) NODE10
|
The command in this example specifies that all events except timer
events on node NODE10 are to be included.
| #4 |
SCACP> SET TRACE/LOCAL=EWA/REMOTE=EWB NODE10,NODE15/L=F*/R=F*,NODE20
|
The command in this example is equivalent to the following command:
SET TRACE NODE10/L=EWA/R=EWB,NODE15/L=F*/R=F*,NODE20/L=EWA/R:EWB
|
The command in the example sets tracing on the following channels:
- On node NODE10, channels with local device EWA and remote device EWB
- On node NODE15, channels with local LAN device starting with F and
remote LAN device starting with F
- On node NODE20, channels with local LAN device EWA and remote LAN
device EWB
SET VC
Sets VC management parameters: checksumming, ecs delay threshold values.
Format
SET VC nodename
Parameter
nodename[,...]
Includes VCs to specific nodes, which you can use wildcards to specify.
Use the /EXCLUDE qualifier to exclude VCs to specific nodes.
Use the SHOW CHANNEL or SHOW VC commands to display VC names, which are
simply the names of remote nodes.
Qualifiers
/CHECKSUMMING
/NOCHECKSUMMING
Enables or disables checksum verification on the selected VCs to the
specified nodes.
You can use this command alone or in combination with the system
parameter NISCS_PORT_SERV. (Refer to online help for NISCS_POST_SERV
for more information.)
Note that the the SET VC/CHECKSUMMING setting is not valid beyond the
life of the system. Therefore, you might want to include SET
VC/CHECKSUMMING commands in your startup file, or reissue these
commands at the next boot.
/ECS_MAX_DELAY=n
/NOECS_MAX_DELAY
Sets a management-specified lower bound on the maximum delay (in
microseconds) an ECS member channel can have. n can be any
value between 0 and 3000000. /NOECS_MAX_DELAY disables a prior
management delay setting.
You can use this command to override the PEdriver automatically
calculated delay thresholds to ensure that all channels with delays
less than the value supplied for n are included in the VC's
ECS.
The command operates as follows: Whenever at least one tight peer
channel has a delay of less than the management-supplied value, all
tight peer channels with delays less than the management-supplied value
are automatically included in the ECS. When all tight peer channels
have delays equal to or greater than the management setting, the ECS
membership delay thresholds are automatically calculated and used. The
/NOECS_MAX_DELAY qualifier disables management control by setting the
management delay value to zero.
You must determine an appropriate value for your configuration by
experimentation. An initial value of 2000 (2 ms) to 5000 (5 ms) is
suggested.
CAUTION:
By overriding the automatic delay calculations, you can include a
channel in the ECS whose average delay is consistently greater than 1.5
to 2 times the average delay of the fastest channels. When this occurs,
the overall VC throughput becomes the speed of the slowest ECS member
channel. An extreme example is when the management delay permits a
10Mb/sec Ethernet channel to be included with multiple 1 Gb/sec
channels. The resultant VC throughput drops to 10Mb/sec!
|
Note that the SET VC/ECS_MAX_DELAY setting is not valid beyond the life
of the system. Therefore, you might want to include SET
VC/ECS_MAX_DELAY commands in your startup file or reissue these
commands at the next boot.
/EXCLUDE=(nodename[,...])
Excludes VCs to specific nodes, which you can use wildcards to specify.
Example
|
SCACP> SET VC/CHECKSUMMING NODE10,NODE20
|
The command in this example enables checksum verification of VCs to
nodes NODE10 and NODE20.
SHOW CHANNEL
Displays PEDRIVER channel information for specific nodes. Each channel
is a single NISCA communications path between a LAN device on a local
system and a LAN device on a remote system.
Use the SHOW CHANNEL command to display node names and local and remote
device names.
Format
SHOW CHANNEL nodename
Parameter
nodename[,...]
Includes channels to specific nodes, which you can use wildcards to
specify. Each node name can be accompanied by optional qualifiers to
specify local and remote device names. If no local or remote device
name is specified, all channels associated with the specified node name
are included.
Qualifiers
/ALL
Includes all channel data.
/COUNTERS
Includes channel counters data.
/ECS
/NOECS
Includes only channels that are (or are not) members of the ECS.
/EXCLUDE=(nodename[,...])
Excludes channels to specific nodes, which you can use wildcards to
specify. Each node name can be accompanied by optional qualifiers to
specify local and remote device names. If no local or remote device
name is specified, all channels associated with the specified node are
included.
/INTERVAL
For the /COUNTERS display, displays the changes to counters since the
last SHOW command.
/LOCAL_DEVICE=(landevicename[,...])
Includes specific LAN devices that identify the local end of the
channel; you can use wildcards to specify LAN devices.
Use the SHOW LAN_DEVICE command to display device names.
/n
Displays the nth page. To select a particular page of a
multipage display, specify the number of the page you want to display.
/OUTPUT=filespec
Creates the specified file and directs output to it.
/REMOTE_DEVICE=(landevicename[,...])
Includes specific LAN devices that identify the remote end of the
channel; you can use wildcards to specify LAN devices.
Use the SHOW LAN_DEVICE command to display device names.
/SDA
Includes channel data displayed in SDA format, with all the data
collected in one display for one channel.
/SUMMARY
Includes channel summary data. This is the default if /ALL, /COUNTERS,
and /SDA qualifiers are not specified.
Examples
| #1 |
SCACP> SHOW CHANNEL NODE20/LOCAL=EWA
|
The command in this example displays channel definition data for all
nodes defined with local device EWA and any remote device and remote
node name starting with NODE20.
| #2 |
SCACP> SHOW CHANNEL/COUNTERS/INTERVAL
SCACP> SPAWN WAIT 0:0:10
SCACP> SHOW CHANNEL/COUNTERS/INTERVAL
|
The first command in this example displays channel counters since the
last SHOW command. The SPAWN command tells the DCL WAIT command to
insert a 10-second delay. The second SHOW CHANNEL command displays
counters after the 10-second period.
| #3 |
SCACP> SHOW CHANNEL/1/3
|
The command in this example displays the first and third pages of data
for all channels. The first page contains Channel Summary data, and the
third page contains Channel Equivalent Channel Set (ECS) data.
SHOW CIRCUIT
Displays SCA circuit information. You can further qualify each node
name you specify with additional parameters to uniquely identify a
single circuit.
Format
SHOW CIRCUIT nodename
Parameter
nodename[,...]
Includes specific circuits to individual nodes, which you can use
wildcards to specify.
Qualifiers
/EXCLUDE=(nodename[/PORT=portname[/RSTATION=n]][,...])
Allows you to exclude a specific circuit to a node. If multiple
circuits to the same node exist, you can use the /PORT and /RSTATION
qualifiers to uniquely identify the circuit.
/PORT=portname[/RSTATION=n]
If multiple circuits to the same node exist, you can use the /PORT and
/RSTATION qualifiers to uniquely identify the circuit. You can use the
/RSTATION qualifier only in conjunction with the /PORT qualifier.
Example
The command in this example displays all circuits to nodes over port
PEA0.
Circuit data for CLUIO2 at 07-DEC 11:55:31.80
Node Port Priority Load Remote Remote
Name Name Cur Mgt Class State Station Type
-------- -------- ---- ---- -------- -------- ------- --------
LYNX03 PEA0 0 0 10 Open dc NI
CLUIO1 PEA0 0 0 10 Open dd NI
PRMMC2 PEA0 0 0 10 Open de NI
RXBOT1 PIB0 5 0 48 Open 4 RF72
RXTOP1 PIB0 5 0 48 Open 1 RF73
RXTOP0 PIB0 5 0 48 Open 0 RF73
CLUIO1 PIB0 5 0 48 Open 7 N710
R4JC3I PIC0 5 0 48 Open 7 RF73
R4HLEK PIC0 5 0 48 Open 5 RF73
R4XEWM PIC0 5 0 48 Open 3 RF73
R4A1FN PIC0 5 0 48 Open 2 RF73
R4XSVE PIC0 5 0 48 Open 4 RF73
R4VLNI PIC0 5 0 48 Open 1 RF73
|
|
SCACP>SHOW CIRCUIT* /PORT=PEA0
|
The command in this example displays all circuits to all nodes.
Circuit data for CLUIO2 at 07-DEC 12:42:23.03
Node Port Priority Load Remote_Port
Name Name State Cur Mgt Class Number Type
-------- -------- -------- ---- ---- -------- ------- --------
LYNX03 PEA0 Open 0 0 100 dc NI
CLUIO1 PEA0 Open 0 0 10 dd NI
PRMMC2 PEA0 Open 0 0 10 de NI
|
SHOW LAN_DEVICE
Displays PEDRIVER device data. Each device is a local LAN device on the
system, which can be used for NISCA communications.
Format
SHOW LAN_DEVICE landevicename
Parameter
landevicename[,...]
Includes specific LAN devices, which you can use wildcards to specify.
Use the /EXCLUDE qualifier to exclude LAN devices.
Use the SHOW LAN_DEVICE command to display device names.
Qualifiers
/ALL
Includes all device data.
/COUNTERS
Includes device counters data maintained by PEDRIVER and counters data
maintained by the LAN drivers.
/EXCLUDE=(landevicename[,...])
Excludes specific LAN devices, which you can use wildcards to specify.
/INTERVAL
For the /COUNTERS display, displays the changes to counters since the
last SHOW command.
/n
Displays the nth page. To select a particular page of a
multipage display, specify the number of the page you want to display.
/OUTPUT=filespec
Creates the specified file and directs output to it.
/SDA
Includes LAN device data displayed in SDA format, with all the data
collected in one display for one LAN device.
/SUMMARY
Includes device summary data. This is the default if /ALL, /COUNTERS,
and /SDA qualifiers are not specified.
Examples
| #1 |
SCACP> SHOW LAN_DEVICE/COUNTERS
|
The command in this example displays device counters.
| #2 |
SCACP> SHOW LAN_DEVICE/COUNTERS/INTERVAL
SCACP> SPAWN WAIT 0:0:10
SCACP> SHOW LAN_DEVICE/COUNTERS/INTERVAL
|
The first command in this example displays device counters since the
last SHOW command. The SPAWN command tells the DCL WAIT command to
insert a 10-second delay. The second SHOW command displays counters
after the 10-second period.
|
