Checking Out from Baseline or Promotion Libraries
Follow these steps to check out one or more components from a baseline or promotion library into your change package.
-
On the Checkout Options menu, select Option 1 Baseline/Promo to display the Checkout panel (CMNCKOT1).
CMNCKOT1 Checkout Command ===>____________________________________________________________________ Package . . . . . . . TEST001852__ Component name . . .______________________________________________________________ + (Blank or pattern for list; * for all members) Library type . . . . . ____ (Blank for list) Source library . . . . 0___ (Baseline 0 to -n; Promotion +1 to +n) Checkout to . . . . . S___ (S-Staging library, P-Personal library) Personal library . . . ___________________________________________________________ + Library dsorg . . . . ____ (Personal lib: PDS, PDSE, SEQ, PAN, LIB, ZFS) Checkout mode . . . . 1__ (1-Online, 2-Batch) Data Encoding ___ (1-ASCII, 2-UTF-8) Enter "/" to select option / Confirm overlay / Lock component / Display component user options _ Build member list from scan results _ Case sensitive Records to select . 0__ . (0 = all) From column . 0__ . (0 = all) To column 0 (Max = 80) Data string . ______________________________________________________This table describes the fields on the Checkout panel.
Field Description Command Enter L to display the component.type Library List where component name (entered below) is found. Panel shows baseline and promotion libraries that contain the component. Note: For this option, you must enter a fully-qualified component name - no masking is permitted. Package This field displays the package ID associated with the component being checked out. The package must be in DEV status. Component name Enter the name of the component you want to check out. Other options: Pattern: Build and display a filtered list of components from the origin library by entering a component pattern (aaa*). You can select components from the filtered list for check out. Note: Do not type * by itself unless you want to check out all of the components in the library. Blank: Leave this field blank or enter a pattern to select from a list of components; Fill in SOURCE LIBRARY. To list all libraries where a particular component is found, enter the component name here, enter the LIBRARY TYPE, leave the SOURCE LIBRARY blank and enter 'L' on the command line. *: Enter '*' to check out all members of the SOURCE LIBRARY. Library type Enter the library type of the component to be checked out. Other options: Pattern: Display a filtered list of library types. Blank: Display a list of all library types so you can select the type you want. Language Note:** Language is no longer specified on this panel. It can be specified on the "STAGE: COMPILE AND LINK EDIT" panel. ChangeMan will 'assume' the language based on: 1 Designated procedure at force level 2 Component history 3 Designated procedure at force level 1 ? Enter ? to specify the language of the designated procedure. Source library Enter an integer to indicate the baseline version or promotion level that you want to check out from. Plus or minus signs are required. 0: Check out from the current or 0-level baseline library. -1 to -999: Check out from a prior version baseline library. The 999 integer following the minus sign represents a relative prior version (e.g. -1 means the version immediately prior to the current version). Librarian Archie and Stacked Reverse Delta baseline libraries can range as low as -255 and -999 respectively. +1 to 99: Level 1 refers to the lowest promotion level, up to +99 n as the closest to production. Promotion libraries can range as high as 99. Blank: You can leave this field blank if you type L in the Command field. Note: If you type L in the Command field, List libraries where 'Component Name' entered is found. For this option, you must enter a fully-qualified component name - no masking is permitted. You can select a library on this list to check out from regardless of the version or level originally specified in the Source Library** field. Checkout to Enter S or P to determine whether components are checked out to a staging library or a personal library or data set. When you check out to a personal library or data set, 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 data set. Personal library If 'P' is selected in the Checkout to field (above), you must enter the name of the target personal library. If a dataset name is entered and it does not exist, ChangeMan ZMF will allocate it based on the Library Type attributes. Note: Batch checkout is required for any personal library including PAN or LIB. Library dsorg Enter a data set organization for the library or data set named in the Personal Library field. PDS: Partitioned dataset SEQ: Sequential data set. PAN: Panvalet file. LIB: Librarian file. ZFS: z/OS File System Checkout mode Enter 1 or 2 to determine whether checkout is performed online or in a batch job. See Online and Batch Execution Modes. 1. Check out components online - The components to be checked out reside in a Baseline library whose Storage Means is defined as (D)elta deck or (C)ompressed PDS. 2. Check out components in a batch job - The PERSONAL LIBRARY NAME to which the component is to be checked out is in PANVALET or LIBRARIAN format, or does not yet exist. If the components being checked out is a unique library type, not defined as Like S, C, L, or P (See Admin - Library definitions) it must be checked out in batch. Data Encoding This option can be used to view components stored using a CCSID representing ASCII or UTF-8 characters. This option has no effect when using Browse. 1. Enables ASCII conversion for ISPF view. 2. Enables UTF-8 conversion for ISPF view. Confirm overlay Select to overlay component in target library before checkout is executed. Omit to bypass confirmation panels and perform checkout. Note:** If your application is configured to maintain baseline by site, a site selection list will be displayed from which a site must be selected prior to a checkout. Lock component Select to immediately lock components in your package after checkout. Omit to bypass component locking. Notes:** This only applies to the current package, it does not cross packages. See Locking and Unlocking Package Components Batch checkout will not update the member's ISPF statistics. Batch checkout will also bypass the OVERLAY PRIOR STAGED MODULE Admin rule. If a component is locked by another user you must go to the stage package driven list (1.6.2) to UNLOCK the component prior to checkout. UC Unlock Component to allow for Checkout/Stage. Display component user options Select to allow display of component user option panel(s) for non-source components during stage process. It has no effect during checkout. Setting the value here allows you to bypass the stage selection panel to set the value prior to edit or stage. This allows user data to be associated with a component for later use in exits or XML services. If the 'Enable component user variables' global option is not enabled this setting is ignored. Note:** Component user variables for source components are accessible during the build process. Build memberlist from scan results Select to scan the source library to limit the member list to members containing a specified data string. If not selected, all fields listed below (Case Sensitive, Records to Select, From Column, To Column, and Data String) are ignored. Member list scan does not support zFS files or data sets with RECFM=U. Case Sensitive Select if the data string entered should be used exactly as entered (with regard to upper and lower case characters). Omit if the scan is to be conducted without regard to case sensitivity. Records to Select Enter a numeric value used to determine when the scan is to be discontinued. When this value is '0', the scan displays a list of all members in the source library that meet the data string search criteria. From Column Specify upon which column, for each record, that the scan is to begin. When this value is '0', each record is scanned, beginning in column one. To Column Specify upon which column, for each record, that the scan is to end. When this value is '0', records are scanned to the 80th column. Data String Enter a data string to be scanned to build the member selection list. -
If you enter L on the Command line the Checkout (CMNCKOT1) panel, the component.type Library List (CMNCMLSL) panel is displayed. Select the library from which to check out the component.
CMNCMLSL ACPSR*.SRC Library List Row 1 to 3 of 3 Command ===>___________________________________________Scroll ===> CSR Lvl Dataset/pathname + Prom.name Site __ +010 CMNTP.S6.V810.PROM.S6P1UT.SRC S6P1UT SERT6 __ +020 CMNTP.S6.V810.PROM.S6P1IT.SRC S6P1IT SERT6 __ 0000 CMNTP.S6.V810.BASE.ACTP.SRC BASELINE ******************************* Bottom of data ******************************** -
On the Checkout panel, if you leave the Component Name field blank or use a pattern that selects multiple components, the Promotion Library Selection List (CMNCPLSL) is displayed. Enter S in the line command field to select from the list of promotion libraries you wish to use.
CMNCPLSL Promotion Library Selection List Row 1 to 2 of 2 Command ===>__________________________________________________ Scroll ===> CSR Library type: SRC Promotion level: +10 Dataset Name Site __ CMNTP.S6.V810.PROM.S6P1UT.SRC + S6P1UT SERT6 __ CMNTP.S6.V810.PROM.S6P1UT1.SRC + S6P1UT1 SERT6P1 ******************************* Bottom of data ********************************Valid primary commands are:CMNCCMSL Checkout from SRC/LVL(0) Row 1 to 7 of 7 Command ===>_______________________________________________ Scroll ===> PAGE Input library: CMNTP.S6.V810.BASE.ACTP.SRC Name Status vv.mm Created Last modified Size Init User __ ACPSRCCA 01.16 2002/05/07 2014/11/19 03:13 34 23 USER016 __ ACPSRCCC 01.05 2002/05/07 2014/11/19 03:10 29 23 USER016 s ACPSRCCE 01.03 2002/05/07 2014/11/19 03:10 29 23 USER016 __ ACPSRCD1 03.01 2002/05/07 2011/03/11 20:09 52 15 USER016 __ ACPSRC80 01.03 2002/05/07 2014/11/19 03:04 24 1 USER016 __ PLIPGM01 01.07 2007/04/16 2014/11/19 03:06 6 6 USER016 __ PLIPGM1 01.04 2011/05/27 2014/11/19 03:06 6 6 USER016 ******************************* Bottom of data ********************************Command Description Abbreviation CANCEL Cancel the checkout. C DCD Display component general descriptions. D LOCATE name Locate an entry. L LONG Display zFS components expanded. LON REFRESH Refresh the panel display. R SHORT Display an abbreviated component list. SH SORT name Sort the list by the column name entered in the command. SO Enter S in the line command for one or more components and press Enter to check the components out to your package.
Valid line commands are:
Command Description B Browse a component. H Display component history. S Select a component for checkout. V View a component. -
If a component you select for checkout is in another active change package, or concurrent checkout has been disallowed, a concurrent development warning message is displayed on the History component.type (CMNCMPSW) panel. The results of the line commands are displayed in the STATUS column.
CMNCMPSW History - ACPSRCCE.SRC 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
ACTP000065 DEV 04.00 2015/03/30 13:56 00030 CMNCOB2 USER016
ACTP000060 DEV 03.00 2015/03/16 14:56 00029 CMNCOB2 USER017
ACTP000038 DEV S6P1UT 03.05 2015/02/12 10:21 00030 CMNCOB2 USER016
ACTP000028 DIS 02.01 2015/01/20 22:55 00029 CMNCOB2 USER016
ACTP000027 DEV 03.00 2015/03/06 11:59 00029 CMNCOB2 USER017
******************************* Bottom of data ********************************
Make sure that you are coordinating your changes with the other developers who have checked out or staged the component into their packages.
If you decide to abandon the checkout for this component, type CANCEL in the Command line and press Enter. Otherwise, press PF3 or Enter to check out the component.
Checking Out From Promotion Sites
The Checkout panel gives you the option of checking out from a promotion library by specifying a promotion level number in the Source Library field. If the application has multiple promotion sites, the same promotion level number may point to different libraries in different sites, so multiple libraries may be displayed on the Promotion Library Selection List (CMNCPLSL) panel.
CMNCPLSL Promotion Library Selection List Row 1 to 2 of 2
Command ===>______________________________________________ Scroll ===> CSR
Library type: SRC Promotion level: +10
Dataset Name Site
CMNTP.S6.V810.PROM.S6P1UT.SRC + S6P1UT SERT6
CMNTP.S6.V810.PROM.S6P1UT1.SRC + S6P1UT1 SERT6P1
******************************* Bottom of data ********************************
Enter S in the line command to select the library from which to check out the component.
CMNCCMSL Checkout from SRC/LVL(+10) Row 1 to 5 of 5
Command ===> Scroll ===> CSR
Input library:
CMNTP.S6.V810.PROM.S6P1UT.SRC
Name Status vv.mm Created Last modified Size Init User
S ACPSRCCE 03.04 2002/05/07 2015/02/01 22:07 30 23 USER016
__ ACPSRCEE 01.01 2015/02/01 2015/02/01 22:08 30 30 USER016
__ ACPSRC1A 02.03 2014/12/18 2015/02/01 22:09 33 34 USER016
__ ACPSRC6A 03.02 2012/09/26 2015/02/01 19:45 44 27 USER016
__ ACPSRC92 03.01 2002/05/07 2 015/01/15 00:06 30 15 USER016
******************************* Bottom of data ********************************
Enter S in the line command to select the component for checkout.
Replying to the Save Previous Version Panel
If the component you want to check out is in a library type that is enabled for staging versions with the PROMPT parameter, ChangeMan ZMF displays the Save Previous Version (CMNCMP03) panel before executing the checkout, regardless of whether the component is actually in the package staging library.
dataset name . . . 'CMNTP.A00A2.#CE9B4B9.#81CAF70.OUTLIST'
|-----------------------------------------------------------|
Report | CMNCMP03 Save Previous Version |
| Command ===>_____________________________________________ |
| | rinting
| Package: ACTP000027 | nting
| Component: ACPSRC94 + |
Job st | Type: SRC |
//US | |
// | Enter "/" to select option |
// | / Save previous staging version |
// | _ Set Save Previous Version prompt off |
| |
| |
|-----------------------------------------------------------|
This table describes the fields on the Save Previous Version panel.
| Field | Description |
|---|---|
| Package | Displays the ID of the package you are checking out to. |
| Component | Displays the component name |
| Type | Displays component type. |
| Save previous staging version | Select to save previous component version that is in staging library. |
| NOTE If the component you are checking out is not already in the package staging library, your response in this field is ignored. | |
| Set Save Previous Version prompt off | Select field 'Set Save Previous Version prompt off' to skip the display of this panel for subsequent requests within the current function. |