Sample ISMF session for an IBM 3995 Optical Library Dataserver

The following series of panels illustrates an ISMF session defining a sample 3995 library and drive configuration. These panels will illustrate how to define libraries and drives for 3995-1xx, 3995-Cxx, and pseudo libraries. From the ISMF Primary Option menu for storage administrators (as shown in Figure 1), select option 10 to start the library management dialog.

Figure 1. ISMF Primary Option Menu
   Panel  Help
 ------------------------------------------------------------------------------
                            ISMF PRIMARY OPTION MENU - z/OS DFSMS V1R13
 Enter Selection or Command ===>

 Select one of the following options and press Enter:

  0  ISMF Profile              - Specify ISMF user profile
  1  Data Set                  - Perform Functions Against Data Sets
  2  Volume                    - Perform Functions Against Volumes
  3  Management Class          - Specify Data Set Backup and Migration Criteria
  4  Data Class                - Specify Data Set Allocation Parameters
  5  Storage Class             - Specify Data Set Performance and Availability
  6  Storage Group             - Specify Volume Names and Free Space Thresholds
  7  Automatic Class Selection - Specify ACS Routines and Test Criteria
  8  Control Data Set          - Specify System Names and Default Criteria
  9  Aggregate Group           - Specify Data Set Recovery Parameters
  10 Library Management        - Specify Library and Drive Configurations
  11 Enhanced ACS Management   - Perform Enhanced Test/Configuration Management
  C  Data Collection           - Process Data Collection Function
  L  List                      - Perform Functions Against Saved ISMF Lists
  P  Copy Pool                 - Specify Pool Storage Groups for Copies
  R  Removable Media Manager   - Perform Functions Against Removable Media
  X  Exit                      - Terminate ISMF

 Use HELP Command for Help; Use END Command or X to Exit.

When you select Library Management, the Library Management Selection menu is displayed, as shown in Figure 2. At this point, you select either an optical library configuration or an optical drive configuration. Because a library must be defined before any drives associated with that library can be defined, you must first define libraries and then define drives. Select option 1 to display the Optical Library Application Selection panel, as shown in Figure 3.

Figure 2. Library Management Selection Menu
   Panel  Help
 ------------------------------------------------------------------------------
                       LIBRARY MANAGEMENT SELECTION MENU
 Enter Selection or Command ===>_

  1  Optical Library          - Optical Library Configuration
  2  Optical Drive            - Optical Drive Configuration
  3  Tape Library             - Tape Library Configuration















Use HELP Command for Help; Use END Command to Exit.
The ISMF screens that follow provide examples for defining 3995-11x, 3995-13x, 3995-Cxx, and pseudo libraries. These examples define the pseudo libraries based on the media type and device type association; however, you can define pseudo libraries to best suit the requirements of your environment (based, for example, on location, or all backup objects with primary active objects, or data categories, and so forth). Where applicable, the ISMF screens are duplicated with examples for the different library definitions. The following libraries are defined in our sample configuration:

The name of the source control data set (SCDS) that contains the library and drive definitions in these examples is SCDS.PRIMARY. The default CDS NAME is the single-quoted word ‘ACTIVE’, which represents the currently active configuration. Whenever you define a new optical library within an SCDS, the library definition added to the SCDS is identified by the system to which the storage administrator is logged on. You can use the Optical Library Configuration application to add an optical library to an SCDS. The Optical Library Configuration application must be running on the system on which the OAM configuration database resides. The OAM configuration database cannot be shared among systems.

The OPTICAL LIBRARY APPLICATION SELECTION panel, Figure 3, provides an example of selecting the define option to define a 3995-133 optical library (LIBRARY1). The following information must be provided on this screen:
Figure 3. Optical Library Application Selection Panel
   Panel  Utilities  Help
 ------------------------------------------------------------------------------
                     OPTICAL LIBRARY APPLICATION SELECTION
Command ===>_

To Perform Library Operations, Specify:
  CDS Name  . . . . . . . ‘SCDS.PRIMARY’
                                 (1 to 44 character data set name or 'ACTIVE')
  Library Name  . . . . . LIBRARY1  (For Optical Library List, fully or
                                     Partially Specified or * for All)
  Library Device Type . . 3995-133  (For Optical Library List, fully or
                                     Partially Specified or * for All)
  Library Type . . . . .  REAL  (REAL, PSEUDO, or * for ALL)

Select one of the following Options:
  3  1. List    - Generate a list of Libraries
     2. Display - Display a Library
     3. Define  - Define a Library
     4. Alter   - Alter a Library
If List Option is Chosen,
   Enter "/" to select option    _ Respecify View Criteria
                                 _ Respecify Sort Criteria
 Use ENTER to Perform Selection;
 Use HELP Command for Help; Use END Command to Exit.
The following are output fields specified in the Optical Library Application Selection panel:
SCDS NAME
The name of the source control data set that this library is defined in.
LIBRARY NAME
The name of the library being defined.
Rules:
  1. To avoid confusion, do not assign the same name to both libraries and Object storage groups when defining them to the OAM configuration database.
  2. You must include library names in the Object and Object Backup storage group definition so that optical writes are performed for the Object or Object Backup storage group.
LIBRARY TYPE
The type of library you are addressing. This can be either REAL or PSEUDO. A REAL optical library is a physical library containing optical disk drives and optical volumes that reside physically inside the library. A PSEUDO optical library is a set of shelf-resident optical disk volumes associated with operator-accessible optical disk drives, or both.

In order to process read and write requests from optical shelf-resident volumes, you need to define compatible optical operator-accessible drives to the pseudo optical library when defining it to the OAM configuration database. If you do not define any optical operator-accessible drives to the pseudo optical library, OAM cannot process read and write requests for optical shelf-resident volumes.

OAM stills uses pseudo optical libraries for each optical drive device type. If no pseudo optical library is defined in the active SMS configuration for a valid optical drive device type, OAM defines a default using the following names that can be used for assigning shelf-resident optical volumes:
  • PCTREUSE—3995-131 device types
  • PCTWORM—3995-132 device types
  • P3995133—3995-133 device types
  • P3995SW3—3995-SW3 device types
  • P3994SW4—3995-SW4 device types
Note: After the first library definition, ISMF primes CDS NAME, LIBRARY NAME, LIBRARY DEVICE TYPE, and LIBRARY TYPE with the last used reference values on the Optical Library Application Selection panel.

For more information on pseudo libraries, see Pseudo optical library concept.