Add CICS TCS Entry (ADDCICSTCS)
Where allowed to run:
- Batch job (*BATCH)
- Interactive job (*INTERACT)
- Batch program (*BPGM)
- Interactive program (*IPGM)
- Batch REXX procedure (*BREXX)
- Interactive REXX procedure (*IREXX)
- Using QCMDEXEC, QCAEXEC, or QCAPCMD API (*EXEC)
Threadsafe: No
|
Parameters
Examples
Error messages |
Use the Add CICS Terminal Control System Table (ADDCICSTCS) command to add an entry to the TCS.
The Terminal Control System Table is used to specify the characteristics of remote CICS systems and details of connections between the local and remote systems. An entry in this table:
- Defines the link to a remote system. This can be used by local applications for function shipping, distributed program link (DPL), or distributed transaction processing. It can also be used by the system for transaction routing.
- Can be used in the SYSID option of other table entries to identify the system on which a remote resource resides.
- Can be used in the SYSID option of EXEC CICS commands to identify the location of a remote resource.
| Keyword |
Description |
Choices |
Notes |
| LIB |
Library |
Communications name, *LIBL, *CURLIB |
Required, Positional 1 |
| GROUP |
Group |
Communications name |
Required, Positional 2 |
| SYSID |
Remote CICS system |
Communications name |
Required, Positional 3 |
| NETWORK |
Network |
Communications name, *SYSID |
Optional, Positional 4 |
| MODE |
Mode |
Communications name, *NETATR |
Optional, Positional 5 |
| CDEPAGE |
Code page |
1-65535, *SYSVAL |
Optional, Positional 6 |
| SYSSTS |
Status |
*ENABLED, *DISABLED |
Optional, Positional 7 |
| SNDPFX |
Outbound session prefix |
Communications name, *NONE |
Optional, Positional 8 |
| SNDLMT |
Available outbound sessions |
0-999 |
Optional, Positional 9 |
| RCVPFX |
Inbound session prefix |
Communications name, *NONE |
Optional, Positional 10 |
| RCVLMT |
Available inbound sessions |
0-999 |
Optional, Positional 11 |
| INDSYS |
Indirect CICS system |
Communications name, *NONE |
Optional, Positional 12 |
| RMTNETID |
Remote network indicator |
Communications name, *NETATR, *LOC, *NONE |
Optional, Positional 13 |
Library (LIB)
Enter the name of the OS/400 library that contains the group. Possible values are:
- *LIBL: The library list is used to locate the first OS/400 library that contains the group.
- *CURLIB: The current library contains the group. If no current library is specified, the QGPL library is used.
- library-name: The name of the OS/400 library that contains the group.
Group (GROUP)
The name of the group to which the TCS table entry is to be added.
- group-name: The group name may have a maximum length of 10 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
Remote CICS system (SYSID)
The system identifier used to identify the remote CICS system that can communicate with the CICS control region. This is the name of the TCS entry.
- system-identifier: The system identifier may have a maximum length of 4 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
Network (NETWORK)
The network name used to identify the other CICS system. This has to be the same as the APPLID specified in the CICS System Initialization Table used to start up the CICS system.
Possible values are:
- *SYSID: The system identifier suffixed with four blanks will be used as the network name.
- network: The network may have a maximum length of 8 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
Mode (MODE)
The name that is passed as the mode name.
Possible values are:
- *NETATR: The default mode name as specified in the OS/400 network attributes will be used.
- mode-name: The maximum length is eight characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
Code page (CDEPAGE)
Code page to be used for conversion of data.
Possible values are:
- *SYSVAL: Use the iSeries system code page.
- code-page: Must be numeric, greater than or equal to 1 and less than or equal to 65535.
Status (SYSSTS)
Indicates if the CICS system identifier can be used by a CICS user in the CICS control region, when the CICS Terminal Control System Table entry is defined to the CICS runtime resource table definition Connection Control facility.
Possible values are:
- *ENABLED: CICS system identifier can be used by a CICS user.
- *DISABLED: CICS system identifier can not be used by a CICS user.
Outbound session prefix (SNDPFX)
The prefix to be used as the first part of a conversation identifier for outbound sessions (line connections) to establish unique session names.
Note: When the SNDPFX has the same value as the value in RCVPFX, then the SNDLMT will be set to 1 and the RCVLMT will be set to 0.
Possible values are:
- *NONE: There are no outbound sessions.
- outbound-session-prefix: The maximum length is two characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
Available outbound sessions (SNDLMT)
The number of outbound sessions (line connections) available to the connected CICS system that can be active at any one time.
available-outbound-sessions: Enter a number in the range 0 through 999.
Note: When SNDPFX is 1 character, the value should not be greater than 999; otherwise the value should not be greater than 99.
Inbound session prefix (RCVPFX)
The prefix to be used as the first part of a conversation identifier for inbound sessions (line connections) to establish unique session names.
Note: When the SNDPFX has the same value as the value in RCVPFX, then the SNDLMT will be set to 1 and the RCVLMT will be set to 0.
Possible values are:
- *NONE: There are no inbound sessions.
- inbound-session-prefix: The maximum length is two characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
Available inbound sessions (RCVLMT)
The number of inbound sessions (line connections) available to the connected CICS system that can be active at any one time.
available-inbound-sessions: Enter a number in the range 0 through 999.
Note: When RCVPFX is 1 character, the value should be less than or equal to 999; otherwise the value should be less than or equal to 99.
Indirect CICS system (INDSYS)
Indicates whether this CICS system utilizes another CICS system to relay communication with the CICS control region.
Posssible values are:
- *NONE: The CICS system can directly communicate with the CICS control region.
- system-identifier: The length is four characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.
Remote network indicator (RMTNETID)
Enter the remote network identifier to be used with the other CICS system.
Possible values are:
- *NETATR: The remote network identifier specified in the network attributes is used.
- *LOC: Any remote network identifier for the other CICS system may be used. If several remote network identifiers are associated with the other CICS system, the system automatically selects the remote network identifier.
- *NONE: No remote network identifier is used.
- remote-network-id: The remote network identifier may have a maximum length of 8 characters. The first character must be alphabetic, or one of the special characters, $, @, or #. The remaining characters can be alphanumeric or one of the special characters, $, @, or #.