Configuring IBM Tivoli Output Manager to browse job logs for z-centric operations
To enable the integration between HCL Workload Automation for Z and Tivoli Output Manager,
make sure that you have:
- Installed PTF UI13683 for APAR PI07423: INTEGRATION ENHANCEMENTS FOR ISPF INTERFACE on Tivoli Output Manager. This PTF provides enhancements to the Tivoli Output Manager ISPF interface to facilitate the passing of parameters by using ISPF variables.
- Installed PTF UI25172 for APAR PI21174 on Tivoli Output Manager.
- Activated the HCL Workload Automation for Z Output Collector started task. For details about the description and configuration of the Output Collector, see Scheduling End-to-end with z-centric Capabilities and Customization and Tuning.
To configure Tivoli Output Manager to
capture the logs (sysouts in Tivoli Output Manager terminology)
of the operations performed by z-centric agents and dynamic domain
managers, perform the following steps:
- Start the Tivoli Output Manager
Administrative Functions
dialog in ISPF and enter A (Archive attributes). - Define an archive attribute by selecting
New
in the file action bar choice. Make sure that the Archive Mask allows the Tivoli Output Manager started task to WRITE these data set names and that your user ID has the ability to READ them. For example:Figure 1. IBM Tivoli Output Manager - Defining an archive attribute. File Help _________________________________________________________________________________ IBM Tivoli Output Manager - Archive Attribute Details Command ===> ___________________________________________________________________ More: + Descriptive data Name . . . . . . . . STR Archive Mask . . . STRTST.&JN..&J£..&N Retention Period . _____ Print Model . . . . Report Dynamic Print . . . No Allocation attributes Management Class . . _________ Storage Class . . . _________ Vol Sers . . . . . _______ _______ _______ _______ _______ Device Type . . . _________ Data Class . . . . . _________ Auto Calculate . . ____ Space Units . . . . _________ Average Record Unit _________ Primary Quantity . ________ Secondary Quantity ________ F1=Help F3=Exit F7=Bkwd F8=Fwd F10=Left F11=Right F12=Cancel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
- Go back to the
Administrative Functions
dialog and enter T (TPL rules). Then, depending on the code page you are using, define a TPL rule as follows (in this example, the code page IBM-1144 is applied).Note: For detailed information about special characters and their code pages, see IBM Tivoli Output Manager for z/OS: Administrator's Guidewhen before line 100 match " = TWS OCCURRENCE --> (A-Z0-9$"à1,16) (ççdà3) (ççdà10) then begin set arcname = "&1 &2 &3"; end
- Go back to the
Administrative Functions
dialog and enterS
(Selector rules). Then:- Define a selector rule and link it to the archive attribute by
selecting the
Link
action bar choice. - Set the status to
Enabled
. - Specify the HCL Workload Automation for Z SYSOUT
class that is assigned to the started tasks, set the Job Type to
Stc
, and the JES Queue toAll
. For example:Figure 2. IBM Tivoli Output Manager - Defining a selector rule. File Link Help _________________________________________________________________________________ IBM Tivoli Output Manager - Selector Rule Command ===> ___________________________________________________________________ More: + Selector Name . EQQ zCentric Status . . . . Enabled Archive Attr: HWA Selection criteria SYSOUT Class . K Destination . _______________________ Writer . . . . ___________ Forms . . . . ___________ Job Type . . . Stc JES Queue . . All / Advanced Selection criteria _ Processing Options _ TPL Rules F1=Help F3=Exit F7=Bkwd F8=Fwd F10=Left F11=Right F12=Cancel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
- Select (/)
Advanced selection criteria
and set the Job Name to the name of the Output Collector started task and the User ID to the owner of the Output Collector started task. For example:Figure 3. IBM Tivoli Output Manager - Specifying advanced options for the sub-selector. File Help _________________________________________________________________________________ IBM Tivoli Output Manager - Advanced Selection Command ===> ___________________________________________________________________ Selector Name . EQQ zCentric Advanced Selection criteria Job Name STRAOUC_ User Id . . . . RACFID2_ FCB . . .________ UCS . . . . . . _____ Flash . . . . . _____ In addition to the Forms field on the previous panel, you may specify an additional 7 values (for a total of 8). These are logically OR'd. Forms2 _________ Forms3 _________ Forms4 _________ Forms5 _________ Forms6 _________ Forms7 _________ Forms8 _________ You may specify up to 4 Prmode values (logically OR'd) Prmode1 _________ Prmode2 ________ Prmode3 ________ Prmode4 _________ F1=Help F3=Exit F7=Bkwd F8=Fwd F10=Left F11=Right F12=Cancel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
- Select (/)
TPL Rules
and add the TPL rule that you have defined.
- Define a selector rule and link it to the archive attribute by
selecting the
- Save your changes and return to the list of selector rules. The top level selector rule you just defined is now eligible to process any job log generated for z/OS operations by HCL Workload Automation for Z.
- Enter the
ACT
primary command to activate your changes. The Tivoli Output Manager started task is now ready to capture the z-centric job logs.