Attributes of a Report

#### Search Results

Search

# Attributes of a Report

This section describes the attributes which are part of a report definition:

- General Attributes

- Identification Attributes

- Distribution Attributes

- Printing Attributes

- Separation Attributes

Default values for report attributes can be set by the system administrator in Report Defaults.

## General Attributes

On this screen you define the general attributes of a report.

### Fields: General Attributes

Field | Explanation
--- | ---
Report name | Enter a report name before any other data when creating a new report. This field is write-protected when you modify an existing report.
Node name | Select the node name the report definition is to be associated with. This node determines the environment in which the data source for the report is to be identified.
Description | Enter a short description for the report.
Type | Created | A definition created automatically by separation definitions during the processing of a master report or default definition or copied from another created definition. Next to the Type field, the name of the originating report definition is displayed. The type "Created" cannot be set or changed manually.
Default | A definition containing identification and processing rules used to process spool data not identified by a suitable master report definition. To have a default definition for all jobs for which no suitable master definition exists, you create a default definition with the name `*` (asterisk). For a default definition to apply to all jobs without master definition whose names begin with a certain character string, you can specify a name with asterisk notation.
Master | A definition containing identification and processing rules used to process one or more spool files.
Suspended | Use this type for a definition which is currently not to be used.
Master owner | The user ID specified here is used to initialize the Master owner field in the General Attributes of the resulting active report. It determines who may delete the active report. The monitor also takes this user ID to submit print jobs for reports to be scheduled for automatic printing. This field is initialized with the ID of the user who creates the report. If you wish, you can select a different user ID.
Keywords | Enter up to 3 keywords which will later help you select reports.
Copy report content to NOM database | Select Yes to take the report contents from the spool and store them in the Entire Output Management active-data file for later viewing or archiving. Otherwise, select No. If you do not specify a storage location, the report stays in the spool.
Retention The retention period determines how long the active report is available online for viewing and printing. When this retention period expires, the active report is archived/deleted depending on the selected Action.
Action | Purge report after | The report will be deleted when the retention period expires. It will not be archived.
Archive report after | The report will be archived when the retention period expires.
Archive report directly and keep online for | The report will be archived the next time the archive job runs, but is still available online until the retention period expires.
Archive report directly, purge online immediately | The report will be archived the next time the archive job runs, and deleted from the spool when its processing is completed.
When an active report is archived, it is no longer available online. After this, it exists only in the archive data set. The active report has to be revived before it can be viewed or printed again.
Number / Unit / Calendar | Specify the length of time (a number and a unit of time) for the selected Action. The unit of time can be: absolute days, working days, weeks or months. If you choose "working days", you also have to choose a calendar. For more information on calendars, see Calendars in the System Administration documentation. With the unit Generations you can specify the number of instances of the active report to be kept. If this number is exceeded, older active reports will be archived/deleted depending on the selected Action.
Archive Type | If the report is to be archived in a user-defined archive, select the desired archive type. Select "none" to archive the report in a standard Entire Output Management archive file.
Archive for | Specify the length of time (a number and a unit of time: days, weeks, months or years) the active report is to be kept in the archive. When this period expires, the active report is deleted from the archive data set. An active report can be archived no matter where it is stored.
Keep revived report ready for | Specify the length of time (a number and a unit of time) a revived active report is be available online for viewing and printing. When this period expires, this "copy" of the archived report is deleted automatically. The unit of time can be: absolute days, working days, weeks or months. If you choose "working days", you also have to choose a calendar. For more information on calendars, see Calendars in the System Administration documentation.

## Identification Attributes

A report can be identified by one of the following:

- Report Identification for POWER

- Report Identification for BS2000

- Report Identification for JES

- Report Identification for 3GL Interface

- Report Identification for CA Spool

- Report Identification for Natural

- Report Identification for UNIX/Windows Nodes

### Report Identification for POWER

#### POWER Identification Attributes

The following attributes determine how a job in the POWER spool is identified by the report definition.

