Document revision date: 30 March 2001

## OpenVMS System Management Utilities Reference Manual

Previous | Contents | Index

## SET DEFAULT_PORT

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

## SET LAN_DEVICE

> 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

> SET TRACE sets or modifies PEDRIVER tracing parameters.

Note This command is reserved for use by Compaq Services and OpenVMS Engineering only. Trace commands and output are subject to change from release to release.

### 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

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

## 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

### 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

#1
    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

>        .
>        .
>        .

#2
    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
>        .
>        .
>        .

#3
    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.

#4
    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.

#5
    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.

#6
    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

## SHOW DEFAULT_PORT

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

## 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

### 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

#1
    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
>        .
>        .
>        .

#2
    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

#3
    SCACP> SHOW LAN_DEVICE/COUNTERS

> The command in this example displays device counters.

#4
    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.

Previous | Next | Contents | Index

| privacy and legal statement |
6048PRO_054.HTML