Previous Topic: TSSRPTST ParametersNext Topic: Sample TSSRPTST Output


Selection Criteria

The selection criteria used in generating the SAF Trace reports are listed below, with brief descriptions. All selection criteria are described in detail after the listing.

JOBMASK

Limits records appearing on the report to those for the job indicated by the job name mask.

TITLE

Specifies a character string added to other title information at the top of the report. This character string can be up to 35 characters in length.

LINECNT

The LINECNT (linecount) parameter specifies the number of output lines to be printed on a page.

SDATE

Specifies the start date of the report in Julian date format.

EDATE

Specifies the ending Julian date from which report information is selected.

STIME

Specifies the start time for the interval from which SMF records are selected.

ETIME

Specifies the end time for the interval from which SMF records are selected.

DETAIL

Specifies the report is to include all the information available for each logging event.

POSTLOG

Requests records created after security validation has completed.

PRELOG

Requests records created before security validation has occurred.

TRACEID

Specifies an eight‑character trace ID.

JOBMASK

Specifies that records appearing on the report are to be limited to those for the job indicated by the job name mask.

JOBMASK(********|jobmask,...)
********

Specifies all jobs are to appear on the report.

jobmask

Indicates jobs are to be limited to those meeting the masking criteria. Use commas or spaces to separate multiple masks.

TITLE

Specifies a character string added to other title information at the top of the report.

TITLE(string)
string

This character string can be up to 35 characters in length. If you do not specify this parameter, the report generator uses the first 35 characters in the PARM field of the EXEC statement. If this character string is longer than 35 characters, the first 35 characters are used.

LINECNT

Specifies the number of output lines (line count) to be printed on a page.

LINECNT(60|nnnnn)
nnnnn

Specifies the number of output lines to be printed on a page. To prevent splitting of information, CA Top Secret report generators that issue multiple line reports check to see whether a complete report item will fit on a page. The maximum number of output lines per page is limited only by the physical constraints of the output media being used, or to 99,999 lines.

SDATE

Specifies the beginning Julian date from which report information is to be selected.

SDATE(00000|yyddd)
yyddd

Specifies the date in Julian date format (last two digits of the year and the sequential number of the day). Any input SMF records generated before the SDATE value are ignored.

Default: 00000, all available records

EDATE

Specifies the ending Julian date for the selected report information.

EDATE(:hp5.99365:ehp5.|yyddd)
yyddd

Specifies the ending Julian date. When combined with the SDATE parameter, this parameter creates a window for report content. The default, 99365, specifies up to the time the job is run.

STIME

Specifies the beginning‑of‑time interval from which SMF records are selected. This time is based on a 24‑hour clock.

STIME(0000|hhmm)
hhmm

Specifies the time at which reporting on the selected SMF records is to begin. This time is based on a 24‑hour Any SMF records generated before this specified time of day are ignored. The selection of records begins at the STIME specified for each date in the SDATE/EDATE range.

Default: 0000, midnight

ETIME

Specifies the end‑of‑time interval from which SMF records are selected. This time is based on a 24‑hour clock.

ETIME(2359|hhmm)
hhmm

Specifies the time at which reporting on the selected SMF records is to end. Any SMF records generated after this specified time of day are ignored.

Default: 2359, one minute before midnight.

DETAIL

Specifies that the external data structures identified in the RACROUTE parameter list definition are displayed following the RACROUTE parameters. These external data structures are shown in both hexadecimal and EBCDIC formats.

POSTLOG

Requests records created after security validation has completed. These records contain the return and reason codes from the security call as well as the modified data structures.

PRELOG

Requests records created before security validation has occurred. These records contain the return and reason codes from the security call as well as the modified data structures.

TRACEID

Specifies an eight‑character trace identifier.

TRACEID(********|traceid)
********

(Default) Specifies all trace identifiers.

traceid

Specifies a trace ID. Masking can be used with trace IDs.