Defining Entire Event Management

This document is a general introduction to defining objects in Entire Event Management. An explanation of each object type is contained in the Concepts and Facilities documentation.

This document covers the following topics:

• Introduction

• Some General Information about Defining Objects

• Getting Started

• "List" Screen

• Commands for Defining Objects

• Object Definition Screens

• Other Useful Commands

Introduction

Defining Entire Event Management involves creating and maintaining the object definitions required for the physical and logical message logging environment, automatic operator responses and Authorization:

• Physical Environment

  • Entire System Server Nodes

  • Server Parameters

• Logical Environment

  • Message Ranges

  • Logical Consoles

  • Logical Console Layouts

• Automatic operator responses

  • Automation Rules

• Authorization

  • Profiles

  • User IDs

• Calendars

  • Calendars

These are explained in the sections which follow.

Some General Information about Defining Objects

You can define and maintain objects using the options on the Main Menu under the heading Administration:

Entire Event Management Main Menu

 15:38:26               *** ENTIRE EVENT MANAGEMENT ***                10.06.06
 Srv    *                        - Main Menu -


    Console Services

     1  Logical Console
     2  Server


    Administration

     3  Environment
     4  Automation
     5  Authorization
     6  Calendars

     .  Exit
     ?  Help
     *  Commands


 Command ===> _________________________________________________________________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit  Flip                                            Menu

Once Entire Event Management has been defined, it can be modified at any time by authorized Users.

The following descriptions take you through every level of the Entire Event Management menu hierarchy. Do not forget, however, that:

• there are usually several ways of issuing commands and moving through Entire Event Management;

• you can skip some of these steps by using the "option code" or direct commands.

For detailed information, see section Using Entire Event Management, especially the subsections Option Code Input and Command Input.

Getting Started

Selecting an Object Type

To begin

1. Place the cursor on an option of the Main Menu and press Enter. You can use any method described in Section Using Entire Event Management. You can select Automation Rules by placing the cursor on the Automation option and pressing Enter. When you place the cursor on the Environment or Authorization option and press Enter, a submenu appears from which you can select an object type to work with.

   Note:
   Depending on your profile settings, the menu option could also be capital letters.

   For example, place the cursor on the Environment option under the heading Administration on the Main Menu and press Enter. The Environment Menu appears:

   Environment Menu

   14:57:32 *** ENTIRE EVENT MANAGEMENT *** 17.06.06 - Environment Menu - Physical Environment 1 Entire System Server Node 2 Console 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

2. On the Environment Menu, place the cursor on the object type you want to work with and press Enter. A List screen appears listing all object definitions that have already been created for the selected object type.

"List" Screen

Selecting an Object Definition

To select an object definition

• For example, place the cursor on the Message Range option and press Enter.

  The List Message Range screen appears:

  List Message Range

  15:18:54 *** ENTIRE EVENT MANAGEMENT *** 12.06.06 - List Message Range - Cmd Name R Message Job Console *_______________________________ * *________ *_______ _ *_______ ** ************************ top of data ************************* __ Adabas---All *ADA* +....... __ Adabas---Automation +........ +....... __ Adabas---Jobs +........ +....... __ Adabas---Supressed *ADAN41 +....... __ CICS-----All *DFH* I CICS __ ComplCmd-All I ComplCmd __ Complete-All *Z* *FCO* I Complete __ Complete-Commands *FCO* I Complete __ Complete-IEF +........ *FCO* I Complete __ Exec EXECUTE +....... __ Netpass--Error NPE* I Netpass __ Netpass--Information NPI* I Netpass __ Network--All IST* I Network __ Network--Complete ZVT* I Network 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 Message Ranges that have already been defined.

  You can select any object definition on the list by entering one of the line commands in the appropriate line command input field.

  Line commands are described in the subsection Line Commands: "Cmd" Column.

  List screens for object definitions are described in more detail for each object type in the following sections.

LIST Command

This command allows you to list some or all object definitions for an object type from anywhere in Entire Event Management. You can invoke a List screen from anywhere in Entire Event Management by typing LIST followed by the object type in the command line and pressing Enter. A List screen appears listing all objects defined for the object type selected.

The list can be restricted, if you invoke it using selection criteria and an asterisk (*) (see the subsection Using Asterisk with LIST Command in section Using Entire Event Management).

Line Commands: "Cmd" Column

A List screen always contains a line command column, Cmd, in which you can enter a two-character line command.

