Checking Out Package Components from Release

After you attach a package to a release, you can check out components into your package from releases that have not been installed.

Checkout from release lets you start coding from a version of a component that is more recent than the version in baseline, and which already contains earlier changes from your project or another project.

If you check out a version of a component from a prior release, you may be able to avoid an out-of-sync audit error indicating regression in your release after the prior release is installed.

If you check out a component from an area in the current release, you will eventually encounter an overlay condition in package or area check-in unless the other version is retrieved.

Note

Your release manager can block an area from checkout by setting an indicator in the area definition. Ask your release manager what areas you are allowed to check out from.

Checkout from release offers you four choices:

Checkout from current Package Release and Area - Use this option when you want to start your coding using a version of a component that has been checked in to the starting area for your package.
Checkout from current Package Releases other Areas - Use this option when you want to start your coding using a version of a component that has been checked in to any area in the current release.
Checkout from Prior Release - Use this option if you want to start your coding using a version of a component that is in a release that is defined as a prior release.
Checkout latest components from consolidated list - Use this option when you want to start your coding from the latest version of a component checked in to your release or prior releases.

Execute these steps to checkout from release in ERO:

Follow these steps to access the package that you want to check out to.
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 out to. Press Enter, and the 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 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 Accessing Release Packages and Components.
On the release - Release Package List panel, type C3 in the line command of the package want to check out components to, and press Enter. The Release Management Checkout Options panel is displayed.
```
CMNRCKOP            Release Management Checkout Options
Option ===>

    Package: ACTP000032     Release: FIN6430    Area: ACCTPAY

1 Checkout from current package release and area
2 Checkout from current package release other areas
3 Checkout from a prior release
4 Checkout latest components from consolidated list
5 Confirm prior release version compatibility
```
This panel offers you four options for choosing the area to check out from and one option to resolve potential version regressions.
- If the component you want to work on has already been checked in to the starting area for your package, select option 1 and press Enter. The Release Check-out Options panel is displayed. Go to Step 5 in this procedure for a picture of this panel and a description of the panel fields, then go to Step 6 to continue the checkout process.
- If you want to check out from any area in the current release, choose option 2 and press Enter. The release Release Area Selections panel is displayed. Go to Step 4 in this procedure for a picture of this panel, then go to Step 5 to continue the checkout process.
- If you want to check out from an area in a prior release, choose option 3, press Enter. The next steps in the checkout process follow immediately.
- If you want to check out the latest version of a component checked in to your release or a prior releases, select option 4 and press Enter. The Release Checkout Options panel is displayed. Go to Step 5 in this procedure for a picture of this panel and a description of the panel fields, then go to Step 6 to continue the checkout process.
- If you want to find, display, and resolve a prior release version regression flagged by ERO audit as an ERROR417!, without repeating the checkout from prior release, see Repair ERR0417 Prior Release Version Regression for instructions on how to use option 5 on the Release Management Checkout Options panel.

If you selected option 3 on the Release Management Checkout Options panel, the release - Prior Release Selection List panel is displayed.

CMNRCKRL    FIN6430 Prior Release Selection List    Row 1 to 1 of 1
Command ===>                                        Scroll ===> CSR

    Release Install Last Area
    FIN6410 20151219 FINANCE
******************************* Bottom of data *******************************

This panel displays releases that have been defined as prior releases for the current release (the release that contains your change package).

On the release - Prior Release Selection List panel, type S in the line command for the prior release you want to check out from. Press Enter, and the release Release Area Selections panel is displayed for the prior release you selected.

CMNRCKAL        FIN6410 Release Area Selections     Row 1 to 3 of 3
Command ===>                                        Scroll ===> CSR

    Name     Type    Description
    ACCTPAY  SUBSYS  Starting Area for Accounts Payable components
    GENLEDGR SUBSYS  Starting Area for General Ledger components
    FINANCE  SYSTEM  Final area for Finance components
******************************* Bottom of data *******************************

This panel shows all areas that are available for checkout.

