Change Control Logs

#### Search Results

Search

# Change Control Logs

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:

- Checking Objects Out for Maintenance

- Checking Objects Back In to PAC

- Accessing the Change Control Log Sub-Functions

- Selecting a Log from a List

- Displaying a Change Control Log

## Checking Objects Out for Maintenance

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

- a change control log is created for each object.

Information recorded when the change control log is created can be displayed on the Display Change Control Logscreen.

## Checking Objects Back In to PAC

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

- optionally, the maintenance request ID.

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.

## Accessing the Change Control Log Sub-Functions

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

## Selecting a Log from a List

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.

## Displaying a Change Control Log

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.

### On this page

- Checking Objects Out for Maintenance
- Checking Objects Back In to PAC
- Accessing the Change Control Log Sub-Functions
- Selecting a Log from a List
- Displaying a Change Control Log