> For the complete documentation index, see [llms.txt](https://docs.editran.onesait.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.editran.onesait.com/documentacion-editran/ibm-editran-v5.3-comun-z-os-en/proxy/definiciones-y-cambios-os-390-z-os/version-cics.md).
# CICS Version
## Definitions
To make the definitions, see [TCP,](https://gitlab.devops.onesait.com/onesait/disruptors/ecosystems-editran/editran-documentation/-/blob/public/IBM/5.3/zOS/proxy/definiciones-y-cambios-os-390-z-os/broken-reference/README.md) except:
Definition of the EZACONFG file. When defining the listener, SECEXIT = EDITR-PR will be specified, so that it is known that this listener will handle this type of connection. If Editran/TCP is available, another listener will be defined (associated with another port and another transid with the same program), with SECEXIT = Editran
```
EZAC,ALTER,LISTENER
APPLID ===> BMCIDATR APPLID of CICS System
TRANID ===> ZTBA Transaction Name of Listener
PORT ===> 07777 Port Number of Listener
IMMEDIATE ===> NO Immediate Startup Yes|No
BACKLOG ===> 020 Backlog Value for Listener
NUMSOCK ===> 100 Number of Sockets in Listener
MINMSGL ===> 004 Minimum Message Length
ACCTIME ===> 060 Timeout Value for ACCEPT
GIVTIME ===> 010 Timeout Value for GIVESOCKET
REATIME ===> 000 Timeout Value for READ
FASTRD (*) ===> YES Read Immediately Yes|No
TRANTRN ===> NO Translate TRNID Yes|No
TRANUSR ===> NO Translate User Data Yes|No
SECEXIT ===> EDITR-PR Name of Security Exit
(*) FASTRD DISAPPEARS IN HIGHER ZOS VERSIONS
```
In CICS, in addition to all the Editran/TCP/IP programs, programs ZTBPO203 and ZTBPOTPR must also be defined.
```
DEFINE PROGRAM(ZTBPO203) GROUP(EDITRAN) LANGUAGE(COBOL) DATALOCATION(ANY)
DEFINE PROGRAM(ZTBPOTPR) GROUP(EDITRAN) LANGUAGE(COBOL) DATALOCATION(ANY)
```
## Onesait Editran Fields (profiles)
To see the definitions, see [Administration and operation](https://gitlab.devops.onesait.com/onesait/disruptors/ecosystems-editran/editran-documentation/-/blob/public/IBM/5.3/zOS/proxy/definiciones-y-cambios-os-390-z-os/broken-reference/README.md). See the local environment, session, and lines screens.
Environment:
```
LOCAL EDITRAN CODE: 0 0009999 0 NO. OF SIMULTANEOUS LISTENER CONNS...: 100
TCP/IP FIELDS: TCPNAME...: TCPIPB2 SEND TIMEOUT IN MILLISECONDS (001-999).: 100
USER DATA TIME-OUT MAX(MSS)..: 020 TCP-PX SEND BUFFER (LISTENER).: 262144
USE SERVER DNS IN INCOMING CALLS..: N TCP-PX RECV BUFFER (LISTENER).: 262144
SERVER CONNECTION TIME (SS).: 030
```
Session:
```
-------------------------------------------------------------------------------
| 17/03/2026 EDITRAN ADMINISTRATOR EDITRAN 5.3 |
| 09:37:48 SESSION |
|-----------------------------------------------------------------------------|
| LOCAL CODE..: 0 0009994 0 REMOTE CODE.: 0 0009998 0 APPLICATION.: MINAYA |
| 1.- LOCAL PROXY LINES: GENERIC SEL. Y/N: N |
| REF01: 001 REF02: REF03: REF04: REF05: REF06: |
| |
| |
| |
| |
| |
| |
| 2.- REMOTE TCP/IP LINES (FOR GOING WITH OR WITHOUT PROXY): GENERIC SEL. Y/N: N |
| REF01: 001 REF02: REF03: REF04: REF05: REF06: |
| |
| |
| |
| |
| |
| |
| LINE SELECTION, VIEW SESSION LINES. |
| EXIT, BACK |
-------------------------------------------------------------------------------
```
Local PX lines:
```
-------------------------------------------------------------------------------
| 17/03/2026 EDITRAN ADMINISTRATOR EDITRAN 5.3 |
| 09:35:46 COMMUNICATIONS LINES |
|-----------------------------------------------------------------------------|
| SELECTION CRITERIA: |
| OWNER: L LINE TYPE.: P CODE.....: 0 0000000 0 |
| S OWNER. TYPE NUM LINE CHARACTERISTICS |
| - --------- --- --- ------------------------------------------------------- |
| LOCAL PX 001 010.055.000.017 -07775 |
| LOCAL PX 002 010.055.000.017 -07779 |
| LOCAL PX 003 010.055.000.017 -09999 |
| LOCAL PX 004 010.055.000.052 -07781 |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| EXIT, SELECT |
-------------------------------------------------------------------------------
```
Remote IP lines:
```
-------------------------------------------------------------------------------
| 17/03/2026 EDITRAN ADMINISTRATOR EDITRAN 5.3 |
| 09:36:38 COMMUNICATIONS LINES |
|-----------------------------------------------------------------------------|
| SELECTION CRITERIA: |
| OWNER: R LINE TYPE.: I CODE.....: 0 0009998 0 |
| S OWNER. TYPE NUM LINE CHARACTERISTICS |
| - --------- --- --- ------------------------------------------------------- |
| 000099980 IP 001 172.022.242.195 -07777 |
| 000099980 IP 002 172.022.242.195 -07778 |
| 000099980 IP 003 MADZOSIMSPRUE.INDRA.ES -07777 |
| 000099980 IP 004 MADZOSIMSPRUE.INDRA.ES -07778 |
| 000099980 IP 005 010.055.000.017 -07776 |
| 000099980 IP 006 010.055.000.017 -07778 |
| 000099980 IP 007 127.000.000.001 -07776 |
| 000099980 IP 008 127.000.000.001 -07778 |
| 000099980 IP 009 172.022.242.193 -07773 |
| |
| |
| |
| |
| |
| EXIT, SELECT |
-------------------------------------------------------------------------------
```
In the session log, the type of connection is indicated (Y = Editran/proxy). If the remote side does not have Editran/PX, its profile connection type will be I (IP). If the remote side also has an Editran/PX, both ends are coded Y. The local PX lines and the remote IP lines are also indicated.
## Trace query
A network message protocol has been implemented that is easily interpretable due to its similarity to X25, with call request X0B, acceptance X0F and release X13. The socket is the CICS task number and the LU is the local or remote port (depending on whether it is an incoming or outgoing call). An x20 message is included to display errors (see the log with cause-diagnosis. The documentation on ERRNO, RETCODE and error messages in TCPCICS, provided by the macros used for EXTENDED SOCKETS, is available in appendix C of the IBM TCP/IP for MVS manual. CICS TCP/IP Socket Interface Guide and Reference. Document Number SC31-7131-03. Program number 5655 HAL. File Number S370/4300/30xx-50. See also Document Number: SC31-8518-00. If the corresponding errno does not appear, the error may be OS390 V2R5 OPEN EDITION, so it comes in F1AF9000 IP Planning and Migration Guide
```
17/02/2025 FILE QUERY EDITRAN 5.3
08:33:02 TRACE QUERY
SESSION : DATE : 17/02/2025
SEL SESSION TIME S MSGE NSM/LU T COMMENT
= ============================= ====== = ==== ====== = ===================
S00DI S00TI EDIPR1 083230 S STC CONNECTION TIMEOUT
S00DI S00TI EDIPR1 083230 S ETT 07777 0B 0002
S00DI S00TI EDIPR1 083233 E ETT 07777 0F 00D8 0002
S00DI S00TI EDIPR1 083233 S SAP NOTIFICATION REQUEST 00
S00DI S00TI EDIPR1 083233 S STN NOTIFICATION TIMEOUT
S00DI S00TI EDIPR1 083237 E SAR+ NOTIFICATION RESPONSE 00
S00DI S00TI EDIPR1 083249 E E11 RELEASE REQUEST
S00DI S00TI EDIPR1 083249 S SAB RELEASE REQUEST 02
S00DI S00TI EDIPR1 083249 E ETT 07777 13 00D8 0000 00 0F
S S00DI S00TI EDIPR1 083258 E ETT 03827 0B 00FD
S00DI S00TI EDIPR1 083258 S ETT 03827 0F 00FD
S00DI S00TI EDIPR1 083258 S STS SAP WAIT TIMEOUT
S00DI S00TI EDIPR1 083302 E SAP NOTIFICATION IND. 00
S00DI S00TI EDIPR1 083302 S SAR+ NOTIFICATION RESPONSE 00
```
The meaning of the previous trace is as follows, for example, for the marked message:
1. In the S and Comment columns appears an incoming message (E) and it is an x’0B’ message (call indication).
2. In the NSM/LU column appears the remote port (3827).
3. In the Comment column appears a cvc, x’00FD’ or 253 in decimal, which is actually the CICS task number (transid ZTBB) that handles the connection indication. It is important to note that if within a very short time said number jumps by very large amounts, we will find that CICS is heavily loaded (it is running many tasks simultaneously). If problems are detected in CICS, check the local environment (number of connections per listener), the parameterization of the CICS to VTAM definition, specifically the EAS parameter (number of communications active simultaneously), and the relationship of the Tclass parameters of the transactions with the CMXT parameter of the SIT (the transid can be assigned to a class, and in the SIT the number of transid of each class is limited. In the SIT there is the MXT parameter to indicate the number of CICS transid.
4. In some cases, a few digits appear, which correspond to the CNID (application identifier, in case of call request, so that it returns the same in accepted call.
5. Other message types are x’0F’ (call accepted), x’13’ (release) and x’20’ (error), in addition to x’0B’ itself, which, if S makes sense, means call request.
6. In the case of Editran/Proxy the message key is ETT.
If we select the previous message (expanded trace), we see the full content of the incoming call (among other things the previously described fields x’0B’ appear):
* x’C5E3E340’ is the ‘ETT ‘ key.
* X’0B’ indicates call request.
* X’0EF3’ is the Editran/PROXY port of Windows-Unix (3827).
* X’00FD’ is the task number identifier (253).
* X’E8’ indicates the connection type (Y).
* X’0F’ is the user data length (15)
* X’C0....0A’ are the x25 user data.
* X’F1F7....F6’ is the Editran/PROXY IP of Windows-Unix (172.022.164.076)
* X’1E69’ is the remote port (7779)
* X’D6E2F3F0F0C2’, in EBCDIC OS390B is the DNS associated with the final IP (remote).
```
17/02/2025 FILE QUERY EDITRAN 5.3
08:43:19 TRACE QUERY
TRACE SESSION...: S00DI S00TI EDIPR1
DATE YYMMDD.: 20040616 TIME HHMMSS....: 083258 IN/OUT.: E
....+....1....+....2....+....3....+....4....+....5....+....6....+....7....
C5E3E3400B00000EF300FD00000000000000000000D70000000000000000000FC0A3300000
9999304544495458310A000000000000000000000000000000000000000000000000404040
40404040404040404040404040404040404040404040404040404040404040404040404040
404040404040404040F1F7F24BF0F2F24BF1F6F44BF0F7F61E634040404040404040404040
40404040404040404040404040404040404040404040404040404040404040404040404040
40404040404040404040D6E2F3F9F0C2F1F0F0F0F9F9F9F4F0F2F0F0F0F9F9F9F4F0C5C4C9
D7D9F100000000000000000000000000000000000000000000000000000000000000000000
01B34040400000404040F0F8F3F2F5F8404040404040
PF2: HEXADECIMAL - CHARACTER SWITCH
```
If we press PF2, the message is displayed in text format and also information is included about the real processing time (it does not have to be the same as the trace time) and about the length of the processed message (it does not have to be the same as the one on the network).
```
17/02/2025 FILE QUERY EDITRAN 5.3
08:53:06 TRACE QUERY
TRACE SESSION...: S00DI S00TI EDIPR1
DATE YYMMDD.: 20040616 TIME HHMMSS....: 083258 IN/OUT.: E
....+....1....+....2....+....3....+....4....+....5....+....6....+....7....
ETT . .3 . P .{t. rr........
172.022.164.076. ...c..
OS390B100099940200099940EDI
PR1
.. 083258
MESSAGE PROCESSING TIME : 083258
PROCESSED MESSAGE LENGTH: 000435
PF2: HEXADECIMAL - CHARACTER SWITCH
```
For more detailed INDRA traces, code operating system = EDPR, operating-system version = spaces or MULT, and Maximum-cvcs-Number = 999. In this case, TS queue ZTBPEDPR (MULT) or TS queues ZTBH+(HHMMSS, minutes, seconds) (spaces) are created, with data about network writes and reads, to be analyzed by INDRA.
## Backup
The proxy connection backup system, in case a call fails, is as follows:
```
Local proxy IP address (1) – Remote IP address (1)
....
Local proxy IP address (1) – Remote IP address (n)
.....
Local proxy IP address (n) – Remote IP address (1)
....
Local proxy IP address (n) – Remote IP address (n)
```
## Error messages x’20’ and release x’13’
See the manual Manual\_de\_usuario-editranTCP-CICS\_documentaciónTécnica. (CICS)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.editran.onesait.com/documentacion-editran/ibm-editran-v5.3-comun-z-os-en/proxy/definiciones-y-cambios-os-390-z-os/version-cics.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.