Rules Structure

The following tables describe the structures of the IDMS Startup and Termination solution rules.

Table 118 IDMS C.V. Initialization Started Rule Structure

Item	Description
Title	IDMS C.V. Initialization Started
Name	IEF403I
Table	IDMS
Message	IEF403I jjj STARTED { - TIME=hh.mm.ss} when the message is issued from job IDMS*.
Message Description	Job jjj starts.
Basic Scheduling Parameters	Always schedule this rule.
Runtime Scheduling Parameters	No special considerations.
Global Variables	None.
Rule Logic	As soon as IDMS is started, the IOA environment is informed that IDMS is no longer down.
Rule Actions	Deletes condition or date CTO-idmsname-DOWN STAT, where idmsname is the name of the IDMS job or started task.
Activating the Rule	Once scheduled, the rule remains active until deleted from Control-O.
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	If a different mechanism that controls IDMS conditions (utility IOACND, Control-M Event Manager, etc.) is already implemented, the mechanism must be removed before implementing this rule. Change the name of the prerequisite condition indicated in this rule to match your previous definition if both of the following are true: The IOA environment already contains a prerequisite condition indicating that IDMS is up or down. For example, if such a condition is already referenced by a Control-M job scheduling definition. The prerequisite condition has a different name than the one indicated in this rule. The rule assumes that the name of the production IDMS jobs or started tasks starts with IDMS. This prefix may need to be changed (in the rule’s ON statement) in order to match site conventions.

Table 119 IDMS C.V. Initialization Completed Rule Structure

Item	Description
Title	IDMS C.V. Initialization Completed
Name	IDMS DC013
Table	IDMS
Message	IDMS DC013005 IDMS-CV/DC INITIALIZATION COMPLETE
Message Description	IDMS completed initialization and is up.
Basic Scheduling Parameters	Always schedule this rule.
Runtime Scheduling Parameters	No special considerations.
Global Variables	None.
Rule Logic	As soon as IDMS initialization is completed, the IOA environment is informed that IDMS is up.
Rule Actions	Adds condition or date CTO-idmsname-UP STAT, where idmsname is the name of the IDMS job or started task.
Activating the Rule	Once scheduled, the rule remains active until deleted from Control-O.
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	If a different mechanism that controls IDMS conditions (utility IOACND, Control-M Event Manager, etc.) is already implemented, the mechanism must be removed before implementing this rule. Change the name of the prerequisite condition indicated in this rule to match your previous definition if both of the following are true: The IOA environment already contains a prerequisite condition indicating that IDMS is up or down. For example, if such a condition is already referenced by a Control-M job scheduling definition. The prerequisite condition has a different name than the one indicated in this rule. Table 120 IDMS C.V. Termination StartedRule Structure
Item	Description
Title	IDMS C.V. Termination Started
Name	IDMS DC201
Table	IDMS
Message	IDMS DC201002 IDMS CENTRAL VERSION QUIESCING
Message Description	IDMS C.V. termination started.
Basic Scheduling Parameters	Always schedule this rule.
Runtime Scheduling Parameters	No special considerations.
Global Variables	None.
Rule Logic	Intercepts IDMS termination message and informs the IOA environment that IDMS is no longer up.
Rule Actions	Deletes condition or date CTO-idmsname-UP STAT, where idmsname is the name of the IDMS job or started task.
Activating the Rule	Once scheduled, the rule remains active until deleted from Control-O.
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	If a different mechanism that controls IDMS conditions (utility IOACND, Control-M Event Manager, etc.) is already implemented, the mechanism must be removed before implementing this rule. Change the name of the prerequisite condition indicated in this rule to match your previous definition if both of the following are true: The IOA environment already contains a prerequisite condition indicating that IDMS is up or down. For example, if such a condition is already referenced by a Control-M job scheduling definition. The prerequisite condition has a different name than the one indicated in this rule. Table 121 IDMS C.V. Termination CompletedRule Structure
Item	Description
Title	IDMS C.V. Termination Completed
Name	IEF404I
Table	DMS
Message	IDMS DC201003 IDMS CENTRAL VERSION SHUTDOWN or IEF404I jjj ENDED { – TIME=hh.mm.ss} when the message is issued from job IDMS*.
Message Description	IDMS DC201003 – IDMS C.V. shutdown successful. IEF404I – Job jjj ended.
Basic Scheduling Parameters	Always schedule this rule.
Runtime Scheduling Parameters	No special considerations.
Global Variables	None.
Rule Logic	When IDMS terminates successfully or when the IDMS job ends, the IOA environment is informed that IDMS is down.
Rule Actions	Deletes condition or date CTO-idmsname-UP STAT, where idmsname is the name of the IDMS job or started task. Adds condition or date CTO-idmsname-DOWN STAT, where idmsname is the name of the IDMS job or started task.
Activating the Rule	Once scheduled, the rule remains active until deleted from Control-O.
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	If a different mechanism that controls IDMS conditions (utility IOACND, Control-M Event Manager, etc.) is already implemented, the mechanism must be removed before implementing this rule. Change the name of the prerequisite condition indicated in this rule to match your previous definition if both of the following are true: The IOA environment already contains a prerequisite condition indicating that IDMS is up or down. For example, if such a condition is already referenced by a Control-M job scheduling definition. The prerequisite condition has a different name than the one indicated in this rule. Table 122 Suppress S IDMS if IDMS Is Active Rule Structure
Item	Description
Title	Suppress S IDMS if IDMS Is Active
Name	S IDMS
Table	IDMS
Command	S IDMS
Command Description	This command starts IDMS (the rule suppresses the command).
Basic Scheduling Parameters	Always schedule this rule.
Runtime Scheduling Parameters	IN !CTO-idmsname-DOWN STAT
Global Variables	None.
Rule Logic	In general, if command S IDMS is issued when IDMS is already up, the new started task is immediately shut down and normal termination messages are issued. These messages, however, give the appearance that the active IDMS has gone down and this may incorrectly trigger other rules in this solution and cause erroneous updating of prerequisite conditions, thus incorrectly triggering jobs in Control-M. This rule prevents the situations described above by suppressing the S IDMS command if IDMS is already up. In this way, issuance of the termination messages is prevented and rules are not incorrectly triggered. This rule serves as a sample rule. A similar rule must be created for each IDMS environment in the site.
Rule Actions	Suppresses the command. Sends a message to user U-SHIFTOPER indicating that command S IDMS was suppressed.
Activating the Rule	Once scheduled, the rule becomes active when prerequisite condition or date CTO-idmsname-DOWN STAT is deleted, where idmsname is the name of the IDMS job or started task.
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	The rule must be duplicated for each IDMS job or started task in the site. To adapt each rule, the IDMS name in the rule’s ON statement and IN condition must be changed. Change the name of the prerequisite condition indicated in this rule to match your previous definition if both of the following are true: The IOA environment already contains a prerequisite condition indicating that IDMS is up or down. For example, if such a condition is already referenced by a Control-M job scheduling definition. The prerequisite condition has a different name than the one indicated in this rule.

Parent Topic

IDMS Startup and Termination