HP OpenVMS Systems Documentation

HP OpenVMS System Management Utilities Reference Manual

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.

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.

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

SCACP> SET PORT PEA0/PRIORITY=5
      

The command in this example sets the management priority for the PEA0 port to 5.

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 sets or modifies PEDRIVER tracing parameters.

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

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.

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.

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.

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

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.

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

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.

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.

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.

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

SCACP>SHOW CIRCUIT
      

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

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

SCACP> SHOW LAN_DEVICE/COUNTERS
      

The command in this example displays device counters.

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.