Tape Movement Exit Program
| Required Parameter Group: | |||
| 1 | Operational information | Input | Char(*) |
| Exit Point Name: QIBM_A1A_TAPE_MOVE | |||
| Exit Point Format Name: MEDM0100 | |||
The exit program is called each time a BRMS registered volume is moved. It will supply the location the volume is moving to and the previous location where the volume came from. To use this exit point you will need to develop an exit program and register it to the exit point name and exit point format name listed above. After registration, BRMS will call the program and pass the information described by the parameters.
Required Parameter Group
- Operation information
- INPUT; Char(*)
Information about the tape movement operation at the time the exit program is called.
Format of Operational Information
The following table shows the format of the operational information. For a description of each field, see Field Descriptions.
| Offset | Type | Field | |
|---|---|---|---|
| Dec | Hex | ||
| 0 | 0 | Binary(4) | Length of operational information |
| 4 | 4 | Char(6) | Volume ID |
| 10 | 0A | Char(8) | Expiration date |
| 18 | 12 | Char(1) | Expired indicator |
| 19 | 13 | Char(10) | Current location |
| 29 | 1D | Char(6) | To slot |
| 35 | 23 | Char(10) | Previous location |
| 45 | 29 | Char(6) | From slot |
| 51 | 33 | Char(10) | Volume next location |
| 61 | 3D | Char(8) | Move date/time |
| 69 | 45 | Char(10) | Media class |
| 79 | 4F | Char(10) | Container ID |
| 89 | 59 | Char(10) | Move policy |
| 99 | 63 | Char(1) | Move verification pending |
Field Descriptions
- Container ID
- The identifier of the container if you are using containers to move media. A special value *NONE is returned if you are not using containers.
- Expiration date
- The date that the volume expires. The format of the date that
is returned is job date format. The values are:
- *NONE
- There is no expiration date. The volume is expired.
- *VER EXP
- The volume is under version control and has expired.
- *VER nnn
- The volume is under version control.
- *PERM
- The volume has a permanent retention date.
- From slot
- The slot from which the volume came.
- Length of operational information
- The length of the data in the structure.
- Media class
- The media class of the volume that is being moved. A special value *NONE is returned if a media class is not found.
- Move policy
- The move policy associated with the volume that you are moving. A special value *NONE is returned if you are not using a move policy.
- Move verification pending
- Indicates whether BRMS marked
the volume for movement and based on the move policy specified above,
whether the move must be verified before it can actually occur. The
values are:
- 0
- Verification of moves is not in effect and the volume has been moved when this exit point is reached. The current location is the location to which the volume was moved.
- 1
- The volume has not moved yet, verification of moves is in effect and the location shows the current location of the volume. The next location shows where BRMS intends to move the volume.
- Move date/time
- The date that the volume is to move. The format of the date that
is returned is job date format. The values are:
- *NONE
- There is no move date. The volume does not move.
- *VER EXP
- The volume is under version control and has expired.
- *VER nnn
- The volume is under version control.
- To slot
- The slot in the location to which the volume is being moved.
- Volume ID
- The volume ID of the volume that is being moved.
- Current location
- The location to which the volume is moving. A special value *NONE is returned if the volume does not have a current location.
- Previous location
- The location from which the volume is being moved. A special value *NONE is returned if the volume does not have a previous location.
- Volume next location
- The location to which the volume will be moved after this move. A special value *NONE is returned if the volume does not have a next location.