Change Device Desc (Tape) (CHGDEVTAP)

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.

Parameters

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

Device description (DEVD)

Specifies the name of the device description.

This is a required parameter.

Resource name (RSRCNAME)

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.

*SAME
The value does not change.
*NONE

No resource name is specified at this time.

*VRT

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.

resource-name

Specify the name to identify the physical or virtual device 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.

Assign device at vary on (ASSIGN)

Specifies whether the tape drive is assigned to the system when it is varied on.

*SAME
The value does not change.
*YES

The tape drive is assigned when the device is varied on.

*NO

The tape drive is not assigned when the device is varied on.

Unload device at vary off (UNLOAD)

Specifies whether the tape drive is unloaded when the device is varied off.

*SAME
The value does not change.
*YES

The tape drive is unloaded when the device is varied off.

*NO

The tape drive is not unloaded when the device is varied off. The tape is rewound, but not past the beginning-of-tape marker.

Message queue (MSGQ)

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

The possible qualified names are:

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

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.

Switch setting (SWTSET)

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.

*SAME
The value does not change.

Examples 

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.

Error messages

*ESCAPE Messages

CPF2618
Device description &1 not changed.