Maintenance Functions for Bundles

This section describes the functions for the creation and maintenance fo bundles:


Listing All Bundles

Bundle Maintenance Screen

Start of instruction set To list all bundle definitions:

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

    The Bundle Maintenance screen is displayed:

       17:08:18             **** ENTIRE OUTPUT MANAGEMENT ****            2019-06-06
      User ID XYZ           - Bundle Maintenance -  Report _________________________
       
      Cmd Bundle                    Authoriz T Description                    NumRep
      ___ _________________________ ________ _ ______________________________ ______
       __ DEP-ADMA                  ADMIN    M Created by PWR-EMPL-STD1-S          6
       __ DEP-COMP                  ADMIN    M Created by PWR-EMPL-STD1-S         23
       __ DEP-DEPT                  ADMIN    M Created by DB-POWER-BIG1-S         21
       __ DEP-FINA                  ADMIN    M Created by PWR-EMPL-STD1-S         11
       __ DEP-HUGO                  ADMIN    M Created by PWR-EMPL-STD1-S
       __ DEP-MARK                  ADMIN    M Created by PWR-EMPL-STD1-S         11
       __ DEP-MASK                  ADMIN    M Created by PWR-EMPL-STD1-S          5
       __ DEP-MGMT                  ADMIN    M Created by PWR-EMPL-STD1-S         26
       __ DEP-PROD                  ADMIN    M Created by PWR-EMPL-STD1-S         10
       __ DEP-SALE                  ADMIN    M Created by PWR-EMPL-STD1-S         19
       __ DEP-SALG                  ADMIN    M Created by PWR-EMPL-STD1-S          5
       __ DEP-SYSA                  ADMIN    M Created by PWR-EMPL-STD1-S          9
       __ DEP-SYSU                  ADMIN    M Created by PWR-EMPL-STD1-S          5
       __ DEP-TECH                  ADMIN    M Created by PWR-EMPL-STD1-S         29
       __ DEP-VENT                  ADMIN    M Created by PWR-EMPL-STD1-S         61
     Top Of Data
      Command => ___________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Add   Exit  Flip               -     +    Activ       Selct Menu
    

    The screen lists all bundle definitions, in alphabetical order, which were created by the user or by someone else who authorized this user to process them.

Special PF Keys

Key Name Function
PF2 Add Create a new bundle.
PF9 Activ Display active bundles.
PF11 Selct List selected bundles.
PF21 Ext Switch between the display of long and short names.

Line Commands

Command Function
AR  Add a report to the bundle.
AU  Authorize other users to process the bundle.
CO  Copy bundle definition (including reports contained in the bundle).
DE  Delete bundle definition.
DI  Display bundle definition.
LO  Display log information about maintenance activities on a bundle.
MO  Modify bundle definition.
RN  Rename bundle definition.
RP  List the reports contained in the bundle.

Selection Criteria

Use an asterisk (*) as wildcard to enter selection criteria in all fields marked with an asterisk. Only those bundles which satisfy the criteria are listed.

Field Explanation
Report * You can enter selection criteria for the report name(s). This is useful if you are looking for a bundle containing specific reports but do not know the bundle name.
Bundle * Enter selection criteria for the bundle name.
Authorization * Authorization used to access object. You can enter:
  • PUBLIC;

  • a user ID or the name of a distribution list to display selected bundles;

  • ADMIN indicates that you are defined as Administrator with Owner authorization for the listed objects. ADMIN cannot be used as selection criterion.

T Type:
  • M = Master definition.

  • S = Suspended definition; that is, a definition that is currently not being used.

Description A short description of the bundle.
NumRep The number of reports in the bundle.

Listing Selected Bundles

Start of instruction set To list only bundles which meet certain selection criteria:

  1. Press PF11 on the Bundle Maintenance screen.

    The Bundle Selection window will be displayed.

  2. In this window you can enter selection criteria for the bundles listed on the Bundle Maintenance screen. The fields are described below.

    Only the bundles which satisfy the selection criteria will be listed.

Selection Criteria

Use an asterisk (*) as wildcard to enter selection criteria in the following fields:

Field Explanation
Bundle Enter selection criteria for the bundle.
Containing reports Enter selection criteria for the prefix of the report(s) contained in the bundles.
Created by master Enter selection criteria for the prefix of the master report definition(s) that automatically created the bundle(s).
For coordinator Enter the coordinator ID of the bundles to be listed.
Type

