Maintenance Functions for Active Reports

This section covers the following topics:


Listing Summary of Active Reports in a Folder

Start of instruction set To list a summary of the active reports filed in a folder:

  1. The List Layout field on the Folder Definition > General Attributes screen must be defined as 1 (summary).

  2. On the Active Reports > Folder Maintenance screen, enter the line command LI next to the appropriate folder.

    The Active Reports > Summary screen will be displayed:

       12:37:01             **** ENTIRE OUTPUT MANAGEMENT ****            2018-06-06
      User ID XYZ            - Active Reports>Summary -                   Loc: B
                                                                                    
      Cmd Report                    Description                                NumRp
      ___ _________________________ __________________________________________ _____
       __ FHILINES                  Get Output From SB NJ(FHILINES)               23
       __ XSETGGR-LINES             test report from SB JL FHILINES               15
       __                                                                           
       __                                                                           
       __                                                                           
       __                                                                           
       __                                                                           
       __                                                                           
       __                                                                           
       __                                                                           
       __                                                                           
       __                                                                           
       __                                                                           
       __                                                                           
       __                                                                           
     All                                                                            
      Command => ___________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip               -     +    Ext    <     >    Menu   
    

    The screen lists the reports filed in the folder.

Line Commands

Command Function
DD  Display active report definition.
LI  List active reports for a report definition.

Fields

Field Explanation
Report (*) The report name is displayed in this column. You can enter a report prefix followed by an asterisk (*) to list only selected reports.
Description A short description for the report.
NumRp

The number of active reports filed in this folder for the respective report definition.

If a default location is specified in the folder definition (see Creating a New Folder), the number refers only to the active reports of this location. The field Loc in the top right corner of the screen indicates the default location.

Listing Active Reports for a Report Definition

Start of instruction set To list active reports for a selected report definition:

  1. On the Active Reports > Summary screen (or on the Report Maintenance screen), enter the line command LI next to the appropriate report definition.

    The following screen is displayed:

       12:39:35             **** ENTIRE OUTPUT MANAGEMENT ****            2018-06-06
      User ID XYZ              - Active Report List -                           
                                                                                    
      Report ........ XSETGGR-LINES                                                 
      Description ... test report from SB JL FHILINES                               
                                                                                    
      Cmd Creation       RunNmbr      Lines   A R L  Rep.Exp. Arc.Exp. Rev.Exp.     
      ___ ___________ __ ___________ ________ _ _ B __________ ______ ________      
       __ 20071219 12:35       10995       50 I   S 20080219                        
       __ 20071218 19:59       10994       50 I   S 20080218                        
       __ 20071218 19:59       10993       50 I   S 20080218                        
       __ 20071218 18:16       10991       50 I   S 20080218                        
       __ 20071218 18:05       10989       50 I   S 20080218                        
       __ 20071212 08:56       10908       50 I   S 20080212                        
       __ 20071212 08:54       10906       50 I   S 20080212                        
       __ 20071211 19:55       10902       20     S 20080211                        
       __ 20071211 19:55       10901       40     S 20080211                        
       __ 20071211 19:55       10900      100     S 20080211                        
       __ 20071204 19:02       10313      100     S 20080204                        
       __ 20071204 18:57       10310      100     S 20080204                        
     Top Of Data                                                                    
      Command => ___________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip               -     +    Ext    <     >    Menu   
    
  2. From this screen, you can perform maintenance functions on active reports by marking the desired report with the appropriate line command.

The following active reports are listed:

  • All active reports in folder:
    If you invoke this function from the Active Reports > Summary screen, all active reports for the selected report definition in the folder are listed.

  • All active reports mailed to user ID:
    If you invoke this function from the Report Maintenance screen, and you are defined as a General User, all active reports mailed to your user ID for the selected report definition are listed.

  • All active reports for report definition:
    If you invoke this function from the Report Maintenance screen, and you are defined as Administrator, all active reports for the selected report definition are listed.

Line Commands

