Log Information

Entire Operations logs all important system events. You can view logs specific to an owner, network or job and specify selection criteria for the log report to be produced.

You can also use the monitoring function to observe all activities currently running in your Entire Operations environment.

The default system log displays information about activities in the system as a whole such as user actions, date and time of events and messages about events. If more information is available for any item on the system log, it is preceded by an asterisk (*). Log information at the job level can be any of the following:

  • JCL log
    Displays the JCL of a specific job run;

  • SYSOUT log
    Displays the SYSOUT of a specific job run;

  • System message log
    Displays all operating system messages about jobs. The system log displays the first of these messages. You can select a job from the system log to display all system messages for that job.

A selection window asks you to select the default log according to owner, network, job and run number.

This document covers the following topics:

Related Topic:


Displaying Logged Information

Start of instruction set To display all logged information

  1. Select the Log Information option from the Main Menu.

    A Log Display Selection screen similar to the example below appears:

     27.10.08               ***** Entire Operations *****                    16:51:08
                                  Log Display Selection
     -------------------------------------------------------------------------------
    
    
         Log Date ==> 27.10.08 Thru ==> 27.10.08    Max. Lines ==> _______
         Log Time ==> 00:00:00 Thru ==> 19:00:00
    
    
            Owner ==> __________                  * Select   Blank All
    
          Network ==> __________                  * Select   Blank All
    
              Run ==> 1____    Thru ==> 99999
    
              Job ==> __________                  * Select   Blank All
    
    
             User ==> ________                    * Select   Blank all
    
      Command => ____________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        End                                                   Menu

    You can specify the date range, owner, network, run number range, job name and user ID for which to display log information. The fields are explained in Fields: Log Display Selection.

  2. Enter the selection criteria for the desired log information. Press ENTER.

    An Entire Operations System Log screen similar to the example below appears:

      Entire Operations System Log ---------------------------------Columns 001 088
     ====>                                                       Scroll====> PAGE  
     M User ID  Owner      Network    Job          Run Date  Time       Message    
       ************************* top of data ************************************* 
       TASK 7   SAGTST     N1168A     JOB-21      1757 19.07 00:00:28.8 Ended ok  
     * TASK 7   SAGTST     N1168A     JOB-21      1757 19.07 00:00:29.0 SYSOUT of 
     * TASK 7   SAGTST     N1168A     JOB-21      1757 19.07 00:00:29.1 JCL of Job
       TASK 1   SAGTST     N1574A001              1526 19.07 00:00:29.1 Activation
       TASK 1   SAGTST     N1574A001              1526 19.07 00:00:29.1 No Network
       TASK 1   SAGTST     N1574A001              1526 19.07 00:00:29.1 Activation
       TASK 1   SAGTST     N1574A001              1526 19.07 00:00:29.1 Awaiting S
       TASK 7   SAGTST     N1168A     JOB-22      1757 19.07 00:00:29.2 Ended ok  
       TASK 1   SAGTST     N1574A002              1590 19.07 00:00:29.2 Activation
       TASK 1   SAGTST     N1574A002              1590 19.07 00:00:29.2 No Network 
       *** Line limit 10 reached ***                                               
       *********************** bottom of data ************************************ 
                                                                                  
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        End   Refre Rfind       Up    Down        Left  Right Curso

    The example above shows the system log for the owner EXAMPLE for the current date and time, with an output limit of 10 lines set.

  3. You can choose PF11 to scroll data to the right:

      Entire Operations System Log ---------------------------------Columns 034 108
     ====>                                                       Scroll====> PAGE  
     M Network    Job          Run Date  Time       Message                        
       ************************* top of data ************************************* 
          1757 19.07 00:00:28.8 Ended ok                        
     *    1757 19.07 00:00:29.0 SYSOUT of JobId 400007 logged   
     *    1757 19.07 00:00:29.1 JCL of JobId 400007 logged      
          1526 19.07 00:00:29.1 Activation with Default Version 
          1526 19.07 00:00:29.1 No Network Versions             
          1526 19.07 00:00:29.1 Activation Network 21.07 09:00  
          1526 19.07 00:00:29.1 Awaiting Symbol Table Activation
          1757 19.07 00:00:29.2 Ended ok                        
          1590 19.07 00:00:29.2 Activation with Default Version 
          1590 19.07 00:00:29.2 No Network Versions             
    
       *********************** bottom of data ************************************ 
                                                                                   
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        End   Refre Rfind       Up    Down        Left  Right Curso

    All commands available to navigate in the log are described in Browse Commands: Entire Operations System Log and Special PF Keys: Entire Operations System Log.

    The columns on the screen are explained in Columns: Entire Operations System Log.

