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 |
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.
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. |
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:
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.
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.
An active report can have the following 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 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 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. | |||
| 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:
|
|||
| 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:
|
|||
| 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:
|
|||
| 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. | |||
The fields are the same as the spool attributes in the report definition; see Attributes of a Report.