> 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/consulta-on-line-alarmas.md). # Consulta on-line Alarmas El acceso al sistema de alarmas, para su administración y consulta, se realiza mediante la opción 5 del menú principal de la transacción del operador de Editran. En el menú principal se muestran las diferentes opciones que el usuario tiene para conseguir la información deseada. A continuación, se muestra dicho menú y se explicarán cada una de las opciones que se presentan en él. ## Menú principal ``` ------------------------------------------------------------------------------ | DD/MM/AA CONTROL Y GESTION DE ALARMAS EDITRAN/EA | | HH:MM:SS 5.3 | ------------------------------------------------------------------------------ | | | | | | | 1 CONSULTA LOG DE ALARMAS | | | | 2 ADMINISTRADOR DE ALARMAS (ENTORNO) | | | | 3 ADMINISTRADOR DE ALARMAS (SESION) | | | | 4 HABILITAR GESTION DE ALARMAS | | | | 5 DESHABILITAR GESTION DE ALARMAS | | | | | | | | OPCION ---> | | | | | | | ------------------------------------------------------------------------------ ``` * Opción: > Se permitirán los valores especificados en la pantalla. ## Consulta Log de Alarmas. Se visualizan los mensajes grabados en las siguientes situaciones: * Cuando se produzcan incidencias en los procesos previos/posteriores a la emisión y recepción de los datos. * En los procesos de interrupción de la transmisión (A7I), que provoquen un cambio de estado en la sesión de presentación. * Mensajes que el usuario indique expresamente. A continuación, se muestran las dos pantallas asociadas a esta consulta. ``` ------------------------------------------------------------------------------ | DD/MM/AA CONTROL Y GESTION DE ALARMAS EDITRAN/EA | | HH:MM:SS CONSULTA DEL LOG DE ALARMAS 5.3 | ------------------------------------------------------------------------------ | | | | | | | CODIGO LOCAL : x nnnnnnn x | | | | CODIGO REMOTO : x nnnnnnn x | | | | APLICACION : xxxxxx | | | | FECHA (DD/MM/AA): dd / mm / aaaa | | | | HORA (HH:MM:SS): hh : mm : ss | | | | | | | | | | | | | | | ------------------------------------------------------------------------------ ``` La consulta del log puede dividirse, en cuanto a las sesiones que afecta, en: * General. Se obtiene sin teclear ninguno de los Códigos. Se muestran los mensajes de todas las Sesiones. * Específica. Se obtiene introduciendo los Códigos Local, Remoto y de Aplicación que componen la Sesión. Se muestran los mensajes de esa Sesión. * Parcial. Se obtiene no introduciendo o poniendo “\*” en alguno de los tres Códigos, o introduciendo el principio o el final de un Código con un “\*” detrás o delante, respectivamente, del Código parcial, o cualquier combinación que no convierta la consulta en alguna de las dos anteriores. Se muestran todos los mensajes que cumplan todos los criterios de selección. En razón del momento en que se han procesado los mensajes: * Si no se introducen ni la Fecha ni la hora, se muestran los últimos mensajes que cumplan los criterios de selección de Códigos. * Si se introduce la Fecha, pero no la Hora, se muestran los primeros mensajes de esa Fecha. * Si se introducen la Fecha y la Hora, se muestran los mensajes de esa Fecha a partir de esa Hora. * El año de la fecha se puede introducir con 4 ó 2 dígitos. En éste último caso, si es 96 a 99 se supone que se trata de 1996 a 1999; si es inferior a 96 se considera del 2000 al 2095. Ejemplo de la consulta de log. ``` 04/03/03 15:16:10 CONSULTA LOG DE ALARMAS EDITRAN/EA 5.3 GES. < e-mail > SESION PRESENTACION FECHA HORA EXT. SMTP UNIX EXT. SMS 000099980 000000010 PRUEBA 03-03-03 08:48:12 99 ZTG0017-ZTBGB244:ERROR EN PROCESO DE CONVERSOR ZTBGBG40. R-C: 00163 000099980 000000010 PRUEBA 03-03-03 11:55:33 00 00 ERROR ABEND CODE. CONSULTE SALIDA DEL JCL. 000099980 000000010 PRUEBA 03-03-03 11:55:35 00 00 ERROR ABEND CODE. CONSULTE SALIDA DEL JCL. 000099980 000000010 PRUEBA 03-03-03 11:55:37 00 00 ERROR ABEND CODE. CONSULTE SALIDA DEL JCL. 000099980 000000010 PRUEBA 03-03-03 12:04:27 00 00 ZTG0063-SE COMUNICA A EDITRAN ERROR EN CARGA DE EMISION (A1R) 000099980 000000010 PRUEBA 03-03-03 15:58:46 00 00 ZTG0211-ZTBGB213: NO HAY NINGUN FICHERO DE APLICACION CATALOGADO 000099980 000000010 PRUEBA 03-03-03 16:00:21 00 00 ZTG0063-SE COMUNICA A EDITRAN ERROR EN CARGA DE EMISION (A1R) 000099980 000000010 PRUEBA 03-03-03 16:02:11 00 00 ZTG0211-ZTBGB213: NO HAY NINGUN FICHERO DE APLICACION CATALOGADO 000099980 000000010 PRUEBA 03-03-03 16:12:20 00 00 ZTG0019-PETICION DE CARGA DE PRESENTACION DE EMISION 000099980 000000010 PRUEBA 04-03-03 12:32:34 00 00 ZTG0019-PETICION DE CARGA DE PRESENTACION DE EMISION ``` ## Administrador de Alarmas - Entorno. Cuando se elige la opción 2 del menú principal, aparece una pantalla con los datos que se guardan en el entorno. ``` ------------------------------------------------------------------------------ | DD/MM/AA ADMINISTRADOR DE ALARMAS EDITRAN/EA | | HH:MM:SS ENTORNO LOCAL 5.3 | ------------------------------------------------------------------------------ | DATOS GENERALES PARA LA CONEXION A GESTORES EXTERNOS: | | Prog.llamado via CALL: xxxxxxxx | | Datos de paso a prog.: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx | | DATOS GENERALES PARA LA CONEXION E-MAIL: | | Para: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx | | DATOS GENERALES PARA LA CONEXION SMS: | | Numero Telefono (SMS): nnnnnnnnnnnnnnn | | DATOS ESPECIFICOS PARA LA CONEXION E-MAIL VIA SMTP: | | De : xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx | | Nbre.Dominio Maq.SMTP: xxxxxxxx Nbre.Proc. SMTP/Clase: xxxxxxxx x | | DATOS ESPECIFICOS PARA LA CONEXION E-MAIL VIA UNIX: | | De : xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx | | Nbre. Proceso Alarma : xxxxxxxx | | DATOS GENERALES PARA LA CONEXION A SERVER EXTERNOS (E-MAIL Y SMS) | | Linea Remota TCP/IP (DNS/IP-ADDRESS + PUERTO REMOTO): | | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx nnnnn | | Intervalo de espera : nnn Region TCP/IP : xxxxxxxx | | | | | ------------------------------------------------------------------------------ ``` DATOS GENERALES PARA LA CONEXION A GESTORES EXTERNOS * Programa llamado vía CALL: > Nombre del programa de usuario que es llamado desde el procedimiento Editran. * Datos de paso a programa: > Datos para pasar al programa de usuario. La descripción detallada de estos parámetros puede consultarse en el apartado *"Administrador de Alarmas - Sesión"*, en la definición correspondiente a “Datos aviso gestor externo”. DATOS GENERALES PARA LA CONEXION E-MAIL * Para: > Dirección de correo electrónico del usuario al que se desea notificar la incidencia. El valor de este campo se tomará por defecto para dar de alta sesiones. DATOS GENERALES PARA LA CONEXION SMS * Número Teléfono (SMS): > Número de teléfono al que se desea notificar la incidencia. El valor de este campo se tomará por defecto para dar de alta sesiones. DATOS GENERALES PARA LA CONEXION E-MAIL VIA SMTP * De: > Dirección de correo electrónico del usuario que notifica la incidencia. Debe ser reconocido por la máquina SMTP. * Nombre Dominio Máquina SMTP: > Nombre del dominio de la máquina SMTP. Sirve para identificar el nombre del dominio del host que hace el envío. * Nombre Procedimiento SMTP/Clase: > Nombre del procedimiento con el que se ha arrancado el servidor SMTP, (address space name), normalmente se llama SMTP y clase de salida (spool class) para el correo enviado. Se recomienda utilizar la clase punch del sistema (clase B). DATOS GENERALES PARA LA CONEXION E-MAIL VIA UNIX * De: > Dirección de correo electrónico del usuario que notifica la incidencia. Debe ser reconocido por el UNIX System Service del OS/390. * Nombre del Proceso de Alarma: > Nombre de procedimiento a arrancar en caso de que el envío de correo se haga desde la partición UNIX del OS/390. Para poder usarlo, el programa *sendmail* tiene que estar activo. Al final de este punto se muestra el procedimiento suministrado con la instalación: ZTBEPSEN. DATOS GENERALES PARA LA CONEXION A SERVER EXTERNOS (E-MAIL Y SMS) * Línea Remota TCP/IP (DNS/IP-ADDRESS + PUERTO REMOTO): > Dirección en la que se encuentra el servidor Editran que va a resolver el correo electrónico y el SMS. * Intervalo de espera: > Tiempo máximo de conexión en segundos, al servidor de Editran para e-mail externo y para SMS. Se recomienda entre 10 y 20 segundos. Admite hasta 300 segundos. * Región TCP/IP: > Nombre del procedimiento TCP/IP de la instalación por el que se conectará con el servidor Editran para e-mail externo y SMS. Se tiene que poder acceder a él desde el IMS. Procedimiento ZTBEPSEN. ```cobol // PROC IDENMAIL=,FCODSMTP= //********************************************************************* //* INDRA - COMUNICACIONES ENERO 2003 * //********************************************************************* //* PROCEDIMIENTO DE ENVIO DE CORREO FORMATO SMTP VIA CLIENTE * //* SENDMAIL, RESIDENTE EN USS * //********************************************************************* //* DATOS RECIBIDOS: * //* RECIBE IDENMAIL = ES UN PARM DE 7 OCTETOS QUE IDENTIFICA EL * //* MENSAJE A ENVIAR. COMIENZA POR X * //* RECIBE FCODSMTP = ES EL FICHERO A ENVIAR (HASTA 44 OCTETOS) * //* EL ULTIMO PUNTERNO ES IDENMAIL * //********************************************************************* //* FICHEROS CREADOS EN USS: * //* EL FICHERO DE ENTRADA MVS (X*) SE COPIA A USS--> M&IDENMAIL * //* SE CREA UN STDOUT --> O&IDENMAIL * //* SE CREA UN STDERR --> E&IDENMAIL * //********************************************************************* //* // SET TMPMODE='SIWUSR,SIRUSR,SIRGRP,SIWGRP,SIROTH,SIWOTH' // SET TMPOPTW='OWRONLY,OCREAT,OTRUNC' // SET TMPOPTR='ORDONLY' //* //********************************************************************* //* UBICAMOS LOS FICHEROS DE TRAAJO Y EL PATH DEL PROGRAMA SENDMAIL * //* ATENCION. DIRECTORIOS TRABAJO TIENEN QUE TENER PERMISOS 777, PUES* //* VAN A SER EJECUTADOS CON USER=CICS, O OTROS USER. * //* ATENCION. ADAPTE LO SIGUIENTE EN SU INSTALACION //********************************************************************* // SET DAPLIC='/Editran/mail/' // SET DDATOS='/Editran/mail/' // SET PRSEND='/usr/lpp/tcpip/sbin/sendmail' //* //************************************************************* //* -- BORRAMOS TODOS LOS FICHEROS UTILIZADOS EN USS --- * //* -- QUE CONTENGAN EL IDENMAIL --- * //************************************************************* //* //PASO010 EXEC PGM=BPXBATCH, // PARM='SH rm &DDATOS.*&IDENMAIL' //* //********************************************************************* //* COPIAMOS EL FICHERO DE ENTRADA A LA PARTICION USS * //* CREANDO UN FICHERO CON NOMBRE M + IDENMAIL * //********************************************************************* //* //PASO020 EXEC PGM=BPXCOPY, // PARM='ELEMENT(M&IDENMAIL) PATHMODE (7,7,7,7) TYPE(TEXT)' //SYSUT1 DD DSN=&FCODSMTP,DISP=SHR //SYSUT2 DD PATH='&DAPLIC' //SYSTSPRT DD SYSOUT=* //* //************************************************************* //* -- EJECUTAMOS EL SENDMAIL PARA ENVIAR EL CORREO --- * //* -- SIEMPRE Y CUANDO EL PASO ANTERIOR FUERA CORRECTO--- * //* -- UTILIZAMOS LOS PARAMETROS --- * //* -- -v (verbose) --- * //* -- t (los receptores del menssaje estan en --- * //* -- el fichero que enviamos) --- * //* -- --- * //* -- CREAMOS FICHERO O + IDENMAIL (stdout) --- * //* -- CREAMOS FICHERO E + IDENMAIL (stdout) --- * //* -- --- * //* -- INCORPORAMOS LAS SALIDAS GENERADAS DEL SENDMAIL --- * //* -- AL JOB QUE HA LLAMADO EL PROCEDIMIENTO --- * //************************************************************* //* // IF (PASO020.RC=0) THEN //PASO030 EXEC PGM=BPXBATCH, // PARM='SH &PRSEND -vt' //* //STDIN DD PATH='&DDATOS.M&IDENMAIL', // PATHOPTS=(&TMPOPTR),PATHMODE=(&TMPMODE) //STDOUT DD PATH='&DDATOS.O&IDENMAIL', // PATHOPTS=(&TMPOPTW),PATHMODE=(&TMPMODE) //STDERR DD PATH='&DDATOS.E&IDENMAIL', // PATHOPTS=(&TMPOPTW),PATHMODE=(&TMPMODE) //* //PASO031 EXEC PGM=IEBGENER //SYSPRINT DD DUMMY //SYSIN DD DUMMY //SYSUT1 DD PATH='&DDATOS.O&IDENMAIL', // PATHOPTS=(&TMPOPTR),FILEDATA=TEXT, // RECFM=VB,LRECL=132,BLKSIZE=1000 //SYSUT2 DD DSN=&&FSYSOUT,DISP=(,PASS,DELETE), // SPACE=(CYL,(1,1),RLSE), // DCB=(RECFM=V,LRECL=132) //* //PASO032 EXEC PGM=IEBGENER //SYSPRINT DD DUMMY //SYSIN DD DUMMY //SYSUT1 DD DSN=&&FSYSOUT,DISP=SHR //SYSUT2 DD SYSOUT=*,LRECL=132,RECFM=V //* //PASO033 EXEC PGM=IEBGENER //SYSPRINT DD DUMMY //SYSIN DD DUMMY //SYSUT1 DD PATH='&DDATOS.E&IDENMAIL', // PATHOPTS=(&TMPOPTR),FILEDATA=TEXT, // RECFM=VB,LRECL=132,BLKSIZE=1000 //SYSUT2 DD SYSOUT=*,LRECL=132,RECFM=V //* //************************************************************* //* -- BORRAMOS TODOS LOS FICHEROS UTILIZADOS EN USS --- * //* -- SIEMPRE Y CUANDO EL ENVIO DE EMAIL FUERA BIEN --- * //* -- DE OTRO MODO QUEDA EL FICHERO DE ERRORES --- * //************************************************************* //* // IF (PASO030.RC=0) THEN //PASO034 EXEC PGM=BPXBATCH, // PARM='SH rm &DDATOS.*&IDENMAIL' //* // ENDIF // ENDIF //* //************************************************************* //* -- BORRAMOS EL FICHERO UTILIZADO PARA MAIL --- * //* -- INDEPENDIENTEMETE DE SI FUE BIEN LO ANTERIOR --- * //************************************************************* //* //PASO040 EXEC PGM=IEFBR14 //DD1 DD DSN=&FCODSMTP,DISP=(OLD,DELETE,DELETE) //* ``` ## Administrador de Alarmas - Sesión Para especificar los parámetros que describen el perfil de una Sesión, es imprescindible haber dado de alta con anterioridad el registro de Entorno. Se accede a esta pantalla desde la opción 3 del menú de Alarmas (opción 5 del operador de Editran). ``` ------------------------------------------------------------------------------ | DD/MM/AA ADMINISTRADOR DE ALARMAS EDITRAN/EA | | HH:MM:SS SESION DE PRESENTACION 5.3 | ------------------------------------------------------------------------------ | | | A ALTA | | | | B BAJA | | | | C CONSULTA | | | | M MODIFICACION | | | | R ALTA CON COPIA | | | | OPCION : x | | CODIGO LOCAL : x nnnnnnn x | | CODIGO REMOTO : x nnnnnnn x | | APLICACION : xxxxxx | | | | | | | | | ------------------------------------------------------------------------------ ``` En el Alta es necesario teclear los Códigos Local, Remoto y Aplicación completos. Se puede dar de alta dos tipos de entidad: * Sesión: identifica una única sesión y los campos Código Local, Código Remoto y Aplicación se rigen por las reglas de cualquier sesión Editran. Será ésta la única sesión afectada por los parámetros que se indiquen * Dominio: identifica al grupo de sesiones a las que se aplicarán las condiciones de tratamiento indicadas por el conjunto de parámetros asociados al dominio. Para definirlos, uno o más de los campos Código Local, Código Remoto y Aplicación será ceros. Por ejemplo, si los campos remoto y aplicación son ceros (000000000 000000), el dominio abarcará a todas las sesiones cuyo código local coincida con el indicado. En el Alta con copia se actúa igual que en el Alta normal, pero los Códigos de la Sesión introducidos deben corresponder a la que se desea tomar como modelo. En este caso se presentan en la parte inferior de la pantalla las líneas siguientes: ``` ¦ EN CODIGO LOCAL : x nnnnnnn x ¦ ¦ EN CODIGO REMOTO : x nnnnnnn x ¦ ¦ EN APLICACION : xxxxxx ¦ ``` Se teclearán los Códigos Local, Remoto y Aplicación de la Sesión a dar de Alta. Con PF3 desaparecen estas líneas adicionales y se retorna a la situación anterior. La pantalla de detalle que se presenta más adelante, se muestra ya rellena con los datos de la Sesión modelo, que podrán ser modificados a voluntad. En el resto de opciones, Baja, Consulta y Modificación, se presentan dos modalidades diferentes de introducción de Códigos: * Específica: Se deben teclear los 3 Códigos completos, incluso el Local. Se presentan directamente las pantallas de detalle de la Sesión o Dominio correspondiente. * Genérica: Cualquiera de los tres Códigos se puede teclear (sean de Sesión o Dominio): * Completo: Se seleccionan, en principio, todas las sesiones que tengan el Código Local, Remoto o Aplicación especificado. * Parcial: Se seleccionan las sesiones cuyos correspondientes Códigos empiecen o terminen con los caracteres especificados delante o detrás de un asterisco respectivamente. * Espacios o “\*”: Se seleccionan todas las sesiones cualquiera que sea su Código correspondiente. Cuando se emplea la modalidad Genérica aparecerá la siguiente pantalla de Selección con todas las sesiones que cumplan los criterios especificados: ``` DD/MM/AA ADMINISTRADOR DE ALARMAS EDITRAN/EA HH:MM:SS MODIFICACION DE SESION DE PRESENTACION 5.3 S LOCAL REMOTO APLICA PROGRAMA NUMERO-TELEFONO MAIL PARA - --------- --------- ------ -------- --------------- ------------------------ x XNNNNNNNX XNNNNNNNX XXXXXX XXXXXXXX NNNNNNNNNNNNNNN xxxxxxxxxxxxxxxxxxxxxxxx ``` Se seleccionará la Sesión o Dominio que se desee dar de Baja, Consultar o Modificar poniendo una “S” a la izquierda de la línea correspondiente, con lo que aparecerá la pantalla de detalle asociada, en la que el código de la sesión es el único dato que está protegido. ``` ------------------------------------------------------------------------------ | 18/01/11 ADMINISTRADOR DE ALARMAS EDITRAN/EA | | 10:14:16 ALTA DE SESION DE PRESENTACION 5.3 | ------------------------------------------------------------------------------ | | | SESION DE PRESENTACION (LOCAL-REMOTO-APLICACION): XNNNNNNNX XNNNNNNNX XXXXXX | | | | TIPO ALARMA GESTOR EXTERNO (S/N): x | | NBRE. PROGRAMA LLAMADO VIA CALL : xxxxxxxx | | DATOS AVISO GESTOR EXTERNO......: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx | | | | TIPO ALARMA E-MAIL SMTP MVS(S/N): x | | TIPO ALARMA E-MAIL UNIX USS(S/N): x | | TIPO ALARMA E-MAIL EXTERNA (S/N): x | | PARA: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx | | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx | | xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx | | | | TIPO ALARMA SMS (S/N)...........: x | | DATOS AVISO SMS (NUMERO TELEF.) : nnnnnnnnnnnnnnn | | | | NIVEL DE ALARMA (0/1/2).........: n 0: ERRORES 1: FIN TRANS. 2: AMBOS | | | ------------------------------------------------------------------------------ ``` Para una Sesión o Dominio se puede activar más de un tipo de alarma (teléfono, e-mail externo, etc.), para ello se pondrá una “S” en el campo tipo de alarma que se desee. * Nombre de Programa llamado vía CALL: > Nombre del programa de usuario que es llamado desde el procedimiento de la aplicación. * Datos Aviso Gestor Externo: > Datos que se pasan al programa del usuario cuando está activa esta alarma. Desde el procedimiento Editran, se hace un CALL dicho programa con esta área de comunicación:
NombreLongitudFormatoDescripción
Función del proc2NumFunción del procedimiento
Sesión de presentación24Alfn.

