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.
-
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 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.
-
-
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 listReport 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 fileLock 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.