CHGDEVTAP (Change Device Description (Tape))

CHGDEVTAP Command syntax diagram

 

Purpose

The Change Device Description (Tape) (CHGDEVTAP) command changes the device description for a tape device.

 

Required Parameters

DEVD
Specifies the name of the device description being changed.

 

Optional Parameters

RSRCNAME
Specifies the resource name that describes the automatic call unit port.

Note: Use the Work with Hardware Resources (WRKHDWRSC) command with *STG specified for the TYPE parameter to determine the resource name. This parameter is not allowed for 3422, 3430, 3480, and 3490 tape devices.

*SAME: The value does not change.

resource-name: Specify the name that identifies the physical tape device hardware on the system.

SWTSET
Specifies the switch setting or device address for this device. This parameter is only allowed for types 3422, 3430, 3480, and 3490.

*SAME: The value does not change.

switch-setting: Specify a value ranging from 0 through F for a 3422, 3480, or 3490 tape device; specify a value ranging from 0 through 3 for a 3430 tape device.

ONLINE
Specifies whether this object is automatically varied on at initial program load (IPL).

*SAME: The value does not change.

*YES: The device is automatically varied on at IPL.

*NO: This device is not automatically varied on at IPL.

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

Begin of change

MSGQ
Specifies the name of the message queue to which messages are sent.

*SAME: The name of the message queue does not change.

*SYSOPR Messages are sent to the system operator message queue (QSYS/QSYSOPR).

message-queue-name: Specify the name of the message queue to which operational messages are sent.

The name of the message queue can be qualified by one of the following library values:

*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
Specifies the text that briefly describes the program and its function. More information is in Commonly used parameters.

*SAME: The value does not change.

*BLANK: Text is not specified.

'description': Specify no more than 50 characters of text, enclosed in apostrophes.

Example for CHGDEVTAP 

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 for CHGDEVTAP

*ESCAPE Messages

CPF2618
Device description &1 not changed.