MQOR (Object record) on IBM i

The MQOR structure is used to specify the queue name and queue manager name of a single destination queue.


Overview

Purpose: MQOR is an input structure for the MQOPEN and MQPUT1 calls.

Character set and encoding: Data in MQOR must be in the character set given by the CodedCharSetId queue manager attribute and encoding of the local queue manager given by ENNAT. However, if the application is running as an IBM 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 MQOPEN call, it is possible to open a list of queues; this list is called a distribution list. Each message put using the queue handle returned by that MQOPEN call is placed on each of the queues in the list, if the queue was opened successfully.


Fields

The MQOR structure contains the following fields; the fields are described in alphabetical order:

    ORMN (48-byte character string)

    Object queue manager name.

    This is the same as the ODMN field in the MQOD structure (see MQOD for details).

    This is always an input field. The initial value of this field is 48 blank characters.

    ORON (48-byte character string)

    Object name.

    This is the same as the ODON field in the MQOD structure (see MQOD for details), except that:

    • It must be the name of a queue.
    • It must not be the name of a model queue.

    This is always an input field. The initial value of this field is 48 blank characters.


Initial values

Field name Name of constant Value of constant
ORON None Blanks
ORMN None Blanks


RPG declaration

     D*..1....:....2....:....3....:....4....:....5....:....6....:....7..
     D*
     D* MQOR Structure
     D*
     D* Object name
     D  ORON                   1     48    INZ
     D* Object queue manager name
     D  ORMN                  49     96    INZ
Parent topic: Data type descriptions on IBM i