Working with Third Party Tape Media Libraries

BRMS can support some third party (non-IBM) media libraries. To add third-party media libraries to BRMS, take the following steps:

1. Attach the device to your system.
2. Type WRKCFGSTS CFGTYPE(*DEV) CFGD(TAP*) at a command line to view the list of stand-alone devices and media libraries on the Work with Configuration Status display.
3. At this display find the name of the third-party device you want to add to BRMS.
4. Type WRKDEVBRM at a command line and press Enter.
5. At the Work with Devices display, type a 1 (Add) in the Opt field.
6. Type the name of the device you want to add in the Device column.
7. Enter the device type *USRMLB (for user-defined MLB) in the Category column. Then press Enter.
8. At the Add User Media Device display, type in the third-party commands responsible for the following activities:
   • Location (this must be the same location as the *USRMLB devices)
   • Text description
   • Mount or eject media
   • Insert and add media
   • Work with and display media
   • Work with and display status
   • Allocate and deallocate media
   • Start and End media movement
   • Work with and display status
   The customer or media library manufacturer must provide commands and the program interface to BRMS and the MLB.
   Note:

   Uppercase should be used for these variables.

   myCommand dev(&DEVICE) vol(&VOLUME) mlb(&MLBNAME)

9. Fill out the additional parameters as needed.
10. Press Enter to add the device entry to BRMS.

Customers or manufacturers can use the following variables with each of the MLB commands. The tape exit supplies the values for these variables.

• DEVICE: the tape device name.
• VOLUME: the volume identifier.
• MLBNAME: the BRMS name of the third party MLB.

BRMS supplies the following messages for users of third-party media libraries. You can find them in message file Q1AMSGF in library QBRM.

• BRM1990: User exit retry operation message.
• BRM1991: User exit failure operation message.

If BRMS issues these messages as escape messages, then BRMS retries (BRM1990) or fails (BRM1991) the job as appropriate. Use the Work with Registration Information (WRKREGINF) command to add and register a program to an exit point.