Create Comm Side Information (CRTCSI)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Create Communications Side Information (CRTCSI) command creates a side information object in a specific library. The side information object name must be unique in the library in which the side information object is to be created. More information on how the system uses the RMTLOCNAME, DEV, LCLLOCNAME, and RMTNETID parameters to select an APPC device description is in the APPC Programming book, SC41-5443.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CSI | Side information | Qualified object name | Required, Positional 1 |
| Qualifier 1: Side information | Name | ||
| Qualifier 2: Library | Name, *CURLIB | ||
| RMTLOCNAME | Remote location | Communications name | Optional |
| TNSPGM | Transaction program | Character value | Optional |
| TEXT | Text 'description' | Character value, *BLANK | Optional |
| DEV | Device | Communications name, *LOC | Optional |
| LCLLOCNAME | Local location | Communications name, *LOC, *NETATR | Optional |
| MODE | Mode | Communications name, *NETATR | Optional |
| RMTNETID | Remote network identifier | Communications name, *LOC, *NETATR, *NONE | Optional |
| AUT | Authority | Name, *LIBCRTAUT, *CHANGE, *ALL, *USE, *EXCLUDE | Optional |
| Top |
Side information (CSI)
Specifies the name of the side information object to be created. An object name must be specified.
This is a required parameter.
- side-information-name
- Specify the name of the object that will contain the desired side information object.
The possible library values are:
- *CURLIB
- The side information object is created in the current library. If no library is specified as the current library for the job, QGPL is used.
- library-name
- Specify the name of the library where the side information object is created.
| Top |
Remote location (RMTLOCNAME)
Specifies the remote location name with which your program communicates. 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 of the remote program.
This is a required parameter.
| Top |
Transaction program (TNSPGM)
Specifies the name (up to 64 characters) of the transaction program on the remote system to be started.
Note: To specify SNA service transaction program names, enter the hexadecimal representation of the service transaction program name. For example, to specify a service transaction program name whose hexadecimal representation is 21F0F0F1, you would enter X'21F0F0F1'.
More information on SNA service transaction program names is in the SNA Transaction Programmer's Reference Manual for LU Type 6.2.
This is a required parameter.
| Top |
Text 'description' (TEXT)
Specifies the text that briefly describes the object.
The possible values are:
- *BLANK
- No text is specified.
- 'description'
- Specify no more than 50 characters of text, enclosed in apostrophes.
| Top |
Device (DEV)
Specifies the name of the device description used for the remote system.
The possible values are:
- *LOC
- device-name
- The device is determined by the system.
| Top |
Local location (LCLLOCNAME)
Specifies the local location name.
The possible values are:
- *LOC
- The local location name is determined by the system.
- *NETATR
- The LCLLOCNAME value specified in the system network attributes is used.
- local-location-name
- Specify the name of your location. Specify the local location if you want to indicate a specific location name for the remote location.
| Top |
Mode (MODE)
Specifies the mode used to control the session. This name is the same as the Common Programming Interface (CPI)- Communications mode_name.
The possible values are:
- *NETATR
- The mode 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 are not allowed.
| Top |
Remote network identifier (RMTNETID)
Specifies the remote network identifier used with the remote location. 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 of the remote program.
The possible values are:
- *LOC
- The remote network ID for the remote location is used.
- *NETATR
- The remote network identifier specified in the network attributes is used.
- *NONE
- The remote network has no name.
- remote-network-id
- Specify a remote network ID.
| Top |
Authority (AUT)
Specifies the authority you are giving to users who do not have specific authority for the object, who are not on an authorization list, and whose group profile or supplemental group profiles do not have specific authority for the object.
The possible values are:
- *LIBCRTAUT
- Public 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 existing objects.
- *CHANGE
- The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.
- *ALL
- The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) 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 object.
- *USE
- The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.
- *EXCLUDE
- The user cannot access the object.
- authorization-list
- Specify the name of the authorization list whose authority is used for the side information.
| Top |
Examples
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.
| Top |
Error messages
*ESCAPE Messages
- CPF3B82
- Communications side information object &1 already exists in library &2.
- CPF3B83
- Communications side information object &1 not created in library &2.
| Top |