Steps for Assure MIMIX IBM MQ - assure_mimix - 10.0

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)
    

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).