Cómo se muestran las definiciones de PCF

Las definiciones de los formatos de mandato programable (PCF) incluidos sus mandatos, respuestas, parámetros, constantes y códigos de error se muestran en un formato coherente.

Para cada mandato o respuesta PCF, hay una descripción de lo que hace el mandato o respuesta, especificando el identificador de mandato entre paréntesis. Consulte Constantes para ver todos los valores del identificador de mandato. Cada descripción de mandato empieza por una tabla que identifica las plataformas en las que el mandato es válido. Para obtener notas de uso adicionales, más detalladas, para cada mandato, consulte la descripción del mandato correspondiente en las Definiciones de los formatos de mandato programable.

Los productos de IBM® MQ , distintos de IBM MQ for z/OS®, pueden utilizar la interfaz de administración de IBM MQ (MQAI), que proporciona una forma simplificada para que las aplicaciones escritas en el lenguaje de programación C y Visual Basic puedan crear y enviar mandatos PCF. Para obtener información sobre la MQAI, consulte la segunda sección de este tema.

Mandatos

Se listan los parámetros necesarios y los parámetros opcionales .

En Multiplatforms, los parámetros deben aparecer en este orden:

Todos los parámetros necesarios, en el orden indicado, seguidos de
Parámetros opcionales según sea necesario, en cualquier orden, a menos que se indique en la definición de PCF.

[z/OS] En z/OS, los parámetros pueden estar en cualquier orden.

Respuestas

El atributo de datos de respuesta siempre se devuelve tanto si se solicita como si no. Este parámetro es necesario para identificar, de forma exclusiva, el objeto cuando existe la posibilidad de que se devuelvan varios mensajes de respuesta.

Los otros atributos que se muestran se devuelven si se solicita como parámetros opcionales en el mandato. Los atributos de datos de respuesta no se devuelven en un orden definido.

Parámetros y datos de respuesta

Cada nombre de parámetro va seguido de su nombre de estructura entre paréntesis (los detalles se proporcionan en Estructuras para mandatos y respuestas PCF ). El identificador de parámetro se proporciona al principio de la descripción.

Constantes

Para ver los valores de las constantes utilizadas por los mandatos PCF y las respuestas, consulte Constantes.

Mensajes informativos

En z/OS, un número de respuestas de mandato devuelven una estructura, MQIACF_COMMAND_INFO, con valores que proporcionan información sobre el mandato.

Tabla 1. Valores de MQIACF_COMMAND_INFO
Valor MQIACF_COMMAND_INFO	Significado
MQCMDI_CMDSCOPE_ACEPTADO	Se ha especificado un mandato que especifica `CommandScope` . Se ha pasado a uno o más gestores de colas solicitados para su proceso
MQCMDI_CMDSCOPE_GENERADO	Se ha generado un mandato que especificaba `CommandScope` como respuesta al mandato especificado originalmente
MQCMDI_CMDSCOPE_COMPLETADO	El proceso del mandato que ha especificado `CommandScope` , ya sea entrado o generado por otro mandato, se ha completado correctamente en todos los gestores de colas solicitados
MQCMDI_QSG_DISP_COMPLETADO	El proceso del mandato que hace referencia a un objeto con la disposición indicada se ha completado satisfactoriamente
MQCMDI_COMMAND_ACEPTADO	El proceso inicial del mandato se ha completado correctamente. El comando requiere otra acción del iniciador de canal para el que se ha puesto en cola una solicitud. Los mensajes que informan del éxito o no de la acción se envían al emisor del mandato más adelante
MQCMDI_SOLICITUD_DE_CLÚSTER_EN_COLA	El proceso inicial del mandato se ha completado correctamente. El mandato requiere una acción adicional por parte del gestor de repositorios de clúster, para el que se ha puesto en cola una solicitud
MQCMDI_CANAL_INICIALIZACIÓN_INICIADA	Se ha emitido un mandato Iniciar iniciador de canal y el espacio de direcciones del iniciador de canal se ha iniciado satisfactoriamente
MQCMDI_RECUPERACIÓN_INICIADA	El gestor de colas ha iniciado correctamente una tarea para procesar el mandato Recuperar estructura CF para la estructura con nombre
MQCMDI_BACKUP_INICIADO	El gestor de colas ha iniciado correctamente una tarea para procesar el mandato Copia de seguridad de estructura CF para la estructura con nombre
MQCMDI_RECUPERACIÓN_COMPLETADA	La estructura CF especificada se ha recuperado correctamente. La estructura está disponible para su uso de nuevo
MQCMDI_SEC_TIMER_CERO	El mandato Cambiar seguridad se ha especificado con el atributo `SecurityInterval` establecido en 0. Esto significa que no se producen tiempos de espera excedidos de usuario
MQCMDI_ACTUALIZAR_CONFIGURACIÓN	Se ha emitido un mandato Cambiar gestor de colas que habilita los sucesos de configuración. Es necesario generar mensajes de suceso para asegurarse de que la información de configuración está completa y actualizada
MQCMDI_IMS_BRIDGE_SUSPENDIDO	El recurso de puente MQ-IMS está suspendido.
MQCMDI_DB2_SUSPENDED	La conexión con Db2® está suspendida
MQCMDI_DB2_OBSOLETE_MSGS	Existen mensajes Db2 obsoletos en el grupo de compartición de colas