Field | Explanation
--- | ---
Identifying attributes | You have to enter a value for at least one of these three attributes. A job is considered identified if it matches at least one of the specified attributes.
Job name | If you want to identify the job by its name, enter the job name here. You can use an asterisk notation (*) for the job name. For example, to identify all jobs whose names begin with "IEE", you enter `IEE*`.
Destination | If you want to identify the job by its `DEST` parameter, enter the destination here.
Form | If you want to identify the job by its `FORM` parameter, enter the form here.
Filter for spool files and sequential files | Use these fields to select the files whose contents are to be used as print data for the active report. For an active report to be created, at least one file of the job has to match these filter criteria. You specify the spool files in the identified jobs which are to be assigned to the report. You specify them as follows: `LS` = POWER List Queue. `DSN=data-set-name`, if the spool data reside in a sequential file. The following special characters can be used to create a file-name pattern: ? (question mark) or _ (underscore) to indicate a single position not to be checked. * (asterisk) to indicate any number of positions not to be checked. Example: `DSN=NATURAL.*EMPL_YEE*`
Code page | By default, Entire Output Management uses the code page defined for the respective node and applies it to all report definitions associated with that node. If you want to use a different code page for a particular report, select the desired code page here. If you do not want to use a report-specific page, select "none". For the definition of code pages, see Default Code Pages.

Note
The processing of sequential files is also triggered by spool queue entries. The corresponding spool file does not contain print data, but an entry with a link pointing to the sequential file. This entry can be created with any utility (for example, a Natural program) and must have the following attributes:

    NOM DSN=data-set-name VOL=volser
    NOM RECFM=recform RECSIZE=record-length
    NOM BLKSIZE=block-size CC=carriage-control

- `data-set-name` may have a maximum length of 22 characters.

- `carriage-control` may be `ASA`, `MACHINE` or `NONE`.

Before processing, the file name is extended with a time stamp to make it unique.

### Report Identification for BS2000

#### BS2000 Identification Attributes

The following attributes determine how a job in the BS2000 spool is identified by the report definition.

Field | Explanation
--- | ---
Identifying attributes | You have to enter a value for at least one of these three attributes. A job is considered identified if it matches at least one of the specified attributes.
Pname | If you want to identify the job by the `PNAME` option of the BS2000 print command (`/Print ...,PNAME=ADAREP`), enter the PNAME here. You can use asterisk notation (*) to for the job name. For example, to identify all jobs whose names begin with "ADA", you enter `ADA*`.
User ID | If you want to identify the job by the BS2000 user ID under which the print command was entered, enter this user ID here (for example: `PROD01`).
Form | If you want to identify the job by its `FORM` parameter, enter the form here.
Filter for spool files and sequential files | Use these fields to select the files whose contents are to be used as print data for the active report. For an active report to be created, at least one file of the job has to match these filter criteria. You specify a completely or partially qualified file name which identifies the report. A report definition is considered identified if, in addition to one of the identifying attributes, one of the files from the file list matches. The following special characters can be used to create a file name pattern: ? (question mark) or _ (underscore) to indicate a single position not to be checked. * (asterisk) to indicate any number of positions not to be checked. For example, if you enter `ADA*` in the Pname field and `*L.ADAREP.*` in this field, all files are identified whose `PNAME` begins with `ADA` and whose file name contains the string `L.ADAREP.`.
Code page | By default, Entire Output Management uses the code page defined for the respective node and applies it to all report definitions associated with that node. If you want to use a different code page for a particular report, select the desired code page here. If you do not want to use a report-specific page, select "none". For the definition of code pages, see Default Code Pages.

#### Carriage Control Characters

The `RECFORM` parameter of the file allows you to determine whether the print file contains carriage control characters and which ones. It is specified as follows:

`RECFORM=(x,y)`

where:

- `x` = `F` for fixed record length, or `V` for variable record length.

