High Level Assembler programming

Information to help to you use the MQI from the System/390 Assembler programming language.

Macros

There are two macros for named constants, and one macro for each of the structures. These files are summarized in the following table.

Table 1. Assembler macros
File Contents
CMQA Named constants (equates) for main MQI
CMQCIHA CICS® information header structure
CMQCNOA Connect options structure
CMQDLHA Dead letter header structure
CMQDXPA Data conversion exit parameter structure
CMQGMOA Get message options structure
CMQIIHA IMS information header structure
CMQMDA Message descriptor structure
CMQMDEA Message descriptor extension structure
CMQODA Object descriptor structure
CMQPMOA Put message options structure
CMQRFHA Rules and formatting header structure
CMQRFH2A Rules and formatting header structure version 2
CMQRMHA Reference message header structure
CMQTMA Trigger message structure
CMQTMC2A Trigger message structure (character format) version 2
CMQVERA Structure version control
CMQWIHA Work information header structure
CMQXA Named constants for data conversion exit
CMQXPA API crossing exit parameter structure
CMQXQHA Transmission queue header structure

Structures

The structures are generated by macros that have various parameters to control the action of the macro. See Structures

CMQVERA macro

This macro allows you to set the default value to be used for the DCLVER parameter on the structure macros.

The value specified by CMQVERA is used by the structure macro only if you omit the DCLVER parameter from the invocation of the structure macro. The default value is set by coding the CMQVERA macro with the DCLVER parameter:
DCLVER=CURRENT
The default version is set to the current (most recent) version.
DCLVER=SPECIFIED
The default version is set to the version specified by the VERSION parameter.
You must specify the DCLVER parameter, and the value must be uppercase. The value set by CMQVERA remains the default value until the next invocation of CMQVERA, or the end of the assembly. If you omit CMQVERA, the default is DCLVER=CURRENT.

Notation conventions

Other topics show how to invoke the calls and declare parameters. In some cases, the parameters are arrays or character strings with a size that is not fixed for which, a lowercase n is used to represent a numeric constant. When you code the declaration for that parameter, replace the n with the numeric value required.