Checking in an Area

Area check-in copies components from the libraries for one area into the libraries for another area. Check-in advances release components through the hierarchy of areas that progressively integrate release components and pass them through environments for higher order testing.

Area check-in accomplishes these objectives:

Populates the area application libraries for the next area defined for the release.
Makes the components available to build processes in other packages in the same application that are attached to the release.
Makes the components available to build processes in other packages in the same application that define this release as a prior release.
Makes the components available to build processes in packages in other applications if this application is defined as a related application.
Continues the process of squeezing out multiple versions of the same component that are in development at the same time and are intended for install at the same time.

Note

The base ChangeMan ZMF product Checkout encourages you to manage different versions of the same component that are in development at the same time by displaying check-out conflict messages and concurrent development messages. In contrast, ERO guarantees that a release will contain only one version of a component in an application by funneling all components through release area libraries that eventually converge in a set of libraries for the final system area.

Check-in area to area is subject to these rules and conditions.

The target area for area check-in is predetermined. When you define an area in a release, you specify the next area.
The check-in rule for the area to be checked in determines whether the area must be audited or blocked before check-in to the next area is allowed.
The check-in rule for the target area can restrict who can perform check-in to the target area.
A single check-in operation copies components from a set of release area application libraries into the corresponding set of area application libraries in the next area. If there are several applications joined to a release, you perform multiple check-in operations to copy all area components to the next area.
You can check-in all components from a selected application, or you can check-in selected components from a selected application.
If a component already exists in the target area library, you must explicitly override a “check-in components disallowed” condition to overlay the component.
A component in a target area library can only be overlaid by the person who last checked in the component to the target area. This rule can be overridden in the definition of the target area.
If a component that already exists in an area library cannot be overlaid, it must be retrieved before it can be checked in again.

Follow these steps to check-in a release area to the next area.

Follow these steps to access the area that you want to check-in.

Type =7 on the Command or Option line of any panel in ChangeMan ZMF, then press Enter.

Type release selection criteria in fields on the Release List Specifications Parameters panel, or leave the fields blank, and press Enter.

The Release List panel is displayed.

CMNRMRLF        Release List            Row 1 to 2 of 2
Command ===>                            Scroll ===> CSR

    Release Sta Install  Work request   Dept Aud    Creator Pkgs
    FIN6420 DEV 20160119 WR 9020        FINANCE     USER015 00003
    FIN6430 DEV 20160220 WR 9030        FINANCE     USER015 00002
******************************* Bottom of data *******************************

The Release List panel shows releases that satisfy the selection criteria you typed on the Release List Parameters panel.

On the Release List panel, type line command AR on a release row to select the release that contains the area you want to check-in. The release Release Area List panel is displayed.

CMNRMALF        FIN6420 Release Area List       Row 1 to 3 of 3
Command ===>                                    Scroll ===> CSR

        Area            Status              Area    Prior   Next
    Name     Type Aud BLK CIA COA CIR COR   step    area    area
    ACCTPAY  SUBSYS    Y   Y   Y   N   N    0001            FINANCE
    GENLEDGR SUBSYS    N   Y   N   N   N    0002            FINANCE
    FINANCE  SYSTEM    N   Y   N   N   N    0003    GENLEDGR
******************************* Bottom of data *******************************

The release Release Area List panel shows all areas that are defined in the release that you selected.

The fields on release Release Area List panel are described in Notifying Area Check-in Approvers.

On the release Release Area List panel, type CI in the line command of the area that you want to check-in to the next area. Press Enter and the release - Joined Application List panel is displayed.

CMNRMAFL    FIN6420 - Joined Application List       Row 1 to 5 of 5
Command ===>                                        Scroll ===> CSR

    Appl    Join date   Application description
    ACTP    20160111    ACTP Accounts Payable (Base ZMF)
    ACTR    20160111    ACTR Accounts Receivable
    COMM    20160111    COMM Common Components (Base ZMF)
    GENL    20160111    GENL General Ledger (Db2 Option)
    JHFS    20160111    JHFS hfs only application
