Previous Topic: TSSREPORT UtilityNext Topic: TSSREPORT3 Utility


TSSREPORT2 Utility

TSSREPORT2 uses the output from the TSSUTIL utility to produce flat file (straight sequential disk) output for use with CA‑Earl, if you include the optional EarlOUT DD statement in the execution JCL.

TSSREPORT2 JCL

The JCL is found in the CAI.SAMPJCL file on the distribution tape.

//REPORT       JOB
//Earl         EXEC PGM=Earl,REGION=4096K
//EarlLIB       DD DISP=SHR,DSN=your.source.library
//EarlOBJ       DD UNIT=unit,SPACE=(3200,(50,4),RLSE)
//SYSUT1        DD UNIT=unit,SPACE=(3200,(15,4),RLSE)
//SYSUT2        DD UNIT=unit,SPACE=(3200,(4,4))
//SYSUT3        DD UNIT=unit,SPACE=(3200,(4,4))
//SYSUT4        DD UNIT=unit,SPACE=(3200,(10,4),RLSE)
//SYSUT5        DD UNIT=unit,SPACE=(3200,(70,4),RLSE)
//SYSUT6        DD UNIT=unit,SPACE=(3200,(15,1),RLSE)
//SORTIN        DD UNIT=unit,SPACE=(3200,(70,4),RLSE)
//SORTOUT       DD UNIT=unit,SPACE=(3200,(70,4),RLSE)
//WORK1         DD UNIT=unit,SPACE=(3200,(300,200))
//SORTWK01      DD UNIT=unit,SPACE=(3200,(70,4))
//SORTWK02      DD UNIT=unit,SPACE=(3200,(70,4))
//SORTWK03      DD UNIT=unit,SPACE=(3200,(70,4))
//SYSUDUMP      DD SYSOUT=*
//SYSPRINT      DD SYSOUT=*
//SYSOUT        DD SYSOUT=*
//TSSUTI        DD DSN=name.of.tssutil
//SYSIN         DD DISP=SHR,DSN=your.source.library(TSSEarlA|B|C|D)
EarlLIB

Defines the CA‑Earl macro library. This source statement library is referenced by the COPY statement within the user's CA‑Earl source program.

EarlOBJ

Defines the file on which the CA‑Earl text file is stored.

SORTIN

Defines the temporary hit file, which contains only the fields from the input records, which are needed to produce the final printed reports. If required to sort the hit file, SORTIN defines the input file to the stand‑alone sort invoked by CA‑Earl.

SORTOUT

Defines the temporary output file from the stand‑alone sort.

WORK1

Defines the SRAM (Sort Reentrant Access Method) file.

SORTWK01

Used with SORTWK02 and SORTWK03, defines the temporary work files for the stand‑alone sort.

TSSUTI

The name of your TSSUTIL OUT file. You must run TSSUTIL before running TSSREPORT2. See TSSUTIL JCL in the chapter “USSUTIL Utility” for the JCL needed to run that utility.

You can generate reports by putting the TSSUTIL output (OUT DD) in a permanent data set and using this data set to run multiple CA‑Earl reports. This saves time by allowing you to run many reports from the same data.

You can also run TSSUTIL and write the output to a temporary data set. Use this temporary data set as input for your TSSREPORT2 JCL.

SYSIN

The input control statement. Put the name of the report you wish to run after the name of your source library: TSSEarlA, TSSEarlB, TSSEarlC or TSSEarlD for whichever report you select.

Note: PARM= in the JCL refers to the input parameters as defined in the next section.

TSSREPORT2 Selection Criteria

Reports A through D are described in the following pages. Input parameters, if any, appear in the boxes and are followed by definitions of both required and optional parameters. The headers that appear on each report output follow the respective report sample.

The DATE format for each report is MM/DD/YY. This can be modified with the CA‑Earl installation options.

Note: See the topic Command Syntax in the chapter “TSSUTIL Utility” for a list of syntax conventions to be used in these reports.

Sample Report A - Data Set Violations

Generates a list of all violations against data sets. This list is sorted by ACID and indicates the number of violations per data set.

PARM=

There are no input parameters for this report.

