Archiving is a migration with origin CONTROL and destination ARCHIVE. It consists of copying objects from a CONTROL status to a work file and subsequently deleting the objects from the ACF system file. The running of an archiving event covers only the copying; immediately after the copying, the objects are still in their compartment and are reported as "unloaded". The deleting is performed by the PAC administrator when he finalizes the completed archiving event, using the facility described in this section.
To access the archiving event maintenance functions, enter Code E (Migration Events) on the PAC Main Menu. Then enter Code W to access the Archive Event Maintenance Menu.
14:01:56 ***** PREDICT APPLICATION CONTROL ***** 2000-04-16 User SAGU - Archive Event Maintenance Menu - Code Sub-Function ---- ---------------------------------- D Display an Archive Event F Finalize an Archive Event M Modify an Archive Event P Purge an Archive Event S Select an Archive Event ? Help . Exit ---- ---------------------------------- Code .... _ Event ... ________________________________ Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Menu Exit Canc |
This document covers the following topics:
To select archiving events on the Archive Event Maintenance Menu, enter the following:
Code S
a range of event names - assuming that "*" is left blank.
If there is a completed (unloaded, locking, finalizing, or finalized) archive event whose name is in the specified range, an Archive Event Selection List appears:
14:03:46 ***** PREDICT APPLICATION CONTROL ***** 2000-04-16 User SAGU - Archive Event Selection List - C Nr Event Name State Application Name - -- -------------------------------- ---------- ----------------------------- _ 1 CLOVER-CONTROL-ARCHIVE-1 Finalized CLOVER _ 2 CLOVER-CONTROL-ARCHIVE-10 Finalized CLOVER _ 3 CLOVER-CONTROL-ARCHIVE-11 Unloaded CLOVER _ 4 CLOVER-CONTROL-ARCHIVE-2 Unloaded CLOVER _ 5 CLOVER-CONTROL-ARCHIVE-3 Unloaded CLOVER _ 6 CLOVER-CONTROL-ARCHIVE-4 Finalized CLOVER _ 7 CLOVER-CONTROL-ARCHIVE-5 Finalized CLOVER _ 8 CLOVER-CONTROL-ARCHIVE-6 Unloaded CLOVER _ 9 CLOVER-CONTROL-ARCHIVE-7 Finalized CLOVER _ 10 CLOVER-CONTROL-ARCHIVE-8 Unloaded CLOVER _ 11 CLOVER-CONTROL-ARCHIVE-9 Unloaded CLOVER Mark Selection, Enter Number or 'T' (Top) __ Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Menu Exit -- + Canc |
If there is no completed archive event whose name is in the specified range, a message appears on the original screen.
The "State" fields can have the values "Unloaded", "Locking", "Finalizing" and "Finalized".
"Unloaded" marks the archiving events which have been completed but whose finalization has not been started. The objects on the migration list of an unloaded archiving event have been written to a work file; their condition has not changed otherwise.
"Locking" and "Finalizing" mark the archiving events which have been completed and whose finalization has been started but not yet completed.
None of the objects on the migration list of a locking archiving event has been archived - i.e., deleted - from the ACF system file. Some objects on the migration list of a finalizing archiving event may have been archived while others remain only unloaded.
"Finalized" marks the archiving events which have been completed and whose finalization has also been completed. In some cases even an object on the migration list of a finalized archiving event may be unloaded but not archived.
The C fields of an Archive Event Selection List screen can take as values - in addition to "?" and "." - S(elect), D(isplay), M(odify), F(inalize), and P(urge). Only an archiving event in the state "Unloaded", "Locking" or "Finalizing" can be finalized.
The command S(elect) returns the Archive Event Maintenance Menu with its "Event" field filled with the name of the selected event.
Choose D from the Archive Event Maintenence Menu. D(isplay) produces a Display Archive Event screen:
14:04:36 ***** PREDICT APPLICATION CONTROL ***** 2000-04-16 User SAGU - Display Archive Event - Event ........ CLOVER-CONTROL-ARCHIVE-10 Modified: 1998-03-25 by EDSWBAT Application .. CLOVER Authorized ... 1998-03-25 12:13:49 by .. EDSW Tid .. MSN1#EC6 Unloaded ..... 1998-03-25 12:14:29 by .. EDSWBAT Tid .. EDSWBAT Finalized .... 1998-03-25 12:20:27 by .. EDSW Tid .. MSN1#EC7 Dataset ...... CLOVER-ARCHIVE-10___________________________ Volume Ser ... ______ Notes ........ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ Processing state ..... Finalized Unloaded objects ..... 2 Archived objects ..... 2 Additional Options ... N Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Menu Exit Opts Canc |
The default setting for additional options is N. If you set it to Y, a window is displayed with the following three additional options you can choose from:
Archive migration list - i.e., the migration list of the archiving event with entries on resolved ranges;
Audit report - i.e., the report of finalization which is present only if the archiving event is finalizing or finalized;
Date.
Choose M from the Archive Event Maintenence Menu.M(odify) produces a Modify Archive Event screen:
14:05:16 ***** PREDICT APPLICATION CONTROL ***** 2000-04-16 User SAGU - Modify Archive Event - Event ........ CLOVER-CONTROL-ARCHIVE-10 Modified: 1998-03-25 by EDSWBAT Application .. CLOVER Authorized ... 1998-03-25 12:13:49 by .. EDSW Tid .. MSN1#EC6 Unloaded ..... 1998-03-25 12:14:29 by .. EDSWBAT Tid .. EDSWBAT Finalized .... 1998-03-25 12:20:27 by .. EDSW Tid .. MSN1#EC7 Dataset ...... CLOVER-ARCHIVE-10___________________________ Volume Ser ... ______ Notes ........ ____________________________________________________________ ____________________________________________________________ ____________________________________________________________ Processing state ..... Finalized Unloaded objects ..... 2 Archived objects ..... 2 Additional Options ... N Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Menu Exit Opts Canc |
A Modify Archive Event screen differs from the Display Archive Event in the following areas:
Dataset;
Volume Ser;
Notes
Fields are unprotected, and their contents can be changed on the screen and in the corresponding archiving event record fields in the ACF system file.
Choose F from the Archive Event Maintenence Menu. F(inalize) is applicable only to unloaded, locking, and finalizing archiving events. When applied, it produces a Finalize Confirmation window:
14:03:46 ***** PREDICT APPLICATION CONTROL ***** 2000-04-16 User SAGU - Archive Event Selection List - C Nr Event Name State Application Name - -- -------------------------------- ---------- ----------------------------- _ 1 CL+---------------------------------------------------+ _ 2 CL| --- Finalize Confirmation --- | f 3 CL| | _ 4 CL| Archive Event .. CLOVER-CONTROL-ARCHIVE-11 | _ 5 CL| | _ 6 CL| The Finalize option has been invoked. | _ 7 CL| | _ 8 CL| Enter 'CONFIRM' or press PF5 to finalize or '.' | _ 9 CL| to exit .. _______ | _ 10 CL| | _ 11 CL| Verify Default parameters before continuing ... | | | | Batch/Online .. B | | Job ........... BS2_BATCH_JCL___________________ | | | +---------------------------------------------------+ Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Menu Exit -- + Canc |
Finalization can be performed online or in batch. Specify O(nline) or B(atch) in the Batch/Online field of the window. If you select B(atch), the name of a JCL text in the ACF system file must be specified in the "Job" field. The sample JCL texts provided by Software AG are called ..._BATCH_JCL. The @PAC-REQUEST parameter receives the value "ARCFINAL <event name>".
Enter CONFIRM or press PF5 to finalize an event. To exit the window without finalizing the archive event, enter a period (.) or press PF3 (Exit) or PF12 (Cancel)
Choose P from the Archive Event Maintenence Menu. P(urge) produces a Purge Confirmation window:
14:03:46 ***** PREDICT APPLICATION CONTROL ***** 2000-04-16 User SAGU - Archive Event Selection List - C Nr Event Name State Application Name - -- -------------------------------- ---------- ----------------------------- p 1 CL+---------------------------------------------------+ _ 2 CL| --- Purge Confirmation --- | _ 3 CL| | _ 4 CL| Archive Event .. CLOVER-CONTROL-ARCHIVE-1 | _ 5 CL| | _ 6 CL| The Purge option has been invoked. | _ 7 CL| | _ 8 CL| Enter 'CONFIRM' or press PF5 to finalize or '.' | _ 9 CL| to exit .. _______ | _ 10 CL| | _ 11 CL| | | | | | +---------------------------------------------------+ Command ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Menu Exit -- + Canc |
Enter CONFIRM or press PF5 to purge an event whose entry is marked with a P in the Archive Event Selection List. Press PF3 to return to the Archive Event Selection List screen or to apply the next function specified in a C field of the Archive Event Selection List screen without purging the event.
After a completed archiving event has been purged, the work file it produced cannot be used by any restoration event.
To finalize or purge an event
use option F or P on the Archive Event Maintenance Menu or
use option S and, in column "C", select F or P.