To COPY DELETE, DISPLAY, MODIFY or RENAME an object definition displayed on a List screen

1. Place the cursor on the two-character command field in the Cmd column preceding the object definition to be processed;

2. Enter CO for COPY, DE for DELETE, DI for DISPLAY, MO for MODIFY or RN for RENAME and press Enter.

   A list and explanation of all line commands is provided in the subsection Line Commands in the Commands documentation.

Display Available Line Commands on a "List" Screen

Some List screens have additional line commands.

To display all available line commands

• Enter an asterisk (*) anywhere in the Cmd column and press Enter.

  For example, enter an asterisk in the Cmd column preceding Adabas---All on the List Message Range screen and press Enter.

  The Select Line Command window opens with a list of the available commands:

  List Message Range - Line Command Help

  15:18:54 *** ENTIRE EVENT MANAGEMENT *** 12.06.06 - List Message Range - Cmd Name R Message Job Console *____________________________ -------------------------------------------- ** ************************ top ! - Select Line Command - ! _* Adabas---All ! ! __ Adabas---Automation ! Sel Cmd Description ! __ Adabas---Jobs ! __ _______________________________ ! __ Adabas---Supressed ! ** ** ********* top of data ********* ! __ CICS-----All ! __ DI Display Message Range ! __ ComplCmd-All ! __ MO Modify Message Range ! __ Complete-All ! __ DE Delete Message Range ! __ Complete-Commands ! __ CO Copy Message Range ! __ Complete-IEF ! __ RN Rename Message Range ! __ Exec ! ** ** ******* bottom of data ******** ! __ Netpass--Error ! ! __ Netpass--Information ! ! __ Network--All ! Your Command .. _* In Line .. 2 ! __ Network--Complete -------------------------------------------- Command ===> _________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Add Exit Flip Rfind Down Menu

To issue a command

• Place the cursor on an option and press Enter.

Commands for Defining Objects

The seven commands listed below are available for defining objects. They have the following meaning:

• ADD Command (direct command and PF2):

  Create a new object definition;

• COPY Command (direct command and line command CO):

  Create a new object definition by copying an existing definition;

• DELETE Command (direct command and line command DE):

  Delete an object definition;

• DISPLAY Command (direct command and line command DI):

  Display an object definition;

• MODIFY Command (direct command and line command MO):

  Modify an object definition;

• RENAME Command (direct command and line command RN):

  Rename an object definition;

If you invoke any of the above commands from the command line without unique specification of an object name, a selection window opens. Place the cursor on the required object name and press Enter (see section Using Entire Event Management).

• DO Command (local command and PF5):

  Save new or modified object definition.

The following subsection explains the above commands in more detail.

ADD Command

The ADD command enables you to create a new object definition. Issue the ADD command as a direct command by typing ADD in the command line and pressing Enter. The other method of issuing the ADD command is to press PF2 (Add), from the appropriate List screen. In both cases, the Add screen for the selected object type appears.

Add an Object Definition - PF2

To ADD a Message Range, for example

• Press PF2 (Add) on the List Message Range screen (3).

  The Add Message Range screen appears:

  Add Message Range

  15:37:05 *** ENTIRE EVENT MANAGEMENT *** 12.06.06 - Add Message Range - Name ..... ________________________________ created ... > Comments.. ________________________________ 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

"Add" Screen

The Add, Display and Modify screens are identical except that the Add screen appears with all fields empty, whereas the Display and Modify screens contain the current definitions.

To ADD when the Add screen has appeared

1. Place the cursor on the desired field and enter data.

2. Save your changes by pressing PF5 (Do), when finished (see the subsections DO Command and Save an Object Definition - PF5).

COPY Command

The COPY command enables you to create new object definitions by copying existing definitions. Issue the COPY command as a direct command by typing COPY in the command line and pressing Enter. Issue the COPY command as a line command by typing CO in the Cmd column preceding an object definition on the appropriate List screen and pressing Enter. In both cases, the Copy window for the selected object definition appears.

Copy an Object Definition - "CO"

To copy an object definition

