Previous Topic: TMSUPDTE Utility—Apply Batch Updates to TMC Volume RecordsNext Topic: Job Control Statements


Report Description

TMSUPDTE produces TMS Report 14 - TMC Batch Updates and TMS Report 14 - TMSUPDTE Error Cross-Reference.

The TMC Batch Updates report reflects the update, informs you of the update error, and gives warnings that the data set is expired. If a record is not found, you are notified. A sample of this report appears on TMS Report 14 - TMC Batch Updates.

The Error Cross-Reference report provides a cross-reference to the update, giving the page number of the batch update report that contains the error and warning. A sample of this report appears on TMS Report 14 - TMSUPDTE Error Cross-Reference Report.

Some volume record fields may be rejected for update, depending upon the the media type of the volume.

The following TMC fields can only be updated for WORM tapes:

WWID  (physical WORM tapes only)
VWWID (virtual WORM tapes only)
WMC

The following TMC fields can only be updated for different, non-WORM tapes:

EDMID   (also valid for virtual WORM tapes)
DATECLN
USECLN
CLNCNT
TRERRC
TWERRC
PRERRC
PWERRC
TRERRI  (also valid for physical WORM tapes)
TWERRI  (also valid for physical WORM tapes)

The following TMC fields cannot be updated by TMSUPDTE.

AUCODE	BATCHID
AUDATE	CPUID
AUFLAG1 HOOKID
AUTIME	 USERID

While the FLAG1 field can be updated, the scratch indicator (X'04) cannot be set by a batch update. The batch TMSCLEAN program and the CA 1 ISPF interface are the only means of marking tapes for scratch. Certain field updates related to multivolume data sets require that the update is performed to the first volume of the set (although this can be overridden with TMSUPDTE). These fields are:

ACCT	DEN	FLAG5	OUTCODE
BLKSIZE DSN	LABEL	OUTDATE
CDATE	EXPDT	LDATE	RECFM
CJOB	FLAG1	LJOB	SLOTS
CPGM	FLAG2	LPGM	SMSMC
CSTEP	FLAG3	LRECL	TRTCH
CTIME	FLAG4	LTIME	1STDSNB

Any manual update to a record results in the FLAG1 X'20' bit being turned on indicating the update. If the update is for a field considered internal or critical to CA 1, the X'80' bit is also set in FLAG1. To bypass setting the internal field updated bit (X'80' in FLAG1), the NOINTAL keyword can be specified on the VOL control statement. The default fields to which this applies are:

EXPDT	FLAG4	NUMDSNB VOLSEQ
FLAG1	FLAG5	PREVVOL 1STDSNB
FLAG2	LSTDSNB SLOT	 1STVOL
FLAG3	NEXTVOL VOLSER

Audit related fields are always automatically updated (AUDATE, AUTIME, AUCODE, BATCHID, CPUID, USERID).

Update the following keywords with hexadecimal values.

These fields are:

CUNIT
DEN
LABEL
LUNIT
RECFM
ROBTY
TRTCH

Note: For more information about the values for each keyword, see the CA 1 Tape Management Systems Programmer Guide.