Processing the tape device selection information (TDSI)

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:
  - Input TDSI—specified in field LCSMMED.
  - Default entry data class—this value is used only if no TDSI media type was specified.
  - Cartridge entry installation exit (CBRUXENT)—may provide the media type if it is not specified in TDSI or default entry data class, or may override the value specified. If the installation exit is invoked and returns an invalid media type, cartridge entry processing is discontinued.
    If media type is not available from any of the sources listed above, the volume is not entered into the MTL.
- 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 exists
TDSI 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 volume
TDSI 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.