Defaults

#### Search Results

Search

# Defaults

As a system administrator, you can set system-wide defaults for various objects and functions.

This section covers the following topics:

- Invoking Default Maintenance

- System Defaults

- Monitor Defaults

- Report Defaults

- Bundle Defaults

- Automatic Archiving Defaults

- User-Defined Archives

- Automatic Reviving Defaults

- Automatic Cleanup Defaults

- CA Spool Defaults

- Natural Advanced Facilities Defaults

- Trigger Container File

- User Exits

- Default Code Pages

- Node Definitions

- Email Message Definitions

- 3GL Interface

- 3GL Interface Maintenance

## Invoking Default Maintenance

To invoke default maintenance:

1. Enter `1` in the command line of the System Administration menu.

   The Default Definition Menu is displayed, providing the following functions:

        1 - System defaults
        2 - Monitor defaults
        3 - Report processing defaults
        4 - Bundle processing defaults
        5 - Automatic archiving defaults
        6 - Automatic reviving defaults
        7 - Automatic cleanup defaults
        8 - CA Spool defaults
        9 - Natural Advanced Facilities defaults
       10 - Trigger container file and user exits
       11 - Default code pages
       12 - 3GL interfaces
       13 - Node definitions
       14 - Email message definitions

2. To select a function, you enter its number in the command line.

## System Defaults

This section covers the following topics:

- Setting System Defaults

- Components of System Defaults

- Integrating Natural Applications

### Setting System Defaults

To set system defaults for Entire Output Management:

1. Enter `1` in the command line of the Default Definition Menu.

   The System Defaults screen is displayed:

         18:32:08             **** ENTIRE OUTPUT MANAGEMENT ****            2022-11-11
        UserId XYZ                  - System Defaults -

        NOM definition-data file               NOM active-data file
           DBID .................... 9____        DBID .................... 9
           FNR ..................... 243__        FNR ..................... 243
        Use owner ID ............... N
        Date format ................ E
        Support long names ......... Y
        Automatic user definition... N

        Daily cleanup
           Time .................... _____
           Next run ................ 13/12/2022 00:01
        Log
           Types ................... _ _ _ _ _ _ _ _ _ _
           Retention period ........ 10D__
        Printouts
           Types ................... _ _ _     Type H
           Retention period ........ _____     ______

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

2. To change any settings, you have to press PF10 first.

   The fields are described under Components of System Defaults.

### Components of System Defaults

#### General

Field | Explanation
--- | ---
NOM definition-data file (DBID/FNR) | The Adabas database ID and file number of the Entire Output Management definition-data file (logical file 206).
NOM active-data file (DBID/FNR) | The Adabas database ID and file number of the Entire Output Management active-data file (logical file 91).
NOM trigger container file | See Trigger Container File.
Use owner ID | Y = Operating-system resources should be accessed with the user ID of the report owner or bundle coordinator. This allows users whose ID is not defined externally (RACF, BS2000 user ID, etc.) to use Entire Output Management. N = The Entire Output Management user must have authorization to access operating-system resources.
Use Owner ID | User ID is ESY User | Browse | Submit Job
Y | Yes | Report Owner | User ID
No | Report Owner
N | Yes | User ID | User ID
No | - | Monitor
Support long names | Y = Report names and bundle names may consist of up to 25 alphanumeric characters. N = Report names may consist of up to 17 alphanumeric characters and bundle names of up to 8 alphanumeric characters.
Date format | Select the format to be used for date information in Entire Output Management: A = American (MM/DD/YY) B = American (MM/DD/YYYY) E = European (DD/MM/YY) F = European (DD/MM/YYYY) G = German (DD.MM.YY) H = German (DD.MM.YYYY) I = International (YY-MM-DD) J = International (YYYY-MM-DD)
Automatic user definition | N = User IDs must be defined manually with the Users function. This is the default. Y = If a user enters an ID which exists neither for a user nor a distribution list, Entire Output Management automatically defines the user ID with a default profile. The default profile will be taken from the user ID `DEFAULT`. P = If a user enters an ID which exists neither for a user nor a distribution list, he/she will be prompted to decide whether he/she wishes to use the default profile `DEFAULT`.
Daily cleanup | Once a day, cleanup processing is performed which deletes: active reports (or marks them for archiving), expired active reports from archive/revival, log records, printout records, and active bundles. If you run the monitor as a single task, it will be unable to process any reports, bundles or printouts while performing daily cleanup. To avoid this, you can define multiple tasks (daily cleanup is done by task 1) or execute the daily, report and spool cleanup as a stand-alone batch job. To achieve the latter, execute the program `NOMCLEAN` in the library `SYSNOM` in a standard batch Natural job, ensuring that `LFILE 206` is set correctly to point to your Entire Output Management system file. You should schedule the batch job so that it finishes before the time specified for daily cleanup. Time = The time when you want to execute the cleanup process. Next run = The date and time of the next cleanup run.

#### Log/Printouts

Field | Explanation
--- | ---
Log
Types | Specify the types of information to be logged by entering the following letters: R = Report maintenance information, B = Bundle maintenance information, P = Logical printer maintenance information, D = Distribution list maintenance information, L = Information about logon/logoff activities of users. W = Clear the work directory `$EOM_WORK` (under UNIX only); see below.
Retention period | Enter the default retention period for log records. This is the period of time that log records are kept in the Entire Output Management database. You set this period by entering a number followed by a letter indicating the unit of time: D = days, W = weeks, M = months. For example, 3D = 3 days, 5M = 5 months. Under UNIX, all log files are written to the directory `$EOM_WORK`; after the retention period, they will only be deleted from this directory if Types = W was specified.
Printouts
Types | Specify the type(s) of printouts to be deleted automatically at the end of the printout Retention period: D = Printed successfully. E = Printing error. F = Printing failed.
Retention Period | Specify the default retention period for printouts. This is the period of time that printouts are kept in the Entire Output Management database. You set this period by entering a number followed by a letter indicating the unit of time: D = days, W = weeks, M = months. For example, 3D = 3 days, 5M = 5 months.
Type H | Specify the default retention period for held printouts. This is the period of time that printouts in Hold status are kept in the Entire Output Management database. You set this period by entering a number followed by a letter indicating the unit of time: D = days, W = weeks, M = months. For example, 3D = 3 days, 5M = 5 months.

### Integrating Natural Applications

You can specify Natural applications which are to be displayed on the Main Menu of Entire Output Management, from where the users can invoke them (not available in the Output Management GUI client).

To integrate applications in the Main Menu:

1. Press PF9 on the System Defaults screen.

   The System Defaults > Applications screen is displayed.

2. On this screen, you specify each application as follows:

   Field | Explanation
   --- | ---
   Title | The text which is to be displayed on the Main Menu.
   Library | The Natural library in which the application is contained.
   Program | The name of the Natural program which is to be executed as startup transaction.
   Parameters | The application-specific startup parameters.

The defined applications are displayed for all users on the Main Menu of Entire Output Management. Under Natural Security, only users with the appropriate access rights will be able to log on to an application.

To return from an application to the Entire Output Management Main Menu, the application must finish with `RETURN`.

#### Automatic Display of Other Software GmbH products

If Entire Operations, Entire Event Management or Natural NSPF are installed at your site, these products are automatically displayed on the Main Menu of Entire Output Management. In this way, it is easy for users to "toggle" between them and Entire Output Management.

Under Natural Security, only users with the appropriate access rights will be able to log on to a product.

## Monitor Defaults

This section covers the following topics:

- Setting Monitor Defaults

- Components of Monitor Defaults

The Monitor runs as one or more subtasks under Entire System Server or as one or more batch jobs and controls the generation, printing and distribution of reports and bundles.

Before you specify several Monitor tasks or allow several Natural tasks, you should check the value of `NATNUMSUB` in the Entire System Server startup parameters:

`NATNUMSUB=subtask-maximum`

`subtask-maximum` is the maximum number of subtasks (recommended: 20).

In z/OS, subtasks run under the Monitor Entire System Server node. In UNIX, each Monitor task uses a separate process.

### Setting Monitor Defaults

To define default parameters for the Entire Output Management Monitor:

1. Enter `2` in the command line of the Default Definition Menu.

   The Monitor Defaults screen is displayed.

2. To change any settings, you have to press PF10 first.

   The fields available on the Monitor Defaults screen vary depending on the spool type. They are described under Components of Monitor Defaults.

#### Special PF Keys

Key | Name | Function
--- | --- | ---
PF7 | CopFi | Define container files.
PF8 | Tasks | Define monitor tasks.
PF9 | Archv | Define automatic archive defaults.
PF10 | Modfy | Switch from display mode to modify mode.

### Components of Monitor Defaults

- General
- Spool Parameters
- Container Files
- Monitor Tasks

#### General

