Excepciones del sistema de EGL

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:
  • Para servicios EGL a los que se accede directamente, el valor está en blanco
  • Para servicios EGL a los que se accede mediante TCP/IP, el valor (si está disponible) tiene el siguiente formato:
      sistemaprincipal:númeroPuerto
    sistemaprincipal
    Nombre del sistema principal TCP/IP que hace referencia a la máquina en la que se ejecuta el servicio.
    númeroPuerto
    Número del puerto TCP/IP que suministra acceso al servicio.
  • Para servicios Web, el valor es el URL; concretamente, el valor SOAPActor del error SOAP
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

Conceptos relacionados
Soporte de bases de datos DL/IServicios EGL y servicios Web
Asociaciones de recursos y tipos de archivo

Consulta relacionada
@DLI
Código de error de ejecución de Java EGL
Manejo de excepciones
errorCode
mqConditionCode
sqlca
sqlcode
sqlState
sqlerrd
sqlerrmc
sqlWarn

Comentarios
(C) Copyright IBM Corporation 2000, 2005. Reservados todos los derechos.