Command Function
AR  Mark an active report for archiving or reset archive flag. The next time the archiving task is active, it copies the active report contents to a magnetic media, which can be restored later.
BR  Browse the contents of the active report. This function invokes the Software AG Editor.
BU  Add the active report to an active bundle that is in Opened status.
CP  Confirm printing of an active report. (Available when a report is defined with the CONFIRM option.) The active report is printed only when all target users confirm printing.
DE  Delete an active report.
DI  Display general attributes of an active report.
DD  Display the underlying report definition.
DS  Distribute an active report to an additional user.
FI  File an active report in another folder.
MO  Modify an active report.
PR  Print an active report.
RV  Mark an archived active report for reviving or reset the revive flag. The active report is restored from the magnetic media to its original location the next time the reviver is active.
SP  Display spool attributes of active report.
US  List users connected to active report.
XB  Cross-reference an active report, that is, display all bundles in which the active report is contained..

Fields

Field Explanation
Mail Date/Time

Date and time when the active report was mailed to your user ID. Enter:

  • <(date in system format) to display all active reports mailed before the date;

  • =(date in system format) to display all active reports mailed on the date;

  • >(date in system format) to display all active reports mailed after the date.

RunNmbr Internal sequence number of the active report.
Lines The number of lines in the active report. For binary active reports, their size is displayed in KB (indicated by a "K" after the number).
A * This is the "Archive" flag. You can enter the following values as selection criteria to display:
  • * - Active reports which have been successfully archived.

  • A - Active reports which are marked for archiving. They are archived when the archiving task is started.

  • I - Active reports which are marked for archiving but which should be retained for on-line viewing until their retention period expires.

  • R - Active reports which have been archived and retained for on-line viewing until their retention period expires.

  • P - Active reports which have been archived and for which the retention period has already expired.

  • blank - Leave blank to display all active reports regardless of archive status.

R *

This is the "Revive from Archive" flag. You can enter the following values as selection criteria to display:

  • * - Active reports which have been successfully revived.

  • D - Active reports which are marked for reviving from archive to Entire Output Management active-data file.

  • S - Active reports which are marked for reviving from archive to spool.

  • blank - Leave blank to display all active reports regardless of revive status.

L *

This is the "Location" flag. It indicates the current storage location for the active report. You can enter the following values as selection criteria to display:

  • * - All active reports, regardless of storage location.

  • A - Active reports currently archived.

  • B - Active reports currently available for online viewing.

  • D - Active reports currently stored in the Entire Output Management active-data file.

  • S - Active reports currently stored in the spool or in a container file.

  • blank - Leave blank to display all active reports regardless of revive status.

Rep.Exp. Report expiration date. The active report is available online until this date.
Arc.Exp. Archive expiration date. The active report is kept in the archive until this date.
Rev.Exp. Revive expiration date. If the active report has been revived from the archive, the copy created is available online until this date.
Message Indicates whether or not the printing of the active report must still be confirmed: CONFIRM means that it must still be confirmed, CONFIRMED means that it has been confirmed. If NOMEX008 is in use (see the section NOM User Exits), this field contains return data from NOMEX008.
Source/sender The source and sender of OPO online reports. Source is the PC name of the OPO user; or, if the user is logged on to a domain, the domain name. Sender is the user ID of the OPO user.

Listing Active Reports in a Folder

Start of instruction set To list the active reports filed in a folder:

  1. The folder attribute List Layout must be defined as 2 (descriptive attributes) or 3 (technical attributes).

  2. On the Active Reports > Folder Maintenance screen, enter the line command LI next to the appropriate folder.

    The Active Report List > Folder screen will be displayed:

        12:40:45             **** ENTIRE OUTPUT MANAGEMENT ****            2018-06-06
      User ID XYZ        - Active Report List >Folder #Inbasket        -       Loc: B
    
      Cmd Report                    Mail Date/Time Description                      
      ___ _________________________ ___________ __ _________________________________
       __ FHILINES                  20080117 10:56 Get Output From SB NJ(FHILINES)  
       __ FHILINES                  20080115 18:56 Get Output From SB NJ(FHILINES)  
       __ FHILINES                  20080115 18:54 Get Output From SB NJ(FHILINES)  
       __ FHILINES                  20080114 08:34 Get Output From SB NJ(FHILINES)  
       __ FHILINES                  20080111 16:41 Get Output From SB NJ(FHILINES)  
       __ FHILINES                  20080111 16:41 Get Output From SB NJ(FHILINES)  
       __ FHILINES                  20080111 16:41 Get Output From SB NJ(FHILINES)  
       __ FHILINES                  20080111 16:29 Get Output From SB NJ(FHILINES)  
       __ FHILINES                  20080111 16:29 Get Output From SB NJ(FHILINES)  
       __ FHILINES                  20080111 16:29 Get Output From SB NJ(FHILINES)  
       __ FHILINES                  20080103 16:30 Get Output From SB NJ(FHILINES)  
       __ FHILINES                  20071220 15:52 Get Output From SB NJ(FHILINES)  
       __ FHILINES                  20071220 15:50 Get Output From SB NJ(FHILINES)  
       __ FHILINES                  20071220 14:53 Get Output From SB NJ(FHILINES)  
       __ FHILINES                  20071220 14:42 Get Output From SB NJ(FHILINES)  
     Top Of Data                                                                    
      Command => ___________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip               -     +    Ext    <     >    Menu
    