Código de la sesión de presentación

Origen (9) – Destino (9) – Aplicación (9)

Fecha-hora del error14Alfn.Fecha-hora del error en formato ssaammddhhmmss
Mensaje de error68Alfn.Datos del aviso de error que genera Editran.
Jobname8Alfn.Nombre del job con el problema
Jobnumber8Alfn.Número del job con el problema
Datos del aviso al gestor externo30Alfn.Datos propios de usuario del aviso a GESTOR EXTERNO que incluyó el usuario en los perfiles de Editran.
* Para: > Direcciones de correo electrónico de los usuarios a los que se desea notificar la incidencia. * Datos Aviso SMS (Número Teléfono): > Número de teléfono al que se desea notificar la incidencia. ## Habilitación de la gestión de alarmas Con las opciones 4 y 5 del menú principal de la gestión de alarmas se habilita y deshabilita el sistema de alarmas. En el momento de dar el alta del Entorno, la gestión de alarmas está deshabilitada. Por tanto, aunque se den de alta Sesiones y Dominios con alarmas activas, el sistema no entrará en funcionamiento hasta que se habilite desde la opción 4. Cuando se quiera desactivar las alarmas de todas las Sesiones y Dominios, se puede utilizar la opción 5, que deshabilita la gestión del sistema sin necesidad de modificar cada una de las Sesiones y Dominios. --- # 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/consulta-on-line-alarmas.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.