WebSphere Message Broker, Versión 8.0.0.5 Sistemas operativos: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte la información sobre la última versión del producto en IBM Integration Bus, Versión 9.0

cciGetLastExceptionDataW

Obtener información de diagnóstico acerca de la última excepción generada. Se devuelve información sobre la última excepción generada en la hebra actual en una estructura de salida CCI_EXCEPTION_WIDE_ST. La extensión definida por el usuario utiliza esta función para determinar si se necesita una recuperación cuando una función de utilidad devuelve un código de error.

Puede llamar a esta función, cuando una función de utilidad o una devolución de llamada de salida de usuario indique que se ha producido una excepción, estableciendo returnCode en CCI_EXCEPTION.

A menos que se indiqueCCI_EXCEPTION, no debe invocar cciGetLastExceptionDataW(), ya que puede provocar resultados imprevisibles.

Sintaxis

void* cciGetLastExceptionDataW(
  int*                        returnCode,
  CCI_EXCEPTION_WIDE_ST*  exception_st);

Parámetros

returnCode
Recibe el código de retorno de la función (salida). Los códigos de retorno posibles son:
  • CCI_INV_DATA_POINTER
  • CCI_NO_EXCEPTION_EXISTS
  • CCI_EXCEPTION
  • CCI_EXCEPTION_UNKNOWN
  • CCI_EXCEPTION_FATAL
  • CCI_EXCEPTION_RECOVERABLE
  • CCI_EXCEPTION_CONFIGURATION
  • CCI_EXCEPTION_PARSER
  • CCI_EXCEPTION_CONVERSION
  • CCI_EXCEPTION_DATABASE
  • CCI_EXCEPTION_USER
exception_st
Especifica la dirección de una estructura CCI_EXCEPTION_WIDE_ST para recibir los datos acerca de la última excepción (salida). El valor de tipo que devuelve en los cuatro bits interiores del campo exception_st.type es uno de los siguiente valores de tipo:
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_BASE
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_TERMINATION
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_FATAL
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_RECOVERABLE
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_CONFIGURATION
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_PARSER
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_CONVERSION
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_DATABASE
  • CCI_EXCEPTION_ST_TYPE_EXCEPTION_USER

El valor devuelto en el campo exception_st.messageNumber, para excepciones que producen un mensaje de excepción catalogado BIP, contiene el nivel de mensaje en los bytes de nivel superior y el número de mensaje BIP en los cuatro bytes de nivel más bajo.

Valores de retorno

Ninguno. Si se produce un error, el parámetro returnCode indica la razón del mismo.

Ejemplo

typedef struct exception_wide_st {
  int               versionId;     /* Identificación de versión de estructura */
  int               type;          /* Tipo de excepción */
  int               messageNumber; /* Número de mensaje */
  int               insertCount;   /* Número de inserciones de mensaje */
  CCI_STRING_ST     inserts[CCI_MAX_EXCEPTION_INSERTS];
                                   /* Matriz de áreas de inserciones de mensaje */
  const char*       fileName;      /* Origen: nombre de archivo */
  int               lineNumber;    /* Origen: número de línea en archivo */
  const char*       functionName;  /* Origen: nombre de función */
  CCI_STRING_ST     traceText;	    /* Texto de rastreo asociado a la excepción */
  CCI_STRING_ST     objectName;    /* Nombre de objeto */
  CCI_STRING_ST     objectType;    /* Tipo de objeto */
} CCI_EXCEPTION_WIDE_ST;
char msgnumTypeStr[64];


CCI_EXCEPTION_WIDE_ST exception_st = malloc(sizeof(CCI_EXCEPTION_WIDE_ST));
int rc = 0;
memset(&exception_st,0,sizeof(exception_st));
cciGetLastExceptionDataW(&rc, &exception_st);
sprintf(msgnumTypeStr, "MsgNum: %d Type: %d", 
(exception_st.messageNumber & 0x0ffff),
(exception_st.type & 0x0f));
Avisos | Marcas registradas | Descargas | Biblioteca | Soporte | Comentarios

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última actualización:
        
        Última actualización: 2015-02-28 17:00:29


Tema de referenciaTema de referencia | Versión 8.0.0.5 | as24620_