MQBO (Begin options) on IBM i

The MQBO structure allows the application to specify options relating to the creation of a unit of work.

Overview

Purpose: The structure is an input/output parameter on the MQBEGIN call.

Character set and encoding: Data in MQBO must be in the character set given by the CodedCharSetId queue manager attribute and encoding of the local queue manager given by ENNAT.

• Fields
• Initial values
• RPG declaration

Fields

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

BOOPT (10-digit signed integer)

Options that control the action of MQBEGIN.

The value must be:

BONONE

No options specified.

This is always an input field. The initial value of this field is BONONE.

BOSID (4-byte character string)

Structure identifier.

The value must be:

BOSIDV

Identifier for begin-options structure.

This is always an input field. The initial value of this field is BOSIDV.

BOVER (10-digit signed integer)

Structure version number.

The value must be:

BOVER1

Version number for begin-options structure.

The following constant specifies the version number of the current version:

BOVERC

Current version of begin-options structure.

This is always an input field. The initial value of this field is BOVER1.

Initial values

1. The symbol ¬ represents a single blank character.

RPG declaration

     D*..1....:....2....:....3....:....4....:....5....:....6....:....7..
     D* MQBO Structure
     D*
     D* Structure identifier
     D  BOSID                  1      4    INZ('BO  ')
     D* Structure version number
     D  BOVER                  5      8I 0 INZ(1)
     D* Options that control the action of MQBEGIN
     D  BOOPT                  9     12I 0 INZ(0)