MQEPH - Cabecera PCF incrustada

La estructura MQEPH describe los datos adicionales que están presentes en un mensaje cuando ese mensaje es un mensaje de formato de mandato programable (PCF). El campo PCFHeader define los parámetros PCF que siguen esta estructura y esto le permite seguir los datos del mensaje PCF con otras cabeceras.

Nombre de formato

MQFMT_EMBEDDED_PCF

Juego de caracteres y codificación

Los datos de MQEPH deben estar en el juego de caracteres proporcionado por el atributo de gestor de colas CodedCharSetId y la codificación del gestor de colas local proporcionado por MQENC_NATIVE.

Establezca el juego de caracteres y la codificación de MQEPH en los campos CodedCharSetId y Encoding en MQMD (si la estructura MQEPH está al principio de los datos del mensaje), o la estructura de cabecera que precede a la estructura MQEPH (todos los demás casos).

Utilización

No puede utilizar estructuras MQEPH para enviar mandatos al servidor de mandatos o a cualquier otro servidor que acepte PCF del gestor de colas.

De forma similar, el servidor de mandatos o cualquier otro servidor de aceptación de PCF de gestor de colas no generan respuestas o sucesos que contengan estructuras MQEPH.

Campos

Nota: En la tabla siguiente, los campos se agrupan por uso en lugar de por orden alfabético. Los temas hijo siguen la misma secuencia.

Tabla 1. Campos en MQEPH para MQEPH
Nombre de campo y descripción	Nombre de constante	Valor inicial (si existe) de constante
StrucId (identificador de estructura)	MQEPH_STRUC_ID	`'EPH¬'`
Versión (número de versión de estructura)	MQEPH_VERSION_1	`1`
StrucLength (longitud de la estructura MQEPH más MQCFH y estructuras de parámetros que le siguen)	MQEPH_ESTRUCTURA_LONGITUD_FIJA	`68`
Codificación (codificación numérica de datos que sigue a la última estructura de parámetros PCF)	Ninguna	`0`
CodedCharSetId (identificador del juego de caracteres de los datos que siguen a la última estructura de parámetros PCF)	MQCCSI_INDETERMINADO	`0`
Formato (nombre de formato de los datos que siguen a la estructura del último parámetro PCF)	MQFMT_NONE	Espacios en blanco
Distintivos (distintivos)	MQEPH_NONE	`0`
PCFHeader (cabecera PCF (formato de mandato programable))	Nombres y valores tal y como se definen en la Tabla 1.	`0`
Notas: El símbolo `¬` representa un único carácter en blanco. En el lenguaje de programación C, la variable de macro MQEPH_DEFAULT contiene los valores que se listan en la tabla. Utilícelo de la forma siguiente para proporcionar valores iniciales para los campos de la estructura: `MQEPH MyEPH = {MQEPH_DEFAULT};`

Declaraciones lingüísticas

Declaración C para MQEPH

typedef struct tagMQEPH MQEPH;
struct tagMQDH {
  MQCHAR4  StrucId;          /* Structure identifier */
  MQLONG   Version;          /* Structure version number */
  MQLONG   StrucLength;      /* Total length of MQEPH including the MQCFH
                                and parameter structures that follow it */
  MQLONG   Encoding;         /* Numeric encoding of data that follows last
                                PCF parameter structure */
  MQLONG   CodedCharSetId;   /* Character set identifier of data that
                                follows last PCF parameter structure */
  MQCHAR8  Format;           /* Format name of data that follows last PCF
                                parameter structure */
  MQLONG   Flags;            /* Flags */
  MQCFH    PCFHeader;        /* Programmable command format header */
 };

COBOL declaración para MQEPH

**   MQEPH structure
  10 MQEPH.
**    Structure identifier
   15 MQEPH-STRUCID         PIC X(4).
**    Structure version number
   15 MQEPH-VERSION         PIC S9(9) BINARY.
**    Total length of MQEPH structure including the MQCFH
**    and parameter structures that follow it
   15 MQEPH-STRUCLENGTH     PIC S9(9) BINARY.
**    Numeric encoding of data that follows last
**    PCF structure
   15 MQEPH-ENCODING        PIC S9(9) BINARY.
**    Character set identifier of data that
**    follows last PCF parameter structure
   15 MQEPH-CODEDCHARSETID  PIC S9(9) BINARY.
**    Format name of data that follows last PCF
**    parameter structure
   15 MQEPH-FORMAT          PIC X(8).
**    Flags
   15 MQEPH-FLAGS           PIC S9(9) BINARY.
**    Programmable command format header
   15 MQEPH-PCFHEADER.
**      Structure type
     20 MQEPH-PCFHEADER-TYPE           PIC S9(9) BINARY.
**      Structure length
     20 MQEPH-PCFHEADER-STRUCLENGTH    PIC S9(9) BINARY.
