Add/Remove Condition

The Add/Remove Condition parameter specifies a prerequisite condition to be added or deleted when the On Statement/Code criteria are satisfied.

Additional information	Description

Usage	Optional
Format	Each Add/Remove Condition parameter consists of three sub-parameters, described below.
Variable Support	None
Alternate names	Control‑M/EM Utilities: DOCOND Control-M Report: (none) Control‑M/Server Utilities: ‑docond Control‑M for z/OS: DO COND Control‑M/EM API: do_cond
Alternate formats
Control‑M/EM Utilities	DOCOND contains the following sub-parameters:
	NAME	Name of the condition. String.
	ODATE	Date (four characters long) for the prerequisite condition. String. Default: ODAT.
	SIGN	Valid values: ADD (Default) DEL
Sub-parameters
Name	Descriptive name of a prerequisite condition.
	Length	1 through 255 characters z/OS: 1 through 39 characters Control‑M for z/OS versions prior to 6.0.00: 1 through 20 characters
	Case Sensitive	Yes. However, if the Uppercase Only check box was selected in the Add Control‑M Definition window, you cannot use lowercase characters.
	Invalid Characters	Computers other than z/OS: Blanks; single quotation marks; ")" and "(" (parentheses); "\|" (pipe) z/OS: Blanks; ")" and "(" (parentheses); "\|" (pipe)
Date	Date (four characters long) for the prerequisite condition. Specific date (mmdd or ddmm format). ODAT. Automatically replaced by the job’s original scheduling date when the job is ordered. PREV Automatically replaced by the job’s previous scheduling date when the job is ordered (or for a forced job, ODAT-1). NEXT Automatically replaced by the job’s next scheduling date when the job is ordered (or for a forced job, ODAT+1). ****** (or $$$$) Any condition date. For deleting a prerequisite condition, only. When specified, all prerequisite conditions with the specified condition name are deleted, regardless of their dates. STAT Condition is not date-dependent. Note that this value is valid only for Control‑M/Server version 6.0.01 and later. NOTE: PREV and NEXT** cannot be specified when modifying details of a job in the Active Jobs database. A date reference is required for each condition. However, beginning with version 6.1.03 of Control-M/Server, ODAT can be specified when modifying details of a job in the Active Jobs database.
Sign	Indicates if the condition should be added (created) or deleted. + Adds (creates) the condition – Deletes the condition If the value of ODAT is $$$$ or ****, + cannot be selected.

The Add/Remove Condition parameter is optional. However, each Condition parameter specified must have a Date reference and a Sign specification.

When the criteria specified in the On Statement/Condition parameter are satisfied, the designated prerequisite condition(s) are added or deleted from the Control‑M Conditions List.

If parameters Add/remove Condition and Out Conditions perform opposing actions on the same prerequisite condition and date, the Add/Remove Condition parameter overrides the Out Conditions parameter.

For more information on the Out Conditions parameter, see Out Condition

NOTE: A maximum of 99 prerequisite conditions can be specified for the Add/Remove Condition parameter.

Parent Topic

On/Do Actions