Change Device Desc (Media Lib) (CHGDEVMLB)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Change Device Description (Media Library) (CHGDEVMLB) command changes the device description for a media library device. Refer to the Storage solutions category in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/ for more tape information.

Restriction: You must have input/output system configuration (*IOSYSCFG) special authority to use this command.

Top

Parameters

Keyword Description Choices Notes
DEVD Device description Name Required, Key, Positional 1
DEVCLS Device class *SAME, *OPT, *TAP Optional
RSRCNAME Resource name Name, *SAME, *NONE Optional
ONLINE Online at IPL *SAME, *YES, *NO Optional
UNLOADWAIT Unload wait time Character value, *SAME, *SYSGEN Optional
MAXDEVTIME Maximum device wait time Character value, *SAME, *SYSGEN Optional
RSCALCPTY Resource allocation priority Character value, *SAME, *JOB Optional
INLMNTWAIT Initial mount wait time Character value, *SAME, *JOB, *IMMED, *NOMAX Optional
EOVMNTWAIT End of volume mount wait time Character value, *SAME, *JOB, *IMMED, *NOMAX Optional
GENCTGID Generate cartridge ids *SAME, *VOLID, *SYSGEN Optional
ROBOTDEV Robot device descriptions Single values: *SAME, *NONE
Other values (up to 2 repetitions): Name
Optional
ROBOTHOST Robot host Single values: *SAME, *NONE
Other values (up to 2 repetitions): Character value
Optional
LCLINTNETA Local internet address Character value, *SAME, *NONE Optional
MSGQ Message queue Single values: *SAME, *SYSOPR
Other values: Qualified object name
Optional
Qualifier 1: Message queue Name
Qualifier 2: Library Name, *LIBL, *CURLIB
TEXT Text 'description' Character value, *SAME, *BLANK Optional
Top

Device description (DEVD)

Specifies the name of the device description.

This is a required parameter.

Top

Device class (DEVCLS)

Specifies the class of the media library being created.

*SAME
The value does not change.
*OPT

The device is an optical media library.

*TAP

The device is a tape media library.

Top

Resource name (RSRCNAME)

Specifies the resource name that identifies the hardware that the description represents.

*SAME
The value does not change.
*NONE

No resource name is specified. A resource name must be provided before the device can be varied on.

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.

Top

Online at IPL (ONLINE)

Specifies whether this object is automatically varied on at initial program load (IPL).

*SAME
The value does not change.
*YES

This device is varied on automatically at IPL.

*NO

This device is not varied on automatically at IPL.

Top

Unload wait time (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.

*SAME
The value does not change.
*SYSGEN

The system default is used.

unload-wait-time

Specify the number of seconds to wait. Valid values range from 1 through 120.

Top

Maximum device wait time (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, and is ignored when *DEVCLS(*TAP) is specified.

*SAME
The value does not change.
*SYSGEN

The system default 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.

*NOMAX

The requests will wait until a tape resource is available.

Note: This value is valid for tape devices only.

max-device-time

For optical devices, specify the number of minutes the volume can remain mounted. Valid values range from 1 through 60. For tape devices, specify the number of minutes a request will wait for allocation of a tape resource. Valid values range from 1 through 600.

Top

Resource allocation priority (RSCALCPTY)

Specifies the resource allocation priority.

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

*SAME
The value does not change.
*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).

Top

Initial mount wait time (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.

*SAME
The value does not change.
*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.

Top

End of volume mount wait time (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.

*SAME
The value does not change.
*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.

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.

Top

Generate cartridge ids (GENCTGID)

Specifies how the cartridge identifiers are assigned to each volume for tape libraries without bar code readers.

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

*SAME
The value does not change.
*VOLID

Specifies that the volume identifier is used as the cartridge identifier. Cartridge identifiers can be assigned by mounting each volume and reading the volume identifier.

*SYSGEN

Specifies that the system generate 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 SLT001, SLT002, SLT003, and so on.

Top

Robot device descriptions (ROBOTDEV)

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

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

*SAME
The value does not change.
*NONE

No robot device device description is specified.

robot-device-description

The specified device description is used.

Top

Robot host (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 valid only when DEVCLS(*TAP) is specified.

*SAME
The value does not change.
*NONE
No robotic host is specified at this time.
host-name
The specified name of the robotic library manager. The user 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 robotic library manager. 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 host internet address is entered from a command line, the address must be enclosed in apostrophes.
Top

Local internet address (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 valid only when DEVCLS(*TAP) is specified.

*SAME
The value does not change.
*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 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 local internet address is entered from a command line, the address must be enclosed in apostrophes.
Top

Message queue (MSGQ)

Specifies the message queue to which operational messages for this device are sent.

*SAME
The value does not change.
*SYSOPR
Messages are sent to the QSYSOPR message queue in QSYS.
message-queue-name
Specify the name of the message queue to which operational messages are sent.

Qualifier 2: Library

*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.
Top

Text 'description' (TEXT)

Specifies the text that briefly describes the object.

*SAME
The text (if any) does not change.
*BLANK
No text is specified.
character-value
Specify no more than 50 characters of text, enclosed in apostrophes.
Top

Examples

CHGDEVMLB   DEVD(LIB01)  ONLINE(*NO)

This command changes the device description of a media library device named LIB01. The device is changed so that it is not automatically varied on at IPL.

Top

Error messages

*ESCAPE Messages

CPF2618
Device description &1 not changed.
Top