Working with Mailboxes

Mailboxes are used for sending messages to Entire Operations users. The messages are triggered by either system-detected or user-defined events.

If a message requires a reply, it is prompted on the Mailbox - Messages and Requests screen. You can then take appropriate steps and manually set the conditions necessary for the job to continue.

Several message destination types can be defined. Among them is the sending of e-mails on z/OS and z/VSE, BS2000 and UNIX and Windows systems.

Optionally, you can use a global exit for message sending. This exit detects all messages that must be sent for various reasons by the Entire Operations Monitor. The exit can store the message content in files and forward the message to other applications, etc.

This document covers the following topics:

• Concept of Single or Multiple Mailbox Users

• Listing and Maintaining Mailboxes

• Viewing Mailbox Messages

• Handling Messages and Requests

Related Topics:

• Defining Notification Messages - Job Maintenance

• Mailbox Definition - Administration documentation

• Mailboxes, Message Sending - Concepts and Facilities documentation (general information including example scenarios)

Concept of Single or Multiple Mailbox Users

A mailbox can be available to one or more users which are linked to the mailbox (see also the Mailboxes field described in User Definition and Profile Settings in the Administration documentation).

All users linked to a mailbox have access to the same range of messages and requests. If a message or request of this mailbox is handled by any of these users, the Entire Operations Monitor triggers all jobs waiting for actions and the message handled by the user disappears from the message list for all other users linked to the mailbox.

SYSDBA Mailbox

All generated messages and requests, for which no user is defined, are sent to the SYSDBA mailbox, which is accessible to the owner SYSDBA.

For an example illustration of single or multiple mailbox use, see Example Scenario - Concept of Single and Multiple Mailbox Users in the Concepts and Facilities documentation.

Listing and Maintaining Mailboxes

This section covers the following topics:

• Listing Mailboxes

• Creating, Modifying and Deleting Mailboxes

• Turning Automatic Mail Notifications On and Off

• Clearing of Mailboxes

Listing Mailboxes

You can list all mailboxes defined in your environment and view their contents depending on the access rights set in the Mailbox Definitions of your user profile (see Administration Functions in the Administration documentation).

To list all mailboxes available in your environment

• Proceed as described in Listing Mailboxes defined to Entire Operations in the Administration documentation.

Creating, Modifying and Deleting Mailboxes

You can only create, change and delete a mailbox if you have appropriate access rights set in the Mailbox Definitions of your user profile (see Administration Functions in the Administration documentation).

For details on defining mailboxes, see Mailbox Definition in the Administration documentation.

Turning Automatic Mail Notifications On and Off

The notification You have Mail is turned on by default.

However, you can turn the notification on and off during the current session.

To turn automatic notifications on and off

• Use the direct command SET as described in the Direct Commands documentation.

Clearing of Mailboxes

Mailbox entries are cleared in accordance with the maximum length of time specified in the Entire Operations default settings for long-term logging. For further information, see the Long-Term Log option described in Default Setting (1) in the Administration documentation.

Viewing Mailbox Messages

The message You have mail notifies you of mailbox requests.

If a mailbox assigned to you has any entries, this message appears in the top left-hand corner of your screen:

EOR1500 - You have Mail                                                        
 17-02-17                ***** Entire Operations *****                18:03:01 
 Owner SAGTEST                     Main Menu                   User ID SAGTEST 
 ------------------------------------------------------------------------------
                                                                               
      Main Menu                               DC Solutions                     
                                                                               
   1  Network and Job Maintenance         20  ENTIRE Output Management         
   2  Active Job Networks                 21  NATURAL ISPF                     
   3  Schedule Maintenance                                                     
   4  Calendar Maintenance                                                     
   5  Log Information                                                          
   6  Symbol Tables                                                            
   7  System Administrator Services                                            
   8  Reports                                                                  
   9  Cross-References                                                         
  10  Import/Export                                                            
  11  Help                                                                     
                                                                               
                                                                               
                                                                               
 Command => ____________________________________________________________       
                                                                               
                                                                               
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
      Help        End                                             Owner Mail

If you want to turn this notification off, proceed as described in Turning Automatic Notifications On and Off.

To view the messages for a mailbox

