Envoy Configuration and Management Manual

Subsystem Control Facility (SCF) Commands for
Envoy
Envoy Configuration and Management Manual—429861-001
5-54
TRACE LINE Command
Considerations
•
If TO file-spec is specified, a new TRACE is initiated unless the file-spec is invalid,
the file cannot be opened, or trace is already active for the IOP. If TO file-spec is
omitted, the TRACE command applies to the trace currently in process, if any. If
there is no trace currently in process, SCF returns an error to the user.
•
The default RECSIZE of 120 is not sufficient for Envoy trace records. Use a
RECSIZE of 256 when starting the trace.
•
The keyword ALL selects all trace options.
•
The trace file size is limited to 70K bytes on disk. When the file is full, trace will
automatically be stopped. The WRAP option allows the trace records to wrap
around in the file. Specify WRAP if the data is expected to go over 70K bytes.
Examples
The following command starts a trace on the line, puts the results in a file named
TRCFILE, and selects the EIO, Poll, ReqRcvd trace options:
-> TRACE LINE $ENVY,TO TRCBIG, SELECT (EIO,Poll,ReqRcvd ) &
PAGES 64, RECSIZE 256, WRAP
The following command stops the trace of the line named $ENVY:
-> TRACE LINE $ENVY, STOP
The following command traces all items for the line named $ENVY:
-> TRACE LINE $ENVY, TO TRCBIG, SELECT ALL, RECSIZE 256, WRAP
PSM 30 Protocol state machine
PSMENTRY 31 Protocol state-machine entry
PSMEXIT 32 Protocol state-machine exit
REQRCVD 33 Requests received
REQRPLY 34 Requests replied
REQSEND 35 Requests sent
SPICMD 36 SPI commands and status
SPICMDCMPL 37 SPI command completion and status
SPIENTRY 38 SPI entry
SPIEXIT 39 SPI exits
WAITTIME 40 Wait time
Table 5-6. Select Specification for a LINE Object (page 2 of 2)
Keyword Value Enables tracing of...