Descriptive Attributes

If you defined List Layout as 2, the above screen, containing descriptive attributes of the active reports, is displayed when you invoke the LI command. The screen lists the active reports in the selected folder which are currently located in the default location (as specified in the folder definition). The reports are listed in descending order of mailing dates.

Technical Attributes

The descriptive attributes section is actually the left half of the complete Active Report List > Folder screen.

  1. You can display the technical attributes for the active reports, which are contained on the right half of the Active Report List > Folder screen, by pressing PF11 (>):

       17:32:42             **** ENTIRE OUTPUT MANAGEMENT ****            2018-06-06
      User ID XYZ       - Active Report List >Folder #Inbasket        -             
                                                                                    
      Cmd Report                    created        RunNmbr     Lines    A R L       
      ___ _________________________ ________ _____ ___________ ________ _ _ B       
       __ DIRECT-INPUT              20080116 15:05       11242      74K     S       
       __ DIRECT-INPUT              20080116 15:05       11241      52K     S       
       __ DIRECT-INPUT              20080116 15:05       11239    1141K     S       
       __ DIRECT-INPUT              20080116 15:05       11245       6K     S       
       __ FHILINES                  20080117 10:56       11246        1     S       
       __ FHILINES                  20080115 18:56       11237       33     S       
       __ FHILINES                  20080115 18:54       11236       33     S       
       __ FHILINES                  20080114 08:34       11235       33     S       
       __ FHILINES                  20080111 16:41       11232       33     S       
       __ FHILINES                  20080111 16:41       11233       33     S       
       __ FHILINES                  20080111 16:41       11234       33     S       
       __ FHILINES                  20080111 16:29       11230       33     S       
       __ FHILINES                  20080111 16:29       11231       33     S       
       __ FHILINES                  20080111 16:29       11229       33     S       
       __ FHILINES                  20080103 16:30       11011       33     S       
     Top Of Data                                                                    
      Command => ___________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip               -     +    Ext    <     >    Menu
    
  2. If you defined List Layout as 3, the above screen, containing technical attributes of the active reports, is displayed when you invoke the LI command. The screen lists active reports in the selected folder in descending order of creation dates. The information displayed is explained below.

    With PF11 (>) you can display further technical attributes.

Special PF Keys

Key Name Function
PF10  < Display descriptive attributes.
PF11  > Display technical attributes.

Line Commands

See Line Commands under Listing Active Reports for a Report Definition.

Fields

Field Explanation
Report (*) Report name. Enter selection criteria for the active report name.
Mail Date/Time

Date and time the active report was mailed to your user ID. Enter:

  • <(date in system format) to display all active reports mailed before the date;

    =(date in system format) to display all active reports mailed on the date;

    >(date in system format) to display all active reports mailed after the date.

Description A short description of the report is displayed here.
Created The date on which the active report was created.
RunNmbr Internal sequence number.
Lines The number of lines in active report. For binary active reports, their size is displayed in KB (indicated by a "K" after the number).
A, R, L See Fields under Listing Active Reports for a Report Definition.
Expires The active report is available online until this date.
Message Indicates whether or not the printing of the active report must still be confirmed: CONFIRM means that it must still be confirmed, CONFIRMED means that it has been confirmed. If NOMEX008 is in use (see the section NOM User Exits), this field contains return data from NOMEX008.
Source/sender The source and sender of OPO online reports. Source is the PC name of the OPO user; or, if the user is logged on to a domain, the domain name. Sender is the user ID of the OPO user.

