TRACE for buffer, I/O, QDIOSYNC, SMS, or STATE (with ID) traces
- Do not use NOTRACE when starting VTAM®, except to override a TRACE start option coded in a predefined list.
- Code TRACE and its qualifiers on one line. Code the TYPE qualifier immediately after TRACE.
Specifies whether VTAM starts or cancels a specific type of trace for a node or line, or monitors the usage of all the VTAM buffer pools.
If you code the TRACE option, code the TYPE qualifier immediately after TRACE.
You can specify a network-qualified name on the ID=node_name operand of the TRACE start option for buffer, I/O, and QDIOSYNC traces.
- AMOUNT
- Specifies whether VTAM records
part or all of the data that is transmitted in inbound and outbound
message buffers.
- AMOUNT=PARTIAL
- Specifies that VTAM records the data in trace records with a maximum size of 256 bytes. Each trace record contains a trace record header and data. Data that does not fit in the trace record is lost. This operand can be abbreviated as AMT=P.
- AMOUNT=FULL
- Specifies that VTAM records all of the data transmitted in message buffers. Multiple trace records might be needed to record all of the data. This operand can be abbreviated as AMT=F.
- EVERY
- Specifies that VTAM starts
or stops the requested trace for the resource named in the ID operand
and all appropriate minor nodes of this resource.
You can abbreviate this operand as E.
This operand applies only to buffer and I/O traces. For example:TRACE,TYPE=IO,ID=line name,E
This start option initiates an I/O trace for the line and each of its minor nodes.
This operand is not valid if ID=ISTPUS or ID=ISTIRN is also coded. If ID names a channel-attachment major node, code the EVERY option. You can name the link in a channel-attachment major node, but you cannot name the link station.
- IDTYPE
- Specifies the type of resource that the ID operand names. In cases
where several types of resources share the same name, IDTYPE can be
used to identify which resource the start option should act on.
If both a CP and an SSCP have the name specified on the ID operand, then both resources are traced.
IDTYPE is valid only for the buffer contents, I/O, and resource state traces.- IDTYPE=CP
- Specifies that the name on the ID operand is a CP. Only the trace for a host CP or for the cross-domain resource that represents the adjacent CP is affected by this start option.
- IDTYPE=SSCP
- Specifies that the name on the ID operand is an SSCP. Only the trace for an SSCP is affected by this start option.
- IDTYPE=RESOURCE
- Specifies that the name on the ID operand is one of the following
items. VTAM looks for the resource
in the order they are listed here:
- SSCP
- Host CP
- Adjacent CP
- Another resource
- ID=line name
- Names the specific line for which a VTAM trace
is started or stopped. line name corresponds
to the name on the LINE statement that represents the same line.
Each line traced must be explicitly coded in a TRACE start option.
- ID=node name
- Names the specific node for which a VTAM trace is started
or stopped. node name corresponds to the name assigned to the node and
filed in the VTAM definition library. node
name can be a network-qualified name for the buffer and I/O traces. See the
description of the MODIFY TRACE command in z/OS Communications Server: SNA Operation for a list of the types of nodes
you can choose.
For a CDRM, you can specify a network-qualified name, but this does not remove the restriction that the non-network-qualified CDRM name must be unique across networks.
You can use ID=VTAM to trace all SSCP activity and, in a multiple-domain network, all cross-domain resource manager activity. You can use ID=ISTPUS or the HOSTPU value to trace all SSCP-PU activity. Each terminal or logical unit traced must be explicitly coded in a TRACE start option.
- ID=trle_name|*
- When TYPE=QDIOSYNC is specified, the ID operand specifies the
TRLE name of the OSA-Express2 or later adapter for which diagnostic
data synchronization and filtering is to be started or stopped. Specify
ID=* to start or stop QDIOSYNC for all TRLEs that define OSA-Express2
or later adapters. When the value ID=* is specified with SAVE=NO,
ID=* indicates that the QDIOSYNC command is to be applied to all currently
active TRLEs that define OSA-Express2 or later adapters. When the
value ID=* is specified with SAVE=YES, ID=* indicates that the QDIOSYNC
command is to be applied to all currently active TRLEs that define
OSA-Express2 or later adapters and to those that are activated by
this VTAM in the future.
When multiple QDIOSYNC NOTRACE or TRACE start options are specified, the last one that is applicable to a specific TRLE name takes precedence. For example, coding TRACE TYPE=QDIOSYNC,ID=TRLE1 requests synchronization for a single OSA-Express2 or later adapter but the request is cancelled if it is followed by NOTRACE TYPE=QDIOSYNC,ID=*. Coding TRACE TYPE=QDIOSYNC,ID=* requests synchronization of all OSA-Express2 or later adapters and, if it is followed by NOTRACE TYPE=QDIOSYNC,ID=TRLE1, it results in the synchronization of all OSA-Express2 or later adapters except TRLE1.
- NOTRACE
- Specifies that VTAM cancels the trace requested by the TYPE operand. You should code this start option only when you need to override a predefined TRACE start option. Code a separate NOTRACE start option to stop each trace.
- OPTION
- For the value TYPE=QDIOSYNC, the OPTION operand specifies the
scope and filter to be applied by the OSA-Express2 or later adapter.
The option specifies the devices and the direction for which diagnostic
data is to be gathered. You can abbreviate this operand as OPT.
- OPTION=ALLIN
- Indicates that the adapter should gather diagnostic data for all devices, including any that might be controlled by other operating systems. This option also indicates that the adapter should collect records pertinent to events and data flowing from the adapter to the host. Code the value OPTION=ALLIN only when advised by IBM® service to do so.
- OPTION=ALLINOUT
- Indicates that the adapter should gather diagnostic data for all devices, including any that might be controlled by other operating systems. This option also indicates that the adapter should collect both inbound and outbound diagnostic data.
- OPTION=ALLOUT
- Indicates that the adapter should gather diagnostic data for all devices, including any that might be controlled by other operating systems. This option also indicates that the adapter should collect records pertinent to events and data flowing from the host to the adapter. Code OPTION=ALLOUT only when advised by IBM service to do so.
- OPTION=IN
- Indicates that the adapter should gather diagnostic data for devices defined to this VTAM only. This option also indicates that the adapter should collect records pertinent to events and data flowing from the adapter to the host. Code OPTION=IN only when advised by IBM service to do so.
- OPTION=INOUT
- Indicates that the adapter should gather diagnostic data for devices defined to this VTAM only. This option also indicates that the adapter should collect both inbound and outbound diagnostic data. Code OPTION=INOUT only when advised by IBM service to do so.
- OPTION=OUT
- Indicates that the adapter should gather diagnostic data for devices defined to this VTAM only. This option also indicates that the adapter should collect records pertinent to events and data flowing from the host to the adapter. Code OPTION=OUT only when advised by IBM service to do so.
- SAVE
- Applies to TYPE=BUF, TYPE=IO, TYPE=QDIOSYNC, and TYPE=STATE. It
specifies whether the trace request is saved for the resource named
on the ID operand.
- SAVE=YES
- VTAM saves the trace request
for the resource named on the ID operand. If the resource exists when
this request is issued, the trace starts immediately. If the resource
does not exist when this request is issued, VTAM saves the trace command and starts the
trace when the resource is defined.
For TYPE=BUF, TYPE=IO, and TYPE=STATE, if you start a trace with IDTYPE=RESOURCE and a CP or an SSCP (but not both) exists when the command is issued, VTAM starts the trace for the existing resource and saves the trace commands for both resources. If both a CP and an SSCP exist when the command is issued, VTAM starts tracing for them immediately.
For TYPE=QDIOSYNC:- If you specify ID=trlename, any saved command from a previous TRACE TYPE=QDIOSYNC start option for that TRLE is deleted.
- If you specify ID=*, all saved commands from previous TRACE TYPE=QDIOSYNC start options are deleted
Use the MODIFY NOTRACE command to delete a saved trace command. VTAM will not delete a saved trace command until you issue a MODIFY NOTRACE command for it, even though the resource might be created and freed or activated and deactivated several times. Saved trace commands are lost when VTAM is halted and restarted.
- SAVE=NO
- Does not save the trace request. If the resource does not exist when you start the trace, the request fails.
- SYNCID
- Optional operand valid for TYPE=QDIOSYNC. The OSA-Express2 or
later uses this value as part of an identifier when it captures diagnostic
data. If this operand is not specified, the trlename value
is used.
Restriction: If you specify a value for SYNCID, it must conform to the rules for names detailed in Format of definition statements.
- TRACE
- Specifies that VTAM starts a specific type of trace for a node or line, or monitors the use of all the VTAM buffer pools. Once started, the trace remains in effect until it is stopped, either by stopping VTAM or by entering the MODIFY NOTRACE command. More than one trace can run concurrently, but code a separate TRACE start option to start each trace.
- TYPE=BUF
- Specifies whether a VTAM buffer trace is started or stopped.
- TYPE=IO
- Specifies whether a VTAM I/O trace is started or stopped.
- TYPE=QDIOSYNC
- Use TYPE=QDIOSYNC to synchronize and optionally apply a scope
and filter to OSA-Express2 or later diagnostic data. Arming the OSA-Express2 or later directs it to capture diagnostic data when there is an unexpected loss of host connectivity. Data is also captured when the following conditions occur:
- The VTAM-supplied message processing facility (MPF) exit (IUTLLCMP) is driven.
- Either the VTAM or TCP/IP
functional recovery routine (FRR) is driven with ABEND06F. ABEND06F
is the result of a PER trap SLIP command that specifies ACTION=RECOVERY.
Restriction: The SLIP must be a PER trap SLIP in order to specify ACTION=RECOVERY.
- TYPE=SMS,ID=VTAMBUF
- Specifies that VTAM monitors the number of its requests to obtain buffers in the VTAM buffer pools. (After a specified number of requests occur, the trace creates a record to show how the pools are being used at that time.) If you code TYPE=SMS, also code ID=VTAMBUF.
- TYPE=STATE
- Specifies whether a resource state trace is started or stopped to monitor changes in the state of the resource named on the ID operand.