- `y` determines the type of carriage control characters:

  - `A` = ASA carriage control characters,

  - `M` = machine-code carriage control characters,

  - `N` = no carriage control characters.

It is recommended that files with a fixed record length be used, because positioning within them is easier than within files with a variable record length.

Note
Files with fixed record length that were expanded with OPEN-EXTENT are not supported.

### Report Identification for JES

#### JES Identification Attributes

The following attributes determine how a job in the JES spool is identified by the report definition.

Field | Explanation
--- | ---
Identifying attributes | You have to enter a value for at least one of these four attributes. A job is considered identified if it matches at least one of the specified attributes.
Job name | To identify the job by its name, enter a job name here. You can use asterisk notation (*) for the job name. For example, to identify all jobs whose names begin with "IEE", you enter `IEE*`.
Destination | To identify the job by the `Destination` parameter, enter the destination here.
Writer | To identify the job by the `External Writer` parameter, enter the writer name. This links the report to the spool file assigned to this writer name. If you use an external writer similar to the report name, it makes identification easier.
Form | To identify the job by the `FORMS` parameter, enter the form here.
Filter for spool files and sequential files | Use these fields to select the files whose contents are to be used as print data for the active report. For an active report to be created, at least one file of the job has to match these filter criteria. You can specify which spool files (data sets) in the identified jobs are to be assigned to the report. See Spool Files and Sequential Files below.
Code page | By default, Entire Output Management uses the code page defined for the respective node and applies it to all report definitions associated with that node. If you want to use a different code page for a particular report, select the desired code page here. If you do not want to use a report-specific page, select "none". For the definition of code pages, see Default Code Pages.

#### Spool Files

To specify the spool files in the selected jobs, you use one of the following three possibilities:

1. Specify: `file-type file-sequence-number`

   where `file-type` can be: `JL` = JCL statements, `SI` = system input, `SM` = system messages, `SO` = system output.

   Examples:

   - Specify `SO 1` for the first SYSOUT file.

   - Specify `SO 1:4` for the first to fourth SYSOUT files.

2. Specify a list of full DDNAME qualifiers in the format:

   `proc-name.step-name.ddname`

   `proc-name` and `step-name` are not mandatory, and if omitted are assumed to be * (any). You can use an asterisk (*) to enter selection criteria for the file names.

   Examples:

   - `PROC1.STEP1.DDN1` is a full qualifier.

   - `*.STEP1.DDN1` refers to a spool file with `STEPNAME=STEP1`, `DDNAME=DDN1` and any procedure name.

   - `*.*.DDN1` or `*.DDN1` or `DDN1` are equivalent and refer to a spool file with `DDNAME=DDN1` in any step name or procedure name in the job.

3. Specify `TYPE=AL` to create an active report containing all System Message and SYSOUT files for a job matching the specified JES attributes. The job must have at least one spool file in one of Entire Output Management's managed classes. `TYPE=AL` must be the only file criterion.

Note
If more than one JES2 spool file of a job is to be processed by Entire Output Management, the job's spool files which are to be processed must all have the same group ID and all be together in a class reserved for Entire Output Management. If this is not achieved by the DD statements, but, for example, by a program via Entire System Server functions, the view `SPOOL-UPDATE` should be used as follows:

    PROCESS SPOOL-UPDATE
            USING  FUNCTION   = 'CHANGE'
            USING  JOB-NAME   = #JOB-NAME
            USING  JOB-NUMBER = #JOB-NUMBER
            USING  GROUP-ID   = #GROUP-ID
            USING  CLASS      = #NOM-CLASS
            USING  NODE       = #NODE
            GIVING ERROR-CODE
                   ERROR-TEXT

#### Sequential Files

If the report data reside in a sequential file, enter the file name in the form `DSN=file-name`.

The following special characters can be used to create a file-name pattern:

- ? (question mark) or _ (underscore) to indicate a single position not to be checked.

- * (asterisk) to indicate any number of positions not to be checked.

Example: `DSN=NATURAL.*EMPL_YEE*`

