Attributes of a Bundle

This section describes the components of a bundle definition:

Default values for bundle attributes can be set by the system administrator in Bundle Defaults.


General Attributes

Field Explanation
Bundle Name You have to enter a unique name for the bundle when you are creating a new bundle. This field is protected when you modify an existing bundle.
Description Enter a short description for the bundle.
Type The type of bundle:
  • Master definition (M).

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

Coordinator ID

You can enter the user ID of the person who is responsible for this bundle.

If you make no entry here, your user ID is automatically written into this field.

The coordinator's name, address and telephone number can be printed at the top of the front page of the bundle separator, if desired.

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 all authorized users, you enter a question mark (?) in this field.

Retention

A closed bundle is kept in the Entire Output Management database until its retention period has expired. A closed bundle can accept no more reports and a new version of the bundle is opened for additional reports.

See also Retention Period in Components of Bundle Defaults in the System Administration documentation.

Period Enter the number of working days, absolute days, weeks or months the bundle should be kept in the Entire Output Management database, after it has been closed.
Unit Possible values:
  • Working days (W)

  • Absolute days (A)

  • Weeks (V)

  • Months (M)

If you select "working days", you have to select a calendar which distinguishes between working and non-working days.

Calendar Select a calendar, if "working days" is the unit for the retention period.

To do so, enter an asterisk (*) in this field. A list of all defined calendars will be displayed, from which you select one.

For more information on calendars, see Calendars in the System Administration documentation.

Example: You have defined a calendar in which Saturday and Sunday are marked as holidays. If have specified "2" as the Period, and "working days" as the Unit and the bundle is created on Friday evening, it will be retained until Tuesday evening.

Print events
Time schedule The bundle can be printed at specified times on specified days.

Enter "Y" to activate the time schedule, which you can define by pressing PF8 (Sched). See Schedule Attributes.

Force flush If none of the other print events occurs before the period entered here has expired, bundle closing and printing is forced.
Period Enter the number of working days, absolute days, weeks or months the bundle should remain open.
Unit Same as for Unit under Retention, above.
Calendar Same as for Calendar under Retention, above.
Lines exceeded When the report that causes this line number to be exceeded has been written to the bundle, the bundle is closed and scheduled for printing.
Report arrival

Enter the names of up to 10 reports which trigger the printing of the bundle. The bundle is printed when all these reports arrive.

To select a trigger report from a list, you enter a question mark (?) in one of these fields.

Trigger reports are automatically added to the list of reports to be included in the bundle (see Functions for Reports in a Bundle). 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.

Schedule Attributes

Field Explanation
Weekdays or Monthly days

You can select printing of the bundle to be scheduled for every day or for certain days of the month or for certain week days:

  • For week days, you specify their two-character abbreviations (SU = Sunday, MO = Monday, etc.).

  • For days of the month, you specify their numbers (01 to 31).

    For printing on every day of the month, you specify ALL; for printing on the last day of the month, you specify LD.

Not before The bundle will not be printed before the time you specify here.
Every You can specify a time interval here.
Not later The bundle will not be printed after the time you specify here.
Calendar

If you specify a calendar, the bundle is only printed on days defined as working days in that calendar, but not on days defined as holidays.

To select a calendar from a list, enter an asterisk (*) in this field.

For more information on calendars, see Calendars in the System Administration documentation.

before or after Holiday

Should a printing date fall on a calendar holiday, enter "A" here to print on the first working day after the holiday, or enter "B" to print on the last working day before the holiday.

See also Print Schedule Examples below.

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, you define these fields as follows:

Not before 14:00
Every 00:00
Not later 14:00
Weekdays Monday, Wednesday, Friday (MO, WE, FR)

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, you define these fields as follows:

Not before 19:00
Every 00:00
Not later 19:00
Monthly 15, last (LD)
Calendar MRS
Holiday (before/after) Before holiday (B)

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, you define these fields as follows:

Not before 08:00
Every 00:00
Not later 19:00
Monthly all
Calendar MRS
Holiday (before/after) After holiday (A)

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:

Not before 07:00
Every 06:00
Not later 19:00
Weekdays Monday; Tuesday; Wednesday, Thursday; Friday (MO, TU, WE, TH, FR)
Calendar MRS
Holiday (before/after) After holiday (A)

Printing Attributes

Field Explanation
Hold before print

Enter "Y" to hold bundle printing until released manually. Enter "N" to print the bundle immediately.

Report separator pages

"Y" - The report separator pages are printed (this is the default).

"N" - The report separator pages are not printed.

The number of separator pages can be defined for each report in the bundle; see Adding a Report to a Bundle.

Bundle separator pages Start Enter the name of the separator page to be printed at the beginning of the bundle.
End Enter the name of the separator page to be printed at the end of the bundle.
Copies Specify how many times each separator page is to be printed for the bundle.
See Separator Pages for further information.

To edit a separator page, position the cursor on the Start or End field, and press PF10 (Edit).

Print control exit A printer control exit can be used to decide whether or not a bundle is actually printed after it has been sent to the printout queue. For example, you may not want to print bundles which only contain one report.

A sample exit is supplied in UEXBUNPR in the library SYSNOMS.

Natural member The name of the user exit.
Natural library The name of the library containing the user exit.
Jobcards Enter the job cards used when bundle printing is performed with batch jobs. The following substitution variables can be used: §USER, §BUNDLE.

If you leave this field blank, the jobcards specified for the logical printer are used instead.

See Adding a New Logical Printer.

Printers Printer

You can enter the names of up to 5 logical printers on which to print the bundle. For a selection list of printers, enter an asterisk (*) in one of these fields.

Additional Printers

To specify more than 5 printers, you press PF11 (Prtr) on the Bundle Definition > Printing Attributes screen. The Bundle Definition > Additional Printers screen is displayed, on which you can specify up to 15 additional printers, and the number of copies to be printed on each of them. For a selection list of printers, enter an asterisk (*) in one of the Printers fields on that screen.

Copies Specify the number of copies of the bundle to be printed on the respective printer.