Field | Explanation
--- | ---
Node | Displays the name/number of the Entire System Server node under which the Entire Output Management Monitor is run as a subtask or batch job.
System | Displays the system type (e.g. z/OS).
Spool type | Displays the spool type (JES2, JES3 or UNIX).
Batch module | This field is only available for JES2 and JES3. Enter the name of the Natural batch module to be used by the Monitor. The module must reside in the Entire System Server load library or in one of the Entire System Server steplib libraries defined for the Natural task that is started. For information on creating the batch module, see the Installation and Customization documentation.
System server job name | This field is only available for JES2 and JES3. Enter the name of the Entire System Server job.
Printer tasks | The number of tasks attached to print reports and bundles (maximum 32). See also the recommendations under Monitor Tasks.
Wait factor | These fields are used to adjust monitoring to the load in your installation. It is the time in seconds the Monitor waits between two consecutive monitoring cycles. During each cycle, the Monitor performs all the work accumulated since the end of the last cycle.
Minimum | Enter the minimum time in seconds the Monitor is to wait between two consecutive monitoring cycles.
Maximum | Enter the maximum time in seconds the Monitor is to wait between two consecutive monitoring cycles.
Increment | If there is no activity during the minimum wait time, the wait time is increased by the value you enter here, until the maximum is reached. When activity occurs, the wait time returns to the minimum. Enter the number of seconds by which the wait time should increase.
Error handling | Retries | The number of retries for a failed Monitor operation. The action in error will not cause an error message, but it will be tried again after the time specified in the Interval field.
Interval | The time in seconds after which a failed Monitor operation is tried again.
Emergency emails | You can specify one or more email addresses. In the case of severe errors, the Monitor will send error information to these addresses. See Email Message Definitions for details.
Jobcards or Additional Parameters | Enter a job card to be used as a default when no other job card is specified. The following substitution variable can be used: `§USER`. Trace: Tracing requires a huge amount of database space and deteriorates performance considerably; therefore, the trace function should only be used if requested by our support. If the text `TRACE=` appears in the jobcards, the Monitor will write a detailed activity trace to its SYSOUT file(s). If the SYSOUT files are not available, for example, if the tracing Monitor routine runs in a server environment or online, the trace output is written to the System Automation Tools log file, which can be retrieved with the utility NOMLOG (see Displaying the Monitor Log under Monitor Management). In addition, the Monitor trace switches on the tracing facilities of Entire System Server and the Natural Data Collection trace function if required by the specified program level. `TRACE` can be specified as follows: `TRACE=OFF` - No tracing will be performed. `TRACE=ON` - Everything will be traced (across all levels and all components). `TRACE=level` - Everything will be traced up to the specified program level (as determined by the Natural system variable *LEVEL). `TRACE=(level,[component,...])` - Tracing will be performed up to the specified program level for the specified component(s). `level` can be `1 - 99`. `component` can be: `MONITOR` = All Monitor administration traces (this is also always traced in conjunction with one of the other components). `SCAN` = The scanning of spool systems for matching reports. `COPY` = The copying of reports to a container file. `CREATE` = The creation of active reports and bundles. `PRINT` = Printout management. Note The tracing of printers is not controlled by this job card. To trace printer tasks, you use the corresponding printer attribute; see Attributes of Physical Printers.

#### Spool Parameters

Field | Explanation
--- | ---
JES2 and JES3 Classes
These fíelds are used to define the SYSOUT classes dedicated to Entire Output Management.
Execution (JES3 only) | Enter a list of execution classes to be processed by Entire Output Management. This method creates considerable performance overhead and should only be used for compatibility reasons. In future, only SYSOUT classes should be used for processing by Entire Output Management. If, however, you still need this method during a transitional period: in addition to searching SYSOUT classes for output, execution classes can also be searched. In this case, the following limitations apply: no default definitions are checked for processing; messages that no report definition has been found for a certain SYSOUT file are not logged.
Sysout | Enter a list of SYSOUT classes to be processed by Entire Output Management. Only those jobs with SYSOUT files in these classes are processed.
Internal | Define one SYSOUT class to hold temporary SYSOUT files. This class must not be one of the classes defined in the Sysout field above.
Print | Enter the class in which reports and bundles are to be printed.
Error | Define one SYSOUT class to hold the SYSOUT files which cause an error during processing. This class must not be one of the classes defined in the Sysout field above.

#### Container Files

For information on the use of container files, see Container Files and Active-Data File in the Concepts and Facilities documentation.

To define a container file for the Monitor:

1. Press PF7 on the Monitor Defaults screen.

2. A window is displayed, in which you specify:

Field | Explanation
--- | ---
Destination | The destination of the container file, as specified in the `DEST=(,...)` parameter of the DD statement (JES).
DBID / FNR | The database ID and file number of the container file.

#### Monitor Tasks

This function is used to define subtask processing for the Entire Output Management Monitor.

You can split the workload of the Monitor between different tasks, each with its own wait factors.

The management functions of the Monitor (for example, cleanup, active bundle flushing) are always performed by Task 1. In addition, Task 1 will take over the work for any other task that fails.

To define subtasks:

1. Press PF8 on the Monitor Defaults screen.

   The Monitor Task Profile screen is displayed:

           12:12:34             **** ENTIRE OUTPUT MANAGEMENT ****             2022-12-12
          UserId XYZ                - Monitor Task Profile -

           Task    Scan       Copy       Create     Printouts /        Wait Factors
          Number  Queues     Sources     Reports     Special       Min   Max   Increment

            1       _           _           _           _          30    120      1__

            2       X           _           _           _          60__  300_     1__

          31-32     _           2           _           _          120_  3600     1__

            4       _           _           X           _          30__  180_     1__

            5       _           _           _           X          40__  240_     1__

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

2. Make the task specifications as desired.

#### Recommendations

The number of additional Monitor tasks depends on your execution environment. The following table gives some recommendations:

Environment | Total Number of Monitor Tasks | Additional Tasks for Functions | Wait Factors (in seconds) | Number of Printer Tasks
--- | --- | --- | --- | ---
Minimum | Maximum | Increment
General recommendation | 2 | Manage Printouts/Special | 5 | 30 | 1 | 2
Many short printouts | 2 | Manage Printouts/Special | 1 | 20 | 1 | 4 - 10
Few large printouts | 3 | Manage Printouts/Special, Copy Sources | 10 | 30 | 1 | 2 - 4
Many short printouts plus a few large printouts | 3 | Manage Printouts/Special, Copy Sources | 1 | 20 | 1 | 4 - 10

#### Multiple Tasks for Copying of Sources

In a multi-node environment, the workload of copying sources may be too great for a single task to handle. In this case, you can split this workload between up to 9 tasks.

If the copying of sources is handled by multiple tasks, each of the tasks dedicated to copying sources cannot perform any other function.

To define multiple tasks for copying sources:

1. On the Monitor Task Profile screen, instead of marking the function Copy Sources with an "X", enter the number of tasks (1 to 9) for this function.

2. The additional tasks will appear in the task list.

## Report Defaults

You can define default parameters for report processing. These defaults apply to newly-created reports and can be modified for each report.

This section covers the following topics:

- Setting Report Defaults

- Components of Report Defaults

### Setting Report Defaults

To set defaults for report processing:

1. Enter `3` in the command line of the Default Definition Menu.

   The following screen is displayed:

          17:43:25             **** ENTIRE OUTPUT MANAGEMENT ****            2022-11-11
         User ID XYZ             - Report Processing Defaults -

         Store in NOM DB ...... N
         Archive directly ..... N
         Create Definition .... _
         Report Retention
            Number ............ 5__
            Unit .............. A
            Calendar .......... ________
            Action ............ P
         Separator Pages
            Start ............. ________
            End ............... ________
            Copies ............ ___

         Jobcards
            //NOMREPPR JOB CLASS=K,MSGCLASS=X_______________________________________
            ________________________________________________________________________
            ________________________________________________________________________

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

2. To change any settings, you have to press PF10 (Modfy) first. The fields are described under Components of Report Defaults

3. The values you enter on this screen are automatically written to the fields with the same names on the Report Definition screens.

   For further information on report processing, see Reports in the User's Guide.

### Components of Report Defaults

Field | Explanation
--- | ---
Report Retention | These fields determine how long reports are stored in the Entire Output Management database. When this retention period expires, the reports are purged and/or archived, depending on the selected Action. The default retention period is the system-wide period defined by the system administrator.
Action | When the retention period expires, the report will be archived (`A`) or purged (`P`). When an active report is archived, its content is no longer available online. After this, it only exists in the archive data set and has to be revived before it can be viewed or printed again.
Number | Specify the number of days/weeks/months the report is to be stored in the Entire Output Management database.
Unit | Possible values: Working days`(W)` Absolute days`(A)` Weeks`(V)` Months`(M)` If you select "working days", you have to specify a calendar which distinguishes between working and non-working days.
Calendar | If you specify "working days" as the Unit of time, you have to specify the name of the calendar which determines which days are considered to be working days. See also Calendars.
Example: If you want reports to be kept for two working days, you specify Number `2` and Unit `working days`. Assuming that in the calendar referenced, Saturday and Sunday are defined as non-working days, this means that if a report is created on a Friday evening, it will be retained until Tuesday evening.
Archive directly (Y/N/I) | This field sets the default value for the field of the same name in the General Attributes of report definitions.
Store in NOM DB (Y/N) | You can use this option to take the report contents from the spool and store them in the Entire Output Management directory file for later viewing or archiving.
Create definition (Y/N) | With this option, you can have report definitions created automatically for reports produced as a result of separation.
Jobcards or Additional Parameters | Enter the job cards to be used for printing with batch jobs. The following substitution variables can be used: `§USER` and `§REPORT`.
Separator Pages | Start | Enter the name of the separator page to be printed at the beginning of the report.
End | Enter the name of the separator page to be printed at the end of the report.
Copies | Specify how many times each separator page is to be printed.
See Separator Pages for further information. To edit a separator page, position the cursor on the Start or End field, and press PF11 (Edit).

## Bundle Defaults

You can define default parameters for bundle processing. These defaults apply to newly-created bundles. They can be modified for each bundle.

For further information, see Adding a Bundle Definition in the User's Guide.

### Setting Bundle Defaults

To set default parameters for bundle processing:

