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 Guide
```
when
  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 enter S (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 to All. 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.

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.