Version 3.2.1	SEARCH   CONTENTS   |   PDF PAGE   PDF BOOKS   |   HOME   UP   PREV   NEXT

This section describes how to create and maintain bundles. It contains the following topics:

• What is a Bundle?

• Listing All Bundle Definitions

• Listing Selected Bundle Definitions

• Adding a Bundle Definition

• Defining Print Parameters for a Bundle

• Defining a Print Schedule for a Bundle

• Defining the Retention Period for a Bundle

• Defining Bundle Contents

• Other Bundle Maintenance Functions

What is a Bundle?

A bundle is a group of reports collected from different jobs or SYSOUT datasets. A bundle is printed and distributed as a unit. The reports in a bundle can be browsed with the Software AG Editor.

Defining a bundle involves:

• creating the bundle,

• defining print parameters,

• defining the retention period,

• defining the reports in the bundle and the reports that trigger printing,

• authorizing user access to the bundle,

• modifying all parameters.

In addition, a bundle can be copied, deleted, and renamed. Bundle parameters and log information can be displayed. All defined bundles and the reports in each bundle can be listed.

Object relationship diagram

Listing All Bundle Definitions

Bundle Maintenance Screen

To list all bundle definitions:

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

   If long report and bundle names are displayed by the system (see settings in System Defaults and Adding a User Profile), the "Bundle Maintenance" screen will take the following form:

   17:08:18 **** ENTIRE OUTPUT MANAGEMENT **** 2008-11-15 User ID XYZ - Bundle Maintenance - Report _________________________ Cmd Bundle Authoriz Description NumRep ___ _________________________ ________ ______________________________ ______ __ DEP-ADMA ADMIN Created by PWR-EMPL-STD1-S 6 __ DEP-COMP ADMIN Created by PWR-EMPL-STD1-S 23 __ DEP-DEPT ADMIN Created by DB-POWER-BIG1-S 21 __ DEP-FINA ADMIN Created by PWR-EMPL-STD1-S 11 __ DEP-HUGO ADMIN Created by PWR-EMPL-STD1-S __ DEP-MARK ADMIN Created by PWR-EMPL-STD1-S 11 __ DEP-MASK ADMIN Created by PWR-EMPL-STD1-S 5 __ DEP-MGMT ADMIN Created by PWR-EMPL-STD1-S 26 __ DEP-PROD ADMIN Created by PWR-EMPL-STD1-S 10 __ DEP-SALE ADMIN Created by PWR-EMPL-STD1-S 19 __ DEP-SALG ADMIN Created by PWR-EMPL-STD1-S 5 __ DEP-SYSA ADMIN Created by PWR-EMPL-STD1-S 9 __ DEP-SYSU ADMIN Created by PWR-EMPL-STD1-S 5 __ DEP-TECH ADMIN Created by PWR-EMPL-STD1-S 29 __ DEP-VENT ADMIN 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

   By pressing PF21 (Ext) you can switch to short names display.

   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

Line Commands

Field

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.

Listing Selected Bundle Definitions

To list only the names of bundles which begin with a certain prefix, containing only certain reports or created by a certain master:

1. Press PF11 to open the "Bundle Selection" window:

   +----------------------------------------------------+ ! Bundle Selection Screen ! ! ! ! Bundle............. _________________________ ! ! Containing reports. _________________________ ! ! Created by master.. _________________________ ! ! For coordinator.... ________ ! ! ! +----------------------------------------------------+

   This window allows you to enter selection criteria for the bundles listed on the "Bundle Maintenance" screen.

Fields

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

Adding a Bundle Definition

To add a bundle:

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

   The "Bundle Definition" screen is displayed.

   If long report and bundle names are displayed by the system (see settings in System Defaults and Adding a User Profile), the screen will take the following form:

   14:31:42 **** ENTIRE OUTPUT MANAGEMENT **** 2008-11-15 User ID XYZ - Bundle Definition - Bundle Name .............. _________________________ Description .......... __________________________________________________ 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

   With PF21 (Ext), you can switch to short names display.

2. On this screen you define a new bundle, or modify an existing bundle definition.

Special PF Keys

Fields

Defining Print Parameters for a Bundle

Defining print parameters for a bundle involves:

• selecting a bundle coordinator,

• selecting reports to trigger printing,

• selecting logical printer(s),

• defining separator pages for the bundle and for reports in the bundle.

Bundles can be printed:

• manually by an operator,

• at a predefined time,

• when one or more defined reports have been processed,

• by an Entire Operations trigger,

• by an API trigger from an external application using API.

At print time separator pages are created as follows:

• one at the start of the bundle,

• one at the end of the bundle,

• optionally, separator pages can be printed between reports.

A table of contents is printed at the end of the bundle and lists the reports contained.

Selecting a Bundle Coordinator

You can enter the user ID of the person who is responsible for this bundle. The coordinator's name, address and telephone number can be used as substitution variables for separator pages.

To select a coordinator from a list of users:

1. Enter a question mark (?) in the Coordinator ID field on the "Bundle Definition" screen.

   The "Bundle Coordinator ID" window is displayed.

