Defining the Logical Environment

This section covers the following topics:


First Steps

This section contains a full description of all items that can be specified for each Entire Event Management object in the Logical Environment. An explanation of each object type is contained in the Concepts and Facilities documentation.

The Entire Event Management Logical Environment consists of the objects:

  • Message Range

  • Logical Console

  • Logical Console Layout

Start of instruction setTo begin

  • Select the object types for Environment by placing the cursor on the Environment option under the heading Administration on the Main Menu and pressing Enter.

    The Environment Menu appears.

    Environment Menu

      14:57:32               *** ENTIRE EVENT MANAGEMENT ***                16.07.06
                                   - Environment Menu -                             
                                                                                    
                                                                                    
         Physical Environment                                                       
                                                                                    
          1  ENTIRE SYSTEM SERVER Node                                              
          2  Server                                                                 
                                                                                    
                                                                                    
         Logical Environment                                                        
                                                                                    
          3  Message Range                                                          
          4  Logical Console                                                        
          5  Logical Console Layout                                                 
                                                                                    
          .  Exit                                                                   
          ?  Help                                                                   
          *  Commands                                                               
                                                                                    
                                                                                    
      Command ===> _________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip                                            Menu
    

Defining a Message Range

A Message Range is a kind of filter for the message-logging process and describes a set of messages to be displayed in a Logical Console. A Message Range is the summary of all messages which satisfy all range conditions that have been defined.

List Message Ranges

Start of instruction setTo ADD, COPY, DELETE, DISPLAY, MODIFY or RENAME a Message Range

  • Place the cursor on the Message Range option under the heading Logical Environment on the Environment Menu and press Enter.

    The List Message Range screen appears:

    List Message Range

     16:35:14               *** ENTIRE EVENT MANAGEMENT ***                16.07.06
                                 - List Message Range -
    
     Cmd Name                             R Message   Job      Console
         *_______________________________ * *________ *_______ _ *_______
     **  ************************  top of data  *************************
     __  Act-Intervention-Required          +........          I Operator
     __  Act-Reply-Messages               X +........          I Operator
     __  Inf-COMPLETE-Commands                        COMPLETE I InfCmds
     __  Inf-Performance-Class-Changes                         I InfCmds
     __  Net-CICS-Messages                  +DFH*              I Network
     __  Net-COMPLETE-Messages              ZVT*               I Network
     __  Net-VTAM-Messages                  IST*               I Network
     **  ***********************  bottom of data  ***********************
    
    
    
    
    
    
    
    
     Command ===> _________________________________________________________________
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Add   Exit  Flip  Rfind             Down                    Menu
    

    This screen lists all the Message Ranges that have already been defined.

Available Local Commands: List Message Range

Add
Down
Find
Locate
Rfind
Top

Available Line Commands: List Message Range

Line Command Explanation
CO Copy Message Range definition.
DE Delete Message Range definition.
DI Display Message Range definition.
MO Modify Message Range definition.
RN Rename Message Range definition.

Field Descriptions: List Message Range

You can use an asterisk (*) to enter selection criteria for the list contents of the fields marked with an asterisk below.

  • Cmd
    In the command line preceding the range you want to process, enter "DI" to display, "MO" to modify or "DE" to delete it. Press Enter.

  • Name *
    Name of the Message Range.

  • R *
    This is the reply indicator:

    * = list all ranges regardless of indicator

    (blank) = list only those ranges without an indicator

    X = list only those ranges with an indicator

  • Message *
    Message ID. A plus sign (+) appears, if the Message Range is defined by more than one Message ID.

  • Job *
    A plus sign (+) appears, if the Message Range is defined by more than one job.

  • Console *
    The letter in the first column under this heading indicates whether the range is linked to a Logical Console and how it is linked:

    I = linked as an Included Message Range

    X = linked as a Excluded Message Range

The names of the Logical Consoles to which the Message Ranges are linked are listed in the second column. A plus sign (+) appears, if the Message Range is linked to more than one Logical Console.

Add a Message Range

Start of instruction setTo ADD a new Message Range

  1. Press PF2 (Add).

    The Add Message Range screen appears:

    Add Message Range

     13:44:18               *** ENTIRE EVENT MANAGEMENT ***                16.07.06
                                 - Add Message Range -
    
       Name ..... ________________________________  created ...
     > Comment .. ________________________________  modified ..
    
       Representation
         Color ..... __  Prefix .. _  Attr .. _
    
       Conditions
         Replies ... _
       > Messages .. _________ __________________________________________________
                     _________ __________________________________________________
                     _________ __________________________________________________
    
         Tokens .... ____________ Pos .. __  and ____________ Pos .. __
                     ____________ Pos .. __  and ____________ Pos .. __
    
         Jobs ...... ________  or  ________  or  ________  or  ________
    
    NCL0644 Please enter Name to add Message Range.
    
     Command ===> _________________________________________________________________
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit  Flip  Do                                        Menu
    

    Available Local Commands: Add Message Range

    +Comment
    DO
    +Message

  2. Enter a name in the Name field and press Enter. You can now enter data for other fields. You can ZOOM on the >Comment and >Message fields to enter more data (see the subsection ZOOM Feature) in section Using Entire Event Management.

Field Descriptions: Add Message Range

Representation

