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.

This document covers the following topics:

Related Topic:


Displaying Logged Information

Entire Operations logs all important system events. Additionally, more detailed user-defined logs are available at the job level. These must be specified for the job in the job definition.

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.

    A System Log screen similar to the example below appears:

      Entire Operations System Log ---------------------------------Columns 014 088
     ====>                                                       Scroll====> PAGE  
     M User ID  Owner      Network    Job          Run Date  Time       Message    
       TASK 3   INCIDENT   I5033788A1             6585 20.01 00:00:33.8 Activation 
       TASK 3   INCIDENT   I5033788A1             6585 20.01 00:00:33.8 Awaiting S 
       TASK 1   EXAMPLE    E52-LOGRES             4556 20.01 00:00:33.8 ... Owner  
       TASK 1   EXAMPLE    E52-LOGRES             4556 20.01 00:00:33.8 ... Run 45 
       TASK 1   EXAMPLE    E52-LOGRES             4556 20.01 00:00:33.8 ... networ 
       TASK 3   INCIDENT   I5033788A1             6586 20.01 00:00:33.8 Activation 
       TASK 3   INCIDENT   I5033788A1             6586 20.01 00:00:33.8 No Network 
       TASK 1   EXAMPLE    E52-LOGRES             4556 20.01 00:00:33.8 List of ac 
       TASK 3   INCIDENT   I5033788A1             6586 20.01 00:00:33.8 Activation 
       TASK 1   EXAMPLE    E52-LOGRES             4556 20.01 00:00:33.8 Determined 
       TASK 1   EXAMPLE    E52-LOGRES             4556 20.01 00:00:33.8 ... Ob  Jo 
       TASK 1   EXAMPLE    E52-LOGRES             4556 20.01 00:00:33.8 ... NV     
       TASK 3   INCIDENT   I5033788A1             6586 20.01 00:00:33.8 Awaiting S 
       TASK 1   EXAMPLE    E52-LOGRES             4556 20.01 00:00:33.8 ... JM     
       TASK 3   INCIDENT   I5033788A1             6587 20.01 00:00:33.9 Activation 
       TASK 3   INCIDENT   I5033788A1             6587 20.01 00:00:33.9 No Network 
       TASK 3   INCIDENT   I5033788A1             6587 20.01 00:00:33.9 Activation 
       TASK 3   INCIDENT   I5033788A1             6587 20.01 00:00:33.9 Awaiting S 
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        End   Refre Rfind       Up    Down        Left  Right Curso
      Entire Operations System Log ---------------------------------Columns 054 128
     ====>                                                       Scroll====> PAGE  
     M     Run Date  Time       Message                                            
       ************************* top of data ************************************* 
          1060 17.11 00:00:00.0 Network to be started on 17.11 at 00:00            
           131 17.11 00:00:00.0 Network to be started on 17.11 at 00:00            
          1390 17.11 00:00:00.0 Network to be started on 17.11 at 00:00            
          1959 17.11 00:00:16.1 Activation in Progress                             
          1959 17.11 00:00:16.3 Network to be started on 17.11 at 01:00            
          1959 17.11 00:00:16.3 Network activation performed                       
           131 17.11 00:00:36.9 Job ready to submit                                
           131 17.11 00:00:37.0 Job ready to submit                                
          1390 17.11 00:00:37.0 Job ready to submit                                
          1959 17.11 00:00:37.4 Prerequisite Check begins                          
          1959 17.11 00:00:37.4 Start Time 17.11 01:00                             
           492 17.11 00:00:42.3 Activation with Default Version                    
           492 17.11 00:00:42.3 No Network Versions                                
           492 17.11 00:00:42.3 Activation Network 22.11 13:00                     
           492 17.11 00:00:42.3 Awaiting Symbol Table Activation                   
          2611 17.11 00:00:43.2 Activation with Default Version                    
          2611 17.11 00:00:43.2 No Network Versions                                
          2611 17.11 00:00:43.3 Activation Network 22.11 06:20                     
          2611 17.11 00:00:43.3 Awaiting Symbol Table Activation                   
           131 17.11 00:00:58.3 Dummy Job terminated                               
           131 17.11 00:00:58.3 Network: First job JOB1 started                    
           131 17.11 00:00:58.3 Dummy Job (Schedule) terminated                    
          1390 17.11 00:00:58.4 Dummy Job terminated                               
          1390 17.11 00:00:58.4 Network: First job JOB1 started                    
           131 17.11 00:01:16.4 Network ended ok                                   
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        End   Refre Rfind       Up    Down        Left  Right Curso

    The above screen is an example of a system log using the "display all" option for the current date (blank selection criteria).

