Running the Report Using JCL

TSSRPTSG Statistics Report › Running the Report Using JCL

Running the Report Using JCL

TSSRPTSG uses standard CA Top Secret report JCL for batch submission. For example:

//TSSRPTSG JOB 1,'STATS RPT',MSGCLASS=A
//*
//REPORT EXEC PGM=TSSRPTSG
//*
//RECMAN1 DD DSN=IFASMF.XE15.SMFLOG,DISP=SHR,
//SUBSYS=(LOGR,IFASEXIT)
//SYSPRINT DD  SYSOUT=*
//SYSUDUMP DD  SYSOUT=*
//SYSIN    DD  *
INCLUDE(-)
//

The report will also accept input via PARM=:

//TSSRPTSG JOB 1,'STATSRPT',MSGCLASS=A,
//*
//REPORT  EXEC  PGM=TSSRPTSG,PARM=('INCLUDE(-)',
//  'EXCLUDE(CACHE,COMMAND),LINECNT(20)')
//RECMAN1    DD  DSN=SYS1.MAN1,DISP=SHR
//SYSPRINT   DD  SYSOUT=*
//SYSUDUMP   DD  SYSOUT=*
//SYSIN      DD  DUMMY
//

TSSRPTSG JCL Parameters

For each of the following parameters (with the exception of PRINTER|TERMINAL):

Enclose the input in parenthesis
Separate multiple features with commas

Example: JCL parameter syntax

This example shows the INCLUDE parameter with three features specified:

INCLUDE(CACHE,SYSPLEX,RACROUTE)

TSSRPTSG JCL Parameter List

Function(feature)

Specifies the name of the security feature statistics are reported for. Possible values for this field are shown in the section 'Feature Field Values'. Only one feature

value can be specified for the Function keyword.

Example:

Function(SYSPLEX)

Note: This parameter is mutually exclusive with the INCLUDE and the EXCLUDE parameters.

INCLUDE(feature1,feature2,…)

Specifies the name of the security feature or features statistics are reported for. Features specified can be masked with a dash (-), for example INCLUDE(C-). Possible values for this field are shown in the section 'Feature Field Values'.

Example:

INCLUDE(RACROUTE,IOSTATS)

Note: This parameter is mutually exclusive with the FUNCTION parameter.

EXCLUDE(feature,feature2,…)

Specifies multiple security features to be omitted from the report. Features specified can be masked with a dash (-), for example EXCLUDE(RAC-).

Possible values for this field are shown in the section 'Feature Field Values'.

Example:

EXCLUDE(SYSPLEX)

Note: This parameter is mutually exclusive with the FUNCTION parameter.

LINECNT(value)

Specifies the number of lines printed per page. Specify numeric values for this parameter.

Example:

LINECNT(20)

Default: 60

TITLE(value)

Specifies a one to 35 character string that is part of the report's page header. If the character string is longer than 35 characters an error message is issued.

Example:

TITLE(TEST REPORT - APRIL 2006)

Default: CA Statistics Log

SDATE(value)

Specifies the beginning date from which records should be selected for the report. Valid input is numeric values in yyddd format.

Example:

SDATE(06031)

Default: 00000

EDATE(value)

Specifies the ending date records should be selected for the report. Valid input is numeric values in yyddd format.

Example:

EDATE(06100)

Default: 99365

STIME(value)

Specifies the beginning time from which records should be selected for the report. Valid input is numeric values in hhmm format.

Example:

STIME(0900)

Default: 0000

ETIME(value)

Specifies the ending time for which records should be selected for the report. Valid input is numeric values in hhmm format.

Example:

ETIME(1700)

Default: 2359

PRINTER|TERMINAL

Specify:

PRINTER-The report produces a report format designed for output to a 133-column line printer.
TERMINAL-The Report uses the default format designed to fit a limited width display terminal.

Function Field Values

Possible values for the FUNCTION, INCLUDE, and EXCLUDE fields of the TSSRPTSG report are:

CACHE

Returns the statistics collected from the CACHE Facility. The following statistics are returned:

Total maximum size of the CACHE
Total size of the CACHE in use
Total number of calls received in CACHE
Total number of calls satisfied in CACHE
Total number of times CACHE cleared

CPF