Enter Representation parameters for all messages fulfilling the range conditions. All messages which fall into the range are displayed in the color and with the prefix and attribute you select. However, if you have defined different Representation parameters for the Included Message Range, then those parameters override your entries here. For further information on Included Message Ranges, see the subsection Defining an Included Message Range.

  • Color
    Color - Field Help
    Enter a question mark (?) in the two-character field and press Enter or place the cursor on the field and press PF1 to display the following help window:

    Color - Field Help
     14:25:42               *** ENTIRE EVENT MANAGEMENT ***                16.07.06
                                 - Add Message Range -
    
       Name ..... Inf-NETPASS-Response-Times_______  created ... 16.07.1996
     > Comment .. _________________ +---------------------------------------------+
                                    !              - Field Help -                 !
       Representation               !                                             !
         Color ..... ?_  Prefix ..  !  Sel Value/Description                      !
                                    !      ____________________________________   !
       Conditions                   !  __  BL  blue                               !
         Replies ... _              !  __  GR  green                              !
       > Messages .. _________ ____ !  __  NE  neutral                            !
                     _________ ____ !  __  PI  pink                               !
                     _________ ____ !  __  RE  red                                !
                                    !  __  TU  turquoise                          !
         Tokens .... ____________ P !  __  YE  yellow                             !
                     ____________ P !                                             !
                                    +---------------------------------------------+
         Jobs ...... ________  or  ________  or  ________  or  ________
    
    
    
     Command ===> _________________________________________________________________
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit  Flip  Do                                        Menu
    
     
    

    Place the cursor on a color and press Enter. The two-letter color code is written to the Color field.

  • Prefix
    Enter a symbol as identifying prefix.

  • Attr.
    Enter a question mark (?) in the one-character field and press Enter or place the cursor on the field and press PF1 to display the following help window:

    Attribute - Field Help

     14:25:42               *** ENTIRE EVENT MANAGEMENT ***                16.07.06
                                 - Add Message Range -
    
       Name ..... Inf-NETPASS-Response-Times_______  created ... 16.07.1996
     > Comment .. _________________ +---------------------------------------------+
                                    !              - Field Help -                 !
       Representation               !                                             !
         Color ..... YE  Prefix ..  !  Sel Value/Description                      !
                                    !      ____________________________________   !
       Conditions                   !  __  B  blinking                            !
         Replies ... _              !  __  C  cursiv/italic                       !
       > Messages .. _________ ____ !  __  D  default intensity                   !
                     _________ ____ !  __  I  intensified                         !
                     _________ ____ !  __  U  underlined                          !
                                    !  __  V  reverse video                       !
         Tokens .... ____________ P !                                             !
                     ____________ P +---------------------------------------------+
    
         Jobs ...... ________  or  ________  or  ________  or  ________
    
    
    
     Command ===> _________________________________________________________________
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit  Flip  Do                                        Menu
    

    Place the cursor on an attribute and press Enter. The one-letter attribute code is written to the Attr field.

Conditions

These conditions define the Message Range. You can use an asterisk (*) to enter selection criteria.

  • Replies
    Mark this field with an "X", if you want to focus on messages with a reply ID (i.e. requiring operator intervention).

  • Messages
    In the first field, enter the message ID that defines the range. For example, to log all messages with an IST prefix, enter IST*. An asterisk (*) represents an alphanumeric string of any length. A question mark (?) represents one character. In the second field you can enter a comment or description to identify the range.

    You can enter 3 message IDs and comments on this screen. ZOOM the Messages option to open the following window in which you can enter more message IDs and comments:

    Zoom Messages

     14:30:50               *** ENTIRE EVENT MANAGEMENT ***                16.07.06
                                 - Add Message Range -
    
       Name ..... Inf-NETPASS-Response-Times_______  created ... 16.07.1996
     > Comment  -------------------------------------------------------------------
                !                        - Zoom Messages -                        !
       Represen ! Message   Comment                                               !
         Color  ! _________ __________________________________________________    !
                ! ********* ************** top of data ***********************    !
       Conditio ! _________ __________________________________________________    !
         Replie ! _________ __________________________________________________    !
       > Messag ! _________ __________________________________________________    !
                ! _________ __________________________________________________    !
                ! _________ __________________________________________________    !
                ! _________ __________________________________________________    !
         Tokens ! _________ __________________________________________________    !
                ! _________ __________________________________________________    !
                ! _________ __________________________________________________    !
         Jobs . ! _________ __________________________________________________    !
                -------------------------------------------------------------------
    
    
     Command ===> _________________________________________________________________
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit  Flip  Do          Up    Down                    Menu
    

    You can enter up to 42 message IDs and comments for each range.

Available Local Commands: Add Message Range - Zoom Messages

Bottom
Do
Down
Top
Up

  • Tokens / Pos.
    Enter the tokens and their position in the message. Tokens are alphanumeric strings separated by the delimiters - defined in the Server Parameters - and identified by position. For more information, see the field description Delimiters in section Defining the Physical Environment.

    When no position is specified, the message fulfills the conditions if the specified tokens appear anywhere in the message. If a position is specified, the token must appear at this position in the message. Use an asterisk (*) to enter selection criteria.

  • Jobs
    You can restrict the Message Range to the jobs you enter here. You can use an asterisk (*) to enter selection criteria. The jobs are combined with logical "or".

    When you have finished entering data, press PF5 (Do) or enter DO on the command line and press Enter. A message confirms that the new Message Range has been saved:

    New Message Range (name) created.

Copy a Message Range

Start of instruction setTo copy a Message Range

  1. On the List Message Range screen, enter CO in the two-character command line preceding the range you want to copy and press Enter.

    The Copy Message Range window opens:

  2. Enter the target range name in the field provided and press Enter.

    A message confirms that the range has been copied.

