Previous Topic

Next Topic

Book Contents

Book Index

User Exits

The sample user exits in Table 23 (located in the IOA SAMPEXIT library) can optionally be installed as part of the Control-M/Tape to OAM interface.

Note: After compiling and linking the following sample exits, put the output modules in the LNKLST, as stated in the relevant IBM DFSMS Object Access Method documentation.

Table 23 Sample user exits

Exit

Description

CBRUXCUA

Change Use Attribute

Allows a change in the use attribute of a volume (SCRATCH to ACTIVE and vice versa) only if this change has already been recorded in the Media Database. Implementation of this exit helps maintain Media Database integrity.

CBRUXEJC

Tape Eject

Turns off the IN-ATL status bit in the volume record of ejected volumes.

CBRUXENT

Tape Entry

This exit does the following:

  • Turns on the IN-ATL status bit in the volume record of the inserted volume.
  • Updates the internal location (in the automated tape library) in the volume record of the relevant volume in the Media Database.
  • Sets the initial use attribute of the volume (that is, SCRATCH or ACTIVE) in the automated tape library to the status as indicated by the relevant volume record in the Media Database.

If the volume is not defined in the Media Database the status is set to ACTIVE (default).

However, if the automated tape library is shared with another environment (for example, another Control-M/Tape environment with a separate Media Database), it may be necessary to allow the other environment to set the volume’s status.

If it is necessary to allow the other environment to set the volume’s status, do not compile and link the exit before changing the &NOTINCTT parameter setting from P (PRIVATE) to I (IGNORE), as follows:

In the sample Exit CBRUXENT, in the IOA SAMPLE library, change.

&NOTINCTT SETC 'P'

– to –

&NOTINCTT SETC 'I'

Note: This sample sets the RECORDING-TECHNIQUE field (UXEREC) to UNKNOWN (that is, to UXENOREC) if no information is available. BMC recommends that you set your own default value by modifying the line marked @TRT. Valid values are listed after the UXENOREC label in the SYS1.MODGEN (CBRUXEPL) member.

CBRUXVNL

Volume Not In Library

Issues a message to the operator with the volume location (as recorded in the Media Database). On receipt of this message, the operator can insert the volume into the automated tape library and reply R (retry) to continue.

Note: This exit should only be implemented at sites where all mount requests are normally handled by the automated tape library.

Implementing this exit at site that often requires mounts outside the automated tape library, results in unnecessary messages.

Parent Topic

IBM Automatic Tape Library (ATL) and Virtual Tape Server (VTS)