Note
The processing of sequential files is also triggered by spool queue entries. The corresponding spool file does not contain print data, but points to the sequential file. The pointer can be created with any utility and must have the following attributes:

    NOM DSN=data-set-name

`data-set-name` may have a maximum length of 22 characters.

The `STEPNAME` to create the spool file must be `NOMDSN`.

#### Example:

    //JOB 1         JOB...
    ......
    //NOMDSN       EXEC       PGM=IEBGENER
    //SYSPRINT      DD          SYSOUT=*
    //SYSUT2         DD          SYSOUT=3
    //SYSIN            DD          DUMMY
    //SYSUT1         DD *
    NOM  DSN=OUTPUT.LISTING
    /*

### Report Identification for 3GL Interface

For the definition of reports that rely on a general, user-defined 3GL interface, all identifying attributes can be freely chosen.

### Report Identification for CA Spool

#### CA Spool Identification Attributes

These attributes determine how a job in the CA spool is identified by the report definition. A job can be identified by one of the following four attributes. You have to specify a value for at least one of these fields. A job is considered identified if it matches at least one of the specified attributes.

Field | Explanation
--- | ---
File name | To identify the job by the file name, enter the file name here as it appears on the CA screen. The file name can contain the user ID of the file creator, the job name or a parameter entered in the `OWN` field in an `OPEN` request. See the CA Spool documentation for details.
User ID | To identify the job by the ID of the user who created the list, enter the user ID here (`UID` field in `OPEN` request).
Writer | To identify the job by the `Writer` parameter, enter the writer name here (`WTR` field in `OPEN` request).
Form | To identify the job by the `FORM` parameter, enter the form here (`FOR` field in `OPEN` request).

You can use asterisk notation (*) for the file name. For example, to identify all files whose names begin with "ADA", enter `ADA*`. Or, to identify all files which were either created by the user "XYZ" or whose names begin with "ADA", enter `ADA*` for File name and`XYZ` for User ID.

### Report Identification for Natural

On this screen, you define how a report is identified which is created by Natural or its related products like Natural Advanced Facilities.

Output from Natural is produced during the processing of a specific Natural program, which is stored in a Natural library and executed by a Natural user. The output can have various attributes defined in the program's `DEFINE PRINTER` statement.

The Identifying attributes are used as selection criteria for output under Natural. A report is considered identified if it meets at least one of these criteria. You have to specify at least one identifying attribute.

In addition, you can specify one or more Filter criteria to further narrow down the selection. All specified filter criteria must be met for a successful identification.

The output data of the program will be used as print data when an active report is created.

Field | Explanation
--- | ---
Identifying attributes
Natural user ID | Enter a Natural user ID or a Natural library ID (but not both).
Natural library ID
Printer profile | Enter the name as defined in the `PROFILE` option of the `DEFINE PRINTER` statement.
Filter (optional)
Natural program | Enter the name of a Natural program.
Natural form | Enter the form as defined in the `FORMS` option of the `DEFINE PRINTER` statement.
Natural report name | Enter the name as defined in the `NAME` option of the `DEFINE PRINTER` statement.

You can use asterisk notation (*) for all attributes, except Printer Profile. For example, to select all programs executed by users whose IDs begin with "MRS", you specify `MRS*` as the user ID. Or, if you enter the user ID value `ABC` and the printer profile value `NOMPRT`, all print files are identified which were created either by the user "ABC" or with the printer profile "NOMPRT".

### Report Identification for UNIX/Windows Nodes

On this screen, you define how a report is identified on UNIX or Windows nodes.

#### UNIX/Windows Identification Attributes

The identification is done using the node name and path, and a file-name pattern. Entire Output Management will process any file found in this path, if it matches one of the specified file names or file-name patterns. Directories are not processed (no recursion).

For every matching file, an active report will be created. For this purpose, the file contents will be copied to the Entire Output Management container file. Then the file will be deleted from the path.

For any file not matching one of the criteria, Entire Output Management checks if an appropriate default report exists. If none exists, the file cannot be processed and will be moved to a temporary directory defined for this node in the Node Definitions instead.

ASCII files can contain line feeds, form feeds and tabulators; any other kind of control character will be ignored and set to blank.

Binary files can be of any format. They are stored in the container file in Base64 format. At the time of printing, they are re-converted to binary format.

In addition to the identified files, associated meta-data files can be processed. If a pair of files such as `file-name.extension` and `file-name.extension.nomxml` is found, the `nomxml` file is treated as a meta-data file in XML format.

Node names, path names and file names are case-sensitive. Node names and paths have to be defined in the Node Definitions first.

Field | Explanation
--- | ---
Node name | Select a node name.
Path | Select a path. Path definitions must not contain any wildcard characters.
Filter for file names | Enter up to 10 files, or file-name patterns, without path entries. File extensions are treated as part of the file name. In a file-name pattern, you use an asterisk (*) as placeholder for several characters and a question mark (?) for a single character in the file name.
Read binary | If this field is not selected, the report will be created from a UNIX file as a text file. If this field is selected, the report will be created from a UNIX file as a binary document.
Source contains ASA control characters | Mark this field if the report is to be created as a text file and the print data from the data source already contain ASA control characters. These will then be used, and additional ASA control characters will not be generated.

## Distribution Attributes

- Distribution via NOM

- Defining a Layout for a User or Distribution List

On this screen you can define the recipients of a report and the facilities used for distribution.

### Distribution via NOM

You can select up to 10 users or distribution lists. When the active report is created, it is distributed to the `#Inbasket` folders of the selected users. All users connected to IDs or lists entered here can browse and print the report.

To select a user or distribution list for receiving a report:

1. Choose the Select button under Distribution via NOM.

   The Select Users / Distribution Lists window is displayed in the content pane:

2. Select a user/list from the list of Users or list of Distribution Lists.

3. Choose the down arrow on the right.

   The selected user/list appears in the Selected Members section at the bottom of the dialog:

4. Choose OK.

   The selected user ID or list name now appears in the Distribution via NOM section of the Distribution Attributes.

To remove a user or distribution list from the Distribute To list:

1. Select an entry on the list.

2. Choose the Delete button below the list.

   The selected user/distribution list is removed from the list.

### Defining a Layout for a User or Distribution List

Note
You cannot combine a report layout definition with separation attributes. You can only use either one or the other.

You can restrict a user's view of the report by defining a user-specific report layout. In this layout, you specify the parts of the layout which are to be visible to the user.

You can define a different layout for each addressee of the report. If the addressee is a distribution list, the specified layout is visible to all members of the list.

To define a layout for a user or distribution list:

1. Select the desired user/list.

2. Choose the Layout button.

   The Layout for User window is displayed:

3. You can define up to 10 columns of the report which are to be displayed to the selected user/list. The fields available to do this are described below. The user(s) will see only the specified columns.

4. In the field Start layout below report line, enter the line number (counting from the top of the page) below which the layout definition is to take effect.

   Lines above and including this line remain in their original format.

5. For each column to be displayed, you specify the first and the last position to be displayed in the from position and to position fields.

   The positions are counted from the beginning of a report line (not including ASA/machine codes).

   The specified positions will be shown in the Select range for layout column field.

   Or:
   Click on a column number (1 to 10). Then mark the desired range of positions in the field Select range for layout column with the cursor, and select Apply.

   The positions thus selected will be shown in the from/to position fields for the column.

   For easier orientation, you can copy text lines from the original report to the clipboard, and then select Paste clip to paste them into the display area. You can copy several lines, but only line by line.

6. When you have specified all columns to be displayed, choose OK.

#### Automatic Printing with Special Layout

If a report is to be automatically printed with a special layout, define `AUTOPRNT` as an addressee and attach the special layout to that addressee (the report will not be distributed to `AUTOPRNT`). To use this facility, you must also define a user `AUTOPRNT`.

## Printing Attributes

- Fields: Printing Attributes

- Selecting Printers for a Report

On this screen you can define how reports are printed automatically.

### Fields: Printing Attributes

Field | Explanation
--- | ---
Hold Logic | This field controls how the report is queued for printing. Choose one of the following values from the drop-down list box:
(none) |
Release manually | The report is held in the printout queue until released manually.
All users confirm | The report is held in the printout queue until manually confirmed by all recipients. A message requesting printing confirmation is displayed to each user in the distribution list. When all users have confirmed, the report is automatically released for printing.
Release immediately | The report is printed immediately.
Separator Pages | Start | Enter the name of the separator page to be printed at the beginning of the report. To edit the corresponding text member, you use the Edit button next to the field.
End | Enter the name of the separator page to be printed at the end of the report. To edit the corresponding text member, you use the Edit button next to the field.
Copies | Specify how many times each separator page is to be printed.
Length | Enter a separator line length, if your separator line length is greater than your report length. The default length is the report length.
See Separator Pages for further information.
Jobcards | Enter the job cards for printing with batch jobs. The following substitution variables can be used: `§USER`, `§REPORT` and `§JOBNAME`. If you leave this field blank, the Jobcards specifications from the logical printer definition are used.
Printers | Printers | The IDs of the printers on which the report will be printed. To add a printer to the list, see Selecting Printers for a Report below.
Copies | The number of copies of the report to be printed on this printer.
Separator | Determines whether or not the Separator Pages (see above) are printed on this printer. By default, they are printed on all printers listed (as indicated by an "X"). If this is not desired, you can change this specification for individual printers.
To change the Copies and Separator specifications, select a printer ID and choose the Modify button. In the fields below the Printers list, you can then change them for the selected printer.

### Selecting Printers for a Report

To select one or more printers for a report:

1. In the Printers section of the Printing Attributes screen, choose the Select button.

   The Select Printers window is displayed:

2. In the Printers section at the top, select a printer ID.

3. Choose the down arrow on the right.

   The printer ID is written to the list of Selected Printers in the bottom section of the window.

4. Choose OK.

   The selected printer now appears in the Printers section of the Printing Attributes screen.

## Separation Attributes

Note
You cannot combine separation attributes with a report layout definition. You can only use either one or the other.

For separation you can use one of the following:

- User Separation

- Standard Separation 1

- Standard Separation 2

- Standard Separation 3

The routines for standard separation are supplied by Software AG.

If no user routine or standard routine is specified, the whole identified spool file is contained in the report.

Field | Explanation
--- | ---
Separation Routine | Select the routine to be used.
Create report definitions for active reports by separation. | By default, when active reports are created dynamically during a separation process, the corresponding report definitions are created automatically. To suppress this automatic creation, select No. This may be useful if you create unique active reports.

### User Separation

- How User Separation Works
- Attributes of User Separation

#### How User Separation Works

The spool file records can be filtered on a record-to-record basis by a supplied user routine. With various action codes, the user routine can control the separation process and positioning within the output and can determine the contents of the created reports.

For more information, see User Separation Routines in the System Administration documentation.

#### Attributes of User Separation

Field | Explanation
--- | ---
User routine | Natural member | Enter the name of the Natural subprogram containing the user routine. To edit the subprogram, you use the Edit button next to the field.
Natural library | Enter the name of the Natural library which contains the subprogram. A library name beginning with `SYS` must not be specified, except `SYSNOMU`.
3GL | If the user routine is written in a language other than Natural, enter its name here. This user routine is invoked by a `CALL` statement.
Parameter | You can enter up to 5 parameters which are passed to the user routine at the start of report processing.

### Standard Separation 1

- How Standard Separation 1 Works
- Attributes of Standard Separation 1
- Example of Standard Separation 1

#### How Standard Separation 1 Works

Standard Separation 1 separates spool data into several reports depending on the break of the specified suffix. The suffix need not appear in sorted order. This separation searches for a defined string in a defined line or anywhere on a page. If the string appears on a page, a suffix is evaluated (at break of the suffix value, a new report is opened). If the string is not found, the page is added to the currently open report. If no report is open, the page is rejected.

#### Attributes of Standard Separation 1

Item | Explanation
--- | ---
Search | Line | Enter the line number, starting from the top of the page, where the string must appear. To determine this line number, you must also count lines containing only carriage control characters. If you do not specify a line number, the search string can appear anywhere on the page.
String | Enter the string to be searched for. If this string appears on a page, the suffix is evaluated (at break of the suffix value, a new report is opened). If the string is not found, the page is added to the currently open report. If no report is open, the page is rejected. You can specify a search pattern like: `*STRING1*STRING2*` or: `*STRING1%STRING2*` where * stands for any string and % stands for any character. Note You must bracket the string with * (for example: *string*) if it can occur anywhere within a line.
Suffix | Line | Enter the line number, starting from the top of the page, where the report suffix appears. To determine this line number, you must also count lines containing only carriage control characters. If you leave this field empty, Entire Output Management assumes that the suffix is located in the Search Line.
Column from | Enter the position in the line where the report suffix starts (value from 1 to 251). To determine the position, you must also count carriage control codes and/or table reference characters.
Column to | Enter the position in the line where the report suffix ends (value from 1 to 251). To determine the position, you must also count carriage control codes and/or table reference characters.
Prefix | Reports | Enter the report prefix which is concatenated to the suffix to determine the report name. The suffix is concatenated suppressing leading and trailing blanks.
Bundles 1 to 5 | (Optional) Enter the bundle prefix which is concatenated to the suffix to determine the bundle name. The suffix is concatenated suppressing leading and trailing blanks. Up to 5 bundles can be specified. To generate bundles with fixed names, fill in this field completely. No suffix is then appended.

#### Example of Standard Separation 1

We have a salary report sorted by department number and want to separate it into the various departments. A standard routine could be defined as follows to perform an automatic separation:

This standard routine separates the spool file on a page basis and creates reports whose names begin with `DEPTS1-`. The report name is created by adding the prefix `DEPTS1-` to the suffix found in the spool file in the positions defined in the example above, for example: `DEPTS1-FINA`.

Optionally, the report can be directed to a bundle with the prefix `DEP-`. The bundle name is created by adding the prefix `DEP-` to the suffix found in the spool file, for example: `DEP-FINA`.

Note
When the suffix and the identifier string are not on the same line, the line parameters must be used. Enter the line numbers where the identifier string and suffix are found. This must be the absolute line number as counted from the top of the page.

### Standard Separation 2

- How Standard Separation 2 Works
- Attributes of Standard Separation 2
- Example of Standard Separation 2

#### How Standard Separation 2 Works

Standard Separation 2 separates spool data into several reports depending on up to 5 break conditions. It searches for a defined string in a defined line or anywhere on a page. If the string appears on a page, up to 5 suffixes are evaluated (at the break of a suffix value, a new report is opened for that suffix). If no string is found, the page is added to the currently opened reports. If no report is opened, the page is rejected.

#### Attributes of Standard Separation 2

Field | Explanation
--- | ---
Search
Line | Same as described for Standard Separation 1.
String
Suffix - Prefix (summary) - You can define parameters for up to 5 suffixes in these fields
Line | Enter the line number, starting from the top of the page, where the report suffix appears. To determine this line number, you must also count lines containing only carriage control characters. If you leave this field empty, Entire Output Management assumes that the suffix is located in the Search Line.
Column from | Enter the position in the line where the report suffix starts (value from 1 to 251). To determine position, you must also count carriage control codes and/or table reference characters.
Column to | Enter the position in the line where the report suffix ends (value from 1 to 251). To determine position, you must also count carriage control codes and/or table reference characters.
Report Prefix | Enter the report prefix which is concatenated to the suffix to determine the report name. The suffix is concatenated suppressing leading and trailing blanks.
Bundle Prefix 1 to 5 | (Optional) Enter the bundle prefix which is concatenated to the suffix to determine the bundle name. The suffix is concatenated suppressing leading and trailing blanks. Up to 5 bundle prefixes can be specified for each suffix. To generate bundles with fixed names, fill in this field completely. No suffix is then appended. The number of the currently displayed prefix appears after the title Bundle Prefix.

#### Example of Standard Separation 2

We have a salary report sorted by department number and want to separate it into the various main departments and sub-departments. A standard routine could be defined as follows to perform an automatic separation:

This standard routine separates the spool file on a page basis and creates reports whose names begin with `STD21-` for the main departments and `STD22-` for the sub-departments. The report name is created by adding the prefix `STD21-` to the department name (columns 55-58 in line 2) or by adding the prefix `STD22-` to the sub-department name (columns 55-60 in line 2) found in the spool data.

Optionally, the report can be directed to a bundle with the prefix `DEP-`. The bundle name is created by adding the prefix `DEP-` to the department or sub-department name.

Note
When the suffix and the identifier string are not on the same line, the line parameters must be used. Enter the line numbers where the identifier string and suffix are found. This must be the absolute line number as counted from the top of the page.

### Standard Separation 3

- How Standard Separation 3 Works
- Attributes of Standard Separation 3
- Examples of Standard Separation 3

#### How Standard Separation 3 Works

Standard Separation 3 searches for a defined string in a defined line. If the string appears on a page, the lines of the page are analyzed regarding the defined logical expression. If not, the whole page is rejected.

From the Start line until end of page, the lines are added to the report, if they match the defined logical expression. Lines before the Start line are also rejected unless they are defined as Header lines.

#### Attributes of Standard Separation 3

Field | Explanation
--- | ---
Search | Line | Same as described for Standard Separation 1.
String
Header lines | Enter the number of lines (0-20), starting from the top of the page, which are used as header lines. To determine this line number, you must also count lines containing only carriage control. If Header lines = 0, no header lines are added. Otherwise, if there is at least one line on a page which matches the separation's logical expression, the header lines are added.
Start line | Enter the line, starting from the top of the page, from which filter processing starts. The lines preceding the Start line are automatically excluded from the report, unless they are defined as Header lines. To determine this line number, you must also count lines containing only carriage control characters.
AND/OR | Concatenates two conditions. Possible values:
Operator | Meaning
`AND` | Concatenates with logical AND.
`OR` | Concatenates with logical OR.
(blank) | Concatenates the same variable with OR=.
Column from | Indicate the position of the operand. Enter positions in column from which to start and at which to end filter processing (value from 1 to 251).
Column to
Format | Variable type: `A` = Alphanumeric. `M` = Mask (as described in the Natural Reference documentation). `N` = Numeric.
Relational Expression | Possible values:
Operator | Meaning
`EQ` or `=` | Equal to.
`GE` or `>=` | Greater than or equal to.
`GT` or `>` | Greater than.
`LE` or `<=` | Less than or equal to.
`LT` or `<` | Less than.
`NE` or `!` | Not equal to.
Value | Enter a numeric or alphanumeric value or a mask definition. Note If most of these lines are rejected, set Copy report content to NOM database to "Yes" (in the General Attributes). The selected lines are copied to the Entire Output Management database and the spool file can be deleted.

#### Examples of Standard Separation 3

#### Example 1 - Salary Report

We have a salary report sorted by department number and want to extract all employees with sex = M, personnel ID number >= 6000000 and birthday <= 50/01/01 (sub-department COMP12):

Lines 1 to 7 are taken as header lines. The filter starts in line 8.

#### Example 2 - Natural CATALL Report

We have a CATALL list and want to extract all lines with error number unequal to 0:

No header lines are added. The filter starts in line 5 on pages with the string `.Error Report.` in line 2.

### On this page

- General Attributes
- Identification Attributes
- Distribution Attributes
- Printing Attributes
- Separation Attributes