INGRMIOL Routine for OLDS Monitoring

This routine should be used as the monitor command for a monitor resource.

It is issued after each monitoring interval to check the status of the online log data sets (OLDS) of an IMS control region and to take recovery actions if needed. To achieve this, the IMS command DISPLAY OLDS is issued to analyze the status of the listed OLDS data sets. If needed, OLDS data sets are started or stopped. Any OLDS data sets that have been defined as spare OLDS data sets are started last and stopped first.

The health status of the monitored OLDS data sets is considered to be NORMAL when the number of available OLDS data sets is not less than a given minimum number, and the AUTOMATIC ARCHIVE is switched on. In all other cases a degraded health status is returned.

Format

Read syntax diagramSkip visual syntax diagramINGRMIOL

Restrictions

  • The monitor resource must be for an IMS control region that is defined as an IMS subsystem of subcategory CTL.
  • OLDS is specified as the monitored object.
  • Automation actions in INGRMIOL are only taken if the recovery automation flag for minor resource OLDS is on.

Comments and Usage Notes

The automation settings for OLDS monitoring are taken from user data for the special message ID OLDS, which is defined in the MESSAGES/USER DATA policy item of the IMS control region with the following keyword-data pairs:
Keyword Data Description
MINIMUM nn The minimum number of OLDS data sets that must be in (AVAILABLE + IN USE) status.

Half of the number of listed OLDS data sets in the response of the DISPLAY OLDS command is assumed as the default value.
SPARES (nn,nn…) These specified spare OLDS data sets are started last or stopped first when OLDS data sets have to be started or stopped in order to have the minimum number of OLDS data sets in status AVAILABLE.
BACKOUT nn The maximum number of OLDS that are allowed to be in a BACKOUT status.
All of these settings are optional.

Return Codes

Depending on the monitor results, INGRMIOL ends with the following return codes, which are mapped to the related health status for the monitor resource:
Return Code Health status Description
1 BROKEN The monitor encountered a severe error.
2 FAILED DISPLAY OLDS failed.
3 NORMAL No problem found by OLDS monitoring.
4 WARNING One of the following occurred:
  • Needed to start spare OLDS to have the minimum in AVAILABLE status
  • AUTOMATIC ARCHIVE is off
5 MINOR Could not start enough spare OLDS to have the minimum in AVAILABLE status.
6 CRITICAL The number of OLDS in BACKOUT status exceeds maximum limit.