Checking in a Package

Package check-in brings components from a package attached to a release into the starting subsystem area defined for that package. This step begins the integration of your package components with other release components that are in development in other change packages across the enterprise.

Package check-in accomplishes these objectives:

Allocates area libraries for all areas in the release for the library types that are contained in the package.
Populates starting release area libraries.
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 packages in other applications that have this application defined as a related application.
Starts the process of resolving multiple versions of the same component that are in development at the same time and that will be installed at the same time.

Note

The base ChangeMan ZMF product encourages you to manage concurrent development by displaying checkout 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 one set of libraries in the final system area.

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

The target release and area for package check-in are predetermined. You define the release and starting area when you attach a package to a release.
The check-in rule for the target area determines whether your package must be audited or approved before package check-in is allowed. The check-in rule can also restrict who can perform check-in to the target area.
You can check-in all package components, or you can check-in selected package components.
The library type of a package component must be defined to the application joined to the target release. Your ChangeMan ZMF administrator makes those definitions. If the library type is not defined in the joined application, check-in is skipped for those components.
If a package 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 an area library can only be overlaid by the person who checked in the component, and it can only be overlaid if it is checked in from the same package. 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.
You cannot check-in a component that is locked under another TSO ID. However, a release manager can check-in components locked by others.

Follow these steps to check-in a package to the starting subsystem area for a release.

Follow these steps to access the package that you want to check-in.
1. Type =7 on the Command or Option line of any panel in ChangeMan ZMF, then press Enter.
2. 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
     FIN6410 DEV 20160328 WR 9010        FINANCE     USER015 00001
     FIN6430 DEV 20160328 WR 9030        FINANCE     USER015 00003
******************************* Bottom of data *******************************
```
  The Release List panel shows releases that:
  - Satisfy the selection criteria you typed on the Release List Parameters panel.
  - Have change packages attached to them.
3. On the Release List panel, type line command PK on a release row to select the release that contains the package you want to check-in. Press Enter, and then release - Release Package List panel is displayed.
```
 CMNRMPLF        FIN6430 - Release Package List      Row 1 to 1 of 1
 Command ===>                                        Scroll ===> CSR

     Package     Sta Area    Install DT/TM Last Promotion    Aud Chkd In
     ACTP000032  DEV ACCTPAY 20160429 2359 SERT6 S6P1IT 20           N
 ******************************* Bottom of data *******************************