Delete a Message Range

Start of instruction setTo delete a Message Range

  1. On the List Message Range screen, enter DE in the two-character command line preceding the range you want to delete and press Enter. Depending on the confirmation level, you may be asked to confirm by entering "Y" (yes) or "N" (no) or by typing the range name again.

  2. Make the appropriate entry in the field provided and press Enter.

    A message confirms that the range has been deleted.

Display a Message Range

Start of instruction setTo display a Message Range

  • On the List Message Range screen, enter DI in the two-character command line preceding the range you want to display and press Enter. In DISPLAY mode you can only view the object parameters. You cannot enter data because all fields are protected.

    The Display Message Range screen appears.

    In DISPLAY mode you can only view the object parameters. You cannot enter data because all fields are protected.

Modify a Message Range

Start of instruction setTo modify a Message Range

  • On the List Message Range screen, enter MO in the two-character command line preceding the range you want to modify and press Enter.

    The Modify Message Range screen appears.

    Proceed as described in the subsection Add a Message Range.

Rename a Message Range

Start of instruction setTo rename a Message Range

  1. On the List Message Range screen, enter RN in the two-character command line preceding the range you want to rename and press Enter.

    The Rename Message Range window opens.

  2. Enter the new range name in the field provided and press Enter.

    A message confirms that the range has been renamed.

Defining a Logical Console

A Logical Console provides a selective view of logged messages and is defined by a set of Included Message Ranges combined by logical OR and by a set of Excluded Message Ranges.

Start of instruction setTo activate a Logical Console

List Logical Consoles

Start of instruction setTo ADD, COPY, DELETE, DISPLAY, MODIFY or RENAME a Logical Console

  • Place the cursor on the Logical Console option under the heading Logical Environment on the Environment Menu and press Enter.

    The List Logical Console screen appears:

    List Logical Console

     09:27:14               *** ENTIRE EVENT MANAGEMENT ***                16.07.06
                                - List Logical Console -
    
     Cmd Console  Aut Layout   M A from  to     Life Time
         *_______ ___ *_______ * * _____ _____  __________
     **  *****************  top of data  ******************
     __  Adabas       Default  X   00:00 23:59
     __  All          Default  X   00:00 23:59
     __  Automate  X  Default  X X 00:00 23:59
     __  Availabl     Default  X   00:00 23:59
     __  Common    X  Default  X X 00:00 23:59
     __  Complete     Default  X   00:00 23:59
     __  Frozen       Frozen   X   00:00 23:59
     __  Network      Default  X   00:00 23:59
     __  Security     Default  X   00:00 23:59  1   WEEKS
     __  Test      X             X 00:00 23:59
     **  ***************  bottom of data  *****************
    
    
    
    
     Command ===> _________________________________________________________________
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Add   Exit  Flip  Rfind             Down                    Menu
    

    This screen lists all Logical Consoles that have already been defined.

Available Local Commands: List Logical Console

Add
Down
Find
Locate
Rfind
Top

Available Line Commands: List Logical Console

Line Command Explanation
CO Copy Logicial Console definition.
DE Delete Logicial Console definition.
DI Display Logicial Console definition.
MO Modify Logicial Console definition.
RN Rename Logicial Console definition.

Field Descriptions: List Logical Console

  • Cmd
    In the command line preceding the console you want to process, enter DI to display, MO to modify or DE to delete it. Press Enter.

  • Console
    Names of Logical Consoles which have already been defined. In the field marked with an asterisk (*) directly below Console at the top of the list, you can enter selection criteria for consoles to be listed. Use an asterisk to enter selection criteria.

  • Aut
    An "X" appears in this column, if Automation Rules are defined for the Logical Console.

  • Layout
    Names of the Logical Console Layouts assigned to the consoles.

  • M
    An "X" in this column means that message logging is active for that console. If blank, logging is not active. Enter an "X" in the field at the top directly below "M", to list only consoles with message logging active. Enter an asterisk (*) in the field at the top, to list all consoles. Leave the field blank to list only consoles with message logging not active. Press Enter after making your entry.

  • A
    An "X" in this column means that automation is active for that console. If blank, automation is not active. Enter an "X" in the field at the top directly below "A", to list only consoles with automation active. Enter an asterisk (*) in the field at the top, to list all consoles. Leave the field blank to list only consoles with automation not active. Press Enter after making your entry.

  • from ... to
    The console is active during these times. This means that message logging and automation are possible only during these times.

  • Life Time
    Message lifetime for the console. The message exists in the console for this length of time.

Add a Logical Console