On the release Release Area Selections panel, type S in the line command for the release area you want to check out from. Press Enter, and the Release Check-out Options panel is displayed.

CMNCKO50                Release Checkout Options
Option ===>

    Package: ACTP000032 Release: FIN6410 Area: ACCTPAY

    1 From area to package libraries 2 List area selection criteria

Component name . . . . .                                                 +
Component type . . . . .     (required for checkout latest)
Report format . . . . . LONG (Short-errors only, Long-all components)
Check out to . . . . . .S    (S-Staging library, P-Personal library)
Personal library . . . .                                                 +
Library dsorg . . . . . PDS  (PDS, PDSE, SEQ, PAN, LIB, HFS)

Enter "/" to select option
    Lock component
    Batch checkout
    Confirm checkout
    Suppress batch messages
    Save Prior Version
  / Mixed Case

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

Field	Description
Package	Displays the package name you are checking out to.
Release	Displays the release that contains the area you are checking out from.
Area	Displays the area that you are checking out from.
Options	Choose an option to display a list of components to select for checkout. 1 Area Display all package components on the Release Checkout area Components panel where you select components for checkout. 2 AreaParms Display the Component Release Area Check-out List Parameters panel where you to specify area component filters, then display the filtered list on the Release Check-out area Components panel where you select components for checkout.
Component Name	Type one of the following to select area components by component name. Full component name is required to check out to a "personal library" that is a sequential dataset. Name Select area components that match a component name. Mask List area components with names that fit a mask. Blank List area components that satisfy all other selection criteria.
Component Type	Type one of the following to select area components by component (library) type. The default for this field is blank. Type Select area components that match a component type. Mask List area components with component types that fit a mask. Blank List area components that satisfy all other selection criteria. Note: Full library type is required to: - Check out to a personal library that is a sequential dataset - Check out latest components from consolidated list
Report Format	Type an online report format for the results of the checkout process. Short Only display components with checkout errors. (Abbreviation: S) Long Display all components requested for checkout. (Abbreviation: L)
Check Out To	Type S or P to determine whether components are checked out to a staging library or a personal library or dataset. When you check out to a personal library or dataset, the component is also copied to a package staging library. S Check out components to a ChangeMan ZMF staging library. P Check out component to a personal development library or dataset.
Personal Library	Type the dataset name for a personal library or dataset if you typed P in the Check Out To field.
Library DSORG	Type a dataset organization for the library or dataset named in the Personal Library field. PDS PDS library PDSE PDSE library SEQ Sequential dataset PAN CA Panvalet file LIB CA Librarian file
Lock Component	Select this field to immediately lock the components that you successfully check out into your package. See “Locking and Unlocking Package Components” in the *ChangeMan ZMF User Guide.
Batch Checkout	Select this field to create batch JCL and submit a job to run in batch to free your terminal while checkout is processing.
Confirm Checkout	Select this field to enable the concurrent development warning panel (CMNCMPSW), which lists other active packages that contain a component that you select for checkout.
Suppress Messages	If you selected the Batch Checkout field, select Suppress Messages to suppress the SEND message normally broadcast when a batch checkout job completes to tell you whether the checkout was successful. (Job submitted messages are also suppressed.)
Save Prior Version	If staging versions is enabled with PROMPT for a library type in this application, Select this field to save staged components that will be overlaid by checkout.
Mixed Case	Type a value to determine the processing of lower case input in the Component Name field. Omit this field to fold Component Name input to upper case regardless of the case that you type. Select this field to process Component Name input exactly as you type it, upper and lower case.

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

If you chose option 1 Area, the Release Check-out area Components panel is displayed. The panel lists all components belonging to your package application that satisfy Component Name and Component Type criteria entered on the Release Check-out Options panel and are checked in to the selected area.

If you chose option 2 Area Parms, the Component Release Area Check-out List Parameters panel is displayed, where you to specify additional component selection criteria.

