Active Reports

#### Search Results

Search

# Active Reports

This section covers the following topics:

What is an Active Report?
Status of an Active Report
Availability of an Active Report
Attributes of an Active Report
Maintenance Functions for Active Reports

## What is an Active Report?

Entire Output Management creates active reports according to the corresponding report definition.

An active report is generated from the print data of the data source which satisfy the criteria specified in the Identification Attributes of the report definition.

An active report is the output that users receive. When an active report is created, it is sent automatically to the users specified in the Distribution Attributes of the report definition. It can also be sent to users manually at any time by any authorized user. Users receive an active report in their `#Inbasket` folder.

An active report can be printed on the logical printers which are specified in the Printing Attributes of the report definition.

See also General Information on Reports.

## Status of an Active Report

The status of an active report may be one of the following:

Status | Explanation
--- | ---
Browsable | The active report has not yet reached its expiration date. It can be viewed online, but has not yet been archived.
To be archived | The active report has passed its expiration 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. Remember that an active report whose expiration date has passed will not be archived, as long as it is 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 expiration date, it can be viewed online, and it has already been copied to an archive (so that it is not lost when the spool queue is deleted).
Archived | The active report has passed its expiration date. It cannot be viewed online. The only copy of it is in the archive.
Revived | The active report has passed its expiration date, was archived and has subsequently been revived from the archive so that it is again available for online viewing until its revive expiration date passes.

## Availability of an Active Report

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

Attribute | Explanation
--- | ---
Retention | The retention period determines how long the active report is 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 active report will be deleted, but not archived, when the retention period expires. The active report will be archived when the retention period expires. The active report will be archived the next time the archive job runs, but it is still available online until the retention period expires. The active report will be archived the next time the archive job runs, and deleted when its processing is completed. When an active report is archived, it is no longer available online. After this, it exists only in the archive. It 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 kept in the archive. When this period expires, the active report is deleted from the archive.
Keep revived report ready for | This attributes determines how long the active report - after is has been revived - is available online again for viewing and printing. When this period expires, the revived copy is deleted again, and only the archived copy remains (until the archive retention period expires).

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.

If an active report is created on 18th January, its expiration date will be 23rd January.

This means that Entire Output Management will mark the active report as "to be archived" on 24th January. The next time the archive job runs, the active report will be copied to an archive file.

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

- Retention Attributes

- Spool 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 | You can enter one or more keywords which will later help you select reports.
Master owner | The user specified here is the only one who can delete the active report; see Deleting an Active Report. The monitor also takes this user ID to submit print jobs for reports to be scheduled for automatic printing. This field is initialized with the Master owner ID of the underlying report definition. Use the Select button to the right of this field to select a different user ID.
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 deleted 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 deleted 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.

### On this page

- What is an Active Report?
- Status of an Active Report
- Availability of an Active Report
- Attributes of an Active Report