Start of instruction setTo ADD a Logical Console

  1. Press PF2 (Add).

    The Add Logical Console screen appears:

    Add Logical Console

     09:36:27               *** ENTIRE EVENT MANAGEMENT ***                16.07.06
                                - Add Logical Console -
    
       Name ..... ________                         created ...
     > Comment .. ________________________________ modified ..
    
       Life Time .. ___  ________                  Layout .... ________
    
       Message Logging      Automation             Calendar .. __________
         Active ... _         Active ..... _       Analyzed .. 00:00 to 00:00
    
     > Excluded Message Ranges
    
     > Included Message Ranges
         Name ....... ________________________________
         Priority ... __     Frozen ..... _
         Representation
           Color .... __     Prefix ..... _  Attr .. _
    
    
    NCL0644 Please enter Name to add Logical Console.
     Command ===> _________________________________________________________________
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help        Exit  Flip  Do                                        Menu
    

    Available Local Commands: Add Logical Console

    +Comment
    Do
    +ExcRnge
    +IncRnge

  2. Enter a name in the Name field and press Enter.

    The Select Message Range window opens on the right:

    Add Logical Console - Select Message Range

      16:39:23               *** ENTIRE EVENT MANAGEMENT ***                16.07.06
                                 - Add Logical Console -                            
                                                                                    
        Name ..... InfResp_                         created ...                     
      > Comment .. ______________________ ------------------------------------------
                                          !        - Select Message Range -        !
        Life Time .. ___  ________        !                                        !
                                          ! Sel Name                               !
        Message Logging      Automation   !     *_______________________________   !
          Active ... _         Active ... ! **  ********  top of data  *********   !
                                          ! __  ---------Execute                   !
      > Excluded Message Ranges           ! __  Adabas---All                       !
                                          ! __  Adabas---Automation                !
      > Included Message Ranges           ! __  Adabas---Jobs                      !
          Name ....... __________________ ! __  Adabas---Suppressed                !
          Priority ... ___    Frozen .... ! __  CICS-----All                       !
          Representation                  ! __  ComplCmd-All                       !
            Color .... __     Prefix .... ! __  Complete-All                       !
                                          ! __  Complete-Commands                  !
                                          ------------------------------------------
     NCL0701 Please select Message Range to work with.                              
      Command ===> _________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip                    Down                    Menu
    

    This window lists all Message Ranges which have been defined.

Available Local Commands: Add Logical Console - Select Message Range

Down
Locate
Top

In the field marked with an asterisk (*) under Name you can enter selection criteria for the ranges to be listed. Use an asterisk to enter selection criteria.

Start of instruction setTo link a Message Range to the Logical Console

  1. Place the cursor on the desired Message Range and press Enter.

    The name of the Message Range you select is written to the Included Message Ranges Name field.

  2. You can now enter data for the remaining fields. ZOOM on the Comment field to enter more text. ZOOM on Excluded Message Ranges and Included Message Ranges to enter the ranges to be linked to the Logical Console (see the subsection ZOOM Feature in section Using Entire Event Management).

Field Descriptions: Add Logical Console

  • Name
    Enter a name for the Logical Console you are creating.

  • Life Time
    Enter the message lifetime for the console. The lifetime defines how long a message is stored in the Logging Database for the Logical Console. When you enter a number in the first field, an active Help window opens with four options: DAYS, WEEKS, MONTHS, YEARS. Select an option with the cursor and press Enter.

  • Layout
    Enter the name of the Logical Console Layout for this console. The layout you select determines how data is displayed in this Logical Console. Enter an asterisk (*) and press Enter to display the Select Logical Console Layout window with the names of all the layouts that have already been defined:

Add Logical Console - Select Logical Console Layout

  16:41:38               *** ENTIRE EVENT MANAGEMENT ***                16.07.06
                             - Add Logical Console -                            
                                                                                
    Name ..... InfResp_                         created ...                     
  > Comment .. ______________________ ------------------------------------------
                                      !   - Select Logical Console Layout -    !
    Life Time .. ___  ________        !                                        !
                                      ! Sel Name                               !
    Message Logging      Automation   !     *_______________________________   !
      Active ... X         Active ... ! **  ********  top of data  *********   !
                                      ! __  Adabas                             !
  > Excluded Message Ranges           ! __  CICS                               !
                                      ! __  ComplCmd                           !
  > Included Message Ranges           ! __  Complete                           !
      Name ....... Adabas---Jobs_____ ! __  Netpass                            !
      Priority ... ___    Frozen .... ! __  Network                            !
      Representation                  ! __  Operator                           !
        Color .... __     Prefix .... ! __  Process                            !
                                      ! __  Security                           !
                                      ------------------------------------------
 NCL0701 Please select Logical Console Layout to work with.                     
  Command ===> _________________________________________________________________
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help        Exit  Flip                    Down                    Menu

Available Local Commands: Add Logical Console - Select Logical Console Layout

Down
Locate
Top

  • Place the cursor on the desired layout and press Enter

The name of the layout you select is written to this field. For more information, see the subsection Defining a Logical Console Layout.

Field Descriptions: Add Logical Console - cont.

  • Message Logging Active
    If you leave this field blank, no message logging occurs. Enter "X" to activate message logging. See also the immediately following subsection Message Logging and Automation.

  • Automation Active
    If you leave this field blank, Automation Rules are not executed. If you enter "X", Automation Rules are activated and automation results are logged to the (Autnnn) Automation Console assigned to Server nnn. See also the immediately following subsection Message Logging and Automation.

  • Calendar
    Enter the name of a Calendar to assign to the Logical Console. In a Calendar, you can mark the days when the Logical Console is to be inactive. For further information, see section Defining a Calendar.

  • Analyzed 00:00 to 00:00
    Enter the time interval during which the Logical Console becomes active. During the time interval you enter here, the Server analyzes the definitions of this Logical Console for the logging and automation process.

Message Logging and Automation

  1. To activate MESSAGE LOGGING ONLY, mark Message Logging with an "X". Leave Automation blank. All messages which satisfy range conditions for this console are displayed. No Automation Rules are executed and consequently Events are not logged to the (Autnnn) Console.

  2. To activate AUTOMATION WITHOUT MESSAGE LOGGING, mark Automation with an "X". Leave Message Logging blank. No messages are displayed in this console. Automation Rules are executed. Events are logged to the (Autnnn) Console.

  3. To activate BOTH MESSAGE LOGGING AND AUTOMATION, mark Message Logging and Automation with an "X" (active). All messages which satisfy the range conditions are displayed in and logged to this console. Automation Rules are executed. Events are logged to the (Autnnn) console.

