IBM Support

TWSz migration issues when skipping release levels ( zWS z Workload Scheduler )

Question & Answer


Question

Changes made April 4, 2023 are marked with a vertical bar "|" in the left margin.
| When migrating to a new zWS z/OS release for example 9.5 or 10.1  from a release older than 9.5 what special considerations must be made?

Cause

migration

Answer

| Need to add new features/ differences for releases 9.3, 9.5 and 10.1 
Here are the important differences introduced at TWSz ( COMPID 5697WSZ01) releases 9.2.0, 9.1,0 8.6.0, 8.5.1, 8.5.0 and 8.3.0:

Recent changes are marked with vertical bar (|) on the lefthand side.

1) Added at TWSz 9.2.0:

New Features:
New filter for operations waiting for pending predecessors
Dependency resolution time interval shown for mandatory pending predecessors
Status of system automation workstations can be changed in the plan
Maximum number of parallel servers per workstation increased
Job run history reports add statuses of jobs ended in error and manually set to completed
Using two message log (MLOG) data sets for controller and tracker with GDG archiving
Product version displayed in the Message Log (EQQMLOG)
New message EQQIC66I issued in the MLOG of the migration JCL when VSAM files of the Application Description database are migrated with the EQQICTOP conversion program
Integration with IBM Tivoli Output Manager
Create incident reports through OSLC integration with SmartCloud Control Desk
Heartbeat checking mechanism for z-centric agents and dynamic domain managers
New JOBREC keyword for the script file extension
Dynamic Workload Console and mobile device applications enhancements impacting TWSz
http://publib.boulder.ibm.com/infocenter/tivihelp/v47r1/topic/com.ibm.tivoli.itws.doc_9.2/common/src_gi/eqqg1dwcmobilenewfeats.htm

(A) New sample job Installation JCL members from EQQJOBS:
EQQBENCO: SAMPLE JCL TO ENCRYPT THE PASSWORDS IN THE OSLCOPTS
EQQPCS12: ALLOCATES TWS for z/OS GDG root for MLOG SWITCH Datasets
EQQSMLOG: REPRO THE INACTIVE MLOG TO A GDG DATA SET

(B) Updated Installation JCL members from EQQJOBS:
EQQICNVS: Added DD and Convert statement for EQQXDIN and EQQXDOUT - Datasets that were added in 8.6.0 and not allocated in earlier releases.

(2) Added at TWSz 9.1.0:

New Features:
Federal Information Processing Standards (FIPS) compliance
Run cycle groups
Programming interface (PIF) for GENDAYS
Additional matching criteria for the resolution of dependencies
New customizable monitoring agent for Tivoli Workload Scheduler
DB2 on z/OS supported for reporting on the Dynamic Workload Console
Automatic promotion of critical z-centric jobs that are late
New SSL default security certificates

(A) Updated Installation JCL members from EQQJOBS:
EQQICNVS: Added DD and Convert statements for EQQXDIN and EQQXDOUT – New Datasets that were added in 8.6.0 and not allocated in earlier releases.

(B) JCL Skeleton changes
New members:
EQQRGPRS: RUN CYCLE GROUP PRINT PROGRAM

DDNames added:
DX12IN, DX12OUT:
EQQDPEXS: DAILY PLANNING - PLAN NEXT PERIOD
EQQDPPRS: DAILY PLANNING - PRINT CURRENT PERIOD RESULTS
EQQDPRCS: DAILY PLANNING - REPLAN CURRENT PERIOD
EQQDPTRS: DAILY PLANNING - PLAN A TRIAL PERIOD

LTPRED3:
EQQLEXTS: LONG TERM PLANNING - EXTEND THE LONG TERM PLAN
EQQLMOAS: LONG TERM PLANNING - MODIFY ALL OCCURRENCES
EQQLPRAS: LONG TERM PLANNING - PRINT THE LONG TERM PLAN
EQQLTRES: LONG TERM PLANNING - CREATE THE LONG TERM PLAN
EQQLTRYS: LONG TERM PLANNING - PLAN A TRIAL PERIOD

LRECL & BLKSIZE changes:
LTPRIN, LTPROUT: LRECL=100,BLKSIZE=6300 from LRECL=66,BLKSIZE=4620
SPACE=(6300,(300,300)) from SPACE=(4620,(300,300))
EQQLEXTS: LONG TERM PLANNING - EXTEND THE LONG TERM PLAN
EQQLMOAS: LONG TERM PLANNING - MODIFY ALL OCCURRENCES
EQQLPRTS: LONG TERM PLANNING - PRINT LONG TERM PLAN
EQQLPRAS: LONG TERM PLANNING - PRINT THE LONG TERM PLAN
EQQLTRES: LONG TERM PLANNING - CREATE THE LONG TERM PLAN
EQQLTRYS: LONG TERM PLANNING - PLAN A TRIAL PERIOD



(3) Added at TWSz 8.6.0:

(A) Datasets:

EQQLOGRC
– Allocated by EQQPCS01 Job
– Joblog and Restart Information pending requests Log data set
– Must add to Controller Start Procedure JCL

