User Exit Reference › USEREDIT User Exit (OS TMCs Only)

USEREDIT User Exit (OS TMCs Only)

Note: This user exit is not required if the TMSXTEND utility has been run.

Use the USEREDIT user exit to translate installation standard volsers into volsers recognized by CA 1. Use this exit to convert external tape volsers into the relative record pointer for each volume record in the CA 1 TMC.

This exit is required for the installation of the CA VM:Tape system using a OS TMC.

If you are using an OS TMC, CA VM:Tape looks for the USEREDIT user exit you specify on the USEREXIT USEREDIT record in the VMTAPE CONFIG file. If this record is not found, CA VM:Tape will default to look for a file called USEREDIT TEXT on any of its accessed minidisks. In either case, if the file is found CA VM:Tape loads it into memory. If the file is not found, CA VM:Tape will not initialize.

This version of the EXIT utilizes a static portion, TMSEXITU TEXT that is provided with CA VM:Tape; and, a customizable portion (TMSVOLDF TEXT) that must be modified for your site. Both portions (TEXT files) are required and must be on an accessed minidisk. You customize the TMSVOLDF portion by updating the provided TMSVOLDF ASSEMBLE file; then, assembling it. TMSEXITU dynamically loads the TMSVOLDF portion. Therefore your USEREXIT USEREDIT record in the VMTAPE CONFIG file should be entered as follows:

USEREXIT USEREDIT TMSEXITU

The exit must be written in assembler and must be reusable each time it is called.