CRTDEVASP (Create Device Description (ASP))

CRTDEVASP Command syntax diagram

 

Purpose

The Create Device Description (ASP) (CRTDEVASP) command creates a device description for an auxiliary storage pool (ASP) device.

 

Required Parameters

DEVD

Specifies the name of the device description being created.

RSRCNAME

Specifies the resource name that identifies the auxiliary storage pool (ASP) by which a collection of disks is known.

 

Optional Parameters

RDB

Specifies the relational database(RDB) name to associate with the auxiliary storage pool(ASP) device.

*GEN: The RDB name will be generated by the operating system after a successful vary on of the device. If the device is the primary ASP of an ASP group, the RDB name will be the same as the device name. If the ASP device is a secondary ASP or user-defined file system (UDFS) ASP the RDB name will be set to blanks.

relational-database-name: Specify the RDB name to associate with the ASP device. The specified RBD name will not be used if the ASP device description is a secondary ASP or UDFS ASP. If the ASP device description is the primary ASP of an ASP group when the ASP group is varied on, the specified RDB name will become the name by which the relational database is known on this system and other systems which connect to this system.

MSGQ

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 object, who are not on the authorization list, or whose user group has no specific authority to the object.

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

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

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

*EXCLUDE: The user cannot access the device description.

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

TEXT

Specifies text that briefly describes the device description.

*BLANK: Text is not specified.

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

Examples for CRTDEVASP

Example 1: Create an independent ASP device

CRTDEVASP   DEVD(COMPANY1) RSRCNAME(COMPANY1)

This command creates a device description for an 
independent ASP named COMPANY1.  The resource name for
the device description is also named COMPANY1. 
Operational messages messages for independent ASP
COMPANY1 will be sent to message queue QSYSOPR in
library QSYS.

Example 2: Create a Primary ASP Device

CRTDEVASP  DEVD(WAREHOUSE2)  RSRCNAME(WAREHOUSE2)
           RDB(WAREHOUSE_NUMBER_2)
           MSGQ(INVENTORY/WH2)

This command creates a device description for a primary
ASP named WAREHOUSE2.  The resource name for the
device description is also named WAREHOUSE2.  The 
relational database (RDB) name that will be associated with
the ASP group when this primary ASP device is varied on
is WAREHOUSE_NUMBER_2.  Operational messages for
independent ASP WAREHOUSE2 will be sent to message
queue WH2 in library INVENTORY.

Error messages for CRTDEVASP

*ESCAPE Messages

CPF261A

Device description &1 not created due to errors.