Maintenance Functions for Active Reports

#### Search Results

Search

# Maintenance Functions for Active Reports

This section covers the following topics:

- Listing Summary of Active Reports in a Folder

- Listing Active Reports for a Report Definition

- Listing Active Reports in a Folder

- Listing Active Reports with a Keyword

- Modifying an Active Report

- Displaying an Active Report

- Adding an Active Report to a Bundle

- Printing an Active Report

- Distributing an Active Report to Extra Users

- Listing Users Connected to an Active Report

- Deleting an Active Report

- Archiving an Active Report

- Reviving an Archived Report

- Confirming Printing of an Active Report

- Filing an Active Report in Another Folder

- Displaying the Report Definition

- Cross-Referencing an Active Report

## Listing Summary of Active Reports in a Folder

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 ****            2022-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

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 ****            2022-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 | obsolete

## Listing Active Reports in a Folder

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 ****            2022-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 ****            2022-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 | obsolete

## Listing Active Reports with a Keyword

To list active reports archived in a folder using selected keywords:

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 one or more keywords (optionally with asterisk notation) to list the active reports to which these keyword are assigned (in the Attributes of a Report).

   If you enter more than one keyword, you can specify "O" or "A":

   - O (Or) = to list active reports to which at least one of the specified keywords is assigned.

   - A (And) = to list active reports to which all of the specified keywords are assigned.

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

## 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.

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 ****            2022-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

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

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.

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

To 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).

To 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

To 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

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.

To 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 can be used to mark a single or multiple active reports for reviving or to cancel a 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.

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".

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).

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

To 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

To 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.

### On this page

- Listing Summary of Active Reports in a Folder
- Listing Active Reports for a Report Definition
- Listing Active Reports in a Folder
- Listing Active Reports with a Keyword
- Modifying an Active Report
- Displaying an Active Report
- Adding an Active Report to a Bundle
- Printing an Active Report
- Distributing an Active Report to Extra Users
- Listing Users Connected to an Active Report
- Deleting an Active Report
- Archiving an Active Report
- Reviving an Archived Report
- Confirming Printing of an Active Report
- Filing an Active Report in Another Folder
- Displaying the Report Definition
- Cross-Referencing an Active Report