Active Reports

This section covers the following topics:

What is an Active Report?
Status of an Active Report
Processing of an Active Report
Attributes of an Active Report
Maintenance Functions for Active Reports
Browsing an Active Report with the Software AG Editor

What is an Active Report?

An active report is the output that an addressee receives.

  • It can be sent to Entire Output Management users either automatically, when the active report is created and the user ID is defined in the User/List field on the Report Definition > Distribution Attributes screen, or manually by any authorized user ID at any time.

  • It is generated by the report definition from all or part of a spool data set that satisfies the criteria set in the identification attributes of the report definition.

  • It can be printed automatically on up to 20 predefined logical printers.

Users can define folder in which they can store their active reports.

Active Report - Object relationship diagram

Status of an Active Report

Entire Output Management creates active reports according to the corresponding report definitions. An active report may be in one of the following states:

Status Explanation
Browsable The active report has not yet reached its expiry date. It can be viewed online, but has not yet been archived.
To be archived The active report has passed its expiry date, but it has not yet been processed by the next run of the archive job. It can still be viewed online until the archive job has processed it. Bear in mind that active reports will not be archived, even if they have expired, as long as they are still in the printout queue waiting to be printed or in an open active bundle which is still open.
Browsable/Archived The report has not yet reached its expiry date, it can be viewed online, and has already been copied to an archive (so that it is not lost when the spool queue is deleted).
Archived The active report exists but has passed its expiry date. The only copy of it is in an archive. The report cannot be viewed online.
Revived The active report exists, has passed its expiry date and been archived and has subsequently been revived from the archive so that it is again available for online viewing until its revive expiry date passes.

Processing of an Active Report

The availability of an active report is controlled by the following general attributes of the underlying report:

Attribute Explanation
Retention The retention period determines how long the active report will be available online for viewing and printing. When this retention period expires, the active report is either archived or deleted, depending on the selected Action. Possible options are:
  • The report will be deleted, but not archived, when the retention period expires.

  • The report will be archived when the retention period expires.

  • The report will be archived the next time the archive job runs, but its contents are still available for online viewing until the retention period expires.

  • The report will be archived the next time the archive job runs, and deleted when its processing is completed.

When an active report is archived, its contents are no longer available online. After this, the report contents exist only in the archive data set. The active report has to be revived before it can be viewed or printed again.

If the report is to be archived in a user-defined archive, you have to select the desired Archive Type.

Archive for This attribute determines how long the active report is to be kept in the archive.

When this period expires, the active report is deleted from the archive data set.

Keep revived report ready for This attributes determines how long the contents of a revived active report will be available online for viewing and printing.

When this period expires, this "copy" of the archived report is deleted automatically.

The attributes are described in detail under Attributes of a Report.

Example of report retention:

Let us assume that a report is defined with a report retention period of 5 absolute days.

An active report is created on 1 August 2015. Its expiry date will be 6 August 2015.

This means that Entire Output Management will mark the report as "to be archived" on 7 August 2015. The next time the archive job is run, the active report contents will be copied to an archive data set.

If anyone needs to view the report after that, it has to be revived.

Attributes of an Active Report

An active report can have the following attributes:

General Attributes

Field Explanation
Report The report name.
Run number Unique internal identifier for active report.
Description A short description for the report.
Location The current storage location for the active report.
Keywords Enter up to 3 keywords which will later help you select reports.
Master owner The monitor takes the user ID of the master owner to submit print jobs for reports to be scheduled for automatic printing. This field is initialized with the user ID of the person who created the report.

Use the Select button to the right of this field to select a different master owner.

Status Current status The current status of the active report. This can be one of the main states listed under Status of an Active Report, or an intermediate status when the active report was marked to be archived or revived.
Expiration date The expiration date which applies to the current status.
Action The action which will be perfomed when the expiration date is reached.
Contents

Number of lines / Size

The number of lines contained in the active report. For a binary report, its size in KB .
CC Type Either ASA or MACHINE.
Record length The maximum number of bytes in the record.

Retention Attributes

Field Explanation
Browsable Creation date The date and time when the active report was created.
Expiration date

The contents of the active report are available online for browsing/printing until this date. When this date is reached, the Action selected below will be performed.

As long as the status of the active report is "Browsable", you can change its expiration date: You either enter or select a new date, or you choose Calculate to calculate a new date, based on the number of absolute days, working days (in conjunction with a calendar which determines which days are to be considered working days), weeks or months you specify in a window displayed for this purpose.

Action Possible values:
  • Archive = The active report will be archived when the expiration date is reached. When an active report is archived, its contents are no longer available online.

  • Purge = The active report will be purged when the expiration date is reached.

Revive Enter the length of time the contents of a revived active report are to be available online for browsing and printing. When this period expires, this "copy" of the archived report is purged automatically.
Retention

Enter the number of working days, absolute days, weeks or months the active report is to be available online, and select a unit for the number:

  • Working days

  • Absolute days

  • Weeks

  • Months

Calendar If you select "Working days" in the field above, you also have to select the name of a calendar, which determines which days are to be considered working days.

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

Revived at The date and time when the active report was revived.
Expiration date

The revived active report is available until this date.

If the status of the active report is "Revived", you can change its expiration date: You either enter or select a new date, or you choose Calculate to calculate a new date, based on the number of absolute days, working days (in conjunction with a calendar which determines which days are to be considered working days), weeks or months you specify in a window displayed for this purpose.

Archive Enter the length of time the active report is to be kept in the archive. When this period expires, the active report is deleted from the archive data set. An active report can be archived no matter where it is stored.
Retention Enter the number of days/weeks/months/years the active report is to be kept in the archive, and select a unit for the number:
  • Days

  • Weeks

  • Months

  • Years

Archived at The date and time when the active report was archived.
Expiration date The active report is kept in the archive until this date.
Expiration orig. The original expiration date. If the expiration date has been modified, the original date is displayed here.
Type If the report is to be archived in a user-defined archive, the number of the required archive type is displayed here. If this field is empty or contains "0", the report is archived in a standard Entire Output Management archive file.
Data set The name of the data set where the active report was archived.
Volser(s) The VOLSER of the archive containing the active report.

Spool Attributes

The fields are the same as the spool attributes in the report definition; see Attributes of a Report.

Formatting Attributes

The fields are the same as the formatting attributes in the report definition; see Attributes of a Report.