Qualifying selection and exclusion criteria options for a trace
Selection keyword | Exclusion keyword | Description |
|---|---|---|
PGMTYPE | NA | Qualifies a trace request by program type The default is all types. You can specify multiple types:
|
TRANTYPE | NA | Qualifies a trace request by transaction type The default is all types. You can specify multiple types:
|
TRAN | XTRAN | Qualifies a trace request by including (TRAN) or excluding (XTRAN) specified IMS or CICS transaction Valid entries are 1- to 8-character alphanumeric transaction codes. Multiple transaction codes can be specified with a positional qualifier. For CICS DBCTL transactions, use the CICS transaction code. For Fast Path transactions, use the routing code assigned by the DBFHAGUO exit routine. |
CLASS | XCLASS | Qualifies a trace request by including (CLASS) or excluding (XCLASS) numeric scheduling classes Multiple classes can be specified as CLASS 1 2 3. The default includes all IMS scheduling classes. |
PSB | XPSB | Qualifies a trace request by including (PSB) or excluding (XPSB) specified IMS program specification blocks Valid entries are 1- to 8-character alphanumeric PSB names. You can specify multiple PSB names with a positional qualifier. |
REGION | XREGION | Qualifies a trace request by including (REGION) or excluding (XREGION) specified IMS region job names Valid entries are 1- to 8-character alphanumeric region job names. You can specify multiple region job names with a positional qualifier. |
USERID | XUSERID | Qualifies a trace request by including (USERID) or excluding (XUSERID) specified IMS sign-on user IDs Valid entries are 1- to 8-character alphanumeric IMS sign-on user IDs. You can specify multiple user IDs with a positional qualifier. |
PROG | XPROG | Qualifies a trace request by including (PROG) or excluding (XPROG) specified programs Valid entries are 1- to 8-character alphanumeric program names. You can specify multiple program names with a positional qualifier. |
RGNID | NA | Qualifies a trace request by specified region ID Enter a 1- to 3-character numeric region ID from 1 to nnn, where nnn is a valid region number. You can specify multiple region IDs with a positional qualifier. |
DATABASE | XDB | Qualifies a trace request by the specified database |
DB2PLAN | XDB2PLAN | Qualifies a trace request by the specified Db2 plan |
ABEND | NA | Qualifies a trace request by abend code where the operand can be +, Sxxx, or Uxxxx, where xxx/xxxx is an alphanumeric code You can specify the following abend types:
|
VTAMNODE | XVTMNODE | Qualifies a trace request by the VTAM node name. Valid entries are 1- to 8-character alphanumeric names, which can include generic qualifiers. Multiple VTAM node names can be specified with a positional qualifier. Generic values of type LCB0* LCB0++S0 are acceptable. |
OTMAMAP | XOTMAMAP | Qualifies a trace request by the OTMA map name Valid entries are 1- to 8-character alphanumeric names. Multiple OTMA map names can be specified with a positional qualifier. Generic names of type ABCD* CFDE++GH are acceptable values. |
OTMACORR | XOTMACOR | Qualifies a trace request by the OTMA correlator name Valid entries are 1-to 16-character alphanumeric names. Multiple OTMA correlator names can be specified with a positional qualifier. OTMA User Data may contain correlators. Some of these are provided by BMC AMI Energizer for IMS Connect, or by IMS Connect itself. Correlators are used for specific features of IMS Connect, such as SYNCH CALLOUT. |
TMEM | NA | Qualifies a trace request by OTMA member name or that IMS Connect job or the started task name If monitoring by IMS Connect name, the BMC AMI Energizer for IMS Connect product must be installed. |
TERM | XTERM | The names of LTERMs or Tpipes to be included (TERM) or excluded (XTERM) from monitoring Valid entries are 1- to 8-character alphanumeric names, which can include plus qualifies. Multiple names can be specified. For DBCTL transactions, this is the 4-character CICS terminal ID. |
ICONIP | XICONIP | Qualifies a trace request by the IMS Connect client IP address You can specify multiple specific or generic IP addresses with a positional qualifier. When using these keywords in a dialog box, do not use quotation marks. When using them in an autoblock member, use single quotation marks (for example '173.23.123.56','10.23*'). |
ICONPRT | NA | Qualifies a trace request by the IMS Connect port number You can specify multiple specific port numbers with a positional qualifier. Valid entries are 1- to 5-character numeric port number from 1 to 65,535 representing the TCP/IP port for an IMS Connect. |
The plus sign qualifier can be used generically or positionally:
- As a generic resource name qualifier, the plus sign cannot be followed by any other character. For example, REGION=CICS+ traces only regions whose names begin with CICS, while XREGION=CICS+ traces only regions whose names do not begin with CICS.
- As a positional qualifier, the plus sign must be repeated for every character to be replaced. For example, TRAN=A++N+ traces all events that have an identifiable transaction code with an A character in the first position, any two characters before the N, and any character following the N. XTRAN=A++N+ traces all events that do not have an identifiable transaction code with an A character in the first position, any two characters before the N, and any character following the N.