CRTDEVMLB

CRTDEVMLB (Create Device Description (Media Library)) Command Description

CRTDEVMLB Command syntax diagram

Purpose

The Create Device Description (Media Library) (CRTDEVMLB) command creates a device description for a media library device.
Restriction: You must have *IOSYSCFG special authority to use this command.
Initially, all tape drive resources associated with this device description are allocated for use by this system. To change the allocation of drive resources within a tape library, use the Work with Media Library Status (WRKMLBSTS) command or the Vary Configuration (VRYCFG) command.

Note: Allocating drives is only allowed when DEVCLS(*TAP) is specified.

More information about using this command is in the Local Device Configuration book.

Required Parameters

DEVD

Specifies the name of the device description being created.

DEVCLS

Specifies the class of the media library being created.
*OPT: The device is an optical media library.
*TAP: The device is a tape media library.

RSRCNAME

Specifies the resource name that identifies the hardware that the description represents. A resource name must be provided before the device can be varied on.
*NONE: No resource name is specified at this time.
resource-name: Specify the name that identifies the media library device hardware on the system.

Note: Use the Work with Hardware Resources (WRKHDWRSC) command with TYPE(*STG) specified to determine the resource name.

Optional Parameters

TYPE

Specifies the type of device that this description represents.

Note: The device type is used to support prompting of this command; the value is not saved as part of the device description.

*RSRCNAME: The device type is determined from the resource name parameter.
Any of the following device types, listed in numeric order, are valid:

3494

3495

3570

3590

3995

9427

9429

Note: Device type 3995 is valid only when DEVCLS(*OPT) is specified.

ONLINE

Specifies whether this object is automatically varied on at initial program load (IPL).
*YES: The device is automatically varied on at IPL.
*NO: This device is not automatically varied on at IPL.

UNLOADWAIT

Specifies the amount of time the system waits for another request to use the mounted volume before unloading the volume if there are outstanding requests for an available drive.

Note: This parameter is valid only when DEVCLS(*OPT) is specified.

*SYSGEN: The system default value is used.
unload-wait-time: Specify the number of seconds to wait. Valid values range from 1 through 120.

MAXDEVTIME

Specifies the maximum number of minutes a volume can remain mounted in an internal device if there are requests for other volumes.

Note: This parameter is valid only when DEVCLS(*OPT) is specified.

*SYSGEN: The system default value is used. This allows a maximum device wait time to be specified for each library device user rather than the same value for each user of the library device.
max-device-time: Specify the number of minutes the volume can remain mounted. Valid values range from 1 through 60.

RSCALCPTY

Specifies the resource allocation priority.

Note: This parameter is valid only when DEVCLS(*TAP) is specified.

*JOB: The priority of the job is used as the resource allocation priority.
resource-allocation-priority: Specify the priority this job is given when requesting a resource. Valid values range from 1 (highest) through 99 (lowest).

INLMNTWAIT

Specifies the maximum amount of time a request will wait for allocation of a tape resource for the initial mount.

Note: This parameter is valid only when DEVCLS(*TAP) is specified.

*JOB: The allocation wait time is determined by the default wait time attribute of the job requesting the allocation, rounded up to the nearest minute.
*IMMED: The request will not wait for a tape resource to become available.
*NOMAX: The request will wait until a tape resource is available.
initial-mount-wait-time: Specify the number of minutes a request will wait for allocation of a tape resource. Valid values range from 1 through 600 minutes.

EOVMNTWAIT

Specifies the maximum amount of time a request will wait for allocation of a tape resource for the end of volume mount.

Note: This parameter is valid only when DEVCLS(*TAP) is specified.

*JOB: The allocation wait time is determined by the default wait time attribute of the job requesting the allocation, rounded up to the nearest minute.
*IMMED: The request will not wait for a tape resource to become available.
*NOMAX: The request will wait until a tape resource is available.
end-of-volume-mount-wait-time: Specify the number of minutes a request will wait for allocation of a tape resource. Valid values range from 1 through 600 minutes.

GENCTGID

