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



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

COBOL - Endevor - Add Element

Adding a Member from an External Data Set Using the Add Elements Action

To control and manage a member from an external data set, you use the Add Elements action (available in foreground, batch, and in packages).
The member can be any of the following:

  • A sequential data set
  • Hierarchical File System (HFS) files (CA CM Enterprise Workbench only)
  • PDS or PDSE library members
  • CA Panvalet library members
  • CA Librarian library members
  • Load modules (RECFM=U)
  • Binary files

You can add members only to the entry stage, and only when there is no other element with the same name in the target entry stage.

Note: If you have an element with the same name in the target entry stage, use the Update Elements action.

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.

Considerations When Adding a Member from an External Data Set

Before you allow the product to control a member from an external data set using the Add Elements action, consider the following information to ensure your success:

Important!
If you do not follow these considerations and continue adding the element, the Add Elements action will fail.

  • Ensure that an element with the same name is not already in the target entry stage.
    If so, first contact the current element owner, or your site administrator, to discuss the most appropriate action.
    Then, consider these workarounds:
    • Wait until the element has been moved out of the entry stage, and then add the member.
    • Add the member using the UPDATE IF PRESENT option.
    • Add the member using the Update Elements action.

  • Ensure that the element corresponding to the member you want to add is signed out to you.
    If the element is signed out to another person on your team, first contact the current element owner, or your site administrator, to see if they can sign the element out to you. Then, consider these workarounds:
    • Sign the element in using the SIGNOUT TO option.
    • Add the member using the OVERRIDE SIGNOUT option.

      Note: If your site administrator has restricted permissions for the OVERRIDE SIGNOUT option, you may not be able to use the option.

How Adding a Member from an External Data Set Works

When you allow the product to control a member from an external data set using the Add Elements action, the product performs the following actions and causes these effects:

  1. Verifies that the element is signed out to you and does not exist in the entry stage.

  2. Searches beyond the entry stage for an element with the same name.

    Note: Every stage in the mapped route is searched for a match.
    If the element is found in a stage in the map, the product copies the current version of the element to the target entry stage, along with the last processor group name used for the element.

  3. If you code the new version option, the element is not copied back to the entry stage.
    The product assigns the version number you enter.

    Important! If the element is found in a stage that is not included in the map, you get a warning message.
    The search continues for an element in a stage that is included in the map.

  4. Compares the member being added with the entry stage base.
    If the element is not found along the map, the element is created in the entry stage with a version number of 01 and base level of 00 (zero).

  5. If the product built an entry stage base, the member being added is compared to that base, and builds a new level with any changes.
    If no changes are detected, you get a warning message.

  6. Updates the Master Control File (MCF).

    Important!
    The value specified for Signout Upon Fetch (the SOFETCH parameter) in the Defaults Table (C1DEFLTS) effects how the MCF will be updated for the element copied back (fetched).
    If Signout Upon Fetch is in effect, the element will be signed out to you unless it is already signed out to someone else.
    If Signout Upon Fetch is not in effect, the element will not be signed out to you.

    Note:
    For more information about Signout Upon Fetch, see the Administration Guide.

  7. Continues executing the action based on the value in the GENERATE ELEMENT option.
    If this option is set to N, the element is not generated.
    If this option is set to Y, the product performs the following actions:
    • Reads the type definition for a source output library specification and writes a copy of the current level of the element to that library.
      If the EXPAND INCLUDES option is set to Y, the product expands INCLUDE statements in the source.
    • Determines which processor group to use and executes the generate processor in that group (if one has been specified).
      After the generate processor has been run for the element, the product updates the processor information in the Master Control File.

      Note: For more information about processors, see the appendix Selecting the Correct Processor Group.

  8. Deletes the member in the FROM library (if the DELETE INPUT SOURCE option is set to Y).

How Adding a Member from an External Data Set Affects the Signout Status

Your site administrator can enable a signout capability on a system-by-system basis.
When you allow the product to control a member from an external data set using the Add Elements action, the product performs the following actions and causes these effects:

  • If the element exists up the map, a fetch is performed.
    • If your site administrator has enabled Signout Upon Fetch, the fetched (source) element is signed out to you, if the element is not signed out to someone else.
      In addition, the target element is signed out to you.
    • If your site administrator has not enabled Signout Upon Fetch, there is no change in the signout status, and the target element is signed out to you.

  • If the element does not exist up the map, a fetch is not performed.
    • If your site administrator has enabled Signout Upon Fetch, the target element is signed out to you.
    • If your site administrator has not enabled Signout Upon Fetch, the target element is signed out to you.
    Note: For more information about Signout Upon Fetch, see the Administration Guide.

How Adding a Member from an External Data Set Affects CCIDs and Comments

When you allow the product to control a member from an external data set using the Add Elements action, you can enter a CCID and comment.
When you enter a CCID and comment, the product sets the following options:

If you manage a new element:

  • Current Source CCID/Comment
  • Generate CCID/Comment (if changed)
  • Last Action CCID/Comment
  • Source Delta CCID/Comment
  • Component Delta CCID/Comment (if generated)

If you manage an existing element:

  • Current Source CCID/Comment (if changed)
  • Generate CCID/Comment (if generated)
  • Last Action CCID/Comment
  • Source Delta CCID/Comment
  • Component Delta CCID/Comment (if the generate creates a delta)

Note: If you set the GENERATE ELEMENT option to N, the Add Elements action does not set the generate or component delta CCIDs and comments.

Add a Member from an External Data Set

To control and manage a member from an external data set (PDS or PDS/E member, CA Panvalet, CA Librarian or sequential data set, or load module), you use the Add Elements action.

Follow the below steps to add an element into endevor entry stage.

  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 2 (Add/Update) and press Enter.

    The Add/Update Elements panel appears.

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

    Note: For more information about adding or updating an element with the Autogen option, see How Generating Elements with Autogen Works.

  4. Choose one of the following steps.

    1. To add a member, enter the information for the action, enter A in the Option field, and press Enter.

      Note: If you want the element name to be different from the member name, change the name in the ELEMENT option.
      In addition, if you are adding an element for the first time, the comment becomes the element description in the Master Control File.

    2. To add multiple members, leave the Option field blank and press Enter.

      The Member Selection List appears. This list appears when the source data set is a library, you leave the Option field blank, the DISPLAY LIST option is set to Y, and when both the ELEMENT and MEMBER options are blank or have a name mask.
      The ISPF Locate command is supported on Member Selection lists.

  5. (Optional) If the Member Selection List appears, enter A to the left of each member you want to add and press Enter.

    The members are added and you return to the Add/Update Elements panel.
    You can browse the listing data set for more information about each selected member.


© Copyright CA Technologies