Maintenance Functions for Bundles

#### Search Results

Search

# Maintenance Functions for Bundles

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

- Listing All Bundles

- Listing Selected Bundles

- Creating a New Bundle

- Copying a Bundle

- Modifying a Bundle

- Renaming a Bundle

- Deleting a Bundle

- Displaying a Bundle

- Displaying Log Information for a Bundle

- Authorizing User Access to a Bundle

- Functions for Reports in a Bundle

## Listing All Bundles

### Bundle Maintenance Screen

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

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

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

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

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

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

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

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

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.

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

- Adding a Report to a Bundle

- Modifying a Report in a Bundle

- Deleting a Report from a Bundle

### Listing All Reports in a Bundle

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

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

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

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

### On this page

- Listing All Bundles
- Listing Selected Bundles
- Creating a New Bundle
- Copying a Bundle
- Modifying a Bundle
- Renaming a Bundle
- Deleting a Bundle
- Displaying a Bundle
- Displaying Log Information for a Bundle
- Authorizing User Access to a Bundle
- Functions for Reports in a Bundle