Modifying the scheduler
/F procname,modifyoption
where:
- procname
- The HCL Workload Automation for Z JCL procedure name.
- modifyoption
- Can be one of the following:
- S=taskname
- Starts the specified subtask.
- P=taskname
- Stops the specified subtask.
taskname can be one of the following:
- APPC
- APPC subtask.
- AR
- Automatic recovery subtask.
- A4
- APPC tracker router subtask.
- CPH
- Critical path handler subtask.
- DRT
- Data router subtask.
- EMGR
- Event manager subtask.
- ERDR
- All active event-reader subtasks.
- EWTR
- Event writer subtask.
- EXA
- External router subtask.
- FL
- Fetch job log task.
- GEN
- General service subtask.
- HTC
- HTTP Client subtask.
- HTS
- HTTP Server subtask.
- IP
- TCP/IP router subtask.
- JCC
- Job-completion-checker subtask.
- NMM
- Normal-mode-manager subtask. The normal mode manager must be restarted as soon as possible after it has stopped. Many functions of HCL Workload Automation for Z require an active NMM task to execute successfully.
- PENF53
- Deactivates the ENF mechanism implemented for the ENF 53 event. In this way, a dynamic time change for all the HCL Workload Automation for Z subsystems cannot be performed. By default, the ENF 53 mechanism is automatically deactivated when the controller is stopped.
- PSU
- Pre-submit task.
- RODM
- RODM subtask.
- SENF53
- Activates the ENF mechanism implemented for the ENF 53 event, so that a dynamic time change for all the HCL Workload Automation for Z subsystems can be performed. By default, the ENF 53 mechanism is automatically activated at controller startup.
- SUB
- Submit subtask.
- VTAM®
- Network communication function (NCF) subtask.
- WSA
- Workstation analyzer subtask.
Only the tasks in HCL Workload Automation for Z subtask table can be activated by a MODIFY command. The subtask table is built when HCL Workload Automation for Z is started. This means that you can only start a task that has stopped earlier in the current session. If you attempt to start a started subtask or stop a stopped subtask, error message EQQZ049W is issued, and no action is taken.
- AWSCLASS (wsname)
- Adds a workstation to the list of workstations for which you defined the class forcing by
setting JTOPTS WSCLASS. For example, to add the workstation CPU1 issue the
command:
/F procname,AWSCLASS(CPU1)
- AWSSYSAFF (wsname:system.destination)
- Adds a workstation or a system and destination to the list of workstations where you
forced the execution of z/OS jobs by setting
JTOPTS WSSYSAFF(wsname:system.destination)
.For example to add the workstation CPU3 with the related destinations, issue the command:/F procname,AWSSYSAFF(CPU3:*.*)
To add the destination D5 belonging to system SYSA to the workstation VIRT, issue the command:/F procname,AWSSYSAFF(VIRT:SYSA.D5)
.
- BKSTATUS
- Issue this command on the primary controller or backup controller to collect detailed
information about plans, JT events, and processes. By comparing the information that is
returned in EQQMLOG, you can verify the alignment status between the controllers. For example, on the primary controller, the following messages are shown in EQQMLOG:
EQQN133I PRIMARY CONTROLLER INFO: EQQN133I CP INFO: EQQN133I - CP RUN : 00000004 EQQN133I - CP TOD : CDDD39D2CA9AB661 EQQN133I LTP INFO: EQQN133I - LT RUN : 00000002 EQQN133I - LT TOD : CDDD39D526710741 EQQN133I LATEST WRITTEN JT EVENT INFO: EQQN133I - EVENT TYPE : 29 EQQN133I - SEQUENCE NUMBER: 00000CD3 EQQN133I - TIME STAMP : 141006/16522655 EQQN133I LATEST TRANSFER PLAN INFO: EQQN133I - NCP JOB NAME : ROZSENCP EQQN133I - NCP JOB ID : STC00814 EQQN133I - NCP JOB STATUS : C EQQN133I - LTP JOB NAME : ROZSENLT EQQN133I - LTP JOB ID : STC00813 EQQN133I - LTP JOB STATUS : C EQQN133I - CP1 JOB NAME : EQQN133I - CP1 JOB ID : EQQN133I - CP1 JOB STATUS :
On the backup controller, the following messages are shown in EQQMLOG:BACKUP CONTROLLER INFO: CP INFO: - CP PLAN AVAILABLE : Y - CP PLAN DDNAME : EQQCP1DS - CP PLAN RUN NUMBER : 00000004 - CP PLAN TOD KEY : CDDD39D2CA9AB661 LTP INFO: - LT PLAN AVAILABLE : Y - LT PLAN RUN NUMBER : 00000002 - LT PLAN TOD KEY : CDDD39D526710741 LATEST WRITTEN JT EVENT INFO: - JT TYPE : 29 - JT SEQNO : 00000C15 - JT TIMESTAMP : 141006/16264299 SYNCHRONIZATION INFO: - SYNC IS IN PROGRESS : N - SYNC TYPE : - NCP STATUS : restore not needed - CP1 STATUS : restore not needed - CP2 STATUS : restore not needed - LTP STATUS : restore not needed LATEST RESTORE PLAN INFO: - NCP JOB NAME : ROZSENCP - NCP JOB ID : STC00805 - NCP JOB STATUS : N BKTAKEOVER INFO: - POSTPONED : N ------------------------------------------------------
- BKTAKEOVER
- Orders a backup controller to take over the functions of the primary controller. Issue
this command on the backup controller.
Specify the option
BKTAKEOVER,FORCE
to force the backup controller takeover, even when the connection between the controllers is apparently up and running. Specify the optionBKTAKEOVER,NOSUB
to deactivate the job-submit option, even if JTOPTS JOBSUBMIT(YES) is set. - CDP=ON
- Activates the CDP logging. This command is effective provided that
OPCOPTS CDPPATH=path_to_CDP_log_files
was already set at controller startup. - CDP=OFF
- Deactivates the CDP logging.
- CPQSTA=ON
- Activates the STATMSG(CPLOCK) message.
- CPQSTA=OFF
- Deactivates the STATMSG(CPLOCK) message.
- DEPLOYCF
- Use this option to manually start the deployment process that refreshes the trackers
event configuration file (member EQQEVLST of the EQQJCLIB data set) according to the
current content of the controller EQQEVLIB data set.
The process can update the event configuration file for the trackers that are currently connected. At the end of the deployment process, each connected tracker monitors for the events that match the refreshed data, based on an in-storage copy of the configuration file.
If a tracker destination is referenced in the controller routing options (ROUTOPTS statement), but it is not currently connected, the tracker acquires the configuration file data when the connection is restored. - DOPIADEP
- Displays the value set for OPIADEP in the JTOPTS statement.
- DSPDEST
- Lists the HTTP destinations that are currently used by the controller. The list is stored in the message log.
- DSPSMOOTHSUB
- Displays all the values that are set for the smooth submission feature in the JTOPTS and BATCHOPT statements.
- DSPPRODD
- Lists the DD names for data sets that cannot be discarded. The list can be obtained in
one of the following ways:
- In the initial parameter statements: RCLOPTS DDPROT or DDPRMEM
- With the MODIFY command
/F procname,PROT(DD=member)
- DSPPRODS
- Lists the data sets that cannot be discarded. The list can be obtained in one of the
following ways:
- In the initial parameter statements: RCLOPTS DSNPROT or DSNPRMEM
- With the MODIFY command
/F procname,PROT(DS=member)
- DSPSTA
- Displays, in message EQQZ095, the status of statistics messaging. The message indicates whether messaging is active for EVENTS, CPLOCKS, GENSERV, and WSATASK. It also gives the values currently set for EVELIM and STATIM. For details, refer to Messages and Codes.
- EVELIM=nnnn
- Sets the new value of the EVELIM parameter of the JTOPTS statement. Allowed values are 0 to 9999.
- DWSCLASS
- Displays the list of workstations for which you defined the class forcing by setting JTOPTS WSCLASS.
- DWSSYSAFF
- Displays the list of workstations where you forced the execution of z/OS jobs by setting
JTOPTS WSSYSAFF(wsname:system.destination)
. . - EVESTA=ON
- Activates the STATMSG(EVENTS) message.
- EVESTA=OFF
- Deactivates the STATMSG(EVENTS) message.
- GENSTA=ON
- Activates the STATMSG(GENSERV) message.
- GENSTA=OFF
- Deactivates the STATMSG(GENSERV) message.
- JCLDBG=ON
- Activates the single JCL trace. For each job handled by WSA task information, such as the
elapsed time in milliseconds needed to handle the job, retrieve the JCL, access the JS VSAM,
or whatever else, will be shown.
This is a powerful trace and should be activated only for short periods of time to identify possible performance problems.
- JCLDBG=OFF
- Deactivates the single JCL trace.
- JESSYMBOL=ON
- Activates the JESSYMBOL parameter of the OPCOPTS statement.
- JESSYMBOL=OFF
- Deactivates the JESSYMBOL parameter of the OPCOPTS statement.
- LSTNOERR
- The controller lists the NOERROR table content. An example of the command output follows:
EQQZ024I Current NOERROR table content: EQQZ024I !------------------------------------------!----------! EQQZ024I ! Statement ! Member ! EQQZ024I !------------------------------------------!----------! EQQN067I ! ABC123.*.*.0016.GE ! STDCWSN ! EQQN067I ! ABC123.*.*.0012.NE ! STDCWSN ! EQQN067I ! ABC123.*.*.0016.EQ ! STDCWSN ! EQQN067I ! ABC123.*.*.0500.TO.0610 ! NOERR2 ! EQQN067I ! ABC123.*.*.0200.TO.0210 ! NOERR2 ! EQQN067I ! ABC123.*.*.0005.LT ! NOERR ! EQQZ024I !------------------------------------------!----------!
The information returned in the
Member
column can help you locate members to be updated. - MAXSUB=nnnn
- Sets the new value of the MAXSUBJOBS parameter of the OPCOPTS statement. Allowed values are 0 to 9999.
- MCPDSSTART
- Use this command to create and use an MCP data space. This overrides MCPDATASPACE(NO) in the JTOPTS statement.
- MCPDSSTOP
- Use this command to stop using and delete the MCP data space. This overrides MCPDATASPACE(YES) in the JTOPTS statement.
- NEWDSLST
- Use this command on the tracker side to rebuild the triggering
selection table. The new table is read from member EQQEVLST (or EQQDSLST, if EQQEVLST does
not exist) of the data set referenced by the EQQJCLIB DD name in the started task JCL
for the tracker. The new table replaces the table in ECSA. Note: If EQQJCLIB contains both EQQEVLST and EQQDSLST member, the resulting triggering selection table is the union of EQQEVLST and EQQDSLST. In this case, EQQEVLST data is processed first.
- NOERROR
- You can use the commands NEWNOERR and NOERRMEM() only if NOERROR entries are
coded under the LIST() parameter of the NOERROR
statement.
When you enter a NEWNOERR command, the program searches the controller PARMLIB member only for NOERROR statements. If none are found, an empty table is created, thus deleting the entries which were loaded when the controller started. Do not use the NEWNOERR command if the NOERROR list is coded under the NOERROR() parameter of the JTOPTS initialization statement. If you enter a NOERRMEM(membername) command, the current table is deleted and created again. The entries that had already been specified for membername are replaced with the entries found in the updated member of the EQQPARM library.
When using NOERROR, consider the following:- Use this keyword only if you are sure you can stop the controller before updating the NOERROR data.
- Initialization statements cannot exceed 32 KB or 455 72-character lines. The available space for NOERROR entries in the initialization statement is more limited compared with using this keyword in the JTOPTS statement.
- Do not mix the three options for defining NOERROR entries:
- JTOPTS NOERROR ()
- NOERROR LIST () in the main parmlib member
- NOERROR LIST () in separate parmlib members identified by the INCLUDE() initialization statement
- If you must dynamically update the NOERROR data without stopping the controller, and the NOERROr entries are defined in a separate parmlib member, place all NOERROR entries in a single parmlib member. In this way, you can use only one member name in the NOERRMEM command.
- NEWNOERR
- Orders a controller to rebuild the NOERROR table, in the case NOERROR statements have been modified in the parameter library member that contains the JTOPTS statement.
- NOERRMEM(member)
- Orders a controller to rebuild the NOERROR table, in the case NOERROR statements have been modified in a parameter library member that was specified in an INCLUDE statement.
- NOERRMEM(M1)
- Order a controller to delete all NOERROR codes defined by member M1, once
you have previously changed M1 to contain only comments. The modified member can contain a
different number of NOERROR codes than the original member. Note: The scheduler opens the EQQPARM library when HCL Workload Automation for Z is started and parameter library members (residing in library extents), that have been created, cannot be accessed, after have been opened. To avoid this problem, the data sets that define the EQQPARM library should be allocated without any secondary extents.
- PROT ([DD=mem1], [DS=mem2])
- Replaces the currently used list contents of the members (mem1 and mem2)
inside the PDS parameter library, if DD or DSN is protected. At least one of the two
keywords DD or DS must be specified. The list of protected DD and DSN is dropped when
mem1 or mem2 is blank. Also, the keywords DD and DS remove the list of
protected DD names and DS names.
For example, if DDPROT is used in the parameter library at startup of the controller, the command drops this list and replaces it with the contents of mem1.
- QUELEN=nnnn
- Sets the new value of the QUEUELEN parameter of the JTOPTS statement. Allowed values are 0 to 9999, but a minimum value of 5 is forced.
- RFRDEST
- If you modify, add, or delete an HTTP or HTTPS destination in ROUTOPTS while HCL Workload Automation for Z is running, makes your
changes immediately effective. This command does not update any changes you make to
the PROXY parameter in ROUTOPTS.
RFRDEST manages up to a total of 100 new destinations, regardless if you add them at once or at different times. .
- RFRUSER
- If you modify the USRREC statement while HCL Workload Automation for Z is running, makes your changes immediately effective.
- RFRUX14T
- If you modify the criteria table pointed by the UX14IN DD name in the controller started
task while the controller is running, makes your changes effective for the operations that
become ready after modifying the table.
To make the changes effective also for the operations that were ready before you modified the table, you must replan the current plan.
For detailed information about the time-dependent-operation exit, see Time-dependent-operation exit (EQQUX014).
- RWSCLASS (wsname)
- Deletes a workstation from the list of workstations for which you defined the class
forcing by setting JTOPTS WSCLASS. For example, to remove the workstation VIRT issue the
command:
/F procname,RWSCLASS(VIRT)
- RWSSYSAFF (wsname[:system])
- Deletes a workstation or a single destination from the list of workstations where you
forced the execution of z/OS jobs by setting
JTOPTS WSSYSAFF(wsname:system.destination)
. The valuesystem
is optional, if you do not specify it the complete workstation definition is deleted.For example, to delete the destination SYSB from the list of systems defined for the workstation VIRT, issue the following command:/F procname,RWSSYSAFF(VIRT)
.
- SETSMOOTHCRITNET=ON
- Sets the SMOOTHCRITNET parameter in JTOPTS to YES, to prioritize the submission of operations belonging to the whole critical network.
- SETSMOOTHCRITNET=OFF
- Sets the SMOOTHCRITNET parameter in JTOPTS to NO.
- SETSMOOTHRATE=nnnn
- Changes the value for the SMOOTHSUBRATE parameter in the JTOPTS statement. Valid values are in the range from 0 to 99999. 0 means that the SMOOTHSUBRATE parameter is not set.
- SETSMOOTHSUB=ON
- Activates the smooth submission feature. To make it effective, run either a daily planning EXTEND or REPLAN.
- SETSMOOTHSUB=OFF
- Deactivates the smooth submission feature. To make it effective, run either a daily planning EXTEND or REPLAN.
- SKIPINC(member name)
- Replaces the currently used list of INCLUDEs that are to be left at the beginning of a
JCL by the JCL tailoring process of Restart and Cleanup. member name can be:
- The name of a member inside the PDS parameter library
- Blank or absent
When a member name is specified, the current SKIPINCLUDE list is deleted and a new SKIPINCLUDE list is built by applying the syntax described for the RCLSKIP statement to the specified member. When no member name is specified, the current SKIPINCLUDE list is removed.
For details about RCLOPTS(SKIPINCLUDE), see RCLOPTS and about RCLSKIP, see RCLSKIP.
- SOPIADEP (YES | NO | TIME)
- Sets a new value for the OPIADEP parameter of the JTOPTS statement.
- STATIM=nn
- Sets the new value of the STATIM parameter of the JTOPTS statement. Allowed values are 0 to 99.
- STATUS
- Returns a message on the system log with the status of HCL Workload Automation for Z subsystem. The status
can be one of the following:
- FULLY_OPERATIONAL
- Everything is active and is working properly.
- PARTIALLY_OPERATIONAL
- The scheduler subsystem has limited functionality. For example, if a controller ER is stopped, the controller can still schedule jobs but cannot receive their statuses.
- NOT_OPERATIONAL
- The major subsystem functionality is not available. For example, a controller is not able to execute a plan or to submit a job.
- STATUS, DD=ddname
- Checks for the status of HCL Workload Automation for Z data set associated
with the specified ddname. ddname can be
a specific DD name, such as EQQWSDS, EQQCP1DS, or EQQLTDS, or it can assume the value ALL,
CP, DB, LTP, or JTL. It returns the return code of the last I/O operation performed on that
ddname. The status of the data set can be one of the following:
- NORMAL
- WARNING
- SEVERE
- CRITICAL
- UNKNOWN
- STATUS, {OP_COMP | OP_ERR}, "destination name"
- Returns the number of completed operations (OP_COMP) or the number of ended-in-error
operations (OP_ERR) for the specified tracker (destination name). Note:
- If more than one workstation is defined for tracker tracker name, the number of completed or in-error operations is the sum of the operations on all the workstations defined on that tracker.
- destination name is the destination name of a tracker, as specified in the ROUTOPTS initialization statement.
- STATUS, SUBTASK
- Lists all subtasks with their statuses. The status can be ACTIVE or INACTIVE.
- SWITCHMLOG
- If the MLOG switching feature is in use, forces the switch to the alternate data set (EQQMLOG or EQQMLOG2), regardless of the number of currently logged records, and starts counting from 0 again.
- TAKEOVER
- Orders a standby controller to take over the functions of the controller. This command is
valid only when both systems are part of the same XCF group, and no controller is
active. You can use this command only for HCL Workload Automation for Z address spaces
where OPCHOST(STANDBY) is specified in the OPCOPTS statement.
Note: Takeover can occur automatically if you have set the TAKEOVER parameter in the XCFOPTS statement of a standby system.
- TRYNOERR(member name)
- Start a trial processing of the
NOERROR statements contained in member name. The controller issues all the normal
processing messages in EQQMLOG. At the end of the trial processing, the controller issues
message EQQN099I, leaving unchanged the NOERROR table.
member name is a member of the EQQPARM library.
- VSTRC=START
- Starts a trace on the message log of all VSAM I/O requests. In a busy scheduler system, you will need a large message-log data set, and the trace will affect the performance of HCL Workload Automation for Z system.
- VSTRC=STOP
- Stops a VSAM I/O request trace on the message log.
- WSASTA=ON
- Activates the STATMSG(WSATASK) message.
- WSASTA=OFF
- Deactivates the STATMSG(WSATASK) message.
IEE324I MODIFY REJECTED - TASK BUSY