> 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/proxy/definiciones-y-cambios-os-390-z-os/version-cics.md).
# Versión CICS
## Definiciones
Para realizar las definiciones, consulte [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) excepto:
Definición del fichero EZACONFG. Al definir el listener, se especificará SECEXIT = EDITR-PR, de forma que se sepa que este listener va a atender a este tipo de conexiones. Si se dispone de Editran/TCP, se definirá otro listener (asociado a otro puerto y otra transid con el mismo programa), con 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 DESAPARECE EN VERSIONES ALTAS DE ZOS
```
En CICS, además de todos los programas Editran/TCP/IP, deben darse de alta los programas ZTBPO203 y ZTBPOTPR.
```
DEFINE PROGRAM(ZTBPO203) GROUP(EDITRAN) LANGUAGE(COBOL) DATALOCATION(ANY)
DEFINE PROGRAM(ZTBPOTPR) GROUP(EDITRAN) LANGUAGE(COBOL) DATALOCATION(ANY)
```
## Campos Onesait Editran (perfiles)
Para ver las definiciones, consulte [Administración y operación](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). Vea las pantallas de entorno local, sesión y líneas.
Entorno:
```
CODIGO LOCAL EDITRAN: 0 0009999 0 NRO.CONEX.SIMULT.LISTENER...: 100
CAMPOS TCP/IP: TCPNAME...: TCPIPB2 TO.MILISEG ENVIOS (001-999).: 100
TIME-OUT USER DATA MAX(MSS)..: 020 BUF.ENVIO TCP-PX (LISTENER).: 262144
USAR SERVER DNS EN LLAM.ENT..: N BUF.RECEP.TCP-PX (LISTENER).: 262144
TIEMPO CONEX. SERVIDOR (SS).: 030
```
Sesión:
```
-------------------------------------------------------------------------------
| 17/03/2026 ADMINISTRADOR DE EDITRAN EDITRAN 5.3 |
| 09:37:48 SESION |
|-----------------------------------------------------------------------------|
| CGO LOCAL..: 0 0009994 0 CGO REMOTO.: 0 0009998 0 APLICACION.: MINAYA |
| 1.- LINEAS LOCALES PROXY: SEL.GENERICA S/N: N |
| REF01: 001 REF02: REF03: REF04: REF05: REF06: |
| |
| |
| |
| |
| |
| |
| 2.- LINEAS REMOTAS TCP/IP (PARA IR CON O SIN PROXY): SEL.GENERICA S/N: N |
| REF01: 001 REF02: REF03: REF04: REF05: REF06: |
| |
| |
| |
| |
| |
| |
| SELECCION DE LINEAS, VISUALIZAR LINEAS SESION. |
| SALIR, RETROCEDER |
-------------------------------------------------------------------------------
```
Líneas PX LOCALES:
```
-------------------------------------------------------------------------------
| 17/03/2026 ADMINISTRADOR DE EDITRAN EDITRAN 5.3 |
| 09:35:46 LINEAS DE COMUNICACIONES |
|-----------------------------------------------------------------------------|
| CRITERIOS SELECCION: |
| PROPIETARIO: L TIPO LINEA.: P CODIGO.....: 0 0000000 0 |
| S PROPIET. TIP NUM CARACTERISTICAS DE LA LINEA |
| - --------- --- --- ------------------------------------------------------- |
| 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 |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| |
| SALIR, SELECCION |
-------------------------------------------------------------------------------
```
Líneas IP REMOTA:
```
-------------------------------------------------------------------------------
| 17/03/2026 ADMINISTRADOR DE EDITRAN EDITRAN 5.3 |
| 09:36:38 LINEAS DE COMUNICACIONES |
|-----------------------------------------------------------------------------|
| CRITERIOS SELECCION: |
| PROPIETARIO: R TIPO LINEA.: I CODIGO.....: 0 0009998 0 |
| S PROPIET. TIP NUM CARACTERISTICAS DE LA LINEA |
| - --------- --- --- ------------------------------------------------------- |
| 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 |
| |
| |
| |
| |
| |
| SALIR, SELECCION |
-------------------------------------------------------------------------------
```
En el registro de sesión, se indica el tipo de conexión (Y = Editran/proxy). Si el remoto no tiene Editran/PX, en su perfil el tipo de conexión será I (IP). Si el remoto tiene a su vez un Editran/PX, ambos extremos codifican Y. También se indican las líneas locales PX y las líneas remotas IP.
## Consulta de la traza
Se ha implementado un protocolo de mensajes de red que es fácilmente interpretable por su similitud a X25, con solicitud de llamada X0B, aceptación X0F y liberación X13 El socket es el número de tarea CICS y la LU es el puerto local o remoto (dependiendo de si es llamada entrante o saliente). Se incluye un mensaje x20 para visualizar errores (consulte el log con causa-diagnóstico. La documentación sobre ERRNO, RETCODE y mensajes de error en la TCPCICS, proporcionados por las macros utilizadas para SOCKET EXTENDIDOS se encuentra disponible en el apéndice C del manual IBM TCP/IP for MVS. CICS TCP/IP Socket Interface Guide and Reference. Document Number SC31-7131-03. Program number 5655 HAL. File Number S370/4300/30xx-50. Ver también Document Number: SC31-8518-00. Si no aparece el errno correspondiente puede que el error se trate de OS390 V2R5 OPEN EDITION, de modo que venga en F1AF9000 IP Planning and Migration Guide
```
17/02/2025 CONSULTA DE FICHEROS EDITRAN 5.3
08:33:02 CONSULTA DE TRAZA
SESION : FECHA : 17/02/2025
SEL SESION HORA S MSJE NSM/LU T COMENTARIO
= ============================= ====== = ==== ====== = ===================
S00DI S00TI EDIPR1 083230 S STC T/O DE CONEXION
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 PET. NOTIFICACION 00
S00DI S00TI EDIPR1 083233 S STN T/O DE NOTIFICACION
S00DI S00TI EDIPR1 083237 E SAR+ RESP. NOTIFICACION 00
S00DI S00TI EDIPR1 083249 E E11 PETICION LIBERACION
S00DI S00TI EDIPR1 083249 S SAB SOL. LIBERACION 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 T/O DE ESPERA DE SAP
S00DI S00TI EDIPR1 083302 E SAP IND. NOTIFICACION 00
S00DI S00TI EDIPR1 083302 S SAR+ RESP. NOTIFICACION 00
```
El significado de la traza previa es el siguiente, por ejemplo, para el mensaje marcado:
1. En las columnas S y Comentario aparece un mensaje entrante (E) y se trata de un mensaje x’0B’ (indicación de llamada).
2. En la columna NSM/LU aparece el puerto remoto (3827).
3. En la columna Comentario aparece un cvc, x’00FD’ o 253 en decimal, que es en realidad el número de tarea CICS (transid ZTBB) que trata la indicación de conexión. Es importante resaltar que, si en un tiempo muy corto dicho número va pegando saltos muy grandes, nos encontraremos con que el CICS se encuentra muy cargado (está ejecutando muchas tareas simultáneamente). Si se detectan problemas en el CICS, revise el entorno local (nro. conexiones por listener), la parametrización de la definición CICS a VTAM, en concreto el parámetro EAS (número de comunicaciones activas simultáneamente) y la relación de os parámetros Tclass de las transacciones con el parámetro CMXT de la SIT (las transid se pueden apuntar a una clase, y en la SIT se limita en número de transid de cada una de las clases. En la SIT está el parámetro MXT para indicar el número de transid CICS.
4. En algunos casos, aparecen unos dígitos, que se corresponden con el CNID (identificador de aplicación, en caso de solicitud de llamada, para que devuelva lo mismo en llamada aceptada.
5. Otros tipos de mensaje son x’0F’ (llamada aceptada), x’13’ (liberación) y x’20’ (error), además del propio x’0B’ que si tiene sentido S significa solicitud de llamada.
6. En caso de Editran/Proxy la clave de mensaje es ETT.
Si seleccionamos el mensaje anterior (traza expandida), vemos el contenido completo de la llamada entrante (entre otras cosas aparecen los campos anteriormente descritos x’0B’):
* x’C5E3E340’ es la clave ‘ETT ‘.
* X’0B’ indica sol-lla.
* X’0EF3’ es el puerto Editran/PROXY de windows-unix (3827).
* X’00FD’ es el identificador del número de tarea (253).
* X’E8’ Indica el tipo de conexión (Y).
* X’0F’ es la longitud de datos de usuario (15)
* X’C0....0A’ son los datos de usuario x25.
* X’F1F7....F6’ es la ip de Editran/PROXY de windows-unix (172.022.164.076)
* X’1E69’ es el puerto remoto (7779)
* X’D6E2F3F0F0C2’, en EBCDIC OS390B es el DNS asociado a la ip final (remoto).
```
17/02/2025 CONSULTA DE FICHEROS EDITRAN 5.3
08:43:19 CONSULTA DE TRAZA
SESION TRAZA...: S00DI S00TI EDIPR1
FECHA SSAAMMDD.: 20040616 HORA HHMMSS....: 083258 ENTRADA/SALIDA.: E
....+....1....+....2....+....3....+....4....+....5....+....6....+....7....
C5E3E3400B00000EF300FD00000000000000000000D70000000000000000000FC0A3300000
9999304544495458310A000000000000000000000000000000000000000000000000404040
40404040404040404040404040404040404040404040404040404040404040404040404040
404040404040404040F1F7F24BF0F2F24BF1F6F44BF0F7F61E634040404040404040404040
40404040404040404040404040404040404040404040404040404040404040404040404040
40404040404040404040D6E2F3F9F0C2F1F0F0F0F9F9F9F4F0F2F0F0F0F9F9F9F4F0C5C4C9
D7D9F100000000000000000000000000000000000000000000000000000000000000000000
01B34040400000404040F0F8F3F2F5F8404040404040
PF2: SWITCH HEXADECIMAL - CARACTER
```
Si pulsamos PF2, se visualiza en mensaje en formato texto y además se incluye información sobre la hora real de proceso (no tiene porqué ser la misma que la de la traza) y sobre la longitud del mensaje tratado (no tiene porqué ser el mismo que el que está en red).
```
17/02/2025 CONSULTA DE FICHEROS EDITRAN 5.3
08:53:06 CONSULTA DE TRAZA
SESION TRAZA...: S00DI S00TI EDIPR1
FECHA SSAAMMDD.: 20040616 HORA HHMMSS....: 083258 ENTRADA/SALIDA.: E
....+....1....+....2....+....3....+....4....+....5....+....6....+....7....
ETT . .3 . P .{t. rr........
172.022.164.076. ...c..
OS390B100099940200099940EDI
PR1
.. 083258
HORA DE PROCESO DE MENSAJE : 083258
LONGITUD DE MENSAJE TRATADO: 000435
PF2: SWITCH HEXADECIMAL - CARACTER
```
Para trazas de más detalle de INDRA, codificar sistema-operativo = EDPR, versión-sistema-operativo = espacios o MULT, y Número-cvcs-máximos = 999. En este caso, se crean cola TS ZTBPEDPR (MULT) o colas TS ZTBH+(MMSS, minutos, segundos) (espacios), con datos sobre escrituras y lecturas de la red, a ser analizados por INDRA.
## Backup
El sistema de backup de conexión proxy, en caso de que falle una llamada es el siguiente:
```
Dir-ip-proxy-local (1) – Dir-ip-remota (1)
....
Dir-ip-proxy-local (1) – Dir.ip.remota (n)
.....
Dir-ip-proxy-local (n) – Dir-ip-remota (1)
....
Dir-ip-proxy-local (n) – Dir.ip.remota (n)
```
## Mensajes de error x’20’ y liberación x’13’
Consulte el 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/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.