Listing Active Reports with a Keyword

Start of instruction set To list active reports archived in a folder using a selected keyword:

  1. On the Active Reports > Folder Maintenance screen, enter the line command LK next to the desired folder.

    A window is displayed.

  2. In the window, enter a keyword to list the active reports to which this keyword is assigned.

    Or:
    Enter a prefix ending with an asterisk (*) to list the active reports to which the keyword with prefix entered is assigned.

    The Active Reports screen is displayed (in the layout as specified with the folder attribute List Layout).

See Attributes of a Report for more information about keywords.

Modifying an Active Report

The attributes of an active report are initialized during report creation according to the rules defined in the respective report definition.

Start of instruction set To modify the attributes of an active report:

  1. On the Active Report List or Active Report List > Folder screen, enter the line command MO next to the desired active report.

    The Active Report > General Attributes screen is displayed, showing the general attributes of the active report:

       13:19:41             **** ENTIRE OUTPUT MANAGEMENT ****            2018-06-06
      User ID XYZ         - Active Report>General Attributes -
    
      Report
         Name .............. UKSJU-XML2
         Run number ........ 32530
         Description .......
         Location .......... S
    
      Keywords ............. _______________ _______________ _______________
      Master Owner ......... UKSJU___
    
      Retention                          Contents
         Number ............ 5__            Number of Lines ... 1004
         Factor ............ A              CC Type ...........
         Calendar .......... ________       Record Length ..... 133
         Action ............ P
    
      Expiration Date ...... 2011-10-15
    
    
      Command => ___________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Flip                    Archv Reviv Spool       Menu
    
  2. Change the attributes as desired. They are described under Attributes of an Active Report

  3. For the other attibutes, use the following PF keys:

    Key Name Function
    PF8  Archv Invoke the archive attributes.
    PF9  Reviv Invoke the revive attributes.
    PF10  Spool Invoke the spool attributes.

Displaying an Active Report

Start of instruction set To display the general attributes of an active report:

  • On the Active Report List or Active Report List > Folder screen, enter the line command DI next to the desired active report.

    The Active Report > General Attributes screen is displayed. The attributes are described under Attributes of an Active Report

Start of instruction set To display the spool attributes of an active report:

  • On the Active Report List or Active Report List > Folder screen, enter the line command SP next to the desired active report.

    Or:
    After invoking the Active Report > General Attributes screen with the line command DI or MO, press PF10 (Spool).

    The Active Report > Spool Attributes screen is displayed, showing the attributes of a spool file. The attributes displayed may differ depending on the spool system of the operating system.

    If the spool type is "Direct Input", you can display the meta data of the active report by pressing PF2.

Adding an Active Report to a Bundle

This function adds an active report to an opened bundle for one distribution only.

Start of instruction set To add an active report to a bundle:

  1. On the Active Report List screen, enter the line command BU next to the active report to be added.

    A window is displayed.

  2. In the window, enter the name of the bundle into which the active report is to be put.

    Depending on the setting of the user profile field Restrict Abun, you can either put the report in any bundle or only in a bundle to which you have access. Administrators can put the report in any bundle, regardless of the setting of Restrict Abun.

For more information on user profile settings, see the section Users in the System Administration documentation.

Printing an Active Report

Start of instruction setTo print an active report:

  1. On the Active Report List screen, enter the line command PR next to the report to be printed.

    A printer selection list will be displayed.

    Only those printers are listed which are PUBLIC or for which the user is authorized (see the section Adding a User to an Authorization List). The printers on which the active report is usually printed are highlighted.

  2. To select a printer, enter any character in the input field preceding the appropriate printer. The report will be printed immediately on this printer.

    The window with the printer selection list also provides the field Hold Printout: Enter a "Y" in this field to place the printout in HOLD status.

Distributing an Active Report to Extra Users

This function distributes an active report to a user or group of users on a distribution list who are not defined in the Distribution Attributes for the report (see Attributes of a Report).

