> 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/estadisticas-monitorizacion-y-alarmas/monitorizacion-de-lineas-de-comunicacion-locales.md).
# Monitorización de líneas de comunicación locales
Esta funcionalidad, permite monitorizar todas las líneas locales (a elegir cuales), de la entidad, indicando cada cuanto tiempo deseamos monitorizarlas. Hay varios tipos de líneas locales: IP y Proxy.
Para utilizarla, se deben seguir los siguientes pasos:
* Entorno local Editran (manual [Administración y Operación](/documentacion-editran/ibm-editran-v5.3-ims/operacion.md)). Debe definir
* La región (ZTBEJMCO) y la transacción de monitorización (ZTBM)
* Los datos relativos al servidor externo de monitorización, en concreto: el puerto y el tiempo, en segundos, que debe esperar la transacción de consultas a que el servidor conteste.
* Gestión de Alarmas. Si se quiere enviar una alarma (mail, sms, etc.) cuando se produzca la caída o activación de una línea, debe dar de alta una sesión de notificación en el administrador de alarmas (6.4) con los códigos local, remoto y de aplicación a nueves (999999999-999999999-999999).
## Procesos de monitorización
### Selección De Líneas Locales
La monitorización de las líneas locales comenzará con la creación del fichero de monitorización. Este fichero contendrá los recursos encontrados en los perfiles de Editran y podrá ser modificado por el usuario para indicar cuáles de esos recursos tienen que ser monitorizados y en qué horario.
La descripción del fichero es la siguiente:
| | | | | |
|---|
| Verificar | Horario | Intervalo | Tipo línea | Datos de línea | Datos actualización |
| 00:00:01/00:23:59 | 00:10:00 | X25 | | |
* Verificar (1byte): con un \* en esta posición se deshabilitará la monitorización para el recurso correspondiente.
* Horario (17bytes): periodo en el que se ha de efectuar la monitorización (hora de inicio / hora de fin)
* Intervalo (8bytes): indica cada cuánto tiempo ha de realizarse el testeo de la línea.
* Tipo de línea (3bytes): IP y PX.
* Datos de línea: datos obtenidos del perfil de Editran necesarios para la monitorización.
* Datos de actualización: fecha y hora de la última comprobación y estado de la línea. Estos datos serán actualizados por el programa que monitoriza.
Los parámetros se separan por guiones.
El JCL que crea este fichero es el ZTBEJSCO. Consta de dos pasos:
* En el primero se recorren las sesiones de transmisión para obtener todas las líneas locales. Se debe introducir vía SYSIN el horario de funcionamiento y el intervalo de testeo por defecto, que podrá ser modificado por cada línea, una vez obtenido el fichero.
* En el segundo paso se eliminan los recursos que estén duplicados.
```cobol
//KI1056EI JOB (SNIM,KIT,,99),MON-INTC,MSGCLASS=H,CLASS=A,
// MSGLEVEL=1,NOTIFY=&SYSUID
//LIBPROC JCLLIB ORDER=IMSP.PROCLIB
/*
//BORRAR EXEC PGM=IEFBR14
//DD1 DD DSN=KI.EGDI.ZTBEFSCO,DISP=(OLD,DELETE,DELETE)
/*
//INTF EXEC IMSBATCH,MBR=ZTBEESCO,PSB=ZTBPEAP1,IMSID=IMSP,REGION=6M
//STEPLIB DD DSN=IMSP.SDFSRESL,DISP=SHR
// DD DSN=KI.EGDI.LOAD,DISP=SHR
//ZTBPFLIS DD DSN=KI.EGDI.ZTBP.JCLS(ZTBPFLIS),DISP=SHR
//ZTBEFSCO DD DSN=&&ZTBEFSCO,DISP=(,PASS,DELETE),
// UNIT=SYSDA,SPACE=(TRK,(1000,100),RLSE),
// DCB=(RECFM=FB,LRECL=138)
//SYSOUT DD SYSOUT=*
//SYSIN DD *
07:30:00/20:00:00-00:30:00
/*
//********************************************************************+
//** ELIMINACION DE DUPLICADOS
//********************************************************************+
//ICEMONR EXEC PGM=ICETOOL
//TOOLMSG DD SYSOUT=*
//DFSMSG DD SYSOUT=*
//INDD DD DSN=&&ZTBEFSCO,DISP=(OLD,PASS,DELETE)
//OUTDD DD DSN=KI.EGDI.ZTBEFSCO,DISP=(NEW,CATLG,DELETE),
// VOL=SER=DES801,SPACE=(TRK,(1000,100),RLSE),
// DCB=(RECFM=FB,LRECL=138)
//TOOLIN DD *
SELECT FROM(INDD) TO(OUTDD) ON(34,90,CH) FIRST
//
```
### Monitorización de Líneas Locales
La revisión periódica de los elementos de comunicación la realiza un programa BMP orientado a transacción que se planifica periódicamente de forma externa. El programa revisa los recursos según lo que indique el fichero de líneas locales (ZTBEFSCO). Notificará la caída o activación de la línea mediante un mensaje de alarmas con el texto del error.
Las acciones a realizar por el módulo para cada tipo de elemento de red son:
* Conexiones TCP/IP. Conexión de un socket con dirección IP de realimentación (127.0.0.1) y el puerto de escucha del listener. Envío de datos de usuario con sesión a nueves y recepción de los mismos.
* Si se produce error al conectar o al escribir, se indicará posible listener caído o inalcanzable.
* Si se produce error al leer o no coincidir los datos, se indicará posible cliente servidor caído.
* Conexión PX. Conexión de un socket al proxy. Envío de mensaje de conexión x’0b’, con dirección IP remota y puerto los del propio Proxy y datos de usuario los de una sesión con código de sesión todo nueves. Si no se reciben los mismos datos generar error.
* Si el error se produce al conectar o al escribir se indicará posible Proxy caído o inalcanzable.
* Si el error se produce al leer los datos o no coincidir se indicará posible listener caído o inalcanzable.
El proceso que se ejecuta es el ZTBEJMCO que se lista a continuación:
```cobol
//KIGE8A2I JOB (SNIM,KIT,,99),MON-RECO,MSGCLASS=H,CLASS=A,
// MSGLEVEL=1,NOTIFY=&SYSUID
//LIBPROC JCLLIB ORDER=IMSP.PROCLIB
/*
//MONRECO EXEC IMSBATCH,MBR=ZTBEEMCO,PSB=ZTBEEMCO,IMSID=IMSP,IN=ZTBM,
// REGION=8M
//STEPLIB DD DSN=IMSP.SDFSRESL,DISP=SHR
// DD DSN=KI.EGDI.LOAD,DISP=SHR
//SYSTCPD DD DSN=SW.TCPIP.SEZAPARM(TCPDATB4),DISP=SHR
//ZTBEFSCO DD DSN=KI.EGDI.ZTBEFSCO,DISP=OLD
//ZTBGFPRI DD SYSOUT=*,DCB=(BLKSIZE=105)
//ZTBGFINT DD SYSOUT=(H,INTRDR),DCB=(BLKSIZE=80)
//SYSOUT DD SYSOUT=*
//
```
## Formato de mensajes informativos
### Mensajes de correo
* Proxy
```
SUBJECT: EDITRAN. Caida de linea(Proxy)
EDITRAN. Caida de linea (2006/01/13 09:38)
Proxy: 10.red-193-152-56.static.ccgg.telefonica.net:7777
Error:ZTP246:ERROR EN LLAMADA A LA INTERFAZ EZASOKET-WRITE -NRO ERROR:00061
```
* TCP/IP
```
SUBJECT: EDITRAN. Caida de linea(TCP)
EDITRAN. Caida de linea (2006/01/13 09:38)
TCP: 172.26.130.26:7777
Error:ZTP246:ERROR EN LLAMADA A LA INTERFAZ EZASOKET-WRITE -NRO ERROR:00061
§ Onesait Editran /Tx
SUBJECT: EDITRAN. Caida de linea(TX)
EDITRAN. Caida de linea (2006/01/13 09:38)
TX: PEPEPEPEP.PEONICA.NET:7777 NRI: 123456789012345
```
* Recuperación de línea
```
SUBJECT: EDITRAN. Recuperacion linea(Proxy)
EDITRAN. Recuperacion linea(26/01/13 09:38)
Proxy: 172.26.130.1:7777
```
### Mensaje SMS
```
EDITRAN. Caida de linea (2006/01/13 09:38)
TCP: 172.26.130.26:7777
EDITRAN. Caida de linea (2006/01/13 09:38)
Proxy: 10.red-193-152-56.static.ccgg.telefonica.net:7777
EDITRAN. Caida de linea (2006/01/13 09:38)
TX: 172.26.130.26:7777 NRI:123456789012345
EDITRAN. Caida de linea (2006/01/13 09:38)
X25 LU:TFSIT3B0 NRI:123456789012345 TC:C0
EDITRAN. Recuperacion linea (2006/01/13 09:38)
X25 LU:TFSIT3B0 NRI:123456789012345 TC:C0
```
### Mensaje de alarmas (LOG)
```
24/06/09 15:51:39 CONSULTA LOG DE ALARMAS EDITRAN/EA 5.3
GES. < e-mail >
SESION PRESENTACION FECHA HORA EXT. SMTP UNIX EXT. SMS
999999999 999999999 999999 18-06-09 12:18:47 00 00 99
Recuperacion linea. Proxy: montilla.indra.es:07778
999999999 999999999 999999 18-06-09 12:18:50 00 00 99
Recuperacion linea. X25 LU:TFSIT3B0 NRI:3171328303 TC:B0
999999999 999999999 999999 18-06-09 13:04:59 00 00 99
Caida de linea. X25 LU:ZTBO NRI:12345 TC:01
999999999 999999999 999999 18-06-09 13:09:11 00 00 99
Caida de linea. TCP: 127.0.0.1:07777
999999999 999999999 999999 18-06-09 13:09:14 00 84 99
Caida de linea. Proxy: montilla.indra.es:07778
000099980 000001230 PRTCP1 19-06-09 09:22:22
PRTCP1ERROR ABEND CODE. CONSULTE SALIDA DEL JCL./CBLQDA(ON)
000099980 000001230 PRTCP1 19-06-09 09:23:19
PRTCP1ERROR ABEND CODE. CONSULTE SALIDA DEL JCL./CBLQDA(ON)
999999999 999999999 999999 19-06-09 10:39:11 00 00 99
Recuperacion linea. TCP: 127.0.0.1:07777
999999999 999999999 999999 19-06-09 10:39:15 00 00 99
Caida de linea. X25 LU:TFSIT3B0 NRI:3171328303 TC:B0
999999999 999999999 999999 19-06-09 10:40:51 00 00 99
Recuperacion linea. Proxy: montilla.indra.es:07778
```
### Mensaje en el Log de Onesait Editran /P
```
24/06/09 CONSULTA DEL LOG EDITRAN/P EDITRAN
16:03:10 -------------------------- 5.3
SESION FECHA HORA MENSAJE
------------------------ ----- -------- ---------------------------------------
999999999999999999999999 19-06 10:39:11 ZTP309:MONITORIZA. TCP. LSTNR=KIGE8A2L P
999999999999999999999999 19-06 10:39:14 ZTP309:MONITORIZA. PROXY. IP=192.168.015
999999999999999999999999 19-06 10:39:14 ZTP241:DETECTA LU FICTICIA NO CONECTADA
999999999999999999999999 19-06 10:39:14 ZTP241:DETECTA LU FICTICIA NO CONECTADA
19-06 10:39:15 ZTP015:RECUPERACION DE CIRCUITOS LU FICT
999999999999999999999999 19-06 10:40:50 ZTP309:MONITORIZA. TCP. LSTNR=KIGE8A2L P
999999999999999999999999 19-06 10:40:51 ZTP309:MONITORIZA. PROXY. IP=192.168.015
999999999999999999999999 19-06 10:40:53 ZTP241:DETECTA LU FICTICIA NO CONECTADA
999999999999999999999999 19-06 10:40:53 ZTP309:MONITORIZA. LU:TFSIT3B0
999999999999999999999999 19-06 10:40:53 ZTP014:LIBERACION TRANSMISION CAUSA : 0D
999999999999999999999999 19-06 10:51:57 ZTP309:MONITORIZA. TCP. LSTNR=KIGE8A2L P
999999999999999999999999 19-06 10:51:59 ZTP309:MONITORIZA. PROXY. IP=192.168.015
999999999999999999999999 19-06 10:52:14 ZTP241:DETECTA LU FICTICIA NO CONECTADA
999999999999999999999999 19-06 10:52:14 ZTP309:MONITORIZA. LU:TFSIT3B0
999999999999999999999999 19-06 10:52:15 ZTP014:LIBERACION TRANSMISION CAUSA : 0D
999999999999999999999999 19-06 10:52:17 ZTP309:MONITORIZA. TCP. LSTNR=KIGE8A2L P
```
### Mensaje en la Traza de Onesait Editran/P
```
24/06/09 CONSULTA DE LA TRAZA EDITRAN
16:09:22 5.3
s SESION FECHA HORA S CLA C NSM COMENTARIO
-------------------------- ----- -------- - --- - ------ ----------------------
999999999999999999999999 19-06 10:39:12 S CLO 0 CIERRA CONEXION TCP
999999999999999999999999 19-06 10:39:12 E E44 MONITORIZA.LU:ZTBO
999999999999999999999999 19-06 10:39:13 S X44 1 LU CAIDA:ZTBO
999999999999999999999999 19-06 10:39:13 E E44 MONITORIZA.LU:TFSIT3B0
999999999999999999999999 19-06 10:39:13 S X44 1 LU CAIDA:TFSIT3B0
000000000000000000000000 19-06 10:39:15 E XAI FB 0000
000000000000000000000000 19-06 10:40:50 E CON 1 INDICACION CONEX. TCP
999999999999999999999999 19-06 10:40:50 E TAK 0 ACEPTA CONEXION TCP
999999999999999999999999 19-06 10:40:50 S CLO 0 CIERRA CONEXION TCP
000000000000000000000000 19-06 10:40:51 E CON 1 INDICACION CONEX. TCP
999999999999999999999999 19-06 10:40:51 E TAK 0 ACEPTA CON. TCP(PROXY)
999999999999999999999999 19-06 10:40:51 S CLO 0 CIERRA CONEXION TCP
999999999999999999999999 19-06 10:40:51 E E44 MONITORIZA.LU:ZTBO
999999999999999999999999 19-06 10:40:51 S X44 1 LU CAIDA:ZTBO
999999999999999999999999 19-06 10:40:51 E E44 MONITORIZA.LU:TFSIT3B0
999999999999999999999999 19-06 10:40:51 S XAI 0B 0000
```
---
# 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/estadisticas-monitorizacion-y-alarmas/monitorizacion-de-lineas-de-comunicacion-locales.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.