Select the type of bundles to be listed: M = Master definitions or S = Suspended definitions.

Creating a New Bundle

Start of instruction set To create a new bundle:

  1. Press PF2 (Add) on the Bundle Maintenance screen.

    The Bundle Definition screen is displayed:

       14:31:42             **** ENTIRE OUTPUT MANAGEMENT ****            2019-06-06
      User ID XYZ                 - Bundle Definition -
    
      Bundle
         Name .............. _________________________
         Description ....... __________________________________________________
         Type .............. M
      Coordinator ID ....... ________
      Retention ............ ___ (Period)     _ (Unit)      ________ (Calendar)
    
      Print events
         Time schedule ..... N (Y/N)
         Force flush ....... ___ (Period)     _ (Unit)      ________ (Calendar)
         Lines exceeded .... _________
         Report arrival .... _________________________ _________________________
                             _________________________ _________________________
                             _________________________ _________________________
                             _________________________ _________________________
                             _________________________ _________________________
    
    
      Command => ___________________________________________________________________
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Add   Exit  Flip  Do    Undo        Sched Print             Menu
    
  2. On this screen you define the general attributes of a bundle. The fields are described under General Attributes.

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

  3. To define the printing attributes of the bundle, press PF9 (Print) on the Bundle Definition screen.

    The Bundle Definition > Printing Attributes screen is displayed. The fields are described under Printing Attributes.

  4. To define a print schedule for a bundle, press PF8 (Sched) on the Bundle Definition screen.

    The Print Schedule window is displayed. The fields are described under Schedule Attributes.

    The print schedule is activated with the general attribute Time schedule.

Copying a Bundle

Start of instruction set To copy a bundle:

  1. On the Bundle Maintenance screen, mark the bundle with the line command CO.

    The Copy Bundle Definition window is displayed.

  2. Enter the name of the target bundle in the input field provided, and specify "Y" (yes) or "N" (no) to copy authorizations.

    A message confirms that the bundle has been copied.

Modifying a Bundle

Start of instruction set To modify a bundle:

  1. On the Bundle Maintenance screen, mark the bundle with the line command MO.

    The Bundle Definition screen for the bundle is displayed.

  2. The fields are described under Attributes of a Bundle. Modify the attributes as desired.

    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 Bundle

Start of instruction set To rename a bundle:

  1. On the Bundle Maintenance screen, mark the bundle with the line command RN.

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

Deleting a Bundle

Start of instruction set To delete a bundle:

  1. On the Bundle Maintenance screen, mark the bundle with the line command DE.

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

Displaying a Bundle

Start of instruction set To display a bundle:

  • On the Bundle Maintenance screen, mark the bundle with the line command DI.

    The bundle definition is displayed. The fields are described under Attributes of a Bundle.

Displaying Log Information for a Bundle

Start of instruction set To display log information for a bundle:

  1. On the Bundle Maintenance screen, mark the bundle with the line command LO.

    The Log Display screen for the bundle is displayed.

  2. To display more information about a log entry, you enter the line command IN next to it.

    For further details, see the section LO - Display Log Information for an Object.

Authorizing User Access to a Bundle

Only users with owner authorization for the bundle can perform this function.

Start of instruction set To authorize user access to a bundle:

  1. On the Bundle Maintenance screen, enter the line command AU next to the bundle for which you want to grant authorization.

    The Authorization List window for bundles is displayed.

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

Functions for Reports in a Bundle

Listing All Reports in a Bundle