1. On the List Message Range screen (3), for example, if you enter CO in the Cmd column preceding Adabas---All and press Enter, the Copy Message Range window for the selected range opens:

   Copy window

   15:04:04 *** ENTIRE EVENT MANAGEMENT *** 12.06.06 - List Message Range - Cmd Name R Message Job Console *_____ ------------------------------------------------------------------- ** ****** ! - Copy Message Range - ! co Adabas ! ! __ Adabas ! Name ..... Adabas---All____________________ created 02.08.94 ! __ Adabas ! > Comment .. ________________________________ modified 09.08.94 ! __ Adabas ! ! __ CICS-- ! New Name ________________________________ ! __ ComplC ! ! __ Comple ------------------------------------------------------------------- __ Complete-Commands *FCO* I Complete __ Complete-IEF +........ *FCO* I Complete __ Exec EXECUTE +....... __ Netpass--Error NPE* I Netpass __ Netpass--Information NPI* I Netpass __ Network--All IST* I Network __ Network--Complete ZVT* I Network Command ===> _________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Flip Menu

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

   The following message confirms that the copy was successful:

   Message Range Adabas---All copied to <name of target range>.

DELETE Command

The DELETE command enables you to delete object definitions. Issue the DELETE command as a direct command by typing DELETE in the command line and pressing Enter. Issue the DELETE command as a line command by typing DE in the Cmd column preceding an object definition on the appropriate List screen and pressing Enter. In both cases, the Delete window for the selected object definition opens and you are asked to confirm deletion.

Window layout depends on the confirmation level. Level 1 requires no confirmation. Level 2 asks you to confirm by entering Y (yes) or N (no). Level 3 asks you to confirm by typing again the name of the object definition to be deleted.

Delete an Object Definition - "DE"

To delete an object definition

1. On the List Message Range screen (3), for example, enter DE in the Cmd column preceding Adabas---All and press Enter.

   The window for confirmation level 3 appears as follows:

   Delete Message Range window

   15:50:29 *** ENTIRE EVENT MANAGEMENT *** 12.06.06 - List Message Range - Cmd Name R Message Job Console *_____ ------------------------------------------------------------------- de Adabas ! - Delete Message Range - ! __ Adabas ! ! __ Adabas ! Name ..... Adabas---All____________________ created 02.08.94 ! __ Adabas ! > Comment .. ________________________________ modified 09.08.94 ! __ CICS-- ! ! __ ComplC ! ! __ Comple ! ! __ Comple ! ! __ Comple ! ! __ Exec ! Please confirm deletion ! __ Netpas ! of Message Range with its ! __ Netpas ! Name ..... ________________________________ ! __ Networ ! ! __ Networ ! ! ** ****** ------------------------------------------------------------------- Command ===> _________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Flip Menu

2. Type the range name again in the field provided and press Enter.

   The following message confirms deletion:

   Deletion of Message Range Adabas---All successful.

For more information on the confirmation level for delete, see the entry for Delete Confirmation Level under the heading Field Descriptions: Set Session Parameters.

DISPLAY Command

The DISPLAY command enables you to display object definitions which have already been created. Issue the DISPLAY command as a direct command by typing DISPLAY in the command line and pressing Enter. Issue the DISPLAY command as a line command by typing DI in the Cmd column preceding an object definition on the appropriate List screen and pressing Enter. In both cases, the Display screen for the selected object definition appears.

Display an Object Definition - "DI"

To display an object definition

• On the List Message Range screen (3), for example, if you enter DI in the Cmd column preceding Adabas---All and press Enter, the Display Message Range screen for the selected range appears:

  Display Message Range

  15:43:06 *** ENTIRE EVENT MANAGEMENT *** 12.06.06 - Display Message Range - Name ..... Adabas---All____________________ created ... 02.08.1994 > Comments.. ________________________________ modified .. 09.08.1994 Representation Color ..... __ Prefix .. _ Attr .. _ Conditions Replies ... _ > Messages .. *ADA*____ __________________________________________________ _________ __________________________________________________ _________ __________________________________________________ Tokens .... ____________ Pos .. __ and ____________ Pos .. __ ____________ Pos .. __ and ____________ Pos .. __ Jobs ...... ________ or ________ or ________ or ________ Command ===> _________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Flip Menu

"Display" Screen

The Display screen contains the current object definition, but you can only view the data. You cannot enter or modify data, because all fields are protected.

MODIFY Command

The MODIFY command enables you to modify object definitions which have already been created (ADDed). Issue the MODIFY command as a direct command by typing MODIFY in the command line and pressing Enter. Issue the MODIFY command as a line command by typing MO in the Cmd column preceding an object definition on the appropriate List screen and pressing Enter. In both cases, the Modify screen for the selected object definition appears.

Modify an Object Definition - "MO"

To modify an object definition

