Object Version Maintenance

#### Search Results

Search

# Object Version Maintenance

The object maintenance facilities allow PAC administrators to

- view and purge change control logs - i.e., the records of migrations of individual objects to and from A (M) status;

- view which parts of Natural objects are in the PCF system file and deactivate the objects - i.e. delete their copies from the PCF;

- view and purge object audit history - i.e., the records of the individual objects in migrations;

- view and purge logged object versions - i.e., the records of individual object removals (retirement or purging from CONTROL or retirement or purging from ARCHIVE);

- view and purge objects in CONTROL or ARCHIVE.

To access the object maintenance functions, enter Code V on the main menu to access the Versioned Objects menu. Enter Code M on the Versioned Objects menu.

The Object Version Maintenance menu appears:

    18:47:45            ***** PREDICT APPLICATION CONTROL *****            2000-04-03
    User SAGU              - Object Version Maintenance -

                      Code  Function
                      ----  -----------------------------------
                        C   Change Control Logs
                        D   Deactivate Object Versions
                        H   Object Version Audit History
                        L   Logged Object Versions
                        P   Purge Object Versions
                        ?   Help
                        .   Exit
                      ----  -----------------------------------

                Code ... _

    Command ===>
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Menu  Exit                                                  Canc

This document covers the following topics:

- Change Control Logs

- Select Closed Change Log from List

- Deactivate Object Versions

- Deactivate Objects from Selection List

- Object Version Audit History

- Purge Object Version Audit History

- Versioned Object Logs

- Select Object Version Log from List

- Display Object Version Log

- Purge Object Version Log

- Purge Object Version

## Change Control Logs

Change control logs are records of individual objects to be migrated to and from a (M) status. A change control log refers either to a versioned object migrated to a (M) status or to a versioned object from a (M) status or to several like named objects, the first of which was migrated to, and the second migrated from a (M) status.

A change control log contains

- the name of an application;

- the name of a maintenance status;

- the name of a Natural object or the number of an error message;

- a designation of the object's type.

It may contain

- the identifier of a maintenance request.

The check-out / check-in information contains

- either an object's check-out data

- or an object's check-in data.

An object's check-out data includes

- the number of the version (migrated to maintenance);

- the library name and the database and file numbers of the Natural location of the migration;

- the time of the migration;

- the user ID of the initiator of the migration;

- the terminal ID of the terminal from which the migration was initiated.

An object's check-in data includes

