Maintenance Functions for Reports

This section describes the functions for the maintenance of reports:


Listing All Reports

Start of instruction set 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 ****            2018-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

Start of instruction set 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 _______________ _______________                    !
    !                         _______________ _______________                    !
    ! Distribute to ...     0 ________ (*)                                       !
    ! Printer .........     0 ________ (*)                                       !
    !                                                                            !
    ! Identification          JES                POWER              BS2000       !
    !    Jobname ......     0 ________ (*)     0 ________ (*)     0 ________ (*) !
    !    Writer .......     0 ________ (*)                                       !
    !    Destination ..     0 ________ (*)     0 ________ (*)                    !
    !    Form .........     0 ______   (*)     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 up to 4 keywords.
    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_______ _______________                    !
    !                         _______________ _______________                    !
    ! Distribute to ...   182 MSE_____ (*)                                       !
    ! Printer .........     0 ________ (*)                                       !
    !                                                                            !
    ! Identification          JES                POWER              BS2000       !
    !    Jobname ......     0 ________ (*)     0 ________ (*)     0 ________ (*) !
    !    Writer .......     0 ________ (*)                                       !
    !    Destination ..     0 ________ (*)     0 ________ (*)                    !
    !    Form .........     0 ______   (*)     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

Start of instruction set 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

Start of instruction set 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

Start of instruction set 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

Start of instruction set 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

Start of instruction setTo 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

Start of instruction set 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

Start of instruction set 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

Start of instruction setTo 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

Start of instruction setTo 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.