Performing User Tasks › How Retrieving an Element from an Inventory Location Works › Retrieve an Element from an Inventory Location

Retrieve an Element from an Inventory Location

Use the CA Endevor Integration for the Natural Environment Retrieve Elements action (available in foreground and batch) to perform the following actions:

• Retrieve a Natural programming object element or Natural error message element from a CA Endevor SCM inventory location to a specified FUSER/Library.
• Retrieve a Predict object element or Natural DDM element from a CA Endevor SCM inventory location to a specified FDIC.

To retrieve an element from an inventory location

1. Access the CA Endevor Integration for the Natural Environment Main Menu.

   Note: For more information, see Start a User Session.

2. Select either the Foreground or Batch processing option on the CA Endevor Integration for the Natural Environment Main Menu. Press Enter.

   The Foreground Processing Menu or the Batch Processing Menu opens.

3. Select an object type (Natural programming object, Error message text, DDM, or Predict object) and the retrieve action type (R) and press Enter.

   The retrieve interface (for the object type you selected) opens.

4. Choose one of the following steps to select the elements you want to retrieve and submit your request:
   1. To retrieve elements from a Retrieve Selection list, set the Select List option to Y, enter the information for the action, and press Enter.

      The Retrieve Selection screen opens.

      • To select the elements you want to retrieve, enter an X to the left of those element on the Retrieve Selection screen.
      • If you want to retrieve a prior level, enter an S to the left of an element on the Retrieve Selection screen. When the Summary Information for Element window opens, press PF4 to open the Element Level Selection List window. You can select a level for retrieval by entering an X to the left of that level.
      • Enter Y to the left of any object that you want to rename. A dialog window opens showing the old name of the object. You can enter a new name. If you previously specified a value in the New Object Name field on the Retrieve Natural Programming Objects panel, you can change that value in the dialog.
   2. To retrieve elements without a selection list, set the Select List option to N, enter the information for the action, and press Enter.

      In both Foreground and Batch modes, an Action Confirmation window opens telling you how many elements have been selected for retrieval. Press Enter to submit the retrieval requests.

5. In Foreground mode, CA Endevor Integration for the Natural Environment interfaces with CA Endevor SCM to retrieve the selected elements to the designated FUSER/Library or FDIC.

   In Batch mode, press PF5 from the Batch Processing Menu to submit the requests for batch processing. The batch request is processed as follows:

   1. For each Natural and Predict element to be retrieved, a batch Natural step is created to execute the EINE Natural program DNPC. DNPC checks the target location to determine if the Natural object or Predict object already exists in the Natural library or FDIC file, respectively. The program issues a message indicating whether or not the element was found and updates the temporary data created for the Retrieve action with the indicator.
   2. When the EINE_ACTIVE=ON option is enabled in the CA Endevor SCM Optional Features table (ENCOPTBL), a CA Endevor SCM UEXIT02 is called that reads the temporary data set updated by DNPC when the CA Endevor SCM SCL is processed.
      • If the REPLACE IF PRESENT option is set to N on the Retrieve Natural Programming Objects panel and the object exists in the target location, CA Endevor SCM fails the Retrieve action and issues an RC = 12 with the following error message:

        C1U0970E  EXIT 2 - RETRIEVE ACTION DENIED - REPLACE=N SPECIFIED AND OBJECT EXISTS IN NATURAL LIBRARY
        

      • If the element does not exist in the target location or the REPLACE IF PRESENT option is set to Y, the appropriate level of the Natural or Predict element is written to the temporary data set.
   3. If Retrieve action has not been failed by the UEXIT02, the Natural or Predict element is written to the temporary data set specified in the To clause and then loaded to the target location in separate batch Natural load steps.

   Note: For more information on the specific details of the Retrieve action Load steps, see Submit Actions in Batch.