Attributes of a Report

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

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


General Attributes

Start of instruction set To define the general attributes of a report:

  1. Press PF2 on the Report Maintenance screen.

    The Report Definition > General Attributes screen is displayed:

       15:12:25             **** Entire Output Management ****            13/10/2015
      User ID XYZ       - Report Definition >General Attributes -
      Report
         Name .............. _________________________
         Description ....... __________________________________________________
         Type .............. M
      Keywords ............. _______________ _______________ _______________
      Master Owner ......... ________
      Store in NOM DB ...... Y
      Archive directly ..... N
      Archive type ......... _
      Retention              Report     Archive   Revive
         Number ............ 1__        ____      ___
         Unit .............. A          _         _
         Calendar .......... ________             ________
         Action ............ P
    
      Command => ___________________________________________________________________
    
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
    
           Help  Add   Exit  Flip                          Ext               Menu
    
  2. On the Report Definition > General Attributes screen, you create a report by defining its general attributes.

    Some fields are initialized with the values specified in the Report Defaults.

  3. The following special PF keys are available:

    Key Name Function
    PF7  Ident Define Identification Attributes, which determine how reports are identified in the spool (not possible for reports of Type "C"). .
    PF8  Print Define Printing Attributes.
    PF9  Dist Define Distribution Attributes.
    PF10  Separ Define Separation Attributes, which determine how reports are separated with user routines or standard routines (not possible for reports of Type "C").
    PF21 Ext Switch between the display of long and short report names.

    Note:
    Some of these PF-key assignments are displayed only after you have entered a report name.

General Attributes - Fields

Field Explanation
Name You have to enter a report name before any other data when you create a new report. This field is write-protected when you modify an existing report.
Description Enter a short description for the report.
Type The type of report:
C = Created definition A definition created automatically during processing of a master report or default definition or copied from another created definition. You cannot define a report as type C.
D = Default definition A definition containing identification and processing rules used to process spool data not identified by a suitable master report definition.

Example: ADAREP* = all jobs whose names begin with ADAREP and which have no suitable master report definition.

M = Master report definition A definition containing identification and processing rules used to process one or more spool files.

Example: ADAREP20 = all ADAREP20 jobs.

S = Suspended definition A definition which is not currently being used.
Keywords Enter up to 3 keywords which will later help you select reports.
Master Owner The Monitor takes the user ID of the Master Owner to submit print jobs for reports to be scheduled for automatic printing. This field is initialized with the user ID of the person adding the report.
Store In NOM DB

Enter "Y" to take report contents from the spool and store them in the Entire Output Management active-data file for later viewing or archiving.

If you do not specify a storage location (Entire Output Management/ Con-nect), the report stays in the spool.

Archive directly - Y/N/I

A report can be archived from the database or directly from the spool.

Possible values:

  • Enter "Y" to archive the report automatically after creating it and when processing is completed. The contents of an active report are then no longer available online.

  • Enter "N" if you do not want automatic archiving.

  • Enter "I" for immediate archiving. The active report is archived the next time the archive job runs, but its contents are still available for online viewing until it reaches its expiry date. After this, the report contents only exist in the archive data set and the active report must be revived before it can be viewed or printed again.

Archive type If the report is to be archived to a user-defined archive, enter the number of the archive type. Enter an asterisk (*) to select an archive type. Enter "0" or leave this field empty to archive the report on a standard Entire Output Management archive file.
Retention
Report The report retention period determines how long the active report is available online for browsing and printing. If this retention period expires, the active report is either marked for archiving or purged (see the field "Action" below).
Number Enter the number of working days, absolute days, weeks or months the report is to be available online.
Unit
  • W = working days.

  • A = absolute days.

  • V = weeks.

  • M = months.

  • G = generations (instances of the active report).

If you select "working days", you also have to select a calendar which distinguishes between working and non-working days.

Calendar Select a calendar, if "working days" is the unit for the retention period.

For more information on calendars, see Calendars in the System Administration documentation.

Action

Enter "A" to archive the report when the retention period expires.

Enter "P" to purge the report when the retention period expires.

When an active report is archived, its contents are no longer available online.

Archive Enter the length of time 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.
Number Enter the number of days/weeks/months/years the active report is to be kept in the archive.
Unit
  • D = days,

  • W = weeks,

  • M = months,

  • Y = years.

Revive

Enter the length of time the contents of a revived active report are to be available online for browsing and printing. When this period expires, this "copy" of the archived report is deleted automatically.

Enter values for Number, Unit and Calendar fields as described for Report above.

Identification Attributes

A report can be identified by one of the following:

The first three are invoked by pressing PF7 (Ident) on on the Report Definition > General Attributes screen.

The others are invoked by first pressing PF7 (Ident) on on the Report Definition > General Attributes screen, and then one of the following keys on the subsequent screen:.

Key Name Identification Attributes
PF7 UNIX UNIX/Windows
PF8 3GL 3GL Interface
PF9 NAT Natural
PF10 CA CA Spool
PF11 SAP SAP Spool

