Creating a message queue monitor - assure_mimix - 10.0

For information about message queue monitors, see Message queue monitors (*MSGQ).

Do the following to create a message queue monitor:

1. From the MIMIX Basic Main Menu, select option 12 (Work with monitors) and press Enter.

2. From the Work with Monitors display, type a 1 (Create) in the Opt column next to the blank line at the top of the list and press Enter.

3. The Create Monitor Object (CRTMONOBJ) display appears. Do the following:

   1. At the Monitor prompt, provide a unique name for the monitor.

   2. At the Event class prompt, specify *MSGQ.

   3. If you want to assign this monitor to a grouping of similar monitors, either for participating in triggering a group monitor or for subsetting, specify a name for the Monitor group prompt.

   4. To call a program before (pre-exit) and after (post-exit) each operation performed on a monitor, specify the program name and library for the Interface exit program prompt. If you want to run a command when the event is triggered, refer to the tips for Common parameters on the CRTMONOBJ command.

   5. To call a program containing user-defined conditions after the predefined condition is met, specify the program name and library for the Condition program prompt.

   6. To call a program that initiates user-defined actions when the predefined conditions and user-defined conditions are met, specify the program name and library for the Event program prompt.

      Note: If you want to run a command instead of an event program, specify *NONE for the Event program prompt and specify *CMD for the Interface exit program prompt. After the monitor is created, you will be prompted to provide the command information.

   7. To use a different job description to submit the monitor job and for asynchronous jobs started for the monitor, specify the name and library for the Job description prompt.

   8. Press Enter, additional parameters will appear on the display.

4. If you want to retry the conditions a number of times before calling the event program, specify a value for the Retry attempts prompt.

5. At the Message queue prompt, specify the name and library of the message queue to be monitored.

6. At the Message identifier prompt, specify one or more message identifiers, including generics, to monitor for on the specified message queue.

7. If you want to use asynchronous processing so that the monitor starts a separate job to process the message identifier, specify *ASYNC for the Process type prompt.

8. If you want message queue monitors in FAILED or INACTIVE state to automatically start when the master monitor is started, specify *YES for the Start with master monitor prompt.

9. If the message queue to be monitored exists in an independent ASP, at the ASP group prompt specify the name of the primary ASP device within the ASP group.

10. Provide a text description of the monitor at the Description prompt and press Enter.

11. If you specified *CMD for the Interface exit program, the Add Monitor Information (ADDMONINF) display appears. Do the following:

    1. Type the command that you want to use and provide the appropriate parameters and values.

    2. Type the name of the library in which the command resides in the Library parameter and press Enter. You can also type *DFT to use the library specified on the Command parameter. If no library is specified on the Command parameter, the library list is used to locate the command. If the command is found, the library name is retained. If you specify *LIBL, the library list is used to locate the command.