Fields: Log Display Selection

The Log Display Selection screen provides the following input fields:

Field/Option Description
Log Date ... Thru Start and end date for the log display.

Default: Current date.

See also Date and Time Formats.

Log Time ... Thru Start and end time for the log display.

Default: 00:00:00 (start time) and current time (end time) in the format HH:II:SS.

See also Date and Time Formats.

Max. Lines  Maximum number of lines to display in the log.

Blank (value 0) means: no limit (default).

This setting can also be specified as a default value in the user profile: see the section User Maintenance in the Administration documentation.
Owner  Name of the owner whose log is to be displayed.

Enter an asterisk (*) to select an owner from a list. Leave the field blank to display the log for all owners.

Network  Name of the network whose log is to be displayed.

Enter an asterisk (*) to select a network from a list. Leave the field blank to display the log for all networks.

Run ... Thru  Range of run numbers to be displayed in the log.

Can be used only if an owner and a network are specified.

Default: 1-9999 (all).

Job  Job whose log is to be displayed.

Enter an asterisk (*) to select a job from a list. Leave the field blank to display the log for all jobs.

User  User ID or Monitor task name (or ranges) for which the log is to be displayed.

Enter a user ID or Monitor task name (for example, TASK 1) or use asterisk (*) to specify a range (for example, TASK*). A selection window does not open.

To display the log for all users and tasks, either leave the field blank (default) or enter an asterisk only (*).

Columns: Entire Operations System Log

The Entire Operations System Log screen contains the following columns:

Column Description
Contains an asterisk (*) if extended log information is available for the job listed in this log line.

For more information, see Extended Log.

User ID User ID or Monitor task name.
Owner  Owner name in Entire Operations.
Job  Entire Operations job name.
Network  Name of the job network.
Run  Job run number.
Date  Date of log entry.

See also Date and Time Formats.

Time  Time of log entry.

See also Date and Time Formats.

Message Message text.

Depending on the default display option set (see User Definitions and Profile Settings in the Administration documentation), the message text is prefixed with a message code (if one exists), for example: EOR2260 - Network activation performed.

Browse Commands: Entire Operations System Log

You can browse the log by entering one of the following direct commands at the ====> command prompt of the Entire Operations System Log screen:

Command Description
BOTTOM  Scroll down to the last log message at bottom of list.
FIND Find a string.

Example: FIND 'TASK 1' finds the next occurrence of the string TASK 1.

Choose PF12 to return to the editor command prompt.

LEFT  Scroll left in the list.

Example: LEFT 5 scrolls 5 columns to the left.

RIGHT  Scroll right in the list.

Example: RIGHT 5 scrolls 5 columns to the right.

TOP  Scroll up to the first log message at the top of the list.

Special PF Keys: Entire Operations System Log

You can perform the following functions using these PF keys on the Entire Operations System Log screen:

PF Key Name Function
PF4  Refre  Update the screen with the most recent log messages at bottom of data.
PF5  Rfind  Find the next occurrence of the string last entered with the FIND command.
PF7  Up  Scroll list toward top of data.
PF8  Down  Scroll list toward bottom of data.
PF10  Left  Scroll left (20 characters).
PF11  Right  Scroll right (20 characters).
PF12 Curso Resets the cursor to the editor command prompt after a FIND command placed the cursor at a string found in the log.

Extended Log

Job-specific extended logs are available if specified in the job master definition: see Specifying Extended Log Information in the section Job Maintenance.

An asterisk (*) in the M column of a log item indicates that an extended log is available for the job listed in this log line.

Start of instruction set To display an extended log

  1. In an M column of the Entire Operations System Log screen, next to the job whose extended log you want to display, replace the asterisk (*) by a non-blank character and press ENTER.

    The job's extended log appears.

  2. Choose PF3 (End) to return to the system log.

Types of Extended Logs

