This section covers the following topics:
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.
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. |
The availability of an active report is controlled by the following general attributes of the underlying report:
| Attribute | Explanation | |
|---|---|---|
| Archive directly | This attribute determines whether or not an archive copy of the active report is to be taken immediately. Possible values are: | |
| Y | As soon as the active report is created it is marked as "to be archived". The next time the archive job runs, the active report will be archived and will no longer be viewable online. If Y is specified, the report retention information is ignored. | |
| I | As soon as the active report is created it is marked as "to be archived and retained online". The next time the archive job runs, the active report is archived, but it is also retained for online viewing until the expiry of the report retention period. | |
| N | The active report is created and is viewable online until the expiry of its report retention. | |
| Retention - Report | This attributes determines how
long a report is retained for online viewing.
In addition, you select the action to be performed when this period expires: either archive the report or delete it. (This action specification is ignored if you set Archive directly to "Y" or "I".) Alternatively, you can specify the number of generations, that is, the number of instances of the same active report. |
|
| Retention - Archive | This attribute determines how long
the active report is to be retained on archive.
When this period expires, the active report is completely deleted and cannot be recovered. |
|
| Retention - Revive | This attribute determines how long
the contents of a revived active report will be available online for viewing
and printing.
When this period expires, the active report reverts to an archived state and can no longer be viewed online. |
|
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.
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.
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. As described for column heading L. | |||
| 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.
You can specify a different user ID. |
|||
| Retention | You can modify the four Retention fields. For an explanation, see the field descriptions under Retention/Report. | |||
| Contents |
Lines/Kbytes |
The number of lines contained in the active report. For a binary report, its size in KB (as indicated by a "K" after the number). | ||
| CC Type | Either ASA or
MACHINE.
|
|||
| Record length | The maximum number of bytes in the record. | |||
| Expiration date | The contents of the active report are available online until the date you specify here. | |||
| Field | Explanation | |
|---|---|---|
| Retention |
This is 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. You can modify the Number and Unit fields, if the active report has not already been archived. For an explanation, see the field descriptions under Retention/Archive. |
|
| Archive (display only) | Date/Time | The date and time the active report was archived. |
| Expiration | Expiration date. The active report is retained 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 archive is user-defined, the type number is shown here. | |
| 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. | |
| Field | Explanation | |
|---|---|---|
|
This is 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. You can modify the Number, Unit and Calendar fields, if the active report has not already been revived. If the active report has been revived, you can modify the Expiration field below. For an explanation, see the field descriptions under Retention/Report. |
||
| Date/Time | The date and time the active report was revived. | |
| Expiration | The revived "copy" of the active report contents is available until this date. You can modify this field if the active report has already been revived. If the active report has not been revived, you can modify the Archive Attribute fields Number, Unit and Calendar. | |