1. Enter `4` in the command line of the Default Definition Menu.

   The following window is displayed:

       +---------------------------------------------------------------------------+
       !                       - Bundle Processing Defaults -                      !
       !                                                                           !
       !  Retention Period ....... ___  Unit _  Calendar ________                  !
       !                                                                           !
       !  Hold Before Print ...... _ (Y/N)                                         !
       !  Printer   List ......... ________ ________ ________ ________ ________    !
       !            Copies ....... ___      ___      ___      ___      ___         !
       !                                                                           !
       !  Separator Bundle ....... ________ (Start)  ________ (End)  ___ (Copies)  !
       !            Report ....... _ (Y/N)                                         !
       !                                                                           !
       !  Jobcard                                                           !
       !  ________________________________________________________________________ !
       !                                                                           !
       !  PF1 Help PF3 Exit PF5 Do PF6 Undo PF10 Modify PF12 Menu                  !
       !                                                                           !
       +---------------------------------------------------------------------------+

2. To change any settings, you have to press PF10 first. The fields are described under Components of Bundle Defaults.

3. The values you enter here are automatically written to the fields with the same names on the Bundle Definition screen.

### Components of Bundle Defaults

Field | Explanation
--- | ---
Retention | Period | Enter the number of absolute days, working days, weeks or months the bundles are to be kept in the Entire Output Management database. See the Retention field description under Attributes of a Bundle in the User's Guide.
Unit | Possible values: Working days`(W)` Absolute days`(A)` Weeks`(V)` Months`(M)` If you select "working days", you have to select a calendar which distinguishes between working and non-working days.
Calendar | Specify the name of a calendar, if "working days" is the unit for the retention period. For more information, see Attributes of a Bundle in the User's Guide. See also Calendars.
Example: You have defined a calendar in which Saturday and Sunday are marked as holidays. If have specified "2" as the Period, and "working days" as the Unit and the bundle is created on Friday evening, it will be retained until Tuesday evening.
Separator Bundle | Start | Enter the name of the separator page to be printed at the beginning of the bundle.
End | Enter the name of the separator page to be printed at the end of the bundle.
Copies | Specify how many times each separator page is to be printed for the bundle.
See Separator Pages for further information.
Printer | List | You can enter up to 5 logical printer names. These are the printers on which the bundle will be printed. To select a printer from a list, enter a question mark (?) in this field.
Copies | Specify the number of copies to be printed on the respective printer.
Separator Report | Y = Print the report separator pages. This is the default. N = Do not print the report separator pages. The number of separator pages can be defined for each report in the bundle. See Attributes of a Bundle in the User's Guide.
Hold before print | Y = The bundle is placed in Hold status in the printout queue until it is released manually for printing. N = The bundle is printed immediately.
Jobcard or Additional Parameters | Enter the job card to be used for printing on system printers. The following substitution variables can be used: `§USER` and `§BUNDLE`.

## Automatic Archiving Defaults

You can set default parameters for archiving. These parameters enable you to create archive data sets and schedule automatic archiving.

For further information on archiving, see the sections Archive Administration and Archiving Task.

This section covers the following topics:

- Defining Parameters for Archiving

- Archiving Parameters

- Archiving Schedule Parameters

### Defining Parameters for Archiving

To define the archiving parameter:

1. Enter `5` in the command line of the Default Definition Menu.

   The Archiving Parameters screen is displayed.

2. Change the parameters as desired. The fields are described under Archiving Parameters below.

3. To define archiving schedule parameters, you press PF8 (Sched).

   The Archiving Parameters/Schedule screen is displayed.

   Change the parameters as desired. The fields are described under Archiving Schedule Parameters below.

4. To edit the job skeleton, you press PF11.

### Archiving Parameters

Field | Explanation
--- | ---
Parameters for All Operating Systems
Default retention | Enter the default retention period for archive records. This is the period of time that reports are kept in the Entire Output Management database. When this period expires, the reports are marked for deletion in the archive catalog.
Number | Enter the number of units the reports are to be kept.
Unit | D = days, W = weeks, M = months, Y = years. For example 3D (3days), 5M (5 months) etc.
Schedule | Time scheduled | Enter `Y` to activate the automatic time schedule, which you define below.
Next run | The date and time for which the next archive run is scheduled. Note The scheduling process can also be started manually by entering the option code >8.7 in the command line.
Data set prefix | Archive | Enter a prefix to be used for creating archive data set names. A sequential number is added automatically to this prefix to create a name for an archive data set.
Condense | You may enter a different prefix for archive data sets created by the condense job, so that these can be distinguished from normal archive data sets.
Delete empty | Automatic deletion of empty archive data sets. Enter "Y" or "N".
Condense threshold | Numbers of active reports in an archive that will cause automatic condense marking of this archive.
Skeleton/Scripts | The name of the job skeleton used for the archive task on mainframes is `JARCSKEL`. You can edit this member by pressing PF11 (Edit). `JARCSKEL` must be located in the library `SYSNOMU`. The job skeleton used for condensing has to be saved in library `SYSNOMU` and must be named `JCDNSKEL`. The name of the script used for the archive task on Linux is `nomarc.bsh` and the one for condensing `nomcdn.bsh`, see section Scripts in Installation on UNIX, Completing the Installation.
Jobcards or Additional Parameters | Enter the job cards to be used for archiving with a batch job. See also Limiting the Amount of Archiving and Condensing below.
Parameters for z/OS only
EXPDT | Enter "Y" to provide the expiry date on every condense step. This will cause operating-system messages to be issued for the second and subsequent steps and these might require operator intervention. Enter "N" (or leave blank) to provide an expiry date (or output file retention period) only on the final condense step. This is the default and is compatible with earlier versions of Entire Output Management.
Generic Name | Enter the generic name for tapes used in your installation. This parameter is used for archiving to tapes. The default is `TAPE` (`UNIT=TAPE` in JCL).
Storage Class (SMS) | Enter the name of the storage class for the storage management system.
Archive to disk | GDG | Enter "Y" to use a generation data set. For information on generation data sets, see the appropriate IBM documentation.
Max. generations | Maximum generations. This field is taken from the definition of the generation data set and cannot be modified.

#### Limiting the Amount of Archiving and Condensing

In some cases, the number of active reports to be archived/condensed may be too high for one archiving/condensing run and should therefore be split. With the parameters `ARCHMAX` and `CONDMAX`, you can limit the number of active reports to be archived and condensed respectively. They are specified in one of the lines for the jobcards (see above) in the form of a comment for the job entry; for example: `//* ARCHMAX=20000`.

`ARCHMAX` can be used on all operating systems, `CONDMAX` can only be used on mainframes, but not on UNIX.

- `ARCHMAX=nnnnnn` - Archiving will stop when the specified number of archived active reports is reached. Message `NOM0494` will be issued as a reminder that archiving has to performed again for the remaining active reports.

- `CONDMAX=nnnnnn` - Condensing will stop when the specified number of condensed active reports is reached. The source archive dataset will continue to have the status "condense". Message `NOM0487` will be issued as a reminder that condensing has to performed again for the remaining active reports. Repeated condense jobs will create new condense datasets.

### Archiving Schedule Parameters

Field | Explanation
--- | ---
Next run | Displays the date and time for which the next archiving run is scheduled (as calculated from on the archive schedule parameters specified on this screen).
Weekdays or Monthly Days | You can either select archiving to be performed every day or on certain days of the month or on certain week days: For weekdays, you specify their two-character abbreviations (SU = Sunday, MO = Monday, etc.). For days of the month, you specify their numbers (01 to 31). For archiving on every day of the month, you specify `ALL`; for archiving on the last day of the month, you specify `LD`.
Start time | You can specify the time of the day when archiving is to start. The default is `24:00` (midnight).
Calendar | If you specify a calendar here, archiving is performed only on days defined as working days in that calendar, but not on days defined as holidays. To select a calendar from a list, enter an asterisk (*) in this field. See also Calendars.
Before/After Holiday(s) | Should an archiving date fall on a calendar holiday, enter `A` to perform it on the first workday after the holiday, enter `B` to perform it on the last workday before the holiday.

## User-Defined Archives

You can define up to 9 custom archive types in addition to the standard archive. This enables you to:

- create multiple hierarchies for archived reports. For example, reports which need to be revived quickly can be archived to disk, with all other reports being archived to tape.

- archive to non-standard data sets (that is, data sets which cannot be accessed as a Natural work file) such as optical disks.

The Entire Output Management Monitor submits an archive job for each type which has active reports to be archived. It also submits a condense job for each type which has archive data sets to be condensed. It submits a revive job for each data set/volume containing reports to be revived.

Notes:

1. You cannot condense data sets of different types into a single output data set.
2. Entire Output Management assigns the logical volser name `NOMUDA` to all user-defined archives.

This section covers the following topics:

- Invoking Archive Maintenance

- Adding an Archive

- Components of User-Defined Archives

- Modifying an Archive

- Displaying an Archive

- Renaming an Archive

- Cross-Referencing an Archive

- Deleting an Archive

### Invoking Archive Maintenance

To invoke archive maintenance:

1. Press PF9 (UsArc) on the Archiving Parameters screen.

   The User Defined Archive Maintenance screen is displayed, listing all existing user-defined archive types.

   For each archive type, the (internally allocated) type number, the name and the short description are displayed.

2. From this screen, you invoke the functions for the maintenance of user-defined archives, as described below.

### Adding an Archive

To add a user-defined archive:

1. Press PF2 (Add) on the User-Defined Archive Maintenance screen:

