Steps for Assure MIMIX IBM MQ - assure_mimix - 10.0

Assure MIMIX Administrator Reference

Product type
Software
Portfolio
Integrate
Product family
Assure
Product
Assure MIMIX™ Software
Version
10.0
Language
English
Product name
Assure MIMIX
Title
Assure MIMIX Administrator Reference
Copyright
2023
First publish date
1999
ft:lastEdition
2024-05-07
ft:lastPublication
2024-05-07T13:36:02.962500

This section includes programs that are shipped with MIMIX for use with MQ-specific application groups. Assure MIMIX IBM MQ requires a separate license key. Configuration for the initial synchronization and the initial start of data groups must be completed prior to using these step programs. For more information, see the Assure MIMIX for IBM MQ book. Once your Assure MIMIX IBM MQ is operational, the step programs can be used.

The MQ step programs need to be modified prior to adding them into the procedures for the MQ application group. To modify the MQ step programs, do the following:

  1. Add the queue manager names to the MQPRESWT and MQPOSTSWT programs. The two source templates are shipped in file MCTEMPLSRC in the MIMIX installation library. Ensure the queue manager name variable (#MQVAR#) is updated in MQPRESWT and MQPOSTSWT to the name of the queue manager.

  2. Add the MIMIX installation library to your library list.

  3. Compile MQPRESWT and MQPOSTSWT. Use the MIMIX installation library as the resulting library.

  4. Copy the MQPRESWT and MQPOSTSWT programs to the other system(s) in the installation.

  5. Define the programs as step programs.

The following is an example of the steps to modify the MQ step programs:

ADDSTEPPGM STEPPGM(MQCHGJRNB) PGM(installation-library-name/MQCHGJRN) TYPE(*DGDFN) NODETYP(*BACKUP)
ADDSTEPPGM STEPPGM(MQCHGJRNP) PGM(installation-library-name/MQCHGJRN) TYPE(*DGDFN) NODETYP(*NEWPRIM)
ADDSTEPPGM STEPPGM(MQPRESWT) PGM(installation-library-name/MQPRESWT) TYPE(*AGDFN) NODETYP(*PRIMARY)
ADDSTEPPGM STEPPGM(MQPOSTSWT) PGM(installation-library-name/MQPOSTSWT) TYPE(*AGDFN) NODETYP(*NEWPRIM)
Note: If you require support in your MQ environment for replicating more than one queue manager, refer to the latest version of the Assure MIMIX for IBM MQ book. The section on “Modifying procedures and step programs” provides the instructions necessary for modifying step programs to provide this support.

Table 124 lists the step programs that are shipped for Assure MIMIX IBM MQ and the procedures where they are used. The values for the Used in Procedure column indicate the following:

  • ‘R’  - The step is required and cannot be changed or disabled.

  • ‘C’  - The step is included and can be changed or disabled.

  • Blank - The step is not used in the procedure.

    Assure MIMIX IBM MQ programs

    Step/Step Program Name

    and Description

    Where Step Runs

    Used in

    Procedure

     

    Type

    Node

    START 1

    SWTPLAN2 SWTUNPLAN3

    MQCHGJRN

    (MQ - change journal)

    If the associated journal is AMQAJRN, the source system journal definition change management is set to *SIZE and the target system journal definition change management is set to None.

    Data Resource Group

    New Primary

    C

     

    C

    MQPRESWT

    (MQ pre-switch)

    Calls the switch program that ends the queue manager.

    Application Group

    Primary

     

    C

     

    MQPOSTSWT

    (MQ post-switch)

    Calls the switch program that enables the queue manager.

    Application Group

    New Primary

     

    C

    C

    1The MQ step programs need to be added to the MIMIX step program's start before starting data groups (MXSTRDG) associated with the application group.

    2The MQ step programs need to be added to the MIMIX step program's planned switch procedure using the ADDSTEP command. The MQPRESWT should be added after the user application is ended (ENDUSRAPP), and the MQPOSTSWT should be added after the user application is started on the new primary system (STRUSRAPP).

    3The MQ step programs need to be added to the MIMIX step program's unplanned switch procedure using the ADDSTEP command. Both MQPRESWT and MQCHGJRNP should be added in that order, after the application is started on the new primary system (STRUSRAPP).