2. Press ENTER again.

   A selection window is displayed:

   +----------------------------------------------------+ ! User Selection List ! ! ! ! M User Name ! ! _ ________ ______________________________ ! ! _ CAR Carter, John ! ! _ CLA Clayton, John ! ! _ COP Copperfield, David ! ! _ CRU Crusoe, Robinson ! ! _ EYR Eyre, Jane ! ! _ INN Innes, David ! ! _ PER Perry, Abner ! ! _ QUA Quatermain, Allan ! ! _ SAW Sawyer, Tom ! ! _ TWI Twist, Oliver ! ! ! ! Select With Any Character ! ! ! ! PF3 Exit PF7 Up PF8 Down ! ! ! +----------------------------------------------------+

   This window lists the IDs of all authorized users.

3. Select an ID by entering any character in the input field preceding the appropriate ID.

   The ID is written to the Coordinator ID field of the "Bundle Definition" screen.

Selecting Reports to Trigger Printing

You can enter up to 10 report names. When all of them arrive, the bundle is printed.

To select reports which trigger bundle printing:

1. Enter a question mark (?) in one of the report arrival fields on the "Bundle Definition" screen.

   The Trigger Reports window opens.

   Trigger Reports are automatically added to the list of reports to be included in the bundle (see the section Defining Bundle Contents). However, they are not automatically deleted from Bundle Contents (Report in Bundle screen) when removed from report arrival. Other reports contained in a bundle will be printed but do no trigger printing.

2. Press ENTER again.

   A selection window is displayed, listing the names of all defined reports.

3. Scroll the list down with PF8 (Down) and back up with PF7 (Up).

4. Select a report to trigger bundle printing by entering any character in the input field preceding the appropriate report name.

   The name of the report you have selected is written to the report arrival field on the Bundle Definition screen.

Selecting a Logical Printer for a Bundle and Defining Separator Pages

To select logical printers to print the bundle and define separator pages:

1. Press PF9 (Print) on the "Printing Attributes" screen.

   The "Bundle Definition > Printing Attributes" screen appears:

   11:50:51 **** ENTIRE OUTPUT MANAGEMENT **** 2008-11-15 User ID XYZ - Bundle Definition>Printing Attributes - Bundle Name .............. XYZ-DEMO_________________ Hold before print .... Y (Y/N) Printers ............. ________ ________ ________ ________ ________ Copies ............... ___ ___ ___ ___ ___ Report Separator Pages N (Y/N) Bundle Separator Pages Print Control Exit Start ............. ________ NATURAL Member.... ________ End ............... ________ NATURAL Library... ________ Copies ............ 1__ Jobcards ________________________________________________________________________ ________________________________________________________________________ ________________________________________________________________________ Command => ___________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Add Exit Flip Ext Edit Prtr Menu

Special PF Keys

Fields

To define or modify more than 5 printers:

1. Press PF11 (Prtr) on the "Bundle Definition > Printing Attributes" screen.

   The "Bundle Definition > Additional Printers" screen appears:

   14:25:21 **** ENTIRE OUTPUT MANAGEMENT **** 2008-11-15 User ID XYZ - Bundle Definition >Additional Printers - Bundle Name................ UKSJUBU2 Printers (6-10)..... ________ ________ ________ ________ ________ Copies (6-10)..... ___ ___ ___ ___ ___ Printers (11-15).... ________ ________ ________ ________ ________ Copies (11-15).... ___ ___ ___ ___ ___ Printers (16-20).... ________ ________ ________ ________ ________ Copies (16-20).... ___ ___ ___ ___ ___ Command => ___________________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Add Exit Flip Do Undo Ext Menu

2. On this screen, you can define up to 15 additional printers, by specifying the following:

   Field	Explanation
   Printer	Enter the names of up to 15 logical printers on which the bundle is to be printed. If you enter a question mark (?) in this field, the printer selection list will appear.
   Copies	Specify how many copies should be printed on each printer.

Defining a Print Schedule for a Bundle

You can define a print schedule for a bundle by pressing PF8 (Sched) from the "Bundle Definition" screen. This schedule is activated if you enter "Y" in the "Time schedule" field on the "Bundle Definition" screen.

To define a print schedule for a bundle:

• Press PF8 (Sched).

  The "Print Schedule" window opens:

  +--------------------------------------------------------------+ ! ! ! Print Schedule ! ! not before ... 00:00 ! ! every ........ 00:00 ! ! not later .... 00:00 ! ! ! ! Weekdays ........ __ __ __ __ __ __ __ ! ! (Sa Su Mo Tu We Th Fr) ! ! Monthly Days .... ___ ___ ___ ___ ___ ___ ! ! ___ ___ ___ ___ ___ ___ ! ! ___ ___ ___ ___ ___ ___ ! ! ___ ___ ___ ___ ___ ___ ! ! ___ ___ ___ ___ ___ ___ ! ! ! ! Calendar ........ ________ ! ! before or after ! ! Holiday ......... _ ! ! ! +--------------------------------------------------------------+

Fields

