OPTIONS parameter

The values for the OPTIONS parameter for the CTnIOSxx parmlib member and reply for a TRACE command are listed below.

DCM

Traces events relating to Dynamic Channel Path Management.

Note: When DCM is active and this option is set, large amounts of trace data will be recorded. Users may wish to consider using an external writer when this option is set.

Traces the results of the cancel subchannel (XSCH) instruction.

EXTEND

Traces all functions that are attached in the IOS address space.

Note: Some functions attached in the IOS address space are traced during minimum or unexpected event tracing.

Traces the results of the cancel subchannel (XSCH) instruction.

STORAGE

Traces events related to IOS or EXCP storage management. When the STORAGE option is specified, the NOFILTER option or ASID/JOBNAME keywords must also be set.

CAPTURE

Traces the capturing and uncapturing of UCBs. When the CAPTURE option is specified, the NOFILTER option or ASID/JOBNAME keywords must also be set.

NOFILTER

Allows the STORAGE option to be set without requiring ASID or JOBNAME filtering.

DS=nnnn

Allows the user to tailor the IOS Trace Data Space where nnnn is the data space size in megabytes.

Note:

nnnn must be a valid decimal digit within the range of 1-1024.
This option can only be specified once at IPL time and cannot be modified using the TRACE CT command.
The default size for the IOS Trace Data Space is 512M. This can require additional auxiliary storage on systems with a small amount of available auxiliary storage. Please refer to Decide where to collect the trace records for information about auxiliary storage for CTRACE data space buffers. Since some options such as STORAGE and DCM will cause more CTRACE entries to be recorded, the IOS Trace Data Set may fill up more rapidly than if none of these options is specified. Users who do not have enough auxiliary storage capacity to handle a full data space may choose to use the DS=nnnn option to set up a smaller IOS Trace Data Space. Similarly, users who do have enough auxiliary storage capacity to handle a full data space may choose to use the DS=nnnn option to set up a larger IOS Trace Data Space. Doing this will prevent potentially valuable debug information from being lost due to wrapping. Note that the number of records contained in a trace data set are highly variable and dependent upon trace settings and system usage.

If the DS=nnnn option is specified more than once, the request is rejected and the following message is issued:

IOS622I IOS COMPONENT TRACE OPTION xxxxxxxx IS NOT VALID - 
        THE TRACE DATA SPACE SIZE HAS ALREADY BEEN SET
        FOR THIS IPL

If the size specified is not valid, then the request is rejected, the default IOS Trace Data Space size is used, and the following message is issued:
```
IOS622I IOS COMPONENT TRACE OPTION xxxxxxxx IS NOT VALID -
        THE REQUESTED SIZE FOR THE TRACE DATA SPACE IS 
        INCORRECT
```

HPAV

Traces events relating to HyperPAV bind and unbind activity. This option may cause large amounts of trace data to be recorded. It should be utilized as a debug tool when needed and not enabled for normal operations.

PCIE

Traces events related to PCIE activity. End of change