******************************* Bottom of data *******************************

This panel shows the applications joined to the release that you selected. Use this panel to select applications to copy to the next area. Depending on ERO global parameter settings, an application can be manifested as a set of release area libraries populated by components originally checked in from change packages in a single application.

On the release - Joined Application List panel, type S in the line command for one or more application rows that you want to check-in. You can also type SETALL and SETOFF in the Command line to select or deselect all applications. Press Enter, and the Release Area to Area Check-in Options panel is displayed.

CMNCKI50                Area to Area Check-in Options
Option ===>

    Release: FIN6420 Area: ACCTPAY Application: ACTP

1 Area          Check-in components from area libraries
2 Area Parms    Check-in component list area selection criteria

Report Format . . . . . SHORT (Long/Short-errors only)

Enter "/" to select option
    Eligible Components only
    Exclude Superseded
    Batch Check-in

This table describes fields and options on the Release Area to Area Check-in Options panel.

Field	Description
Release	Displays the release that contains the area you are checking-in.
Area	Displays the area that you are checking-in to the next area.
Application	Displays the application that you selected to copy to the next release area application libraries.
Report Format	Type an online report format for the results of the check-in process. Short Only display components with check-in errors. (Abbreviation: S) Long Display all components requested for check-in. (Abbreviation: L)
Eligible Components	Select this to display only application components that are eligible for checkin, including overlays that may be overridden. If not selected, then this will display all application components in the area to be checked in.
Exclude Superseded	This option is enabled only if Eligible Components is selected. Select this to display only application components that are eligible for checkin, including overlays that may be overridden, but excluding any component that will overlay a component in the area with a newer last staged date, regardless of the hash token, SETSSI, user ID, or originating package. If not selected, then display only application components that are eligible for checkin, including overlays that may be overridden.
Batch Check-in	Type an option to determine whether check-in runs online with your terminal locked, or in a batch job. Select this to create batch JCL and submit a job to free your terminal while check-in is processing. If not selected, then process check-on online with your terminal locked.
Options	Choose an option to display a list of components to select for check-in. 1 Area Display all area components on the Release Checkin area Components panel where you select components for check-in. 2 Area Parm Display the Component Release Area Check-in List Parameters panel where you to specify area component filters, then display the filtered list on the Release Checkin area Components panel where you select components for check-in.

Choose one of the options on the Release Area to Area Check-in Options panel and press Enter.

If you chose option 1 Area, the Release Checkin area Components panel is displayed. The panel lists all components in the release application area libraries.
If you chose option 2 Area Parms, the Component Release Area Check-in List Parameters panel is displayed, where you to specify component filters, When you press Enter, the Release Checkin area Components panel is displayed. This panel shows only the release area application components that passed the filters.

CMNCKI52    RELEASE CHECKIN ACCTPAY Components      Row 000001 Of 000026
Command ===>                                            Scroll ===> CSR

    Component   Type Like   Checked in to area  Orig. pkg   User    Area
    _ ACPCTC10  CTC   P     2010-12-02-13.48.12 ACTP000039  USER239 ACCTPAY
    _ ACPJCL20  JCL   J     2010-12-02-13.48.12 ACTP000039  USER239 ACCTPAY
    _ ACPPRC10  PRC   R     2010-12-09-11.49.30 ACTP000039  USER239 ACCTPAY
    _ ACPPRC20  PRC   R     2010-12-02-13.48.12 ACTP000039  USER239 ACCTPAY
    _ ACPSRC1A  LOD   L     2010-12-02-13.48.34 ACTP000038  USER239 ACCTPAY
    _ ACPSRC1A  LST   X     2010-12-02-13.48.34 ACTP000038  USER239 ACCTPAY
    _ ACPSRC1A  SRC   S     2010-12-02-13.48.34 ACTP000038  USER239 ACCTPAY
    _ ACPSRC2A  LOD   L     2010-12-02-13.48.12 ACTP000039  USER239 ACCTPAY
    _ ACPSRC2A  LST   X     2010-12-02-13.48.12 ACTP000039  USER239 ACCTPAY
    _ ACPSRC2A  SRC   S     2010-12-02-13.48.12 ACTP000039  USER239 ACCTPAY
    _ ACPSRC30  LCT   K     2010-12-02-13.48.34 ACTP000038  USER239 ACCTPAY
    _ ACPSRC30  LOD   L     2010-12-02-13.48.34 ACTP000038  USER239 ACCTPAY
    _ ACPSRC30  LOS   N     2010-12-02-13.48.34 ACTP000038  USER239 ACCTPAY
    _ ACPSRC30  LST   X     2010-12-02-13.48.34 ACTP000038  USER239 ACCTPAY
    _ ACPSRC50  LOD   L     2010-12-02-13.48.34 ACTP000038  USER239 ACCTPAY
    _ ACPSRC50  LOS   N     2010-12-02-13.48.34 ACTP000038  USER239 ACCTPAY