Start of instruction set To list all reports in a bundle:

  1. On the Bundle Maintenance screen, enter the line command RP next to the appropriate bundle.

    The Report in Bundle screen is displayed, listing all reports included in the bundle:

      14:48:15             **** ENTIRE OUTPUT MANAGEMENT ****            2019-12-12
     User ID XYZ          - Report In Bundle -       UKSJUBU2
    
     Cmd Group    Sequence Report                    Copies  Separator NumSep
     ___ ________ _______  _________________________ _______ _________ ______
      __ SJUGRP1      1    UKSJU-SEP-1                       DEFAULT       1
      __ SJUGRP1      2    UKSJU-SEP-2                       DEFAULT       1
      __ SJUGRP1      3    UKSJU-SEP-3                       DEFAULT       1
      __ SJUGRP1      4    UKSJU-SEP-4                       DEFAULT       1
      __ SJUGRP1      5    UKSJU-SEP-5                       DEFAULT       1
      __ SJUGRP1      6    UKSJU-SEP-6                       DEFAULT       1
      __ SJUGRP1      7    UKSJU-SEP-7                       DEFAULT       1
      __ SJUGRP1      8    UKSJU-SEP-8                       DEFAULT       1
      __ SJUGRP1      9    UKSJU-SEP-9                       DEFAULT       1
      __ SJUGRP1     10    UKSJU-SEP-10                      DEFAULT       1
      __ SJUGRP1     11    UKSJU-SEP-11                      DEFAULT       1
      __ SJUGRP1     12    UKSJU-SEP-12                      DEFAULT       1
      __ SJUGRP1     13    UKSJU-SEP-13                      DEFAULT       1
      __ SJUGRP1     14    UKSJU-SEP-14                      DEFAULT       1
      __ SJUGRP1     15    UKSJU-SEP-15                      DEFAULT       1
    Top Of Data
     Command => ___________________________________________________________________
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Add   Exit  Flip               -     +    Ext               Menu
    

    With PF9 (Ext), you can switch between the display of long and short names.

    The reports are listed in the order of their sequence in the bundle. For each report, the following information is displayed:

    Field Explanation
    Group The name of the group in which the report is to be printed. Groups of reports in a bundle are printed in alphabetical order.
    Sequence The sequential number of the report in the bundle. Within the same group, the reports are printed in this sequence.
    Report The name of the report.
    Copies The number of copies of this report printed in the bundle.
    Separator The name of the separator page used for this report in the bundle.
    NumSep The number of times the separator page is printed.
  2. From this screen, you can add reports to the bundle, delete reports from the bundle, or modify the report parameters.

Adding a Report to a Bundle

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

  1. Press PF2 (Add) on the Report in Bundle screen; or on the Bundle Maintenance screen, enter the line command AR next to the bundle to which you want to add the report.

    The Bundle Contents window is displayed:

    +----------------------------------------------------+
    !  - Bundle Contents - Of: UKSJUBU2                  !
    !                                                    !
    ! Report name .......... _________________________   !
    ! Grouping Name ........ ________                    !
    ! Sequence Number ...... 1__                         !
    ! Number Of Copies ..... ___                         !
    ! Num Of Separators .... 0__                         !
    ! Pagedef .............. ________                    !
    ! Formdef .............. ________                    !
    ! Logical Printer ...... ________                    !
    !                                                    !
    !                                                    !
    ! PF3 Exit PF5 Do PF6 Undo PF9 Ext                   !
    +----------------------------------------------------+
  2. This window is used to add a report to the bundle, or modify the print parameters of a report already in the bundle. The fields are described below.

  3. When you have finished entering data, press ENTER.

    A message confirms that the report parameters have been saved.

To add reports to a bundle that will trigger the printing of the bundle, see the general attribute Report Arrival under Attributes of a Bundle.

New Report in Bundle - Fields

Field Explanation
Report Name

Enter a report name. To select a report name from a list, enter a question mark (?).

If you are modifying printing parameters, the name of the report cannot be changed here.

Grouping Name If you want to subdivide the bundle, enter a group name for this report. All reports in the bundle with the same group name are printed together in their group according to their sequence numbers.
Sequence Number Enter the sequential number of the report in the bundle. Reports are printed in this sequence within their group in the bundle. Reports with the same sequence number within a group are printed in the sequence in which they are listed on the list of reports in a bundle (see Listing All Reports in a Bundle).
Number of Copies Enter the number of copies of the report to be printed.
Number of Separators Enter the number of times the report separator page is to be printed in the bundle. The default is 1.
Pagedef If you want to print the report on an IPDS printer, enter the JCL parameter PAGEDEF to be used.
Formdef If you want to print the report on an IPDS printer, enter the JCL parameter FORMDEF to be used.
Logical Printer

Enter the name of the logical printer to be used for the report.

Modifying a Report in a Bundle

Start of instruction set To modify a report in a bundle:

  1. On the Report in Bundle screen, mark the report with the line command MO.

    The Bundle Contents window is displayed for the report selected.

  2. Make your changes. Then press ENTER to save them.

    A message confirms the modification.

Deleting a Report from a Bundle

Start of instruction setTo delete a report from a bundle:

  1. On the Report in Bundle screen, mark the report with the line command DE.

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