• On the List Message Range screen (3), for example, if you enter MO in the Cmd column preceding Adabas---All and press Enter, the Modify Message Range screen for the selected range appears.

  Modify Message Range

  15:44:18 *** ENTIRE EVENT MANAGEMENT *** 12.06.06 - Modify Message Range - Name ..... Adabas---All____________________ created ... 02.08.1994 > Comments.. ________________________________ modified .. 09.08.1994 Representation Color ..... __ Prefix .. _ Attr .. _ Conditions Replies ... _ > Messages .. *ADA*____ __________________________________________________ _________ __________________________________________________ _________ __________________________________________________ Tokens .... ____________ Pos .. __ and ____________ Pos .. __ ____________ Pos .. __ and ____________ Pos .. __ Jobs ...... ________ or ________ or ________ or ________ Command ===> _________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Flip Do Menu

"Modify" Screen

The Modify screen contains exactly the same data as the Display screen.

To MODIFY the object definition

1. Simply place the cursor on the desired field and enter a new value.

2. Save your changes by pressing PF5 (Do), when finished (see the subsections DO Command and Save an Object Definition - PF5).

RENAME Command

The RENAME command enables you to change object names. Issue the RENAME command as a direct command by typing RENAME in the command line and pressing Enter. Issue the RENAME command as a line command by typing RN in the Cmd column preceding an object definition on the appropriate List screen and pressing Enter. In both cases, the Rename window for the selected object definition appears.

Rename an Object Definition - "RN"

To rename an object definition

1. On the List Message Range screen (3), for example, if you enter RN in the Cmd column preceding Adabas---All and press Enter, the Rename Message Range window for the selected range opens:

   Rename window

   15:09:15 *** ENTIRE EVENT MANAGEMENT *** 12.06.06 - List Message Range - Cmd Name R Message Job Console *_____ ------------------------------------------------------------------- ** ****** ! - Rename Message Range - ! rn Adabas ! ! __ Adabas ! Name ..... Adabas---All____________________ created 02.08.94 ! __ Adabas ! > Comment .. ________________________________ modified 09.08.94 ! __ Adabas ! ! __ CICS-- ! New Name ________________________________ ! __ ComplC ! ! __ Comple ------------------------------------------------------------------- __ Complete-Commands *FCO* I Complete __ Complete-IEF +........ *FCO* I Complete __ Exec EXECUTE +....... __ Netpass--Error NPE* I Netpass __ Netpass--Information NPI* I Netpass __ Network--All IST* I Network __ Network--Complete ZVT* I Network Command ===> _________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Exit Flip Menu

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

   The following message confirms that the rename was successful:

   Message Range Adabas
   ---All renamed to <new name>.
    

DO Command

The DO command enables you to save a new or modified object definition. Issue the DO command as a local command by typing DO in the command line of the object definition screen of the object definition you want to save and pressing Enter. The other method of issuing the DO command is to press PF5 (Do) while in the object definition screen. In both cases, the new or modified object definition is saved.

Save an Object Definition - PF5

To save a new or modified object definition

• Proceed as described above.

To return to the previous screen or window after saving or to exit without saving

1. Either press PF3 (Exit), or enter EXIT on the command line and press Enter.

   If you have made modifications, but have not saved them, and attempt to leave an Add or Modify screen, either by ZOOMing an option or by exiting to a previous screen:

   If data you have entered on the current screen are consistent with existing data, a window opens with three options:

   Ignore/Resume Modifications window

   11:37:29 *** ENTIRE EVENT MANAGEMENT *** 06-09-26 - Modify Server Parameter - Server ... 114 F-Mc . created ... 01.03.1994 > Comment .. __________ --------------------------- ed .. 24.09.1996 ! You want to leave this ! Logical Console .... ! screen but your modifi- ! LAPI__ UKSJUC-1 UKSJUC-2 ! cations are not saved. ! G_COMC SAG_ESY_ SAG_DBA_ ! ! G_SECU SAG_XCMD SJUTREE_ ! __ Resume to correct ! ______ ________ ________ ! __ Ignore modifications ! ______ ________ ________ ! __ Save modifications ! Log DBID/FNR ....... --------------------------- ressed Messages ET Threshold ....... _1 Msg or __1 MIN Delimiters ......... ,=;()_____ + Automation Parameters Collect Wait Time .. __1 SEC + Installation Backup File Msgid Exit ......... YMSGID__ Init. Exit ......... YINIT___ + Miscellaneous Command ===> _________________________________________________________________ +Auto +Comment +InsFile +Misc +SuprMsg Do Bar Cancel Exit Flip Help Keys Menu Quit Tech