Fields: Log Display Selection

The Log Display Selection screen provides the following input fields:

Field Description
Log Date ... Thru The date (or a start date) for which the log entries are selected. Default is the current date and 00:00:00 for time in the format HH:MM:SS.

See also Date and Time Formats.

Log Time ... Thru The time (or a start time) for which the log entries are selected. Default is the current date and the current time in the format HH:MM:SS.

See also Date and Time Formats.

Max. Lines  The maximum number of lines in the log display.

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  Enter name of the owner whose log is to be displayed. Enter asterisk * and press ENTER to select owner from a list. Leave blank to select log of all owners.
Network  Enter name of the network whose log is to be displayed. Enter asterisk * and press ENTER to select network from a list. Leave blank to select log of all networks.
Run ... Thru  Enter run number range to be displayed. Can be used only if owner and network have been selected. Default: 1-9999 (all).
Job  Enter name of the job whose log is to be displayed. Enter asterisk * and press ENTER to select job from a list. Leave blank to select log of all jobs.
User  Enter the user ID for which the log is to be displayed. To display the log for the Monitor, enter the name of the Monitor task.

Enter an asterisk * and press ENTER to define a group of users. A selection window does not open. To select the log of all users, either leave this field empty or enter only an asterisk *.

Column Headings: System Log

The System Log screen contains the following columns:

Column Description
Overtype the asterisk (*) in this field with any character to display more specialized information as defined for the job by the user. For more information see the subsection User-defined Log.
User ID User ID as defined in host TP environment.
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: System Log

Use the following Editor commands to browse the Log:

Command Description
BOTTOM  Scroll down to the last Log message at bottom of list.
FIND Find a string. FIND 'TASK 1', for example, finds the next occurrence of the string TASK 1.
LEFT  Scroll left in the list. LEFT 5, for example, scrolls 5 columns to the left.
RIGHT  Scroll right in the list. RIGHT 5, for example, scrolls 5 columns to the right.
TOP  Scroll up to the first Log message at the top of the list.

PF Keys: System Log

Use the following PF keys to browse the Log:

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).

Extended Log

An asterisk (*) in the M column of any job means that a more specialized extended log is available according to the specifications made in the original job definition.

Start of instruction set To display the extended log

  1. Type over the asterisk * in the M column of the selected job on the System Log screen with a non-blank character. Press ENTER.

    The extended log appears.

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

Types of Extended Log

The following types of extended log are available:

  • JCL log
    If (in the Job Maintenance facility) you specified JCL logging, the JCL of the job run selected from the System Log screen is displayed in Editor format, 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, the SYSOUT of the job run selected from the System Log screen is displayed in Editor format, browse mode;

  • Operating system messages
    If you specified operating system messages to be logged according to the criteria defined in the Job Maintenance facility, the messages of the job run selected from the System Log screen are displayed in Editor format, browse mode.

    In later versions of NOP, more types of extended log may be added.

  • Active JCL modifications
    If you specified to log the changes made to an active/pregenerated JCL using the corresponding option described in Default Setting (2) (Administration documentation), the changes are visible in detail in the extended logging 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 the name of your Entire Operations library, usually SYSEOR.

    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 when 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 Job Display in the Messages and Codes documentation.