MEDIACONTROLS VOLUMES and MEDIACONTROLS(SDSP) VOLUMES: Requesting an audit of control information

Explanation: MEDIACONTROLS VOLUMES and MEDIACONTROLS(SDSP) VOLUMES(volser...) are mutually exclusive parameters that are specified to audit control records as follows:

MEDIACONTROLS audits control information contained in migration copies and backup versions.

MEDIACONTROLS(SMALLDATASETPACKING) audits only the SDSP (small data set packing) data sets on the specified volumes.

In either case, VOLUMES(volser...) is a required parameter. For (volser...) substitute a volume serial number or a list of volume serial numbers. Each serial number must identify a DFSMShsm-owned, single-file format, tape backup or migration volume or a DASD migration volume.

Defaults: None.

Note:

If DFSMShsm is unable to complete output processing to backup or migration tapes, an incomplete TTOC is created. When an audit is performed against these tapes, the AUDIT function positions to the last data set described by that portion of the TTOC that was written successfully and then proceeds to audit the tape from that point forward.

RESUME can be specified on the AUDIT MEDCTL VOLUMES(tape volser) FIX Command in order to resume a previously interrupted audit in the case where the AUDIT was held, DFSMShsm was stopped, or SETSYS EMERGENCY was specified.

RESUME is only valid for migration and backup tapes. It is not valid when specified with SDSP or when the volser specified is for a DISK volume.

RESUME is only valid when FIX is also specified. If the initial AUDIT is issued without specifying FIX and the AUDIT is held, and then the generated FIXCDS commands are manually issued, the results of AUDIT MEDCTL with RESUME are unpredictable. Manually entering patches generated by NOFIX is discouraged by IBM®.

AUDIT will not be able to RESUME after abends or experiencing an I/O error or a point or note failure. If you CANCEL the AUDIT TASK using the CANCEL TCBADDRESS Command, be sure to first HOLD AUDIT in order for RESUME to execute.

If RESUME is validly specified, but the required information and records are not available, AUDIT will start at the beginning of the tape.

If RESUME is specified on the command, message ARC0877I will be issued stating the volser and extension on which AUDIT is starting.

Note: When audit is held or stopped, the function terminates. After audit terminates and before the AUDIT MEDCTL RESUME command is issued, the volume is available for all functions. Following are some situations that will affect the resumed audit:

If the volume is RECYCLED and then DELVOLED, the TTOC is deleted and the audit cannot be resumed.
If RECALLS or RECONNECTIONS occur for data sets already audited, the valid block count will not reflect this when the resumed audit completes.
If additional entries are added to the volume by migration or backup, the audit will resume at the interrupt point and continue on through the new entries as usual.
However, if the additional entries result in a FAILEDCREATE situation where the TTOC is not consistent with the contents of the tape media and TTCFAIST is ON, the RESUME parameter will be ignored and audit will add the missing TTOC entries. On completion of this audit, the AUDIT MEDCTL RESUME command can be issued again and audit will then resume with the last data set being processed when audit was held.