Print CICS Trace (PRTCICSTRC)

Where allowed to run:

Batch job (*BATCH)
Interactive job (*INTERACT)
Batch program (*BPGM)
Interactive program (*IPGM)
Batch REXX procedure (*BREXX)
Interactive REXX procedure (*IREXX)
Using QCMDEXEC, QCAEXEC, or QCAPCMD API (*EXEC)

Threadsafe: No

The Print CICS Trace (PRTCICSTRC) command produces a job-oriented report from the CICS auxiliary trace user spaces. Entries are selected for inclusion in, or exclusion from, the report based upon a variety of job details and interval times.

Top

Parameters

Keyword	Description	Choices	Notes
TRCUSRSPC	Auxiliary Trace user space	Element list	Required, Positional 1
	Element 1: Object name	Character value
	Element 2: Library name	Character value, *LIBL
TRCFMT	Message/data format	BASIC, FULL, *NONE	Optional, Positional 2
OPTION	Trace entry type	Values (up to 5 repetitions): ALL, ENTRY, ERROR, EVENT, EXIT, USER	Optional, Positional 3
TRANID	CICS Transaction Id	Character value	Optional, Positional 4
TERMID	CICS Terminal Id	Character value	Optional, Positional 5
TRCNUM	CICS Trace number	Values (up to 25 repetitions): Hexadecimal value	Optional, Positional 6
JOBNUM	CICS Job number	Decimal number	Optional, Positional 7
PERIOD	Time period of trace	Element list	Optional, Positional 8
	Element 1: Start time and date	Element list
	Element 1: Start time	Time, *AVAIL
	Element 2: Start date	Date, *BEGIN
	Element 3: Ending time and date	Element list
	Element 1: End time	Time, *AVAIL
	Element 2: End date	Date, *END

Top

Auxiliary Trace user space (TRCUSRSPC)

Specifies the name and location of the auxiliary trace user space object to report on.

Element 1: Object name:

Specify the name of the auxiliary trace table user space object.

object-name: The name of the auxiliary trace table user space object.
Element 2: Library name:

Specify the name of the library where the CICS auxiliary trace user space object exists.
*LIBL: The library list is used to locate the CICS auxiliary trace user space object.
library-name The name of the library where the auxiliary trace user space object exists.

Top

Message/data format (TRCFMT)

Specifies the type of format that is produced for this report. Possible values are:

*FULL: All trace data is printed up to a maximum of 4000 bytes.
*BASIC: A maximum of 3 lines of 32 bytes each of trace data is printed.
*NONE: No trace data is printed.

Top

Trace entry type (OPTION)

Specifies the information being printed. Any combination, up to five, of the following may be selected.

*ALL: All trace entries are selected for the report.
*ENTRY: All trace entries marked as ENTRY are selected for the report.
*ERROR: All trace entries marked as ERROR are selected for the report.
*EVENT: All trace entries marked as EVENT are selected for the report.
*EXIT: All trace entries marked as EXIT are selected for the project.
*USER: All trace entries marked as USER are selected for the report.

Top

CICS Transaction Id (TRANID)

Specifies the transaction identifier that is to be used for producing the trace information.

Top

CICS Terminal Id (TERMID)

Specifies the terminal identifier that is to be used for producing the trace information.

Top

CICS Trace number (TRCNUM)

Specifies the trace numbers that are used for producing the trace information. Up to 25 may be specified.

Top

CICS Job number (JOBNUM)

Specify the six-digit number of a job to select. All six digits must be specified (use leading zeros, if necessary).

Top

Time period of trace (PERIOD)

Specifies the period of time for which the auxiliary trace entries in the specified user space object is shown. This parameter contains two lists of two elements each.

Element 1: Starting Time

One of the following values is used to specify the starting time at which or after which the auxiliary trace entries are collected. Data collected before the specified time and date is not included in the report.

*AVAIL: The auxiliary trace entries in the specified user space object that are available for the specified starting date are shown.
start-time: Specify the starting time after which the data must be collected to be included in the report. The time is specified in 24-hour format and can be specified with or without a time separator:
- Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Hours, minutes, and seconds must each be exactly 2 digits (use leading zeros if necessary).
- With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
Element 2: Starting Date

One of the following values is used to specify the starting date on which or after which the auxiliary trace entries are collected. Data collected before this date is not included in the report.
*BEGIN: Data records starting from the beginning of the trace file are included in the report.
start-date: Specify the starting date. The date must be specified in the job date format.
Element 3: Ending Time

Use one of the following values to specify the ending time. Data collected after this time and date is not included in the report.
*AVAIL: The logged data that is available for the specified ending date is shown.
end-time Specify the ending time for the specified ending date that determines the auxiliary trace entries to be printed. See start-time for the formats in which time can be entered.
Element 4: End Date

Use one of the following values to specify the date to end collection of the data records. Data collected after the specified date and time is not included in the report.
*END: Data records through the last day and time of the collection period are included in the report.
end-date: Specify the ending date for which the auxiliary trace entries are to be printed. The date must be specified in the job date format.