Archive Event Maintenance

#### Search Results

Search

# Archive Event Maintenance

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:

- Select an Archive Event

- Display Archive Event

- Modify Archive Event

- Finalize Archive Event

- Purge Archive Event

## Select an Archive Event

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.

## Display Archive 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.

## Modify Archive Event

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.

## Finalize Archive Event

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 GmbH 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)

## Purge Archive Event

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.

### On this page

- Select an Archive Event
- Display Archive Event
- Modify Archive Event
- Finalize Archive Event
- Purge Archive Event