Staging from Package
Use Option 2 Package on the Stage Options menu to stage and manage components that are already in your change package.
A typical use of the stage from package function is to edit a program in your package and then compile and link-edit the updated source:
-
On the Stage Options menu, choose Option 2 and press Enter. The Stage: package Components (CMNSTG01) panel is displayed.
CMNSTG01 STAGE: ACTP000027 Components Row 1 to 5 of 5 Command ===>______________________________________ Scroll ===> CSR Name + Type Status Changed Procname User Request __ACPSRCCA SRC CHECKOUT 20150306 115925 CMNCOB2 USER016 __ACPSRCCC SRC CHECKOUT 20150306 115928 CMNCOB2 USER016 LOCKED __ACPSRCCE SRC CHECKOUT 20150306 115940 CMNCOB2 USER016 LOCKED __ACPSRCD1 SRC CHECKOUT 20150306 115943 CMNCOB2 USER016 LOCKED __ACPSRC94 SRC ACTIVE 20150115 164426 CMNCOB2 USER016 ******************************* Bottom of data ********************************This table describes the fields on the Stage: package Components panel:
Field Description COMMAND Enter one of the following commands, or leave the command line blank and type a line command next to a component name. DCD: Display the first line of the component general description on an additional line. EDIT member.typ: Edit and stage a component in the package. If the component is not in the package, an empty edit session is provided, which is saved under the component name and library type specified in the EDIT command. Abbreviation: E REFRESH: Display updated information on this panel. Abbreviation: R SORT heading: Sort listed components under one of two field names or specified column headings. The sort direction can be specified by following the field name with A for ascending or D for descending. If not specified, the default sort direction for the field will be used. SORT DEFAULT restores the default sort, which is by NAME. LOCATE member: Locate a listed component by information in the last sorted column or by Name if the components were not sorted. Abbreviation: L LONG: Display additional component information on a second line. XLONG: Display long component name on the first line, and display additional component information on a third line. SHORT: Suppress the additional component information displayed with the LONG command and the long name displayed with the XLONG command. CANCEL: Cancel the function and return to the previous panel. Abbreviation: C Line Command Enter a line command to the left of the Name row: B: Browse component from personal or staging library. BA: Browse component activity file. (Set up by Administrator). BD: Browse component general description. (Set up by Administrator). BL: Browse the component listing. CB: Compare package component with its baseline version D: Delete component from staging library. E: Edit and stage component from personal or staging library. E: A Edit and stage component activity file. ED: Edit component general description. H: Display component history. LC: Lock component to disallow a checkout/stage by another user. See Locking and Unlocking Package Components R: Restage component from staging library. This is not the same as the Recompile function. SB: Stage component in batch - Free the terminal and submit a batch job to perform ISPF file tailoring to build JCL for the stage job; then submit the stage job. See Batch Stage Job Card SL: Display source-to-load relationship (source components only). ST: Stage one or multiple components in a single batch job submission. (Abbreviated S is also acceptable) UC: Unlock component (if locked) to allow for checkout/ stage. See Locking and Unlocking Package Components UL: Display Component UserID Work List (if enabled by administrator). UV: Update component user variables V: View component from personal or staging library. VC: Display Version Control panel (if enabled by administrator). See Staging Version Installed VL: View the component listing. To display the Valid Staging Selection Codes panel, which shows valid line commands and allows you to enter the command from that panel, type an invalid command or type nonsense characters such as / or ? or 99 in the line command for a component. Name Displays the name of the component. Type Displays the library type under which the component is checked out or staged in this package. Status Displays the status of the component in the package: ACTIVE: Component has been successfully staged CHECKOUT: Component has been checked out from baseline but not yet staged FROZEN: Component is frozen and may not be updated INACTIVE: Component name has been copied forward from another package, but the component has not been checked out to the staging library INCOMP: Compile job has not completed or has failed UNFROZEN: Previously frozen component is available for update Changed Displays the date and time that the component was last modified (and or staged). Language The language under which the source (SRC) or 'like-SRC' component was staged or checked out. Procname Displays one of the following for SRC or like-source components: The name of the last ISPF skeleton used to build JCL to stage the component. *RECOMP* if the component was recompiled. Displays *RELINK* for LOD or like-load components that were last built with relink. User Displays the User ID of the person who performed the last action on the component or the jobname if Batch Stage was used. Request Displays the last action performed on the component since the Stage: Package Components panel was first displayed. The following information is displayed on a second line for each listed package component if LONG or XLONG is entered on the Command Line: Org Displays the data set organization of the data set from which the member was staged. Valid options include: PDS: Partitioned dataset or PDSE SEQ: Sequential dataset PAN: PANVALET library LIB: LIBRARIAN Master ZFS: z/OS File System OTH: OTHER proprietary structures. Input dataset name Displays the data set from which the component was staged. If the component was relinked, the LCT library name is displayed. Target lib Displays target load library type for SRC and like-source components. If DCD is entered on the command line, the first line of the component general description is displayed on an additional line. -
On the Stage: package Components panel, choose an action you want to perform against a listed component, enter the appropriate code in the line command for the component, and press Enter.
For this example, enter E in the line command for an SRC component and press Enter.
If this dataset has been migrated, the following message is displayed that allows you to cancel the edit.
CMNSTG01 STAGE: FLOO002605 Components Row 1 to 9 of 12 Command ===> ______________________________________________ Scroll ===> CSR__ Name + Type Status Changed Procname User Request _E ASMS _______________________Dataset Migrated____________________ | | LOD __ ASMS| Command ===> _________________________________________ | LOD __ ASMS| | LOD __ ASMS| Dataset: CMNDEV.CMNL.FLOO.#002605.SP1 | __ ASMS| | __ ASMS| Press Enter to recall, END to bypass. | LOD __ ASMS|__________________________________________________________| __ ASMSRC01 SRC CHECKOUT 20150306 115943 CMNCOB2 USER016 LOD __ ASMSRC02 SRC ACTIVE 20150115 164426 CMNCOB2 USER016 ******************************* Bottom of data ********************************If this dataset has not been migrated, an edit session opens.
ISREDDE2 CMNTP.A00A2.#CE9B479.#0638571.ACPSRC94 Columns 00001 00072 Command ===>______________________________________________ Scroll ===> PAGE ****** ***************************** Top of Data ****************************** 000001 IDENTIFICATION DIVISION. 000002 PROGRAM-ID. ACPSRC94. 000003 000004 *PACKAGE ACTP000027 S6.V810 000005 *PACKAGE ACTP000001 S6.V810 000006 *PACKAGE ACTP000016 S4.V710T19 000007 *PACKAGE ACTP000007 S4.V711 000008 000009 ENVIRONMENT DIVISION. 000010 CONFIGURATION SECTION. 000011 SOURCE-COMPUTER. TRS-80. 000012 OBJECT-COMPUTER. IBM-370. 000013 000014 INPUT-OUTPUT SECTION. 000015 FILE-CONTROL. -
The edit session in the ChangeMan ZMF stage function is an ISPF edit session.
The file being edited is a ChangeMan ZMF temporary data set. The stage function copies the component from the package staging library into a dynamically allocated temporary edit data set so that you are not editing directly in the staging library.
Because you are working in a temporary data set, the ISPF SAVE function has no meaning and is disabled. If your administrator enabled the EDIT STAGING RECOVERY MODE ON parameter for your application, and your ChangeMan ZMF session ends abnormally, the temporary data set is saved, and is presented to you when ChangeMan ZMF is restarted and you connect again.
See Editing Components in ChangeMan ZMF for details about recovering your work from an interrupted edit session in ChangeMan ZMF.
-
When you finish your edit changes, press PF3 or type End in the Command line and press Enter.
If the COMPARISON REPORT option is selected, the updated component in the temporary edit data set is compared to the original component in the staging library. A comparison report is displayed online.
ISRBROBA CMNTP.A00A2.#CE9B479.#0638571.OUTLIST Line 00000000 Col 001 080 Command __________________________________________________===> Scroll ===> PAGE ********************************* Top of Data ********************************** S E R C M P A R (MVS - 871 - 20140828) 2 TEXTONLY FRIDAY MARCH SYSUT1=CMNTP.S6.ACTP.STG6.#000027.SRC(ACPSRC94),SYSUT2=CMNTP.A00A2.#CE9B479.#063 IDENTIFICATION DIVISION. PROGRAM-ID. ACPSRC94. ++++++++|+++.+<++1++++.++++2++++.++++3++++.++++4++++.++++5++++.++++6++++.++++7+> D *PACKAGE ACTP000027 S6.V810 ++++++++|+++.+<++1++++.++++2++++.++++3++++.++++4++++.++++5++++.++++6++++.++++7+> *PACKAGE ACTP000001 S6.V810 ++++++++|+++.+<++1++++.++++2++++.++++3++++.++++4++++.++++5++++.++++6++++.++++7+> I *PACKAGE ACTP000001 S6.V810 ++++++++|+++.+<++1++++.++++2++++.++++3++++.++++4++++.++++5++++.++++6++++.++++7+> *PACKAGE ACTP000016 S4.V710T19 *PACKAGE ACTP000007 S4.V711 ++++++++|+++.+<++1++++.++++2++++.++++3++++.++++4++++.++++5++++.++++6++++.++++7+> I *PACKAGE ACTP000008 S4.V711 ++++++++|+++.+<++1++++.++++2++++.++++3++++.++++4++++.++++5++++.++++6++++.++++7+> -
After reviewing your edit changes in the comparison report, press PF3 or type End in the Command line and press Enter. The Comparison Report Disposition (CMNSTG16) panel is displayed.
CMNSTG16 Comparison Report Disposition Command ===>_______________________________________________ Report dataset name . . . 'CMNTP.A00A2.#CE9B479.#0638571.OUTLIST' Report disposition . . . 3 1 - Print dataset and delete 2 - Print dataset and keep 3 - Delete dataset without printing 4 - Keep dataset without printing Job statement information if printing: //USER016 JOB (0000),'CHANGE MAN', // CLASS=A,NOTIFY=USER016,MSGCLASS=X //* //*The most important function of this panel is to let you cancel the changes you made in your edit session if you do not like the results that displayed in the comparison report. You can also print the comparison report from this panel.
If you want to keep your edit changes, use PF3 or type End in the Command line and press Enter.
-
If the CONFIRM OTHER REQUESTS option is selected, and the component you edited is in another change package that has not been baselined, the History- component.type (CMNCMPSW) warning panel is displayed.
CMNCMPSW History - ACTCPY00.CPY Row 1 to 2 of 2 Command ===>______________________________________ Scroll ===> CSR This component is included in the following packages: Package Sta Promoted vv.mm Last action Size Procname User Release ACTP000008 DEV 2015/01/12 20:44 *RENAME USER016 ACTP000007 DEV 04.01 2015/03/05 11:16 00006 USER016 ******************************* Bottom of data ********************************This panel lists the other packages that contain the component that you edited. You should 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 changes you made in your edit session, type CANCEL in the Command line and press Enter.
-
If staging versions are enabled for the library type being staged, the Component Change Description (CMNCMP02) panel is displayed, which allows you to enter an optional description of the component you are about to stage. You will also be able to provide change description for each component in the version control function within the package staging and query functions.
CMNSTG16 Comparison Report Disposition Command ===>_________________________________________________________ Report dataset name . . . 'CMNTP.A00A2.#CE9B4B9.#81CAF70.OUTLIST' ____________________________________________________ Report | CMNCMP02 Component Change Description | | Command ===> | | |rinting | Package: ACTP000027 |nting | Component: ACPSRCCA + | Job st | Type: SRC | //US | | // | Component change description (optional): | // | Deleted lines of code | // | | | | | | |____________________________________________|This table describes the fields on the Component Change Description panel:
Field Description Package Displays the ID of the package containing the component being processed. Component Displays the component name followed by the library type formatted as a file extension. Type Displays the component type Component change description Enter a description of the component you are saving to the staging library. The maximum length of the description is 35 characters. You may leave the description blank. Note
The description you enter on the Component Change Description panel applies to the new member in the staging library, not to the old member that is being saved as a staging version.
For a full description of the staging versions function, see Using Staging Versions
-
If your Administrator specified PROMPT when staging versions were enabled for the library type, the Save Previous Version (CMNCMP03) panel is displayed to ask you if you want to save a member that might already be in the staging library before it is overlaid.
CMNSTG16 Comparison Report Disposition Command ===>__________________________________________________ Report 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 containing the component being processed. Component Displays the name of the component that will be saved as previous version. Type Displays the component type of the component being processed. Save previous staging version Select to create a staging version from the component Omit to replace the component in staging without saving it first as a staging version. Set Save Previous Version prompt off Select to suppress the Save Previous Version panel until you exit the checkout or stage function. The last response entered in the Save version field is given for each component as long as the panel is suppressed. -
If you are staging a component that is not SRC or like-source, the system returns to the Stage: package Components panel, and the stage process is complete.
-
For SRC and like-source components, the stage process continues. The Stage: Build (CMNSTG04) panel is displayed.
CMNSTG04 Stage: Build HISTORY ASSUMED Command ===>___________________________________ Package: ACTP000003 Status: DEV Install Date: 20141231 Staged name . . . . ACPSRCCA + Library type . . . . SRC - Source for Programs to be Linked Executable Dataset name . . . . CMNTP.S4.V711.BASE.ACTP.SRC + Language . . . . . . . . . COBOL2 (Blank for list) Compile procedure . . . . CMNCOB2 (Blank for list; ? for designated proc.) Compile parms . . . . . . _________________________________ Pgm binder parms . . . . ._________________________________ Enter "/" to select option __Db2 processing __Other Db2 options __Other options / User variables __Suppress messages Job statement information: //USER001 JOB (0000),'S6 V810', // CLASS=A,MSGCLASS=X,NOTIFY=USER001 //* //*Note
The component status is changed to INCOMP as soon as this panel is displayed. Even if you press PF3 or type Cancel in the Command line, the component status changes
This table describes the fields on the Stage: Build panel:
Field Description Package ID The package ID of the current change package. Status The current status of this change package. Install date The date this change package is scheduled for installation. Staged name Displays the component name in the staging library. Library type Displays the component library type. Dataset name Displays the name of the staging dataset from which the component is to be staged; a personal or development library, or the temporary dataset created by ChangeMan if the module is to be checked out to staging. If there is a Designated Procedure for the component being staged, and the Force Level in that procedure is 2, then the fields on the Stage: Build panel are presented in display mode. If the Force Level of the Designated Procedure is 1, you can restore the fields on this panel to the values required for freeze by typing ? in the Compile Procedure field. Language Enter the source language. If the Language field is blank, the Language Selection List is displayed when you press Enter. If the Language field contains information when the panel is first displayed, the short ISPF message in the upper right corner of the panel tells you where the language was obtained: HISTORY ASSUMED: Obtained from component history. DESIGNATED ENFORCED: Obtained from a Designated Procedure. PRIOR ASSUMED: Obtained from a prior use of this panel for another component during your current ChangeMan ZMF session. Compile Procedure Enter the compile procedure to be used to stage the component. Compile procedures are members in the ChangeMan ZMF skeleton library that are processed by ISPF File Tailoring to create stage JCL. Type ? to restore Language, Compile Procedure, Compile Parms, Link Edit Parms, Db2 Precompile, and User Options from a Designated Procedure with Force Level 1. If the Compile Procedure field is blank, and if there are multiple Compile Procedures defined in administration for the specified Language, the Compile Procedure Selection List panel is displayed when you press Enter. If the Compile Procedure is blank, but there is only one Compile Procedure defined for the specified Language, the Compile Procedure field is filled automatically when you press Enter. If the Compile Procedure field contains information when the panel is first displayed, the short ISPF message tells you where the procedure was obtained. See Language above. Compile parms Enter additional compile options that are not already in effect through: System defaults. Compile Procedure skeletons. User Options. See Other Options below. Pgm binder parms Any additional program binder (link edit) parms as appropriate. Db2 Processing Indicates whether or not a Db2 pre-process or co-process is to be invoked during the compile. Other Db2 options Select to display the Db2 Physical Subsystems panel to set additional options for Db2 components. Field Db2 Processing must be selected. Leave blank to omit display of Db2 Physical Subsystems panel. Other options Select to display the Stage: User Options panel before submitting the stage job. Leave blank to omit display of Stage: User Options panel before submitting the stage job. Obtain User Options from component history or from a Designated Procedure with Force Level 2. Note: If the component has an enforced designated procedure associated with it, the values defined in the designated procedure are used whether or not you choose to display the options panel(s). User Variable Enter '/' to specify user variables V01 through V10 on panel CMNUSV1 to pass information to skeleton file tailoring. Suppress messages Select to suppress the SEND message normally broadcast at the completion of the stage job that tells you whether the component was staged successfully. (The job submitted message for the stage job is also suppressed.) Broadcast a SEND message at the completion of the stage job to tell you whether the component was staged successfully. Job statement information Enter valid job card information for your site. -
If you do not select Other Options field, stage job JCL is built by ISPF file tailoring from the Compile Procedure skeleton, and a stage job is submitted.
If you select Other Options field, as many as four Stage: User Options (CMNUSR01, CMNUSR02, CMNUSR03, CMNUSR04) panels are displayed.
Your ChangeMan ZMF installer and administrator may have modified these panels to fit your company needs. The example below shows only the first User Options Part 1 (CMNUSR01) panel that is delivered with ChangeMan ZMF.
CMNUSR01 User Options Part 1 Command ===>_____________________________________________________ Name: GNLSRC99 + Type: SRC Language: COBOL2 Compile only . . . . . IMS DLITxxx entry . . . CICS precompile . . . Drop include stmts . . Easytrieve object . . User option 06 . . . . User option 07 . . . . User option 08 . . . . User option 09 . . . . User option 10 . . . . User option 11 . . . . User option 12 . . . . User option 13 . . . . User option 14 . . . . User option 15 . . . . User option 16 . . . . User option 17 . . . . User option 18 . . . . User option 19 . . . . User option 20 . . . . Enter "/" to select option _ Mixed Case -
After setting use options, press Enter. ISPF file tailoring builds stage job JCL from the Compile Procedure skeleton. The stage job is submitted, and you are returned to the Stage: package Components (CMNSTG01) panel.
CMNSTG01 STAGE: ACTP000027 Components Row 1 to 5 of 5 Command ===>__________________________________________ Scroll ===> CSR Name + Type Status Changed Procname User Request __ACPSRCCA SRC CHECKOUT 20150306 115925 CMNCOB2 USER016 __ACPSRCCC SRC CHECKOUT 20150306 115928 CMNCOB2 USER016 LOCKED __ACPSRCCE SRC CHECKOUT 20150306 115940 CMNCOB2 USER016 LOCKED __ACPSRCD1 SRC CHECKOUT 20150306 115943 CMNCOB2 USER016 LOCKED __ACPSRC94 SRC INCOMP 20150115 164426 CMNCOB2 USER016 *BUILD ******************************* Bottom of data ********************************The Request column for the component now indicates the action taken, and the component Status is changed to INCOMP until the build process completes successfully.
-
Upon completion, the stage job issues an MVSSEND message to indicate whether the build process was successful. Type REFRESH on the Command line of the Stage: package Components (CMNSTG01) panel, and the Status column is changed to ACTIVE if the stage job was successful. If build processing failed, the component status remains INCOMP.
CMNSTG01 STAGE: ACTP000027 Components Row 1 to 5 of 5 Command ===>______________________________________________________ Scroll ===> CSR Name + Type Status Changed Procname User Request __ACPSRCCA SRC CHECKOUT 20150306 115925 CMNCOB2 USER016 LOCKED __ACPSRCCC SRC CHECKOUT 20150306 115928 CMNCOB2 USER016 LOCKED __ACPSRCCE SRC CHECKOUT 20150306 115940 CMNCOB2 USER016 LOCKED __ACPSRCD1 SRC CHECKOUT 20150306 115943 CMNCOB2 USER016 LOCKED __ACPSRC94 SRC ACTIVE 20150306 131649 CMNCOB2 USER016 ******************************* Bottom of data ********************************