MQDMHO (Delete message handle options) on IBM i

The MQDMHO structure allows applications to specify options that control how message handles are deleted.


Overview

Purpose: The structure is an input parameter on the MQDLTMH call.

Character set and encoding: Data in MQDMHO must be in the character set of the application and encoding of the application (ENNAT).


Fields

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

    DMOPT (10-digit signed integer)
    The value must be:

      DMNONE

      No options specified.

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

    DMSID (10-digit signed integer)

    This is the structure identifier; the value must be:

      DMSIDV

      Identifier for delete message handle options structure.

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

    DMVER (10-digit signed integer)

    This is the structure version number; the value must be:

      DMVER1
      Version-1 delete message handle options structure.

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

      DMVERC
      Current version of delete message handle options structure.

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


Initial values

Table 1. Initial values of fields in MQDMHO
Field name Name of constant Value of constant
DMSID DMSIDV 'DMHO'
DMVER DMVER1 1
DMOPT DMNONE 0


RPG declaration

     D* MQDMHO Structure
     D*
     D*
     D* Structure identifier
     D  DMSID                  1      4    INZ('DMHO')
     D*
     D* Structure version number
     D  DMVER                  5      8I 0 INZ(1)
     D*
     D* Options that control the action of MQDLTMH
     D  DMOPT                  9     12I 0 INZ(0)