Códigos de terminación y razón

Por cada llamada, el gestor de colas o una rutina de salida devuelven un código de terminación y un código de razón para indicar que la llamada se ha realizado de forma satisfactoria o bien con errores.

Para obtener más información sobre la API de IBM® MQ , consulte Desarrollo de aplicacionesy la información de referencia en Desarrollo de aplicaciones de referencia.

Para obtener una lista completa y una explicación de los códigos de motivo de la API, consulte Finalización de la API y códigos de motivo.

Códigos de terminación del API

A continuación se muestra una lista de los códigos de terminación (MQCC) devueltos por IBM MQ
0: Terminación satisfactoria (MQCC_OK)

La llamada se ha completado del todo; se han establecido todos los parámetros de salida.

En este caso, el parámetro Reason tiene siempre el valor MQRC_NONE.

1: Aviso (terminación parcial) (MQCC_WARNING)

La llamada se ha completado parcialmente. Es posible que algunos parámetros de salida se hayan establecido además de los parámetros de salida CompCode y Reason .

El parámetro Reason proporciona información adicional.

2: La llamada ha fallado (MQCC_FAILED)

El procesamiento de la llamada no se ha completado y el estado del gestor de colas no suele variar; se indican excepciones concretas. Sólo se han establecido los parámetros de salida CompCode y Reason ; todos los demás parámetros no se modifican.

La razón puede ser un error en la aplicación, o puede ser el resultado de una situación externa al programa, por ejemplo, la autorización de la aplicación podría haberse revocado. El parámetro Reason proporciona información adicional.

Códigos de razón de API

El parámetro del código de razón (Reason) es una calificación del parámetro del código de terminación (CompCode).

Si no hay que notificar ninguna razón especial, se devuelve MQRC_NONE. Una llamada que ha finalizado correctamente devuelve MQCC_OK y MQRC_NONE.

Si el código de terminación es MQCC_WARNING o MQCC_FAILED, el gestor de colas siempre informa de una razón calificadora; se proporcionan detalles en la descripción de cada llamada.

Allá donde las salidas de usuario establezcan códigos de terminación y de razón, habrán de atenerse a estas reglas. Además, los valores de razón especiales definidos por salidas de usuario han de ser menors que cero para garantizar que no entran en conflicto con los valores definidos por el gestor de colas. Las salidas pueden establecer razones ya definidas por el gestor de colas cuando procedan.

También aparecen códigos de razón en:
  • El campo Reason de la estructura MQDLH.
  • El campo Feedback de la estructura MQMD.
Cada código de razón en su totalidad está soportado en todas las plataformas a las que IBM MQ da soporte, a menos que:
  • Haya uno o varios iconos de plataforma en la parte superior de un código de razón, en cuyo caso dicho código de razón solo se aplica a aquellas plataformas que se muestran.
  • Se visualice un icono de plataforma en una sentencia específica, en cuyo caso dicha sentencia solo se aplica a dicha plataforma.
Consulte iconos de plataforma para obtener una descripción de los iconos.
Los temas hijo son un conjunto de códigos de razón, en orden numérico, que proporcionan información detallada para ayudarle a entenderlos, incluyendo:
  • Una explicación de las circunstancias que han provocado la aparición del código.
  • El código de terminación asociado.
  • Acciones sugeridas por el programador en respuesta al código.