```
  The release - Release Package List panel shows all packages that are attached to the release that you selected.
  
  The fields on the release - Release Package List panel are described in step 2 of [Accessing Release Packages and Components).

On the release - Release Package List panel, type CI in the line command of the package that you want to check-in, and press Enter. The Release Check-in Options panel is displayed.

CMNCKI00                Release Checkin Options
Option ===>

    Package: ACTP000032     Release: FIN6430    Area: ACCTPAY

1 Package       Check-in components from package libraries
2 Package Parms Check-in component list package selection criteria

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

Enter "/" to select option
    Eligible components only
    Exclude Superseded
    Batch Check-in
    / Prompt for description

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

Field	Description
Package	Displays the package that you are checking-in from.
Release	Displays the release that you are checking-in to.
Area	Displays the starting subsystem area that you are copying package components into.
Options	Choose an option to display a list of components to select for check-in. 1 Package Display all package components on the Release Checkin package Components panel where you select components for check-in. 2 Package Parms Display the Component Release Package Check-in List Parameters panel where you specify package component filters, then display the filtered list on the Release Checkin package Components panel where you select components for check-in.
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 only	Omit to display all components in the package to be checked in. Select to display only components that are eligible for checkin, including overlays that may be overridden.
Exclude Superseded	This option is enabled only if Eligible Components is set to Yes. NO Display only components that are eligible for checkin, including overlays that may be overridden. YES Display only components that are eligible for checkin, including overlays that may be overridden, but exclude any overlay by a component with a newer last staged date, regardless of the hash token, SETSSI, user ID, or originating package.
Batch Check-in	Select this field to create batch JCL and submit a job to run in batch to free your terminal while check-in is processing.
Prompt for description	Select this field if you want to display the Checkin from package Descriptions (CMNCKI20) panel to enter a description for the components that you are checking into the area.

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

If you chose option 1 Package, the Release Checkin package Components panel is displayed. The panel lists all components in the package or all eligible components depending on your entry in the Eligible Components field.

If you chose option 2 Package Parms, the Component Release Package Checkin List Parameters panel is displayed, where you to specify package component selection criteria. After you have typed your selection criteria, press Enter to display the Release Checkin package Components panel. The panel lists only the selected package components.

CMNCKI02    RELEASE CHECKIN ACTP000038 Components       Row 000001 Of 000009
Command ===>                                            Scroll ===> CSR

  Component     Type Status Changed         Procname User    Area
_ ACPJCL10      JCL  ACTIVE 20160331 165939          USER239 ACCTPAY
_ ACPPRC10      PRC  ACTIVE 20160331 165956          USER239 ACCTPAY
_ ACPSRC1A      SRC  ACTIVE 20160331 170321 CMNCOB2  USER239 ACCTPAY
_ ACPSRC2A      SRC  ACTIVE 20101128 081311 CMNCOB2  USER239 ACCTPAY
_ ACPSRC30      LCT  ACTIVE 20101128 102049          USER239 ACCTPAY
_ ACPSRC30      LOS  ACTIVE 20101128 102143 CMNCOB2  USER239 ACCTPAY
_ ACPSRC99      SRC  ACTIVE 20101128 095418 CMNCOB2  USER239 ACCTPAY
_ ACPSRS1B      SRS  ACTIVE 20160331 170059 CMNCOB2  USER239 ACCTPAY
_ ACPSRS1C      SRS  ACTIVE 20160331 170134 CMNCOB2  USER239 ACCTPAY
******************************* Bottom of Data *******************************

This table describes the fields on the Release Checkin package 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 any selected components.
Line Command	Type S to select a component for check-in.
Component	Displays the component name.
Type	Displays the component library type.
Status	Displays the current component status.
Changed	Displays the date and time that the component was last changed.
Procname	Displays the stage procedure name for a Like-Source component.
User	Displays the userid of the person who last changed the package component.
Area	Displays the target check-in area.

Type S on the line command for components you want to check-in, or use the SETALL command to select all listed components.

Note

If you filter the list of package components with selection criteria on the Component Release Package Check-in List Parameters panel, then use the SETALL command on the Release Checkin package Components panel, you can check-in a large number of components without selecting each component individually from a long list.

When you are satisfied with your selections on the Release Checkin package 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.

CMNCKI03    RELEASE CHECKIN COMPONENTS Disallowed     Row 000001 Of 000003
Command ===>                                            Scroll ===> CSR

  Component Type Checked in to area    Orig. pkg  User    Shared Reason
_ ACPJCL10  JCL  2010-11-28-07.24.43   ACTP000039 USER239        OVERLAY
_ ACPPRC10  PRC  2010-11-28-07.24.43   ACTP000039 USER239        OVERLAY
_ ACPSRC2A  SRC  2010-11-28-07.24.43   ACTP000039 USER239        SRC CIM
******************************* Bottom of Data *******************************

This panel shows problems that ERO detected with components you selected for check-in.

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 any selected components.
Line Command	Type S to override a check-in disallowed condition and process the component for check-in.
Component	Displays the name of the disallowed component.
Type	Displays the library type of the disallowed component.
Checked in to area	Displays the date and time that the component now in the target area library was originally checked in.
Orig. pkg	Displays the name of the package that contains the component now in the target area library.
User	Displays the userid of the last person to change the component.
Area	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. Usually, the library type is not defined in this application in ERO.
	NO MBR The component has no corresponding member in the package staging library
	PKGLOCK The component is locked in the staging library by another user. AREALCK The area is checkin locked while area component locks are being applied for checkin by another user. Area checkin lock is removed when all area component locks are applied. Occasionally, the area locks are not released. This can occur when the area function process is interrupted prior to releasing the area lock. To unlock the area or reset the area in progress indicators, the administrator must issue the RS command on the area from ERO Release Administration. CKILOCK The component is checkin locked in the area until the checkin completes for another user. Occasionally, the checkin component locks are not released. This can occur when the checkin process is interrupted prior to releasing the area checkin component locks. To unlock the component(s), the administrator must issue the CL command on the area from ERO Release Administration or from the release area functions. The User can view the area component locks by issuing the CL command on the area. The User can also remove any area component locks that were set on their behalf. SRC CIM Recompile/relink component will overlay a source component. You must check out the source and stage the component.

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

You are checking in the component from the same package 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 packages and 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 package Components panel to change your component 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 you specified YES in the Descriptions field on the Release Check-in Options (CMNCKI00) panel, the Checkin from package Descriptions (CMNCKI20) panel is displayed:
```
CMNCKI20    Check-in from ACTP000038 - Descriptions     Row 1 to 7 of 15
Command ===>        Scroll ===> CSR

  Line Command: S-Select ( SETALL Select all, SETOFF De-select all )

    Default: Default description to apply to all components______________

  COMPONENT     DESCRIPTION
