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 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.
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.
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.
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.
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).
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.
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.
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.
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 .. BS2000 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.
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}.
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.