Change Device Desc (Tape) (CHGDEVTAP)

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

Top

Device description (DEVD)

Specifies the name of the device description being changed.

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

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

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.

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.

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