Previous Topic: The Element Selection List for the Signin ActionNext Topic: The Element Selection List for the Transfer Action

Processing Elements in Batch › Transferring Elements

Transferring Elements

The Transfer action transfers elements from one CA Endevor SCM location to another. Use the Transfer Elements panel to identify the element being transferred. The Transfer action cannot be done against a sourceless element.

If you want to transfer an element to or from an archive data set, you must manually code the SCL for the action.

Note: For more information about manually coding the SCL, see Edit the Request Data Set and the SCL Reference Guide.

If you manually code a Transfer request to an archive data set, you cannot use “ROSCOE” as the archive (TO) data set. If you assign “ROSCOE” as the TO data set name, you receive an error message.

The Transfer Elements panel contains the following fields:

Option

Use this field to specify the processing you wish to perform. The following options are available:

Blank

Display a selection list, optionally restricted according to any specifications provided (environment, system name, etc.).

T

Generate an action request to transfer a sourced element from the From Location to the To Location.

S, M, B, C, H

Display one of the following element information panels:

  • Summary of Levels (S)
  • Element Master Info (M)
  • Element Browse (B)
  • Element Changes (C)
  • Element History (H)

Note: S, B, C, and H are invalid display options for sourceless elements. For elements of log delta format, options H and C are not valid, and option B can only be used on the current (last) level of the element. For elements of image delta format, H and C are not valid.

From Location

Define the location from which the element is being transferred. The following options are available:

Environment

Name of the current environment. Enter a different name to transfer an element from another environment.

System

Name of the system under which the element is currently defined. You can use a name mask to indicate that all systems, or only those matching the characters specified, be considered in this request.

Subsystem

Name of the subsystem under which the element is currently defined. You can use a name mask to indicate that all subsystems, or only those matching the characters specified, be considered in this request.

Element

The name of the element (up to 10 characters) to be transferred. You can use a name mask to indicate that all elements, or only those matching the characters specified, 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. You can use a name mask to indicate that all types, or only those matching the characters specified, be considered in this request.

Stage

Enter the ID of the stage from which you want to transfer the element. Use one of the IDs listed to the right of this field. You also can use a name mask with this field.

To Location

Define the To Location for the element being transferred. The following options are available:

Note: You cannot use name masks with the To Location fields.

Environment

Name of the To Location environment. If you leave this field blank, the environment defaults to the FROM environment.

System

Name of the system under which the TO element is defined. If you leave this field blank, the system defaults to the FROM system entry.

Subsystem

Name of the subsystem under which the TO element is defined. If you leave this field blank, the system defaults to the FROM subsystem entry.

Element

The name under which the TO element will be stored. Enter an element name if you want to change the name specified in the FROM clause. Otherwise, the element name defaults to the FROM entry.

Note: You can enter a new element name here only if you coded a full element name as the FROM element name. Element names can include only the following characters: A-Z, 0-9, @, #, and $

Type

Name of the to element type (such as COBOL, COPYLIB, etc.). If you leave this field blank, the type defaults to the FROM type entry.

Stage

The stage ID for the TO element. If you leave this field blank, the stage ID defaults to the FROM stage.

Comment

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

List

The following List options are available:

Display List

This option is always set to Y.

Where CCID EQ

A CCID can be specified in this field to limit the selection list to only those elements whose last CCID is equal to the specified CCID. If omitted, the WHERE CCID EQ field is not used to limit the selection list.

Where PROC GRP EQ

A processor group can be specified in this field to limit the selection list to only those elements to which the processor group has been assigned. If omitted, the WHERE PROC GRP EQ field is not used to limit the selection list.

Action

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

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 Element Delete

Use the BYPASS ELEMENT DELETE option to retain the element in the From Location after it is transferred. Otherwise, the system automatically deletes that element after the Transfer action is completed.

  • Enter Y to retain the element after it is transferred. This is the default value.
  • Enter N to delete the element after it is transferred.
Bypass Gen Processor

Use this option if you want to bypass the generate processor for the element after it is transferred. Otherwise, the system looks for and executes the generate processor for that element.

  • Enter Y to bypass (that is, not execute) the generate processor for the element after it is transferred. This is the default value.
  • Enter N to execute the generate processor for the element after the Transfer action is completed.
Override Signout

This option applies only when signin/signout is in effect for the FROM system.

  • Enter Y to transfer the element 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

The name of the processor group to be used. If you leave this field blank, the system defaults to the processor group last used for this element. You can also type a processor group name in this field or use a name mask to access a list of processor groups from which you can select.

Synchronize

This option applies when the element already exists in the To Location. The SYNCHRONIZE option is used in conjunction with the WITH HISTORY option. When you want to transfer an element with history, and the current level of the To Location element differs from the base level of the From Location element, you normally receive an error message and the transfer is not performed.

If you use this option, however, the system creates an intermediate level known as the synchronized level which contains the differences between the base level of the From Location element and the current level of the To Location element. All levels (change history) associated with the From Location element are then appended to the To Location element and renumbered.

  • Enter Y if you want the Transfer action to be performed even though the base level of the FROM element differs from the current level of the TO element.
  • Enter N if you do not want the Transfer action to be performed when the base level of the FROM element differs from the current level of the TO element. This is the default value.
With History

The WITH HISTORY option preserves From Location change history. If you request a TRANSFER WITH HISTORY, the system first ensures that the current level of the To Location element is the same as the current level of the From Location element. All levels of the element are then moved from the From Location to the To Location, and the From Location change history is appended to the To Location change history.

If you do not specify this option and differences exist between the current levels of the From Location element and the To Location element, these differences are combined and recorded as a new level in the To Location.

  • Enter Y to append From Location change history to To Location change history.
  • Enter N to combine ALL From Location change levels into one level to be moved into the To Location. This is the default value.
Retain Signout

This option tells CA Endevor SCM to retain the source location signouts for all elements at the target location. This option applies only if the element was signed out at the source before the TRANSFER.

  • If the element was signed out at the source before the TRANSFER, it will be signed out to that same ID at the target after the TRANSFER.
  • If the element was not signed out at the source before the TRANSFER, it will not be signed out at the target after the TRANSFER.
  • If you do not use this option, the element at the target location is not signed out, regardless of whether it was signed out at the target before the TRANSFER took place.
Signout To

This option tells CA Endevor SCM to sign all elements out to the specified user ID at the target stage.