MODIFY CPOP
Modify an operation in the current plan. If the attempts fails, BCIT will perform
other attempts at a predefined time interval (for the maximum of 3 total).
ACTION=MODIFY,RESOURCE=CPOP,ADID=application_description,
AEC=automatic_error_completion,
AJR=automatic_job_hold/release,
ASUB=automatic_job_submission,
CLATE=cancel_if_late,
CLNTYPE=cleanup_type,
CONDRJOB=conditional_recovery_job,
COIFBNDD=complete_if_bind_fails,
COIFBNDZ=complete_if_bind_fails,
DEADWTO=issue_deadline_wto,
DESC=descriptive_text,
DURATION=duration,
EDUR=estimated_duration,
ERRCODE=error_code,
EXPJCL=expanded_jcl,
FORM=form_number,
GROUP=authority_group_name,
HRC=highest_successful_retcode,
IA=input_arrival_datetime,
JCLASS=jobclass,
JOBCRT=critical_job,
JOBNAME=jobname,
JOBPOL=WLM_job_policy,
MONITOR=externally_monitored,
OPCMD=operation_command,
OPDL=op_deadline_datetime,
OPDLACT=op_deadline_action,
OPIA=op_input_arrival_datetime,
OPNO=operation_number,
OSTATUS=oc_status,
PSUSE=paralleles_server_required,
R1USE=resource1_required,
R2USE=resource2_required,
READID=remote_job_appl_desc,
REJOBNM=remote_job_name,
REJSNM=remote_job_stream_name,
REJSWS=remote_ws_name,
REOPNO=remote_job_op_num,
RERUT=reroutable_operation,
RESTA=restartable_operation,
SDUR=estimated_duration_inseconds,
STATUS=op_status,
TIMEDEP=timedependent_job,
USRSYS=user_sysout,
WLMSCLS=WLM_service_class,
WSNAME=workstation_name;
- application_description
- Character (char(16)) can be generic (%*)
- automatic_error_completion
- A character: Y or N (char(1))
- automatic_job_hold/release
- A character: Y or N (char(1))
- automatic_job_submission
- A character: Y or N (char(1))
- cancel_if_late
- A character: Y or N (char(1))
- cleanup_type
- A character: A, M, I or N (char(1))
- complete_if_bind_fails
- A character: Y or N (char(1)). Use
COIFBNDD
for an IBM Workload Schedulerremote job, useCOIFBNDZ
for anIBM Z Workload Scheduler remote job. - conditional_recovery_job
- A character: Y or N (Char(1))
- critical_job
- A character: P, W, or N (char(1))
- descriptive_text
- Character (char(24))
- duration
- Time (Integer (4)) number of hundredths of a second
- error_code
- Character (char(4))
- estimated_duration
- Time (HHMM)
- estimated_duration_inseconds
- (Integer (4)) number of seconds
- expanded_jcl
- A character: Y or N (char(1))
- externally_monitored
- A character: Y or N (char(1))
- form_number
- Character (char(8))
- highest_successful_retcode
- Integer (integer (4)): allowed values from 0 to 4095.
- input_arrival_datetime
- Date and time (YYMMDDHHMM) or 'X'
- issue_deadline_wto
- A character: Y or N (char(1))
- jobclass
- A character: A–Z, 0–9 (char(1))
- jobname
- Character (char(8)) can be generic (%*)
- oc_status
- Occurrence status: C, D, E, P, S, U, or W (char(1))
- op_deadline_datetime
- Date and time (YYMMDDHHMM)
- op_deadline_action
- A character (char(1)):
- A
- Only an alert message is issued.
- C
- The operation is set to Complete, if its status allows it. Otherwise, it is NOPed.
- E
- The operation is set to Error with ODEA, if its status allows it. Otherwise, this setting is postponed at the time when the status allows it.
- N
- The operation and all its internal successors are NOPed, if their status allows NOPing. Otherwise, it is ignored.
- op_input_arrival_datetime
- Date and time (YYMMDDHHMM)
- op_status
- A character: A, R, S, C, D, I, E, W, U, or * (char(1))
- operation_command
- Character (char(2) can be:
- EX = Execute operation
- KJ = Kill operation1
- MH = Hold operation
- MR = Release operation
- NP = NOP operation
- PN = Prompt reply no
- PY = Prompt reply yes
- UN = Un-NOP operation
Note:- Applies only to operations running on IBM Z Workload Scheduler Agents (z-centric agents).
- operation_number
- Integer (integer(4))
- paralleles_server_required
- Integer (integer(4))
- remote_job_appl_desc
- Character (char(16)). Only for aIBM Z Workload Scheduler remote job.
- remote_job_name
- Character (char(40)). Only for an IBM Workload Scheduler remote job.
- remote_job_op_num
- Integer (integer(4)). Only for an IBM Z Workload Scheduler remote job.
- remote_job_stream_name
- Character (char(16)). Only for an IBM Workload Scheduler remote job.
- remote_ws_name
- Character (char(16)). Only for an IBM Workload Scheduler remote job.
- reroutable_operation
- A character: Y or N (char(1))
- resource1_required
- Integer (integer(4))
- resource2_required
- Integer (integer(4))
- restartable_operation
- A character: Y, N or R (Char(1))
- timedependent_job
- A character: Y or N (char(1))
- user_sysout
- A character: Y or N (Char(1))
- WLM_job_policy
- L, D, S, or C (char(1))
- WLM_service_class
- Character (char(8)) can be generic (%*)
- workstation_name
- Character (char(4)) can be generic (%*)
Note:
- The parameters of the MODIFY CPOP request are the same as the parameters of the INSERT CPOP request. In addition, the MODIFY CPOP request has the ERRCODE and the OPCMD parameters.
- An ADID is identified by ADID and IA. If there is only one occurrence (regardless of its status) specify the correct value of IA or IA=X. If there is only one occurrence in a given status, specify the correct value of IA or IA=X and OSTATUS to identify the occurrence. If there is more than one occurrence in the status specified by the OSTATUS operand, a return code of 10 is sent and the occurrence will not be modified. The OPNO argument identifies the operation within the occurrence.
- It is impossible to use SDUR and EDUR arguments at the same time.
- The character R in WLM_job_policy and in restartable_operation will be sent to PIF as blank.