EQQXDnDS, EQQNXDDS
– Allocated by EQQPCS01 Job
– Extended data and New Extended data
– Must add to Controller Start Procedure JCL
– Must add to CP Extend/Replan/Trial job JCL

EQQTMPL
– Allocated by SMP/E Job
– Extend ISPF panel Dataset
– Add to TSO LOGON Procedure JCL or CLIST

SEQQGENU/SEQQGJPN
– Allocated by SMP/E Job
– Extend ISPF panel Dataset
– Add to TSO LOGON Procedure JCL or CLIST

(B) Parameters

JTOPTS
– MAXJSFILE Unit Change from KB to MB
- LARGEUSERBUFFER default value is 64K, prior to 8.6 the value used was 32K

(C) SPE (Small Programming Enhancements) - check if these were applied

PM63132
PM63133
PM63134
PM63135
PM63136
PM63137

(4) Added at TWSz 8.5.1:

(A) Datasets

EQQHTTP0
– Allocated by EQQPCS02 Job
– z-Centric Agent & Remote Engine Event Dataset
– Add to Controller Start Procedure JCL

| ADREPORT - allocated by EQQADCDZ skeleton JCL in SEQQSKL0- LRECL was changed to 129
| and BLKSIZE to 6450 to accomodate conditional step dependency reporting needs .

(B) Parameters

TCPOPTS
– CONNTIMEOUT Default changed from 15 to 60

(C) SPE:

PM14386


(5) Added at TWSz 8.5.0

(A) Datasets:

EQQEVLIB
– Allocated by EQQPCS01 Job
– Configuration Dataset for EDWA
– Must add to Controller Start Procedure JCL

LTPRIN/LTPROUT LRECL/BLKSIZE changed
– Temporary dataset allocated by LTP Extend/Modify/Trial/Print Job JCL
– LRECL changed from 65 to 66, BLKSIZE changed from 4550 to 4620
– Must Modify LTP Extend/Modify/Trial/Print job JCL
– APAR - PK96855 AVOID LOSS OF EXTERNAL DEPENDENCIES

(B) Parameters

SERVOPTS
– PROTOCOL Changed from JSC to TCP

DSTOPTS
– DSTHIGHJOBID deleted
– DSTLOWJOBID deleted

MONOPTS
– CONNTIMEOUT/LOCHOSTNAME deleted

MONPOL
– OPERATION(CRITPATH) deleted and integrated to CRITICAL

(C) SPE - none

(D) Message changes (auto operations considerations)

EQQE036I message text changed
– Before
EQQE036I JOB &JOBNAME(&JNUM), OPERATION(&OPERNUM),
ENDED IN ERROR &EC.
PRTY=&PRI, APPL = &APPL, WORK STATION = &WSID, IA = &IA'

– After
EQQE036I JOB &JOBNAME(&JNUM), OPERATION(&OPERNUM),
OPERATION TEXT(&OPTEXT), ENDED IN ERROR &EC.
PRTY=&PRI, APPL = &APPL, WORK STATION = &WSID, IA = &IA


(6) Added at TWSz 8.3

(A) Datasets:

SCP (EQQSCPDS) became mandatory (was previously needed only for E2E)

EQQLOOP - CP loop analysis

(B) Parameters

OPCOPTS:
- GDGNONST - Default value changed to YES

TOPOLOGY
-POSTPONE (for reducing network outage at SYMPHONY distribution)

(C) SPE:

PK40356
PK40969
PK41519
PK46292
PK46296
PK46298
PK46302
PK46532
PK48574
PK53366
PK58515
PK58516
PK58520
PK63960
PK63698
PK71280

(D) Message changes (auto operations considerations)

EQQE036I message text changed (via APAR PK53543)

– Before
EQQE036I JOB &JOBNAME(&JNUM), OPERATION(&OPERNUM),
ENDED IN ERROR &EC.
PRTY=&PRI, APPL = &APPL, WORK STATION = &WSID, IA = &IA'

– After
EQQE036I JOB &JOBNAME(&JNUM), OPERATION(&OPERNUM),
OPERATION TEXT(&OPTEXT), ENDED IN ERROR &EC.
PRTY=&PRI, APPL = &APPL, WORK STATION = &WSID, IA = &IA

(E) Other new features:

SE (scheduling environment) integration with WLM
Removed the 877 ETT limit -- limit became minutes until end of CP
Enhanced Critical jobs (Critical Path Handler or Dynamic Critical Path)
"EVERY" run cycles
Attach FTAs directly to E2E server (no Domain Manager required)
TEP (Tivoli Enterprise Portal) integration (monitoring)
SA automation (IBM system automation or SA/390)
enhancements to JCL variables
"ONCOMPLETE" for special resource

[{"Type":"MASTER","Line of Business":{"code":"LOB35","label":"Mainframe SW"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SSWL3F","label":"IBM Z Workload Scheduler"},"ARM Category":[{"code":"a8m0z0000001fw9AAA","label":"ZOS-\u003EIZWS-\u003EMigration to a new release"}],"ARM Case Number":"TS000000000","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"All Versions"}]

Document Information

Modified date:
04 April 2023

UID

swg21672997