Configuring by using the TPL rules

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.

To configure Tivoli Output Manager to capture the logs (sysouts in Tivoli Output Manager terminology) of z/OS operations run by HCL Workload Automation for Z, 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
  match ".*>< 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 classes that are to be processed by Tivoli Output Manager. 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 Jobs               
       Status . . . . Enabled   
       Archive Attr:  ZWS
      Selection criteria
       SYSOUT Class  . E                                   
       Destination   . _______________________
       Writer  . . . . ___________
       Forms   . . . . ___________
       Job Type  . . . Batch 
       JES Queue   . . All   

    _   Advanced Selection criteria
    _   Processing Options
    _   TPL Rules                                                      

     F1=Help     F3=Exit     F7=Bkwd     F8=Fwd     F10=Left     F11=Right     F12=Cancel 
  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Define a sub-selector by entering the ss command next to the selector you have just defined, 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 classes that are to be processed by Tivoli Output Manager. For example:

Figure 3. IBM Tivoli Output Manager - Defining a sub-selector rule.

  File  Link   Help   
  _________________________________________________________________________________

                      IBM Tivoli Output Manager - Subselector Rule       
   Command ===> ___________________________________________________________________
                                                                         
   Subelector . . JESDS                  Parent EQQ Jobs
   Status . . . . Enabled                       Enabled
   Archive Attr . STR                           STR
   Selection criteria                       From parent
     Parent SYSOUT . E
     SYSOUT Class  . E
     Job Type  . . . Batch             Batch 
     Job Name  . . . _________
     Destination   . _____            
     Form  . . . . . __________

     Writer  . . . . __________
     Archive name  . __________________________________         

    _   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 Step Name to JES2, DD Name to JES*, and JES Queue to All, as follows:

Figure 4. IBM Tivoli Output Manager - Specifying advanced options for the sub-selector.

  File    Help   
  _________________________________________________________________________________

                      IBM Tivoli Output Manager - Advanced Selection       
   Command ===> ___________________________________________________________________
                                                                         More:    +
   Subselector . . JESDS                  Parent EQQ Jobs

   Selection criteria                            From parent 
     Job Class  . .  ________________________________________ 
     Proc Step Name. ________
     Step Name . . . JES2____
     DDName. . . . . JES*____
     JES Queue  . .  All     
     User Id . . . . ________
     Prmode  . . . . ________
     FCB  . ____   
     UCS  . ____ 
     Flash . . . . . _____
     
     Account1 _________  Account2 _________  Account3 _________   
     Account4 _________  Account5 _________  Account6 _________   
     Account7 _________  Account8 _________     
     Programmer Name ______________________

     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.
If you want to continue to have the z/OS job logs processed into the HCL Workload Automation for Z data store, proceed to Configuring IBM Tivoli Output Manager for data store.
Otherwise, enter the ACT primary command to activate your changes. The Tivoli Output Manager started task is now ready to capture the z/OS job logs.