Maintenance Functions for Reports

#### Search Results

Search

# Maintenance Functions for Reports

This section describes the functions for the maintenance of reports:

- Listing All Reports

- Listing Selected Reports

- Creating a New Report

- Copying a Report

- Modifying a Report

- Renaming a Report

- Displaying a Report

- Deleting a Report

- Displaying Log Information for a Report

- Authorizing User Access to a Report

- Listing Active Reports for a Report

## Listing All Reports

To list all reports:

1. Enter `1` in the command line of the Main Menu.

   The Report Maintenance screen is displayed:

         16:21:24             **** ENTIRE OUTPUT MANAGEMENT ****            2024-06-06
        User ID XYZ                 - Report Maintenance -

        Cmd Report            Authoriz T Description
        ___ _________________________ ________ _ _____________________________________
         __ UEX-GO            ADMIN    S Exit GOTO/GOTOP/NEXTP example
         __ UEX-INSL-ADDP     ADMIN    M Exit INSL/ADDP change first line of e
         __ UKSJU-ABEND       ADMIN    M separation exit abends with a s0c7
         __ UKSJU-BIG-SEP     ADMIN    M A big report that gets separated
         __ UKSJU-COBOL       ADMIN    M Report created by COBOL program using
         __ UKSJU-DEST        ADMIN    M Should be copied to container file 9,
         __ UKSJU-DEST-SEP    ADMIN    M Should be copied to container file 9,
         __ UKSJU-FILE        ADMIN    M Create report from sequential file
         __ UKSJU-HANG        ADMIN    M separation exit issues a wtor
         __ UKSJU-IMMARC      ADMIN    M immediately archived
         __ UKSJU-INSL        ADMIN    S SEP EXIT INSERTS LINES
         __ UKSJU-NAF-ANYPROF ADMIN    M create report for nomprt*
         __ UKSJU-NAF-NAME1   ADMIN    M
         __ UKSJU-NAF-NAME2   ADMIN    M
         __ UKSJU-NAF-NAME3   ADMIN    M
       More ...
        Command => ___________________________________________________________________
       Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
             Help  Add   Exit  Flip               -     +    Selct  <     >    Menu

   The screen lists in alphabetical order all reports which were defined by the user, created by someone else who authorized this user to process them, or generated automatically by a standard separation routine or a user routine.

   With PF21 you can switch between the display of long and short report names.

2. From this screen, you can invoke the other functions for the maintenance of reports.

#### Line Commands

Command | Function
--- | ---
AU | Authorize other users to process the report. Only users with owner authorization for the report can perform this function. See Authorizing User Access to Objects.
CO | Copy report definition (including report processing).
DE | Delete report definition.
DI | Display report definition.
LI | List active reports for a report definition.
LK | List active reports by keyword. See the section Active Reports.
LO | Display log information about maintenance activity on this report, such as who last modified it and who created it.
MO | Modify report definition.
RN | Rename report definition.

#### Fields

If a field is marked with an asterisk (*) below, you can enter selection criteria with an asterisk in the field directly beneath the heading on the Report Maintenance screen.

Field | Explanation
--- | ---
Report * | Enter selection criteria for the report name.
Authoriz * | Authorization used to access the report. You can enter: PUBLIC, a user ID or the name of a distribution list to list selected reports. ADMIN indicates that you are defined as Administrator with Owner authorization for the listed reports. ADMIN cannot be used as selection criterion.
T * | Report type. Possible values: C - Created definition D - Default definition M - Master definition. S - Supended definition.
Description | A short description of the report.

## Listing Selected Reports

To list only those reports which satisfy certain selection criteria:

1. On the Report Maintenance screen, press PF9 (Selct).

   The Find Report Definitions window is displayed:

       +------------------------- Find Report Definitions --------------------------+
       !                                                                            !
       ! Report Name .....     0 _________________________ (*)                      !
       ! Master Report ...     0 _________________________ (*)                      !
       ! Keywords ........     0 _______________ _______________  O  (And/Or)       !
       !                         _______________ _______________ (*)                !
       ! Distribute to ...     0 ________ (*)                                       !
       ! Printer .........     0 ________ (*)                                       !
       !                                                                            !
       ! Identification          JES                                   BS2000       !
       !    Jobname ......     0 ________ (*)                        0 ________ (*) !
       !    Writer .......     0 ________ (*)                                       !
       !    Destination ..     0 ________ (*)                                       !
       !    Form .........     0 ______   (*)                        0 ________ (*) !
       !    User ID ......                                           0 ________ (*) !
       ! UNIX                                                                       !
       !    Node Name ....     0 ________________            (*)                    !
       !    Path .... ....     0                             (*)                    !
       !         __________________________________________________________________ !
       !    Files ........     0 __________________________________________________ !
       !      as Substring     N (instead of prefix)                                !
       ! Total ...........     0                                                    !
       !  PF3 Exit                                                                  !
       +----------------------------------------------------------------------------+

