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, use COIFBNDZ 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:
  1. 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:
  1. 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.
  2. 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.
  3. It is impossible to use SDUR and EDUR arguments at the same time.
  4. The character R in WLM_job_policy and in restartable_operation will be sent to PIF as blank.