This section describes the global user exits that can be used to perform version, JCL, symbol or message validation checks in the whole Entire Operations environment. This is useful, for example, if no specific validation checks are defined for single job networks.
Note:
The existence of the defined global user exits is checked during
the Entire Operations Monitor startup. If at least one of these exits cannot be
found, the Entire Operations Monitor performs an immediate shutdown.
The following applies:
A global user exit may exist only once within the whole Entire Operations installation.
All global user exits are optional.
The user exits must reside as Natural objects in the SYSEORU library.
The same coding rules and restrictions apply as described in the sections User Exits and Starting an Edit Session in the User's Guide apply.
This document covers the following topics:
User Exits in the User's Guide
To access and maintain global user exits
In the Messages and Exits window, open the tabbed page Global User Exits:
Enter or change the required values.
The fields and options are described in Fields: Global User Exits.
If required, choose Edit next to the global user exit whose source you want to modify.
If required, choose Export to open the Export Objects window and export the current settings. See also Exporting Current Settings in the Import/Export Functions documentation.
When finished, choose to save your entries.
| Field | Meaning | |
|---|---|---|
| Version Names | Name of the user exit to be used as the global exit for version names. | |
| JCL Activation | Name of the user exit to be used as the global JCL activation exit. | |
| Symbol Modification | Name of the user exit to be used as the global symbol modification exit. | |
| Symbol Not Found | Name of the user exit to be used as the global symbol not found exit. | |
| Message Sending | Name of the user exit to be used as the global message sending exit. | |
| Usage | Only applies to
Message Sending.
Option to be used for the global message sending exit. Note: Possible selection options: |
|
| Never use this exit | Never use this exit. | |
| Explicit sending via exit | Use for explicit sending via exit
only (=EXIT).
|
|
| Additionally for all messages | Additionally for all defined message send actions. | |
| For all events | For all events. | |
All global exits are described in the following sections.
If specified, this exit will check each newly created network version name or symbol table version name.
The exit must be coded as a Natural subprogram.
The parameter list is named NOPXPL-A (see User Exits in the User's Guide) and is available in the SYSEOR system library.
Include it in the exit with:
DEFINE DATA PARAMETER USING NOPXPL-A
| Parameter | Meaning | |
|---|---|---|
P-CALL-PLACE |
NVN |
For network version checking. |
SVN |
For symbol table version checking. | |
| P-RC | Meaning |
|---|---|
| 0 | The version name is OK. |
| 1 |
The version name is rejected by the exit. If the
version name is rejected, the content of
If |
If specified, Entire Operations will use this exit for each job activation.
The exit must be coded as a Natural subprogram. It is possible to modify almost all fields which describe the JCL location.
Note:
You must set P-RC := 1 to make the modifications
valid.
The modifications are effective only for the current run, but not for the job's master definition.
The parameter list is named AJCLX1-A and is available in the SYSEOR system library.
Include it in the exit with:
DEFINE DATA PARAMETER USING AJCLX1-A
| P-RC | Meaning |
|---|---|
| 0 | OK, no modification of the JCL location. |
| 1 | OK, JCL location was modified by exit. |
| other | Access to JCL file
denied or other problem.
In this case, the JCL load for the given job will be interrupted. |
User-defined symbols may be modified and validation checks carried out during job network activation. If defined, this exit will be invoked during the activation of all job networks for which no specific symbol prompting or modification exit was defined.
In the case of user-defined map(s) and validation checks during the symbol prompting for job network activation, the symbols must be read and updated by the Entire Operations API routine NOPUSY7N (see API Routines in the User's Guide). This API routine also allows sequential reading in the active symbol table.
See also Specifying User Exits for Symbol Modification in the section Symbol Table and Symbol Maintenance in the User's Guide.
The user exit is to be written as a Natural subprogram and must use the supplied parameter list NOPSYP3A (see User Exits in the User's Guide). This parameter list contains all environment parameters needed.
A list of symbol tables used for this network activation will be passed.
| P-RC | Meaning |
|---|---|
| 0 | OK, modifications were done. |
| 1 | OK, no symbols prompted or modified. |
| 2 | Activation cancelled. |
| 3 | On input, rewrite modified symbols to the master symbol table. |
This exit is invoked during the activation of all job networks for which no specific symbol prompting or modification exit was defined and symbol search failed within the existing hierarchy.
All actions of this exit will be logged.
For special Usage considerations, see Usage in
Note:
Extensive use of this exit can cause considerable
overhead.
For this exit, the common exit parameter list
NOPXPL-A (see
User Exits in the User's Guide) is
used. The field P-CALL-PLACE contains SNF.
| P-RC | Meaning |
|---|---|
| 0 | Exit returned another symbol value. |
| 1 | Accept that the symbol is missing; skip replacement. |
| 2 | Use another symbol
instead.
The returned symbol value will be preceded by the
current escape character and followed by a period ( |
| 3 | Exit returns:
symbol not found.
The symbol replacement is not successful. |
This exit can be used to send messages for job events. The exit must be coded as a Natural subprogram.
For possible option settings, see the Usage field described in Fields: Global User Exits.
Note:
Extensive use of this exit can cause considerable
overhead.
This section covers the following topics:
The parameter list is named NOPMSG-A and is available in the SYSEOR system library.
Include it in the exit with:
DEFINE DATA PARAMETER USING NOPMSG-A
| P-RC | Meaning |
|---|---|
| 0 | Exit execution was OK. |
| 1 | Temporary error.
The Entire Operations Monitor should try to send the message through the exit later. |
| 2 | Permanent error.
The Entire Operations Monitor should not try to send the message through the exit later. |