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

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

Table 1. Initial values of fields in MQBO
Field name Name of constant Value of constant
BOSID BOSIDV 'BO¬¬'
BOVER BOVER1 1
BOOPT BONONE 0
Notes:
  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)