- the number of the version (migrated from maintenance or retired to maintenance;

- the library name and the database and file numbers of the Natural location of the migration, whereby the string ">Cancel<" takes the place of the library name, if the object was retired from the maintenance migration;

- the time of the migration or retirement;

- the user ID of the initiator of the migration or retirement;

- the terminal ID of the terminal from which the migration or retirement was initiated.

A change control log is defined as closed if it contains the check-in data of an object. It is defined as open if it is not closed. Only closed change control logs can be viewed or purged in the Administration Functions subsystem of PAC. Both the open and the closed change control logs can be viewed; neither can be purged in the Reporting and Maintenance subfunctions subsystem of PAC.

To access the change control logs maintenance functions, enter Code C on the Object Version Maintenance screen.

## Select Closed Change Log from List

The Closed Change Control Logs Menu appears:

    18:51:18          ***** PREDICT APPLICATION CONTROL *****             2000-04-03
    User SAGU           - Closed Change Control Logs Menu -

                      Code  Sub-Function
                      ----  -----------------------------
                        R   Select Logs by Request ID
                        S   Select Logs by Object Name
                        U   Select Logs by Check-Out User
                        ?   Help
                        .   Exit
                      ----  -----------------------------

       Code ........... _
       Application .... ________________________________
       Object Name .... ________________________________
       Library Name ... ________  DBnr ... ___  Fnr ... ___
       Request / User . ____________________

    Command ===>
     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help  Menu  Exit                                                  Canc

To select change control logs for viewing or purging, enter

- one the following codes:

  - Code R to obtain a list of logs referring to specified maintenance requests and primarily sorted by the IDs of the requests referred to;

  - Code S to obtain a list of logs referring to specified maintenance requests and primarily sorted by the IDs of the requests referred to;

  - Code U to obtain a list of logs created at migrations initiated by specified users and primarily sorted by the check-out user IDs.

- the name of an application - optional with Code R, required with Code S;

- a range of object names - assumed "*" if left blank;

- optionally the library name and the database and file numbers of a Natural location to be matched by those in the check-in data of the selected logs;

- a range of request IDs with Code R or S, a range of user IDs with Code U - either assumed "*" if the "Request/User" field is left blank.

If there is a change control log which satisfies the selection criteria, a Change Control Log Selection List appears:

     19:13:57          ***** PREDICT APPLICATION CONTROL *****             2000-04-03
     User SAGU          - Change Control Log Selection List -

     PURGE Log *
     C Nr Object   Library  OutVer OutDate User   InVer InDate     Request ID
     - -- -------- -------- ---- -------- ------- ---- -------- -------------------
     _  1 ES_Z_C03 >cancel<    1 19980117 EDSW       1 19980118
     _  2 ES_Z_L01 ES1                               1 19980117
     _  3 ES_Z_L01 >cancel<    1 19980117 EDSW       1 19980118
     _  4 ES_Z_L02 ES1                               1 19980117
     _  5 ES_Z_L02 >cancel<    1 19980117 EDSW       1 19980118
     _  6 ES_Z_N02 >cancel<    1 19980117 EDSW       1 19980118
     _  7 ES_Z_P07 ES1         1 19980117 EDSW       2 19980117 REQUEST002
     _  8 ES_Z_P07 >cancel<    2 19980117 EDSW       2 19980118
     _  9 ES_Z_P08 ES1         1 19980117 EDSW       1 19980117 REQUEST002

                    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 no change control log satisfies the selection criteria, a message appears on the original screen.

If no application name is specified or "*", "<", or ">" occurs in the Application field, an application selection list is displayed, allowing you to to select an application.

If no request ID is specified with Code R, all logs satisfying the other selection criteria and each referring to some maintenance request are listed. If no request ID is specified with Code S, the selection is not restricted on the account of the Request/User field and logs which do not refer to any maintenance request may also be listed.

If no user ID is specified with Code U, all logs containing check-out data are listed.

The C fields of the Change Control Log Selection List screen can take as values - in addition to " ", "?" and "." - S(elect), D(isplay), and P(urge).

S(elect) returns the Closed Change Control Logs Menu with its fields filled with the data of the selected log.

D(isplay) produces a Display Change Control Log screen:

     19:18:49          ***** PREDICT APPLICATION CONTROL *****             2000-04-03
     User: SAGU            - Display Change Control Log -

     Request Id ... REQUEST002                       Modified: 1998-01-17 by EDSW
     Application .. CLOVER
     Object ....... ES_Z_P07 (Progrm)
     Status ....... MAI1
     Access type .. (Update)

                            --- Check-Out/Check-In Information ---
                   Version  Library   DBnr Fnr  UserID   Date-Time         TermID
                   -------  --------  ---- ---  -------- ----------------- --------
     Check-Out ....     1   ES1       222  127  EDSW   1998-01-17 17:51:11 MSN1#EC6
     Check-In .....     2   ES1       222  127  EDSW   1998-01-17 18:11:23 MSN1#EC6

     Notes ........

     Additional Options ... N

     Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
           Help        Exit  Opts  Purge                                     Canc

The type designation in parentheses in the Object field belongs to the migrated object if the log was closed by a retirement; it belongs to the migrated object if the log was closed by a migration.

The Access type field can have as values "(Open)", "(Update)" and "(Access)". Only "(Open)" can occur in an open log, only "(Update)" or "(Access)" in a closed one. "(Update)" indicates that the log was closed by a migration and the migrated object is distinct from the migrated; in other closed logs the value is "(Access)".

P(urge) produces a Purge Confirmation window:

     19:13:57          ***** PREDICT APPLICATION CONTROL *****             2000-04-03
     User SAGU          - Change Control Log Selection List -

     PURGE Log *
     C Nr Object +-----------------------------------------------------+st ID
     - -- -------|            --- Purge Confirmation ---               |------------
     _  1 ES_Z_C0|                                                     |
     _  2 ES_Z_L0| Application .. CLOVER                               |
     _  3 ES_Z_L0|                                                     |
     _  4 ES_Z_L0| The Purge option has been invoked for Change        |
     _  5 ES_Z_L0| Control Logs for this Application. The              |
     _  6 ES_Z_N0| maintenance activity of the object(s) selected      |
     p  8 ES_Z_P0| will be removed.                                    |  02
     _  9 ES_Z_P0|                                                     |
                 | Enter 'CONFIRM' or press PF5 to Purge or '.'        |  02
                 | to Exit ... _______                                 |
                 |                                                     |
                 +-----------------------------------------------------+
                    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

Enter CONFIRM or press PF5 to purge the change control logs marked with "P"s in the Change Control Log Selection List. Press PF3 to return to the Closed Change Control Logs Menu without purging the logs.

## Deactivate Object Versions

To access the object deactivation functions, enter Code D on the Object Version Maintenance screen.

The Deactivate Object Version Menu appears:

    22:53:10          ***** PREDICT APPLICATION CONTROL *****             2000-04-03
    User SAGU            - Deactivate Object Version Menu -

                      Code  Sub-Function
                      ----  ----------------------------------------
                        D   Deactivate Versioned Object
                        ?   Help
                        .   Exit
                      ----  ----------------------------------------

       Code ........... _           Selection List ... Y
       Application .... ________________________________
       Object Name .... ________________________________
       Object Type .... _______________

    Command ===>
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Menu  Exit                                                  Canc

To select objects for viewing or deactivation, enter

- Code D;

- Selection List Y;

- the name of an application;

- a range of object names - assumed "*" if left blank;

- a (possibly empty) string of Natural object type designations consisting of one letter.

## Deactivate Objects from Selection List

If there is an object which satisfies the selection criteria, a Deactivate Object Version Selection List appears:

    22:54:22          ***** PREDICT APPLICATION CONTROL *****             2000-04-03
    User SAGU       - Deactivate Object Version Selection List -

     C Nr Object Name                      Object Type     S/C State
     - -- -------------------------------- --------------- --- -----------
     _  1 ES_Z_A01                         Parameter       S/C
     _  2 ES_Z_C03                         Copycode        S
     _  3 ES_Z_L03                         Local           S/C
     _  4 ES_Z_N02                         Subprogram      S/C
     _  5 ES_Z_P07                         Program         S/C
     _  6 ES_Z_P11                         Program             Deactivated

                    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

This is a list of Natural object names, accompanied by type designations rather than a list of versioned objects. For each entry, there can be many like named versioned objects. The entry stands for the one with the highest number, the only one which can normally be in the PCF system file.

If no object satisfies the selection criteria, a message appears on the original screen.

If no application name is specified or if "*", "<", or ">" occurs in the Application field, an application selection list is displayed letting one choose an application.

"S/C", "S", "C", or blank in an S/C field of a Deactivate Object Version Selection List screen indicates that copies of both the source of the object and its loadable part, only that of its source, only that of its loadable part, or neither of these is in the PCF system file.

"Deactivated" in a State field of a Deactivate Object Version Selection List screen indicates that no copy of the highest numbered version of an object referred to in the entry is present in the PCF system file.

The C fields of a Deactivate Object Version Selection List screen can take the value - in addition to " ", "?" and "." - D(eactivate).

D(eactivate) produces a Deactivate Confirmation window:

     19:13:57          ***** PREDICT APPLICATION CONTROL *****             2000-04-03
     User SAGU          - Deactivate Object Version Selection List -

     PURGE Log *
     C Nr Object +-----------------------------------------------------+
     - -- -------|         --- Deactivate Confirmation ---             |--
     _  1 ES_Z_C0|                                                     |
     _  2 ES_Z_L0| Application .. HEATHER                              |
     _  3 ES_Z_L0|                                                     |
     _  4 ES_Z_L0| The Deactivate option has been invoked for          |
     _  5 ES_Z_L0| Objects in this Application.                        |
     _  6 ES_Z_N0| maintenance activity of the object(s) selected      |
     p  8 ES_Z_P0| will be removed.                                    |
     _  9 ES_Z_P0|                                                     |
                 | Enter 'CONFIRM' or press PF5 to Deactivate or '.'   |
                 | to Exit ... _______                                 |
                 |                                                     |
                 +-----------------------------------------------------+
                    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

Enter CONFIRM or press PF5 to deactivate the objects marked with D's in the Deactivate Object Version Selection List. Press PF3 to return to the Deactivate Object Version Menu without deactivating the objects.

If the Selection List field of the Deactivate Object Version Menu is set to N rather than Y then objects are selected just as they would be selected with but instead of listing them PAC immediately produces a Deactivate Confirmation window and upon confirmation deactivates all selected objects.

## Object Version Audit History

An object audit version history record is a record in the ACF system file which contains information about the migrated object. When an object is migrated to test, production or maintenance, an object-status link (record) is created in the ACF system file; this makes the object "known by PAC to be in the migration". If the object is overwritten during the migration with another object of the same application or retired from the migration, the object-status link becomes an audit version history record. Such a version audit history record stays in the ACF system file as long as the object or its archive stays in the application - unless an administrator purges the record, using the facility described in this section.

To access the object version audit history maintenance functions, enter Code H on the Object Version Maintenance screen.

The Purge Object Version Audit History Menu appears:

    22:56:26          ***** PREDICT APPLICATION CONTROL *****             2000-04-03
    User SAGU       - Purge Object Version Audit History Menu -

                      Code  Sub-Function
                      ----  -----------------------------------
                        P   Purge Object Version Audit History
                        ?   Help
                        .   Exit
                      ----  ------------------------------------

        Code .......... _           Selection List ... Y
        Application ... ________________________________
        Status ........ ________________________________
        Object ........ ________________________________
        Object Type ... _______________

    Command ===>
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Menu  Exit                                                  Canc

To select audit history records for viewing or purging, enter

- Code P;

- the name of an application;

- the name of a status;

- a range of object names - assumed "*" if left blank;

- a (possibly empty) string of one letter Natural object type designations: "E" for error messages, "V" for views, or "R" for rules.

If there is an audit history record satisfying the selection criteria then an Audit History Selection List appears:

    22:59:02          ***** PREDICT APPLICATION CONTROL *****             2000-04-03
    User SAGU             - Audit History Selection List -

    Application ... FURZE
    Status ........ AS-MAI7
    C Nr Object Name                      Object Type Version Effective Date
    - -- -------------------------------- ----------- ------- -------------------
    _  1 AS_Z_A01                         Parameter     0001  1998-03-27 13:21:42
    _  2 AS_Z_A02                         Parameter     0001  1998-03-27 13:21:41
    _  3 AS_Z_N99                         Subprogram    0001  1998-02-15 19:24:56
    _  4 AS_Z_P01                         Program       0003  1998-03-04 13:51:01
    _  5 AS_Z_P01                         Program       0003  1998-03-04 13:47:49
    _  6 AS_Z_P01                         Program       0003  1998-02-15 19:54:48
    _  7 AS_Z_P03                         Program       0002  1998-02-15 19:44:49
    _  8 AS_Z_P03                         Program       0001  1998-02-15 19:36:26
    _  9 AS_Z_P03                         Program       0002  1998-02-15 19:31:35
    _ 10 AS_Z_P04                         Program       0002  1998-03-15 20:29:28
    _ 11 AS_Z_P04                         Program       0001  1998-02-20 11:19:35
    _ 12 AS_Z_P04                         Program       0001  1998-02-15 19:28:34

                    Mark Selection, Enter Number or 'T' (Top) __

    Command ===>
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Menu  Exit              --          +                 SDate Canc

If no audit history record satisfies the selection criteria, a message appears on the original screen.

If no application name is specified or if "*", "<", or ">" occurs in the Application field, an application selection list is displayed, allowing you to select an application.

If an application has been specified but no status has or "*", "<", or ">" occurs in the Status field, an application status-link selection list is displayed, allowing you to select a link, which defines a migration.

If the Object Type field has been left blank or contains an "*", the selection of audit history records is not restricted on its account. This is the only way to list the audit history records of foreign objects.

The last column of an Audit History Selection List screen can be switched from "Effective Date" to "Superseded Date" by pressing PF11 and PF10, respectively.

There can be more than one entry for a single versioned object in an Audit History Selection List. This occurs if the object has been migrated to the migration several times.

The C fields of a Deactivate Object Version Selection List screen can take the value - in addition to " ", "?" and "." - P(urge).

## Purge Object Version Audit History

P(urge) produces a Purge Confirmation window:

    22:59:02          ***** PREDICT APPLICATION CONTROL *****             2000-04-03
    User SAGU             - Audit History Selection List -

    Application+-------------------------------------------------+
    Status ....|           --- Purge Confirmation ---            |
    C Nr Object|                                                 | Date
    - -- ------| Application .. FURZE                            |---------------
    _  1 AS_Z_A| Status ....... AS-MAI7                          |-03-27 13:21:42
    _  2 AS_Z_A|                                                 |-03-27 13:21:41
    _  3 AS_Z_N| The Purge option has been invoked for Object    |-02-15 19:24:56
    _  4 AS_Z_P| Version Audit History in the above Application  |-03-04 13:51:01
    _  5 AS_Z_P| Status Link.                                    |-03-04 13:47:49
    _  6 AS_Z_P|                                                 |-02-15 19:54:48
    _  7 AS_Z_P| Enter 'CONFIRM' or press PF5 to Purge or '.'    |-02-15 19:44:49
    _  8 AS_Z_P| to Exit ... _______                             |-02-15 19:36:26
    _  9 AS_Z_P|                                                 |-02-15 19:31:35
    _ 10 AS_Z_P|                                                 |-03-15 20:29:28
    _ 11 AS_Z_P+-------------------------------------------------+-02-20 11:19:35
    _ 12 AS_Z_P04                         Program       0001  1998-02-15 19:28:34

                    Mark Selection, Enter Number or 'T' (Top) __

    Command ===>
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Menu  Exit              --          +                 SDate Canc

Enter CONFIRM or press PF5 to purge the audit history records marked with P's in the Audit History Selection List. Press PF3 to return to the Purge Object Version Audit History Menu without purging the audit history records.

## Versioned Object Logs

A versioned object log is a record in the ACF system file containing information about the previous existence of an object in an application. When an object migrated to CONTROL, an object record is created in the ACF system file. If the object is retired or purged from CONTROL or from ARCHIVE, its record is deleted from the ACF system file or its record is recorded on an object log. (The latter occurs if the Versioned Object Log option of the application has been set to "Y".) Such an object log stays in the applicaltion as long as an administrator does not purge it, using the facility described in this section.

To access the object purge logs maintenance functions, enter Code L on the Object Maintenance screen.

The Versioned Objects Log Maintenance Menu appears:

    23:01:11          ***** PREDICT APPLICATION CONTROL *****             2000-04-03
    User SAGU         - Versioned Objects Log Maintenance Menu -

                      Code  Sub-Function
                      ----  ----------------------------------------
                        D   Display Versioned Object Log
                        H   Hardcopy Versioned Object Log
                        S   Select Versioned Object Log
                        P   Purge Versioned Object Log
                        ?   Help
                        .   Exit
                      ----  ----------------------------------------

       Code ........... _
       Application .... ________________________________
       Object Name .... ________________________________
       Version From ... ____         Version To ... ____
       Object Type .... _______________

    Command ===>
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Menu  Exit                                                  Canc

To select object purge logs for displaying, hardcopying, or purging, enter

- Code S;

- the name of an application;

- a range of object names - assumed "*" if left blank;

- a range of object version numbers - assumed from 1 to 9999 if both fields are left blank;

- a (possibly empty) string of one letter Natural object type designations, "E" for error messages, "V" for views, or "R" for rules.

## Select Object Version Log from List

If there is an object log which satisfies the selection criteria, an Object Version Log Selection List appears:

    23:03:27           ***** PREDICT APPLICATION CONTROL *****             2000-04-03
      User SAGU        - Object Version Log Selection List -

      C Nr Object Name                      Object Type     Ver  Purge Date-Time
      - -- -------------------------------- --------------- ---- ------------------
      _  1 ES_Z_N02                         Subprogram      0002 1997-04-01 20:15:56
      _  2 ES_Z_P07                         Program         0002 1997-04-01 20:15:56

                     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 no object log satisfies the selection criteria then a message is superimposed on the original screen.

If no application name is specified or "*", "<", or ">" occurs in the Application field then an application selection list is displayed letting one choose an application.

If the Object Type field has been left blank or contains an "*" then the selection of object purge logs is not restricted on its account. This is the only way of getting the foreign object purge logs listed.

The C fields of an Object Version Log Selection List screen can take as values - in addition to "?" and "." - D(isplay), H(ardcopy), S(elect), and P(urge).

S(elect) returns the Versioned Objects Log Maintenance Menu with its fields filled with the data of the selected log.

## Display Object Version Log

D(isplay) produces a Display Object Purge Log screen:

    23:04:11            ***** PREDICT APPLICATION CONTROL *****           2000-04-03
    User SAGU              - Display Object Version Log -

    Application ... HEATHER
    Object ........ ES_Z_N02.0002 (Subprogram)
    Purged ........ 1998-04-01 20:15:56 By .. EDSW     at .. MSN1#EC7
    Saved ......... 1998-01-18 22:17:15
    Cataloged ..... 1998-01-18 22:17:15
    Migration Event .. HEATHER-DEV0-CONTROL-1
    Created .......... 1998-01-18 22:17:01

                    --- Development Source Directory Information ---
    Library .... ES0        User-ID ...... EDSW         Saved .. 1998-01-18 22:16:17
    Tp-System .. RTIO       Terminal-ID .. MSN1#EC1
    Op-System .. MVS     Transaction .. C.NRT227
    NAT-Ver .... 2.2.7      Mode ......... Structured
    Size in ESIZE ........................ 653     Bytes

    Additional Options ... N

    Command ===>
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Menu  Exit  Opts                                            Canc

The Display Object Version Log screen is similar to the Display Object Version screen for the object before its retirement or purging. There are two additional option: Dates and Audit Report. Audit Report is produced by the activity that retired or purged the object from CONTROL or ARCHIVE.

## Purge Object Version Log

P(urge) produces a Purge Confirmation window:

    23:03:27           ***** PREDICT APPLICATION CONTROL *****             2000-04-03
    User SAGU        - Object Version Log Selection List -

    C Nr Object +----------------------------------------------+ Date-Time
    - -- -------|        --- Purge Confirmation ---            | ------------------
    _  1 ES_Z_N0|                                              |97-04-01 20:15:56
    _  2 ES_Z_P0| Object ... ES_Z_N02                          |997-04-01 20:15:56
                | Version .. 0002                              |
                | The Purge option has been invoked.           |
                |                                              |
                | Enter 'CONFIRM' or press PF5 to Purge or '.' |
                | to Exit ... _______                          |
                |                                              |
                +----------------------------------------------+

                   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

Enter CONFIRM or press PF5 to purge the object purge logs marked with P's in the Object Version Log Selection List. Press PF3 to return to the Versioned Objects Log Maintenance Menu without purging the logs.

To display, hardcopy, or purge a single object purge log from the Object Purge Logs Menu, enter

- Code D, H or P;

- the name of an application;

- a range of object names - assumed "*" if left blank;

- a range of object version numbers - assumed from 1 to 9999 if both fields are left blank;

- a (possibly empty) string of Natural object type designations consisting of one letter: "E" for error messages, "V" for views or "R" for rules.

If there are no logs satisfying the specified criteria then a message is superimposed on the original screen.

If there is exactly one log satisfying the specified criteria, it is displayed or hardcopied with Code at "D" or "H". For [Code] = "P", a Purge Confirmation window appears.

If there is more than one log satisfying the specified criteria, a modified S(elect) is applied instead. The modification consists in the restriction of the set of functions applicable to the selected logs to {D}, {H}, or {P}.

## Purge Object Version

Objects can be removed from CONTROL

- by retirement from CONTROL;

- by archiving - i.e., by finalizing a completed CONTROL to ARCHIVE migration event;

- by purging from CONTROL, which is described in this section.

The removability of an object from a CONTROL status is affected by the values of the Minimum Current Versions and Current Retention Period fields of the application.

Note
If applymod 23 is not active, an object cannot be removed from a CONTROL compartment if it is known to have been migrated to test, production, or maintenance and is not known to have been subsequently overwritten there or retired to it. An object whose removal from CONTROL is not allowed for any of these reasons.

- will be passed over by any submitted retirement from CONTROL event;

- will be passed over at the finalization of any archiving event;

- will be neither presented on any Purge Object Version Selection List nor purged without being so presented.

When an object is archived, it is removed from CONTROL, and its record in the ACF system file is logged. While thelogged object remains in the application (and the work file to which the object has been copied remains available), the object itself can be restored. If the token is deleted, the object is no longer restorable. The deletion of a logged object from an application causes its "removal from ARCHIVE". It can be achieved

- by retirement from ARCHIVE;

- by purging from ARCHIVE, which is described in this section.

The removability of an object from ARCHIVE in the above sense is affected by the values of the Minimum Archive Versions and Archive Retention Period fields of the application. A logged object whose deletion is not allowed by either of the two values

- will be passed over by any submitted retirement from ARCHIVE event;

- will neither appear on any Purge (archived) Object Version Selection List nor be deleted without being so presented.

To access the object purging functions, enter Code P on the Object Version Maintenance screen.

The Purge Object Version Menu appears:

    23:08:34             ***** PREDICT APPLICATION CONTROL *****             2000-04-03
    User SAGU               - Purge Object Version Menu -

                      Code  Sub-Function
                      ----  ----------------------------------------
                        A   Purge Versioned Objects in Archive
                        C   Purge Versioned Objects in Control
                        ?   Help
                        .   Exit
                      ----  ----------------------------------------

       Code ........... _           Selection List ... Y
       Application .... ________________________________
       Object Name .... ________________________________
       Version From ... ____         Version To ... ____
       Object Type .... _______________

    Command ===>
    Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
          Help  Menu  Exit                                                  Canc

To select objects to be purged from CONTROL or ARCHIVE enter

- Code C or A;

- Selection List Y;

- the name of an application;

- a range of object names - assumed "*" if left blank;

- a range of object version numbers - assumed from 1 to 9999 if both fields are left blank;

- a (possibly empty) string of Natural object type designations consisting of one letter: "E" for error messages, "V"for views "R" for rules.

If there is an object version (for [Code] = "C") or object version (for [Code] = "A") which satisfies the selection criteria, a Purge Object Version Selection List appears:

    23:09:55          ***** PREDICT APPLICATION CONTROL *****             2000-04-03
    User SAGU         - Purge Object Version Selection List -

     C Nr Object Name                      Object Type     Ver  Migration Date
     - -- -------------------------------- --------------- ---- -----------------
     _  1 ES_FU_11                         View            0003 1998-03-12 14:33:55
     _  2 ES_FU_11                         View            0002 1998-01-17 17:54:19
     _  3 ES_FU_11                         View            0001 1998-03-12 13:48:34
     _  4 ES_FU_12                         View            0001 1998-01-17 17:54:20
     _  5 ES_Z_A01                         Parameter       0003 1998-01-18 22:19:11
     _  6 ES_Z_A01                         Parameter       0002 1998-01-18 22:17:00
     _  7 ES_Z_C03                         Copycode        0003 1998-01-18 22:19:11
     _  8 ES_Z_C03                         Copycode        0002 1998-01-18 22:17:01
     _  9 ES_Z_L03                         Local           0001 1998-03-12 14:29:28
     _ 10 ES_Z_N02                         Subprogram      0003 1998-01-18 22:19:12
     _ 11 ES_Z_P07                         Program         0003 1998-01-18 22:19:12
     _ 12 ES_Z_P11                         Program         0001 1998-03-12 14:29:28
     _ 13 FUSER-127-ES-0                   View            0001 1998-03-12 15:42:59

                     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 no object of Control Status (for [Code] = "C") or object of Archive Status (for [Code] = "A") satisfies the selection criteria then a message is superimposed on the original screen.

If no application name is specified or "*", "<", or ">" occurs in the Application field then an application selection list is displayed letting one choose an application.

If the Object Type field has been left blank or contains an "*" then the selection of objects or tokens is not restricted on its account. This is the only way of getting the foreign objects listed.

The C fields of a Purge Object Version Selection List screen can take the value - in addition to " ", "?" and "." - P(urge).

P(urge) produces a Purge Confirmation window:

    23:09:55          ***** PREDICT APPLICATION CONTROL *****             2000-04-03
    User SAGU         - Purge Object Version Selection List -

     C Nr Object+--------------------------------------------------------+n Date
     - -- ------|              --- Purge Confirmation ---                |--------
     _  1 ES_FU_|                                                        | 14:33:55
     _  2 ES_FU_| Application .. HEATHER                                 | 17:54:19
     _  3 ES_FU_|                                                        | 13:48:34
     _  4 ES_FU_| The Purge option has been invoked for Objects in       | 17:54:20
     _  5 ES_Z_A| this Application which have not been promoted to       | 22:19:11
     _  6 ES_Z_A| any Status and Objects which are currently in the      | 22:17:00
     _  7 ES_Z_C| Archive Status                                         | 22:19:11
     _  8 ES_Z_C|                                                        | 22:17:01
     _  9 ES_Z_L| Enter 'CONFIRM' or press PF5 to Purge or '.'           | 14:29:28
     _ 10 ES_Z_N| to Exit ... _______                                    | 22:19:12
     _ 11 ES_Z_P|                                                        | 22:19:12
     _ 12 ES_Z_P+--------------------------------------------------------+ 14:29:28
     _ 13 FUSER-127-ES-0                   View            0001 1998-03-12 15:42:59

                     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

Enter CONFIRM or press PF5 to purge the objects whose entries are marked with P's in the Purge Object Version Selection List. Press PF3 to return to the Purge Object Version Menu without purging the logs.

If the Selection List field of the Purge Object Version Menu is set at N rather than Y then objects are selected just as they would be selected with Y; but instead of listing them, PAC immediately produces a Purge Confirmation window and, at confirmation, purges all selected objects or tokens.

### On this page

- Change Control Logs
- Select Closed Change Log from List
- Deactivate Object Versions
- Deactivate Objects from Selection List
- Object Version Audit History
- Purge Object Version Audit History
- Versioned Object Logs
- Select Object Version Log from List
- Display Object Version Log
- Purge Object Version Log
- Purge Object Version