Copy a Logical Console

Start of instruction setTo copy a logical console

  1. On the List Logical Console screen, enter CO in the two-character command line preceding the console you want to copy and press Enter.

    The Copy Logical Console window opens:

  2. Enter the target console name in the field provided and press Enter.

    A message confirms that the console has been copied.

Delete a Logical Console

Start of instruction setTo delete a logical console

  1. On the List Logical Console screen, enter DE in the two-character command line preceding the console you want to delete and press Enter. Depending on the confirmation level, you may be asked to confirm by entering "Y" (yes) or "N" (no) or by typing the console name again.

  2. Make the appropriate entry in the field provided and press Enter.

    A message confirms that the console has been deleted.

Display a Logical Console

Start of instruction setTo display a Logical Console

  • On the List Logical Console screen, enter DI in the two-character command line preceding the console you want to display and press Enter.

    The Display Logical Console screen appears.

    In DISPLAY mode you can only view the object parameters. You cannot enter data because all fields are protected.

Modify a Logical Console

Start of instruction setTo modify a Logical Console

  • On the List Logical Console screen, enter MO in the two-character command line preceding the console you want to modify and press Enter.

    The Modify Logical Console screen appears.

    Proceed as described in the subsection Add a Logical Console.

Rename a Logical Console

Start of instruction setTo rename a Logical Console

  1. On the List Logical Console screen, enter RN in the two-character command line preceding the console you want to rename and press Enter.

    The Rename Logical Console window opens:

  2. Enter the new console name in the field provided and press Enter.

    A message confirms that the console has been renamed

Defining an Excluded Message Range

An Excluded Message Range is a Message Range that is excluded from logging and display in a Logical Console. Messages which satisfy the filter conditions of an Excluded Message Range do not trigger any Automation Rule defined for the Logical Console. You can add any number of ranges to the Logical Console for suppression.

Add an Excluded Message Range

Start of instruction setTo ADD an Excluded Message Range

  1. Place the cursor on the Excluded Message Ranges option and press Enter.

    The List Excluded Message Range window opens:

    Add Logical Console - List Excluded Message Range

      16:43:20               *** ENTIRE EVENT MANAGEMENT ***                16.07.06
                                 - Add Logical Console -                            
                                                                                    
        Name ..... InfResp_                         created ... 16.07.1996          
      > Comment .. ______________________ ------------------------------------------
                                          !    - List Excluded Message Range -     !
        Life Time .. ___  ________        !                                        !
                                          ! Sel Name                               !
        Message Logging      Automation   !     *_______________________________   !
          Active ... X         Active ... ! **  ********  top of data  *********   !
                                          ! **  *******  bottom of data  *******   !
      > Excluded Message Ranges           !                                        !
                                          !                                        !
      > Included Message Ranges           !                                        !
          Name ....... Adabas---Jobs_____ !                                        !
          Priority ... ___    Frozen .... !                                        !
          Representation                  !                                        !
            Color .... __     Prefix .... !                                        !
                                          !                                        !
                                          ------------------------------------------
     NCL0641 No objects for Excluded Message Range defined.                         
      Command ===> _________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Add   Exit  Flip  Rfind             Down                    Menu
    

    Available Local Commands: Add Logical Console - List Excluded Message Range

    Add
    Down
    Find
    Locate
    Rfind
    Top

    This window lists all Excluded Message Ranges which have been added to the Logical Console. If no Excluded Message Ranges are linked to the console, this message appears at the bottom of your screen:

    No objects for Excluded Message Range defined.
  2. Press PF2 (Add).

    The Link Message Range window opens:

    Excluded Message Ranges - Link Message Range

      16:43:20               *** ENTIRE EVENT MANAGEMENT ***                16.07.06
                                 - Add Logical Console -                            
                                                                                    
        Name ..... InfResp_                         created ... 16.07.1996          
      > Comment .. ______________________ ------------------------------------------
                                          !         - Link Message Range -         !
        Life Time .. ___  ________        !                                        !
                                          ! Sel Name                               !
        Message Logging      Automation   !     *_______________________________   !
          Active ... X         Active ... ! **  ********  top of data  *********   !
                                          ! __  ---------Execute                   !
      > Excluded Message Ranges           ! __  Adabas---All                       !
                                          ! __  Adabas---Automation                !
      > Included Message Ranges           ! __  Adabas---Suppressed                !
          Name ....... Adabas---Jobs_____ ! __  CICS-----All                       !
          Priority ... ___    Frozen .... ! __  ComplCmd-All                       !
          Representation                  ! __  Complete-All                       !
            Color .... __     Prefix .... ! __  Complete-Commands                  !
                                          ! __  Complete-IEF                       !
                                          ------------------------------------------
     NCL0701 Please select Message Range to link.                                   
      Command ===> _________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip                    Down                    Menu
    

    Available Local Commands: Excluded Message Range - Link Message Range

    Down
    Locate
    Top

    This window lists all Message Ranges which have not been linked to the Excluded Message Ranges or the Included Message Ranges in this Logical Console.

  3. Place the cursor on a range you want to suppress and press Enter.

    The name of the range you selected is written to the List Excluded Message Range window and the following message confirms that the range has been added to the Logical Console:

    New Excluded Message Range (name) created.

Delete an Excluded Message Range

