Las excepciones del sistema de EGL están disponibles en todo código, pero se utilizan con más
frecuencia en un bloque onException. Para obtener una visión general, consulte la sección
Manejo de excepciones.
Cada una de las excepciones del sistema de EGL tiene como mínimo los campos siguientes:
- code
- Una serie que identifica la excepción, por ejemplo "com.ibm.egl.InvocationException" o la
constante equivalente SysLib.InvocationException
- descripción
- Una serie que indica el significado de la excepción
Las excepciones del sistema EGL son las siguientes:
- SysLib.DLIException
- Identifica un error grave de E/S provocado por el acceso a DL/I. Los campos específicos son los siguientes:
- códigoEstado
- Un código de estado DLI de 2 caracteres, por ejemplo GB o II.
- nombrePCB
- El nombre del PCB utilizado en la llamada DL/I. En el programa, en la variable de
tipo PSBRecord, se hace referencia al mismo nombre PCB en el campo nombrePCB y en la
propiedad compleja @PCB. El valor por omisión de ese campo es el nombre del
registro PCB utilizado en la llamada.
- SysLib.FileIOException
- Identifica un error que se produce durante el acceso a archivos. Los errores que se producen
durante el acceso a colas de mensajes de bases de datos relacionales no provocan esta excepción.
Los campos específicos son los siguientes:
- códigoError
- El código de estado de 8 caracteres devuelto también en SysVar.ErrorCode; para conocer los
detalles, consulte la sección SysVar.ErrorCode
- nombreArchivo
- El nombre lógico del archivo al que se accede, para conocer los detalles, consulte la sección
Asociaciones de recursos y tipos de archivo
- SysLib.InvocationException
- Identifica un error que se produce en una sentencia call.
Los campos específicos son los siguientes:
- códigoError
- El código de estado de 8 caracteres devuelto también en SysVar.ErrorCode; para conocer los
detalles, consulte la sección SysVar.ErrorCode
- nombre
- El nombre del programa que se llama.
- SysLib.JavaObjectException
- Identifica un error que se produce durante el acceso de un método
Java por
medio de una interfaz EGL.
El campo descripción contiene los mensajes de la excepción
Java. Los campos específicos son los siguientes:
- nombreExcepción
- Nombre de la excepción
Java.
- SysLib.LobProcessingException
- Identifica un error que se ha producido durante el proceso de un campo de tipo LOB o CLOB. Los campos específicos son los siguientes:
- nombreElemento
- Nombre del campo
- operación
- Nombre de la función del sistema EGL que ha fallado
- recurso
- Nombre del archivo (si lo hay) conectado al campo
- SysLib.ServiceBindingException
- Identifica un error que se produce al inicializar un enlace en una biblioteca de
enlaces de servicios o al invocar una función ServiceLib que cambia un enlace.
No hay campos específicos de la excepción disponibles.
- SysLib.ServiceInvocationException
- Identifica un error que se produce cuando se invoca un servicio. Puede producirse un
error si falta una clase EGL o JAX-RPC; si el entorno de ejecución JAX-RPC lanza una
excepción; o si el servicio EGL (o entorno de ejecución EGL) lanza una excepción.
El
valor del campo
descripción varía según el tipo de error.
- Además de las excepciones específicas de EGL, el valor del campo diagnóstico
procede del método toString de la excepción; por ejemplo, de JAX-RPC o
SOAP
- Si el error procede de EGL, el valor es el número y el texto del mensaje del entorno de
ejecución
Java EGL,
que se describen en los temas derivados de la sección Códigos de error del entorno de ejecución
Java
En el caso de los siguientes errores EGL, sólo los campos
código y
descripción de la excepción reciben valores:
- VGJ1501E: Error al cargar archivo de propiedades.
- VGJ1502E: Error al cargar propiedades de servicio.
- VGJ1503E: Error de enlace de servicio. El servicio es un servicio EGL y las
operaciones get/set en propiedades de servicio Web no son válidas.
- VGJ1504E: Error de enlace de servicio. El servicio es un servicio Web y las
operaciones get/set en propiedades de servicio EGL no son válidas.
- VGJ1505E: Error de enlace de servicio. El servicio es un servicio EGL local y las
operaciones get/set en propiedades de servicio TCPIP no son válidas.
Para otros errores, los campos específicos de la excepción son los siguientes:
- códigoError
- El valor depende del tipo de excepción:
- Para excepciones de error SOAP, el valor se devuelve desde el código de error de una
excepción SOAP
- Para excepciones JAX-RPC, el valor está en blanco
- Para excepciones relacionadas con EGL, el valor es uno de estos números de mensaje:
CSO7488E, CSO8109E, VGJ1525E, VGJ1526E, VGJ1527E, VGJ1528E, VGJ1529E, VGJ1530E,
VGJ1532E, VGJ1534E, VGJ1535E, VGJ1536E, VGJ1538E, VGJ1539E, VGJ1540E, VGJ1541E,
VGJ1542E, VGJ1543E, VGJ1544E, VGJ1545E
- origen
- El tipo de servicio que se estaba invocando cuando se produjo la excepción:
- EGL, que indica que se estaba invocando un servicio EGL
- WEB, que indica que se estaba invocando un servicio Web
- ubicación
- Ubicación del servicio en el que se ha producido la excepción:
- diagnóstico
Además de las excepciones específicas de EGL, el valor del campo
diagnóstico procede del método toString de la excepción; por ejemplo, de JAX-RPC o
SOAP. Para excepciones específicas de EGL, el valor está en blanco
- SysLib.MQIOException
- Identifica un error que se produce durante el acceso de una cola de mensajes de
MQSeries. Los campos específicos son los siguientes:
- códigoError
- El código de estado de 8 caracteres devuelto también en SysVar.ErrorCode; para conocer los
detalles, consulte la sección SysVar.ErrorCode
- mqConditionCode
- El código de finalización de una llamada API de
MQSeries, tal
como se describe en VGVar.mqConditionCode
- nombre
- El nombre lógico de la cola a la que se accede, para conocer los detalles, consulte la sección
Asociaciones de recursos y tipos de archivo
- SysLib.SQLException
- Identifica un error que se produce durante el acceso de una base de datos relacional.
Los campos específicos son los siguientes:
- sqlca
- El área de comunicaciones de SQL; para conocer los detalles, consulte la sección SysVar.sqlca
- sqlcode
- El código de retorno de SQL; para conocer los detalles, consulte la sección
SysVar.sqlcode
- sqlErrd
- Una matriz de 6 elementos, en la que cada elemento contiene el valor de área de comunicación
SQL (SQLCA) correspondiente devuelto desde la última operación de E/S SQL; para conocer los
detalles, consulte la sección VGVar.sqlErrd
- sqlErrmc
- El mensaje de error asociado a sqlcode, para un acceso a base de datos que no sea a través de
JDBC; para conocer los detalles, consulte la sección VGVar.sqlErrmc
- sqlState
- El valor de estado de SQL para la operación de E/S de SQL finalizada más recientemente; para
conocer los detalles, consulte la sección SysVar.sqlState
- sqlWarn
- Una matriz de 11 elementos, en la que cada elemento contiene un byte de aviso devuelto en el
área de comunicaciones SQL (SQLCA) para la última operación de E/S SQL y en la que el índice es
superior en uno al número de aviso de la descripción SQLCA SQL; para conocer los detalles consulte
la sección VGVar.sqlState