2. Select Save Modifications to save changes made, Ignore Modifications to discard any changes made or Resume to resume working. Select an option by marking it with any character and pressing Enter.

   If data you have entered on the current screen are not consistent with existing data, a window opens with two options:

   Select Ignore Modification to discard any changes made or Resume to correct to resume working and correct the inconsistent data.

3. Select an option by marking it with any character and pressing Enter.

   11:37:29 *** ENTIRE EVENT MANAGEMENT *** 06-09-26 - Modify Server Parameter - Server ... 114 F-Mc . created ... 01.03.1994 > Comment .. __________ --------------------------- ed .. 24.09.1996 ! You want to leave this ! Logical Console .... ! screen but your modifi- ! LAPI__ UKSJUC-1 UKSJUC-2 ! cations are not saved. ! G_COMC SAG_ESY_ SAG_DBA_ ! ! G_SECU SAG_XCMD SJUTREE_ ! __ Resume to correct ! ______ ________ ________ ! __ Ignore modifications ! ______ ________ ________ --------------------------- Log DBID/FNR ....... __9 _79 (NCLSYSF3) + Suppressed Messages ET Threshold ....... _1 Msg or __1 MIN Delimiters ......... ,=;()_____ + Automation Parameters Collect Wait Time .. __1 SEC + Installation Backup File Msgid Exit ......... YMSGID__ Init. Exit ......... YINIT___ + Miscellaneous Command ===> _________________________________________________________________ +Auto +Comment +InsFile +Misc +SuprMsg Do Bar Cancel Exit Flip Help Keys Menu Quit Tech

Object Definition Screens

An Add, Display or Modify screen is referred to as an "object definition screen". The following fields appear on most object definition screens:

• Name
  This is an input field for the object name. You can enter names using upper or lower case characters, but when translated to upper case, each name must be unique. For example, a name entered as "ISTlog" is identical to "istLOG" or "ISTLOG". You cannot use asterisks (*) or blanks in object names. The first character of the name must be a letter and cannot be a number.

• Comment
  You can enter a comment about the object definition. The length of a comment is always 32 bytes. You can enter up to 10 lines of comment by ZOOMing the Comment option. The Comment window opens:

Comment window

 14:30:59               *** ENTIRE EVENT MANAGEMENT ***                09.06.06
                            - Modify Message Range -

   Name ..... Act-Intervention-Required_______  created ... 06.04.1990
 > Comment .. ______________________ ------------------------------------------
                                     !              - Comment -               !
   Representation                    !                                        !
     Color ..... __  Prefix .. _  At !    ________________________________    !
                                     !    ________________________________    !
   Conditions                        !    ________________________________    !
     Replies ... _                   !    ________________________________    !
   > Messages .. .HASP050_ JES resou !    ________________________________    !
                 .HASP190_ Setup for !    ________________________________    !
                 IEA994E__ Dump Data !    ________________________________    !
                                     !    ________________________________    !
     Tokens .... ____________ Pos .. !    ________________________________    !
                 ____________ Pos .. !    ________________________________    !
                                     !                                        !
     Jobs ...... ________  or  _____ !                                        !
                                     ------------------------------------------


 Command ===> _________________________________________________________________
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        Exit  Flip  Do                                        Menu
 

Enter your text and press Enter. Press PF3 (Exit) to return to the object definition screen. See the subsection ZOOM Feature in section Using Entire Event Management for an explanation of how to ZOOM.

• created
  Date when the object definition was created.

• modified
  Date when the last version of the object definition was saved.

Other Useful Commands

Help - PF1

For a context-related Help screen, press PF1 (Help) or enter Help on the command line and press Enter.

Exit - PF3

To return to the previous screen or window after saving or to Exit without saving

• Either press PF3 (Exit), or enter Exit on the command line and press Enter.

Return to Object Definition Screen

To return to the object definition screen of the main owner-object, if you have opened more than one window

• Enter Cancel in the command line and press Enter. If you have opened only one window or no window, Cancel is the same as Exit.

Return to Main Menu - PF12

To return to the Main Menu from anywhere in Entire Event Management

• Either press PF12(Menu), or enter Menu on the command line and press Enter.

For more details on PF Keys and other methods of moving through Entire Event Management, see section Using Entire Event Management.