Creating a message from variables

You can also use BMC AMI Ops Automation for MQ to create new IBM MQ messages.

The IBM MQ product offers a programming interface for many languages such as assembler, COBOL and C. BMC has created the IMFEXEC MQI interface for BMC AMI OpsA EXECs to provide access to these facilities using the REXX and CLIST programming languages. The structures associated with the IBM MQ API (application programming interface) are available to you through BMC AMI Ops Automation for MQ variables in the format:

IMFMQI_structure_fieldname

where structure is the structure identifier and fieldname is the name of the field in the structure. See IMFEXEC-MQI-variables for more information about the format and content of these variables.

BMC AMI OpsA can update messages retrieved from a queue, based upon values of variables that you set in your EXEC and then place the updated message on the same or a different queue when the IMFEXEC MQI PUT or PUT1 statement is executed. Some variables correspond to each field of each structure in IBM MQ (CIH, DLH, IIH, MD, MDE, RFH, RFH2, RMH, TM, TMC2, WIH, XQH, CFH, OD).

Additionally, other variables correspond to each data item name for an instrumentation event. Details about the most commonly used variables for the IMFEXEC MQI statements are covered in this section; all other variables are listed in EXECs-variables in this section.

When creating new messages, BMC AMI OpsA builds the Message Descriptor, the Object Descriptor, and the message buffer from variables that you create, or from default values where possible (there are no default values for the message buffer). Note that when creating new messages, the author of the EXEC is responsible for entering all necessary variables for structures except for the Message Descriptor and Object Descriptor (MD and OD).

This section contains the following topics: