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 (KI1056E) puede ser definido en el fichero de configuración TCP ‘PROFILE’ asignado al puerto de escucha para Editran.

//KI1056EI JOB (SNIM,KIT,,99),LISTENER,MSGCLASS=H,CLASS=A,                     
//             MSGLEVEL=1                                                      
//TCPI  EXEC IMSBATCH,MBR=ZTBPELIS,PSB=ZTBPELIS,IMSID=IMSP,                    
//             PREFIX=IMS510P,REGION=6M                                        
//STEPLIB   DD DSN=IMS510P.RESLIB,DISP=SHR                                     
//          DD DSN=KI.EGDI.LOAD,DISP=SHR                                       
//ZTBPFLIS  DD DSN=KI.EGDI.ZTBP.JCLS(ZTBPFLIS),DISP=SHR                        
//SYSOUT    DD SYSOUT=*                                                        
//                                                                             

//KI0E8A2S JOB (SNIM,KIT,,99),CLIENTE-SERVIDOR,MSGCLASS=H,CLASS=A,             
//             MSGLEVEL=1                                                      
//ZTBPEBDA EXEC IMSBATCH,MBR=ZTBPEBDA,PSB=ZTBPBDDA,PREFIX=IMS510P
//STEPLIB  DD DSN=IMS510P.RESLIB,DISP=SHR                       
//         DD DSN=IMS510P.PGMLIB,DISP=SHR                       
//         DD DSN=KI.EGDI.LOAD,DISP=SHR                         
//DFSVSAMP DD DSN=IMS510P.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=IMS510P,REGION=6M                                        
//STEPLIB   DD DSN=IMS510P.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/01/25 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). El PUERTO se refiere al puerto por el que escucha el Editran remoto (generalmente 07777). Si se dispone de Proxy Editran, podemos indicar

21/01/25 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: ZTB3                                                    
  DIRECCION IP REMOTA (TCP/IP)                                      PUERTO     
   172.022.242.194                                                   07777     
   editran.test.indra.es                                             07779     
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
  COMPRESION (S/N)........ : N    (S:LZW DE FICHERO, N:NO COMPRESION)          
                                                   
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               
                                                                               

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.

//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.