Batch Utility IOACND

Utility IOACND is a utility that is generally included in New Day processing but can also be run throughout the day on an as-needed basis. The utility adds, verifies the existence of, deletes, or modifies prerequisite conditions and resources in the IOA Conditions file and/or the Control-M Resources file. It can be activated as a started task (STC), from TSO, or from within a user program.

A copy of the utility is pre-supplied with Control-M. You need only provide the desired control statements, as discussed below:

1. In the pre-supplied copy of the utility, add the following control statements under the EXEC statement:

     ADD    COND IDGS-MONITOR-UP %%OMONTH.%%ODAY

     DELETE COND IDJOB10-ENDED-OK %%OMONTH.%%ODAY

     CHANGE RESOURCE IDTAPE 3

     ADD CONTROL IDDATA1 E

   This job must be submitted through Control-M to resolve the AutoEdit variables.

2. Submit the utility.
3. Enter the IOA Conditions/Resources screen.

• Condition IDGS-MONITOR UP appears with the current ODATE.
• Condition IDJOB10-ENDED-OK with the current ODATE no longer appears.
• Three units of quantitative resource IDTAPE appear in the screen.
• Control resource IDDATA1 has been assigned Exclusive control.

Take a closer look at the control statements you can use in this utility. All control statements must have the following format:

action entity_type entity_name  qualifiers

where

• action can be one of the following:
  • ADD         Valid for any entity type.
  • DELETE    Valid for any entity type.
  • CHECK      Valid for COND only. Verifies that the condition exists.
  • CHANGE    Valid for RESOURCE only. Changes the resource quantity.
• entity_type can be one of the following:
  • COND            For prerequisite conditions
  • RESOURCE    For quantitative resources
  • CONTROL     For control resources
• entity_name is the name of the condition or resource.
• qualifiers depend on the entity type, as indicated in the following table:

  Table 28 Qualifiers and Entity Types

  Entity Type	Qualifier	Description and Valid Values
  COND	cond_date	Condition date. Valid values are: literal – mmdd or ddmm site format DATE – Current Gregorian date WDATE – IOA working date STAT – static date.
  RESOURCE	resc_quantity	Resource quantity. In either of two formats: n (integer, such as 2 or 3). Valid for ADD and DELETE actions. +/- n (such as -2 or  +3). Valid for CHANGE actions. It specifies the amount and direction of the change.
  CONTROL	control_type	Type of Control. Valid values are: E – Exclusive S – Shared

Note the following points about utility IOACND:

• It can be activated as a started task (STC), from TSO, or from within a user program.
• The addition, deletion, modification or verification is recorded three ways:
  • in the job sysout
  • as a message on the operator console
  • as an event in the IOA Log file.
• Parameters can be received by the utility in two ways:
  • using DD statement DACNDIN (or SYSIN)
  • using PARM.

  The parameters required depend on whether prerequisite conditions, control resources or quantitative resources are being processed.

• If it is necessary to add, delete, verify, or modify prerequisite conditions or resources during a job step, CTMCND can be called as a procedure from within the application program.

IOA Online Utility I1, which is described in the IOA Utilities chapter of the Control-M for z/OS User Guide, can be used for adding, deleting or checking a prerequisite condition in the IOA Conditions file.