CRTDEVOPT (Create Device Description (Optical))

CRTDEVOPT Command syntax diagram

 

Purpose

The Create Device Description (Optical) (CRTDEVOPT) command creates a device description for an optical device. More information about using this command is in the Local Device Configuration book.

 

Required Parameters

DEVD
Specifies the name of the device description being created.

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

*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 created. The resource name will represent virtual (not physical) hardware.

Note: There can be at most one active virtual optical device on the system.
>

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.

 

Optional Parameters

TYPE
Specifies the type of device that this description represents.

*RSRCNAME: The device type is determined from the resource name (RSRCNAME) parameter.

6320: The device type is a compact disc with read-only memory (CD-ROM).

6321: The device type is a CD-ROM drive.

632A: The device type is a generic (Non-IBM) optical drive.

632B: The device type is a virtual optical device.

6330: The device type is a DVD-RAM drive.

6336: The device type is a DVD-ROM drive.>

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

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

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

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

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

AUT
Specifies the authority given to users who do not have specific authority to the device description, who are not on an authorization list, and whose user group has no specific authority to the device description.

*LIBCRTAUT: The authority for the object is the same as the create authority for QSYS. The create authority for QSYS can be displayed by using the Display Library Description (DSPLIBD) command. If the create authority is changed with the Change Library (CHGLIB) command, the new authority does not affect existing objects.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the device description.

*USE: The user can perform basic operations on the device description, such as running a program or reading a file. The user cannot change the device description. *USE authority provides object operational authority, read authority, and execute authority.

*EXCLUDE: The user cannot access the device description.

authorization-list-name: Specify the name of the authorization list used.

TEXT
Specifies the text that briefly describes the device description. More information on this parameter is in Commonly used parameters.

*BLANK: Text is not specified.

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

Examples for CRTDEVOPT 

Example 1: Create an Optical Device Description
CRTDEVOPT   DEVD(OPT01)  RSRCNAME(*OPT01)  TYPE(*RSRCNAME)
This command creates a device description for an optical device that is named OPT01. The device type is determined from the resource name. 
Example 2: Create a Virtual Optical Device Description
CRTDEVOPT   DEVD(VRTOPT01)  RSRCNAME(*VRT)  TYPE(*RSRCNAME)

This command creates a device description for a virtual optical device that is named VRTOPT01. The device type is determined from the resource name. All virtual optical devices will be assigned a TYPE value of 632B.

Error messages for CRTDEVOPT

*ESCAPE Messages

CPF261A
Device description &1 not created due to errors.>