VERSION 9.0 ADMINISTRATION REPORT UTILITY2
12/07/02   REPORT A: REPORT OF DATASET and NUMBER OF VIOLATIONS    PAGE 1
_________________________________________________________________________
           ACID           DATASET NAME                   NO. OF VIOLATION
_________________________________________________________________________

           USER001        AUDT001.CLIST                                  4
           USER001        SYS1.BRODCAST                                  1
           USER001        SYS1.MACLIB                                    1
                                                                    ‑‑‑‑‑‑
           USER001                                                       6
                                                                    ‑‑‑‑‑‑
           USER002        AUDT001.CLIST                                  1
                                                                    ‑‑‑‑‑‑
           USER002                                                       1
                                                                    ‑‑‑‑‑‑
                                                                    ‑‑‑‑‑‑
                                                                         7
GRAND TOTAL                                                         ‑‑‑‑‑‑
ACID

Lists the ACID responsible for the data set violation.

DATASET NAME

Lists the name of the data set the user attempted to access.

NO. OF VIOLATIONS

Lists the number of violations against each data set.

For TSSUTIL report selection criteria, select EVENT(VIOL).

Sample Report B - Requested vs. Allowed Access

Lists all access violations against each data set and indicates which ACID requested access, what type of access was requested and what access level was allowed for that ACID. This list is sorted according to data set name.

PARM=

There are no input parameters for this report.

DATE

Indicates the date when the ACID attempted to access the data set.

TIME

Indicates the time at which access was attempted.

DATASET NAME

Indicates which data set the ACID attempted to access.

ACID

Indicates the ACID which incurred the violation.

REQ ACCESS

Indicates what access level the ACID requested to the data set.

ALLOWED ACCESS

Indicates the actual level at which the ACID is allowed to access the data set.

For TSSUTIL report selection criteria, specify EVENT(VIOL).

Sample Report C - Password Violations

Lists all ACIDs that have received password violations.

PARM=

There are no input parameters for this report.

VERSION 9.0 ADMINISTRATION REPORT UTILITY2
23/07/02    REPORT C: REPORT OF PASSWORD VIOLATIONS                       PAGE 1
________________________________________________________________________________
            DATE        TIME           ACID           TSSTEXT
________________________________________________________________________________

            94162       15:17:47       USER001        PASSWORD INCORRECT
            94162       15:17:33       USER001        PASSWORD INCORRECT
            94162       15:17:03       USER001        PASSWORD INCORRECT
            94162       15:16:49       USER001        PASSWORD INCORRECT
            94162       15:19:23       USER002        PASSWORD INCORRECT
            94162       15:19:12       USER002        PASSWORD INCORRECT
END OF REPORT
DATE

Lists the date that the violation occurred.

TIME

Lists the time that the violation occurred.

ACID

Indicates which ACID incurred the violation.

TSSTEXT

Details, in plain language rather than in DRC code numbers, the type of password violation which occurred.

For TSSUTIL report selection criteria, specify EVENT(VIOL).

Sample Report D - Terminal Violations

Generates a list of all terminal violations. The type of violation is explained in text, not by DRC code.

PARM=

There are no input parameters for this report.

VERSION 9.0 ADMINISTRATION REPORT UTILITY2
23/07/02      REPORT D: REPORT OF TERMINAL VIOLATIONS      PAGE 1
_________________________________________________________________
   DATE   TIME         TERM ID                TSSTEXT
_________________________________________________________________

   94162  15:17:47     K18L4258               PASSWORD INCORRECT
   94162  15:17:33     K18L4258               PASSWORD INCORRECT
   94162  15:17:03     K18L4258               PASSWORD INCORRECT
   94162  15:16:49     K18L4258               PASSWORD INCORRECT
   94162  15:19:23     A29LP021               PASSWORD INCORRECT
   94162  15:19:32     A29LP021               PASSWORD INCORRECT
   94164  12:58:29     INTRDR                 SYSTEM FACILITY NOT AUTHORIZED
   94164  12:58:49     INTRDR                 ACID NOT DEFINED

END OF REPORT
DATE

Indicates the date on which the violation occurred.

TIME

Indicates the time that the violation occurred.

TERM ID

Indicates the terminal at which the violation occurred.

TSSTEXT

Details the type of violation that occurred.

For TSSUTIL report selection criteria, specify

EVENT(VIOL)RESOURCE(TERMINAL)