2. The User-Defined Archive Type screen is displayed:

          14:25:48             **** ENTIRE OUTPUT MANAGEMENT ****            2022-11-11
         User ID XYZ              - User Defined Archive Type -

         Name ................. ARCTYP5_    Number: 5
         Description .......... __________________________________________________
         DSN Prefix ........... ______________________________
         Job Skeletons
            Archive ........... ________    Revive : ________   Condense: ________
         Default Retention               User Routine
            Number ............ ____        Library: ________
            Unit .............. _           Member : ________
         Archive Jobcards
             ________________________________________________________________________
             ________________________________________________________________________
             ________________________________________________________________________
         Revive Jobcards
             ________________________________________________________________________
             ________________________________________________________________________
             ________________________________________________________________________

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

   The fields are described under Components of User-Defined Archives.

#### Special PF-Keys

Key | Name | Function
--- | --- | ---
PF9 | Attrb | Define keywords for JCL substitution.
PF10 | Edit | Edit skeletons and user routines. Cursor must be on object to edit it.

#### Defining Keywords for JCL Substitution

To define keywords for JCL substitution:

1. Press PF9 (Attrb) on the User-Defined Archive Type screen.

2. A screen is displayed, on which you can enter up to 28 job skeleton variables.

   Whenever any of the keywords you define here appears in a job skeleton (prefixed with "&"), it is replaced by its value.

   Certain keywords are reserved for Entire Output Management. If you attempt to add a keyword with a reserved name an error message is returned. It is your own responsibility to ensure that value substitution does not result in invalid JCL (for example, truncation).

3. Press PF9 to return to the previous screen.

### Components of User-Defined Archives

Field | Explanation
--- | ---
Name | Enter an archive name (must be unique).
Number | The internally allocated type number.
Description | Enter a description.
DSN Prefix | The prefix used for data sets created for this archive type. If you leave this field blank, the value is taken from Automatic Archiving Defaults.
Job Skeletons | The name of the member in `SYSNOMU` to be used for submitting archive, revive and condense jobs.
Default Retention | The archive retention value to be used for any report which does not have its own retention value. If you leave this field blank, the value is taken from the Automatic Archiving Defaults.
User Routine | The user routine library and member to be invoked for this archive type. If you leave this field blank, the archive will be handled as a standard batch Natural work file.
Archive/Revive Jobcards | Jobcards to be used for archive/condense and revive jobs. If you leave these blank, they are taken from the Automatic Archiving Defaults and Automatic Reviving Defaults.

### Modifying an Archive

You cannot modify a user-defined archive if there are any reports, active reports or archive data sets of this type.

To modify a user-defined archive:

1. On the User-Defined Archive Maintenance screen, mark the archive with the line command `MO`.

   The User-Defined Archive Type screen is displayed for the selected archive.

2. Modify the data as desired. The fields are described under Components of User-Defined Archives.

   Then press ENTER to save your modifications.

   A message confirms the modification.

### Displaying an Archive

To display a user-defined archive:

- On the User-Defined Archive Maintenance screen, mark the archive with the line command `DI`.

  The User-Defined Archive Type screen is displayed for the selected archive. The fields are described under Components of User-Defined Archives.

### Renaming an Archive

To rename a user-defined archive:

1. On the User-Defined Archive Maintenance screen, mark the archive with the line command `RN`.

2. A window will be displayed, in which you enter the new name of the archive.

### Cross-Referencing an Archive

To display cross-reference information for a user-defined archive:

1. On the User-Defined Archive Maintenance screen, mark the archive with the line command `XR`.

   The XREF of Archive Type window is displayed, It shows how many objects of each type use this archive.

2. Mark the relation type with any character in column M to display the list of objects.

### Deleting an Archive

To delete a user-defined archive:

1. On the User-Defined Archive Maintenance screen, mark the archive with the line command `DE`.

2. Depending on the `CONFIRM` option (see SET command), you may be prompted to confirm the deletion.

## Automatic Reviving Defaults

The reviving parameters enable you to schedule automatic reviving.

For further information, see the section Start Reviving Task.

This section covers the following topics:

- Defining Reviving Defaults

- Reviving Parameters

### Defining Reviving Defaults

To define default parameters for reviving:

1. Enter `6` in the command line of the Default Definition Menu.

   The Reviving Parameters screen is displayed.

          06:58:32             **** Entire Output Management ****            2022-11-11
         User ID XYZ                 - Reviving Parameters -

         Skeleton ................ JREVSKEL
         Schedule
            Time scheduled ....... Y
            Next run ............. 12.11.2022 07:00
            not before ........... 07:00
            every ................ 06:00
            not later ............ 19:00
            Weekdays ............. MO TU WE TH FR __ __  (Su Mo Tu We Th Fr Sa)
            Or Monthly Days ...... ___ ___ ___ ___ ___ ___ ___ ___ ___ ___
                                   ___ ___ ___ ___ ___ ___ ___ ___ ___ ___
                                   ___ ___ ___ ___ ___ ___ ___ ___ ___ ___
            Calendar ID .......... ________
            Before/After Holiday . _
         Jobcards
            * $$ JOB JNM=NOMREV,CLASS=0,DISP=H,LDEST=*,SYSID=_______________________
            * $$ LST CLASS=Y,DISP=H_________________________________________________
            ________________________________________________________________________

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

2. The fields are described under Reviving Parameters below.

#### Special PF Keys

Key | Name | Function
--- | --- | ---
PF10 | Edit | Edit the Job Skeleton

### Reviving Parameters

Field | Explanation
--- | ---
Skeleton | The name of the job skeleton. The member resides in the library `SYSNOMU`.
Jobcards or Additional Parameters | Enter the job cards to be used for reviving.
Schedule | The following fields are used to define the automatic scheduling of the reviving process.
Time scheduled | Enter "Y" to activate the automatic time schedule, which you define below.
Next run | Displays the date and time for which the next revive run is scheduled (as calculated from on the revive schedule parameters specified on this screen).
Weekdays or Monthly Days | You can either select reviving to be performed every day or on certain days of the month or on certain week days: For weekdays, you specify their two-character abbreviations (SU = Sunday, MO = Monday, etc.). For days of the month, you specify their numbers (01 to 31). For reviving on every day of the month, you specify `ALL`; for reviving on the last day of the month, you specify `LD`.
Not before | Reviving will not be performed before the time specified here.
Every | You can specify a time interval here. For example, to perform reviving every 6 hours, you specify `06:00`.
Not later | Reviving will not be performed after the time specified here.
Calendar ID | If you specify a calendar here, reviving is performed only on days defined as working days in that calendar, but not on days defined as holidays. To select a calendar from a list, enter an asterisk (*) in this field. See also Calendars.
Before/After Holiday | Should a reviving date fall on a calendar holiday, enter `A` to perform it on the first workday after the holiday, enter `B` to perform it on the last workday before the holiday.

## Automatic Cleanup Defaults

The cleanup parameters enable you to schedule automatic cleanup.

This section covers the following topics:

- Defining Cleanup Parameters

- Cleanup Parameters

### Defining Cleanup Parameters

To define default parameters for Cleanup:

1. Enter `7` in the command line of the Default Definition Menu.

   The Cleanup Parameters screen is displayed.

         18:01:02             **** ENTIRE OUTPUT MANAGEMENT ****            2022-11-11
        User ID XYZ                 - Cleanup Parameters -

        Spool Cleanup .... Y
        Report Cleanup ... Y

        Cleanup Schedule
          Time scheduled . Y
          not before ..... 07:00
              every ...... 01:01
          not later ...... 23:00

          Weekdays ....... __ __ __ __ __ __ __     (Su Mo Tu We Th Fr Sa)
          Or Monthly Days  ALL ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___
                           ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___ ___

          Calendar-Id .... ________      Before/After Holiday(s) .. _

        Scheduled next ... 2022-11-12  18:11

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

2. On this screen, you define the automatic scheduling of the cleanup process. The fields are described under Cleanup Parameters below.

### Cleanup Parameters

Field | Explanation
--- | ---
Cleanup Process
Spool cleanup | Enter `Y` to activate automatic SPOOL cleanup. This automatically deletes SPOOL files and container-file entries no longer needed by Entire Output Management.
Report cleanup | Enter `Y` to activate automatic report cleanup. This automatically deletes active reports with location SPOOL, if corresponding SPOOL file no longer exists because it was deleted outside Entire Output Management.
Cleanup Schedule
Time scheduled | Enter `Y` to activate the automatic time schedule, which you define below.
Scheduled next | Displays the date and time for which the next cleanup run is scheduled (as calculated from on the cleanup schedule parameters specified on this screen).
Weekdays or Monthly Days | You can either select cleanup to be performed every day or on certain days of the month or on certain week days: For weekdays, you specify their two-character abbreviations (SU = Sunday, MO = Monday, etc.). For days of the month, you specify their numbers (01 to 31). For cleanup on every day of the month, you specify `ALL`; for cleanup on the last day of the month, you specify `LD`.
Not before | Cleanup will not be performed before the time specified here.
Every | You can specify a time interval here. For example, to perform cleanup every 6 hours, you specify `06:00`.
Not later | Cleanup will not be performed after the time specified here.
Calendar ID | If you specify a calendar here, cleanup is performed only on days defined as working days in that calendar, but not on days defined as holidays. To select a calendar from a list, enter an asterisk (*) in this field. See also Calendars.
Before/After Holiday(s) | Should a cleanup date fall on a calendar holiday, enter `A` to perform it on the first workday after the holiday, enter `B` to perform it on the last workday before the holiday.

## CA Spool Defaults

CA Spool Defaults are only available on mainframes.

CA Spool, among other spooling systems, can serve as source for the output data to be processed. Here you can define whether the CA Spool interface should be active or not.

