Processing Elements in Batch › Adding and Updating Elements

Adding and Updating Elements

Use the Add/Update action to:

• Add an element to the environment's entry stage for the first time.
• Add an element to stage 1 (when it is the entry stage), for the first time, that currently resides in Stage 2.
• Add an element to the entry stage of the environment after it has been removed from that stage by a Move, Delete, Transfer, or Archive action.
• Update an element in the entry stage, creating a new level of the element.

The Add/Update Elements panel contains the following fields:

Option

Indicates the processing you wish to perform. The following options are available:

Blank

Displays a list of members in the source library. You can select one or more members to add or update.

A

Adds an element, either for the first time or after the prior version was deleted by a Delete, Move, Archive or Transfer action. Note that you can add an element only to the entry stage.

U

Updates an element in the entry stage to create a new level of the element.

To Location

Enter information defining the element being added or updated. The following options are available:

Environment

Name of the current environment. Enter a different name to add or update an element in another environment.

System

Name of the system under which the element is (to be) defined.

Subsystem

Name of the subsystem under which the element is (to be) defined.

Element

The name of the element (up to 10 characters) to be added or updated. If the from data set is a library, you can leave this field blank; the member name in that library automatically becomes the element name. You also can use a name mask to indicate that all elements, or only those matching the characters specified, should be considered in this request.

Element names can include only the following characters: A-Z, 0-9, @, #, and $

Type

The element type, such as COBOL, COPYLIB, etc. This is a required field for an Add or Update action.

Action

These options provide additional information for the request. The following options are available:

Comment

Enter any comments describing this request. Depending upon the system specified for this request, comments may be required.

CCID

You can enter a CCID (up to 12 characters) to further define the element. Depending upon the system specified for this request, a CCID may be required.

Bypass Gen Processor

Specify Y (yes) if you want CA Endevor SCM to bypass the generate processor for the element. If you select Y, the element or member will be added or updated, but the generate processor will not be executed for that element or member. In addition, CA Endevor SCM will not set the generate or component delta CCID comments for the element.

Delete Input Source

Allows you to delete the member from the PDS, CA Panvalet or CA Librarian data set in which it originated, after the element is added successfully.

• Enter Y to delete the member after processing.
• Enter N to retain the member after processing.

Note: You cannot use this option to delete a member from the CA Roscoe IE library.

New Version

This option applies to an Add action only. By default, the element is assigned a version number of 1 if it is a new element, or the Stage 2 version number if the element currently exists in Stage 2. You can assign a different version number, however, by entering a number from 1 to 99 in this field.

Leave this field blank to apply the appropriate default value.

Override Signout

This option applies when adding an element currently in Stage 2 or when updating an element with signin/signout in effect.

• Enter Y to indicate that the element can be added or updated, even if it is not signed out to you. CA Endevor SCM signs the element out to you if you specify this option.
• Enter N to indicate that processing is not allowed unless the element is signed out to you. This is the default value.

Processor Group

This is the name of the processor group to be used. If you leave this field blank and are adding a new element, the system uses the default processor group for the element type. If you leave this field blank and are adding an existing element or updating an element, the system defaults to the processor group last used for this element. You can also type a processor group name in this field or a name mask to access a list of processor groups from which to select.

Update if Present

This option applies to an Add action only. It allows you to add the element, even if it currently exists in the entry stage, by treating the action as an Update action.

• Enter Y to indicate that the element should be added even if it already exists in the entry stage.
• Enter N to indicate that the element should not be added to the entry stage if it currently exists there. This is the default.

From Partitioned or Sequential Data Set

Enter information defining the library or data set in which the element currently resides. The following options are available:

Data Set Name

Enter the appropriate data set name.

Member

Enter the appropriate member name; you can enter either the full name or use a name mask. If you leave this field blank, the member name defaults to the element name.

Thru Member

Use this field to specify a range of members in the data set. The member name entered here indicates the last member in the range, with the name specified in the MEMBER field considered as the first name in the range. You can enter either a full member name or use a name mask.

As an alternative, you can add a member from a CA Roscoe IE data set. The interface:

• Builds the SCL for the request as: From DDNAME ROSCOE.
• Appends an IEBUPDTE step to the beginning of the skeleton JCL to transfer the CA Roscoe IE member to a temporary data set. This temporary data set is then passed to a CA Endevor SCM step under DDNAME ROSCOE.

List Options:

• This option is always set to Y.