The following types of extended logs are available:

  • JCL Log
    If you specified JCL logging in the job master definition, the JCL of the job run selected from the System Log screen is displayed in the editor (browse mode). The JCL log source is dependent upon the operating system, in which the job has run.

  • SYSOUT Log
    If you specified the job SYSOUT to be logged after job termination in the job master definition, the SYSOUT of the job run selected from the System Log screen is displayed in the editor (browse mode).

  • Operating System Messages
    If you specified operating system messages to be logged according to the criteria defined in the job master definition, the messages of the job run selected from the System Log screen are displayed in the editor (browse mode).

  • Active/Pregenerated JCL Modifications
    If you specified to log the changes made to an active/pregenerated JCL by setting the corresponding option in the Default Setting (2) (Administration documentation), JCL changes are visible in detail for the job selected from System Log screen.

Output of Log Information

Log data can be written to the Natural standard output for printing or for transfer to other programs.

The batch utility NOPLP01P serves this purpose. It must be executed in a Natural batch job. The system files of Entire Operations must be correctly assigned.

Natural Program Call

LOGON SYSEOR
NOPLP01P <P-FROM> <P-TO> <P-LANGUAGE> <P-OWNER> <P-NETWORK> <P-DBENV> <P-RUN-FROM> <P-RUN-TO> <P-JOB> <P-ACTIVE-JCL> <P-SYSOUT> <P-CHGJCL> <P-EXTLOG>
FIN

Parameters

Parameter Format Use
P-FROM  A14 Start date (with time as an option)

Formats: YYYYMMDD

YYYYMMDDHHIISS

If time is omitted, the start is at the beginning of the day.

P-TO  A14 End date (with time as an option)

Formats: YYYYMMDD

YYYYMMDDHHIISS

If time is omitted, the end is at the end of the day.

P-LANGUAGE  I04 Language code (optional)
1 English
2 German
If this parameter is omitted, the language setting from the Entire Operations defaults will be used.
P-OWNER A10 Owner range. Wildcard is allowed at the end. For all owners, use an asterisk (*).
P-NETWORK A10 Network range. Wildcard is allowed at the end. For all networks, use an asterisk (*).
P-DBENV A10 For future use. Use a hyphen (-).
P-RUN-FROM P13 Beginning of run number range. For all runs, use 1 here.
P-RUN-TO P13 End of run number range. For all runs, use 99999 here.
P-JOB A10 Job range. Wildcard is allowed at the end. For all jobs, use an asterisk (*).
P-ACTJCL A01 Y Print the active JCL too.
N Do not print the active JCL.
P-SYSOUT A01 Y Print the logged SYSOUT too.
N Do not print the logged SYSOUT.
P-CHGJCL  A01 Y Print the changes of the active JCL. In a batch report, the changes to the active JCL will be added.
N Do not print the changes of the active JCL (default).
P-EXTLOG A01 Y Print all extended logging (active JCL, SYSOUT, changes of the active JCL)
N Do not print any extended logging.

Example of a Call

LOGON SYSEOR
NOPLP01P 20081027 20081028120000 1 EXAMPLE NET* - 1 99999 * Y Y N
FIN

Outputs all log data in English from 27/10/2008 00:00:00 to 28/10/2008 12:00:00, for owner EXAMPLE, network names starting with NET, all run numbers, all jobs of these networks, with active JCL, with logged SYSOUT, without changes to the active JCL, without using the global extended logging switch.

Example of an Output

