HP OpenVMS System Management Utilities Reference Manual


Previous Contents Index

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


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
      

This SHOW CIRCUIT command 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.

Example


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.

SHOW PORT

Displays information about selected SCA ports.

Format

SHOW PORT portname


Parameter

portname[,...]

Displays information about specific SCA ports, which you can use wildcards to specify. If no portname is specified, all ports on the node are displayed.

Qualifiers

/EXCLUDE=(portname[,...])

Excludes specific port names from the display. You cannot use wildcards to specify port names.

/OUTPUT=filespec

Creates the specified file and directs the output of the command to this file.

Example


SCACP> SHOW PORT
      

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


  Port data for CLUIO2 at 06-DEC 15:01:25.82 
 
    Port   Mgt       Msgs       Msgs     Dgrams     Dgrams 
    Name   Prio      Sent       Rcvd       Sent       Rcvd 
    ------ ---- ---------- ---------- ---------- ---------- 
    PEA0     0      64582      92237          0          0 
    PIB0     0      95276     148937          0          0 
    PIA0     0          0          0          0          0 
    PIC0     0      62030     115148          0          0 

SHOW TRACE

Displays PEdriver tracing data and 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

SHOW TRACE 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 are included.

Use the SHOW CHANNEL command to display node names and local and remote device names.


Qualifiers

/CONTEXT

Displays only PEdriver trace settings and the event definition. If this qualifier is not included, trace event data is displayed.

/EVENT=(event1[,...])

Enables tracing on specific events, which you can use wildcards to specify. The default is all of the events that are in the trace buffer.

Use the SHOW TRACE/CONTEXT command to display event names.

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

/GLOBAL (default when no nodes are specified)

/NOGLOBAL (default when nodes are specified)

Specifies whether or not global trace data is to be returned.

/INPUT=filename

Reads trace data from the specified file and displays it.

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

/OUTPUT=filename

Creates the specified file and directs output to it. If the filename extension is .DMP, the trace data is written to a dump file so that you can use the /INPUT qualifier to display it later.

/REMOTE_DEVICE=(landevicename[,...])

Includes specific LAN devices which identify the remote end of the channel, which you can use wildcards to specify.

Use the SHOW LAN_DEVICE command to display device names.

/SORT

/NOSORT (default)

Returns trace data sorted across channels, VCs, and the global trace buffer by sequence number. The default is trace data returned for channels and VCs one at a time, in order, for the channel or VC, but not across channels and VCs.

Examples

#1

SCACP> SHOW TRACE/CONTEXT
      

The command in this example displays trace settings and definition.

#2

SCACP> SHOW TRACE/OUTPUT=NODE10.TRC
      

The command in this example displays trace data and writes it to the specified file.

An example of the screen output of a SHOW TRACE/CONTEXT command follows.


SYS999 Trace Context 31-JAN-2001 10:59:28.25: 
 
  Trace buffer size requested 2048 bytes 
  Trace buffer total allocated 92160 bytes 
  Trace buffer allocations 45 successful 
  Trace buffer allocations 0 failed 
  Current trace sequence number 812286047 
  System cycle counter 404196 cps 
  Stop tracing 0 events after stop event 
 
  Trace  Stop  Default  Event 
  -----  ----  -------  ----- 
  Active          Y     Error 
  Active                Penalize_ch 
  Active                Timer 
  Active                Listen_timr 
  Active                Handsh_timr 
  Active                Size_probe 
  Active                Delay_msmt 
  Active                Verf_vack 
  Active          Y     CC_event 
  Active          Y     CC_state 
  Active          Y     Path_state 
  Active          Y     ECS_state 
  Active                ACK_process 
  Active          Y     Chan_update 
  Active                Rcvd_CC_msg 
  Active                Rcvd_TR_msg 
  Active                Send_TR_msg 
  Active                Xmt_failed 
  Active          Y     VC_state 
  Active                ACK_timeout 
  Active          Y     TMO_listen 
                  Y     No_path 
 
    Channel Selection: 
    Local Dev  Remote Dev  Remote Node Name    Selection 
    ---------  ----------  ----------------    --------- 
    All channels and VCs selected 

SHOW VC

Displays PEdriver virtual circuit data. Each VC is an SCACP communications path between the local system and a remote system comprised of a set of channels.

Use the SHOW CHANNEL or SHOW VC commands to display node names, which are simply the names of the remote nodes.


Format

SHOW VC nodename


Parameter

nodename[,...]

Includes specific nodes, which you can use wildcards to specify.

Qualifiers

/ALL

Includes all VC data.

/COUNTERS

Includes VC counter data.

/EXCLUDE=(nodename[,...])

Excludes specific nodes, which you can use wildcards to specify.

Use the SHOW CHANNEL or SHOW VC commands to display VC names, which are simply the names of the remote nodes.

/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 VC data displayed in SDA format.

/SUMMARY

Includes VC summary data. This is the default if /ALL, /COUNTERS, and /SDA qualifiers are not specified.

Examples

#1

SCACP> SHOW VC/COUNTERS NODE10
      

The command in this example displays VC counters for all VCs whose name (that is, remote node name) starts with NODE10.

#2

SCACP> SHOW VC/COUNTERS/INTERVAL
SCACP> SPAWN WAIT 0:0:10
SCACP> SHOW VC/COUNTERS/INTERVAL
      

The first command in this example displays VC counters since the last SHOW command. The SPAWN command tells the DCL WAIT command to insert a 10-second delay. The second SHOW VC command displays counters after the 10-second period.

SPAWN

Creates a subprocess of the current process. The SPAWN command copies the context of the subprocess from the current process.

Format

SPAWN [command-string]


Parameter

command-string

A string of commands to be executed in the context of the created subprocess. After the command string is executed, control returns to SCACP.

Qualifiers

None.

Example


SCACP> SPAWN SHOW TIME
24-AUG-2005 15:22:39
SCACP>
      

The command in this example creates a subprocess of the current process and displays the time.

START LAN_DEVICE

Directs PEdriver to start using the specified LAN device. The original (and still supported) way to start PEdriver on a LAN device is SYS$EXAMPLES:LAVC$START_BUS.

Format

START 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=(landevicename[,...])

Excludes specific LAN devices, which you can use wildcards to specify.

Use the SHOW LAN_DEVICE command to display device names.


Example


SCACP> START LAN_DEVICE EWA
      

This command starts PEdriver on the LAN device EWA.

START TRACE

Starts or resumes PEdriver tracing, optionally setting tracing options.

Note

This command is reserved for use by HP Services and OpenVMS Engineering only. Trace commands, their qualifiers, and output are subject to change from release to release.

Format

START TRACE nodename


Parameter

nodename[,...]

Includes information about communications with 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 included.

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, continues tracing for n events, and then stops. 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:


       channelname=* 
       /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.

Use the SHOW TRACE/CONTEXT command to display event names.

/EXCLUDE=(landevicename[,...])

Excludes specific LAN devices, which you can use wildcards to specify.

Use the SHOW LAN_DEVICE command to display device names.

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

/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=(event[,...])

Stops tracing on specific events, which you can use wildcards to specify. The default is to stop no events.

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> START TRACE/EVENT=CC_STATE/SIZE=2000
      

The command in this example changes the Trace Channel Control layer state with a 2000-byte trace buffer.

#2

SCACP> START TRACE/EVENT=ALL NODE10,NODE20
      

The command in this example traces all events but only for the NODE10 and NODE20 channels.


Previous Next Contents Index