When objects are migrated to or from a maintenance status, the check-out/check-in facility of PAC is automatically activated: objects are checked out of PAC to a maintenance status type, then are checked back into PAC. The maintenance activities are tracked through the audit history of the change control logs that record these events.
Detailed information about the maintenance of Natural objects can be retrieved using the change control log sub-function of the PAC check-out/check-in facility
For general information about change control logs, refer to Maintaining Natural Objects in PAC.
This document covers the following topics:
Note:
Different users may check out the same object since each user has a
unique copy of the object.
When you set up the migration event to check an object out to a maintenance status, you may identify a maintenance request ID, but that is not required. When the migration event is processed
the specified versions of the objects are migrated to the maintenance status location;
an object status is created; and
Information recorded when the change control log is created can be displayed on the Display Change Control Logscreen.
Before a maintenance change to an object can be recorded, the object must be returned to PAC. The migration event to return the object to the PAC controlled environment should specify
the maintenance status in which the object is being maintained;
the destination status, which must be Control, test, or production; and
When the migration event is processed
the object is moved or copied from the maintenance status into Control;
the link of the object version checked out to the maintenance status is purged; and
the change control log for that object is located, updated, and closed.
If the Copy option is used, a new change control log of the new version of the object is created, and the new version of the object is placed in the origin maintenance status.
If the Move option is used, the object is checked in and physically deleted from the maintenance library.
If applymod 24 is switched on, only the source of the object is deleted from the maintenance library.
If PAC User Exit 7 is active, the user may verify the check-in.
PAC audits the check-in of the object. This information can be viewed in the audit report.
The updated change control log can be displayed on the Display Change Control Log screen.
To access the PAC Change Control Log sub-functions, enter Code Q on the PAC Main Menu.
The Change Control Log Menu appears:
08:13:00 ***** PREDICT APPLICATION CONTROL ***** 2000-05-01
User PACUSR - Change Control Log Menu -
Code Sub-Function
---- ----------------------------
D Display Change Control Log
O Select All Open Logs
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 ID .... ____________________
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Exit Canc
|
From this menu, you can retrieve change control log information for a specific log, or you can retrieve lists of all logs, logs for objects checked out but not yet checked back in, logs displayed alphabetically by maintenance request ID, object name, or user who checked the object out.
The input fields on the screen are used to enter search criteria for retrieving logs. Depending on the sub-function, entries may be required or optional. See Selecting a Log from a List for more information. You may specify a value or a range for Object Name, Library Name, and Request ID. In the DBnr and Fnr fields, you may indicate a search of all numbers by leaving the field blank or entering a 0; or you may enter a specific value (1-254 for DBnr; 1-255 for Fnr).
To access a list of logs from the Change Control Log Menu, enter one of the Select ... sub-functions (O, R, S, U) and the required search criteria.
The requirements for each available option are indicated in the following table:
| Code | Description and Requirements | |
|---|---|---|
|
|
||
| O | All open logs for an application. Enter any relevant selection criteria; the application name is required. | |
| R | All logs for a specified maintenance request. Enter the name of the maintenance request or a range in the Request ID field; the application name is optional. | |
| S | All logs for a specified object. Enter the object name or a range in the Object Name field; the application name is optional. | |
| U | All logs for an application for the current check-out user. Enter any relevant selection criteria; the application name is required. To select all logs that are checked out but not yet checked in, enter Code U and in the Request ID field, enter the user ID followed by ".O"; for example, SAGNA.O. | |
Note:
Since the selection criteria may result in many reads before a
selection is made, the monitor option may be used to view all activities. You
may set the monitor on by typing "MON" on the command line and turn it off by
typing "NOMON". By default, the monitor is set to off.
The Change Control Log Selection List screen appears displaying the requested list of logs:
14:34:00 ***** PREDICT APPLICATION CONTROL ***** 2000-07-01
User PACUSR - Change Control Log Selection List -
DISPLAY Request *
C Nr Object Ver. Library Out User Out Date In Date Request ID Ty
- -- -------- ---- -------- -------- -------- -------- -------------------- --
_ 1 AA 10 MRMNT SAGMRBAT 2000-06-22 U
_ 2 BB 6 MRMNT SAGMRBAT 2000-06-22 U
_ 3 DUT2 1 MR SAGYZBAT 2000-06-23 MR3 U
_ 4 DUT3 1 MR SAGYZBAT 2000-06-23 MR3 U
_ 5 DUT4 1 MR SAGYZBAT 2000-06-23 MR3 U
_ 6 D82PMAIN 24 MRMNT SAGMRBAT 2000-06-22 U
_ 7 PROGA 1 MRMNT SAGMRBAT 2000-06-23 2000-06-23 MR3 U
_ 8 PROGA 1 MRMNT SAGNA 2000-06-23 U
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
|
Note:
Objects with no check-out/check-in information are ignored.
The status line directly under the User field displays the sub-function you used to access this screen.
This particular screen is the result of selecting a list in alphabetical order by maintenance request ID. The same columns are displayed for all Select options.
The columns of the Change Control Log Selection List are described as follows:
| Column | Description | |
|---|---|---|
|
|
||
| C | Input field for sub-function codes to display a specific log. | |
| Nr | Screen number assigned to a particular list item. | |
| Object | Name of the object checked out of or back into PAC. | |
| Ver(sion) | Version number of the migrated object. | |
| Library | Name of the maintenance library. If set to ">Cancel<", a check-out was cancelled by a migration from maintenance to Retire. | |
| Out User | Identity of the user who checked the object out to maintenance. | |
| Date | Date the object was checked out of or back into PAC. | |
| Request ID | Name or number of the maintenance request for the object, if there is one. | |
| Ty(pe) | Maintenance request type of check-out The intention or result of the check-out: U indicates an intention to update the object. If a checked-in object displays type U, the object has been updated. A indicates an intention to access the object only. PAC determines whether changes were in fact made when the object is checked-in. | |
To display the log entries for a specific object, type the number of the object (from the "Nr" column) in the Mark Selection... field, or mark the object with D in the "C" column.
The Display Change Control Log screen appears.
To select a specific change control log, enter Code D on the Change Control Log Menu and selection criteria sufficient to uniquely identify the log, or select a log from a list.
14:34:53 ***** PREDICT APPLICATION CONTROL ***** 2000-07-01
User PACUSR - Display Change Control Log -
Request Id ... RQ3 (Update) Modified: 2000-07-01 by SAGXX
Application .. ORD-EXAM
Object ....... APGMH1
Status ....... MAINTENANCE
--- Check-Out/Check-In Information ---
Version Library DBnr Fnr Userid Date-Time Termid
------- -------- ---- --- -------- ----------------- --------
Check-Out .... 1 RQMNT 235 17 SAGNABAT 2000-06-23 10:58:11 NATDEMO
Check-In ..... 2 RQMNT 235 17 SAGNA 2000-06-23 11:40:52 10
Notes ........
Additional Options ... N
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Exit Opts Canc
|
If you specified a maintenance request ID on the migration event, that ID along with the type (Update or Access only) in parentheses is recorded along with the name of the object migrated, its application, and the name of the maintenance status.
The table of Check-Out/Check-In Information provides for each event:
| Version | the version of the specified object migrated out of/into PAC. |
| Library | the name of the maintenance library. |
| DBnr/Fnr | the location of the object before it was migrated. |
| Userid | the value of the *USER variable at the time the event was processed. |
| Date-Time | the date and time of the event, and |
| Termid | the value of the *INIT-ID variable at the time the event was processed - a terminal ID or batch. |
The Notes field displays additional information created during the processing of the event, or comments you may want to attach to the change control log.
The Additional Options (change the default N to Y or press PF4) available from this screen allow you to
display the date and time the object was added / modified, and by whom.
display the Events for Maintenance Request screen which lists the other migration events to which the current maintenance request ID is assigned.