Report Identification for POWER

   15:27:59             **** ENTIRE OUTPUT MANAGEMENT ****            2015-10-02
  User ID XYZ       - Report Definition >POWER Identification -
  Report
     Name .............. ADABAS-DEFAULT___________ 
  POWER Attributes
     Jobname ........... ADA*____  or  Destination ......... ________
     or Form ........... ____
  and Data Sets ........ ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
  Command => ___________________________________________________________________
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---

       Help        Exit  Flip  Do    Undo  UNIX  3GL   NAT         SAP   Menu

On the Report Definition > POWER Identification screen, you define how a report is identified in the POWER spool.

POWER Identification Attributes

The following attribute fields determine how a report is identified in the POWER spool.

Field Explanation
You must enter a value for at least one of the following three attributes. They attributes are the primary selection criteria for report definitions. A report definition is considered identified if at least one primary selection criterion is found. Note that the number of the identified definitions is limited by the primary selection criteria. Use the file names to make a secondary selection.
Jobname If you want to identify the report by the name of the originating job, enter a job name here. You can also use an asterisk (*) to enter selection criteria for the job name. For example, for all jobs beginning with IEE, enter IEE*. You can select the spool data sets in this job to be assigned to the report by filling in the "and Data Sets" fields.
Destination If you want to identify the report by the DEST parameter of the originating job, enter the destination here.
Form If you want to identify the report by the FORM parameter of the originating job, enter the form here.
and Data Sets

To specify the spool data sets in the selected jobs which identify the report(s), fill in these fields as follows:

  • LS (POWER List Queue)

  • Data set name, if spool data resides in a sequential file.

The following special characters are supported as placeholders:

  • ? (question mark) or _ (underscore):  Indicates a single position that is not to be checked.

  • * (asterisk): Indicates any number of positions not to be checked.
    Example: *EMPL_YEE*

Note:
Should this field be write-protected, remove the node name from the Report Identification for UNIX/Windows Nodes.

