User Exit Reference › USREXIT4 User Exit › Definitions

Definitions

A(VM userid)

Indicates the address of the user ID for which the tape is being mounted. If the mount is part of a CA VM:Batch job, it is the address of the user ID submitting the job. This field is padded on the right with blanks; that is, it is left-justified.

Following user ID is an 80-byte work area that you can use to pass information between exits. This area is used by the Bin system exits BINEXIT3 and BINACNT. Be sure these areas are not overlaid if you are using the Bin system.

A(VM userid account number)

Indicates the address of the 8-byte account number obtained from the VMBLOK or ACCTBLOK of the user ID issuing the mount. Also, if the mount is part of a CA VM:Batch job, it is the account number of the user submitting the CA VM:Batch job.

A(TMC record for requested volser)

Indicates the address of the 340-byte TMC record for the volser that was mounted. The file TMRECORD COPY on the CA VM:Tape 192 minidisk, describes the format of this record. Use it to access various fields in the record. Because this exit is called after a successful ATTACH, the TMC record passed contains up-to-date data including information about the current mount.

A(Character string: SL, NL, BLP, or AL)

Indicates the address of a character string indicating the label processing for the mount. This character string is three bytes long and padded with blanks on the right; that is, it is left-justified. The values can be SL for standard label tapes, NL for non-labeled tapes, BLP for bypass label processing and AL for ASCII-labeled tapes.

A(Character string: R/O or R/W)

Indicates the address of a character string indicating the access type for the mount. This character string is three bytes long. The values can be R/W for read/write mounts and R/O for read/only mounts.

A(Userid requesting the mount)

Indicates the address of the user ID that issued the MOUNT command, if the mount is a MOUNTFOR, SAVEFOR, or OWNEDBY mount.

A(Userid to charge for this mount)

Indicates the address of the user ID using a Diagnose X‘4C' to forward all charges to another user ID. This user ID is different from the user ID in the first parameter (VM user ID) only if an ACCTBLOK is created by the user ID issuing the mount.

For example, if a user delegates another user to mount the tape, it is the address of the first user - the one who delegates the job - that belongs in this field.

A(Common User Exit Buffer)

Indicates the address of the 256-byte work area to be used for passing information between the various user exits. This work area is specific to each command being processed by CA VM:Tape and cannot be used across commands.

A(DSName)

Indicates the address of the data set name for the tape being requested. This character string is 44 bytes long and is left-justified.

A(ThisDate)

A(ThisTime)

Indicates the address of the current date and time of the mount being processed. This date and time also represent the creation time and creation date when writing a new data set or mounting a scratch tape. For more information about Date and time formats, see Field Types.