Overview

Purpose: The MQPMR structure is used to specify various message properties for a single destination when a message is being put to a distribution list. MQPMR is an input/output structure for the MQPUT and MQPUT1 calls.

Character set and encoding: Data in MQPMR must be in the character set and encoding of the local queue manager; these are given by the CodedCharSetId queue manager attribute and ENNAT, respectively. However, if the application is running as an MQ client, the structure must be in the character set and encoding of the client.

Usage: By providing an array of these structures on the MQPUT or MQPUT1 call, it is possible to specify different values for each destination queue in a distribution list. Some of the fields are input only, others are input/output.

Note:

This structure is unusual in that it does not have a fixed layout. The fields in this structure are optional, and the presence or absence of each field is indicated by the flags in the PMPRF field in MQPMO. Fields that are present must occur in the following order:

• PRMID

• PRCID

• PRGID

• PRFB

• PRACC

Fields that are absent occupy no space in the record.

Because MQPMR does not have a fixed layout, no definition of it is provided in the COPY file. The application programmer should create a declaration containing the fields that are required by the application, and set the flags in PMPRF to indicate the fields that are present.