MQSMPO - Set message property options

The MQSMPO structure allows applications to specify options that control how properties of messages are set. The structure is an input parameter on the MQSETMP call.

Availability

All IBM® MQ systems and IBM MQ clients.

Character set and encoding

Data in MQSMPO must be in the character set of the application and encoding of the application ( MQENC_NATIVE ).

Fields

Note: In the following table, the fields are grouped by usage rather than alphabetically.
Table 1. Fields in MQSMPO
Field name and description Name of constant Initial value (if any) of constant
StrucId (structure identifier) MQSMPO_STRUC_ID 'SMPO'
Version (structure version number) MQSMPO_VERSION_1 1
Options (options) MQSMPO_NONE 0
ValueEncoding (property value encoding) MQENC_NATIVE Depends on environment
ValueCCSID (property value character set) MQCCSI_APPL -3
Notes:
  1. The value Null string or blanks denotes the null string in C, and blank characters in other programming languages.
  2. In the C programming language, the macro variable MQSMPO_DEFAULT contains the values that are listed in the table. It can be used in the following way to provide initial values for the fields in the structure: 
    MQSMPO MySMPO = {MQSMPO_DEFAULT};

Language declarations

C declaration for MQSMPO

typedef struct tagMQSMPO MQSMPO;
struct tagMQSMPO {
  MQCHAR4   StrucId;         /* Structure identifier */
  MQLONG    Version;         /* Structure version number */
  MQLONG    Options;         /* Options that control the action of MQSETMP */
  MQLONG    ValueEncoding;   /* Encoding of Value */
  MQLONG    ValueCCSID;      /* Character set identifier of Value */
};

COBOL declaration for MQSMPO

**   MQSMPO structure
  10 MQSMPO.
**    Structure identifier
   15 MQSMPO-STRUCID       PIC X(4).
**    Structure version number
   15 MQSMPO-VERSION       PIC S9(9) BINARY.
**    Options that control the action of MQSETMP
   15 MQSMPO-OPTIONS       PIC S9(9) BINARY.
**    Encoding of VALUE
   15 MQSMPO-VALUEENCODING PIC S9(9) BINARY.
**    Character set identifier of VALUE
   15 MQSMPO-VALUECCSID    PIC S9(9) BINARY.

PL/I declaration for MQSMPO

dcl
 1 MQSMPO based,
  3 StrucId        char(4),       /* Structure identifier */
  3 Version        fixed bin(31), /* Structure version number */
  3 Options        fixed bin(31), /* Options that control the action of MQSETMP */
  3 ValueEncoding  fixed bin(31), /* Encoding of Value */
  3 ValueCCSID     fixed bin(31), /* Character set identifier of Value */

High Level Assembler declaration for MQSMPO

MQSMPO                DSECT
MQSMPO_STRUCID        DS   CL4   Structure identifier
MQSMPO_VERSION        DS   F     Structure version number
MQSMPO_OPTIONS        DS   F     Options that control the action of
*                                MQSETMP
MQSMPO_VALUEENCODING  DS   F     Encoding of VALUE
MQSMPO_VALUECCSID     DS   F     Character set identifier of VALUE
MQSMPO_LENGTH         EQU  *-MQSMPO
MQSMPO_AREA           DS   CL(MQSMPO_LENGTH)