COBOL - Endevor - Retrieve Element - www.cadcobol.com.br



Desenvolvido por DORNELLES Carlos Alberto - Analista de Sistemas - Brasília DF. - cad_cobol@hotmail.com

COBOL - Endevor - Retrieve Element

Retrieving an Element from an Inventory Location Using the Retrieve Elements Action

To retrieve an element from an inventory location to an external (user) data set, you use the Retrieve Elements action (available in foreground, batch, and in packages).

This section contains information for performing this development task in the foreground only.

Note: For more information about how to perform this element action in batch, see the SCL Reference Guide.
For more information about how to perform this element action using packages, see the Packages Guide.
The Add, Move, Generate, and Signin actions can be performed from the Quick-Edit Option panel, if the CA Endevor SCM Quick Edit option is enabled at your site.
For more information about Quick-Edit, see the Quick Edit Option User Guide.

How Retrieving an Element from an Inventory Location Works

When you retrieve an element from an inventory location to an external (user) data set using the Retrieve Elements action, the product performs the following actions and causes these effects:

  1. Determines whether the element is signed out. If the element is signed out to someone else, and if you do not set the SIGNOUT ELEMENT option to N, you must set the OVERRIDE SIGNOUT option to Y to retrieve the element.
    Note: Your site administrator must set up permissions for you to use the OVERRIDE SIGNOUT option.

  2. Searches for the specified element, in the following order:
    • At the location you specify in the RETRIEVE elements action
    • In each stage in the environments on the map route

    Note: If the product finds the element at a subsequent stage that is not part of the map, you get a warning message.
    In addition, if you do not know the exact location of the element you want to retrieve, specify the lowest stage in the map route.
    The product searches the entire map route for the element.

  3. Copies the current level of the element to the output data set.
    If you set the EXPAND INCLUDES option to Y, any INCLUDE statement is expanded when it is copied from the source.
    If the output data set is a library, the following applies:
    • If the member currently exists in the library, you must set the REPLACE MEMBER option to Y. Otherwise, the RETRIEVE action fails.
    • By default, the assigned member name will be the same as the element name you enter. You can enter a different name for the member.
      In this situation, the product assigns the new name to the retrieved element in the user library.

  4. If you set the SIGNOUT ELEMENT option to Y, the product updates the Master Control File (MCF) and signs the element out to you.
    If you set the SIGNOUT ELEMENT option to N, the product stops processing the action after it creates the copy in step 3.

How Retrieving an Element from an Inventory Location Affects the Signout ID

When you retrieve an element from an inventory location to an external (user) data set using the Retrieve Elements action, the software signs the element out to you by recording your user ID in the SIGNOUT ID field on the Master Control File (MCF) for the stage from which the element was retrieved, provided you set the SIGNOUT ELEMENT option to Y.
You should only set the SIGNOUT ELEMENT option to N when you want a copy of the element to review, but do not want to make changes to the element.

The administrator activates the signin/signout option for each system.
If signin/signout is not in effect, then the signout user ID is always updated.

How Retrieving an Element from an Inventory Location Affects CCIDs and Comments

When you retrieve an element from an inventory location to an external (user) data set using the Retrieve Elements action, you can enter a CCID and comment.
When you enter a CCID and comment, the Retrieve CCID/Comment is set.
When you set the SIGNOUT ELEMENT option to Y, the product records the CCID and comment you entered in the RETRIEVE CCID and COMMENT fields in the Master Control File (MCF). If you set the SIGNOUT ELEMENT option to N, the product does not update this information.

Retrieve an Element from an Inventory Location

To retrieve an element from an production to an external (user) data set, you use the Retrieve Elements action.

Important!
If your site administrator has enabled Global Type Sequencing, element actions execute in the type sequence order defined by your administrator (at the site level), regardless of the action's inventory location.

Follow the below steps to retrieve an element from an production.

  1. Start the product using the instructions provided by your site administrator.

    The Primary Options panel appears.

  2. Enter 2 (Foreground) and press Enter.

    The Foreground Options menu appears.

  3. Enter 3 (Retrieve) and press Enter.

    The Retrieve Elements panel appears.

    Note: For more information about a field or option on the panel, press PF1.

  4. Choose one of the following steps.

    • To retrieve an element, enter the information for the action, enter R in the Option field, and press Enter.

    • To retrieve an element from an Element Selection List (applies when you set the DISPLAY LIST option to Y), enter the information for the action, leave the Option field blank, and press Enter.

    • To retrieve a prior version of an element, enter the information for the action, enter S in the Option field, and press Enter.

  5. (Optional) If the Element Selection List or Summary of Levels panel appears, enter an option to the left of each member you want to retrieve and press Enter.
    The ISPF Locate command is supported on Element Selection lists.

    The element is retrieved to an external (user) data set.


© Copyright CA Technologies.