1========== Entire Operations Log - 27.10.08 00:00:00 thru 28.10.08 12:00:00 ========== Page: 6
Date Time User-ID Owner Network Run Job Code Message
27.10.08 10:22:36 TASK 1 UKSJU SCHEDDEP     7715 Network SCHEDDEP did not run on 27.10.08
27.10.08 10:22:36 TASK 1 UKSJU SCHTEST98     7715 Network SCHTEST98 did not run on 27.10.08
27.10.08 10:22:36 TASK 1 UKSJU TESTEXP     2710 Calendar WORKDAYS undefined for 2007
27.10.08 10:22:36 TASK 1 USW V-AT-VWLS     2710 Calendar K-USW undefined for 2007
27.10.08 10:22:36 TASK 1         7065 Schedules of 26 Networks extracted
27.10.08 10:22:38 TASK 1 EXAMPLE E01-CONTI 526   7370 Symbol Table EX-ST-COMN activated
27.10.08 10:22:38 TASK 1 EXAMPLE E10-PAR-01 151   7370 Symbol Table EX-ST-COMN activated
27.10.08 10:22:38 TASK 1 EXAMPLE E60-FLOW 4767   7370 Symbol Table EXAM-ST1 activated
27.10.08 10:22:39 TASK 1 GFR BS2000 714   7370 Symbol Table GFR-ST1 activated
27.10.08 10:22:39 TASK 1 GFR BS2000 714   7725 Awaiting Symbol Prompting
27.10.08 10:22:39 TASK 1 GFR BS2000 714   7725 Message Sending: No Recipient defined
27.10.08 10:22:39 TASK 1 GFR BS2000 714   2060 Symbol Prompt Request sent to SYSDBA
27.10.08 10:22:40 TASK 1 EXAMPLE E01-CONTI 526 E01-J01 1990 Time Frame Setting
27.10.08 10:22:40 TASK 1 EXAMPLE E01-CONTI 526 E01-J02 1990 Time Frame Setting
27.10.08 10:22:40 TASK 1 EXAMPLE E01-CONTI 526 E01-J03 1990 Time Frame Setting
27.10.08 10:22:40 TASK 1 EXAMPLE E01-CONTI 526 E01-J04 1990 Time Frame Setting
27.10.08 10:22:40 TASK 1 EXAMPLE E01-CONTI 526 E01-J05 1990 Time Frame Setting
27.10.08 10:22:40 TASK 1 EXAMPLE E01-CONTI 526 E01-J06 1990 Time Frame Setting
27.10.08 10:22:40 TASK 1 EXAMPLE E01-CONTI 526   2110 Network activated on 24.02 at 10:22

Monitoring Entire Operations Activities

Activity monitoring is a non-conversational display of Entire Operations events on a special terminal, for example in the computer center. Activity monitoring can be started on this terminal and can be controlled from any other terminal.

Activity monitoring is used to permanently display Entire Operations events that currently occur in your Entire Operations environment.

The following applies to the monitoring feature:

  • The activity monitoring facility receives its data from the Entire Operations log file.

  • The activity monitoring facility only displays the most important messages. Error messages and other very important messages appear highlighted.

  • The default setting displays events starting from the current time minus one hour. As the display is updated, it scrolls automatically. The start time and display refresh interval can be modified via the Control of Activity Monitoring option of the Special Functions system administration services described in the Administration documentation.

This section covers the following topics:

Viewing Entire Operations Activities