The Release Checkin area Components panel shows a list of components for you to select for check-in.

This table described the fields on the Release Checkin area Components panel.

Field	Description
Command	Type a command, or leave Command blank to type a Line Command on a component. CANCEL Cancel panel without update. (Abbreviation: C) LOCATE component Locate a component. (Abbreviation: L) SETALL Sets all line commands to S to select all listed components. SETOFF Sets all line commands to blank to deselect all selected components.
Line Command	Type S to select a component for check-in.
Component	Displays the component name.
Type	Displays the component library type.
Like	Displays the library Like-type for the component.
Checked in to area	Displays the date and time that the component was checked in to the area.
Orig. pkg	Displays the name of the change package that contains the component now in the area library.
User	Displays the userid of the last person to change the component in the change package.
Area	Displays the name of the current area (the area to be copied from).

Note

You can check-in a large number of components without selecting each component individually. Filter the list of application area components with selection criteria on the Component Release Area Check-in List Parameters panel, then use the SETALL command on the Release Checkin area Components panel select all of the listed components.

When you are satisfied with your selections on the Release Checkin area Components panel, press Enter to process your selections. If there are problems with check-in for any selected component, the Release Checkin Components Disallowed panel is displayed.

CMNCKI53    RELEASE CHECKIN Components Disallowed       Row 000001 Of 000001
Command ===>                                                Scroll ===> CSR

    Component   Type Checked in to area     Orig. pkg   User Shared Reason
    _ ACPPRC10  PRC  2010-12-09-12.25.53    GENL000005  USER239     OVERLAY
******************************* Bottom of Data ********************************

This table describes the fields on the Release Checkin Components Disallowed panel.

Field	Description
Command	Type a command, or leave Command blank to type a Line Command on a component. CANCEL Cancel panel without update. (Abbreviation: C) LOCATE component Locate a component. (Abbreviation: L) SETALL Sets all line commands to S to select all listed components. SETOFF Sets all line commands to blank to deselect all selected components.
Line Command	Type S to override a check-in disallowed condition and process the component for check-in.
SELECTED COMPONENT NAME	Displays the name of the disallowed component.
LIB TYPE	Displays the component library type.
DATE/TIME COMPONENT CHECKED IN TO AREA	Displays the date and time that the component now in the target area library was originally checked in.
ORIGINATING PACKAGE	Displays the name of the package that contained the component now in the target area library.
USER ID	Displays the userid of the last person to change the component.
BASELINE SHARED	Displays Yes if the baseline library for the disallowed component is shared with other library types.
REASON	Displays the reason that the component was disallowed from check-in. OVERLAY The component has already been checked in into the area. NO AUTH You have no authority to check in the component. NO BUN The Baseline Unique Number for the component library type is missing. NO MBR The component has no corresponding member in the area library AREALCK The component is locked in the area by another user CKILOCK The component is locked in the area by an uncompleted checkin process.