_ ACPCTC10 CTC  Override the default description for this component_________
_ ACPSRC30 LCT ____________________________________________________________
_ ACPSRC30 LOD ____________________________________________________________
_ ACPSRC30 LOS ____________________________________________________________
_ ACPSRC30 LST ____________________________________________________________
_ ACPSRC50 LCT ____________________________________________________________
_ ACPSRC50 LOD ____________________________________________________________
```
This panel displays all of the components that you have selected to check into the target area. You can enter up to 120 characters as a description for each component on this panel, as follows:
- The description you enter in the Default field applies to all components that you select by entering the letter S in the line command field that precedes the component name. Enter the SETALL command to select all components that are listed. (Enter the SETOFF command to deselect all selected components.) (The default description given in this example is "Default description to apply to all components."
- If you want to override the default description for one or more components, enter the desired description for the component in the Description field to the right of the component name. In this example, you override the default description for component ACPCTL10 and type the description "Override the default description for this component" instead. Note that the default description will apply to component ACPJCL10 in this example.
- Press PF3 to assign the description and exit the panel. (The description for each component, if any, is written to the CIM$DESC field of the Components In Motion table and to the RHS$DESC field of the History table.)
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, checkin is executed.

If all release area libraries have not been allocated previously for the component types you are checking in, for the package application you are checking in from, for all areas in the chain of areas from the starting area to the final area, then those area libraries are allocated here. The Release Checkin Libraries Allocated panel shows all area libraries for the library type/application, including the ones that are allocated here and libraries that were allocated previously.

CMNCKI05 Release CHECKIN LIBRARIES ALLOCATED Row 000001 Of 000018
Command ===> Scroll ===> CSR

Application: ACTP

Dataset name                        Type  Like-type         Status
CMNTP.FIN6430.ACCTPAY.ACTP.CTC      CTC   PDS               EXISTING
CMNTP.FIN6430.FINANCE.ACTP.CTC      CTC   PDS               EXISTING
CMNTP.FIN6430.GENLEDGR.ACTP.CTC     CTC   PDS               EXISTING
CMNTP.FIN6430.ACCTPAY.ACTP.LCT      LCT   LINK-EDIT CNTL    RC = 0000
CMNTP.FIN6430.FINANCE.ACTP.LCT      LCT   LINK-EDIT CNTL    RC = 0000
CMNTP.FIN6430.GENLEDGR.ACTP.LCT     LCT   LINK-EDIT CNTL    RC = 0000
CMNTP.FIN6430.ACCTPAY.ACTP.LOD      LOD   LOAD MODULE       EXISTING
CMNTP.FIN6430.FINANCE.ACTP.LOD      LOD   LOAD MODULE       EXISTING
CMNTP.FIN6430.GENLEDGR.ACTP.LOD     LOD   LOAD MODULE       EXISTING
CMNTP.FIN6430.ACCTPAY.ACTP.LOS      LOS   NCAL LOAD         EXISTING
CMNTP.FIN6430.FINANCE.ACTP.LOS      LOS   NCAL LOAD         EXISTING
CMNTP.FIN6430.GENLEDGR.ACTP.LOS     LOS   NCAL LOAD         EXISTING
CMNTP.FIN6430.ACCTPAY.ACTP.LST      LST   LISTING           EXISTING
CMNTP.FIN6430.FINANCE.ACTP.LST      LST   LISTING           EXISTING
CMNTP.FIN6430.GENLEDGR.ACTP.LST     LST   LISTING           EXISTING
CMNTP.FIN6430.ACCTPAY.ACTP.SRS      SRS   SOURCE            EXISTING
CMNTP.FIN6430.FINANCE.ACTP.SRS      SRS   SOURCE            EXISTING
CMNTP.FIN6430.GENLEDGR.ACTP.SRS     SRS   SOURCE            EXISTING
******************************* Bottom of Data *******************************

Press Enter to continue the check-in process.

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

CMNCKI07 KIN ACTP000038 to ACCTPAY LONG Summary     Checkin Complete
Command ===>                                        SCROLL ===> CSR

Release     Lib  Release   Area     CIM   History Release area check-in
Component   type area      copy    table   table   component  status
ACPSRC1A    LOD  ACCTPAY  RC=0000 RC=0000 RC=0000 CHECKIN WAS COMPLETED
ACPSRC1A    LST  ACCTPAY  RC=0000 RC=0000 RC=0000 CHECKIN WAS COMPLETED
ACPSRC1A    SRC  ACCTPAY  RC=0000 RC=0000 RC=0000 CHECKIN WAS COMPLETED
ACPSRC30    LCT  ACCTPAY  RC=0000 RC=0000 RC=0000 CHECKIN WAS COMPLETED
ACPSRC30    LOD  ACCTPAY  RC=0000 RC=0000 RC=0000 CHECKIN WAS COMPLETED
ACPSRC30    LOS  ACCTPAY  Recomp. RC=0000 RC=0000 CHECKIN WAS COMPLETED
ACPSRC30    LST  ACCTPAY  RC=0000 RC=0000 RC=0000 CHECKIN WAS COMPLETED
ACPSRC99    LOD  ACCTPAY  RC=0000 RC=0000 RC=0000 CHECKIN WAS COMPLETED
ACPSRC99    LST  ACCTPAY  RC=0000 RC=0000 RC=0000 CHECKIN WAS COMPLETED
ACPSRC99    SRC  ACCTPAY  Recomp. RC=0000 RC=0000 CHECKIN WAS COMPLETED
ACPSRS1B    LOS  ACCTPAY  RC=0000 RC=0000 RC=0000 CHECKIN WAS COMPLETED
ACPSRS1B    LST  ACCTPAY  RC=0000 RC=0000 RC=0000 CHECKIN WAS COMPLETED
ACPSRS1B    SRS  ACCTPAY  RC=0000 RC=0000 RC=0000 CHECKIN WAS COMPLETED
ACPSRS1C    LOS  ACCTPAY  RC=0000 RC=0000 RC=0000 CHECKIN WAS COMPLETED
ACPSRS1C    LST  ACCTPAY  RC=0000 RC=0000 RC=0000 CHECKIN WAS COMPLETED
ACPSRS1C    SRS  ACCTPAY  RC=0000 RC=0000 RC=0000 CHECKIN WAS COMPLETED
******************************* Bottom of Data *******************************

If you specified Short in the Report Format field on the Release Check-in Options panel, the Checkin package 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.

CMNCKI07 KIN ACTP000038 to ACCTPAY SHORT Summary        Checkin Complete
Command ===>                                            SCROLL ===> CSR

Release     Lib    Release   Area    CIM    History   Release area check-in
Component   type    area      copy    table   table      component status
FOR ALL COMPONENTS ACCTPAY  RC=0000 RC=0000 RC=0000   CHECKIN WAS COMPLETED
******************************* Bottom of Data *******************************

Note

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

This table describes the fields on the Checkin package Long Summary panel.

Field	Description
Release Component	Displays the name of package components that were requested for checkin.
Lib type	Displays the library type of the component.
Release area	Displays the name of the release area that is the target for checkin.
Area copy	Displays the return code from the copy from staging 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 check-in component status	Displays status of the component in the check-in process.

Press PF3 to return to the release - Release Package List panel, which now displays Y in the Checked In column for the package you checked in.

CMNRMPLF        FIN6430 - Release Package List          Row 1 to 1 of 1
Command ===>                                            Scroll ===> CSR

    Package     Sta  Area    Install DT/TM  Last Promotion      Aud Chkd In
    ACTP000032  DEV  ACCTPAY 20160429 2359  SERT6 S6P1IT    00          Y
    ACTP000038  DEV  ACCTPAY 20160429 2359  SERT6 S6P1IT    00          Y
******************************* Bottom of data *******************************

Package check-in is complete.