Browsing a job log with IBM Tivoli Output Manager

If you run IBM Tivoli Output Manager Version 3.0 or later in your enterprise, you can use it to view the job logs of operations run with HCL Workload Automation for Z.

To do so, enter the Browse joblog via ITOM (LJ) command that is available in the ISPF panels where the Browse joblog (L) command is available. The panels are those related to browsing or modifying operations in the current plan; that is:
  • MODIFYING OPERATIONS IN THE CURRENT PLAN (EQQMMOPL, EQQMOPRL, and EQQMOPRR)
  • HANDLING OPERATIONS ENDED IN ERROR (EQQMEE1L, EQQMEE2L, EQQMEP1L, and EQQMEP2L)
  • LIST DEPENDENCY STATUS CHANGE (EQQMOSTL)
  • RERUNNING AN OCCURRENCE IN THE CURRENT PLAN (EQQMROCL)
  • OPERATIONS IN THE CURRENT PLAN (EQQMOPRV or EQQSRCLP)
  • OPERATION IN THE CURRENT PLAN (EQQSOPSD - Operation menu)
Attention: If Tivoli Output Manager is not installed in your system, or if it is incorrectly configured, the following message is displayed in the panel where you launched the LJ command:
CALL OF ITOM INSTANCE ITOMINST HAS FAILED.
where ITOMINST is the name of the command that starts Tivoli Output Manager in your environment.
To view a job log with Tivoli Output Manager:
  1. Enter the LJ command next to an operation listed in one of the panels mentioned above.
    The following Tivoli Output Manager window is displayed.
    Figure 1. IBM Tivoli Output Manager - Search for Archived Sysouts.
    
    
    
     IBM Tivoli Output Manager - Search for Archived Sysouts 
                                                                           
     Command ===> __________________________________________________________ 
                                                           More:           + 
     Job Name  . . . ___________                                            
      Sysout Class  . ___________________________________________            
      Archive Name  . DEVAPP 020 1311050201                            
      User ID . . . . ___________                                            
                                                                             
      Exceptions  . . ___                   (Yes, No, or blank)              
                                                                             
      After Date  . . _____________         (YYYY/MM/DD, Today, T-nnnn)      
      Before Date . . _____________         (YYYY/MM/DD, Today, T-nnnn)      
                                                                             
      After Time  . . ___________           (HH:MM:SS)                       
      Before Time . . ___________           (HH:MM:SS)                       
                                                                             
      Save criteria?  ___  (Yes/No)                                          
                                                                             
      F1=Help        F3=Exit        F7=Bkwd        F8=Fwd        F10=Left    
     F11=Right      F12=Cancel                                               
    
    
    
    
    
    where the Archive Name field shows the string that identifies the requested job log in the form application_ID operation_number input_arrival (for example, DEVAPP 020 1311050201).
  2. Press Enter.
    The next window displays all the logs available for that operation.
    Figure 2. IBM Tivoli Output Manager - Archived Sysouts.
      File    Options    Search    Help   
    
                     IBM Tivoli Output Manager - Archived sysouts            TOM301DB  
       Command ===> _____________________________________________ SCROLL ===> PAGE
                                                                                 1/2
       Cmd   Archive name                 Job Name  Job ID    Archive Time     
       ____  DEVAPP 020 1311050201        JOBSAMPL  JOB02686  2013 11/22 17:37:01
       ____  DEVAPP 020 1311050201        JOBSAMPL  JOB02685  2013 11/22 17:36:09
    
    ********************************************************************************
    
  3. There are several options for viewing a job log. The B (Browse) command is used in this example:
    Figure 3. Choosing an archived sysout for viewing.
      File    Options    Search    Help   
    
                     IBM Tivoli Output Manager - Archived sysouts            TOM301DB  
       Command ===> _____________________________________________ SCROLL ===> PAGE
                                                                                 1/2
       Cmd   Archive name                 Job Name  Job ID    Archive Time     
       _B__  DEVAPP 020 1311050201        JOBSAMPL  JOB02686  2013 11/22 17:37:01
       ____  DEVAPP 020 1311050201        JOBSAMPL  JOB02685  2013 11/22 17:36:09
    
    ********************************************************************************
    
    Entering B next to the chosen archive name and pressing Enter displays the job log as shown here:
    Figure 4. Viewing the selected job log.
      File    Options    Help   
    
    BROWSE    DEVAPP 020 1311050201 >  JOBSAMPL JOB02686 JES2 JESMSGLG    Page 1   
    Command ===> _____________________________________________ SCROLL ===> PAGE
    ************************************** Top of Data ****************************
    1                      J E S 2  J O B  L O G  --  S Y S T E M  E S 5 4 -- N O D
    0                                                                              
     17.37.00 JOB02686 ---- FRIDAY,     22 NOV 2013 ----
     17.37.00 JOB02686  IRR010I  USERID RACFID2  IS ASSIGNED TO THIS JOB.
     17.37.01 JOB02686  ICH70001I RACFID2  LAST ACCESS AT 17:36:07 ON FRIDAY, NOVEM
     17.37.01 JOB02686  $HASP373 JOBSAMPL  STARTED - INIT 4   - CLASS X - SYS ES54 
     17.37.01 JOB02686  IES403I JOBSAMPL - STARTED - TIME=17.37.01
     17.37.01 JOB02686  EQQCN00I START CLEANUP AND/OR RET-CODE SIMULATION PROCESS(E
     17.37.01 JOB02686  EQQCN18I SNUM STEPNAME PROCNAME RC
     17.37.01 JOB02686  EQQCN02I 002           S1       0000
     17.37.01 JOB02686  EQQCN99I CLEANUP AND/OR RET-CODE SIMULATION PROCESS(ES) END
     17.37.01 JOB02686  -                                         --TIMINGS (MINS.)
     17.37.01 JOB02686  -JOBNAME  STEPNAME PROCSTEP    RC   EXCP    CPU    SRB  CLO
     17.37.01 JOB02686  -JOBSAMPL EQQCLEAN EQQCLEAN    00     48    .00    .00    .
     17.37.01 JOB02686  -JOBSAMPL          S1       FLUSH      0    .00    .00    .
     17.37.01 JOB02686  CSV003I  REQUESTED MODULE IEFBR15  NOT FOUND
     17.37.01 JOB02686  CSV028I  ABEND806-04  JOBNAME=JOBSAMPL  STEPNAME=S2
     17.37.01 JOB02686  IEA995I  SYMPTOM DUMP OUTPUT  932
        932             SYSTEM COMPLETION CODE=806  REASON CODE=00000004
        932              TIME=17.37.01  SEQ=02429  CPU=0000  ASID=0032  
        932              PSW AT TIME OF ERROR  070C1000   813D7120  ILC 2  INTC 0D
        932                NO ACTIVE MODULE FOUND
        932                NAME=UNKNOWN
        932                DATA AT PSW  013D711A - 8400181E  0A0D18FB  180C181D
        932                GR 0: 00001F00   1: 84806000
     F1=Help    F3=Exit    F4=Mark    F5=Rfind   F6=Goto    F7=Up      F8=Down
    F10=Left   F11=Right  F12=Cancel
    
The integration between HCL Workload Automation for Z and Tivoli Output Manager is based on a string made up by the following data that identify an operation in HCL Workload Automation for Z:
  • Application ID
  • Operation number
  • Input arrival date and time

To set up the integration, you must complete the configuration steps described in the next sections.