You can override components disallowed from checkin if the reason is OVERLAY and one of these is true:

You are checking in the component with the same TSO ID that checked in the component previously.
Your release manager set an indicator in the release area definition that allows check-in overlay by components from different TSO IDs.

From the Release Checkin Components Disallowed panel, possible courses of action include.

Type CANCEL on the Command line to abandon the check-in process and return to the Release Check-In Options panel.
Press PF3 to return to the Release Checkin area Components panel to change your selections for check-in.
Press Enter to continue with check-in without processing the components displayed on the Release Checkin Components Disallowed panel.
Type S in the line command for one or more components to attempt an override of the overlay condition. You can use SETALL and Enter to select all disallowed components. Press Enter to continue processing components for check-in, including the components you selected for override.

If ERO finds no conditions to disallow components, or if you decide to continue the check-in process from the Release Checkin Components Disallowed panel and press Enter, check-in is executed.

If you specified Long in the Report Format field on the Release Area to Area Check-in Options panel, the Checkin area to area Long Summary panel is displayed. This panel shows the status of the check-in process for every component selected for check-in.

CMNCKI57    KIN ACCTPAY to FINANCE Long Summary         Checkin Complete
Command ===>                                            Scroll ===> CSR
                           Area     CIM   History  Checkin
Component   Type    Area   Copy    table   table   component status
ACPCTC10    CTC FINANCE   RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPJCL20    JCL FINANCE   RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPPRC20    PRC FINANCE   RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPSRC1A    LOD FINANCE   RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPSRC1A    LST FINANCE   RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPSRC1A    SRC FINANCE   RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPSRC2A    LOD FINANCE   RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPSRC2A    LST FINANCE   RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPSRC2A    SRC FINANCE   RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPSRC30    LCT FINANCE   RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPSRC30    LOD FINANCE   RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPSRC30    LOS FINANCE   Recomp. RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPSRC30    LST FINANCE   RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPSRC50    LOD FINANCE   RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPSRC50    LOS FINANCE   Recomp. RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPSRC50    LST FINANCE   RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPSRC99    LOD FINANCE   RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPSRC99    LST FINANCE   RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
ACPSRC99    SRC FINANCE   Recomp. RC=0000 RC=0000  CHECKIN WAS COMPLETED

If you specified Short in the Report Format field on the Release Area to Area Check-in Options panel, the Checkin area to area Short Summary panel is displayed. This panel lists components where there was a problem in the check-in process. If there were no problems, the panel shows a summary line FOR ALL COMPONENTS.

CMNCKI57    KIN ACCTPAY to FINANCE Short Summary        Checkin Complete
Command ===>                                            Scroll ===> CSR
                            Area     CIM   History  Checkin
Component   Type    Area    Copy    table   table   component status
FOR ALL COMPONENTS FINANCE RC=0000 RC=0000 RC=0000  CHECKIN WAS COMPLETED
******************************* Bottom of Data ********************************

Note

If you select like-source components for check-in, area components with a source-to-load relationship to the selected components are also checked-in.

This table describes the fields on the Checkin area to area Long Summary panel.

Field	Description
RELEASE COMPONENT NAME	Displays the name of area component requested for check-in.
LIB TYPE	Displays the library type of the component.
RELEASE AREA	Displays the name of the release area that is the target for check-in.
AREA COPY	Displays the return code from the copy from area library to release area library.
CIM TABLE	Displays the return code from the component-in-motion table update.
HISTORY TABLE	Displays the return code from the history table update.
RELEASE AREA CHECKIN COMPONENT STATUS	Displays the status of the component in the check-in process.

Press Enter to return to the Release Area to Area Check-in Options panel and then press PF3. If there are more applications to check in, the Application field on the Release Area To Area Check-In Options panel displays the next selected application. Execute the release area checkin process for the next application, starting at #4 above.
When there are no more applications to check in and you press PF3 on the Release Area To Area Check-In Options panel, you are returned to the release Release Area List panel.

Area check-in is complete.