The tape device selection information for each volume is processed
as follows:
- If a volume record exists for the volume to be entered into the
manual tape library, all TDSI values are ignored and the values from
the existing volume record are passed to the cartridge entry installation
exit (CBRUXENT).
- If no volume record exists for the volume to be entered into the
manual tape library, TDSI values are processed as follows:
- Recording technology specified in TDSI is ignored. A volume's
recording technology may be determined by using the library's default
entry data class, if applicable, by a default recording technology
based on the media type, or explicitly set by the CBRUXENT installation
exit. If the volume is a SCRATCH volume, UNKNOWN is also a possible
recording technology value.
- If the volume is MEDIA1 and the entry default data class is not
defined for the library or is not applicable for the volume's media
type, by default, 36-track is passed to the exit. UNKNOWN can be passed
to the exit for a SCRATCH volume if the default data class is not
defined. The installation exit may set an applicable value (18-track,
36-track).
- If the volume is MEDIA2, 36-track is passed to the exit because
this is the only applicable recording technology.
- If the volume is MEDIA3 or MEDIA4, and the entry default data
class is not defined for the library or is not applicable for the
volume's media type, by default, 128-track is passed to the exit.
UNKNOWN may be passed to the exit for a SCRATCH volume if the default
data class is not defined. The installation exit may specify an applicable
recording technology (128-track, 256-track, 384-track).
- If the volume is MEDIA5, MEDIA6, MEDIA7, or MEDIA8 and the entry
default data class is not defined for the library or is not applicable
for the volume's media type, by default, EFMT1 is passed to the exit.
UNKNOWN may be passed to the exit for a SCRATCH volume if the default
data class is not defined. The installation exit may specify an applicable
recording technology (EFMT1, EFMT2, EEFMT2, EFMT3, or EEFMT3).
- If the volume is MEDIA9 or MEDIA10 and the entry default data
class is not defined for the library or not applicable for the volume's
media type, by default, EFMT2 is passed to the exit. UNKNOWN may be
passed to the exit for a SCRATCH volume if the default data class
is not defined. The installation exit may specify an applicable recording
technology (EFMT2, EEFMT2, EFMT3, EEFMT3, EFMT4, or EEFMT4).
- If the volume is MEDIA11, MEDIA12 or MEDIA13 and the entry default
data class is not defined for the library or not applicable for the
volume's media type, by default, EFMT4 is passed to the exit. UNKNOWN
may be passed to the exit for a SCRATCH volume if the default data
class is not defined. The installation exit may specify an applicable
recording technology (EFMT4 or EEFMT4).
- PRIVATE volumes must have an applicable recording technology set.
SCRATCH volumes can be entered with an applicable recording technology
or UNKNOWN.
- Media type for the volume must be set before the volume can be
entered into the manual tape library. Media type may be specified
by any of the following:
- Compaction type specified in TDSI is ignored, and the UNKNOWN
value is passed to the installation exit. The exit may specify a value
for compaction type.
- Special attribute specified in TDSI is ignored and a value of
NONE is passed to the installation exit. The exit may specify a value
for special attribute.
- EXITINFO=installation-exit-information
- Specifies the name of a character variable (16-byte length) that
contains a customer-specified free-form value that is passed to the
cartridge entry installation exit (CBRUXENT).
The permanent OAM control block structure must be available in
order for manual cartridge entry to be performed. This means that
the OAM address space must have been started since the last IPL.
When manual cartridge entry is successful, the following processing
occurs:
- The tape volume record is either created or updated in the TCDB.
- TDSI for the volume is returned in LCSMTDSI in structure LCSMLIST.
- The scratch volume counts in the library record in the TCDB are
updated.
- Message CBR3610I is issued to inform the operator of the volumes
which have been entered into the library.
If the cartridge entry installation exit (CBRUXENT) is disabled,
cartridge entry processing is not performed. Unless the installation
has indicated that the cartridge entry installation exit should not
be called, it is invoked for every volume in the list.
Even though the manual tape library supports national characters
(@ $ and #) and special characters (, . / ' ( ) * & + - and =),
for coexistence, the volume serial number for each of the volumes
entered into a manual tape library should meet the same character
set defined for an ATLDS: upper case alphabetics or numerics. The
volume serial may not contain any imbedded blanks.
The volume serial for each volume entered into a manual tape library
may not be a duplicate of a known DASD volume, or a tape volume which
resides in another tape library dataserver (according to the tape
volume record in the TCDB).
If a volume record exists for a private volume and it contains
a nonblank storage group name, the storage group name is validated.
If the storage group is not "tape", is not defined to the active
SMS configuration, or does not contain the library specified for the
MCE request, the request fails and the volume is not entered into
the library.
If a volume record exists in the TCDB for an MCE volume and the
volume record indicates that the volume already resides in the specified
library the entry for this volume fails (duplicate assumed).
If an error is encountered while processing one of the volumes,
the return and reason codes for that volume are stored in the fields
LCSMRET and LCSMREAS in the volume list array, and processing continues
for the rest of the volumes. If an error occurs which causes cartridge
entry to be disabled or suspended, no more volumes are processed and
error return and reason codes are set for the remaining volumes in
the list.
If a volume record exists for the volume entered into the manual
tape library, tape device selection information is processed as shown
in Table 1.
Table 1. TDSI
processing for MCE—Volume existsTDSI attribute |
TDSI input |
Default entry data class |
Installation exit |
Volume record |
---|
Recording technology |
Ignored |
Ignored |
May override existing volume record |
Updated only if installation exit
makes change |
Media type |
Ignored |
Ignored |
Cannot override existing volume record |
MCE fails with return code LCSFAIL(12)
and reason code LCSFMUMT(321) if media type returned from installation
exit does not match the media type defined on the volume record |
Compaction |
Ignored |
Not applicable |
May override existing volume record |
Updated only if installation exit
makes change |
Special attribute |
Ignored |
Not applicable |
May override existing volume record |
Updated only if installation exit
makes change |
If no volume record exists for the volume entering the manual tape
library, the tape device selection information is processed as shown
in Table 2.
Table 2. TDSI
processing for MCE—No volume record exists for volumeTDSI attribute |
TDSI input |
Default entry data class |
Installation exit |
Volume record |
---|
Recording technology |
Ignored |
Can specify value |
Can specify an applicable value,
overriding the default value or library default entry data class value
passed to the exit. |
Created with value passed to installation
exit or applicable value specified by installation exit. |
Media type |
May be specified |
Used if no TDSI value specified |
Can specify value if not provided
in TDSI or default entry data class, or may override value from either
source. |
Created with value specified in TDSI
or default entry data class or installation exit. |
Compaction |
Ignored |
Not applicable |
Can specify value. |
Created with value specified by installation
exit. If no value specified, set to UNKNOWN. |
Special attribute |
Ignored |
Not applicable |
Can specify value. |
Created with value specified by installation
exit. If no value specified, set to NONE. |