Change Device Desc (Media Lib) (CHGDEVMLB)

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

Restriction: The user of this command must have *IOSYSCFG authority.

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

Resource name (RSRCNAME)

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

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

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

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.

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 determines the value.
unload-wait-time: Specify the number of seconds to wait. Valid values range from 1 through 120.

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.

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).

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.

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

Generate cartridge ids (GENCTGID)

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

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

Robot device descriptions (ROBOTDEV)

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

*SAME: The value does not change.
*NONE: No robot device device description is specified.
robot-device-description: The specified device description is used.

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.

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

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.

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

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.

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.