Keywords

You can use the following CTRACE keywords with TCP/IP component trace formats:

JOBLIST, JOBNAME

Use the JOBLIST and JOBNAME keywords to select packet trace records with a matching link name. However, only the first 8 characters of the link name are matched and no asterisks are accepted in the job name. Also, use them to match the job name in data trace records.

ASIDLIST

Use the ASIDLIST to select trace records only for a particular address space.

GMT

The time stamps are converted to GMT time.

LOCAL

The time stamps are converted to LOCAL time.

SHORT

If the OPTIONS string does not specify any reports, then format the trace records. Equivalent to the FORMAT option.

FULL

If the OPTIONS string does not specify any reports, then format and dump the trace records. Equivalent to the FORMAT and DUMP options.

SUMMARY

If the OPTIONS string does not specify any reports, then create a one line summary for each trace record. Equivalent to the SUMMARY option.

TALLY

If the OPTIONS string does not specify any reports, then count the trace records.

START and STOP

These keywords limit the trace records that are seen by the formatter. The STOP keyword determines the time when records are no longer seen by the packet trace report formatter.

Rule: CTRACE always uses the time the trace record was moved to the buffer for START and STOP times.

LIMIT

Determines the number of records the formatter is allowed to process.

USEREXIT

The CTRACE USEREXIT is called for TCP/IP formatter, except for the packet trace formatters. Therefore, the packet trace formatter calls the CTRACE USEREXIT before testing the records with the filtering criteria. If it returns a nonzero return code, then the record is skipped. The USEREXIT can also be used in the OPTIONS string. It is called after the record has met all the filtering criteria in the OPTIONS string. For details, see Formatting packet traces using IPCS.