Configuring by using the BJT@UX01 exit

To enable the integration between HCL Workload Automation for Z and Tivoli Output Manager, make sure that PTF UI13683 for APAR PI07423: INTEGRATION ENHANCEMENTS FOR ISPF INTERFACE is installed 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.

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:
  1. Use the BJTRXASM sample (supplied with Tivoli Output Manager) to linkedit exit BJT@UX01. The exit requires no additional customization.

    Exit BJT@UX01 drives the integration between Tivoli Output Manager and the scheduler (exit EQQUX001 is no longer used for this purpose). Its function is to locate the >TWS OCCURRENCE heading in the HCL Workload Automation for Z job log and use the string that follows (application_ID, operation_number, input_arrival) as an Output Manager archive name.

  2. Concatenate the library that contains the load module for BJT@UX01 in the steplib of the Tivoli Output Manager started task
  3. Start the Tivoli Output Manager Administrative Functions dialog in ISPF and enter A (Archive attributes).
  4. 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 
  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  5. Go back to the Administrative Functions dialog and enter S (Selector rules). Then:
    1. Define a selector rule and link it to the archive attribute by selecting the Link action bar choice.
    2. Set the status to Enabled.
    3. Specify the HCL Workload Automation for Z SYSOUT classes that are to be processed by IBM Tivoli Output Manager.
    4. Select (/) Processing Options.
    For example:
    Figure 2. IBM Tivoli Output Manager - Defining a selector rule and linking it to the archive attribute.
      File  Link   Help   
  _________________________________________________________________________________

                      IBM Tivoli Output Manager - Selector Rule       
   Command ===> ___________________________________________________________________
                                                                         More:    +
      Selector Name . STR                 
       Status . . . . Enabled  
       Archive Attr:  STR
      Selection criteria
       SYSOUT Class  . CDEQ                                 
       Destination   . _______________________
       Writer  . . . . ___________
       Forms   . . . . ___________
       Job Type  . . . All   
       JES Queue   . . All   

    _   Advanced Selection criteria
    /   Processing Options
    _   TPL Rules                                                      

     F1=Help     F3=Exit     F7=Bkwd     F8=Fwd     F10=Left     F11=Right     F12=Cancel 
  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  6. In the Processing options dialog, specify Yes in the Combine SYSOUT field and User exit in the Archive Name rule source field. For example:
    Figure 3. IBM Tivoli Output Manager - Specifying processing options.
      File    Help   
  _________________________________________________________________________________

                      IBM Tivoli Output Manager - Processing options       
   Command ===> ___________________________________________________________________
                                                                         More:    +
      Selector Name . STR                 
     Processing Options
       Combine SYSOUT. Yes
       Exists . . . .  Extend 
       Line Limit  . . 0          
       Page length . . 0  
       Archive Name rule source . . . . User exit  Escape Char .  $

                       Normal                Error                 Line Limit
     Disposition . .   Delete                Hold                  Hold   
     Class   . . . .   _                     _                     _ 
     Destination . .   ____________________  ____________________  ____________________
     Form. . . . . .   ________              ________              ________
     Writer. . . . .   ________              ________              ________
                                                         

     F1=Help     F3=Exit     F7=Bkwd     F8=Fwd     F10=Left     F11=Right     F12=Cancel 
  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  7. 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.
  8. 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.