Update Parameters (CTMTBUPD AJF Mode)

Update parameters generally correspond to the parameters of the Control-M Job Zoom and Save screen. Not all fields in the screen can be updated using the utility. Fields that can be updated are listed and described below. For a detailed description of each parameter, see the Job Production parameters chapter in the Control-M for z/OS User Guide.

You can update the fields shown in Table 151b by specifying the new desired values in the following format:

parm_name=new_value

where

parm_name is the name of the parameter in the job scheduling definition.
new_value is the new value for the parameter.

Note: In Table 151b, an asterisk in column * indicates that character masking can be specified for the parameter as follows:

If an asterisk is specified following a character string, the character string is treated as a prefix (meaning, only the first n characters of the parameter, corresponding to the number of characters preceding the *, participate in the modification).

If the character string begins with one or more asterisks, the number of characters at the start of the parameter value corresponding to the number of asterisks specified do not participate in the modification.

Table 151b CTMTBUPD Parameters in AJF Mode

Parameter	*	Value	Description

MODE		AJF	Applies to jobs in the AJF. The MODE parameter must be on the first line. If MODE is omitted the function will apply to the schedule definition.
HOLDBUPD		Y\|N	Holds the job before the Zoom and Save and frees the job afterwards. The default is”Y”.
PIPE		pipe name (1 to 44 characters)	MAINVIEW Batch Optimizer (MVBO)/Job Optimizer Pipes pipe name Note: This field is supported only if MAINVIEW Batch Optimizer (MVBO) is installed at your site.
IN		(cond,date) cond – 1 through 39 characters date – 4 characters Boolean characters \|()	Name of IN condition Date reference of IN condition Default: ODAT (for date reference) Note: If the condition name contains Boolean characters (open or close parentheses), enclose the parameter value in quotation marks rather than parentheses.
OUT		(out,date,option) out – 1 through 39 characters date – 4 characters option – +/-	Name of OUT condition Date reference Function: ADD or DELETE Default: ODAT (for the date reference); + (for the option)
RESOURCE		(resource,number, opt1, opt2) resource – 1 through20 characters number – 4 characters opt1 – D opt2 – K	Quantitative resource. Name of resource. Quantity of resource. Disposition of the resource when job ends OK (D=Delete) Disposition of the resource when job ends NOTOK (K=Keep)
CONTROL		(control,type,opt) control – 1 through 20 characters type – S or E opt – K	Control resource Name of Control resource Usage type: Shared or Exclusive Disposition of the resource when job ends NOTOK (K=Keep)
OVERLIB	*	1 through 44 characters	Overriding JCL library name
MAXWAIT		2 digits	Maximum days job is retained 0-98 (default is 0) 99 indicates "forever"
APPL	*	1 through 20 characters	Application name
REMOVEATONCE		Y (Yes) or N (No - default)	Indicates that all the jobs will be removed together, when the folder is ready to be removed.
DAYSKEEPNOK		2 digits (0–99)	The minimal number of days that the folder and its jobs are kept in the AJF after the folder is marked as "NOT-OK". 1-98 – Number of days to keep. 99 – Keep forever. The above two options are invalid when REMOVEATONCE is set to "No". 0 – Do not keep (Default). This is the only valid value when REMOVEATONCE is set to "No".
GROUP		1 through 20 characters	Group name (Ignored if SMART table was created via the GROUP-ENTITY parameter)
DESC		1 through 50 characters	Description of job
DOCLIB	*	1 through 44 characters	Documentation library name
DOCMEM	*	1 through 8 characters	Documentation member name
TIMEFROM		[+/-]hhmm	Earliest time to submit job
DAYSFROM		3 digits (0–120)	Time FROM days offset
TIMEUNTIL		[+/-]hhmm,>	Latest time to submit job, submit as soon as possible
DAYSUNTIL		3 digits (0–120)	Time UNTIL days offset
TIME-ZONE		3 characters	Time zone designation
SCHENV		1 through 16 characters	Workload management scheduling environment
SYSTEM-ID		1 through 4 characters	SYSTEM-ID identifier
NJE-NODE		1 through 8 characters	NJE node name
DUE-OUT		(hhmm,nnn)	Time when the job finishes executing nnn is an offset of up to 120 days Default: 0
DAYS-DUEOUT		3 digits (0–120)	Due-out time days offset
PRIORITY		1 to 2 characters	Priority
CONFIRM		Y (Yes) or N (No)	Confirmation for schedule
PREVENT-NCT2		Y (Yes) or N (No) or F or L	Prevent ‘NOT CATLGD 2’ errors
SETVAR		1 through 66 characters %%varname=value	Set AutoEdit value If value contains delimiter characters (for example, commas), enclose the entire parameter text in quotes or apostrophes (for example, ‘%%varname=value’).
CATEGORY		1 through 20 characters	Category for Control-D
MAXRERUN		4 digits	Maximum number of reruns
INTERVAL		5 digits, 0 through 64800	Time interval between reruns
INTERVAL-TYP		1 character: S, E, T	Interval type Start or End of Interval or Target S Start E End T Target Default: E
MAXDAYS		2 digits	Expiration period
MAXRUNS		3 digits	Maximum number of runs
RETDAYS		3 digits	Maximum number of days to retain
RETGENS		2 digits	Maximum number of generations to retain
MAXRERUN-CYC		4 digits; 0 through 9999	Maximum number of cyclic runs. Effective only if TASKTYPE is set to CYC.
INTERVL-UNIT		M, H, D		The units in which INTERVAL is expressed (Minutes, Hours, or Days) Default: M
TOLERANCE		1 to 4 digits		Enhanced cyclic tolerance - the maximum number of minutes after the specified time permitted for a late submission. Default: 0000
VAR-INTERVAL		nnnnn, unit		Enhanced cyclic varying interval (nnnnn - interval length, unit = M (Minutes), H (Hours), D (Days) Default: M
CYC-RUNTIME		hhmm, nnn		Enhanced cyclic specific run times in 24-hour format: hh (hour), mm (minutes) with an optional day-offset (nnn)

Parent Topic

CTMTBUPD Parameters