Retrieving from an Area

The retrieve area function removes components from area libraries.

You must retrieve components from area libraries to:

Detach a package from a release.
Check-in a new version of the component from a different package.
Check-in a component by a person different from the person who last checked in the component.

Note

You cannot edit components in an area library. After your package is attached to a release and components are checked in, you change those components in package staging libraries using ChangeMan ZMF package functions. You can only change a component in an area library by checking-in a new version to the area.

Area retrieve is subject to these rules and conditions.

The retrieve rule for an area determines whether you can retrieve from the area if it is blocked. The retrieve rule can also restrict who can perform retrieve from the area.
You can retrieve all components in an area or you can retrieve selected components. If you want to remove all components that originated in a particular package, use the package retrieve function. See Retrieving a Package.
A single area retrieve operation removes components from a set of release area application libraries. If there are several applications joined to a release, you perform multiple retrieve operations to remove all components from the area.

Follow these steps to retrieve components from a release area.

Follow these steps to access the release area that you want to retrieve.

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 AR on a release row to select the release that contains the area you want to retrieve. Press Enter, and the release Release Area List panel is displayed.

CMNRMALF        FIN6410 Release Area List       Row 1 to 3 of 3
Command ===>                                    Scroll ===> CSR

        Area                Status          Area  Prior     Next
    Name     Type   Aud BLK CIA COA CIR COR step  area      area
    ACCTPAY  SUBSYS 00   N   N   N   N   N  0001            FINANCE
    GENLEDGR SUBSYS      N   N   N   N   N  0002            FINANCE
    FINANCE  SYSTEM      N   N   N   N   N  0003  GENLEDGR
******************************* Bottom of data *******************************

The release Release Area List panel shows all areas that are defined in the release that you selected. The fields on release Release Area List panel are described in Notifying Area Check-in Approvers.

On the release Release Area List panel, type RT in the line command of the area that you want to retrieve, and press Enter. The release - Joined Application List panel is displayed.

CMNRMAFL        FIN6410 - Joined Application List       Row 1 to 5 of 5
Command ===>                                            Scroll ===> CSR

    Appl    Join date  Application description
    ACTP    20160111   ACTP Accounts Payable (Base ZMF)
    ACTR    20160111   ACTR Accounts Receivable
    COMM    20160111   COMM Common Components (Base ZMF)
    GENL    20160111   GENL General Ledger (Db2 Option)
    JHFS    20160323   JHFS hfs only application
******************************* Bottom of data *******************************

This panel shows the applications joined to the release you selected. Use this panel to select a set of release area application libraries to retrieve from.

On the release - Joined Application List panel, type S in the line command for one or more application rows that you want to retrieve. You can also type SETALL and SETOFF in the Command line to select or deselect all applications. Press Enter, and the Release Area Retrieve Options panel is displayed.

CMNRTV50            Release Area Retrieve Options
Option ===>

Release: FIN6410    Area: ACCTPAY   Application: ACTP

1 Area          Retrieve components from area libraries
2 Area Parms    Retrieve component list area selection criteria

Report format . . . LONG (Short-errors only; long-all components)

Enter "/" to select option
    Batch Retrieve

Note

Here, we are retrieving from area ACCTPAY, which fits with the example in Checking-in an Area, where we checked in area ACCTPAY into area FINANCE.

This table describes fields and options on the Release Area Retrieve Options panel.

Field	Description
Release	Displays the release that contains the area you are retrieving from.
Area	Displays the area that you are retrieving from.
Application	Displays the application that you selected to retrieve from.
Report Format	Type an online report format for the results of the retrieve process. Short Only display components with retrieve errors. (Abbreviation: S) Long Display all components requested for retrieve. (Abbreviation: L)
Batch Retrieve	Choose an option to determine whether retrieve runs online with your terminal locked or in a batch job. Select to create batch JCL and submit a job to free your terminal while retrieve is processing. Blank will process a retrieve online with your terminal locked.
Options	Choose an option to display a list of components to select for check-in. 1 Area Display all package components on the Release Checkin area Components panel where you select components for check-in. 2 Area Parms Display the Component Release Area Retrieve List Parameters panel where you to specify area component filters, then display the filtered list on the Release Retrieve area Components panel where you select components for retrieve.

Choose one of the options on the Release Area Retrieve Options panel and press Enter.

If you chose option 1 Area, the Release Retrieve area Components panel is displayed. The panel lists all components belonging to the selected application that are checked-in into the area you are retrieving from.
If you chose option 2 Area Parms, the Component Release Area Retrieve List Parameters panel is displayed, where you to specify component filters. When you press Enter, the Release Retrieve area Components panel is displayed. The panel shows only the components belonging to the selected application that are checked-in into the area you are retrieving from that passed the filter.

