MQOR - Object record

Use the MQOR structure to specify the queue name and queue manager name of a single destination queue. MQOR is an input structure for the MQOPEN and MQPUT1 calls.

Availability

The MQOR structure is available on the following platforms:

AIX®
IBM® i
Linux®
Windows

and for IBM MQ MQI clients connected to these systems.

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 MQENC_NATIVE. However, if the application is running as an MQ MQI 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, you can 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, provided that the queue was opened successfully.

Fields

Note: In the following table, the fields are grouped by usage rather than alphabetically.

Table 1. Fields in MQOR for MQOR
Field name and description	Name of constant	Initial value (if any) of constant
ObjectName (object name)	None	Null string or blanks
ObjectQMgrName (object queue manager name)	None	Null string or blanks
Notes: The value Null string or blanks denotes the null string in C, and blank characters in other programming languages. In the C programming language, the macro variable MQOR_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: `MQOR MyOR = {MQOR_DEFAULT};`

Language declarations

C declaration for MQOR

typedef struct tagMQOR MQOR;
struct tagMQOR {
  MQCHAR48  ObjectName;      /* Object name */
  MQCHAR48  ObjectQMgrName;  /* Object queue manager name */
};

COBOL declaration for MQOR

**   MQOR structure
  10 MQOR.
**    Object name
   15 MQOR-OBJECTNAME     PIC X(48).
**    Object queue manager name
   15 MQOR-OBJECTQMGRNAME PIC X(48).

PL/I declaration for MQOR

dcl
 1 MQOR based,
  3 ObjectName     char(48), /* Object name */
  3 ObjectQMgrName char(48); /* Object queue manager name */

Visual Basic declaration for MQOR

Type MQOR
  ObjectName     As String*48 'Object name'
  ObjectQMgrName As String*48 'Object queue manager name'
End Type