TWS Education + Training
April 29-May 3, 2012
Hyatt Regency Austin
Austin, Texas
Collecting and keeping job
output
4401
Thursday, May 3rd
Output Management adjacency to Tivoli Workload
Scheduler for z/OS
Output
Archiving
File
transfer
mgt
Output
Mgt
Remote
spooling
Tivoli Workload
Scheduler for
z/OS
Restart
and
Cleanup
Validation
and crossreference
Who does what?
Archive job
outputs, transform
data into customer
reports
Output
Archiving
File
transfer
mgt
Output
Mgt
Centralized
retrieval of job
outputs
Tivoli Workload
Scheduler for
z/OS
Restart
and
Cleanup
Validation
and crossreference
Remote
spooling
Value of centralized job output retrieval
Output
Archiving
• Facilitate access to company
data for analisys and
File
auditing purposes transfer
mgt
Output
Mgt
• Adherence to company standards
• Archiving products take inputs from JES
Tivoli Workload
Scheduler for
z/OS
Restart
and
Cleanup
Validation
and crossreference
Remote
spooling
Centralized retrieval of job output in TWS z/OS
•JES Spool is where the Job Outputs are
written
TWS z/OS Controller
• Output produced by any job/task
• Daily and Long Term Planning jobs with
SYSOUT CLASS
JES SPOOL
EQQM
TWS z/OS Tracker Agents
JOBB
JOBA
• TWS z/OS Controller and Tracker started
tasks that specify a SYSOUT Class
message logs
Centralized retrieval of job output in TWS z/OS end-to-end
•JES Spool is where the Job Outputs are
written
TWS z/OS Controller
• Output produced by any job/task
• Daily and Long Term Planning jobs with
SYSOUT CLASS
JES SPOOL
EQQM
• TWS z/OS Controller and Tracker started
tasks that specify a SYSOUT Class
message logs
TWS z/OS Tracker Agents
SCRIPTA
JOBB
What about FTA /
z-centric job
outputs?
Mainframe
Distributed
SCRIPTB
JOBA
Distributed agents (FTA or z-centric)
Solutions covered in this presentation
C
B
A
Utility to
automatically
retrieve FTA and
z-centric job
output (sending to
JES)
Automatic
retrieval of
ended-in-error
job outputs
(sending to JS)
Automatic
retrieval of all
job outputs in
the enterprise
(sending to
JES)
FTA and zCentric job outputs retrieval utility
TWS z/OS Controller
Customized
EQQUX007
exit
JES SPOOL
TWS z/OS Tracker Agents
SCRIPTA
Distributed
SCRIPTB
Mainframe
A
Distributed agents (FTA or z-centric)
P
I
F
1.Retrieve job
output
2.Build header
and attach
joblog
3.Submit a job
with the same
jobname as the
original job
FTA and zCentric job outputs retrieval utility
TWS z/OS Controller
Customized
EQQUX007
exit
JES SPOOL
TWS z/OS Tracker Agents
SCRIPTA
Distributed
SCRIPTB
Mainframe
A
Distributed agents (FTA or z-centric)
P
I
F
1.Retrieve job
output
2.Build header
and attach
joblog
3.Submit a job
with the same
jobname as the
original job
Automatic retrieval of ended-in-error jobs
•Introduced with TWS z/OS v8.6
TWS z/OS Controller
• Option to be activated through new
parameters in RCLOPTS and HTTPOPTS
JS FILE
E?
TWS z/OS Tracker Agents
SCRIPTA
Distributed
SCRIPTB
Mainframe
B
Distributed agents (z-centric)
NO
B
Automatic retrieval of ended-in-error jobs
RCLOPTS
JOBLOGRETRIEVAL
ONDEMAND
ONERROR
RESTARTINFORETRIEVAL
ONDEMAND
ONERROR
Change the default to automatically retrieve joblogs (or info for R&C)
HTTPOPTS
JOBLOGRETRIEVAL
ONDEMAND
ONERROR
Change the default to automatically retrieve output of jobs running on z-centric or dynamic
workstations
C
The final solution
•Automate and control the entire collection process
•New Output Collector component to automatically retrieve z-centric job output
1
Retrieve the joblog from the agent (or the dynamic
domain manager)
2
Build an header containing run time information
for every joblog released in the z-centric
environment
3
Send to the JES for output management tool to
archive
C
Just three steps to take advantage of it!
Define
Run “Create Sample Job JCL” panel (EQQJOBS
Option 1) to prepare Output Collector environment:
Sample started task procedure (EQQOUC)
Sample parameters (EQQOUCP)
Sample to allocate new datasets (EQQPSC11)
EQQOUCEV for Controller and Output Collector
comunication
EQQOUCKP job log request checkpoint
Sample job log header template (EQQOUCH)
C
Just three steps to take advantage of it!
Define
Run EQQPCS11 to allocate new datasets
Update Controller started task with DDNAME
EQQOUCEV
Set the following parameters
HTTPOPTS
Activate
OUTPUTCOLLECTOR
JLOGHDRTEMPL
OPCOPTS
OUCOPTS
YES
member
C
Just three steps to take advantage of it!
Define
Activate
Customize header
 A joblog header template sample comes with the
installation (EQQOUCH)
 You can edit it and copy into the member pointed out
by JLOGHDRTEMPL parameter, selecting the
variables considered useful or retaining them all
The whole picture
TWS z/OS Controller
Output Collector
JES SPOOL
EQQM
TWS z/OS Tracker Agents
SCRIPTA
JOBB
Distributed
SCRIPTB
JOBA
Mainframe
C
Z-centric or dynamic agents
Output collector and high availability
TWS z/OS Controller
Output Collector
TWS z/OS Standby
Controller
Image 1
TWS z/OS Tracker Agents
Image 2
C
• Define the OUTCOL keyword of OPCOPTS
statement to specify the name of the Output
collector started task to the controller.
• In a sysplex environment this enables the
standby controller to continue the interaction
with Output collector.
C
Output collector deep dive
Output Collector
TWS z/OS Controller
EQQOUCEV
Event file
• Queue Manager
• Processes incoming requests
• Creates an entry in the checkpoint DS
TWS z/OS Tracker Agents
• Log Retriever
• Dynamically allocates a DS with the DD
name equal to the job name
• Gets the joblog header from the agent
• Write joblog + header to
• Removes the entry from the checkpoint
• Starts a number of parallel threads
depending on user parameters
Job completion
produces an events in
the event dataset
•
JOBA
HTTP and HTTPS destination can be refreshed
with a command issued to the Output Collector
Questions?
TWS Education & Training
April 29-May 3, 2012
Hyatt Regency Austin
Austin, Texas
REMINDER!
 Please complete the session evaluation card
included in your registration envelope.
 Place the evaluation card in the basket on your
way out of the session.