HP OpenVMS Systems Documentation

Sets the default port to which to apply SCACP commands.

Note In OpenVMS Version 7.3, the default port is PEA0. The SET DEFAULT_PORT command is non-functional.

Format

SET DEFAULT_PORT portname

Parameter

portname

Identifies the port name; PEA0 is the name of the port implemented by PEDRIVER.

Qualifiers

None.

Example

SCACP> SET DEFAULT_PORT PEA0
      

The command in this example sets the default port to PEDRIVER.

Sets device management parameters: management priority.

Format

SET LAN_DEVICE landevicename

Parameters

landevicename[,landevice1,landevice2,...]

Includes specific LAN devices, which you can specify using wildcards.

Use the /EXCLUDE qualifier to exclude LAN devices.

Use the SHOW LAN_DEVICE command to display device names.

Qualifiers

/EXCLUDE[=(landevicename1,landevicename2,...)]

Excludes specific LAN devices, which you can specify using wildcards.

Use the SHOW LAN_DEVICE command to display device names.

/PRIORITY[=n]

Sets the management priority value for the selected devices.

Example

SCACP> SET LAN_DEVICE/PRIORITY=3 EWA
      

The command in this example sets the management priority for device EWA to 3.

SET TRACE sets or modifies PEDRIVER tracing parameters.

Format

SET TRACE nodename

Parameters

nodename[,nodename1,nodename2,...]

Includes channels and VCs to specific nodes, which you can specify using wildcards. 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.

/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,event2,...)]

Enables tracing on specific events, which you can specify using wildcards. 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[=(nodename1[/LOCAL_DEVICE=landevicename] [/REMOTEDEVICE=landevicename],nodename2,...)]

Excludes VCs or channels, or both, to specific nodes, which you can specify using wildcards. 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[=(landevicename1,landevice2,...)]

Includes specific LAN devices that identify the local end of the channel; you can specify using wildcards.

Use the SHOW LAN_DEVICE command to display device names.

/REMOTE_DEVICE[=(landevicename1,landevice2,...)]

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,event2,...)]

Stops tracing on specific events, which you can specify using wildcards. 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.

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 values.

Note In the initial release of OpenVMS Version 7.3, PEDRIVER does not support this command.

Format

SET VC nodename

Parameter

nodename[,nodename1,nodename2,...]

Includes VCs to specific nodes, which you can specify using wildcards.

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 (default)

Enables or disables checksum verification on the VCs to specified nodes.

/EXCLUDE[=(nodename1,nodename2,...)]

Excludes VCs to specific nodes, which you can specify using wildcards.

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

Parameters

nodename[,nodename1,nodename2,...]

Includes channels to specific nodes, which you can specify using wildcards. 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[,nodename1,nodename2,...]

Excludes channels to specific nodes, which you can specify using wildcards. 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[=(landevicename1,landevice2,...)]

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[=(landevicename1,landevice2,...)]

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
      

The command in this example produces output similar to the following:

SYS999 PEA0 Channel Summary 31-JAN-2001 10:59:15.99: Remote LAN Dev Channel Total ECS Priority Buffer Delay Load Total Node Loc Rmt State Errors State Cur Mgt Hops Size (uSec) Class Pkts(S+R) ---- --- --- ----- ------ ----- --- --- ---- ---- ------ ----- --------- NODE17 EWC EIB Open 2 N(T,I,S) 0 0 2 1426 390.9 10 35401 NODE17 EWC EIA Open 2 N(T,I,S) 0 0 2 1426 1032.3 10 35528 NODE17 EWD EIB Open 2 N(T,I,S) 0 0 2 1426 705.7 10 35402 NODE17 EWD EIA Open 3 N(T,I,F) 0 0 2 1426 453.6 10 35529 . . .

SCACP> SHOW CHANNEL/ALL
      

The command in this example produces output similar to the following:

