Skip to content

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:

  1. 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.
  2. 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.
    
  3. 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.

  4. 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+>
    
  5. 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.

  6. 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.

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

  8. 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.
  9. 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.

  10. 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.
  11. 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
    
  12. 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.

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