2. In this window, you enter the report attributes to be used for finding reports to be listed on the Report Maintenance screen.

   In all fields marked with an asterisk (*) in the Find Report Definitions window, you can specify selection criteria using asterisk notation. For example, to list all reports whose names begin with "ADA", you would specify `ADA*` in the Report Name field.

   Selection Criteria | Explanation
   --- | ---
   Report
   Name | Enter a report name.
   Master Report | Enter the name of a master report or selection criteria for a master report prefix. This field is used to find created reports only. As these created reports have no identification, specifying a master report and job name identification will result in nothing found.
   Keywords | Enter one or more keywords. If you enter more than one keyword, you can specify "O" or "A": O (Or) = Reports identified by at least one of the specified keywords will be found. A (And) = Reports identified by all of the specified keywords will be found.
   Distribute to | Enter a user ID or distribution list name, as defined in the User/List field (see Distribution Attributes).
   Printer | Enter a printer name, as defined in the Printers field (see Printing Attributes).
   Identification
   These fields correspond to the fields of the same names in the Identification Attributes.
   UNIX
   Node Name / Path / Files | These fields correspond to the fields of the same names in the UNIX/Windows Identification Attributes.
   as Substring (instead of prefix) | This field determines how the value in the Files field is interpreted: N = The search will be for all file-name patterns which start with the Files value. Y = The search will be for all file-name patterns which contain the Files value anywhere within them.

3. When you have finished entering selection criteria, press ENTER.

   The number of reports found, which satisfy a selection criterion, is displayed for each criterion next to the corresponding input field. The total number of reports which satisfy all selection criteria is displayed in the Total field at the bottom of the screen:

       +------------------------- Find Report Definitions --------------------------+
       !                                                                            !
       ! Report Name .....     6 ADA*_____________________ (*)                      !
       ! Master Report ...     0 _________________________ (*)                      !
       ! Keywords ........    10 STANDARD_______ _______________  O  (And/Or)       !
       !                         _______________ _______________ (*)                !
       ! Distribute to ...   182 MSE_____ (*)                                       !
       ! Printer .........     0 ________ (*)                                       !
       !                                                                            !
       ! Identification          JES                                   BS2000       !
       !    Jobname ......     0 ________ (*)                        0 ________ (*) !
       !    Writer .......     0 ________ (*)                                       !
       !    Destination ..     0 ________ (*)                                       !
       !    Form .........     0 ______   (*)                        0 ________ (*) !
       !    User ID ......                                           0 ________ (*) !
       ! UNIX                                                                       !
       !    Node Name ....     0 ________________            (*)                    !
       !    Path .... ....     0                             (*)                    !
       !         __________________________________________________________________ !
       !    Files ........     0 __________________________________________________ !
       !      as Substring     N (instead of prefix)                                !
       ! Total ...........     5                                                    !
       !  PF3 Exit                                                                  !
       +----------------------------------------------------------------------------+

   In the example above, we are looking for all reports whose names begin with `ADA`, have the keyword `STANDARD` and are distributed to the user ID `MSE`.

   ``.

   Entire Output Management has located 6 reports beginning with `ADA`, 10 reports with the keyword `STANDARD` and 182 reports distributed to the user ID `MSE`. There are 5 reports which satisfy all these criteria.

4. Press ENTER again. A security check is performed, and all reports found for which the user is authorized are listed on the Report Maintenance screen.

   If the user is not authorized for some reports, a message indicates the number of reports rejected for this reason.

## Creating a New Report

To create a new report:

1. Press PF2 on the Report Maintenance screen.

   The Report Definition > General Attributes screen is displayed.

2. On this screen and subsequent screens, you create a report by defining its attributes. They are described under Attributes of a Report.

## Copying a Report

To copy a report:

1. On the Report Maintenance screen, enter the line command `CO` next to the report you want to copy.

   A window is displayed.

2. Enter the name of the target report in the input field provided.

   A message confirms the copying.

## Modifying a Report

To modify a report definition:

1. On the Report Maintenance screen, enter the line command `MO` next to the report you want to modify.

   The Report Definition screen is displayed for the report you have selected.

2. Modify the report definition as desired. The fields are described under Attributes of a Report.

   Then press PF5 (Do) or ENTER to save your modifications.

3. Depending on the `COMMIT` option (see SET command), you may be prompted to confirm the modifications.

## Renaming a Report

To rename a report:

1. On the Report Maintenance screen, enter the line command `RN` next to the report you want to rename.

2. A window is displayed in which you enter the new report name.

## Displaying a Report

To display a report:

- On the Report Maintenance screen, enter the line command `DI` next to the report you want to display.

  The definition of the selected report will be displayed.

## Deleting a Report

To delete a report:

1. On the Report Maintenance screen, enter the line command `DE` next to the report you want to delete.

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

## Displaying Log Information for a Report

To display log information for a report:

1. On the Report Maintenance screen, enter the line command `LO` next to the report for which you want to display log information.

   The Log Display screen is displayed for the report selected.

2. You can display more information about a log entry by marking it with the line command `IN`.

   For further details, see Display Log Information for an Object.

## Authorizing User Access to a Report

To authorize user access to a report:

1. On the Report Maintenance screen, enter the line command `AU` next to the report for which you want to grant authorization.

   The Authorization List window for reports is displayed.

2. To grant authorization to a new user, proceed as described in the section Authorizing User Access to Objects.

## Listing Active Reports for a Report

To list active reports for a report:

- On the Report Maintenance screen, enter the line command `LI` to list active reports created for this master report.

### On this page

- Listing All Reports
- Listing Selected Reports
- Creating a New Report
- Copying a Report
- Modifying a Report
- Renaming a Report
- Displaying a Report
- Deleting a Report
- Displaying Log Information for a Report
- Authorizing User Access to a Report
- Listing Active Reports for a Report