Entire Output Management scans the specified destinations and moves the output into its own database container for further processing. The destinations to be scanned should be defined as virtual printers reserved for Entire Output Management. The destination is switched to the specified Temporary Destination (also a virtual printer) in order to avoid processing the same queue entry again.

This section covers the following topics:

- Defining CA Spool Defaults

- CA Spool Defaults

### Defining CA Spool Defaults

To define default parameters for CA Spool:

1. Enter `8` in the command line of the Default Definition Menu.

   The following screen is displayed:

          18:50:25             **** ENTIRE OUTPUT MANAGEMENT ****            2022-11-11
         UserId XYZ                  - CA Spool Defaults -

         Scan CA Spool queue .......... N

         CA Spool Interface Version ... 90       CA Spool Version (1/2)  _
         Temporary Destination ........ NOMTEMP_ Time Limit ............ 6_

           Destination DBID  FNR    Destination  DBID  FNR
           ___________ ____  ___    ___________  ____  ___
           NOMFIL2_    9____ 247__ ________     _____ _____
           ________    _____ _____ ________     _____ _____
           ________    _____ _____ ________     _____ _____
           ________    _____ _____ ________     _____ _____
           ________    _____ _____ ________     _____ _____
           ________    _____ _____ ________     _____ _____
           ________    _____ _____ ________     _____ _____
           ________    _____ _____ ________     _____ _____
           ________    _____ _____ ________     _____ _____
           ________    _____ _____ ________     _____ _____

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

2. The fields are described under CA Spool Defaults below.

### CA Spool Defaults

Field | Explanation
--- | ---
Scan CA Spool queue | Activate the CA Spool interface? Enter `Y` (yes) or `N` (no).
CA Spool Interface Version | Specify your current interface version of CA Spool (for example, 90).
CA Spool Version (1/2) | Specify your current version of CA Spool. For versions earlier than 2.0, specify `1`. For other versions, specify `2`.
Temporary Destination | Specify a virtual CA Spool destination to which Entire Output Management routes the output to be processed.
Time Limit | Enter the maximum number of seconds the Monitor is allowed to scan for output arriving through the CA Spool interface in one cycle. A value of `0` means no limit.
Destination | Specify up to 20 destinations to be scanned by Entire Output Management.
DBID / FNR | Specify the database ID and file number of the corresponding Entire Output Management container file in which to store the created reports.

## Natural Advanced Facilities Defaults

Instead of printing output from Natural programs in the Natural Advanced Facilities spool file (FSPOOL), you can route it to an Entire Output Management file (SYS2), from which it can be distributed, bundled or separated.

Here you can define whether the NAF/NOM interface is active and from which Natural Advanced Facilities environments output is to be processed. A separate Entire Output Management container file can be assigned to each FSPOOL file. However, you can also assign the same Entire Output Management container file to all FSPOOL files.

This section covers the following topics:

- Defining Natural Advanced Facilities Defaults

- Natural Advanced Facilities Defaults

### Defining Natural Advanced Facilities Defaults

To define default parameters for Natural Advanced Facilities:

1. Enter `9` in the command line of the Default Definition Menu.

   The following screen is displayed:

          12:28:48             **** ENTIRE OUTPUT MANAGEMENT ****            2022-11-11
         UserId XYZ        - Natural Advanced Facilities Defaults -

         NAF Interface active .. Y        Time Limit .. 1_

             FSPOOL      Container         FSPOOL      Container
            DBID  FNR    DBID  FNR        DBID  FNR    DBID  FNR
            ____  ___    ____  ___        ____  ___    ____  ___
            __177 ___43  ____9 __212      _____ _____  _____ _____
            ___10 ___60  ____9 __212      _____ _____  _____ _____
            ___76 __210  ____9 __247      _____ _____  _____ _____
            11177 _1247  ____9 __247      _____ _____  _____ _____
            _____ _____  _____ _____      _____ _____  _____ _____
            _____ _____  _____ _____      _____ _____  _____ _____
            _____ _____  _____ _____      _____ _____  _____ _____
            _____ _____  _____ _____      _____ _____  _____ _____
            _____ _____  _____ _____      _____ _____  _____ _____
            _____ _____  _____ _____      _____ _____  _____ _____

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

2. The fields are described under Natural Advanced Facilities Defaults below.

### Natural Advanced Facilities Defaults

Field | Explanation
--- | ---
NAF interface active | Process spool data from Natural Advanced Facilities? Enter Y (yes) or N (no).
Time limit | Enter the maximum number of seconds the Monitor is allowed to scan for output arriving through the Natural Advanced Facilities interface in one cycle. A value of `0` means no limit.
FSPOOL DBID / FNR | The database ID and file number as defined in the FSPOOL parameter.
Container DBID / FNR | The database ID and file number of the Entire Output Management container file. Output is filed to a database and is subject to the transaction logic of the database. Be sure to issue an ET as soon as possible. Be sure to regularly issue new ETs to prevent the Hold queue from overflowing (when there is a large amount of output).Remember that output from BTs is also affected. Be sure that no user transaction is open during an Adabas CLOSE or DEFINE PRINTER. For further information, see the section ET/BT Logic in the Natural Advanced Facilities documentation.

## Trigger Container File

Entire Output Management uses the trigger container file to process print data from various sources:

- Natural: Output files from Natural applications can be processed. In JES, these output files can belong to any output class. For more information, see the members `NOMTP`, `NOMTP--D`, `NOMTP--P` and `NOMSR--L` in the libraries `SYSNOMU` and `SYSNOMS` respectively. Please note that the API described as "NOM trigger processing" in these members is also used by Entire Operations.

- Remote mainframe nodes: If print data from remote mainframe nodes are to be processed, they are copied into the trigger container file. See also Node Definitions.

If the trigger container file is to be used for any of these purposes, it has to be defined and activated.

To define and activate the trigger container file:

1. Enter `10` in the command line of the Default Definition Menu.

   The Trigger Container File and User Exits screen is displayed.

2. On this screen, you specify:

   - DBID/FNR: The database ID and file number of the trigger container file.

   - Process trigger queue: Set this field to "Y" to activate the processing of the print data queued in the trigger container file. Set it to "N" it to deactivate processing.

For the activation/deactivation to take effect, you have to restart the Monitor.

## User Exits

The user exits described below are located in the Natural library `SYSNOMS`.

This section covers the following topics:

- Activating/Deactivating User Exits

- User Exit Descriptions

### Activating/Deactivating User Exits

To activate or deactivate a user exit:

1. Enter `10` in the command line of the Default Definition Menu.

   The Trigger Container File and User Exits screen is displayed, listing the available user exits.

   Their functions are described below.

2. To activate or deactivate a user exit, mark it with "Y" or "N" respectively.

### User Exit Descriptions

