Document revision date: 30 March 2001

## OpenVMS System Management Utilities Reference Manual

Previous | Contents | Index

## SHOW TRACE

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

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

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

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

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

> #### /GLOBAL (default when no nodes are specified)

> #### /NOGLOBAL (default when nodes are specified)

> Specifies whether global trace data is to be returned.

> #### /INPUT[=filename]

> Reads trace data from the specified file and displays it.

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

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

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

> 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

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

>     SYS999 Trace Results 31-JAN-2001 10:59:24.81

>      EntryTimeStamp  Sequence  VC/Channel        State/Status  Addl Data                      Event/SubType
>      --------------  --------  ----------        ------------  ---------                      -------------
>     53850998.232793  00000004    SYS999          004  STS.   = 00000004 00000000 00000000 ECS_state/Exiting NEW_EPOCH
>     53850998.232793  00000009    SYS999          004  WSeq   = 00010001 LAcc   = 00000000 Send_TR_msg/None
>     53850998.232793  0000000A    SYS999          005  00000000 00000000 00000000 00000000 VC_state/VC opened
>     53850998.232793  0000000B    SYS999          005  WSeq   = 00010001 LAcc   = 00000000 Send_TR_msg/None
>     53850998.232793  0000000C    SYS999          005  WSeq   = 00010001 LAcc   = 00000000 Send_TR_msg/None
>        .
>        .
>        .
>     53851866.350546  3069EF05    SYS11           005  WSeq   = 00010553  LAcc   = 000008CB Send_TR_msg/None
>     53851866.350628  3069EF0C    SYS666          005  EDly   = 007F428A 000F722A 0003B13A Rcvd_TR_msg/Estimated RTT
>     53851866.352023  3069EF7E    SYS44           005  WSeq   = 00010000 LAcc   = 00000D01 Send_TR_msg/None
>     53851866.352140  3069EF8B    SYS11           005  EDly   = 0075FFB9 000E16E8 00054879 Rcvd_TR_msg/Estimated RTT
>     53851866.375951  3069F644  SYS444_EWB_EIB   Open 6B Evnt = 00000000 00000000 00000000 CC_event/Process CC event
>       .
>       .
>       .

>       Channel status legend:
>         6B - Path Open Remote_HWA_valid Tight Fast

>       VC status legend:
>         004 - Path
>         005 - Open Path
>         00D - Open Path Queued

#2
    SCACP> SHOW TRACE/CONTEXT

> The command in this example displays trace settings and definition.

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

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

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

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

> In this example, the command shows tracing for the following channels:

> - To node NODE10, channels with local device EWA and remote device EWB
> - To node NODE15, channels with local LAN device starting with F and remote LAN device starting with F
> - To node NODE20, channels with local LAN device EWA and remote LAN device EWB

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

### Parameters

> #### nodename[,nodename1,nodename2,...]

> Includes specific nodes, which you can specify using wildcards.

### Qualifiers

> #### /ALL

> Includes all VC data.

> #### /COUNTERS

> Includes VC counter data.

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

> Excludes specific nodes, which you can specify using wildcards.

> 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

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

>     SYS999 PEA0 VC Summary 31-JAN-2001 10:59:08.74:

>     Remote        Total         Channels ECS MaxPkt  ReXmt  XmtWindow  Xmt     Total
>      Node  State Errors Xmt:TMO Open ECS Pri  Size TMO(uSec) Cur Max Options Pkts(S+R)
>      ----  ----- ------ ------- ---- --- ---  ---- --------- --- --- ------- ---------
>     NODE17 Open       7     1346  13   1   0  7460  453639.7   7  31            10040
>     NODE22 Open       0 Infinite  13   1   0  1426 3000000.0   1   8                5

>        .
>        .
>        .

#2
    SCACP> SHOW VC/ALL

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

>     SYS999 PEA0 VC Summary 31-JAN-2001 10:59:11.26:

>     Remote        Total         Channels ECS MaxPkt  ReXmt  XmtWindow  Xmt     Total
>      Node  State Errors Xmt:TMO Open ECS Pri  Size TMO(uSec) Cur Max Options Pkts(S+R)
>      ----  ----- ------ ------- ---- --- ---  ---- --------- --- --- ------- ---------
>     NODE17 Open       7     1346  13   1   0  7460  453639.7   7  31            10040
>     NODE22 Open       0 Infinite  13   1   0  1426 3000000.0   1   8                5
>        .
>        .
>        .

#3
    SCACP> SHOW VC/COUNTERS NODE10

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

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

### Parameters

> #### 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-2000 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) means of starting PEDRIVER on a LAN device is SYS$EXAMPLES:LAVC$START_BUS.

### Format

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

### Example

    SCACP> START 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 Compaq Services and OpenVMS Engineering only. Trace commands and output are subject to change from release to release.

### Format

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

> #### /DEFAULT

> Sets the trace context back to the default settings, which are:

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

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

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

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

> Use the SHOW LAN_DEVICE command to display device names.

> #### /LOCAL_DEVICE[=(landevicename1,landevice2,...)]

> Includes specific LAN devices which 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[=(landevicename1,landevice2,...)]

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

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

###

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

#3
    SCACP> START TRACE/LOCAL=EWA/REMOTE=EWB NODE10,
    NODE15/L=F*/R=F*, NODE20

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

>     START TRACE NODE10/L=EWA/R=EWB, NODE15/L=F*/R=F*, NODE20/L=EWA/R:EWB

> In the example, the command starts tracing for the following channels:

> - To node NODE10, channels with local device EWA and remote device EWB
> - To node NODE15, channels with local LAN device starting with F and remote LAN device starting with F
> - To node NODE20, channels with local LAN device EWA and remote LAN device EWB

## STOP LAN_DEVICE

> Directs PEDRIVER to stop using the specified LAN device. The original (and still supported) means of stopping PEDRIVER on a LAN devices is SYS$EXAMPLES:LAVC$START_BUS.

> Caution As with SYS$EXAMPLES:LAVC$STOP_BUS, you can cause the system to CLUEXIT if you do not maintain at least one path to each member of the cluster.

### Format

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

### Example

    SCACP> STOP LAN_DEVICE EWA

> This command stops PEDRIVER on the LAN device EWA.

## STOP TRACE

> Stops PEDRIVER tracing. You can read the trace data recorded so far with a SHOW TRACE command.

> To revert trace behavior to initial settings, enter the command SET TRACE/DEFAULT.

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

> STOP TRACE

### Parameters

> None.

### Qualifiers

> None.

### Example

    SCACP> STOP TRACE

> The command in this example stops PEDRIVER tracing.

Previous | Next | Contents | Index

| privacy and legal statement |
6048PRO_055.HTML