CRTCSI (Create Communications Side Information)

CRTCSI Command syntax diagram

 

Purpose

The Create Communications Side Information (CRTCSI) command is used to create a side information object in a specific library. The side information object name must be unique for the library in which the side information object is to be created.

 

Required Parameters

CSI

Specifies the name of the side information object to be created. An object name must be specified. The side information object is accessed by the symbolic destination name (sym_dest_name) parameter on the Initialize_Conversation (CMINIT) call.

The name of the side information object can be qualified by one of the following library values:

*CURLIB: The side information object is created in the current library for the job. 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 where the side information object is created.

side-information-name: Specify the name of the object that contains the desired side information. This is the CPI-Communications symbolic destination name (sym_dest_name).

RMTLOCNAME

Specifies the remote location name that is associated with the symbolic destination name. The Common Programming Interface (CPI) -Communications partner_LU_name, which consists of the remote network identifier and the remote location, determines the remote logical unit (LU) of the remote program.

TNSPGM

Specifies the name (up to 64 characters) of the transaction program on the remote system to be started. This is the CPI-Communications TP_name. The user can enter SNA service transaction program names by specifying hexadecimal input. For example, '03F0F0F4' is a valid input format for an SNA service transaction program.

 

Optional Parameters

DEV

Specifies the name of the device description used for the remote system.

*LOC: The device associated with the remote location is used. If several devices are associated with the remote location, the system determines which device is used.

device-name: Specify the name of a communications device associated with the remote location. If the device name is not valid for the remote location, a message is sent when the program device entry is acquired.

LCLLOCNAME

Specifies the local location name.

*LOC: The device associated with the remote location is used. If several devices are associated with the remote location, the system determines which device is used.

*NETATR: The LCLLOCNAME value specified in the system network attributes is used.

local-location-name: Specify the name of the local location. Specify the local location if the remote location is also indicated by a specific local location name.

MODE

Specifies the mode used to control the session. This name is the same as the CPI-Communications mode_name.

*NETATR: The mode name specified in the network attributes is used.

*BLANK: Eight blank characters are used.

mode-name: Specify a mode_name for the remote location.

Note:

The values SNASVCMG and CPSVCMG cannot be specified.

RMTNETID

Specifies the remote network identifier used with the remote location. The CPI-Communications partner_LU_name, which consists of the remote network identifier and the remote location, locates the LU in the network.

*LOC: The remote network ID for the remote location is used.

*NETATR: The RMTNETID value specified in the system network attributes is used.

*NONE: The remote network has no name.

remote-network-ID: Specify a remote network ID.

AUT

Specifies the authority given to users who do not have specific authority to the object, who are not on the authorization list, and whose user groups have no specific authority to the object.

*LIBCRTAUT: Authority for the object is taken from the CRTAUT parameter of the specified library. This value is determined at create time. If the CRTAUT value for the library changes after the object is created, the new value does not affect any 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 on the object 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 can transfer ownership of the object.

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

*EXCLUDE: The user cannot access the communications side information.

authorization-list: Specify the name of the authorization list whose authority is used for the side information.

TEXT

Specifies the text that briefly describes the object and its function. 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 CRTCSI

CRTCSI   CSI(QGPL/SIDEOBJ)  RMTLOCNAME(APPC2)
  TNSPGM(TESTNOP)  AUT(*CHANGE)

This command creates a communications side information object named SIDEOBJ in library QGPL. The remote location name is set to APPC2, the transaction program name to TESTNOP. The authority to the object is *CHANGE.

Error messages for CRTCSI

*ESCAPE Messages

CPF3B82

Communications side information object &1 already exists in library &2.

CPF3B83

Communications side information object &1 not created in library &2.