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:
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:
Entire System Server Nodes
Server Parameters
Message Ranges
Logical Consoles
Logical Console Layouts
Automation Rules
Profiles
User IDs
Calendars
These are explained in the sections which follow.
You can define and maintain objects using the options on the Main Menu under the heading Administration:
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.
To begin
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:
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 |
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.
To select an object definition
For example, place the cursor on the Message Range option and press Enter.
The List Message Range screen appears:
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.
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).
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
Place the cursor on the two-character command field in the Cmd column preceding the object definition to be processed;
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.
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:
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.
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.
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.
To ADD a Message Range, for example
Press PF2 (Add) on the List Message Range screen (3).
The Add Message Range screen appears:
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 |
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
Place the cursor on the desired field and enter data.
Save your changes by pressing PF5 (Do), when finished (see the subsections DO Command and Save an Object Definition - PF5).
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.
To copy an object definition
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:
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 |
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>.
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.
To delete an object definition
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:
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 |
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.
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.
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:
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 |
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.
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.
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.
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 |
The Modify screen contains exactly the same data as the Display screen.
To MODIFY the object definition
Simply place the cursor on the desired field and enter a new value.
Save your changes by pressing PF5 (Do), when finished (see the subsections DO Command and Save an Object Definition - PF5).
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.
To rename an object definition
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:
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 |
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>.
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.
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
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:
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 |
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.
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 |
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:
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.
For a context-related Help screen, press PF1 (Help) or enter Help on the command line and press Enter.
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.
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.
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.