1. Type MAIL in the command line or choose PF12 (Mail) on the Main Menu.

   The MAIL direct command is described in the Direct Commands documentation.

2. Press ENTER.

   A Mailbox - Messages and Requests screen similar to the example below appears:

   02.07.19 ***** Entire Operations ***** 15:58:26 User SAG Mailbox - Messages and Requests ------------------------------------------------------------------------------ Cmd Date Time Mailbox Owner Network Run Job 02.07 00:00 ---------- ---------- *--------- ----- ---------- _ 26.06 01:02 SYSDBA Network not terminated - no deactivation ==> INCIDENT / I1044152A / 767 _ 26.06 01:02 SYSDBA Network not terminated - no deactivation ==> INCIDENT / I1044152A / 766 _ 26.06 01:02 SYSDBA Network not terminated - no deactivation ==> INCIDENT / I1044152A / 765 _ 26.06 01:02 SYSDBA Network not terminated - no deactivation ==> INCIDENT / I1044152A / 764 _ 26.06 00:01 SYSDBA Symbol Prompting AH Run 70 (OVER START TIME) _ 26.06 00:01 SYSDBA Symbol Prompting SYNCRIGADE Run 16907 (OVER START TI _ 26.06 00:01 SYSDBA Symbol Prompting SYNCRIGADE Run 16906 (OVER START TI _ 26.06 00:01 SYSDBA Symbol Prompting SYNCRIGADE Run 16905 (OVER START TI *********************************** m o r e ********************************** Sequence : D (A/D) Mark lines with any character for specific actions. Command => ____________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help End Save Up Down Menu

   The table view is filled dynamically with data if scrolled to the end of the table.

   All messages and requests of all mailboxes to which the current Entire Operations user (owner at logon) is linked are listed in the table.

The screen columns and input fields provided to change the display and filter the messages are described in Fields and Columns: Messages and Requests.

The messages and requests listed on the screen and the functions you can perform on them are described in Handling Mailbox Messages and Requests.

This section covers the following topics:

• Fields and Columns: Messages and Requests

• Special PF Keys: Messages and Requests

Fields and Columns: Messages and Requests

The fields and columns provided on the Mailbox - Messages and Requests screen are described in the following table:

Special PF Keys: Messages and Requests

This following special PF keys are available to navigate in the Mailbox - Messages and Requests screen:

Handling Messages and Requests

You can perform message-specific actions on the messages and requests listed on the Mailbox - Messages and Requests screen, such as symbol prompting, setting a condition or removing a message.

The action (delete, set or prompt operations) you can perform on a selected message depends on the type of message you select from the message list and the permissions you are granted in your Entire Operations user profile. The types of messages that can be shown are listed in the following table. The numbers in the example messages denote the job run numbers.

Messages on which actions are performed are removed for all users linked to the respective mailbox.

To perform an action on a message or request

• On the Mailbox - Messages and Requests screen, in the Cmd input field next to the required message, enter any character and press ENTER.

• Performing Symbol Prompting

Performing Symbol Prompting

To perform symbol prompting

1. On the Mailbox - Messages and Requests screen, in the Cmd input field next to a message requesting symbol prompting, enter any character and press ENTER.

   A Symbol Prompting for Table screen appears where you can view, add, modify or deactivate the symbol(s) defined for the network indicated in the message.

   Proceed as described in Symbol Prompting during Network or Job Activation in the section Symbol Table and Symbol Maintenance.

2. A message requesting symbol prompting usually displays the time until the next network start (in hours). However, if the network has exceeded its start time, the message says OVER START TIME.

   If this is the case, a window prompts you to enter a new start time or cancel the activation:

   +--------------------------------------------------------------------+ | | | Owner XSETAA Network AH Run 70 | | | | The planned start time was in the past ==> 28.06.19 00:00 | | You can enter a new start time ==> 28.06.19 00:00 | | | | or deactivate the activation with PF6 | | | | PF3 End PF6 Deactivate | +--------------------------------------------------------------------+

3. Enter a new start time and press ENTER.

   Any symbol changes are saved and the window closes.

   The new start time is entered as the earliest start time in all active network jobs.

   Or:
   Choose PF6 (Deactivate) to cancel the active run of the specified network.

   A window prompts you to confirm the deactivation.