Formatting a SYSAPPC trace

Format the trace with an IPCS CTRACE COMP(SYSAPPC) subcommand. Its OPTIONS parameter specifies the options that select trace records to be formatted. Your formatting options depend to a great extent on the tracing options you requested. Use the options to narrow down the records displayed so that you can more easily locate any errors. If the CTRACE subcommand specifies no options, IPCS displays all the trace records.

The options follow. The first option is either FILTER or CORRELATE, which are mutually exclusive; the first option controls how the other options select the records.
FILTER
The FILTER option selects the trace records that match only one of the specified options. The options that are valid with the FILTER option are:
  • AQTOKEN
  • CONVCOR
  • CONVID
  • FUNCID
  • INSTNUM
  • LUNAME
  • LUWID
  • NETNAME
  • SEQNUM
  • SESSID
  • TPIDPRI
  • TPIDSEC
  • URID
  • USERID
The formats of the OPTION parameter with FILTER are: 
OPTION((FILTER,option))
OPTION((FILTER,option,option, ... ,option))
CORRELATE
The CORRELATE option selects the trace records that match a specified option and, for an unspecified option, uses the option's default values. The DEFAULTS keyword defines how default values are found for the unspecified options. The options that are valid with the CORRELATE option are:
  • AQTOKEN
  • CONVCOR
  • CONVID
  • DEFAULTS
  • INSTNUM
  • LUNAME
  • LUWID
  • NETNAME
  • SEQNUM
  • SESSID
  • TPIDPRI
  • TPIDSEC
  • URID
The formats of the OPTION parameter with CORRELATE are: 
OPTION((CORRELATE,option))
OPTION((CORRELATE,option,option, ... ,option))
AQTOKEN(allocate-queue-token)
Use with either the FILTER or CORRELATE option to specify an allocate queue token. The allocate-queue-token is an 8-byte hexadecimal string.
CONVCOR(conversation-correlator)
Use with either the FILTER or CORRELATE option to specify a conversation correlation. The conversation-correlator is an 8-byte hexadecimal string.
CONVID(conversation-id)
Use with either the FILTER or CORRELATE option to specify a conversation identifier. The conversation-id is a 4-byte hexadecimal string.
||DEFAULTS(NONEANYEXACT)
Use only with the CORRELATE option to specify the values to be used for matching unspecified options.
NONE
Tells component trace to format only the trace records that match one or more of the specified options. NONE is the default.
ANY
Tells component trace to format:
  • Trace records matching one or more of the specified options.
  • Related trace records that match default values established for the unspecified options. Component trace derives the defaults from the values for unspecified options found in the first records that match any of the specified options.
EXACT
Tells component trace to format:
  • Trace records matching one or more of the specified options.
  • Related trace records matching default values established for the unspecified options. Component trace derives the defaults from the values for unspecified options found in the first records that match all of the specified options.
FUNCID(function-id)
Use only with the FILTER option to specify the APPC/MVS subcomponent trace records to format. Specify one function-id:
01
Recovery
02
Verb services
03
FMH-5 manager
04
Conversation manager
05
System data file manager (SDFM)
06
VTAM exits
07
LU manager
08
State machine
09
Test enablement
10
APPC/MVS scheduler (ASCH)
11
Transaction scheduler interface
12
Allocate queue services
INSTNUM(instance-number)
Use with either the FILTER or CORRELATE option to specify the instance number for a logical unit of work. The instance-number is a 6-byte hexadecimal string.
LUNAME(local-luname)
Use with either the FILTER or CORRELATE option to specify the LU name for the local logical unit of work. The local-luname is an 8-byte EBCDIC character string.
LUWID(logical-unit-of-work-id)
Use either the FILTER or CORRELATE option to specify a logical unit of work identifier, which represents the processing a program performs from one sync point to the next. To specify the logical-unit-of-work-id, enter the hexadecimal string as it appears in the CTRACE report, without including blank spaces.
NETNAME(network-name)
Use with either the FILTER or CORRELATE option to specify the network name for a logical unit of work. The network-name is an 8-byte EBCDIC character string, which is the same as the network-ID portion of a network-qualified LU name.
SEQNUM(sequence-number)
Use with either the FILTER or CORRELATE option to specify the sequence number for a logical unit of work. The sequence-number is a 2-byte hexadecimal string.
SESSID(session-id)
Use with either the FILTER or CORRELATE option to specify the session identifier. The session-id is an 8-byte hexadecimal string.
TPIDPRI(tp-id)
Use with either the FILTER or CORRELATE option to specify the primary TP identifier. The tp-id is an 8-byte hexadecimal string.
TPIDSEC(tp-id)
Use with either the FILTER or CORRELATE option to specify the secondary TP identifier, which is used for multi-trans TPs. The tp-id is an 8-byte hexadecimal string.
URID(unit-of-recovery-id)
Use with either the FILTER or CORRELATE option to specify a unit of recovery identifier, which represents part of a TP's processing for a protected conversation. The unit-of-recovery-id is a 32-byte hexadecimal string.
USERID(userid)
Use only with the FILTER option to specify a userid as a filter. The userid is an 8-byte EBCDIC character string.
Parent topic: SYSAPPC component trace