The trace selection parameters for DFHTU700
Use the trace selection parameters to define the number of lines to be printed on a page and to define which trace records you want to select for printing. You code the trace selection parameters in the DFHAXPRM DD statement or in the PARM parameter.
//PRINT EXEC PGM=DFHTU700,PARM='selection_parameter,selection_parameter,...'- ABBREV|SHORT|FULL
- Specifies how much of each trace entry you want printed. If you
specify this statement, it must always be the first statement in either
the PARM parameter or the DFHAXPRM data set.
- ABBREV
- Indicates that you require the abbreviated, one-line-per-entry, form of trace print.
- SHORT
- Indicates
that you require the short formatted print of the data in each entry.
This consists of the information in the abbreviated format entry,
and the following elements from the interpretation string of the fully
formatted entry:
- Interpreted parameter list
- Return address
- Time
- Interval
- FULL
- Indicates that you want a fully formatted print of all the data in each entry. This is the default.
- ALL
- Specifies that all trace entries in the auxiliary trace data set are to be printed. This is the default.
- ENTRY_NUM=({nnnnnnn|nnnnnnn-nnnnnnn}[,{nnnnnnn|nnnnnnn},.,.,.])
- Specifies
the sequence numbers of one or more trace entries that you want to
print. Each sequence number can be up to seven digits in length. If
you specify a range of sequence numbers by using xxxxxxx-yyyyyyy,
the second sequence number (yyyyyyy) must be larger
than the first (xxxxxxx).
Note: Use alternative trace selection parameters if there are more than 9999999 trace entries, and, you require any entry beyond the first 9999999 to be printed. Only the first set of entries with numbers from 000001 to 9999999 will be printed.
- EXCEPTION
- Specifies
that only exception trace entries in the auxiliary trace data set
are to be printed. Note: This parameter is not valid for printing GTF trace entries.
- INTERVAL={0.0128|number of seconds}
- Specifies the interval between auxiliary trace entries after which entries are highlighted with an asterisk as follows:
- In abbreviated trace format, the asterisk appears to the left of the sequence number.
- In full trace format, the asterisk appears as the next character after the printed time interval.
If successive auxiliary trace entries are written at intervals equal or greater than this limit, they are highlighted in the same manner.
If successive auxiliary trace entries are written at intervals less than this limit, they are not highlighted. They are, however, written, formatted, and printed.
If you specify no INTERVAL value, a default of 0.0128 seconds applies.
You can specify interval values in the range zero seconds (all trace entries are highlighted) through 99.9999999999 seconds.
Note: The interval extends to ten decimal places. Zeros are padded from the right. - KE_NUM=(xxxx[,xxxx,.,.])
- Specifies that only the entries for tasks with the specified hexadecimal kernel task numbers are printed.
- LAST_BLOCKS=n
- For
internal trace, specifies that only the last n blocks
of the trace table are printed, counting from the most recently used
block in the internal trace table. You can specify a value in the
range 1 through 262144.
If this parameter is not specified, all blocks are formatted.
You can use this parameter to reduce the storage and time requirements associated with formatting a large internal trace table in a system dump. To decide how many blocks to print to see the trace entries that you require, allow for approximately 25 entries per block.
This parameter does not apply to trace in transaction dumps, auxiliary trace, or GTF trace.
- PAGESIZE=(value)
- Specifies
the number of lines printed on a page. You can specify a value in
the range 20 through 9999 lines per page. If you specify an incorrect
value, CICS issues an error message and stops the trace. The default
value is 55. Note: This parameter is not valid for printing GTF trace entries.
- TASKID=({id|id-id}[,,{id|id-id},.,..])
- Specifies
the task identifiers of one or more tasks for which trace entries
are to be printed. An ID value can be in any of the following forms,
to compare with the task field in the formatted trace data:
- Any number up to five decimal digits long
- Any of the character strings JAS, J01 through J99, III, TCP, or DSTCB
- Any non-numeric two-character domain ID of the attaching domain (for non-TCA) tasks.
You can specify a range of task identifiers of the five decimal digit form by using a hyphen (for example, TASKID=nnnnnn-nnnnnn).
- TCB_ID=(aaaaa[,aaaaa,.,.,.])
- Specifies the TCB identifiers of one or more TCBs for which trace entries are to be printed.
- TCB_ADDR=(hhhhhhhh[,hhhhhhhh,.,.,.])
- Specifies the address of one or more TCBs for which trace entries are to be printed.
- TERMID=(tttt[,tttt,.,.,.])
- Specifies
the terminal identifiers of one or more terminals for which trace
entries are to be printed.
If you use the TERMID parameter to specify the trace entries you want formatted, the DFHTU700 program selects all the trace entries that are associated with any transaction-attach trace entries it finds that contain the terminal identifiers you specify. For more information about how trace entries for tasks are associated with transaction-attach trace entries, see Identifying trace entries from their transaction-attach entries.
- TIMERG=(hhmmss-hhmmss[,hhmmss-hhmmss,.,.,.])
- Specifies
the time period or periods for which trace entries are to be printed.
Time periods are shown by pairs of values represented as hours (hh),
minutes (mm), and seconds (ss)
separated by a hyphen. The ending value of each pair must be later
than the starting value.
The DFHTU700 program converts the store-clock (STCK) values in the trace entries to whole seconds before comparing against the time range you specify. Fractions of a second are ignored; that is, all times are rounded down to the nearest whole second, which means in effect that the minimum time span can be up to two seconds. For example, if you specify TIMERG=153000-153001, the DFHTU700 program includes all trace entries with times of 153000.00000000 to 153001.99999999 inclusive.
Note: This parameter is not valid for printing GTF trace entries. - TRANID=(tttt[,tttt,.,.,.])
- Specifies
the transaction identifiers of one or more transactions for which
trace entries are to be printed.
If you use the TRANID parameter to specify the trace entries you want formatted, the DFHTU700 program selects all the trace entries that are associated with any transaction-attach trace entries it finds that contain the transaction identifiers you specify. For more information about how trace entries for tasks are associated with transaction-attach trace entries, see Identifying trace entries from their transaction-attach entries.
- TYPETR=({ddxxxx|ddxxxx-xxxx}[,{ddxxxx|ddxxxx-xxxx}])
- Specifies
the trace entry identifiers for the particular domain entries, specified
by the domain ID and a point ID within the domain.
- dd
- Represents the domain identifier:
Code Component name AP Application domain BA Business application manager BM* Basic mapping support BR* 3270 bridge CP* Common programming interface DC* Dump compatibility layer DD Directory manager domain DH Document handling domain DM Domain manager domain DP Debugging profiles domain DS Dispatcher domain DU Dump domain EC* Event capture and emission EI* Exec interface EJ Enterprise Java™ domain EM Event manager domain EP Event processing domain FC* File control GC Global catalog domain IC* Interval control IE ECI over TCP/IP domain IS* ISC or IRC KC* Task control KE Kernel LC Local catalog domain LD Loader domain LG Log manager domain LM Lock domain ME Message domain ML Markup language domain MN Monitoring domain MP Managed platform domain NQ Enqueue domain OT Object transaction domain PA Parameter domain PC* Program control PG Program manager domain PI Pipeline domain PT Partner domain RA Resource manager adapters RI* Resource manager interface (RMI) RL Resource life-cycle domain RM Recovery manager domain RS Region status domain RX RRS-coordinated EXCI domain RZ Request streams domain SC* Storage control SH Scheduler services domain SJ JVM domain SM Storage manager domain SO Sockets domain ST Statistics domain SZ* Front End Programming Interface (FEPI) TC* Terminal control TD* Transient data TI Timer domain TR Trace domain TS Temporary storage domain UE* User exit interface US User domain WB Web domain WU CICS® Management Client Interface (CMCI) domain W2 Web 2.0 domain XM Transaction manager domain XS Security manager domain Notes:- Components marked * are subcomponents of the AP domain. The trace entries for these components are produced with a trace point ID of AP nnnn.
- For the DS domain function CHANGE_MODE, a trace entry is generated if DS level 2 or 3 tracing is active.
- xxxx
- Represents the point ID within the domain in the form of a four-character hexadecimal value (0000-FFFF). You can specify a range of point IDs by using a hyphen.
- UPPERCASE
- Specifies that you want the trace output in uppercase only. If you want trace output in mixed case (the default), do not code this parameter.