| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Device Description (Tape) (CHGDEVTAP) command changes a device description for a tape device.
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 |
| RSRCNAME | Resource name | Name, *SAME, *NONE, *VRT | Optional |
| ONLINE | Online at IPL | *SAME, *YES, *NO | Optional |
| ASSIGN | Assign device at vary on | *SAME, *YES, *NO | Optional |
| UNLOAD | Unload device at vary off | *SAME, *YES, *NO | 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 |
| SWTSET | Switch setting | Character value, *SAME | Optional |
| Top |
Specifies the name of the device description.
This is a required parameter.
| Top |
Specifies the resource name that identifies the virtual or physical hardware this description represents. For a physical hardware resource use the WRKHDWRSC command to determine the resource name.
No resource name is specified at this time.
The resource name will be generated by the operating system at the time the device description is modified. The resource name will represent virtual (not physical) hardware.
Specify the name to identify the physical or virtual device on the system.
| 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 whether the tape drive is assigned to the system when it is varied on.
The tape drive is assigned when the device is varied on.
The tape drive is not assigned when the device is varied on.
| Top |
Specifies whether the tape drive is unloaded when the device is varied off.
The tape drive is unloaded when the device is varied off.
The tape drive is not unloaded when the device is varied off. The tape is rewound, but not past the beginning-of-tape marker.
| Top |
Specifies the message queue to which operational messages for this device are sent.
The possible qualified names are:
Qualifier 2: Library
| Top |
Specifies the text that briefly describes the object.
| Top |
Note: This parameter is no longer valid. Specify the RSRCNAME parameter for all tape devices. The SWTSET parameter is provided for compatibility with earlier versions of this command. If specified, the SWTSET parameter is converted to a resource name by the system.
Specifies the switch setting for tape devices.
For 3422, 3480, and 3490 tape devices the possible values are 0 to F.
For 3430 tape devices the possible values are 0 to 3.
| Top |
CHGDEVTAP DEVD(TAP01) ONLINE(*YES)
This command changes the device description of a tape device named TAP01 so that at an IPL the device is automatically varied on.
| Top |
| Top |