Rules Structure

The following tables describe the structures of the Reserved Dataset Handling solution rules, as well as the following KOA script:

• Log onto OMEGAMON and Perform LOC Command

  Table 105 Respond to Reserved Dataset Message of a Production Rule Structure

  Item	Description
  Title	Respond to Reserved Dataset Message of a Production
  Name	IEF863I
  Table	OMEGAMON
  Message	IEF863I DSN=dsn where JNAME begins with P.
  Message Description	A job is waiting for one or more datasets that are not available. Message IEF863I is issued listing the unavailable datasets.
  Basic Scheduling Parameters	Always schedule this rule.
  Runtime Scheduling Parameters	No special considerations.
  Global Variables	None.
  Rule Logic	The rule is triggered when a production job (that is, a job whose name starts with P) is waiting for unavailable datasets required in Exclusive mode. The rule calls KOA script OMLOC. The KOA script locates the users, jobs or started tasks holding the datasets and "shouts" appropriate messages to those users and/or to the production manager.
  Rule Actions	Suppresses message IEF863I from the console. Calls KOA script OMLOC.
  Activating the Rule	Once scheduled, the rule is triggered whenever message IEF863I is issued by any job whose name starts with a P (that is, a production job).
  Recommended Mode or Category	During the testing period, activate the rule in LOG mode. Once you are satisfied with the results of the rule, change the mode to PROD to avoid log messages for the rule. The SolveWare category for this rule is 2—some customization is required before implementation.
  Customization	Check if the production job names in your site begin with a P. If not, adjust the rule according to site naming conventions for production jobs. KOA script OMLOC may also require adaptation to site requirements.

  Table 106 Log onto OMEGAMON and Perform the LOC Command Script Structure

  Item	Description
  Title	Log onto OMEGAMON and Perform the LOC Command
  Name	OMLOC
  KOA Script Description	This KOA script is invoked by rule IEF863I. The rule passes to the script a parameter that identifies a held dataset required in Exclusive mode by a production job. The script logs onto OMEGAMON and performs OMEGAMON command LOC, which identifies the users, jobs or started tasks holding the dataset. The script then "shouts" a message to TSO users holding the dataset and to the production manager for each job or started task that holds the dataset.
  Activating the KOA Script	The KOA script is activated by rule IEF863I.
  Parameters	%A1 Name of the required (held) dataset. %A2 Name of the production job that produced message IEF863I.
  Global Variables	None.
  KOA Script Logic	This KOA script logs onto OMEGAMON and performs OMEGAMON command LOC. LOC locates all holders of the dataset identified in parameter %A1, which is passed to the KOA script by its initiating rule. The script checks the response from OMEGAMON. For each TSO user holding the dataset, a message is "shouted" to the user. For each job or started task holding the dataset, a message is "shouted" to the production manager.
  Recommended Mode or Category	The SolveWare category for this KOA script is 3—the script is provided as an example. Implementation of the KOA script requires little or no customization.
  Customization	Locate the SHOUT messages to the production manager in the KOA script and modify the destination to the TSO user ID of the production manager.