VMTAPE CONFIG File Record Reference › USEREXIT Record › Parameter Descriptions

Parameter Descriptions

The following provides a description of each parameter:

USERACNT filename [TEXT]

Indicates the name of the user exit that lets you write site-specific accounting information to the TMC accounting field (field name ACCT). This routine is entered for successful scratch mounts just before the TMC Record is written to change the volume from a scratch to an owned tape.

USERCMND filename [TEXT]

Indicates the name of the user exit that examines all commands and then accepts, modifies, or rejects their execution.

USEREDDF filename [TEXT]

Indicates the program that supplies the input and output editing for site-defined EDITDEF field types.

USEREDIT filename [TEXT]

Indicates valid only with an OS TMC. Translates alphanumeric volsers into Record numbers that are used to process OS TMC records.

USERSECR filename [TEXT]

Indicates the name of the user exit that is called whenever volume control information is accessed or whenever a volume or volume data access is requested. This exit receives control on specific scratch and non-scratch MOUNT, CATALOG, LIST, EDIT, and QUERY commands.

USREXIT1 filename [TEXT]

Indicates the name of the user exit that receives control at the beginning of the mount process for foreign (non-TMC) tapes. This user exit provides a way to control how non-TMC tapes are handled by CA VM:Tape.

USREXIT2 filename [TEXT]

Indicates the name of the user exit that receives control early in the mount process before CA VM:Tape performs its security validation. This exit receives all non-scratch and specific scratch mounts. It provides a way to customize CA VM:Tape security validation or to bypass it altogether.

USREXIT3 filename [TEXT]

Indicates the name of the user exit that receives control for all mounts immediately after the VOL1 label is read but before normal CA VM:Tape label validation. This user exit provides a way to customize CA VM:Tape tape label processing or bypass it altogether.

USREXIT4 filename [TEXT]

Indicates the name of the user exit that receives control after attaching the successfully mounted tape to the user. This exit creates an accounting Record for each mount request through the CP Diagnose X‘04C'.

USREXIT5 filename [TEXT]

Indicates the name of the user exit that can request a Data Security Erase (DSE) for designated scratch mounts according to conditions defined in the exit. The routine is entered just after the mount has been determined to be a valid scratch write mount and the TMC is updated from scratch to owned status.

USREXIT7 filename [ EXEC ] | [ TEXT ]

Indicates the name of the user exit that rewinds and positions the tape on the CA VM:Tape service virtual machine just before the drive is attached to the user ID. Use of this exit will help prevent users from overwriting the VOL1 label.

USREXIT8 filename [TEXT]

Indicates valid only with an OS TMC. This user exit reformats TMC records to allow compatibility with tape management systems that have slightly different TMC formats.

USREXIT9 filename [ EXEC ]

Indicates the name of a REXX only user exit that can be used to retrieve various information about the tape that is about to be mounted.

ALLOCATE filename [ EXEC ]

Indicates the name of a REXX only user exit that can be used to manipulate the drives in the EDL, and to modify drive usage information.

COMMAND filename [ EXEC ]

Indicates the name of a REXX only user exit that can be used to examine all commands and then accept, change, or reject their execution.

TCPAUTH filename [ EXEC ]

Indicates the name of a REXX only user exit that can be used to customize authorizations for TCP/IP API requests.