Start of instruction setTo delete an Excluded Message Range

  1. Place the cursor on the Excluded Message Ranges option on the Add/Modify Logical Console screen and press Enter.

    The List Excluded Message Range window opens.

  2. Enter DE in the two-character command field preceding the range you want to delete and press Enter.

    The following message confirms that the range has been deleted:

    Deletion of Excluded Message Range (name) successful.

Defining an Included Message Range

An Included Message Range is a Message Range linked to a Logical Console. The messages of an Included Message Range are logged to and displayed in the Logical Console, if they do not match the conditions defined for Excluded Message Ranges (see the subsection Defining an Excluded Message Range).

  • You can add any number of Message Ranges to a console. The name of the Message Range displayed in the Name field under the Included Message Ranges option is only the FIRST range linked to the console. This is the range you selected to begin creating the Logical Console.

  • If there are more Included Message Ranges, the plus sign (+) preceding Included MessageRanges is highlighted. To list all ranges linked to the Logical Console, place the cursor on the Included Message Ranges option and press Enter.

Field Descriptions: Included Message Ranges

  • Name
    The name of the first Message Range of the set of Included Message Ranges which defines the Logical Console. This is the range you selected to create the console.

  • Priority
    Enter a number to define the representation priority of all messages in the Included Message Range. If a message satisfies conditions of more than one Included Message Range of the Logical Console, it is displayed with the representation parameters of the range with the highest priority.

    The higher the number, the higher the priority. For example, if range "AB" has a priority of 10, range "BC" has a priority of 5 and the message "B" satisfies conditions of both ranges, then message "B" assumes representation parameters and priority of range "AB".

  • Frozen
    Enter "X" here to assign the attribute frozen to all included messages. Frozen messages remain on the Logical Console screen until released by the operator.

Representation

The representation parameters you enter here are for all messages from the Included Message Range, i.e. this Message Range linked to this Logical Console. These messages are displayed in the color and with the prefix and attribute you select.

The entries you make here have the highest priority. You can leave these fields blank, but if you do enter parameters here, they override any representation parameters you defined for the Message Range itself (see the subsection Defining a Message Range).

  • Color
    Enter a question mark (?) in the two-character field and press Enter or place the cursor on the field and press PF1 to display the Color Help window with the following options:

    Color Abbreviation Explanation
    BL blue
    GR green
    NE neutral
    PI pink
    RE red
    TU turquoise
    YE yellow

    Place the cursor on a color and press Enter. The two-letter color code is written to the Color field.

  • Prefix
    Enter a character as identifying prefix.

  • Attr.
    Enter a question mark (?) in the one-character field and press Enter or place the cursor on the field and press PF1 to display a Help window with the following options:

    Color Abbreviation Explanation
    B blinking
    C cursive/italic
    D default intensity
    I intensified
    U underlined
    V reverse video

    Place the cursor on an attribute and press Enter. The one-letter attribute code is written to the Attr field.

List Included Message Ranges

Start of instruction setTo LIST all ranges linked to the Logical Console, DISPLAY or MODIFY parameters for all Included Message Ranges, to DELETE an Included Range or ADD a new range

  • Place the cursor on the Included Message Ranges option and press Enter.

    The List Included Message Range screen appears:

    List Included Message Range

      16:44:26               *** ENTIRE EVENT MANAGEMENT ***                16.07.06
                                 - Add Logical Console -                            
                                                                                    
        Name ..... InfResp_                         created ... 16.07.1996          
      > Comment  -------------------------------------------------------------------
                 !                - List Included Message Range -                  !
        Life Tim ! Cmd Message Range                    Prio Repres                !
                 !     *_______________________________  ___ __ _ _ ______________ !
        Message  ! **  *********************  top of data  *********************   !
          Active ! __  Adabas---Jobs                                               !
                 ! **  *******************  bottom of data  ********************   !
      > Excluded !                                                                 !
                 !                                                                 !
      > Included !                                                                 !
          Name . !                                                                 !
          Priori !                                                                 !
          Repres !                                                                 !
            Colo !                                                                 !
                 !                                                                 !
                 -------------------------------------------------------------------
                                                                                    
      Command ===> _________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Add   Exit  Flip  Rfind             Down                    Menu
    

Available Local Commands: List Included Message Ranges

Add
Down
Find
Locate
Rfind
Top

Field Descriptions: List Included Message Ranges

  • Cmd
    In the command line preceding the link you want to process, enter DI to display, MO to modify or DE to delete it. Press Enter.

  • Message Range
    Names of the Message Ranges linked to the Logical Console. In the field marked with an asterisk (*) at the top of the list you can enter selection criteria for ranges to be listed. Use an asterisk to enter selection criteria.

  • Prio
    Priority of Included Message Range (see the field description Priority under the heading Field Descriptions: Included Message Ranges in the subsection Defining an Included Message Range).

  • Repres
    Representation parameters of Included Message Ranges.

Add an Included Message Range