Return the statistics collected from the Command Propagation Facility. The following statistics are returned for each node:

Total number of inbound command requests
Total number of outbound command requests
Total number of inbound password requests
Total number of outbound password requests
Total number of returned outbound requests

RACROUTE

Returns the SAF RACROUTE request statistics. The following statistics are returned:

Total number of REQUEST= AUTH
Total number of REQUEST= FASTAUTH
Total number of REQUEST= LIST
Total number of REQUEST= DEFINE
Total number of REQUEST= VERIFY
Total number of REQUEST= EXTRACT
Total number of REQUEST= DIRAUTH
Total number of REQUEST= TOKENMAP
Total number of REQUEST= VERIFYX
Total number of REQUEST= TOKENXTR
Total number of REQUEST= TOKENBLD
Total number of REQUEST= EXTRACT (BRANCH)
Total number of REQUEST= AUDIT
Total number of REQUEST= STAT
Total number of REQUEST= SIGNON
Total number of REQUEST= TOKENMAP (Cross memory MODE)
Total number of REQUEST= EXTRACT (Cross memory MODE)

SYSPLEX

Returns the statistics collected from the Sysplex Coupling Facility. The following statistics are returned:

Total number of writes
Total number of reads
Total number of deletes
Total number of messages sent
Total number of messages retrieved

COMMAND

Returns the statistics collected from commands entered in CA Top Secret. The following statistics are returned:

Total number of CREATE commands issued
Total number of DELETE commands issued
Total number of ADD commands issued
Total number of REPLACE command issued
Total number of RENAME commands issued
Total number of REMOVE commands issued
Total number of PERMIT commands issued
Total number of REVOKE commands issued
Total number of WHOOWNS commands issued
Total number of WHOHAS commands issued
Total number of LIST commands issued
Total number of HELP commands issued
Total number of LOCK commands issued
Total number of UNLOCK commands issued
Total number of WHOAMI commands issued
Total number of MODIFY commands issued
Total number of ADMIN commands issued
Total number of DEADMNIN commands issued
Total number of MOVE commands issued
Total number of REFRESH commands issued
Total number of GENCERT commands issued
Total number of GENREQ commands issued
Total number of EXPORT commands issued
Total number of CHKCERT commands issued
Total number of MLWRITE commands issued
Total number of REKEY commands issued
Total number of ROLLOVER commands issued

WORKLOAD

Returns the statistics collected from the use of Command Processor Subtasks within CA Top Secret Security. The following statistics are returned:

Total number of commands issued
Command Processor Subtask 1 (percent use)
Command Processor Subtask 2 (percent use)
Command Processor Subtask 3 (percent use)
Command Processor Subtask 4 (percent use)
Command Processor Subtask 5 (percent use)
Command Processor Subtask 6 (percent use)
Command Processor Subtask 7 (percent use)
Command Processor Subtask 8 (percent use)
Command Processor Subtask 9 (percent use)
Command Processor Subtask 10 (percent use)

IOSTATS

Returns the statistics collected from Input/Output activity within CA Top Secret Security. The following statistics are returned:

Number of RACINITS
Number of SRI Calls
Total RACINITS,RACHECKS,RACDEFS,RACLISTS
Number of Violations
Number of EXEC intercepts
Number of SMF Records Dumped
Number of Security File Changes
Number of Security File Changes Dumped
Number of Audit Records Written
Number of Reads to the Security File
Number of Writes to the Security File
Number of Waits High Water Mark
Number of RCBs in WAIT Queue
Number of Lock I/Os issued
Number of Failed lock I/Os

SECCACHE

Returns the statistics collected from the SECCACHE facility. The following statistics are returned:

Maximum size of cache data area
Size of cache data area in use
Percentage of cache data area in use
Maximum number of index entries
Number of index entries in use
Percentage of index entries in use
Number of successful ADD requests
Number of successful DELETE requests
Total number of GET requests
Number of satisfied GET requests
Percentage of GET requests satisfied
Number of SHARE enqueue waits
Number of EXCLUSIVE enqueue waits
Number of data area alloc failures
Number of index area alloc failures
Lowest security record size in cache
Highest security record size in cache
Average security record size in cache
Record expiration interval in hours
Threshold full warning level