Start of instruction set To start activity monitoring and display activities

  1. At a Natural command prompt, enter the following command and press ENTER:

    LOGON library-name

    where library-name is usually the SYSEOR system library.

    When you are logged on to the specified library, enter the following at the command prompt:

    ACTIVITY

    Or:
    In an Entire Operations command line, enter the following direct command and press ENTER:

    ACTIVITY

    Activity monitoring is started, and an Entire Operations Activity Display window similar to the example below opens:

     16-09-27                ***** Entire Operations *****                17:51:37
     Owner EXAMPLE                     Main Menu                   User ID NATQA5
     ------------------------------------------------------------------------------
                                                                                   
          Main Menu                               DC Solutions                     
                                                                                   
       1  Networ +-----------------------------------------------------+ t         
       2  Active !                                                     !           
       3  Schedu !         Entire Operations Activity Display          !           
       4  Calend !                                                     !           
       5  Log In !  Query Interval (in minutes) ===> 60___             !           
       6  Symbol !                                                     !           
       7  System !  The query interval is the time span until the      !           
       8  Report !  next interruption query by the activity display.   !           
       9  Cross  !  In between, it can only be interrupted from        !           
      10  Import !  another terminal running Entire Operations.        !           
      11  Help   !                                                     !           
                 !  PF3 End                                            !           
                 !                                                     !           
                 !                                                     !           
     Command =>  +-----------------------------------------------------+ ___       
                                                                                   
                                                                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        End                                             Owner Mail

    You can modify the Query Interval (update interval) as required.

  2. Press ENTER.

    An Activity Display screen similar to the example below appears:

    05.11.08                  *** Entire Operations ***                  15:24:17
    Date 05.11.08                  Activity Display       Monitor active 15:24:12
    from 14:37:32            Display Interval 20   sec.   Next Interrupt 16:23:14
    ------------------------------------------------------------------------------
    Network    Job          Run JobId Time  Message
    UKSJUTEST1 TEST1JOB1      2  5094 14:37 Monitor Error 936 in EJA-EV-N Line 553
    UKSJUTEST1 TEST1JOB1      2  5094 14:37 Message Sending: No Recipient defined
    UKSJUTEST1 TEST1JOB1      2  5094 14:37 Monitor Task 1 Restart by NOPMET-P
    UKSJUTEST1 TEST1JOB1      2  5094 14:37 Monitor Error 936 in EJA-EV-N Line 553
    UKSJUTEST1 TEST1JOB1      2  5094 14:37 Message Sending: No Recipient defined
    UKSJUTEST1 TEST1JOB1      2  5094 14:37 Monitor Task 1 Restart by NOPMET-P
    QAN02z/OS-M                2       14:38 Message Sending: No Recipient defined
    E40-REC-01             1032  2257 14:38 Message Sending: No Recipient defined
    E40-REC-01             1033  2440 14:38 Message Sending: No Recipient defined
    E50-USRT                753       14:38 Message Sending: No Recipient defined
    E50-USRT                754       14:38 Message Sending: No Recipient defined
    E50-USRT                755       14:38 Message Sending: No Recipient defined
    E50-USRT                756       14:38 Message Sending: No Recipient defined
    E50-USRT                757       14:38 Message Sending: No Recipient defined
    E50-USRT                758       14:38 Message Sending: No Recipient defined
    SUB-1                     2       14:38 Message Sending: No Recipient defined
    SUB-1                     3       14:38 Message Sending: No Recipient defined
    *********************************** m o r e **********************************

    The Display Interval (query interval) is equivalent to the Monitor and cannot be changed.

    The fields and columns contained on the screen are described in Fields and Columns: Activity Display.

  3. When the query interval has expired and the Next Interrupt time is reached, a window similar to the example below prompts you to restart the Activity Display screen by entering Y, or end monitoring by entering N. Press ENTER.

    11.03.15                ***** Entire Operations *****                11:36:54
    Date 11.03.15                  Activity Display       Monitor active 11:36:45
    from 11:20:17            Display Interval 20   sec.   Next Interrupt 11:37:14
    ------------------------------------------------------------------------------
    Network    Job          Run JobId Time  Message                               
                                      11:20 EOR2046 - Natural Message Cache disabl
                                      11:23 EOR2045 - Natural Message Cache enable
                                      11:23 DCAGD1-P 1380 SYSNOM / MMO NSC---L Rc:
                                      11:23 NAT0807 - Logon to this library is not
                                      11:23 LG-LEV-P 790 - program stack          
                                      11:23 . 2:DCAGD1-P/1450 1:MENUEOR/2800      
                                      11:24 EOR2045 - Natural Message Cache enable
    N1459C     JOB-1      17202       11:26 Dummy Job terminated 
    N1459A     JOB-1      17223       11:30 Activation in Progress
    N1459C     JOB-1   +-------------------------------------+ ess
    N1459A     JOB-1   |                                     |                    
    N1459C     JOB-1   |    Activity Display has expired     |  1, avail. 0 of 1
    N1459A     JOB-1   |                                     | at 11:58           
    N2009A     J001    |         Restart ==> Y (Y,N)         | - Invalid User ID  
    N2009A     J001    |                                     | h
    N2009A     J001    +-------------------------------------+ L Generation Error 
    N2009A     J001          63  8465 11:30 EOR7182 - JCL Load - Invalid User ID
    *********************************** m o r e **********************************

Fields and Columns: Activity Display

The fields and columns of the Activity Display screen are described in the following table:

Field/Column Meaning
from  Date and time of the first message on the screen.

See also Date and Time Formats.

Display Interval  The time after which the display is automatically refreshed.
Monitor active  The time the Monitor was last active.
Next Interrupt  The time at which the Activity Display will be interrupted to prompt you for continuation. This is the end of the query interval specified in the Entire Operations Activity Display window.
Owner Owner of the active network.
Network  Name of the active network.
Job  Name of the active job.
Run  Run number as assigned to the active network by Entire Operations.
JobId  Job identifier as assigned by the operating system or by the job entry subsystem.
Time  Last action or check time for the job.
Message  Last message issued for the job by Entire Operations.

For a list of possible messages, see Messages in Active Jobs Lists in the Messages and Codes documentation.