Códigos de error

[z/OS] En z/OS, los mandatos PCF pueden devolver códigos de razón MQRC en lugar de códigos MQRCCF

Los códigos MQRCCF se utilizan en AIX®, Linux®, and Windows. Al final de la mayoría de las definiciones de formato de mandato, hay una lista de códigos de error que puede devolver dicho mandato.

Códigos de error aplicables a todos los mandatos

Además de los códigos de error listados bajo cada formato de mandato, cualquier mandato puede devolver los siguientes códigos de error en la cabecera de formato de respuesta (las descripciones de los códigos de error MQRC_ * se proporcionan en la documentación de Mensajes y códigos de razón [z/OS] y IBM MQ for z/OS mensajes, códigos de terminación y razón ):

Razón (MQLONG)

El valor puede ser cualquiera de los valores siguientes:

MQRC_NONE: (0, X'000') No hay ninguna razón sobre la que informar.
MQRC_MSG_DEMASIADO_GRANDE_PARA_Q: (2030, X'7EE' ) Longitud de mensaje superior a la máxima para la cola.
MQRC_CONNECTION_BROKEN: (2009, X'7D9') Se ha perdido la conexión con el gestor de colas.
MQRC_NOT_AUTHORIZED: (2035, X'7F3' ) Acceso no autorizado.
MQRC_SELECTOR_ERROR: (2067, X'813 ') El selector de atributos no es válido.
MQRC_STORAGE_NOT_AVAILABLE: (2071, X'817') No hay suficiente almacenamiento disponible.
MQRC_UNKNOWN_OBJECT_NAME: (2085, X'825 ') Nombre de objeto desconocido.
MQRCCF_ATTR_VALUE_ERROR: Valor de atributo no válido.
MQRCCF_CFBF_FILTRO_VALOR_LONGITUD_ERROR: La longitud de valor de filtro no es válida.
MQRCCF_CFBF_LONGITUD_ERROR: La longitud de estructura no es válida.
MQRCCF_CFBF_ERROR_DEL_OPERADOR: Error de operador.
MQRCCF_CFBF_PARM_ID_ERROR: Identificador de parámetro no válido.
MQRCCF_CFBS_PARÁMETRO_DUPLICADO: Parámetro duplicado.
MQRCCF_CFBS_ERROR_DE_LONGITUD: La longitud de estructura no es válida.
MQRCCF_CFBS_PARM_ID_ERROR: Identificador de parámetro no válido.
MQRCCF_CFBS_ERROR_LONGITUD_CADENA: La longitud de serie no es válida.
MQRCCF_CFGR_LONGITUD_ERROR: La longitud de estructura no es válida.
MQRCCF_CFGR_PARM_ERROR_DE_CONTADO: El recuento de parámetros no es válido.
MQRCCF_CFGR_PARM_ID_ERROR: Identificador de parámetro no válido.
MQRCCF_CFH_ERROR_DE_COMANDO: El identificador de mandato no es válido.
MQRCCF_CFH_ERROR_DE_CONTROL: La opción de control no es válida.
MQRCCF_CFH_LONGITUD_ERROR: La longitud de estructura no es válida.
MQRCCF_CFH_MSG_NÚMERO_DE_SECUENCIA_ERROR: El número de secuencia de mensaje no es válido.
MQRCCF_CFH_PARM_CONTRADO_ERROR: El recuento de parámetros no es válido.
MQRCCF_CFH_TIPO_ERROR: El tipo no es válido.
MQRCCF_CFH_VERSIÓN_ERROR: El número de versión de estructura no es válido.
MQRCCF_CFIF_LONGITUD_ERROR: La longitud de estructura no es válida.
MQRCCF_CFIF_ERROR_OPERADOR: Error de operador.
MQRCCF_CFIF_PARM_ID_ERROR: Identificador de parámetro no válido.
MQRCCF_CFIL_CONTROL_ERROR: El recuento de valores de parámetro no es válido.
MQRCCF_CFIL_VALOR_DUPLICADO: Parámetro duplicado.
MQRCCF_CFIL_LONGITUD_ERROR: La longitud de estructura no es válida.
MQRCCF_CFIL_PARM_ID_ERROR: Identificador de parámetro no válido.
MQRCCF_CFIN_PARÁMETRO_DUPLICADO: Parámetro duplicado.
MQRCCF_CFIN_LONGITUD_ERROR: La longitud de estructura no es válida.
MQRCCF_CFIN_PARM_ID_ERROR: Identificador de parámetro no válido.
MQRCCF_CFSF_FILTRO_VALOR_LONGITUD_ERROR: La longitud de valor de filtro no es válida.
MQRCCF_CFSF_ERROR_DE_LONGITUD: La longitud de estructura no es válida.
MQRCCF_CFSF_ERROR_DEL_OPERADOR: Error de operador.
MQRCCF_CFSF_PARM_ID_ERROR: Identificador de parámetro no válido.
MQRCCF_CFSL_CONTROL_DE_ERRORES: El recuento de valores de parámetro no es válido.
MQRCCF_CFSL_PARÁMETRO_DUPLICADO: Parámetro duplicado.
MQRCCF_CFSL_ERROR_DE_LONGITUD: La longitud de estructura no es válida.
MQRCCF_CFSL_PARM_ID_ERROR: Identificador de parámetro no válido.
MQRCCF_CFSL_LONGITUD_CADENA_ERROR: Valor de longitud de serie no válido.
MQRCCF_CFSL_ERROR_LONGITUD_TOTAL: Error de longitud de serie total.
MQRCCF_CFST_PARÁMETRO_CONFLICTIVO: Parámetros en conflicto.
MQRCCF_CFST_PARÁMETRO_DUPLICADO: Parámetro duplicado.
MQRCCF_CFST_ERROR_DE_LONGITUD: La longitud de estructura no es válida.
MQRCCF_CFST_PARM_ID_ERROR: Identificador de parámetro no válido.
MQRCCF_CFST_LONGITUD_DE_CADENA_ERROR: Valor de longitud de serie no válido.
MQRCCF_COMANDO_FALLIDO: El mandato ha fallado.
MQRCCF_ERROR_DE_CODIFICACIÓN: Error de codificación.
MQRCCF_MD_FORMATO_ERROR: Formato no válido.
MQRCCF_MSG_NÚMERO_DE_SEQUENCIA_ERROR: El número de secuencia de mensaje no es válido.
MQRCCF_MSG_TRUNCADO: Mensaje truncado.
MQRCCF_MSG_LONGITUD_ERROR: Longitud del mensaje no válida.
MQRCCF_NOMBRE_OBJETO_ERROR: Nombre de objeto no válido.
MQRCCF_OBJETO_ABIERTO: El objeto está abierto.
MQRCCF_PARM_CONTE_DEMASIADO_GRANDE: Recuento de parámetros demasiado grande.
MQRCCF_PARM_CONTE_DEMASIADO_PEQUEÑO: El recuento de parámetros es demasiado pequeño.
MQRCCF_PARM_ERROR_SECUENCIA: La secuencia de parámetros no es válida.
MQRCCF_PARM_ERROR_SINTAXIS: Se ha detectado un error de sintaxis en el parámetro.
MQRCCF_TIPO_DE_ERROR_DE_ESTRUCTURA: El tipo de estructura no es válido.
MQRCCF_NOMBRE_OBJETO_DESCONOCIDO: Nombre de objeto desconocido.