Specifies how the cartridge identifiers are assigned to each volume for tape libraries without bar code readers.
*VOLID:The volume identifier is used as the cartridge identifier. Cartridge identifiers can be assigned by mounting each volume and reading the volume identifier.
*SYSGEN:The system generates the cartridge identifiers for each volume. If system-generated identifiers are used, tape operations must use the generated cartridge identifiers. The cartridge identifiers are assigned sequentially in the form GEN01, GEN02, GEN03, and so on.

ROBOTDEV

Specifies the name of the device description representing the robot for library devices with separate robots.

Note: This parameter is only valid when DEVCLS(*TAP) is specified.

*NONE: No robot device description is specified at this time.
robot-device-description: The specified device description is used. A maximum of 2 robot device descriptions can be specified.

ROBOTHOST

Specifies the TCP/IP host name or Internet address of the robotic library manager. A maximum of 2 robot library managers can be specified.

Note: This parameter is only valid when DEVCLS(*TAP) is specified.

Note: The host name specified on the ROBOTHOST parameter may fail to communicate with the 3494 tape media library device when the system is a restricted state. When the system is in restricted state, only one TCP/IP interface is allowed to be active on the system. It is possible that the interface brought up to communicate with the MLB device is not one which is able to communicate with the configured Domain Name Server(s). When running in restricted state, store a mapping between the host name and the IP address in the local host table by using the CFGTCP option 10 or ADDTCPHTE command.

*NONE: No robotic host is specified at this time.
host-name: The specified name of the robotic library manager. The user can may enter the robot host name by entering the robot host name or the domain qualified robot host name. The domain qualified robot host name allows input of 255 bytes.
host-internet-address: The specified address of the TCP/IP interface. The internet address must be of the form ddd.ddd.ddd.ddd where ddd is a decimal number ranging from 0 to 255. This decimal number should not contain leading zeros. If the internet address is entered from a commnad line, the address must be enclosed in apostrophes.

LCLINTNETA

Specifies the local internet address of the interface that is connecting to the robot library manager. This is the interface the operating system will start when TCP/IP needs to be started to use the tape media library.

Note: This parameter is only valid when DEVCLS(*TAP) is specified.

*NONE: No TCP/IP address is specified at this time.
local-ip-address: Specify the local internet address to be started. The internet address must be of the form nnn.nnn.nnn.nnn, where nnn is a decimal number ranging from 0 through 255. This decimal number should not contain leading zeros. If the local internet address is entered from a commnad line, the address must be enclosed in apostrophes.

MSGQ

Specifies the name of the message queue to which messages are sent.
*SYSOPR: Messages are sent to the system operator message queue (QSYS/QSYSOPR).
message-queue-name: Specify the name of the message queue to which operational messages are sent.
The name of the message queue can be qualified by one of the following library values:

*LIBL: All libraries in the job's library list are searched until the first match is found.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

AUT

Specifies the authority given to users who do not have specific authority to the device description, who are not on an authorization list, and whose user group has no specific authority to the device description.
*LIBCRTAUT: The authority for the object is the same as the create authority for QSYS. The create authority for QSYS can be displayed by using the Display Library Description (DSPLIBD) command. If the create authority is changed with the Change Library (CHGLIB) command, the new authority does not affect existing objects.
*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.
*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the device description.
*USE: The user can perform basic operations on the device description, such as running a program or reading a file. The user cannot change the device description. *USE authority provides object operational authority, read authority, and execute authority.
*EXCLUDE: The user cannot access the device description.
authorization-list-name: Specify the name of the authorization list used.

TEXT

Specifies the text that briefly describes the device. More information on this parameter is in Commonly used parameters.
*BLANK: Text is not specified.
'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Example for CRTDEVMLB
CRTDEVMLB DEVD(LIB01) DEVCLS(*OPT) RSRCNAME(LIB01) ONLINE(*YES)

This command creates a device description for a media library device named LIB01. The library is an optical library and the physical resource name is LIB01. The device description is varied on at IPL.
Error messages for CRTDEVMLB
*ESCAPE Messages

CPF67B0

Tape device &7 not in a library device

CPF67D1

Library device description not created