Start of instruction setTo ADD an Included Message Range

  1. Press PF2 (Add).

    The Link Message Range window opens on the right with a list of all Message Ranges which have not yet been added to this Logical Console:

    List Included Message Range - Link Message Range

      16:44:26               *** ENTIRE EVENT MANAGEMENT ***                16.07.06
                                 - Add Logical Console -                            
                                                                                    
        Name ..... InfResp_                         created ... 16.07.1996          
      > Comment  ------------------------ ------------------------------------------
                 !                - List  !         - Link Message Range -         !
        Life Tim ! Cmd Message Range      !                                        !
                 !     *_________________ ! Sel Name                               !
        Message  ! **  ****************** !     *_______________________________   !
          Active ! __  Adabas---Jobs      ! **  ********  top of data  *********   !
                 ! **  ****************** ! __  ---------Execute                   !
      > Excluded !                        ! __  Adabas---All                       !
                 !                        ! __  Adabas---Automation                !
      > Included !                        ! __  Adabas---Suppressed                !
          Name . !                        ! __  CICS-----All                       !
          Priori !                        ! __  ComplCmd-All                       !
          Repres !                        ! __  Complete-All                       !
            Colo !                        ! __  Complete-Commands                  !
                 !                        ! __  Complete-IEF                       !
                 ------------------------ ------------------------------------------
     NCL0701 Please select Message Range to link.                                   
      Command ===> _________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip                    Down                    Menu
    

    Available Local Commands: List Included Message Ranges - Link Message Range

    Down
    Locate
    Top

    In the field marked with an asterisk (*) under Name you can enter selection criteria for the ranges to be listed. Use an asterisk to enter selection criteria.

  2. Select a Message Range to add to the Logical Console by placing the cursor on the desired Message Range and pressing Enter.

    The Add Included Message Range window opens:

    Add Included Message Range

      16:44:26               *** ENTIRE EVENT MANAGEMENT ***                16.07.06
                                 - Add Logical Console -                            
                                                                                    
        Name ..... InfResp_                         created ... 16.07.1996          
      > Comment  -------------------------------------------------------------------
                 !                 - Add Included Message Range -                  !
        Life Tim !                                                                 !
                 !   Name ..... Adabas---All____________________ created           !
        Message  ! > Comment .. ________________________________ modified          !
          Active !                                                                 !
                 !   Priority .... ___                                             !
      > Excluded !                                                                 !
                 !   Frozen ...... _                                               !
      > Included !                                                                 !
          Name . !   Representation                                                !
          Priori !     Color ..... __ Prefix .. _ Attr .. _                        !
          Repres !                                                                 !
            Colo !                                                                 !
                 !                                                                 !
                 -------------------------------------------------------------------
                                                                                    
      Command ===> _________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip  Do                                        Menu
    

    Available Local Commands: Add Included Message Range

    +Comment
    Do

    Field Descriptions: Add Included Message Range

    See the heading Field Descriptions: Included Message Ranges in the subsection Defining an Included Message Range.

  3. Press PF5 (Do) or enter DO in the command line and press Enter to create the new Included Message Range.

    The following message confirms creation:

    New Included Message Range (name) created.

Display an Included Message Range

Start of instruction setTo DISPLAY an Included Message Range

  • On the List Included Message Range screen, enter DI in the two-character command line preceding the range you want to display and press Enter.

    The Display Included Message Range screen appears.

    In DISPLAY mode you can only view the object parameters. You cannot enter data because all fields are protected.

Modify an Included Message Range

Start of instruction setTo MODIFY an Included Message Range

  • On the List Included Message Range screen, enter MO in the two-character command line preceding the range you want to modify and press Enter.

    The Modify Included Message Range screen appears.

    Proceed as described in the subsection Add an Included Message Range.

Delete an Included Message Range

Start of instruction setTo DELETE an Included Message Range

  1. On the List Included Message Range screen, enter DE in the two-character command line preceding the range you want to delete and press Enter. Depending on the confirmation level, you may be asked to confirm by entering "Y" (yes) or "N" (no) or by typing the range name again.

  2. Make the appropriate entry in the field provided and press Enter.

    A message confirms that the range has been deleted.

Defining a Logical Console Layout

A Logical Console Layout contains parameters that determine how Logical Console data is displayed on your terminal screen. You can define a Logical Console Layout to display the most important information from the messages in a Logical Console. Any number of layouts can be defined and any layout can be assigned to any Logical Console.

List Logical Console Layouts

Start of instruction setTo ADD, COPY, DELETE, DISPLAY, MODIFY or RENAME a Logical Console Layout

  • Place the cursor on the Logical Console Layout option under the heading Logical Environment on the Environment Menu and press Enter.

    The List Logical Console Layout screen appears:

    List Logical Console Layout

    12:16:04           *** ENTIRE EVENT MANAGEMENT ***                    06-09-26
                             - List Logical Console Layout -
    
      Cmd Name     Comment
          *_______ ________________________________
      **  *************  top of data  *************
      __  hka-test
      __  hkaold
      __  new
      __  NoSplit
      __  SAG_Oper Layout used for Operator Console
      __  Split
      __  Split-2
      __  uksjulay
      **  ***********  bottom of data  ************
    
    
    
    
    
    
      Command ===> _________________________________________________________________
       Add      Down     Locate   Top      Find     Rfind
       Bar      Cancel   Exit     Flip     Help     Keys     Menu     Quit     Tech
    

    This screen lists all Logical Console Layouts that have already been defined.

Available Local Commands: List Logical Console Layout

Add
Down
Find
Locate
Rfind
Top

Available Line Commands: List Logical Console Layout

Line Command Explanation
CO Copy Logical Console Layout.
DE Delete Logical Console Layout.
DI Display Logical Console Layout.
MO Modify Logical Console Layout.
RN Rename Logical Console Layout.

Field Descriptions: List Logical Console Layout

  • Cmd
    In the command line preceding the layout you want to process, enter DI to display, MO to modify or DE to delete it. Press Enter.

  • Name
    The name of the Logical Console Layout. You can enter selection criteria for the layout name. Use an asterisk (*) to enter selection criteria.

  • Comment
    A short comment or description of the layout.

Add a Logical Console Layout