CMNCKO51        Component Release Area Checkout List Parameters
Command ===>

    Release: FIN6410        Area: ACCTPAY
    Package: ACTP000032     Status: DEV     Install date: 20160429

Release area selection criteria:
Language . . . . . . . . .

Changed date: from . . . . (yyyymmdd)
              to . . . . . (yyyymmdd)

Compile procedure . . . .
User . . . . . . . . . . .

When you press Enter, the Release Check-out area Components panel is displayed. The panel lists components belonging to your package application that are checked in to the selected area and that pass your selection criteria.

CMNCKO52    RELEASE CHECKOUT ACCTPAY Components     Row 000001 Of 000011
Command ===>                                            Scroll ===> CSR

    Component   Lib Like Checked in to area  Package    Release Area
    _ ACPCTC10  CTC  P   2010-11-27-16.23.40 ACTP000037 FIN6420 ACCTPAY
    _ ACPJCL10  JCL  J   2010-11-27-16.23.40 ACTP000037 FIN6420 ACCTPAY
    _ ACPSRC1A  LOD  L   2010-11-27-16.23.40 ACTP000037 FIN6420 ACCTPAY
    _ ACPSRC1A  LST  X   2010-11-27-16.23.40 ACTP000037 FIN6420 ACCTPAY
    _ ACPSRC1A  SRC  S   2010-11-27-16.23.40 ACTP000037 FIN6420 ACCTPAY
    _ ACPSRS1B  LOS  N   2010-11-27-16.23.40 ACTP000037 FIN6420 ACCTPAY
    _ ACPSRS1B  LST  X   2010-11-27-16.23.40 ACTP000037 FIN6420 ACCTPAY
    _ ACPSRS1B  SRS  S   2010-11-27-16.23.40 ACTP000037 FIN6420 ACCTPAY
    _ ACPSRS1C  LOS  N   2010-11-27-16.23.40 ACTP000037 FIN6420 ACCTPAY
    _ ACPSRS1C  LST  X   2010-11-27-16.23.40 ACTP000037 FIN6420 ACCTPAY
    _ ACPSRS1C  SRS  S   2010-11-27-16.23.40 ACTP000037 FIN6420 ACCTPAY
******************************* Bottom of Data *******************************

This table describes the fields on the Release Checkout 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 any selected components.
Line Command	Type S to select a component for checkout.
Component	Displays the component name.
Lib	Displays the component library type.
Like	Displays the ERO like-type for the component.
Component checked in to area	Displays the date and time that the component was checked in to the area.
Package	Displays the name of the package where the component originated.
Release	Displays the release.
Area	Displays the area you are checking out from.

Type S on the line command for components you want to check out to your package, 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 Area Check-out List Parameters panel, then use the SETALL command on the Release Checkin area Components panel, you can check out a large number of components without selecting each component individually from a long list.

When you are satisfied with your selections on the Release Checkout area Components panel, press Enter to process your selections.

After you select components for checkout, if the Confirm Checkout field is set to Y on the RELEASE CHECK-OUT OPTIONS panel (CMNCKO50), and if a component you selected for checkout is in another active package, the concurrent development warning panel (CMNCMPSW) is displayed.

CMNCMPSW        History - ACPJCL10.JCL          Row 1 to 5 of 5
Command ===>                                    Scroll ===> CSR

This component is included in the following packages:

Package    Sta Promoted vv.mm Last action      Size Procname User   Release
ACTP000041 DEV          02.00 2011/09/07 14:14 00669         USER42 R041127
ACTP000031 DEV          01.02 2010/12/29 13:57 00669         USERLE R041030
ACTP000029 DEV          02.01 2008/08/19 07:53 00670         USER42
ACTP000019 DEV          02.00 2008/01/26 14:38 00663         USER42
ACTP000016 DEV LOCAL1   01.01 2008/06/17 11:39 00663         USER42 R041030
******************************* Bottom of data *******************************

If you decide to abandon checkout for a component, type CANCEL in the Command line and press Enter. If you want to check out the component, press PF3 or Enter.

