Skip to content

Retrieving a Package

The retrieve package function removes all package components from the libraries for an area.

You must remove package components from area libraries to:

  • Detach a package from a release.

  • Check in new versions of all package components from a different package.

Note

You cannot edit components in an area library. Even after your package is attached to a release and components are checked in, you change those components in the package staging libraries using ChangeMan ZMF base functions. You change a component in an area library by checking in a new version to the area. Unless you were the last person to check in a component from the same package, you must retrieve the component from the area before checking in a new version.

Package retrieve is subject to these rules and conditions:

  • The retrieve rule for the area determines whether you can retrieve components from the area if the area is blocked. The retrieve rule can also restrict who can perform retrieve from the area.

  • Package retrieve removes all package components from the area. If you want to remove selected package components from the area, use the area retrieve function. See Retrieving from an Area.

  • Package retrieve only removes those components that originated in your package. Components in area libraries that originated in other change packages are not removed, even if you have components with the same name in your package.

  • If you attempt to use package retrieve after the area retrieve function was used to remove all of your package components from an area, an error message is issued. However, the package checked in indicator is reset, and no problems will result.

Follow these steps to retrieve a package from one or more release areas:

  1. Follow these steps to access the package that you want to retrieve.

    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 retrieve. 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 00           Y
           ACTP000038  DEV ACCTPAY 20160429 2359 SERT6     S6P1IT 00           Y
       ******************************* Bottom of data *******************************
      

      The release - Release Package List 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.

  2. On the release - Release Package List panel, type RP in the line command of the package that you want to retrieve, and press Enter. If the target package has many components, you can type RB (Retrieve Batch) in the line command of the package that you want to retrieve and press Enter. (RB will submit a batch job to retrieve package components, which frees your terminal so that you can perform other functions while the retrieve option is being performed.)

    Regardless of whether you type the RP or RB line command, the package Area List With Components panel is displayed.

    CMNRMPAR        ACTP000038 Area List With Components    Row 1 to 1 of 1
    Command ===>                                            Scroll ===> CSR
    
            Area            Status           Area  Prior    Next
        Name    Type Aud BLK CIA COA CIR COR step  area     area
    _   ACCTPAY   0       N   Y   N   N   N  0001           FINANCE
    ******************************* Bottom of data *******************************
    

    This panel lists release areas that contain components from your package. In this example, the package was checked into the starting area, but that area was not checked in to its next area. By the end of the release life cycle, the package Area List With Components panel displays the entire chain of areas from the starting area to the final release area.

    This table describes the fields on the package Area List With Components panel.

    Field Description
    Command Type a command, or leave Command blank to type a Line Command on an area.
    CANCEL   Cancel panel without update. (Abbreviation: C)
    LOCATE area   Locate an area. (Abbreviation: L)
    REFRESH   Refresh the panel display from system files and tables. (Abbreviation: R)
    Line Command Type S to select a release area to remove package components from.
    Area Name Displays the area name
    Field Description
    Area Type Displays the area type code.
    0   Subsystem area
    1   System area
    Area Aud Displays the return code of the last release audit run on this area.
    Status BLK Displays Y if the release area is blocked.
    Status CIA Displays Y if all check-in approvers have entered their approval.
    Status COA Displays Y if all check-off approvers have entered their approval.
    Status CIR Displays Y if at least one check-in approver has entered a reject.
    Status COR Displays Y if at least one check-off approver has entered a reject.
    Area Step Displays the step number specified in the area definition. The number in this field determines the order that areas are displayed on ERO panels.
    Prior Area Displays the prior area specified in the area definition.
    Next Area Displays the next area specified in the area definition.
  3. On the package Area List With Components panel, type S in the line command for an area row to retrieve your package components from that area. You can select multiple areas for package retrieve. Press Enter to process your request.

    If you selected the RB (Retrieve Batch) function, the Submit Batch Retrieve (CMNRTV70) panel is displayed. Enter a valid JOB statement and press Enter to submit the job. The release retrieve summary is written to the SYSPRINT output dataset.

    Note

    The batch retrieve function calls exit CMNEX220 for post-retrieve processing. Refer to the ChangeMan ZMF Customization Guide for information about this exit.

    If you selected the RP (Retrieve Package) function, the Release Retrieve Summary panel is displayed.

    CMNRTV57    Release RETRIEVE LONG Summary           Retrieve Complete
    Command ===>                                        Scroll ===> CSR
    Release     Lib Release Area      CIM   History Release area retrieve
    component   type area   delete   table   table    component status
    ACPSRC1A    LOD ACCTPAY RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
    ACPSRC1A    LST ACCTPAY RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
    ACPSRC1A    SRC ACCTPAY RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
    ACPSRC30    LCT ACCTPAY RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
    ACPSRC30    LOD ACCTPAY RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
    ACPSRC30    LOS ACCTPAY RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
    ACPSRC30    LST ACCTPAY RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
    ACPSRC99    LOD ACCTPAY RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
    ACPSRC99    LST ACCTPAY RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
    ACPSRC99    SRC ACCTPAY RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
    ACPSRS1B    LOS ACCTPAY RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
    ACPSRS1B    LST ACCTPAY RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
    ACPSRS1B    SRS ACCTPAY RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
    ACPSRS1C    LOS ACCTPAY RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
    ACPSRS1C    LST ACCTPAY RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
    ACPSRS1C    SRS ACCTPAY RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
    ******************************* Bottom of Data ********************************
    

    This table describes the fields on the Release Retrieve Summary panel.

    Field Description
    Release component Displays the name of package components that are retrieved from release area libraries.
    Lib type Displays the library type of the retrieved component.
    Release area Displays the name of the release area that the component is retrieved from
    Area delete Displays the return code from the delete from release area library.
    CIM table Displays the return code from the component-in-motion table update.
    History table Displays the return code from the history table update.
    Release area retrieve component status Displays retrieve status of the component in the target area.
  4. Press Enter then press PF3 to return to the release - Release Package List panel, which now displays N in the Checked In column for the package you retrieved.

    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 00           N
        ACTP000038 DEV ACCTPAY 20160429 2359 SERT6  S6P1IT 00           N
    ******************************* Bottom of data *******************************
    

    Package retrieve is complete.