Note:
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 (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>
  • Maximum length of the DSN pattern to identify the data set is 22.

  • Maximum length of the input data set name is 26.

  • Carriage control = ASA, MACHINE or NONE.

  • Data set is renamed before processing.

Report Identification for BS2000/OSD

   15:20:30             **** ENTIRE OUTPUT MANAGEMENT ****            2015-08-08
  User ID NOM      - Report Definition >BS2000/OSD Identification -
  Report
     Name .............. ADAREP-DB063___________ 
  PRINT Attributes
     Pname ............. ADARE063  or  User ID ............. ________
     or Form ........... ________
  and Files ............ L.ADAREP.063*_______________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
  Command => ___________________________________________________________________
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help        Exit  Flip  Do    Undo  UNIX  3GL   NAT         SAP   Menu

On the Report Definition > BS2000/OSD Identification screen, you define how a report is identified in the BS2000/OSD spool.

BS2000/OSD Identification Atttributes

The following attribute fields determine how a report is identified in the BS2000/OSD spool.

Field Explanation

The report can be identified by the PNAME option of the BS2000/OSD print command, by the BS2000/OSD user ID or the FORM option of the print command and by the completely or partially qualified file name.

You must enter a value for at least one of the following three attributes. These attributes are the primary selection criteria for report definitions. A report definition is considered identified if at least one primary selection criterion is found.

The number of the identified definitions is limited by the primary selection criteria. Use the Files field to make a secondary selection.

Pname If you want to identify the report by the PNAME option of the BS2000/OSD print command (/Print ...,PNAME=ADAREP), enter the PNAME here. You can also use an asterisk (*) to enter selection criteria for the job name. For example, for all jobs beginning with ADA, enter ADA*.
User ID The BS2000/OSD user ID under which the print command was entered. If you want to identify the report with this ID, enter it here (for example: PROD01).
Form If you want to identify the report by the FORM parameter of the originating job, enter the form here.
Files Enter a completely or partially qualified file name which identifies the report (secondary selection). A report definition is considered identified if, in addition to one of the primary selection criteria, one of the files from the file list is selected.

Note:
Should this field be write-protected, remove the node name from the Report Identification for UNIX/Windows Nodes.

Example:

If you enter the value ADA* for Pname and the value *L.ADAREP.* for and File, all files are identified whose PNAME begins with ADA and whose file name contains the string L.ADAREP..

The following special characters are supported as placeholders:

Special Character Meaning
? (question mark)  Indicates a single position that is not to be checked.
_ (underscore)  Same as question mark.
* (asterisk)  Indicates any number of positions not to be checked.
Example: *EMPL_YEE*

The RECFORM parameter of the file allows you to determine whether the print file contains carriage control characters and which ones:

  • (F,A),(V,A),... contains ASA carriage control characters.

  • (F,M),(V,M),... contains ENDIC carriage control characters.

  • (F,N),(V,N),... contains 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.

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

Report Identification for JES

   16:00:46             **** ENTIRE OUTPUT MANAGEMENT ****            2015-08-08
  User ID XYZ       - Report Definition >JES Identification -
  Report
     Name .............. A-SAP-DEFAULT____________ 
  JES Attributes
     Jobname ........... X_______  or  Destination ......... ________
     or Writer ......... ________  or  Form ................ ______
  and Data Sets ........ ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________
                         ____________________________________________

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

On the Report Definition > JES Identification screen, you define how a report is identified in the JES spool.

JES Identification Attributes

Field Explanation

The report can be identified by job name, destination, writer or form and a spool data set qualification. You must enter a value for at least one of the first four attributes. These attributes are the primary selection criteria for report definitions. A report definition is considered identified if at least one primary selection criterion is found.

The number of the identified definitions is limited by the primary selection criteria. Use the Data Sets field to make a secondary selection.

Jobname

To identify the report by the name of the originating job, enter a job name here.

You can also use an asterisk( *) to enter selection criteria for the job name. For example, for all jobs beginning with IEE, enter IEE*. You can select the spool data sets in this job to be assigned to the report by filling in the Data Sets fields.

Destination To identify the spool data set by the Destination parameter of the originating job, enter the destination here.
Writer To identify the spool data set by the External Writer parameter of the data set, enter the writer name. This links the report to the spool data set assigned to this writer name. If you use an external writer similar to the report name, it makes identification easier.
Form To identify the report by the FORMS parameter of the originating job, enter the form here.
Data Sets See Spool Data Sets below.

Note:
Should this field be write-protected, remove the node name from the Report Identification for UNIX/Windows Nodes.

Spool Data Sets

Start of instruction setTo specify the spool data sets in the selected jobs which identify the report(s)

  • Either enter: <file-type> <file-sequence-number>

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

    For example, enter SO 1 for the first SYSOUT data set or SO 1:2 for the first and second SYSOUT data sets.

    Or:
    Enter a list of full DDNAME qualifiers in the format:

    <PROCNAME>.<STEPNAME>.<DDNAME>

    For example: PROC1.STEP1.DDN1

    PROCNAME and STEPNAME are not mandatory, and when missing are assumed to be * (any). You can use an asterisk (*) to enter selection criteria for the data set names, for example:

    *.STEP1.DDN1

    This refers to a spool data set with STEPNAME=STEP1, DDNAME=DDN1 and any procedure name.

    *.*.DDN1, *.DDN1 or DDN1, for example, are equivalent and they refer to a spool data set with DDNAME=DDN1 in any procedure name or step name in the job.

    Or:
    Enter TYPE=AL to create an active report containing all System Message and SYSOUT data sets 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 data set criterion.

Note:
If more than one JES2 spool data set of a job is to be processed by Entire Output Management, then the job's spool data sets, 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 by a program via Entire System Server functions, for example, then 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 spool data reside in a sequential file, enter the data set name. The data set name is preceded by "DSN=". The following special characters are supported as placeholders:

Character Explanation
? (question mark) Indicates a single position that is not to be checked.
_ (underline) Same as question mark.
* (asterisk) Indicates any number of positions not to be checked. Example: DSN=*EMPL_YEE*

Note:
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>

The maximum length of the DSN pattern to identify the data set is 22. The maximum length of the input data set name is 26. The STEPNAME to create the spool data set 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

   14:44:29             **** ENTIRE OUTPUT MANAGEMENT ****            2015-11-15
  User ID XYZ        - Report Definition >3GL Identification -
  Report
     Name .............. USR104-TEST______________
  3GL Interface 104 Attributes
     User ID ............ MRS*____  or    Terminal ID ........ ________  or
     Program ............ ________
  and
     List-Name .......... ______________________________________________________
                          ______________________________________________________
                          ______________________________________________________
                          ______________________________________________________
                          ______________________________________________________
                          ______________________________________________________
                          ______________________________________________________
                          ______________________________________________________
                          ______________________________________________________
                          ______________________________________________________
  Command => ___________________________________________________________________
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help        Exit  Flip  Do    Undo              Ext               Menu

On the Report Definition > 3GL Identification screen, you define a report that relies on a general, user-defined 3GL interface.

3GL Interface Identification Attributes

Field Explanation
3GL Interface nnn Attributes

(Identifying Attributes) In this group, you can enter up to 4 attributes to be used as selection criteria for report definitions. You must specify at least one of the attributes.

The Identifying Attributes of the 3GL Interface Defaults determine which attributes are displayed here and which attribute can be entered with an asterisk (*).

and (File Identification) This attribute can be used as an additional selection criterion (secondary selection). In this case, the File Identification of the 3GL Interface Defaults determines which attribute can be entered here.

See also 3GL Interface Maintenance in the System Administration documentation.

Report Identification for SAP Spool

   16:02:29             **** ENTIRE OUTPUT MANAGEMENT ****            2015-10-15
  User ID XYZ       - Report Definition >SAP-Spool Identification -
  Report
     Name .............. A-SAP-DEFAULT____
  SAP-Spool Attributes
     Destination ....... *___  or
     User ID ........... *___

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

On the Report Definition > SAP-Spool Identification screen, you define how a report is identified in the SAP spool.

SAP-Spool Identification Attributes

Field Explanation
Destination or User ID

If the report is to be identified by its destination, enter the destination.

If the report is to be identified by the user ID, enter the user ID.

You must enter a value for at least one of these fields. These attributes are the primary selection criteria for report definitions. A report definition is considered identified if at least one primary selection criterion is met.

The number of the identified definitions is limited by the primary selection criteria. Use the List IDs field to make a secondary selection.

List IDs To make a secondary selection, enter a fully or partially qualified list name that identifies the report. A report definition is considered identified if a list ID from this group is found in addition to one of the primary selection criteria.

Report Identification for CA Spool

   10:48:19             **** ENTIRE OUTPUT MANAGEMENT ****            2015-10-15
  User ID XYZ       - Report Definition >CA Spool Identification -
  Report
     Name .............. ADAREP-DEFAULT___________
 
 CA Spool Attributes
     Filename .......... ________  or
     UserID ............ ________  or
     Writer ............ ________  or
     Form .............. ____

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

On the Report Definition > CA Spool Identification screen, you define how a report is identified in the CA Spool.

CA Spool Identification Attributes

The report can be identified by one of the following attributes.

Field Explanation
File name

To identify the report by the file name, enter the file name here as it appears on the CA screen (Display Files panel). 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 more details.

User ID The user ID which created the list. If you want to identify the report with this ID, enter it here (UID field in OPEN request).
Writer To identify the report by the Writer parameter, enter the writer name here (WTR field in OPEN request).
Form

To identify the report by the FORM parameter, enter the form here (FOR field in OPEN request).

Note:
A definition is considered identified, if at least one CA Spool attribute is found.

You can also use wildcard notation (*). 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 the value ADA* for File name and the value XYZ for User ID.

Report Identification for Natural

   09:12:27             **** ENTIRE OUTPUT MANAGEMENT ****            2015-10-15
  User ID XYZ       - Report Definition >NATURAL Identification -
  Report
     Name .............. ADAREP-DEFAULT___________

  NATURAL Attributes
     *USER ............. ________  or
     *LIBRARY ID ....... ________  or
     Printer Profile ... ________

     and

     *PROGRAM .......... ________  and
     FORM .............. ________  and
     NAME .............. ________

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

On the Report Definition > Natural Identification screen, you define how a report is identified which is created by Natural or its related products like Natural Advanced Facilities or Open Print Option.

Natural Identification Attributes

Output from Natural is produced during the processing of a specific program. This program is stored in a Natural library and executed by a Natural user. The output can have various attributes defined in the DEFINE PRINTER statement. To identify this output, specify one or more identification attributes:

Field Explanation

Natural Attributes

Primary identification attributes (you must specify at least one of these):
*USER Enter a Natural user ID.
*LIBRARY ID Enter a Natural library ID.
Printer Profile Enter the name as defined in the OUTPUT option of the DEFINE PRINTER statement.
Secondary identification attributes (optional):
*PROGRAM Enter a Natural program.
FORM Enter form as defined in the DEFINE PRINTER statement.
NAME Enter name as defined in the DEFINE PRINTER statement.

Notes:

  1. Use an asterisk (*) to enter selection criteria for a field, for example, MRS* for all Natural user IDs that begin with MRS. You can use asterisk notation for all attributes except Printer Profile.
  2. A first selection is made by the primary attributes, considerably reducing the number of definitions. A definition is applied to the print file, if at least one primary attribute is matched. All secondary attributes for which you have entered values must be matched.

For example: If you enter the value EBU for *USER and the value SYSNOM for *LIBRARY ID, all print files are identified which were either created by user ID EBU or created in the library SYSNOM.

Report Identification for UNIX/Windows Nodes

11:37:40 ****             ENTIRE OUTPUT MANAGEMENT ****            2015-11-15
 User ID XYZ            - Report Definition >UNIX Identification -
 Report
    Name ................... Report________________

 UNIX Attributes
    Node Name .................. node_name_______ Read-binary... _
    Path:
    e:/Nomdir/
    and Files ......... file*_pattern_____________________________________
                        __________________________________________________
                        __________________________________________________
                        __________________________________________________
                        __________________________________________________
                        __________________________________________________
                        __________________________________________________
                        __________________________________________________
                        __________________________________________________

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

On the Report Definition > UNIX Identification screen, you define how a report is identified on UNIX or Windows nodes.

UNIX/Windows Identification Attributes

Identification is done using node name, path, and file pattern. ASCII files are scanned in the specified directory and matched to the file pattern specified here. These files are moved to an Entire Output Management container file and can be processed as usual. An ASCII file 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. Their format is converted to Base64 format and stored in a container file. At the time of printing, the file is re-converted to binary format.

In addition to the files residing in the file system under UNIX or Windows, the Entire Output Management identification process can process meta data. 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. This format corresponds to the meta-data files processed by the Open Print Option; see Installing the Open Print Option. This requires that the Monitor has to be enabled to process XML files; see Configuration of Entire Output Management on Mainframes.

Output from a UNIX or Windows application is stored as a sequential ASCII file in a directory defined here. The monitor will move (not copy!) this file to an Entire Output Management container file and create active reports. If no report definition matches the file name pattern and no default report was found, the file cannot be processed and will be moved to a temp directory that has been defined for this node by the administrator function UNIX Defaults. File and path names are case-sensitive; node name and path have to be defined in UNIX Defaults first, as well as logon data for this node.

Field Explanation
Node name Enter a node name that has been predefined by the administrator using the function UNIX Defaults. This field is case-sensitive.
Read binary

Possible values:

  • T = The report will be created from a UNIX file as text file.

  • B = The report will be created from a UNIX file as binary document.

Output from a UNIX or Windows application is stored as a sequential ASCII file in a directory defined here. The monitor will move (not copy!) this file to an Entire Output Management container file and create active reports.

If no report definition matches the file name pattern and no default report was found, the file cannot be processed and will be moved to a temp directory that has been defined for this node by administrator function UNIX Defaults.

File and path names are case-sensitive, node name and path have to be defined in UNIX Defaults first, also logon data for this node. Details see below.

Path Select a path from the default definition entered with administrator using the function UNIX Defaults. Use PF11 for selection. Path definitions must not contain wild characters. The defined path is owned by Entire Output Management. The monitor will process any file found in this path. Directories are not processed. If a file is found in this directory which cannot be processed, it will be moved to the 'Temp' directory (see explanation above). If the path definition in UNIX Defaults is changed, the definition in this field will not change automatically. In this case, use PF11 to select a new path. This will ensure that an "old" report definition will still work, even if the defaults change.
Files Enter up to 10 files or file patterns without path entries. Wild cards * and ? can be used to insert placeholders for many (*) or one single (?) character(s) in the file name. For each file matching the pattern, an active report will be created. However, the file contents will be copied to the container file for each path only once. After the file has been processed, it will be deleted on the UNIX or Windows node. File names are case-sensitive.

Distribution Attributes

Start of instruction set To define or modify the distribution attributes:

  1. Press PF9 on the Report Definition > General Attributes screen.

    The Report Definition > Distribution Attributes screen is displayed:

       15:36:54             **** ENTIRE OUTPUT MANAGEMENT ****            2015-11-15
      User ID XYZ      - Report Definition >Distribution Attributes -
      Report
         Name .............. FVSE-DB__________________
    
      Distribution via NOM
         User/List ......... DC-GROUP ________ ________ ________ ________
                             ________ ________ ________ ________ ________
    
      Distribution via CON-NECT
         Cabinet ........... ________
         Subject ........... ____________________________________________
         Mail to ........... ________ ________ ________ ________ ________
                             ________ ________ ________ ________ ________
    
      Command => ___________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip  Do    Undo              Ext   Layot       Menu
    
  2. On this screen, you define the recipients of a report and the facilities used for distribution.

  3. You can use PF10 to specify different Report Layout Attributes for different addresses of the report.

Distribution Attributes - Fields

Field Explanation

Distribution via NOM

User/List

Enter up to 10 user IDs or distribution list names. When the report is created, all users connected to user IDs or distribution lists entered here can access this report, and can browse, print etc.

A user ID selection window or a distribution list selection window can be opened by entering an asterisk * (or a selection criterion ending in an asterisk) in this field. For more information, see the section Selecting Users to Receive a Report.

AUTOPRNT

To automatically print a report with a special layout, you have to define an Entire Output Management user ID AUTOPRNT. Then add AUTOPRNT to the "Distribution via NOM" list of users and give it the required layout, which will then be applied to the printed report. However the report will not actually be distributed to the user AUTOPRNT, so it is not possible to log on as AUTOPRNT and view any active reports.

Distribution via Con-nect

Cabinet

Enter the name of a Con-nect cabinet, where you want the report contents to be created as a Con-nect document (optional).

If you do not want to create a document in a user cabinet, but wish to distribute it to Con-nect users directly, leave this field empty and only fill in the Mail To fields below. In this case, the report is created in a Con-nect stand-alone cabinet named SYSNOMC.

Subject Enter a description to appear with the Con-nect document.
Mail To Enter up to 10 Con-nect user IDs if you want to distribute the report directly to Con-nect users. One copy of the report is created in the Con-nect stand-alone cabinet named SYSNOMC. Entire Output Management uses Con-nect to send the report to all Con-nect users defined in these fields.

Selecting Users to Receive a Report

Start of instruction setTo select a user or group of users on a distribution list:

  1. Enter an asterisk (*), or a selection criterion ending in an asterisk, in a User/List field on the Report Definition > Distribution Attributes screen.

    The Member Name window is displayed.

  2. Press:

    • PF4 to display a list of all users; or

    • PF5 to display a list of all distribution lists.

    A selection window is displayed, listing all users / distribution lists defined for your Entire Output Management system.

  3. Enter any character in the field preceding the desired user / distribution list.

    The user ID / distribution list name is written to the User/List field.

    When the report is produced, it is distributed to the "inbasket" of the user; in the case of a distribution list all users on the list receive the report. The user(s) can then browse and print the report.

    You can also restrict users' view of the report by defining an individual report layout; see Report Layout Attributes.

Report Layout Attributes

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, all members of the list will see the specified layout.

These layouts are only for addressees in Entire Output Management. Addressees in Con-nect see the entire report.

Start of instruction set To define a layout for a user or distribution list:

  1. On the Report Definition > Distribution Attributes screen, place the cursor on a User/List field containing a user ID or list name and press PF10 (Layot).

    The Report Definition > Layout Attributes screen is displayed:

       15:40:42             **** ENTIRE OUTPUT MANAGEMENT ****            2015-11-15
      User ID XYZ      - Report Definition >Layout Attributes -
      Report
         Name .............. FVSE-DB__________________
         User/List ......... DC-GROUP
    
                             From  To
         Layout ............ ___   ___
                             ___   ___
                             ___   ___
                             ___   ___
                             ___   ___
                             ___   ___
                             ___   ___
                             ___   ___
                             ___   ___
                             ___   ___
         Headerlines ....... ___
      Command => ___________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip  Do    Undo   -     +    Ext               Menu
    
  2. You can define up to 10 different layouts for each report to be distributed to different addressees. A report layout consists of up to 10 pairs of offsets. The positions are counted from the beginning of a report line (not including ASA/machine codes).

    Field Explanation
    From / To For each column to be displayed, you the specify the first and last position to be displayed.
    Header Lines Here you specify the number of lines - counting from the top of the page - which are to remain in their original format.

    For more information on layout, see the section Modifying the Layout of an Active Report.

Printing Attributes

Start of instruction set To define or modify printing attributes:

  1. Press PF8 (Print) on the Report Definition > General Attributes screen.

    The Report Definition > Printing Attributes screen is displayed:

       12:05:13             **** ENTIRE OUTPUT MANAGEMENT ****            2015-11-15
      User ID XYZ       - Report Definition >Printing Attributes -                  
      Report                                                                        
         Name .............. XYZ-XML__________________                              
      Hold Logic ........... _                                                      
      Printers ............. ________ ________ ________ ________ ________           
      Copies ............... ___      ___      ___      ___      ___                
      Separator Pages                                                               
         Start ............. ________                                               
         End ............... ________                                               
         Copies ............ ___                                                    
         Length ............ ___                                                    
      Style.. ______________________________________________________________________
      Jobcards                                                                      
         ________________________________________________________________________   
         ________________________________________________________________________   
         ________________________________________________________________________   
                                                                           
      Command => ___________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip  Do    Undo              Ext   Edit  Prtr  Menu  
    

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

Printing Attributes - Fields

Field Explanation
Hold Logic

This field controls how the report is queued for printing. Enter one of the following values:

  • H (Hold) - The report is held in the printout queue until released manually.

  • C (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.

  • R (Release) - The report is printed immediately.

Printers

Enter the names of up to 5 logical printers on which to print the report when it is created.

For a selection list, enter an asterisk (*).

To specify more than 5 printers, use PF11; see Additional Printers below.

Copies Enter the number of copies of the report to be printed on each printer.
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.
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.

To edit a separator page, position the cursor on the Start or End field, and press PF10 (Edit).

Style If the report is being printed on an XML-type printer, you can specify the URL of a default stylesheet. This stylesheet will be used for XML documents, which specify file://EOM/* in the XML stylesheet href. For further information see XML Printers.
Jobcards

Enter the job cards for printing with batch jobs.

The following substitution variables can be used: §USER, §REPORT, §JOBNAME.

If you leave this field blank, the Jobcards specifications from the logical printer definition are used.

Additional Printers

Start of instruction set To select additional printers:

  1. Press PF11 (Prtr) on the Report Definition > Printing Attributes screen.

    The Report Definition > Additional Printers screen is displayed.

  2. You can specify up to 15 additional printers.

    Field Explanation
    Printers Enter the names of the logical printers on which to print the report. For a selection list, enter an asterisk (*).
    Copies Specify how many copies of the report are to be printed on each printer.

Formatting Attributes

Note:
The functionality described in this section is not yet available. It will be made available with the next version.

A report which has one of the formats text, PDF or PostScript can be converted to a common multimedia file when it is loaded. The target format is the one in which the data will be stored in Entire Output Management.

For general information on report conversion, see Converting the Report Format in the Concepts and Facilities documentation.

For this report conversion, you define formatting attributes.

Start of instruction set To define formatting attributes:

  1. Press PF11 on the Report Definition > General Attributes screen.

    The Report Definition > Formatting Attributes screen is displayed.

    On this screen, you specify the formatting attributes for the file conversion. The first three attributes are mandatory, the others are optional. The attribute fields are:

Field Explanation
Report Format The desired output format. Predefined formats are available, which correspond to the following Ghostscript devices:
Format
Ghostscript device
BMP bmp16m
EPS epswrite
FAX faxg3
HTML html
JPEG jpeg
PCL pxlcolor
PDF pdfwrite
PNG png16m
PS ps2write
RTF rtf
TIFF tiff32nc

Any other value in this field will be interpreted as the name of a Ghostscript device which may be present in the specific user environment. See the Ghostscript documentation for details.

If this field is empty, no file conversion will be performed.

Conversion Node The Entire System Server node name (as defined in the UNIX Defaults) to be used to convert the file to the desired format.
Conversion Path The path to be used for temporary files during file conversion on the conversion node.
Enscript Attributes (optional)
Header The name of the Enscript "fancy-header". If this field is empty, no header will be generated. If this field contains DEFAULT, the Enscript default fancy-header will be used.
Header Font The font name and font size of the header and footer.
Footer The footer definition.
Font The font name and font size of the text report.
Lines The number of lines per page for a text report.
Landscape If this field is empty, the pages will be created in portrait orientation. If you want landscape orientation, enter any character in this field.
Media The paper size to be printed.
Mask File

The name of a PDF file which can overlay all pages of a report that is in PDF format. This file is treated as a "stamp" on each page: Only the parts of the mask file which are transparent will show the original report. In this way, logos can be integrated in a report. If the mask file contains more than one page, the corresponding pages of the report will be overlaid.

The use of mask files requires that the package "pdftk (PDF Toolkit) is installed on the conversion node.

A PDF file with transparent parts cannot be created with a Windows PDF printer; instead, you have to use the "export to PDF" function of a graphic application (e.g. Photoshop or Gimp).

Code Page Specify the code page in which the text report is to be stored. If this field is empty, the code page "latin1" (ISO-8859-1) will be used by default.
Additional In this field, you can specify any additional parameters.
For details on the above Enscript attributes, see the Enscript documentation (man page).

Separation Attributes

Start of instruction set To define or modify separation attributes:

  • Press PF10 (Separ) on the Report Definition > General Attributes screen.

    The Report Definition > Separation Attributes screen is displayed:

       15:41:21             **** ENTIRE OUTPUT MANAGEMENT ****            2015-11-15
      User ID XYZ       - Report Definition >Separation Attributes -
    
      Report
         Name .............. FVSE-DB__________________
    
      Create Definition .... _
    
      Standard Routine ..... __
    
      User Routine
        NATURAL Member ..... ________
        NATURAL Library .... ________
        3GL ................ ________
      Command => ___________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip  Do    Undo              Param Edit  Trace Menu
    

    On this screen, you define whether a user routine or a standard routine is to be used.

Special PF Keys

Key Name Function
PF9  Param Define parameters for the user routine or standard routine.
PF10  Edit Edit Natural member for user routine.
PF11  Trace Trace processing of a user routine. See Tracing Report Processing.

Separation Attributes - Fields

Field Explanation
Create Definition When active reports are dynamically created during a standard separation or user separation process, the corresponding report definitions are usually created automatically. To suppress automatic creation, enter an "N" here. This is useful when creating unique active reports.
Standard Routine Enter "1", "2" or "3" to indicate which standard routine is to be used. For more information on the standard routines, see Using a Standard Separation Routine.
User Routine

Note:
If no user routine or standard routine is specified, the whole identified spool data set is contained in the report.

If a user routine is required, enter the member name and the library name in the appropriate fields as described in the following.

The spool data set 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.

The following fields are used to define the user routine which determines the report contents:

Natural Member Enter the name of the Natural member containing the user routine. Press PF10 (Edit) to edit this member.
Natural Library The user routine can be a Natural subprogram. You can enter the Natural library name containing the user routine or leave this field blank. The library name must not begin with SYS, unless it is SYSNOMU.
3GL If the user routine is written in a language other than Natural, enter the name of the routine. This user routine is invoked by a CALL statement.

Defining User Routine Parameters

Start of instruction set To define or modify parameters for a user routine:

  1. Press PF9 (Param) on the Report Definition > Separation Attributes screen.

    The Report Definition > User Separation window is displayed.

  2. In this window, you can specify up to 5 parameters which are passed to the user routine at the start of report processing.

Using a Standard Separation Routine

A Standard Separation Routine is a method supplied by Software AG for separating or filtering spool data sets. When you use such a routine, you must supply parameters which tailor further processing.

Three standard separations are available:

Standard Separation 1

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.

Standard Separation 1 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.

Note:
When separating POWER spool data sets, make use of container files. The spool data set is compressed and copied into a database file before processing. For more information on container files, see Monitor Defaults in the System Administration documentation.

Start of instruction set To define or modify the use of Standard Separation 1:

  1. Enter "1" in the Standard Routine field on the Report Definition > Separation Attributes screen and press PF9 (Param).

    The Report Definition > Standard Separation 1 screen is displayed.

  2. On this screen, you define the attributes described below.

Fields

Field 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 Search Line, then 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.

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 do not specify Suffix Line, Entire Output Management assumes that the suffix is located in the Search Line.
Start Column 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.
End Column 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.
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

(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 Report Definition with Standard Separation 1 - Salary Report:

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:

   15:43:45             **** ENTIRE OUTPUT MANAGEMENT ****            2015-11-15
  User ID XYZ       - Report Definition >Standard Separation 1 -
  Report
     Name .............. PWR-EMPL-STD1-S__________
  Search
     Line .............. 2__
     String ............ *Employee List sorted by Departments*______________
  Suffix
     Line .............. 3__
     Start Column ...... 55_
     End Column ........ 58_

  Prefix: Reports ...... DEPTS1-__________________
          Bundles(1-2).. DEP-_____________________ _________________________
                 (3-4).. _________________________ _________________________
                 (5).... _________________________

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

Note:
The bundle prefix is optional.

This standard routine separates the spool data set 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 data set 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 DEP- prefix to the suffix found in the spool data set, 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

Standard Separation 2 separates spool data into several reports depending on up to 5 break conditions.

Standard Separation 2 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 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.

Note:
When separating POWER spool data sets, make use of container files. The spool data set is compressed and copied into a database file before processing. For more information on container files, see the section Monitor Defaults in the System Administration documentation.

Start of instruction set To define or modify the use of Standard Separation 2:

  1. Enter "2" in the Standard Routine field on the Report Definition > Separation Attributes screen and press PF9 (Param).

    The Report Definition > Standard Separation 2 screen is displayed.

  2. On this screen, you define the attributes described below.

Fields

Field 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 Search Line, then 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 no string is found, the page is added to the currently opened reports. If no report is opened, 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.

Suffix
You can define parameters for up to 5 suffixes in the following three fields.
Li 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 do not specify Suffix Li(ne), Entire Output Management assumes that the suffix is located in the Search Line.
CF (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.
CT (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 (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. If long report and bundles names are displayed, only 1 bundle prefix is displayed for each suffix. To process the other bundle prefixes, press PF10 or PF11. The number of the currently displayed prefix appears after the title Bundle Prefix.

Example of Report Definition with Standard Separation 2 - Salary Report:

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:

  19:00:10             **** ENTIRE OUTPUT MANAGEMENT ****            2015-11-15
 User ID XYZ       - Report Definition >Standard Separation 2 -
 Report
    Name .............. PWR-EMPL-STD2-S__________
 Search
    Line .............. 2__
    String ............ *Employee List sorted by*_________________________

 SuffixLi/CF/CT  Report Prefix              Bundle Prefix 1
 ______________  _________________________  _________________________
  3__  55_  58_  STD21-___________________  DEP-_____________________
  3__  55_  60_  STD22-___________________  DEP-_____________________
  ___  ___  ___  _________________________  _________________________
  ___  ___  ___  _________________________  _________________________
  ___  ___  ___  _________________________  _________________________

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

Note:
The bundle prefix is optional.

This standard routine separates the spool data set 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 3) or by adding the prefix STD22- to the sub-department name (Columns 55-60 in Line 3) 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 DEP- prefix 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

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.

Start of instruction set To define or modify the use of Standard Separation 3:

  1. Enter "3" in the Standard Routine field on the Report Definition > Separation Attributes screen and press PF9 (Param).

    The Report Definition > Standard Separation 3 screen is displayed.

  2. On this screen, you define the attributes described below.

Fields

Feld Erklärung
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.
String

Enter the string to be searched for. If this string appears on a page, the page is processed. If no string is found, 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.

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 on a page at least one line, 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:

  • AND - concatenates with logical AND.

  • OR - concatenates with logical OR.

  • (blank) - concatenates the same variable with OR=.

For an example, see below.

Col From/to Indicates 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).
F

Format. Variable type (first column) and relational expression (second column).

Possible variable types:
  • A = Alphanumeric.

  • M = Mask as described in the Natural Reference documentation.

  • N = Numeric.

Possible relational expressions:
EQ, =  Equal to
GE, >=  Greater than or equal to
GT, >  Greater than
LE, <=  Less than or equal to
LT, <  Less than
NE, !  Not equal to
Value Enter a numeric or alphanumeric value or a mask definition.

Note:
If most of these lines are rejected, set "Store in NOM DB=Y" (on the Report Definition > General Attributes screen). The selected lines are copied to the Entire Output Management database and the spool data set can be deleted.

Example 1 of Report Definition with Standard Separation 3 - 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):

   15:45:40             **** ENTIRE OUTPUT MANAGEMENT ****            2015-08-15
  User ID XYZ       - Report Definition >Standard Separation 3 -
  Report
     Name .............. PWR-EMPL-STD3-D3_________
  Search
     Line .............. 3__
     String ............ *COMP12*__________________________________________
  Header Lines ......... 8_
  Start Line ........... 9__
     and/or Col From/to F    Value
     ______ ___________ _ __ __________________________________________________
              55_ 62_   N GE 6000000___________________________________________
       AND    65_ 65_   A EQ M_________________________________________________
       AND    67_ 74_   A LE 50/01/01__________________________________________
       ___    ___ ___   _ __ __________________________________________________
       ___    ___ ___   _ __ __________________________________________________

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

The lines 1 to 8 are taken as header lines. The filter starts in Line 9.

Example 2 of Report Definition with Standard Separation 3 - Natural CATALL Report:

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

   15:45:40             **** ENTIRE OUTPUT MANAGEMENT ****            2015-11-15
  User ID XYZ       - Report Definition >Standard Separation 3 -
  Report
     Name .............. NOM-CATALL-ERRORS________
  Search
     Line .............. 3__
     String ............ *- Error Report -*________________________________
  Header Lines ......... __
  Start Line ........... 6__
     and/or Col From/to F    Value
     ______ ___________ _ __ __________________________________________________
              16_ 19_   N NE 0_________________________________________________
       OR_    65_ 65_   N NE 0_________________________________________________
       ___    ___ ___   _ __ __________________________________________________
       ___    ___ ___   _ __ __________________________________________________
       ___    ___ ___   _ __ __________________________________________________
  Command => ___________________________________________________________________
 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
       Help        Exit  Flip  Do    Undo              Ext               Menu

No header lines are added. The filter starts in Line 6 on pages with the string - Error Report - in Line 3.