**      Structure version number
     20 MQEPH-PCFHEADER-VERSION        PIC S9(9) BINARY.
**      Command identifier
     20 MQEPH-PCFHEADER-COMMAND        PIC S9(9) BINARY.
**      Message sequence number
     20 MQEPH-PCFHEADER-MSGSEQNUMBER   PIC S9(9) BINARY.
**      Control options
     20 MQEPH-PCFHEADER-CONTROL        PIC S9(9) BINARY.
**      Completion code
     20 MQEPH-PCFHEADER-COMPCODE       PIC S9(9) BINARY.
**      Reason code qualifying completion code
     20 MQEPH-PCFHEADER-REASON         PIC S9(9) BINARY.
**      Count of parameter structures
     20 MQEPH-PCFHEADER-PARAMETERCOUNT PIC S9(9) BINARY.

PL/I declaración para MQEPH

dcl
 1 MQEPH based,
  3 StrucId         char(4),       /* Structure identifier */
  3 Version         fixed bin(31), /* Structure version number */
  3 StrucLength     fixed bin(31), /* Total Length of MQEPH including the
                                      MQCFH and parameter structures that
                                      follow it
  3 Encoding        fixed bin(31), /* Numeric encoding of data that follows
                                      last PCF parameter structure
  3 CodedCharSetId  fixed bin(31), /* Character set identifier of data that
                                      follows last PCF parameter structure
  3 Format          char(8),       /* Format name of data that follows last
                                      PCF parameter structure */
  3 Flags           fixed bin(31), /* Flags */
  3 PCFHeader,                     /* Programmable command format header
   5 Type           fixed bin(31), /* Structure type */
   5 StrucLength    fixed bin(31), /* Structure length */
   5 Version        fixed bin(31), /* Structure version number */
   5 Command        fixed bin(31), /* Command identifier */
   5 MsgseqNumber   fixed bin(31), /* Message sequence number */
   5 Control        fixed bin(31), /* Control options */
   5 CompCode       fixed bin(31), /* Completion code */
   5 Reason         fixed bin(31), /* Reason code qualifying completion code */
   5 ParameterCount fixed bin(31); /* Count of parameter structures */

Declaración de High Level Assembler para MQEPH

MQEPH                            DSECT
MQEPH_STRUCID                    DS   CL4   Structure identifier
MQEPH_VERSION                    DS   F     Structure version number
MQEPH_STRUCLENGTH                DS   F     Total length of MQEPH including the
*                                           MQCFH and parameter structures that
                                            follow it
MQEPH_ENCODING                   DS   F     Numeric encoding of data that follows
*                                           last PCF parameter structure 
MQEPH_CODEDCHARSETID             DS   F     Character set identifier of data that
*                                           follows last PCF parameter structure
MQEPH_FORMAT                     DS   CL8   Format name of data that follows last
*                                           PCF parameter structure
MQEPH_FLAGS                      DS   F     Flags
MQEPH_PCFHEADER                  DS   0F    Force fullword alignment
MQEPH_PCFHEADER_TYPE             DS   F     Structure type
MQEPH_PCFHEADER_STRUCLENGTH      DS   F     Structure length
MQEPH_PCFHEADER_VERSION          DS   F     Structure version number
MQEPH_PCFHEADER_COMMAND          DS   F     Command identifier
MQEPH_PCFHEADER_MSGSEQNUMBER     DS   F     Structure length
MQEPH_PCFHEADER_CONTROL          DS   F     Control options
MQEPH_PCFHEADER_COMPCODE         DS   F     Completion code
MQEPH_PCFHEADER_REASON           DS   F     Reason code qualifying completion code
MQEPH_PCFHEADER_PARAMETER COUNT  DS   F     Count of parameter structures
MQEPH_PCFHEADER_LENGTH           EQU  *-MQEPH_PCFHEADER
                                 ORG  MQEPH_PCFHEADER
MQEPH_PCFHEADER_AREA             DS   CL(MQEPH_PCFHEADER_LENGTH)
*
MQEPH_LENGTH                     EQU  *-MQEPH
                                 ORG  MQEPH
MQEPH_AREA                       DS   CL(MQEPH_LENGTH)

Declaración de Visual Basic para MQEPH

Type MQEPH
  StrucId         As String*4 'Structure identifier'
  Version         As Long     'Structure version number'
  StrucLength     As Long     'Total length of MQEPH structure including the MQCFH'
                              'and parameter structures that follow it'
  Encoding        As Long     'Numeric encoding of data that follows last'
                              'PCF parameter structure'
  CodedCharSetId  As Long     'Character set identifier of data that'
                              'follows last PCF parameter structure'
  Format          As String*8 'Format name of data that follows last PCF'
                              'parameter structure'
  Flags           As Long     'Flags'
  PCFHeader       As MQCFH    'Programmable command format header'
 End Type

Global MQEPH_DEFAULT As MQEPH