Condition or Resource Parameters (CTMTBUPD)

Updates to the IN, OUT, CONTROL, and RESOURCE parameters require statements that often provide additional information beyond just the new value.

The format of the update statement for condition or resource parameters is:

where

• parmname is the parameter to be updated (IN, OUT, CONTROL, or RESOURCE) in the job scheduling definition.
• N is the new parameter value.
  This parameter is used without an O parameter when adding a new condition or resource, and is used with an O parameter when replacing an existing condition or resource value. Subparameters are
  • name – Condition or resource name
  • qualifier – Parameter qualifier (for example, condition date, resource quantity). For details, see Subparameter Qualifier (CTMTBUPD).
• O is the old (existing) parameter value.
  This parameter is used without an N parameter when deleting an existing condition or resource, and is used with an N parameter when replacing an existing condition or resource value. Subparameters are
  • name – Condition or resource name
  • qualifier – Parameter qualifier (for example, condition date, resource quantity). For details, see Subparameter Qualifier (CTMTBUPD).
• P is the starting character position. This parameter is used when partial names are specified in parameter N or O (for generic updating). For details, see Partial Names (Generic Changes) (CTMTBUPD).

Note the following points:

• Parameter parmname is mandatory.

  An N parameter and/or an O parameter must be specified.

  Parameter P must be specified if parameter N or parameter O in the statement is to be treated as a partial value (meaning, not a full 20-character name padded with trailing blanks).

• The specified parameters must be in the order indicated in the format statement (meaning, parmname must be first, N cannot follow O or P, and O cannot follow N or P).
• When both parameters N and O are specified, the length of the name value need not be the same for each of the parameters.
• Whether this statement applies to an IN, OUT, CONTROL or RESOURCE parameter is determined by the parmname value. This, in turn, determines the format and valid values of the subparameters in parameters N and O.
  • Valid values for subparameter qualifier are generally determined by the values allowed in job scheduling definitions.
  • In many cases, question marks can be specified as the value for subparameter qualifier.

Note: Question marks indicate that the specified qualifier (meaning, subparameters in the job scheduling definition such as condition date or resource quantity) is not considered during processing. This topic is discussed at greater length later.

Format and valid values for subparameter qualifier are described immediately below. Usage of these values, including question marks, is discussed later.