Note:
You cannot specify both weekdays and monthly days in parallel.

Print Schedule Examples

Example 1 - Print at a Fixed Time on Fixed Weekdays, also on holidays

To print a bundle at 2 p.m. on all Mondays, Wednesdays and Fridays whether or not they are holidays, define these fields as follows:

Example 2 - Print at a Fixed Time on Fixed Monthly Dates, on day before holiday

To print a bundle at 7 p.m. on the 15th and on the last day of the month or, if these days are holidays, on the last workday before the holiday, define these fields as follows:

Example 3 - Print Daily between Fixed Times, on day after holiday

To print a bundle daily when it arrives between 8 a.m. and 7 p.m. or, if the day is a holiday, on the first workday after the holiday, define these fields as follows:

Example 4 - Print on Workdays at Fixed Times, on day after holiday

To print a bundle at 7 a.m., 1 p.m. and 7 p.m. from Monday to Friday or, if the day is a holiday, on the first workday after the holiday, define these fields as follows:

Defining the Retention Period for a Bundle

Selecting a Calendar

If you specify "W" ( working days) as the unit for the Retention Period, you can select a calendar which excludes holidays.

To select a calendar from a list of defined calendars:

1. Enter an asterisk (*) in the Retention (Calendar) field on the "Bundle Definition" screen.

   A selection window is displayed, listing the names of all defined calendars.

2. Select a calendar by entering any character in the field preceding it.

   The name of the calendar selected is written to the (Calendar) field on the "Bundle Definition" screen.

For more information on calendars, see the section Defining a Calendar in the System Administration documentation.

Defining Bundle Contents

Listing the Reports Included in a Bundle

To list the reports to be included in a bundle:

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

   The "Report in Bundle" screen appears with a list of all reports to be included in the bundle. If long report and bundle names are displayed by the system (see settings in System Defaults and Adding a User Profile), the screen will take the following form:

   14:48:15 **** ENTIRE OUTPUT MANAGEMENT **** 2008-11-15 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 to short names display.

   You may add and delete reports from the bundle or modify the report parameters from this screen. The reports are displayed in the order of their sequence in the bundle.

Special PF Keys

Line Commands

Fields

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 opens:

   +----------------------------------------------------+ ! - 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 ! +----------------------------------------------------+

   This window is used to add a report to a bundle or modify the print parameters of a report already in a bundle.

Note:
To add reports to a bundle that will trigger the printing of the bundle, please refer to Selecting Reports To Trigger Printing.

Fields

When you have finished entering data, press ENTER.

A message confirms that the report parameters have been saved.

Modifying a Report in a Bundle

To modify the parameters of a report listed on the Report in Bundle screen:

1. Enter the line command MO next to the name of the report you want to modify.

   The "Bundle Contents" window opens for the report selected.

2. When you have entered your modifications, press ENTER.

   A message confirms the modification.

Other Bundle Maintenance Functions

Modifying a Bundle Definition

To modify a bundle definition:

1. On the "Bundle Maintenance" screen, enter the line command MO next to the bundle you want to modify. The "Bundle Definition" screen appears for the bundle you have selected.

2. The fields are described under Fields: Bundle Definition.You can modify the data displayed by overwriting them. When you have finished modifying the bundle definition, press ENTER to save your changes.

   A message confirms the modification.

3. If COMMIT is set to OFF, press PF5 (Do) to save your modifications before exiting.

   If you do not, a window opens which asks you to commit modifications by typing Y. Type Y.

   A message confirms that all modification have been committed.

Authorizing User Access to a Bundle

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.

Copying a Bundle Definition

To copy a bundle definition:

1. On the "Bundle Maintenance" screen, enter the line command CO next to the bundle you want to copy.

   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.

Deleting a Bundle Definition

To delete a bundle definition:

1. On the "Bundle Maintenance" screen, enter the line command DE next to the bundle definition you want to delete.

   If CONFIRM is set to ON, a window opens asking you to confirm the deletion.

2. To do so, enter the bundle name in the input field provided.

   A message confirms the deletion.

Displaying a Bundle Definition

To display a bundle definition:

• On the "Bundle Maintenance screen", enter the line command DI next to the bundle you want to display.

  The bundle definition of the selected bundle is displayed.

Displaying Log Information for a Bundle Definition

To display log information for a bundle definition:

1. On the "Bundle Maintenance" screen, enter the line command LO next to the bundle definition for which you want to log information.

   The "Log Display" screen appears for the bundle definition selected.

2. You can display more information about a log entry by entering the line command IN next to the entry.

For further details, see the section Displaying Log Information for an Object and the Log Display screen.

Renaming a Bundle Definition

To rename the bundle definition:

1. On the "Bundle Maintenance" screen, enter the line command RN next to the bundle definition you want to rename.

   The "Rename Bundle" window is displayed.

2. Enter the new name of the bundle in the input field provided.

www.softwareag.com

Copyright © Software AG 1990-2008. All rights reserved.

SEARCH   CONTENTS   |   PDF PAGE   PDF BOOKS   |   HOME   UP   PREV   NEXT