CRTDEVINTR (Create Device Description (Intrasystem)) Command Descripiton

CRTDEVINTR Command syntax diagram

 

Purpose

The Create Device Description (Intrasystem) (CRTDEVINTR) command creates an intrasystem device description, which allows two programs running on the same system to communicate with each other.

 

Required Parameters

DEVD

Specifies the name of the device description being created.

RMTLOCNAME

Specifies the remote location name of the system with which this object communicates.

 

Optional Parameters

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.

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

Example for CRTDEVINTR

CRTDEVINTR   DEVD(INTRALOC)  RMTLOCNAME(INTRARMT)

This command creates a device description named INTRALOC for intrasystem communications with a remote location named INTRARMT.

Error messages for CRTDEVINTR

*ESCAPE Messages

CPF261A

Device description &1 not created due to errors.