Migrating the controller with the IWSZSELFUPGRADE application
You can upgrade the HCL Workload Automation for Z controller
in an automatic way, with only few manual steps, by using the IWSZSELFUPGRADE
application
that is provided with the product.
In IWSZSELFUPGRADE
,
the jobs requiring manual actions are defined as dummy operations
on a manual start and completion workstation.
IWSZSELFUPGRADE
is
provided in batch loader and Workload Automation Programming Language formats
that you can import by using the EQQUPGBL or EQQUPGWA sample, respectively.
After importing the
IWSZSELFUPGRADE
application,
to migrate an HCL Workload Automation for Z controller
complete the following procedure.Note:
- Before running
IWSZSELFUPGRADE
, ensure that you setVARSUB=YES
in the OPCOPTS statement. - If you are using JES3 exit, modify the operations 004 and 005
in
IWSZSELFUPGRADE
to replace EQQJES2 and EQQJES21 with EQQJES3.
- Copy
IWSZSELFUPGRADE
to the Application Description. - Customize the following jobs as required for your migration purposes:
- EQQALPDS
- To allocate the data sets required to run EQQJOBS.
- EQQNPJOB
- To mark as NOP all the operations that install or migrate optional functions (such as Restart and Cleanup or Reporting) that you do not use.
- EQQCPMOD
- To copy the load modules EQQSSCMx and EQQINITx to the user library that needs to be APF authorized and added to the z/OS system LINKLIST.
- EQQCPPAR
- To copy the old PARMLIB to the new PARMLIB.
- Add the
IWSZSELFUPGRADE
application to the current plan.The following operations are run automatically or wait for your manual intervention:- Operation 001 (automatic)
- The data sets required for EQQJOBS are allocated.
- Operation 002 (manual)
- You are required to run EQQJOBS and copy the generated sample
JCLs to the job library data set (EQQJBLIB). Note: Ensure that in the Create Sample Job JCL (EQQJOBS3) panel, you specify the
//&OJOBNAME JOB
card in the Job Statement Information field. - Operation 003 (automatic)
- The NOPJOB job is run.
- Operations 004, 005, and 006 (automatic)
- The samples generated by EQQJOBS named EQQJES2, EQQJES21, and
EQQSMF are run to link the JES2 and SMF exits.Note: If you are using JES3 exit, you must have modified the operations running EQQJES2 and EQQJES21 to an operation running EQQJES3.
- Operation 009 (manual)
- You are required to manually update the following members:
- IEFSSNnn defined for the load modules EQQINITx and EQQSSCMx.
- IKJTSOnn defined for the load module EQQMINOx.
- Operations from 010 to 113 (automatic)
- The following jobs are automatically run, unless you marked them
as NOP.Note: Because EQQPCS02 contains system symbols, if you want to use them you must make EQQPCS02 a started task or batch job by copying it to a procedure library. Then, define the workstation where this operation is run as
STARTED TASK, STC = Y
. - Operation 120 (manual)
- You are required to update the controller startup procedure.
- Operation 130 (automatic)
- The EQQICNVS sample job is automatically run to migrate the VSAM data sets.
- Operation 150 (automatic)
- The COPYMOD job is automatically run to copy the load modules EQQSSCMx and EQQINITx to the PARMLIB.
- Operation 151 (automatic)
- The COPYPARM job is automatically run to copy the old PARMLIB to the new PARMLIB.
- Operation 152 (manual)
- You are required to update the new PARMLIB as required.
After the IWSZSELFUPGRADE
application
completes successfully, you can start the subsystem that was migrated.