Mailboxes

#### Search Results

Search

# 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 like 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:

Column/Field | Description
--- | ---
Cmd | Line command input field to execute message-specific actions as described in Handling Mailbox Messages and Request.
Date/Time | Date and time when the message was sent. In the input field below these column headings, you can enter a start date and time. Enter an asterisk (`*`) for the current date. See also Date and Time Formats.
Mailbox | Mailbox to which the message was sent. Preselection is possible.
Sequence | Sort order of the message list. Valid input values:
`A` | Ascending order. Earliest messages come first.
`D` | Descending order. Latest messages come first.
Owner | Name of the owner. In the input field below this column heading, you can enter a name or specify a range of names to filter the list: see Specifying Filter Criteria. Asterisk (*) selects all names (default).
Network | Name of the network. In the input field below this column heading, you can enter a name or specify a range of names to filter the list: see Specifying Filter Criteria. Asterisk (*) selects all names (default).
Run | Number of the run. In the input field below this column heading, you can enter the run number for which to show the messges.
Job | Name of the job. In the input field below this column heading, you can enter a name or specify a range of names to filter the list: see Specifying Filter Criteria. Asterisk (*) selects all names (default).
description | Message text. For possible messages, see the message types described in Handling Mailbox Messages and Requests.

### Special PF Keys: Messages and Requests

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

PF Key | Name | Function
--- | --- | ---
PF7 | Up | Scroll list of messages towards the top.
PF8 | Down | Scroll list of messages towards the bottom.

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

Message Type | Possible Action | Example Message
--- | --- | ---
System Information This is internal processing information and error messages and global messages defined for events (see Global Messages for Events in the Administration documentation). | Delete You can remove a message of this type from the list. A window prompts you to confirm the deletion. Enter `Y` and press ENTER to delete the message. | NETWORK DEMO-NET ACTIVATED ==> SAG / DEMO-NET / 195 / MESSAGE EJA Exit Execution Error ==> SAGTEST / SAGNET / 564 / JOB-1
User Notification This is a notification defined as an action for and End-of-Job event (see Defining Notification Messages). | Remove job next month - no longer required ==> SAGTEST / SAGNET / 577 / NJOB-1
Confirmation Request Only available for jobs requesting a condition. A message of this type means that a scheduled network or job is waiting for a condition to be set. | Set You are prompted to set the selected condition to true. Enter `Y` (true) to confirm or `N` (false) to reject the condition and press ENTER. | NETWORK-START-OK - 549 - RUN not found MAIL-ADMIN - 7 - RUN not found ==> SAG / SAGNET / 7 / DATA-PROCESSING-OK
Symbol Prompting Only available for networks or jobs requesting symbol prompting. A message of this type means that a scheduled network or job is waiting for symbols to be entered or modified. See also Symbol Prompting during Network or Job Activation. | Prompt Proceed as described in Performing Symbol Prompting. | Symbol Prompting E60-FLOW Run 530 (OVER START TIME)

- Performing Symbol Prompting

### Performing Symbol Prompting

Note
Symbol prompting via mailbox is only used for automatic jobs started by schedule and cannot be used for jobs started interactively. Definition of the recipient mailbox for symbol prompting messages is described in Specifying Recipients for Network Messages in the section Network Maintenance.

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.

### On this page

- Concept of Single or Multiple Mailbox Users
- Listing and Maintaining Mailboxes
- Viewing Mailbox Messages
- Handling Messages and Requests