Change Device Desc (Optical) (CHGDEVOPT)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Change Device Description (Optical) (CHGDEVOPT) command changes the device description for an optical device.

Top

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

Device description (DEVD)

Specifies the name of the device description being changed.

This is a required parameter.

Top

Resource name (RSRCNAME)

Specifies the resource name that identifies the hardware that the description represents.

*SAME
The value does not change.
*NONE
No resource name is specified. A resource name must be provided before the device can be varied on.
*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 that identifies the optical device hardware on the system.

Note: Use the Work with Hardware Resources (WRKHDWRSC) command with TYPE(*STG) specified to determine the resource name.

Top

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

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

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

Examples

CHGDEVOPT   DEVD(OPT01)  ONLINE(*YES)

This command changes the device description of an optical device that is named OPT01 so that the device is automatically varied on at IPL.

Top

Error messages

*ESCAPE Messages

CPF2618
Device description &1 not changed.
Top