Previous Topic: TLMSXUPD - Volume Master File Update ExitNext Topic: CTSUXEDM - Defining External Data Manager Tapes

User Exits and Macros › TLMSXUPD - Volume Master File Update Exit › Use

Use

The user exit will gain control for automatic functions and manual updates. The exit is passed the address of the update transaction record and the address of the Volume Master File base volume record. You will receive control in the following cases:

  1. At CLOSE/EOV of an output tape data set.
  2. At CLOSE/EOV of an input tape data set.
  3. At OPEN of an output data set during the volume mount and verification phase.
  4. For manual updating (TSO, TLTPISPF, INQR, and TRS).
  5. At OPEN of an input data set.

The DSECT for the update transaction record is named TLMSTRAN.

TLMSUPDT calls your exit using standard operating system linkage. Register 1 points to a parameter list which contains the

You must set the return code (in register 15) to zeros when returning from the exit. If set to a nonzero value, the transaction is ignored, and no update takes place.

T6SUBTYP must be set to either 1 (reject tape) or 0 (accept tape). If T6SUBTYP is other than one of these two values, the online recorder will abend with a user code of 997. T6NONVMF=# indicates that either EXPDT=98000 or SPACE=(1,(1,1)) was used to indicate a foreign volume, or the volume is not in the VMF. T6RESVOL=Y indicates the volser is in the VMF; T6RESVOL=N indicates that the volser is not in the VMF.

You can control the data set protection feature of CA TLMS by examining both the TRANREC record and the VMFBASE record. If you decide to reject the volume (disallow OPEN for output), place the character 1 in the field T6SUBTYP and set R15 to a nonzero value. TLMSUPDT will then return to the operating system OPEN module and force a dismount of the volume. If you decide to allow the volume to be opened for output, but do not want CA TLMS's data set protection logic to be executed, place the character 0 (zero) in the T6SUBTYP field and set R15 to a nonzero value. TLMSUPDT will then return to the operating system OPEN module and allow the volume to be used.

Note: When a foreign volume condition exists for cases 1, 2 or and 3, X'FF' (high values) is placed in the Volume Master File base volume record.

This user exit should be assembled and linked through SMP USERMOD. An example of the JCL is located in CAI.CTAPJCL (TLMJU017).