> 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-ims/tcp-ims-documentacion-tecnica/operaciones-de-administracion-y-configuracion.md).
# Operaciones de administración y configuración
## JCL de arranque de los procesos
Las BMPs que forman el Listener y el Cliente-Servidor se ejecutarán mediante dos JCLs (ZTBPJLIS y ZTBPJTCP) que se arrancarán manualmente y permanecerán siempre activos.
El nombre del JOB asociado al Listener (KILSZTCP) puede ser definido en el fichero de configuración TCP ‘PROFILE’ asignado al puerto de escucha para Editran.
```cobol
//KILSZTCP JOB (SNIM,KIT,,99),LISTENER,MSGCLASS=H,CLASS=A,
// MSGLEVEL=1
//TCPI EXEC IMSBATCH,MBR=ZTBPELIS,PSB=ZTBPELIS,IMSID=IMSP,
// PREFIX=IMSP,REGION=6M
//STEPLIB DD DSN=IMSP.RESLIB,DISP=SHR
// DD DSN=KI.EGDI.LOAD,DISP=SHR
//ZTBPFLIS DD DSN=KI.EGDI.ZTBP.JCLS(ZTBPFLIS),DISP=SHR
//SYSOUT DD SYSOUT=*
//
```
```cobol
//KICSZTCP JOB (SNIM,KIT,,99),CLIENTE-SERVIDOR,MSGCLASS=H,CLASS=A,
// MSGLEVEL=1
//ZTBPEBDA EXEC IMSBATCH,MBR=ZTBPEBDA,PSB=ZTBPBDDA,PREFIX=IMS510P
//STEPLIB DD DSN=IMSP.RESLIB,DISP=SHR
// DD DSN=IMSP.PGMLIB,DISP=SHR
// DD DSN=KI.EGDI.LOAD,DISP=SHR
//DFSVSAMP DD DSN=IMSP.PROCLIB(DFSVSAMP),DISP=SHR
//SYSOUT DD SYSOUT=H
//SYSPRINT DD SYSOUT=H
//PRINTDD DD SYSOUT=H
//TCPIP EXEC IMSBATCH,MBR=ZTBPETCP,PSB=ZTBPETCP,IMSID=IMSP,IN=ZTCP,
// PREFIX=IMSP,REGION=6M
//STEPLIB DD DSN=IMSP.RESLIB,DISP=SHR
// DD DSN=KI.EGDI.LOAD,DISP=SHR
//SYSTCPD DD DSN=TCPIP.SEZAINST(TCPDATB2),DISP=SHR
//SYSOUT DD SYSOUT=*,OUTLIM=999999
//
```
## Parada de los procesos
El Cliente-Servidor y el Listener pueden ser parados mediante comandos MODIFY o STOP de consola.
F nnnnnnnn,STOP o bien P nnnnnnn.
El Cliente-Servidor puede detenerse enviándole el mensaje
ZTCx FIN
Donde ZTCx es el nombre de la transacción asignada al cliente.
Como BMP también pueden ser parados con el comando IMS /STO REG n ABDUMP
## Modificación de entorno
En primer lugar, se modificará el Entorno Local.
La transacción o transacciones asociadas al Cliente Servidor (ZTC\* asociadas al programa ZTBPETCP), se dan de alta como CLIENTE SERVIDOR TCP/IP.
La REGION TCP/IP es el nombre del TCP definido en el fichero TCPIP.DATA. Podemos dejarlo en blanco para que lo asuma por defecto
El LIMITE CHKP (límite de ‘check-point’) regula la ejecución de puntos de sincronismo en el Cliente-Servidor. El valor de ‘mensajes’ indica el número de llamadas al DLI a partir del cual se genera ‘check-point’. Deberá aproximarse al número máximo de mensajes por transacción permitido en la instalación para otras aplicaciones. El valor de ‘minutos’ señala el tiempo máximo entre dos ‘check-point’. Sirve para evitar que el Cliente esté largos intervalos de tiempo sin hacer sincronismos.
El INTERVALO T/O es el tiempo máximo en milisegundos que la aplicación utilizará para completar una conexión o para esperar la llegada o el envío de un dato a través de un ‘socket’. Se modificará en la instalación para adaptarlo a la velocidad de respuesta de las instalaciones remotas. Largos intervalos ralentizan la trasmisión mientras que intervalos pequeños pueden aumentar el consumo de CPU.
T/O LLAMADA ENTRANTE: indica el tiempo de espera para la recepción de datos de conexión en una llamada entrante. Generalmente es suficiente un intervalo del orden de 1 o 2 segundos, pero en caso de redes o máquinas sobrecargadas o en caso de remotos con incidencias de programación no corregidas es necesario alargar este tiempo al orden de decenas de segundos.
El BUFFER DE ENVIO y BUFFER DE RECEPCION permiten modificar el ‘buffer’ TCP asignado a cada ‘‘socket’’ cuando no es posible hacerlo en las definiciones TCP. Modifican los valores asignados por defecto en la macro TCPCONFIG del fichero PROFILE.TCPIP (parámetros TCPSENDBfrsize y TCPRCVBufrsize). El valor del buffer nunca debe sobrepasar los máximos permitidos en la macro TCPCONFIG. Este valor se tomará como base para las sesiones donde podrá particularizarse.
El PROXY EDITRAN indica la dirección IP donde se encuentra instalado el producto Editran/Px. Esta facilidad permite el filtrado de peticiones de conexión entrantes o salientes y el control de tráfico. Generalmente se ejecuta en una máquina situada en la DMZ para servir de pantalla entre Internet, o una extranet, y nuestra red interna. El PUERTO se refiere al puerto por el que Editran/Proxy escucha nuestras peticiones de conexión. Para utilizar esta facilidad, en llamadas salientes, hay que indicarlo en la sesión (parámetro USAR PROXY). Las peticiones entrantes pueden entrar, indistintamente, a través del Proxy o bien directamente, de formar transparente.
Estos valores serán arrastrados a todas las Sesiones de Editran.
```
21/06/26 14:26:10 MODIFICACION DEL ENTORNO LOCAL (1) EDITRAN 5.3
------------------------------------------------------------------------------
CODIGO LOCAL: 0 0009998 0 VERSION EDITRAN: 5.2 FASE: 01
ALIAS : L00 NOMBRE INSTALACION : INDRA IMS DESARROLLO
DATOS DE CONEXION
NRO MAX CONEXIONES: 999 REGION TCP/IP :
CLIENTE SERVIDOR : ZTCP ZTC1
LIMITE CHKP : 0200 mensajes 010 minutos
INTERVALO T/O TCP : 000200 mlseg. T/O LLAMADA ENTRANTE: 30 seg.
BUFFER DE ENVIO : 262144 bytes BUFFER DE RECEPCION : 262144 bytes
DIRECCION IP PROXY PUERTO
010.055.000.017 07778
editran.indra.es 07778
```
## Modificación del Remoto
Se pondrá en TIPO CONEXION ‘I’, aparece por defecto y no se puede modificar ‘USAR PROXY TCP/IP= S’ para que las llamadas salientes se dirijan a través del Proxy. El BUFFER DE ENVIO y BUFFER DE RECEPCION permiten modificar el ‘buffer’ TCP asignado a cada ‘‘socket’’ cuando no es posible hacerlo en las definiciones TCP. Modifican los valores asignados por defecto en la macro TCPCONFIG del fichero PROFILE.TCPIP (parámetros TCPSENDBfrsize y TCPRCVBufrsize). El valor del buffer nunca debe sobrepasar los máximos permitidos en la macro TCPCONFIG. Este valor se tomará como base para las sesiones donde podrá particularizarse. Las direcciones IP remotas se consignan como DIRECCIÓN IP REMOTA en formato numérico (999.999.999.999) o como nombres de un DNS ([WWW.INDRA.ES](http://WWW.INDRA.ES)). El PUERTO se refiere al puerto por el que escucha el Editran remoto (generalmente 07777). Si se dispone de Proxy Editran, podemos indicar
```
21/06/26 14:28:53 MODIFICACION ENTIDAD REMOTA EDITRAN 5.3
------------------------------------------------------------------------------
CODIGO REMOTO : 0 0009999 0 NOMBRE: REMOTO PRUEBAS PG VERSION: 5.2
TIPO DE CONEXION : I (I=TCP/IP) USAR PROXY TCP/IP (S/N): S
BUFFER ENVIO : 262144 BUFFER RECEPCION : 262144
TRANSACCION NUCLEO: ZTB2
DIRECCION IP REMOTA (TCP/IP) PUERTO
172.022.242.194 07777
editran.test.indra.es 07779
```
Estos valores serán arrastrados a todas las Sesiones de Editran.
## Adaptación del JCL de arranque del Listener
El proceso del Listener se apoya en un fichero de configuración para adaptar ciertos valores en la instalación.
```cobol
//KILTZTCP JOB (SNIM,KIT,,99),LISTENER,MSGCLASS=H,CLASS=A,
// MSGLEVEL=1
//TCPI EXEC IMSBATCH,MBR=ZTBPELIS,PSB=ZTBPELIS,IMSID=IMSP,
// PREFIX=IMST,REGION=6M
//STEPLIB DD DSN=IMST.SDFSRESL,DISP=SHR
// DD DSN=KI.EGTI.LOAD,DISP=SHR
//ZTBPFLIS DD DSN=KI.EGTI.ZTB.JCLS(ZTBPFLIS),DISP=SHR
//SYSTCPD DD DSN=SW.TCPIP.SEZAPARM(TCPDATB4),DISP=SHR
//SYSOUT DD SYSOUT=*
//
NOMBRE DEL TCP, TCPNAME=TCPIPB
NOMBRE DE LAM TRANSACCION CLIENTE/SERVIDOR, SERVER=ZTCP
NUMERO DE CONEXIONES QUE ACEPTA EL LISTENER, CON-PTE=0050
INTERVALO DE TIME-OUT PARA PASAR CONEXIONES, SEG:MSG-TO=030:000
PUERTO POR EL QUE VOY A ESCUCHAR, PUERTO=7777
TIEMPO ENTRE 'CHECK-POINT' (MINUTOS), CHKP=060
```
Como **TCPNAME** se consigna el nombre de la región TCP que se da de alta en Perfiles. Si lo dejamos a espacios se tomará el valor por defecto para ese JCL (ficha SYSTCPD). El Listener y su Cliente-Servidor deben ejecutarse en la misma región TCP.
EL **SERVER** se corresponde a la transacción del Cliente-Servidor (ZTCP).
CON-PTE indica el número de peticiones de conexión pendientes que el Listener puede acumular sin ser procesadas.
**SEG:MSG-TO** señala en segundos y milisegundos el tiempo máximo que el Listener esperará para que el Cliente-Servidor procese una petición de conexión del remoto. Estos intervalos se alargarán si se producen tiempos de respuesta grandes en el Cliente-Servidor.
**PUERTO** apunta el puerto local por el que la aplicación recibirá las conexiones. Tradicionalmente se asigna el 7777. Este valor es el que puede apuntarse en el fichero. PROFILE como puerto de EDITRAN. Los Editranes remotos reseñarán este puesto en las sesiones que tengan definidas con nosotros. No es necesario que un extremo y otro escuchen por el mismo número de puerto. Basta con que se asocie correctamente el puerto de la sesión local con el puerto de escucha remoto y viceversa.
**CHKP** limita el intervalo máximo de tiempo (en minutos) para realizar ‘check-point’. Es análogo al parámetro LIMITE CHKP definido en el Entorno para el Cliente Servidor. Garantiza que el LISTENER ejecute un sincronismo cada cierto tiempo.
**BUFFER** sirve para modificar el valor del buffer de envío y recepción asignado al ‘socket’, para todas las llamadas entrantes. Tiene el mismo significado que el parámetro BUFFER DE ENVIO y RECEPCION de entorno.
---
# 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-ims/tcp-ims-documentacion-tecnica/operaciones-de-administracion-y-configuracion.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.