If there are problems with checkout for any selected component, the Release Checkout Components Disallowed panel is displayed.

CMNCKO53    Release CHECKOUT Components Disallowed      Row 000001 Of 000002
Command ===>                                            Scroll ===> CSR
    Component   Lib Checked out to pkge Package    User   Shared Reason
    ACPCTC10    CTC 2010-11-27-16.09.36 ACTP000131 USER239       DUPLIC
    _ ACPJCL10  JCL 2010-11-27-16.18.43 ACTP000131 USER239       OVRLAY
******************************* Bottom of Data ********************************

This table describes the fields on the Release Checkout 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 checkout disallowed condition and process the component for checkout.
Component	Displays the name of the disallowed component.
Lib	Displays the library type of the disallowed component.
Component checked out to pkge	Displays the date and time that the component was checked out to the target package.
Package	Displays the name of the package that the target for checkout.
User	Displays the userid of the last person to change the component.
Reason	Displays the reason that the compnent was disallowed form checkout. ARELCK The component is locked in area being checked out from by another user BATCH The component can only be checked out in batch. CKILCK The component is locked in area being checked out from by another user for checkin processing. CONCHK The component is already checked out to another planned package and application administration does not allow concurrent checkout. CONFLC The component is already in the package under another person's TSO ID. DUPLIC The component is already in the package in CHECKOUT status. HSTCHK The component is checked out to another active package, and you decided on the concurrent development warning panel (CMNCMPSW) to abandon checkout for this component. LOCKED The component is locked by another user. NO BUN The Baseline Unique Number for the component library type is missing. NO MBR The member does not exist in the area library. NOAUTH You have no authority to check out the component. OVRLAY The component is already in the package under your TSO ID.

You can override components disallowed from checkout if the reason is OVRLAY or CONFLC.

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

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

If ERO finds no conditions to disallow components, or if you decide to continue the checkout process from the Release Checkout Components Disallowed panel, checkout is executed.

If you specified Long in the Report Format field on the Release Check-out

Options panel, the Release Checkout Long Summary panel is displayed. This panel shows the status of the checkout process for every component selected for checkout and not disallowed.

CMNCKO57    Release CHECKOUT LONG Summary       Checkout Complete
Command ===>                                    Scroll ===> CSR

Component   Lib Release Area    RC Checkout component status
ACPSRC1A    SRC FIN6420 ACCTPAY 00 CHECKOUT WAS COMPLETED
ACPSRS1B    SRS FIN6420 ACCTPAY 00 CHECKOUT WAS COMPLETED
ACPSRS1C    SRS FIN6420 ACCTPAY 00 CHECKOUT WAS COMPLETED
******************************* Bottom of Data *******************************

If you specified Short in the Report Format field on the Release Check-out Options panel, the Release Checkout Short Summary panel is displayed. This panel lists components where there was a problem in the checkout process. If there were no problems, the panel shows one row with name FOR ALL COMPONENTS representing all components requested for checkout and not disallowed.

CMNCKO57    Release CHECKOUT SHORT Summary      Checkout Complete
Command ===>                                    Scroll ===> CSR

Component   Lib Release Area       RC Checkout component status
FOR ALL COMPONENTS FIN6420 ACCTPAY 00 CHECKOUT WAS COMPLETED
******************************* Bottom of Data *******************************

Note

Check out like-source or like-linkcontrol components, but do not check out related components in target library types. Source-to-load relationships are not preserved in checkout from release area processing.

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

Field	Description
Component	Displays the name of components that were requested for checkout.
Lib	Displays the library type of the component.
Release	Displays the name of the release area that the checkout was requested from.
Area	Displays the return code from the copy from release area library to staging library.
RC	Displays the return code from the Package Master file update.
Checkout component status	Displays status of the component in the checkout process.

Press Enter to leave the Release Checkout Long/Short Summary panel and return to the Release Check-out Options panel.

Press PF3 twice to return to the release - Release Package List panel.

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 *******************************

Checkout from release is complete.