Creating an interval monitor - assure_mimix - 10.0

For information about interval monitors, see Interval monitors (*INTERVAL).

Do the following to create an interval 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 *INTERVAL.

   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 Time interval (sec.) prompt, specify the length of time, in seconds, that MIMIX Monitor waits before optionally checking the communications object and, if the object is not active, starting the condition and event programs for the monitor again. The value specified must be equal to or greater than 300 if the Process type specified was *ASYNC.

6. Depending on what items you want the monitor to check you will need to select the following parameters:

   Table 1. Interval monitor parameter selections

   Desired action	Interval subclass prompt choice
   If you do not need to have the monitor check additional parameters:	Specify *NONE for the Interval subclass prompt and press Enter Proceed to Step 7.
   If you want to have the monitor check the status of a configuration object:	Specify *CFG for the Interval subclass prompt and press Enter. At the Configuration object prompt, specify the name of the object to monitor. At the Configuration type prompt, specify the type of the line, controller, or device to monitor and proceed to Step 7.
   If you want to check the status of a TCP/IP host address or alias:	Specify *TCP for the Interval subclass prompt and press Enter. At the Host address or alias prompt, specify the TCP host address or alias to monitor. (Ensure that you place single quotes around the host address) and proceed to Step 7.
   If you want to check a communications link using the primary transfer definition specified in a system definition used in a replication environment:	Specify *SYSDFN for the Interval subclass prompt and press Enter. At the System definition prompt, specify a system definition that is defined to MIMIX. Press F4 (Prompt) to see a list of system definitions and then proceed to Step 7.
   If you want to check a communications link using a transfer definition used in a replication environment:	Specify *TFRDFN for the Interval subclass prompt and press Enter. At the Transfer definition prompt, specify the three-part name of the transfer definition that is defined to MIMIX and which defines the communications method to be monitored. All three parts of the transfer definition must be specified. Press F4 (Prompt) to see a list of transfer definitions and then proceed to Step 7.

7. If you want to use asynchronous processing so that the interval master monitor controls the intervals and starts a separate job to run the condition and event programs, specify *ASYNC for the Process type prompt.

8. If you want interval 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. Provide a text description of the monitor at the Description prompt and press Enter.

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