SYS999 PEA0 Channel Summary 31-JAN-2001 10:59:17.43: Remote LAN Dev Channel Total ECS Priority Buffer Delay Load Total Node Loc Rmt State Errors State Cur Mgt Hops Size (uSec) Class Pkts(S+R) ---- --- --- ----- ------ ----- --- --- ---- ---- ------ ----- --------- NODE17 EWC EIB Open 2 N(T,I,S) 0 0 2 1426 390.9 10 35401 NODE17 EWC EIA Open 2 N(T,I,S) 0 0 2 1426 1032.3 10 35528 NODE17 EWD EIB Open 2 N(T,I,S) 0 0 2 1426 705.7 10 35402 NODE17 EWD EIA Open 3 N(T,I,F) 0 0 2 1426 453.6 10 35529 . . . SYS999 PEA0 Channel Equivalent Channel Set (ECS) 31-JAN-2001 10:59:17.43: Loc Rmt Remote ECS ECS ECS Average Remote Remote Rsvp Channel ECS Dev Dev Node State Losses Transitions RTTime Ring Size Rcv Cache Thresh Open Time Member Time --- --- ---- ----- ------ ----------- ----- --------- --------- ------ --------- ----------- EWA EWB SYS11 Y(T,P,F 0 41 3028.9 31 31 2 00:34:57.62 00:33:17.95 EWB EWC SYS11 Y(T,P,F) 0 53 2571.8 16 31 7197 00:38:38.99 00:35:19.57 EWB EWA SYS111 Y(T,P,F) 0 1 117079.2 16 31 0 19:10:04.85 19:10:04.81 EWB EWB SYS22 Y(T,P,F) 0 1 109055.9 16 31 96 19:10:16.21 19:10:16.21 EWB EXA SYS222 Y(T,P,F) 0 1 9262.7 31 31 39182 20:01:40.85 20:01:40.85 . . . SYS999 PEA0 Channel Counters and Errors 31-JAN-2001 10:59:17.43: Loc Rmt Remote -- Transmit -- -- Receive -- Retransit TransmitFail Receive Other Dev Dev Node Messages Bytes Messages Bytes Errors Penalties Errors Errors --- --- ---- -------- ----- -------- ----- ------ --------- ------ ------ EWA EWB SYS11 3520 494938 5973 876922 10 0 0 9 EWB EWC SYS11 5497 789781 9385 1406215 11 0 0 29 EWB EWA SYS111 268360 36700156 356173 48271657 67 0 0 1 EWB EWB SYS22 546214 89400904 583298 80580667 92 0 0 1 EWB EXA SYS222 4841514 913885390 3764456 3888518960 2 0 0 1 . . . SYS999 PEA0 Channel Errors 31-JAN-2001 10:59:17.43: Loc Rmt Remote -------------------- Receive -------------------- -- Timeouts- No MSCP Disk Not Topology Path Dev Dev Node Bad Auth Bad ECO Bad MCA Short Incompat Old Chan Handshake Listen Server Served Change Restart --- --- ---- -------- ------- ------- ----- -------- -------- --------- ------ ------ ------ ------ ------- EWA EWB SYS11 0 0 0 0 0 0 0 4 0 0 5 0 EWB EWC SYS11 0 0 0 0 0 0 0 4 0 20 5 0 EWB EWA SYS111 0 0 0 0 0 0 0 0 0 0 1 0 EWB EWB SYS22 0 0 0 0 0 0 0 0 0 0 1 0 EWB EXA SYS222 0 0 0 0 0 0 0 0 0 0 1 0 . . .

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.

SCACP> SHOW CHANNEL/LOCAL=EWA/REMOTE=EWB NODE10,
NODE15/L=F*/R=F*, NODE20
      

The command in this example is equivalent to the following command:

SHOW CHANNEL NODE10/L=EWA/R=EWB, NODE15/L=F*/R=F*, NODE20/L=EWA/R:EWB

This command shows the following channels:

• To node NODE10, the channel with local device EWA and remote device EWB
• To node NODE15, the channel with local LAN device starting with F and remote LAN device starting with F
• To node NODE20, the channel with local LAN device EWA and remote LAN device EWB

Displays the current default port.

Format

SHOW DEFAULT_PORT

Parameters

None

Qualifiers

/OUTPUT[=filespec]

Creates the specified file and directs output to it.

Example

SCACP> SHOW DEFAULT_PORT
      

The command in this example displays the currently selected port, PEA0, which indicates PEDRIVER.

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

Parameters

landevicename[,landevice1,landevice2,...]

Includes specific LAN devices, which you can specify using wildcards.

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.

/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
      

The command in this example produces output similar to the following:

SYS999 PEA0 Device Summary 31-JAN-2001 10:58:57.93: Device Errors + Mgt Buffer MgtMax Line Total Current Device Type Events Status Priority Size BufSiz Speed Pkts(S+R) LAN Address ------ ---- ------ ------ -------- ---- ------ ----- --------- ----------- LCL 0 Run Online Local Restart 0 1426 0 N/A 46456 00-00-00-00-00-00 FWA DEFPA 847806 Run Online Restart 0 4396 0 100 0 08-00-2B-B9-1A-2C EWA DE500 0 Run Online Restart -123 1426 0 10 228538 AA-00-04-00-62-4D EWB DEGPA 1204 Run Online Restart 0 7460 0 1000 63188 00-60-6D-21-12-1E . . .

SCACP> SHOW LAN_DEVICE/ALL
      

The command in this example produces output similar to the following:

SYS999 PEA0 Device Summary 31-JAN-2001 10:59:00.88: Device Errors + Mgt Buffer MgtMax Line Total Current Device Type Events Status Priority Size BufSiz Speed Pkts(S+R) LAN Address ------ ---- ------ ------ -------- ---- ------ ----- --------- ----------- LCL 0 Run Online Local Restart 0 1426 0 N/A 46456 00-00-00-00-00-00 FWA DEFPA 847806 Run Online Restart 0 4396 0 100 0 08-00-2B-B9-1A-2C EWA DE500 0 Run Online Restart -123 1426 0 10 228538 AA-00-04-00-62-4D EWB DEGPA 1204 Run Online Restart 0 7460 0 1000 63188 00-60-6D-21-12-1E . . . SYS999 PEA0 Device Counters and Errors 31-JAN-2001 10:59:00.88: --------- Transmit --------- --------- Receive -------- Port Port Addr Restart Device Messages Bytes Errors Messages Bytes Errors Usable Down Change Failed *Last Event Time ------ -------- ----- ------ -------- ----- ------ ------ ---- ------ ------ ---------------- LCL 77926 10131658 0 77926 9196546 0 1* 0 0 0 30-JAN 14:53:04.27 EBA 79932 10771395 0 79828 9471857 0 1* 0 0 0 30-JAN 14:53:04.27 EWA 95170718 951046392 0 90389699 824505995 0 1 0 1* 0 30-JAN 14:53:54.96 EWB 28515398 3596974072 0 31235328 1573461656 0 1 0 1* 0 30-JAN 14:53:56.96 ELA 288523549 3938187772 0 268398349 1991472896 0 1* 0 0 0 30-JAN 14:53:04.38 SYS999 PEA0 Device Errors 31-JAN-2001 10:59:00.88: - Transmit - ------------------- Received -------------------- Allocation Generic Hello With Bad Mcast TR Short Short On Wrong Discard Failures On Device Errors Errors Last Transmit Error SYSTEMID Message CC Msg DX Msg Port PortDisa CH VC ------ ------ ------ ------------------- -------- ------- ------ ------ ---- -------- ---- ---- LCL 0 0 (No time) 0 0 0 0 0 0 0 0 EBA 0 0 (No time) 0 0 0 0 0 0 0 0 EWA 0 0 (No time) 0 0 0 0 0 0 0 0 EWB 0 0 (No time) 0 0 0 0 0 0 0 0 ELA 0 0 (No time) 0 0 0 0 0 0 0 0 SYS999 LAN Counters and Errors 31-JAN-2001 10:59:00.88: ---------- Transmit -------- ---------- Receive ------ Buffer Unavailable -- Unrecognized -- Device Packets Bytes Errors Packets Bytes Errors System User Individual Multicast Events ------ ------- ----- ------ ------- ----- ------ ------ ---- ---------- --------- ------ LCL 0 0 0 0 0 0 0 0 0 0 0 EBA 80172 10808778 0 80068 10786180 0 0 0 0 240 0 EWA 95170964 214548983411 0 90390818 185699326463 0 0 0 0 1119 0 EWB 28520511 14930703525 0 31255260 18836142478 0 0 0 1697 1653 0 ELA 288523791 655074988675 0 268399522 415695135533 0 0 0 0 1173 0

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.