CMNCKI52    RELEASE RETREIVE ACCTPAY Components     Row 000001 Of 000026
Command ===>                                        Scroll ===> CSR

      Component     Type Like Checked in to area Orig. pkg   User    Area
    _ ACPCTC10      CTC   P   2016-04-13-11.25.12 ACTP000039 USER239 FINANCE
    _ ACPJCL20      JCL   J   2016-04-13-11.25.12 ACTP000039 USER239 FINANCE
    _ ACPPRC20      PRC   R   2016-04-13-11.25.12 ACTP000039 USER239 FINANCE
    _ ACPSRC1A      LOD   L   2016-04-13-11.25.12 ACTP000038 USER239 FINANCE
    _ ACPSRC1A      LST   X   2016-04-13-11.25.12 ACTP000038 USER239 FINANCE
    _ ACPSRC1A      SRC   S   2016-04-13-11.25.12 ACTP000038 USER239 FINANCE
    _ ACPSRC2A      LOD   L   2016-04-13-11.25.12 ACTP000039 USER239 FINANCE
    _ ACPSRC2A      LST   X   2016-04-13-11.25.12 ACTP000039 USER239 FINANCE
    _ ACPSRC2A      SRC   S   2016-04-13-11.25.12 ACTP000039 USER239 FINANCE
    _ ACPSRC30      LCT   K   2016-04-13-11.25.12 ACTP000038 USER239 FINANCE
    _ ACPSRC30      LOD   L   2016-04-13-11.25.12 ACTP000038 USER239 FINANCE
    _ ACPSRC30      LOS   N   2016-04-13-11.25.12 ACTP000038 USER239 FINANCE
    _ ACPSRC30      LST   X   2016-04-13-11.25.12 ACTP000038 USER239 FINANCE
    _ ACPSRC50      LOD   L   2016-04-13-11.25.12 ACTP000038 USER239 FINANCE
    _ ACPSRC50      LOS   N   2016-04-13-11.25.12 ACTP000038 USER239 FINANCE
    _ ACPSRC50      LST   X   2016-04-13-11.25.12 ACTP000038 USER239 FINANCE

The Release Re_area_trieve Components panel shows a list of components for you to select for retrieve from the area.

This table describes the fields on the Release Retrieve ar_ea 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 all selected components.
Line Command	Type S to select a component for retrieve.
Component	Displays the component name.
Type	Displays the component library type.
Like	Displays the library Like-type for the component.
Checked in to area	Displays the date and time that the component was checked in to the area.
Orig. pkg	Displays the name of the change package that contained the component now in the area library.
User	Displays the userid of the last person to change the component in the change package.

Note

You can retrieve a large number of components without selecting each component individually. Filter the list of application area components with selection criteria on the Component Release Area Retrieve List Parameters panel, then use the SETALL command on the Release Retrieve area Components panel to select all of the listed components.

When you are satisfied with your selections on the Release Retrieve area Components panel, press Enter to process your selections.

If you specified Long in the Report Format field on the Release Area Retrieve Options panel, the Release Retrieve Long Summary panel is displayed. This panel shows the status of the retrieve process for every component selected for retrieve.

CMNCKI57 EVE ACCTPAY to FINANCE Long Summary        Retrieve Complete
Command ===>                                        Scroll ===> CSR
                         Area     CIM   History Checkin
Component   Type Area    Copy    table   table  component status
ACPCTC10    CTC FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPJCL20    JCL FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPPRC20    PRC FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPSRC1A    LOD FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPSRC1A    LST FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPSRC1A    SRC FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPSRC2A    LOD FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPSRC2A    LST FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPSRC2A    SRC FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPSRC30    LCT FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPSRC30    LOD FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPSRC30    LOS FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPSRC30    LST FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPSRC50    LOD FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPSRC50    LOS FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPSRC50    LST FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPSRC99    LOD FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPSRC99    LST FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED
ACPSRC99    SRC FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED

If you specified Short in the Report Format field on the Release Area Retrieve Options panel, the Release Retrieve Short Summary panel is displayed. This panel lists components where there was a problem in the retrieve process. If there were no problems, the panel shows a summary line FOR ALL COMPONENTS.

CMNRTV57 - RELEASE RETRIEVE Short Summary           Retrieve Complete
Command ===>                                        Scroll ===> CSR

Release         Lib  Release  Area    CIM    History Release area retrieve
component       type  area   delete  table    table  component status
FOR ALL COMPONENTS   FINANCE RC=0000 RC=0000 RC=0000 RETRIEVE WAS COMPLETED

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

Field	Description
Release component	Displays the names of the components requested for retrieve.
Lib type	Displays the library type of the component.
Release area	Displays the name of the release area from which the retrieve was requested.
Area delete	Displays the return code from the operation that deletes the component from the release area applications 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 status of the component in the retrieve process.

Press Enter to return to the Release Area Retrieve Options panel and then press PF3. If there are more applications to retrieve, the Application field on the Release Area Retrieve Options panel displays the next selected application. Execute the release area retrieve process for the next application, starting at #4 above.
When there are no more applications to retrieve and you press PF3 on the Release Area Retrieve Options panel, you are returned to the release Release Area List panel.
Area retrieve is complete.