CHANGES Control Statement

TSSAUDIT Utility › TSSAUDIT JCL › CHANGES Control Statement

CHANGES Control Statement

Lists changes made to the Security File.

[CA(acid) ]
 CHANGES   [DATE(-nn) ]
[STRING(string) ]

CA: Only those changes made by the specified control ACID are to be listed. If omitted, all changes are listed.
DATE: Only those changes made on or after the starting date are listed. The starting date to search the Recovery File is obtained by subtracting the number of days ('nn') from the current date. The value 'nn' can be any number from 00 to 99. If omitted, no date restrictions are applied.
STRING: Only those changes containing the specified string entries are listed.

Because TSSAUDIT reads the entire CA Top Secret Recovery File into memory when the CHANGES control statement is specified, the server's virtual storage size may need to be increased when the CHANGES control statement is specified. Insufficient storage is indicated by a 2719 abend.

Each record in the Recovery File is subjected to the following checks to determine if it meets your selection criteria.

Was the change made within the period implied by the DATE operand? (If the DATE is omitted, all those changes made from the beginning date of the Recovery File are listed.)
Was the change made by the ACID indicated in the CA operand? (This check is bypassed if the CA operand was omitted.)
Is the change within your scope? (Only those changes within your scope will be listed.) For example, a VCA can list changes for her division, and all departments within her division.
Does the change contain the string specified in the STRING operand? (This check is bypassed if the STRING operand was omitted.)

The following describes the information header line for CHANGES listing:

Header	Explanation
CHANGER	Lists the ACID name of the user that made the change.
DATE	Lists the date on which the change was made. (Date information appears in the form specified in CA Top Secret's DATE startup option.)
TIME	Lists the time at which the change was made.
SYSID	Lists the VMLOGID or SMF identifier of the CPU on which the change was made.
TYPE	Indicates the type of change: CMND-TSS command PW-Password change AVO-Automatic Volume Ownership DUF-DUFUPD
COMMAND/IMAGE	Lists the TSS command used to make the change or a simulated TSS command for PW, AVO, DUF.

If the CHANGES control statement is specified, and you are not the MSCA, you must have the following administrative authority:

TSS ADMIN (Auditor's acid) ACID(REPORT) RESOURCES(REPORT)