ISMF provides a library management function to allow the storage
administrator to use a series of panels to define the tape libraries
needed for their installation.
To define a tape library, select option 10, LIBRARY MANAGEMENT,
from the ISMF Primary Option Menu (as shown in Figure 1) to start the library management dialog.
Note: When defining the libraries associated with the Peer-to-Peer
VTS Subsystem, remember to define the composite library along with
the associated distributed libraries. From an ISMF define perspective,
each library is defined as a separate tape library. Their association
is established once communication is made to the library.
Figure 1. ISMF Primary Option Menu Panel Panel Help
------------------------------------------------------------------------------
ISMF PRIMARY OPTION MENU - z/OS DFSMS V1 R13
Selection or Command ===>
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
G Report Generation - Create Storage Management Reports
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 option 10, Library Management, the Library Management
Selection Menu is displayed, as shown in Figure 2.
Figure 2. Library Management Selection Menu Panel 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.
Selecting option 3, Tape Library, and hitting ENTER displays the
Tape Library Application Selection panel (see Figure 3).
Note: For example purposes, a CDS name of SCDS.TEMP.PRIMARY, and library
names of LIB1 and LIB2 are used in the panels in this appendix.
Figure 3. Tape Library Application Selection Panel Panel Utilities Help
------------------------------------------------------------------------------
TAPE LIBRARY APPLICATION SELECTION
Command ===>_
To Perform Library Operations, Specify:
CDS Name . . . . . . . ‘SCDS.TEMP.PRIMARY’
(1 to 44 character data set name or 'ACTIVE')
Library Name . . . . . LIB1 (For Tape Library List, fully or
Partially Specified 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 selection option _ Respecify View Criteria
_ Respecify Sort Criteria
Use ENTER Command to Perform Selection;
Use HELP Command for Help; Use END Command to Exit.
To begin the library definition process:
- Enter a CDS NAME.
- Enter a LIBRARY NAME.
- Select option 3, DEFINE.
Note: - The letter "V" is reserved exclusively as the first character
in a VOLCAT volume serial number. It readily identifies the volume
serial number as belonging to a VOLCAT. To avoid confusion with the
VOLCAT naming conventions, you may not use the letter "V" as
the first character of a tape library name. Additionally, tape library
names may not begin with numeric characters. You may use alphabetics
and the special characters "$", "@", and "#" for the
first character of a tape library name. You may use alphabetic, numeric,
and the aforementioned special characters for the remainder of a tape
library name.
- After the first library definition, ISMF primes
CDS NAME and LIBRARY NAME with the last used reference values on the
Tape Library Application Selection panel. The default CDS NAME is
the single-quoted word ‘ACTIVE’, which represents the currently active
configuration.
Choosing option 3, DEFINE, displays the TAPE LIBRARY DEFINE panel
with all the input fields set to blank. You can enter a definition
for LIB1, as shown in the sample Figure 4 and Figure 5.
Figure 4. Tape Library Define Panel (Page 1 of 4) Panel Utilities Scroll Help
------------------------------------------------------------------------------
TAPE LIBRARY DEFINE Page 1 of 4
Command ===>
SCDS Name . : SCDS.TEMP.PRIMARY
Library Name : LIB1
To Define Library, Specify:
Description ==> Automated tape library 0001C in
==> building 031
Library ID . . . . . . . . . . . 0001C (00001 to FFFFF)
Console Name . . . . . . . . . . LIB1CON
Entry Default Data Class . . . . DCATLDS
Entry Default Use Attribute . . P (P=PRIVATE or S=SCRATCH)
Eject Default . . . . . . . . . K (P=PURGE or K=KEEP)
Use ENTER to Perform Verification; Use DOWN Command to View next Panel;
Use HELP Command for Help; Use END Command to Save and Exit; CANCEL to Exit.
Figure 5. Tape Library Define Panel (Page 2 of 4) Panel Utilities Scroll Help
------------------------------------------------------------------------------
TAPE LIBRARY DEFINE Page 2 of 4
Command ===>
SCDS Name . : SCDS.TEMP.PRIMARY
Library Name : LIB1
Media Type: Scratch Threshold
Media1: . . . . . . . . . . . 100 (0 to 999999)
Media2: . . . . . . . . . . . 150 (0 to 999999)
Media3: . . . . . . . . . . . 100 (0 to 999999)
Media4: . . . . . . . . . . . 0 (0 to 999999)
Media5: . . . . . . . . . . . 0 (0 to 999999)
Media6: . . . . . . . . . . . 0 (0 to 999999)
Media7: . . . . . . . . . . . 0 (0 to 999999)
Media8: . . . . . . . . . . . 0 (0 to 999999)
Media9: . . . . . . . . . . . 0 (0 to 999999)
Media10: . . . . . . . . . . 0 (0 to 999999)
Media11: . . . . . . . . . . 0 (0 to 999999)
Media12: . . . . . . . . . . 0 (0 to 999999)
Media13: . . . . . . . . . . 0 (0 to 999999)
Use ENTER to Perform Verification; Use DOWN Command to View next Panel;
Use HELP Command for Help; Use END Command to Save and Exit; CANCEL to Exit.
SCDS NAME and LIBRARY NAME are output fields that contain the SCDS and library name
you specified in the Tape Library Management Application Selection
panel.
Specify the following information for the tape library definition
in the tape configuration database and in the current source control
data set.
- DESCRIPTION
- A 120-byte field used for entering a description of the library
definition. There are no restrictions on its content.
- LIBRARY ID
- Establishes the connection between the software-assigned library
name and the tape drives that belong to the library. A valid value
is entered as five hexadecimal digits. For an ATLDS, it is defined
at the library by the customer engineer and must also match what is
optionally specified in the HCD LIBRARY-ID parameter. This value is
returned by the control unit in response to a read device characteristics
command. For an MTL, it must match what was specified in the HCD LIBRARY-ID
parameter. Valid values are 00001 – FFFFF; a default value of 00000
is not allowed.
- CONSOLE NAME
- Specifies the name of the MVS console associated with the tape
library being defined. The console name provides precise routing of
console messages pertaining to a specific library. When the console
name is not specified on the Tape Library Define panel, console name
routing support is not provided. The console name is passed to the
installation exits for their use. To use console name message routing,
the console name defined on this panel must also be defined in the
CONSOLxx member of the PARMLIB (see the discussion in Step 2C, "Update CONSOLxx PARMLIB
member" in Changing system libraries for more
information on this PARMLIB member). A valid value is entered as two
to eight characters. Valid characters are alphanumeric, #, @, or $;
the first character must be nonnumeric.
- ENTRY DEFAULT DATA CLASS
- Specifies the data class to be used to determine the interchange
attributes for private volumes entered into the tape library. No other
attributes of the data class are used. You can use the cartridge entry
installation exit (CBRUXENT) to assign appropriate interchange values
that override the default data class specifications.
Note: The specified
data class name is not automatically assigned or used as the default
data class policy name for outboard policy management.
- ENTRY DEFAULT USE ATTRIBUTE
- Specifies the default volume
use attribute for the cartridges entered into the library being defined.
- P
- Indicates PRIVATE for the entry default use attribute. These tape
cartridges can be used to satisfy specific volume requests.
- S
- Indicates SCRATCH for the entry default use attribute. These tape
cartridges can be used to satisfy nonspecific volume requests.
- EJECT DEFAULT
- Specifies the default action for the TCDB volume record when a tape
cartridge is ejected from the library being defined.
- P
- Indicates PURGE for the eject default parameter. The volume record
is deleted from the TCDB.
- K
- Indicates KEEP for the eject default parameter. The volume record
is kept in the TCDB.
Note: No matter which disposition is specified, the
volume record in the ATLDS library manager inventory is deleted upon
cartridge ejection.
When the first define panel is complete, use the DOWN command to
display the second part of the Tape Library Define panel (
Figure 5). Continue with the definition for library
LIB1 by completing part two of the Tape Library Define panel.
- SCRATCH THRESHOLD
- Specify the minimum acceptable number of scratch volumes for each media type in the library being defined. The following are
recognized media types:
- MEDIA1
- IBM Cartridge System Tape. The number must be in the range of
0 to 999999. The default value of this parameter is 0.
- MEDIA2
- IBM Enhanced Capacity Cartridge System Tape. The number must be
in the range of 0 to 999999. The default value of this parameter is
0.
- MEDIA3
- IBM High Performance Cartridge Tape. The number must be in the
range of 0 to 999999. The default value of this parameter is 0.
- MEDIA4
- IBM Extended High Performance Cartridge Tape. The number must
be in the range of 0 to 999999. The default value of this parameter
is 0.
- MEDIA5
- IBM Enterprise Tape Cartridge. The number must be in the range
of 0 to 999999. The default value of this parameter is 0.
- MEDIA6
- IBM Enterprise WORM Tape Cartridge. The number must be in the
range of 0 to 999999. The default value of this parameter is 0.
- MEDIA7
- IBM Enterprise Economy Tape Cartridge. The number must be in the
range of 0 to 999999. The default value of this parameter is 0.
- MEDIA8
- IBM Enterprise Economy WORM Tape Cartridge. The number must be
in the range of 0 to 999999. The default value of this parameter is
0.
- MEDIA9
- IBM Enterprise Extended Tape Cartridge. The number must be in
the range of 0 to 999999. The default value of this parameter is 0.
- MEDIA10
- IBM Enterprise Extended WORM Tape Cartridge. The number must be
in the range of 0 to 999999. The default value of this parameter is
0.
- MEDIA11
- IBM Enterprise Advanced Tape Cartridge. The number must be in
the range of 0 to 999999. The default value of this parameter is 0.
- MEDIA12
- IBM Enterprise Advanced WORM Tape Cartridge. The number must be
in the range of 0 to 999999. The default value of this parameter is
0.
- MEDIA13
- IBM Enterprise Advanced Economy Tape Cartridge. The number must
be in the range of 0 to 999999. The default value of this parameter
is 0.
When the number of scratch volumes in the library falls below the
scratch volume threshold for that media type, operator action message CBR3660A is issued requesting that scratch volumes
of the required media type be entered into the library. When the number
of scratch volumes exceeds twice the scratch volume threshold for
that media type, the message is deleted.
Attention: It is recommended that a scratch threshold
be set for all media types used within a tape library. If a
media type is not being used, the default threshold value of zero
(threshold=0) should be used.
When the second define panel is complete, use the DOWN command
to display the third part of the Tape Library Define panel (Figure 6). Continue with the definition for
library LIB1 by completing part three of the Tape Library Define panel.
You may also need to use part four of the Tape Library Define panel
(Figure 7).
Figure 6. Tape Library Define Panel (Page 3 of 4) Panel Utilities Scroll Help
------------------------------------------------------------------------------
TAPE LIBRARY DEFINE Page 3 of 4
Command ===>
SCDS Name . : SCDS.TEMP.PRIMARY
Library Name : LIB1
Initial Online Status (Yes, No, or Blank):
SYS1 ===> YES SYS2 ===> SYS3 ===> SYS4 ===>
SYS5 ===> SYS6 ===> SYS7 ===>
Warning:
When you connect a tape library to a system group rather than a system,
you lose the ability to vary that library online or offline to the
individual systems in the system group. It is strongly recommended that
the tape library be connected to individual systems only.
Use ENTER to Perform Verification; Use DOWN Command to View next Panel;
Use HELP Command for Help; Use END Command to Save and Exit; CANCEL to Exit.
Figure 7. Tape Library Define Panel (Page 4 of 4) Panel Utilities Scroll Help
------------------------------------------------------------------------------
TAPE LIBRARY DEFINE Page 4 of 4
Command ===>
SCDS Name . : SCDS.TEMP.PRIMARY
Library Name : LIB1
Initial Online Status (Yes, No, or Blank):
Warning:
When you connect a tape library to a system group rather than a system,
you lose the ability to vary that library online or offline to the
individual systems in the system group. It is strongly recommended that
the tape library be connected to individual systems only.
Use ENTER to Perform Verification; Use UP Command to View previous Panel;
Use HELP Command for Help; Use END Command to Save and Exit; CANCEL to Exit.
Note: You can exit the Tape Library Define panel at any time without
saving tape library attributes by issuing the CANCEL command.
Specify the following information on this panel:
- INITIAL ONLINE STATUS
- Specifies how the library being defined will be associated
to each system or system group in the SMS complex each time this SCDS
is activated. The following are valid values:
- Online (YES)
- Offline (NO)
- Not connected (blank)
A tape library can be connected to any combination of one or more
of the systems or system groups defined in the CDS base, but it is
strongly recommended that the tape libraries be connected to systems
rather than system groups. When a tape library is connected to a system
group, the user loses the ability to vary the tape library online
or offline to the individual systems in the system group. The ISMF
Tape Library panels support both system names and system group names.
The system administrator defining the libraries does not need to
be logged on to one of the systems in the SMS complex to define the
libraries in that complex—both the TCDB and the SCDS can be moved
after being created. However, both the SCDS and the TCDB for the SMS
complex being defined must be available to the system administrator
during the library definition process.
The definition for the tape library does not take affect until
the SCDS to which it is defined is activated. Once the library is
defined within the SCDS and the record for the library is updated
in the TCDB, the attributes assigned to the last defined library for
the SCDS are displayed on the Tape Library Application Selection menu
and the Tape Library Define panel as defaults. These values can be
modified to define other libraries as needed.
After you complete the definition of LIB1, the Tape Library Application
Selection menu (Figure 3) is displayed again,
and you can define your second tape library as follows:
- Enter a LIBRARY NAME (LIB2)
- Press ENTER
Note: Since LIB1 was the last library defined, the SCDS to which it
belongs is primed to display in the SCDS NAME field on this panel
(assuming the SCDS was reactivated since the definition of LIB1).
If you wish to change the SCDS NAME, you may do so here; otherwise,
the library (LIB2) that is currently being defined will reside in
the same SCDS as LIB1.
The Tape Library Define panels (Figure 8, Figure 9, Figure 10, and Figure 11) are again displayed,
and you enter the appropriate information for LIB2.
Figure 8. Tape Library Define Panel (Page 1 of 4 Panel Utilities Scroll Help
------------------------------------------------------------------------------
TAPE LIBRARY DEFINE Page 1 of 4
Command ===>
SCDS Name . : SCDS.TEMP.PRIMARY
Library Name : LIB2
To Define Library, Specify:
Description ==> Automated tape library 0001C in
==> building 031
Library ID . . . . . . . . . . . 0002C (00001 to FFFFF)
Console Name . . . . . . . . . . LIB2CON
Entry Default Data Class . . . . DCMTLDS
Entry Default Use Attribute . . P (P=PRIVATE or S=SCRATCH)
Eject Default . . . . . . . . . K (P=PURGE or K=KEEP)
Use ENTER to Perform Verification; Use DOWN Command to View next Panel;
Use HELP Command for Help; Use END Command to Save and Exit; CANCEL to Exit.
Figure 9. Tape Library Define Panel (Page 2 of 4) Panel Utilities Scroll Help
------------------------------------------------------------------------------
TAPE LIBRARY DEFINE Page 2 of 4
Command ===>
SCDS Name . : SCDS.TEMP.PRIMARY
Library Name : LIB2
Media Type: Scratch Threshold
Media1: . . . . . . . . . . . 100 (0 to 999999)
Media2: . . . . . . . . . . . 150 (0 to 999999)
Media3: . . . . . . . . . . . 100 (0 to 999999)
Media4: . . . . . . . . . . . 0 (0 to 999999)
Media5: . . . . . . . . . . . 0 (0 to 999999)
Media6: . . . . . . . . . . . 0 (0 to 999999)
Media7: . . . . . . . . . . . 0 (0 to 999999)
Media8: . . . . . . . . . . . 0 (0 to 999999)
Media9: . . . . . . . . . . . 0 (0 to 999999)
Media10: . . . . . . . . . . 0 (0 to 999999)
Use ENTER to Perform Verification; Use DOWN Command to View next Panel;
Use HELP Command for Help; Use END Command to Save and Exit; CANCEL to Exit.
Figure 10. Tape Library Define Panel (Page 3 of 4) Panel Utilities Scroll Help
------------------------------------------------------------------------------
TAPE LIBRARY DEFINE Page 3 of 4
Command ===>
SCDS Name . : SCDS.TEMP.PRIMARY
Library Name : LIB2
Initial Online Status (Yes, No, or Blank):
SYS1 ===> YES SYS2 ===> SYS3 ===> SYS4 ===>
SYS5 ===> YES SYS6 ===> SYS7 ===>
Warning:
When you connect a tape library to a system group rather than a system,
you lose the ability to vary that library online or offline to the
individual systems in the system group. It is strongly recommended that
the tape library be connected to individual systems only.
Use ENTER to Perform Verification; Use DOWN Command to View next Panel;
Use HELP Command for Help; Use END Command to Save and Exit; CANCEL to Exit.
Figure 11. Tape Library Define Panel (Page 4 of 4) Panel Utilities Scroll Help
------------------------------------------------------------------------------
TAPE LIBRARY DEFINE Page 4 of 4
Command ===>
SCDS Name . : SCDS.TEMP.PRIMARY
Library Name : LIB2
Initial Online Status (Yes, No, or Blank):
Warning:
When you connect a tape library to a system group rather than a system,
you lose the ability to vary that library online or offline to the
individual systems in the system group. It is strongly recommended that
the tape library be connected to individual systems only.
Use ENTER to Perform Verification; Use UP Command to View previous Panel;
Use HELP Command for Help; Use END Command to Save and Exit; CANCEL to Exit.
After completing these library definitions, you have two libraries—one
ATLDS library, LIB1, along with an MTL library, LIB2—defined in the
SMS configuration. Defining a tape library using the Tape Library
Define panels adds a library record to the TCDB along with the library
definition into the specified SCDS.
z/OS DFSMS OAM Planning, Installation, and Storage Administration Guide for Tape Libraries
Copyright IBM Corporation 1990, 2014