Start of instruction setTo ADD Logical Console Layout

  1. Press PF2 (Add).

    The Add Logical Console Layout screen appears:

    Add Logical Console Layout

    12:18:33           *** ENTIRE EVENT MANAGEMENT ***                    06-09-26
                              - Add Logical Console Layout -
    
        Name ..... ________                         created ...
      > Comment .. ________________________________ modified ..
    
        Seq Attribute       Leng   Seq Attribute       Leng    Break Lines
        ___ _______________ ____   ___ _______________ ____
        __  Date            __8    __  JobName         __8       Top of day .... _
        __  Time            _10    __  JobID           __8       Frozen Msg .... _
        __  Message Text    180    __  JType           __8
        __  MsgID           __9    __  ReplyID         __8
        __  Category        _32    __  Frozen
        __  Severity               __  Priority
        __  SrceNode        _32    __  Prefix
        __  SrceAppl        _32    __  Automation
        __  Range           __8
        __  Srv
    
    
     NCL0644 Please enter name to add Logical Console Layout.
      Command ===> _________________________________________________________________
      +Comment  Do
       Bar      Cancel   Exit     Flip     Help     Keys     Menu     Quit     Tech
    

    Available Local Commands: Add Logical Console Layout

    +Comment
    Do

  2. Enter a name in the Name field and press Enter. You can now enter data for the other fields. You can ZOOM on the Comment field to enter more data (see the subsection ZOOM Feature in section Using Entire Event Management).

    Field Descriptions: Add Logical Console Layout

    • Seq
      Your entries here determine in which order message attributes are displayed in the Logical Console. For example, enter "1" after Range to display range data in column 1, enter "2" after Message to display message data in column 2, etc.

    • Leng
      This is the number of characters for the attribute on the Logical Console screen. For example, enter "50" after Message to display the first 50 characters of the message, enter "8" after Date to display the full date, etc.

    • Attribute
      Enter a column sequence number in the Seq field and a line length in the Leng field to display these message attributes in the Logical Console:

      • Date
        The arrival date of the message.

      • Time
        The arrival time of the message.

        To display only hours and minutes, enter "5" in the Length column.

        To display hours, minutes and seconds, enter "8".

        To display hours, minutes, seconds and 1/10 seconds, enter "11".

      • Message Text
        The message text with its ID.

      • MsgID
        The message ID.

      • Category
        Category of events forwarded via the API. Defaults: Leng 8

      • Severity
        Severity of events forwarded via the API.

      • SrceNode
        Network node where the message originated. Defaults: Seq 1, Leng 8.

      • SrceAppl
        Application where the message originated. Defaults: Leng 8.

      • Range
        The Message Range which is owner of the message.

      • Srv
        The number of the Server which has logged the message.

      • JobName
        The job that issued the message.

      • JobID
        The job number of the job that issued the message.

      • JType
        The type of job that issued the message. Defaults: Leng 3.

      • Reply ID
        This is the reply ID for messages requiring an operator reply.

      • Frozen
        This attribute is displayed with an "X" in the Logical Console.

      • Priority
        The message priority as assigned by the Included Message Range of the Logical Console.

      • Prefix
        The prefix as defined in the Included Message Range of the Logical Con-sole and in the Message Range itself. This is a one-byte character that distinguishes the message from others.

      • Automation
        E = The message has triggered an Event.

        F = Execution of the related Automation Rule has failed.

    • Break Lines
      Enter an "X" to display the following break lines in the Logical Console.

      • Frozen Msg
        ********** frozen messages **********

      • Top of day
        ****** top of DD/MM/YY *******

  3. When you have finished entering data on the Add Logical Console Layout screen, press PF5 (Do) or enter DO on the command line and press Enter.

    The following message confirms creation of the new Logical Console Layout:

    New Logical Console Layout (name) created.

Copy a Logical Console Layout

Start of instruction setTo COPY a Logical Console Layout

  1. On the List Logical Console Layout screen, enter "CO" in the two-character command line preceding the layout you want to copy and press Enter.

    The Copy Logical Console Layout window opens:

  2. Enter the target layout name in the field provided and press Enter.

    A message confirms that the layout has been copied.

Delete a Logical Console Layout

Start of instruction setTo DELETE a Logical Console Layout

  1. On the List Logical Console Layout screen, enter DE in the two-character command line preceding the layout you want to delete and press Enter. Depending on the confirmation level, you may be asked to confirm by entering "Y" (yes) or "N" (no) or by typing the layout name again.

  2. Make the appropriate entry in the field provided and press Enter.

    A message confirms that the layout has been deleted.

Display a Logical Console Layout

Start of instruction setTo DISPLAY a Logical Console Layout

  • On the List Logical Console Layout screen, enter DI in the two-character command line preceding the layout you want to display and press Enter.

    The Display Logical Console Layout screen appears.

    In DISPLAY mode you can only view the object parameters. You cannot enter data because all fields are protected.

Modify a Logical Console Layout

Start of instruction setTo MODIFY a Logical Console Layout

  • On the List Logical Console Layout screen, enter MO in the two-character command line preceding the layout you want to modify and press Enter.

    The Modify Logical Console Layout screen appears.

    Proceed as described in the subsection Add a Logical Console Layout.

Rename a Logical Console Layout

Start of instruction setTo RENAME a Logical Console Layout

  1. On the List Logical Console Layout screen, enter RN in the two-character command line preceding the layout you want to rename and press Enter.

    The Rename Logical Console Layout window opens:

  2. Enter the new layout name in the field provided and press Enter.

    A message confirms that the layout has been renamed.