User Exit | Explanation
--- | ---
NOMEX001 | This exit is called by the Entire Output Management Monitor while scanning the spool queue. A call to this function indicates that no report definition was found for the specified source and the spool exit 001 flag was set. The exit must set the "process" flag to `TRUE` to advise Entire Output Management to make the source as subject for its normal cleanup processing, or `FALSE` to advise it not to process this output. In this case, the exit must switch the output from the Entire Output Management input queue to prevent subsequent processing for the same output.
NOMEX002 | This exit is called by the Entire Output Management Monitor while scanning the spool queue. The function is called if the exit 002 flag is set to allow the modification of spool attributes before they are stored in the Entire Output Management database.
NOMEX003 | This exit is called by Entire Output Management to allow/disallow access to Natural NSPF.
NOMEX004 | This exit is called by Entire Output Management to allow suppression of log messages.
NOMEX005 | This exit is called by Entire Output Management to allow modification of print job substitution variables.
NOMEX006 | This exit is called by Entire Output Management to make available information about completed printouts.
NOMEX007 | This exit is called by the Entire Output Management user interface when certain fields are to be modified online. This exit may set initial values for the fields and prohibit modification.
NOMEX008 | This exit is called by Entire Output Management to allow the integration of user-written application logic with Entire Output Management, allowing the storing of notes for an active report or even for a specific line of an active report. The exit is invoked whenever the status of an active report changes. A documented example is provided in the library `SYSNOMS`. Please note that this example does not store any data permanently, it is only a template to show options.
NOMEX009 | This exit is called by Entire Output Management to suppress optimization for counting lines of BS2000 input files. Assuming Rename=N (BS2000 files will not be renamed): Normally, when a BS2000 file is printed more than once by Entire Output Management, Entire Output Management will count the records in the file only once and pass this record count on for further processing. This makes sense, because Entire Output Management assumes that the contents of the file do not change. Upon special customer request, this exit was created to allow suppression of this optimization. This means that for each print to Entire Output Management the same file is counted again, because the file can change its contents and length. In this case, the flag `NOMEX009-COUNT-OPTIMIZE` should be set to false. If renaming is deactivated, reports resulting from BS2000 input files with changing contents can lead to inconsistencies. To avoid these, such reports should be stored in the NOM database; that is, they should be defined with the general attribute Store in NOM DB = Y.
NOMEX010 | This exit is called by Entire Output Management to receive or suppress a log message.
NOMEX011 | This exit is called by Entire Output Management immediately before a record is written to the required target (PC) and allows modification of browsed active report data as well as suppression and insertion of records. The object must be in a library accessible to the Entire Output Management online system. NOM221S contains a sample NOMEX011 as well as the parameter data area NOMEXP11. Output parameters for NOMEX011: `P-EXP-RC` - Return code: 0 = include record as is. 4 = include modified record (`P-EXP-RECORD`). 8 = insert `P-EXP-RECNO` lines from `P-EXP-INSERT-LINES` (next call to exit is with the same record). 12 = suppress record. 16 = terminate export with message `P-EXP-RT`. 99 = continue export without calling NOMEX011 again. `P-EXP-RT` - Error text for `P-EXP-RC` = 16. `P-EXP-RECNO` - Number of records to insert. `P-EXP-RECORD` - Modified record to be exported. `P-EXP-INSERT-LINES` - Up to 10 lines to be inserted. `P-EXP-WORK` - Work area for NOMEX011, maintained across calls.
NOMEX012 | Unused.
NOMEX013 | This user exit is called immediately before a report is opened. It will supply attributes of the active report to be opened, spool attributes, and the source attributes. Some fields can be changed and returned to Entire Output Management. For a description of what is to be tested, see the program source. Meta data can be associated with UNIX/Windows files (see also UNIX/Windows Identification Attributes in the User's Guide). These meta data are the properties of the print data. They are stored in the field `#SPOOL-ATTR-EXTENDED`.
NOMEX014 | This user exit is invoked by RMPRRP (print reports) and RMPRBU (print bundles) once at the start of a printout within the printer task to retrieve the properties of a printout - especially the extended attributes, which are stored in the field `#SPOOL-ATTR-EXTENDED`. On meta data, see also NOMEX013 above. For a description of the parameters for this user exit, see the source of NOMEX014. All parameters are input-only parameters and cannot be changed - exceptions: the fields `NOMEX014-ERROR-CODE` and `NOMEX014-ERROR-TEXT`. If an error code is set at return time, Entire Output Management will display it instead of starting the printout. If error code 5 is set, any user message can be displayed; all other error numbers will display the corresponding Entire Output Management error message with `NOMEX014-ERROR-TEXT` containing the parameters of the message.
UEX-HTML | This user exit is called by Entire Output Management during the loading of files on Linux to be able to deactivate HTML conversion. By default, HTML tags in the loaded files are converted. Note This user exit is always active when available. It cannot be activated/deactivated like the other user exits, as explained under Activating/Deactivating User Exits above.

## Default Code Pages

This function is used to specify the code pages which are to be available in Entire Output Management. The defined code pages can be used in report and node definitions.

To add/remove a code page:

1. Enter `11` in the command line of the Default Definition Menu.

   The Default Code Pages screen is displayed, listing the code pages already available in Entire Output Management.

   With PF9 you can switch the display width of the Name and Description columns.

2. To add a code page, either enter its name manually, or enter an asterisk (*) in the Name column to select it from a list. The selection list provides the names of several commonly used code pages.

3. To remove a code page, remove its name from the Name column.

   If a code page is used by any report or node definition, it cannot be removed.

Any code-page name specified on the Default Code Pages screen is automatically checked for validity (using a Natural `MOVE ENCODED` statement).

For further information on code pages, see Unicode and Code Page Support in the Natural documentation.

## Node Definitions

This section covers the following topics:

- General Information on Nodes

- Listing Node Definitions

- Defining a Mainframe Node

- Attributes of a Mainframe Node

- Defining a UNIX or Windows Node

- Attributes of a UNIX or Windows Node

### General Information on Nodes

The source of the print data processed by Entire Output Management can be either the same mainframe or UNIX environment in which Entire Output Management runs or any other supported mainframe, UNIX or Windows environment. Thus it is possible to transfer the output of any mainframe, UNIX or Windows application and process it with Entire Output Management.

The environment in which Entire Output Management runs is called local node. Any other environments are called remote nodes.

If you only process print data from the local node, you only have one node definition for the local node; this is created automatically by Entire Output Management. In addition, to process print data from remote nodes, you have to create a node definition for each remote node.

If the print data come from a remote UNIX node, the transfer of the data is done by EntireX. If they come from a remote mainframe node, the transfer of the data is done either by Entire System Server in conjunction with Entire Network or by Entire Systems Management Adapter (BS2000 only). Therefore the use of remote UNIX and Windows nodes requires that EntireX and Entire System Server on UNIX be installed, and use of remote mainframe nodes requires that either Entire System Server and Entire Network or Entire Systems Management Adapter (BS2000 only) be installed.

The print data from a remote mainframe node are copied into the trigger container file on the local node. Therefore this file has to be defined and its processing activated; see Trigger Container File.

#### Code Pages

The code page used on a remote node may be different from the one on the local node.

If the print data come from a remote UNIX node which uses a different code page, EntireX automatically converts the data to match the local code page.

If the print data come from a remote mainframe node which uses a different code page, Entire Output Management converts the data to match the local code page. This requires the following:

- The Natural profile parameters `CFICU` and `CP` have to be set for the Natural environment of the local node.

- In the node definition of the remote node, you have to specify the code page used on the remote node.

If a different code page is to be used for an individual report, you can specify this in the corresponding report definition.

For general information on code pages, see Unicode and Code Page Support in the Natural documentation.

#### Entire Operations

For Entire Output Management to be able to process Entire Operations data from remote nodes, Entire Operations has to be installed on the same local node as Entire Output Management.

### Listing Node Definitions

To list the nodes which are already defined:

1. Enter `13` in the command line of the Default Definition Menu.

   The Node Definitions screen is displayed:

        10:34:53               **** ENTIRE OUTPUT MANAGEMENT ****            2022-12-12
         User ID XYZ                  - Node Definitions -

       Cmd Node             No.   Description               System           Status
       ___ ________________ _____ _________________________ ________________ ________
        __ Monitor             40                           z/OS             Monitor
        __ cfmainframenode1    40                           z/OS             deactiv.
        __ daef             55522                           z/OS             deactiv.
        __ new_   node                                      Unix             deactiv.
        __ npr_cftest             Test Node for CF..        Unix             deactiv.
        __ npr_cftest2            test node                 Unix             deactiv.
        __ npr_cftest3            test UX node CF           Unix             deactiv.
        __ npr_daeesmv6           npr node on daeesmv6      Unix             deactiv.
        __ npr_pcevi                                        Unix             deactiv.
        __ npr_su                                           Unix             deactiv.
        __ npr_susnat2_qe         EVI node QA               Unix             deactiv.
        __ npr_susvmesm01         NPR node on susvmesm01    Unix             active
        __ npr_vmws200801         ESM82 test vm_- qe        Unix             deactiv.
        __ npr_win_pcsn4          SN's PC                   Unix             deactiv.
        __ su-1234            122 *** PRODUCTION NODE 123 D Mainframe        deactiv.
       Top Of Data
       Command => ___________________________________________________________________
        DE delete  DI display  IN info  MO modify

       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help  Add   Exit  Flip               -     +    Stat              Menu

   It lists the nodes which are already defined. The Monitor node is listed first; the other nodes are in alphabetical order of node names.

   For every node the following is displayed: its name, number, description, operating system, and status.

#### Status

See Node status under Attributes of a Mainframe Node and Attributes of a UNIX or Windows Node.

To check the current status of all active nodes, you press PF9 (Stat). For detailed status information, you use the line command `IN`.

If the status is "active" or "Monitor", the System field shows the operating system under which the node is running; for all others, it shows either "Mainframe" or "Unix".

#### Line Commands

Command | Function
--- | ---
`DI` | Display node definition.
`XR` | Xref node definition (view reports that use a certain node).
`MO` | Modify node definition.
`DE` | Delete node definition.
`IN` | Display detailed status information.

### Defining a Mainframe Node

To define a mainframe node:

1. On the Node Definitions screen, press PF2.

   A node-type selection window is displayed.

2. Select "Mainframe".

   The Mainframe Node Definition > General Attributes screen is displayed.

3. On this screen, you specify the general attributes of the node as desired.

   To specify spool attributes for it, press PF10.

The general and spool attributes are described below.

### Attributes of a Mainframe Node

#### General Attributes

Field | Explanation
--- | ---
Node name | Specify the name of the node. This field is case-sensitive.
Node number | Specify the node number which identifies the Entire System Server node. If the node is in use by any reports, you can only change the node number to one with the same spool type.
Description | You can enter a short text description of the node.
Node status | The current status of the node. Possible values: `A` = Active: The node is scanned to get output to Entire Output Management. `D` = Deactivated: A logon to this node is not possible. `S` = Suspended: A logon to this node is currently not possible; it is reactivated by the Entire Output Management Monitor as soon as a logon is possible again. This status is set automatically and cannot be changed manually. `I` = Inactive: The node is inactive and has to be (re-)started. `E` = Error: A non-recoverable error occurred, and the node is not active. To reactivate it, you have to change the status manually. `M` = Monitor: This node is automatically defined during the installation. It is defined as environment for the Monitor, is never suspended, and its status cannot be changed. The Monitor attempts to log on to each node at each Monitor cycle. If a node cannot be accessed, the Monitor will write an error message to the Monitor log once, and set the node status to "S" (Suspended). If the node is active again, a message will be written to the Monitor log that it has been reactivated, and file processing will start again.
System | Displays the operating-system type and product name of the node.
ESY user ID | Specify the user ID used to log on to the target Entire System Server.
Code page | You can specify the name of a code page to be used by the node. You can either enter the name manually, or enter an asterisk (*) or press PF1 to select it from a list. A code page is required if the Spool type (see below) is different from that of the Monitor node. For the definition of code pages, see Default Code Pages.
Spool type | Possible spool types of a node are: SPOOL, JES2 and JES3. As long as the node definition is used in any report definition, the spool type cannot be changed.

#### Spool Attributes

Field | Explanation
--- | ---
Spool Type SPOOL (BS2000)
Rename files | Enter "Y" (yes) to rename files, or "N" (no) to not rename them. Entire Output Management renames the print files during processing by adding an internal ID to make them unique. If renaming is deactivated, the option Copy files (see below) must be set to "Y" to copy the source to a container file. To avoid inconsistencies with reports resulting from BS2000 input files with changing contents, they should be stored in the NOM database; that is, the reports should be defined with the general attribute Store in NOM DB = Y.
Copy files | Enter "Y" to copy BS2000 files to an Entire Output Management container file; or "N" to not copy them. At least one destination has to be defined: for a local node, see Container Files; for a remote node, see Trigger Container File. When this option is active, the original BS2000 files will not be processed by Entire Output Management after being copied, in particular cleanup processing will not delete them.
Virtual printer | Enter the names of virtual printers (RSO) defined in BS2000. The printouts for this device are processed by Entire Output Management. (The printers must be virtual and must not be enabled for the spooling system). If the type of carriage control is not contained in the RECFORM attribute, the printout must be routed to the printer assigned to the corresponding carriage control. As of BS2000 spool version 3.0 B, exactly one virtual printer (not RSO), which can be addressed with the `PRINT-DOCUMENT` command, can be assigned to a BS2000 ID. In this case, enter *V in the recform field and leave the others empty.
Spool Type JES2
Spool classes | These fields are used to define the SYSOUT classes dedicated to Entire Output Management.
Sysout | Enter a list of SYSOUT classes to be processed by Entire Output Management. Only those jobs with SYSOUT files in these classes are processed.
Internal | Define one SYSOUT class to hold temporary SYSOUT files. This class must not be one of the classes defined in the Sysout field above.
Print | Enter the class in which reports and bundles are to be printed.
Error | Define one SYSOUT class to hold the SYSOUT files which cause an error during processing. This class must not be one of the classes defined in theSysout field above.
Spool Type JES3
Spool classes | The same as for JES2; see above.
Execution | Enter a list of execution classes to be processed by Entire Output Management. This method creates considerable performance overhead and should only be used for compatibility reasons. In future, only SYSOUT classes should be used for processing by Entire Output Management. However, if you still need this method during a transitional period: in addition to searching SYSOUT classes for output, execution classes can also be searched. In this case, the following limitations apply: no default definitions are checked for processing; messages that no report definition has been found for a certain SYSOUT file are not logged.

### Defining a UNIX or Windows Node

To define a UNIX or Windows node:

1. On the Node Definitions screen, press PF2.

   A node-type selection window is displayed.

2. Select "UNIX".

   The UNIX Node Definition screen is displayed.

3. On this screen, you specify the attributes of the node as desired.

   The fields are described under Attributes of a UNIX or Windows Node below.

### Attributes of a UNIX or Windows Node

Field | Explanation
--- | ---
Node | Enter the desired node name here. A node on a UNIX or Windows system is identified by its name, not by a node number. This name must be registered at a broker and entered in the member `SATSRV` of the library SYSSATU in a section like this:
    node_name SATSRV TYPE=ACI
              BROKER-ID=...
              SERVER-CLASS=NPR
              SERVER-NAME=...
              SERVICE=node_name
              USER-ID=...
              WAIT-TIME=30S
For details, see the Entire System Server Installation for UNIX documentation. This field is case-sensitive.
Status | The current status of the node. Possible values: `A` = Active: The node is scanned to get output to Entire Output Management. `D` = Deactivated: A logon to this node is not possible. `S` = Suspended: A logon to this node is currently not possible; it is reactivated by the Monitor as soon as a logon is possible again. This status is set automatically and cannot be changed manually. `I` = Inactive: The node is inactive and has to be (re-)started. `E` = Error: A non-recoverable error occurred, and the node is not active. To reactivate it, you have to change the status manually. `M` = Monitor: The node is defined as environment for the Monitor, is never suspended, and invokes Entire System Server on UNIX via EntireX. Used on UNIX systems. `L` = Local monitor: The node is defined as Monitor, it invokes Entire System Server as a subprogram without using EntireX. Used on UNIX systems. If UNIX nodes are defined, the Entire Output Management Monitor will try to log on to each node at each Monitor cycle. If a node cannot be accessed, the Monitor will write an error message (`NOM2026`) to the Monitor log and set the node status to "S" (Suspended). When the node is active again, a message will be written to the Monitor log that it has been reactivated, and file processing will start again.
Suspend message NOM2071 after nnnn minutes | This field can be used to suppress the repeated display of the message `NOM2026` if the node cannot be accessed. If you leave this field empty, the message `NOM2026 (Node ... has been suspended)` is issued every time the node cannot be accessed. If you specify a time interval (number of minutes): the message `NOM2026` is issued only once within the specified time interval, and the message `NOM2071 (Node ... exceeded maximum suspended time)` will be issued once when the specified time interval has been exceeded.
Descr | This field describes the node definition.
Temp | Enter a directory here where files are stored that could not be processed by Entire Output Management. This is done to keep the directories "clean" of non-processable files which would waste CPU time. A directory name must not contain wild characters, because it is used to identify file directories uniquely. The last character must be '/' (this is concatenated automatically), the back slash is not allowed. For Windows systems it will be created automatically. This field is case-sensitive.
User ID | Enter the user ID used on the target node to log on to the machine. Entire Output Management will get exactly the rights this user ID has on the specified node. This field is case-sensitive.
Passw | Enter the password used on the target node to log on to the machine. It is stored and sent across the network in an encrypted format. This field is case-sensitive.
Confirm | As the password is entered without being displayed, you have to confirm your password typing it twice. This field is case-sensitive.
Group | On UNIX systems enter the group ID here, on Windows systems it is the domain name. Leave this field blank to get to the default group / domain. This field is case-sensitive.
Paths | Enter up to 10 default paths here. When creating a report, one of these paths must be selected for the report. A directory name must not contain wild characters, because it is used to identify file directories uniquely. The last character must be '/' (this is concatenated automatically), the back slash is not allowed. For Windows systems it will be created automatically. On Windows systems drive letters (e.g. 'C:/') will be recognized. These paths are owned by Entire Output Management. The Monitor will try to find reports for any of the files, copy them to the specified container file and create active reports. Then the file in the specified directory will be deleted. If no reports are found and no default report exists, the file will be moved to the directory specified in the 'Temp' field, a time stamp will be added, and Entire Output Management will forget about it. These fields are case-sensitive.
Container DBID /FNR | Specify the database ID and file number of the container file which is connected to this path. Only the first entry is mandatory, if the other lines are left empty, they will default to the first line.

## Email Message Definitions

This section covers the following topics:

- General Information on Email Message Definitions

- Attributes of an Email Message Definition

- Listing Email Message Definitions

- Creating a New Email Message Definition

- Modifying an Email Message Definition

- Displaying an Email Message Definition

- Deleting an Email Message Definition

### General Information on Email Message Definitions

With this function, you can define certain events which will trigger the sending of emails to specified email addresses. For each error situation, you can specify which text is to be sent by email and to whom. As trigger, you can use any message number issued by Natural or Entire Output Management. In this way, you can inform the appropriate persons whenever a certain error situation has occurred.

Note
On UNIX systems, the sending of these emails requires that the mail program `mutt` is available.

#### Emergency Emails

In the case of certain severe error situations, Entire Output Management will automatically send emergency emails. These are sent if one of the following errors occurs:

Message Number | Error
--- | ---
`NAT1222` | Memory allocation errors.
`NAT1801`, `NAT1804`, `NAT1806`
`NAT3001` to `NAT3255` | Database errors.
`NAT5751` | Memory allocation errors.
`NAT6104`
`NAT9969` | Escaped from error loop.
`NOM0136` | Warning during license check.
`NOM0137` | Error during license check.

Emergency emails are provided by Entire Output Management and are not user-modifiable. However, you can specify their recipients (in the Emergency emails field of the Monitor Defaults).

### Attributes of an Email Message Definition

Field | Explanation
--- | ---
Name | The name identifying the message definition.
Subject | The title to be used as subject of the sent email.
General
Email triggers | The error number(s) which trigger(s) the sending of the email. The email will be sent if any of these errors occurs. You can specify `NATnnnn` and `NOMnnnn` message numbers. If you specify multiple numbers, separate them from each other by a semicolon. You can use asterisk notation for the message numbers. Examples: If you specify `NAT3*`, any NAT message number from `3000` to `3999` will trigger the email. If you specify `NOM*`, any NOM message will trigger the email.
Check cycle (min.) | The time interval in which Entire Output Management checks if one of the errors specified as triggers has occurred. To begin with, it is recommended to use a time interval of 30 minutes. Depending on how many emails are actually sent, you may then decide to increase or decrease the time interval. To deactivate the email message definition, you set this field to `0`.
Email text library | The Natural library in which the text member is stored. Note The NOM monitor user needs access permission for this library, set in Natural Security.
Email text member | The Natural text member which contains the email text to be sent. If the text contains the string `&MESSAGES`, this will be replaced in the actual email by the message number which triggered the sending of the email. If the text contains the string `&LAST`, this will be replaced in the actual email by the time when the trigger check was performed last. To edit the text member itself, you press PF10 (Edit)
Email addressees
From / Sender name | On UNIX systems: You specify the mail address to be used as sender. On mainframes: The internal default email address provided by Entire System Server (SEND-MAIL) will be used as sender. In addition, you can specify a sender name, which will precede the sender address when the email is sent. The sender name must not contain quotation marks.
Reply to | The email address to which the recipients' replies are sent.
Recipients | The email addresses of the email's recipients (direct, CC or BCC). If you specify multiple addresses, separate them from each other by a semicolon.
Recipients CC
Recipients BCC
To specify an email address, you place the cursor in the appropriate line and press ENTER. This will open a window in which you can specify email addresses (up to a total of 250 characters per field). Depending on the character set used, the character `@` (at sign) may not be represented correctly in some environments. Therefore it should be specified within email addresses as `(a)`.
Test email
To test an email to make sure all email addressees are specified correctly, you press PF9 (Test). A test email will be sent to all recipients, and in the case of an invalid email address an error message will be returned, indicating the address in question.

### Listing Email Message Definitions

To list all existing email message definitions:

1. Select Email message definitions (`14`) on the Default Definition Menu.

2. The Email Message Definitions screen will be displayed, listing all existing email message definitions.

   The available functions are described below.

### Creating a New Email Message Definition

To create a new email message definition:

1. On the Email Message Definitions screen, press PF2 (Add).

2. The Email Message Definition is displayed. Specify the attributes as desired.

   They are described under Attributes of an Email Message Definition.

### Modifying an Email Message Definition

To modify an email message definition:

1. On the Email Message Definitions screen, mark the definition with line command `MO`.

2. The selected Email Message Definition is displayed, and you can change it.

   The fields are described under Attributes of an Email Message Definition.

### Displaying an Email Message Definition

To display an email message definition:

1. On the Email Message Definitions screen, mark the definition with line command `DI`.

2. The selected Email Message Definition is displayed.

   The fields are described under Attributes of an Email Message Definition.

### Deleting an Email Message Definition

To modify an email message definition:

1. On the Email Message Definitions screen, mark the definition with line command `DE`.

2. Confirm the deletion.

## 3GL Interface

- Control Block

- Data Field

- Work Area

- Transaction Logic

The 3GL interface is only available on mainframes.

The 3GL interface can transfer output line by line to Entire Output Management for further processing. The interface provides the functions OPEN, PUT, CLOSE. It consists of a control block, a data field and a work area. Several lists can be transferred to Entire Output Management at the same time, but each list must have its own control block and work area.

### Control Block

Field | Offset | Length | Explanation
--- | --- | --- | ---
Function code | 0 | 2 | Possible values: 1 = OPEN 2 = PUT 3 = CLOSE 5 = End transaction 6 = Backout transaction
Carriage control character | 2 | 2 | Possible values: 1 = ASA code 2 = IBM machine code 3 = Siemens EBCDIC code 4 = without carriage control character.
Interface description | 4 | 2 | Enter the number of the interface here which you have described in the 3GL Interface Defaults.
Return code | 6 | 4 | 0 or error code.
ET possible | 10 | 2 | Reserved for internal use.
ET/BT necessary | 12 | 2 | Needed only when the caller is controlling the transaction logic (when automatic ET > 0). 0 = No open transaction. 1 = Transaction open.
Report opened | 14 | 2 | Possible values: 0 = No OPEN has been performed for this control block. 1 = A report has been opened for this control block.
Execute ET | 16 | 2 | Reserved for internal use.
Automatic ET | 18 | 2 | Possible values: 0 = Transaction logic controlled by interface. >0 = Transaction logic controlled by caller.
Database number | 20 | 2 | Database ID of the container file.
File number | 22 | 2 | File ID of the container file.
Line length | 24 | 4 | Must be supplied for the PUT function so that it can provide the line length.
Defaults at OPEN | 28 | 2 | Possible values: 0 = Default values are not written to the control block fields at OPEN. 1 = Defaults are written to fields.
Debugging | 30 | 2 | Reserved for internal use.

### Data Field

Field | Offset | Length | Explanation
--- | --- | --- | ---
Data | 0 | 251 | Contains the spool attributes during an OPEN and the print lines during a PUT.

### Work Area

Field | Offset | Length | Explanation
--- | --- | --- | ---
Work area | 0 | 4096 | Only for internal use. The work area contains compressed output among other data.

### Transaction Logic

The print lines are stored in an Adabas database. Like any other changes to a database, the stored records must be confirmed (END TRANSACTION) or rejected (BACKOUT TRANSACTION). The transaction logic can either be executed automatically by the interface or can be determined by the caller.

Bytes 1 to 63 of the spool attributes must uniquely identify the print data.

#### Automatic ET

If the field "Automatic ET" is set to "0", the interface performs an ET in the following situations:

1. during processing of the OPEN;

2. during processing of the PUT, if n records have been stored in the database since the last confirmation (n = value of "Automatic ET");

3. during processing of the CLOSE.

It is recommended to always choose "1" as the value for "Automatic ET".

#### Transaction Logic Controlled by Caller

In addition to the OPEN, PUT, CLOSE functions, you must also perform the functions END TRANSACTION and BACKOUT TRANSACTION before calling Adabas with ET or BT. After the CLOSE you must always perform an Adabas ET call.

You should only use this option when you are performing other database changes in your program. In all other cases, you should only work with "Automatic ET".

## 3GL Interface Maintenance

3GL Interface Maintenance is only available on mainframes.

A 3GL interface, among others, can serve as source for the output data to be processed. OPEN, PUT and CLOSE transfer the list data to these 3GL interfaces

OPEN transfers the interface number+attributes (spool attributes) for identification and display purposes. PUT transfers one print line at a time. A CLOSE call tells the interface that the list is complete. An entry is created for processing of the list. For further details, see the section 3GL Interface.

The 3GL maintenance functions enable you to describe your own interface. The data entered are used to interpret the spool attributes and also to dynamically generate the Report Definition > 3GL Identification and Active Reports > Spool Attributes screens.

### Invoking 3GL Interface Maintenance

To define default parameters for 3GL interfaces:

1. Enter `12` in the command line of the Default Definition Menu.

   The 3GL Interface Maintenance screen is displayed:

   It lists the defined 3GL interfaces in numerical order.

2. From this screen, you invoke the functions for 3GL interface maintenance, as described below.

### Modifying 3GL Interface Defaults

To describe the 3GL interface with the specified interface number:

1. On the 3GL Interface Maintenance screen, enter `MO` in the command line preceding the interface you want to modify.

   The following screen is displayed:

          16:29:31             **** Entire Output Management ****            2022-06-06
         UserId XYZ                - 3GL Interface Defaults -

         3GL Interface 104
           active ..................... Y
           Time Limit ................. __
           Description ................ User-defined Spool (3GL Interface 104)_______

         NOM container file
           DBID .......................     9
           FNR ........................   247

         Identifying Attributes
           Prompt                 Offset  Length  Order  Generic (*)
            1040________________    1__     8__     1_      Y
            1041________________    9__     8__     2_      N
            1042________________    17_     8__     3_      N
            ____________________    ___     ___     __      _
         File identification
            1043_______________     33_     8__

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

2. Enter the attributes to be used as prompt in the report definition and link them to the spool attributes as specified in the OPEN call (Offset, Length). The fields are described under 3GL Interface Defaults.

3. When you have finished modifying the interface, press ENTER to save your modifications.

   A message confirms the modification.

### Displaying 3GL Interface Defaults

To display the 3GL interface defaults:

- On the 3GL Interface Maintenance screen, enter the line command `DI` next to the interface defaults you want to display.

  The 3GL Interface Defaults screen is displayed for the defaults you selected. The fields are described under 3GL Interface Defaults.

### Deleting 3GL Interface Defaults

To delete the 3GL interface defaults:

1. On the 3GL Interface Maintenance screen, enter the line command `DE` next to the interface defaults you want to delete.

2. Depending on the `CONFIRM` option (see SET command), you may be prompted to confirm the deletion.

### 3GL Interface Defaults

Field | Explanation
--- | ---
3GL Interface nnn
active | Enter "Y" to activate this interface. For the Monitor to begin scanning for output arriving through this interface, you must bring it down and back up again.
Time Limit | Enter the maximum number of seconds the Monitor is allowed to scan for output arriving through the 3GL interface in one cycle. "0" means no limit.
Description | Enter a short description of the interface being defined.
NOM Container File
DBID, FNR | Enter the database ID and file number of the Adabas file to be used as spool container.
Identifying Attributes
Prompt | Enter the four-digit number (library SYSNOMU) in SYSERR of the field prompt. This text is used in the report definition to describe the identifying attributes. It will also be used in the display of spool attributes of an active report.
Offset | Enter the offset in spool attributes parameter. The value of the specific attribute will be extracted from this offset in the given length.
Length | Enter the length in spool attributes parameter. The value of the specific attribute will be extracted from the specified offset in the given length.
Order | Enter a number from 1 to 4 to specify the order in which the primary identification attributes will be evaluated.
Generic (*) | Enter "Y" if this attribute is to be used generically for report identification. Note that only one attribute can be used in this way.
File Identification

#### Example

In the 3GL interface 104 during OPEN, the user ID is in bytes 1 to 8, the terminal ID in bytes 9 to 16, the program name in bytes 17 to 24 and the list name for post selection in bytes 33 to 40.

The prompts User ID, Terminal ID, Program and List Name were stored via SYSERR in the texts of numbers 1040, 1041, 1042, 1043 in the library SYSNOMU. When 3GL interface 104 is selected for report identification, a screen like the 3GL Interface Defaults screen is displayed.

### On this page

- Invoking Default Maintenance
- System Defaults
- Monitor Defaults
- Report Defaults
- Bundle Defaults
- Automatic Archiving Defaults
- User-Defined Archives
- Automatic Reviving Defaults
- Automatic Cleanup Defaults
- CA Spool Defaults
- Natural Advanced Facilities Defaults
- Trigger Container File
- User Exits
- Default Code Pages
- Node Definitions
- Email Message Definitions
- 3GL Interface
- 3GL Interface Maintenance