| 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 |
| 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 |
Specifies the name of the device description.
This is a required parameter.
| Top |
Specifies the class of the media library being created.
The device is an optical media library.
The device is a tape media library.
| Top |
Specifies the resource name that identifies the hardware that the description represents.
No resource name is specified. A resource name must be provided before the device can be varied on.
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 |
Specifies whether this object is automatically varied on at initial program load (IPL).
This device is varied on automatically at IPL.
This device is not varied on automatically at IPL.
| Top |
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.
The system default is used.
Specify the number of seconds to wait. Valid values range from 1 through 120.
| Top |
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.
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.
The requests will wait until a tape resource is available.
Note: This value is valid for tape devices only.
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 |
Specifies the resource allocation priority.
Note: This parameter is valid only when DEVCLS(*TAP) is specified.
The priority of the job is used as the resource allocation priority.
Specify the priority this job is given when requesting a resource. Valid values range from 1 (highest) through 99 (lowest).
| Top |
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.
The allocation wait time is determined by the default wait time attribute of the job requesting the allocation, rounded up to the nearest minute.
The request will not wait for a tape resource to become available.
The request will wait until a tape resource is available.
Specify the number of minutes a request will wait for allocation of a tape resource. Valid values range from 1 through 600 minutes.
| Top |
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.
The allocation wait time is determined by the default wait time attribute of the job requesting the allocation, rounded up to the nearest minute.
The request will not wait for a tape resource to become available.
Specify the number of minutes a request will wait for allocation of a tape resource. Valid values range from 1 through 600 minutes.
| Top |
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.
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.
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 |
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.
No robot device device description is specified.
The specified device description is used.
| Top |
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.
| Top |
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.
| Top |
Specifies the message queue to which operational messages for this device are sent.
Qualifier 2: Library
| Top |
Specifies the text that briefly describes the object.
| Top |
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 |
| Top |