Start of instruction setTo distribute an active report to extra users:

  1. On the Active Report List screen, enter the line command DS next to the active report you want to distribute.

    A window is displayed.

  2. In the window, enter the user ID of the additional user to whom the active report is to be distributed.

    To select a user or distribution list, enter a question mark (?) in the User ID field.

    A window is displayed.

  3. Press one of the following keys:

    • PF4 to display a list of all users;

    • PF5 to display a list of all distribution lists.

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

  4. Select a user / distribution list from the list by entering any character in the field preceding the user ID / distribution list name.

    The ID/name is written into the User ID field of the Distribute Report to User window.

  5. To distribute the active report to the #Inbasket folder of this user, or the users on this distribution list respectively, press ENTER again.

    The user(s) can then browse and print the report.

    You can also restrict the users' view of the report; see the section Modifying the Layout of an Active Report.

Listing Users Connected to an Active Report

Start of instruction setTo lists all users to whom an active report is distributed:

  • On the Active Report List screen, enter US in the command field preceding the report for which users are to be listed.

    A window is displayed, listing all users who receive the report, whether they are in the distribution list or have been selected with the line command DS.

Deleting an Active Report

Start of instruction set To delete an active report:

  1. On the Active Report List screen, enter DE in the command field preceding the active report to be deleted.

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

If you are Master owner of the active report, the active report itself and all references to it are deleted. Otherwise, only the reference from the active report to your user ID is deleted.

If the active report is in the archive, it will not be deleted immediately, but only marked for deletion. It will be deleted from the archive on the following day.

Archiving an Active Report

This function marks an active report for archiving or cancels the archiving flag. An active report marked for archiving is archived the next time the archiving task is active.

Start of instruction setTo archive an active report:

  • On the Active Report List screen, enter AR in the command field preceding the report to be marked for archiving or whose archiving flag is to be cancelled. Press ENTER to mark the report or cancel the archiving flag.

Reviving an Archived Report

This function marks an active report for reviving or cancels the reviving flag. An active report marked for reviving is revived the next time the reviving task is active. The report is restored to the Active Report List.

Start of instruction set To revive an archived report:

  1. On the Active Report List screen, enter RV in the command field preceding the report to be marked for reviving or whose reviving flag is to be cancelled.

  2. Press ENTER to mark the report or cancel the reviving flag. When reviving an active report, specify the location to which it should be revived (S = spool, D = database) and, optionally, a bundle to which the active report will be added when it is revived.

    If you enter the name of the bundle, the report is added to an open active bundle at revive time. If there is no open active bundle, one is created if a master bundle with the same name exists. If there is no master bundle with the given name, an error message will be displayed.

Confirming Printing of an Active Report

This function releases an active report for printing. The report is printed only when all target users have confirmed by issuing this command. The report must be defined with the printing attribute "Hold Logic = C".

Start of instruction set To confirm printing of an active report:

  • On the Active Report List screen, enter CP in the command field preceding the report to be released for printing.

For more information, see Hold Logic under Attributes of a Report - Printing Attributes.

Filing an Active Report in Another Folder

This function is used to move an active report filed in your current folder to another of your own folders (but not to a linked folder).

Start of instruction set To file an active report in another folder:

  1. On the Active Report List screen, enter FI in the command field preceding the report to be moved.

    A window is displayed.

  2. In the window, enter the name of the folder in which the active report is to be filed in the To Folder field.

    The active report is now filed in the specified folder.

Displaying the Report Definition

Start of instruction setTo display the report definition which generated an active report:

  • On the Active Report List screen, enter DD in the command field preceding the active report for which you want to display the report definition.

    The Report Definition > General Attributes screen is displayed, showing the general attributes of the report.

They are described under Attributes of a Report.

Cross-Referencing an Active Report

Start of instruction setTo list all active bundles in which an active report is contained:

  • On the Active Report List screen, enter XB in the command field preceding the report to be cross-referenced.

    A list of all bundles in which the report is contained is displayed, providing the following information on the bundles:

Field Explanation
Bundle Name of the active bundle in which the active report is contained.
Run Number Internal report identification.
Group Group identifier assigned to the report in the bundle.
Seq(uence Number) Sequence number assigned to the report in the bundle.
Status Bundle status.
Printer Logical printer assigned to the report in the bundle.