EGL Reference Guide for iSeries

transferToProgram element

A transferToProgram element of a linkage options part specifies how a generated COBOL program transfers control and ends processing.

The element includes these properties:

You can avoid specifying a transferToProgram element when the target program is generated with VisualAge Generator or (in the absence of an alias) with EGL.


Related concepts
Linkage options part
Run unit


Related tasks
Adding a linkage options part
Editing the transfer-related elements of a linkage options part


Related reference
alias in transfer-related linkage elements
fromPgm in transferToProgram element
linkType in transferToProgram element
toPgm in transfer-related linkage elements

fromPgm in transferToProgram element

The linkage options part, transferToProgram element, property fromPgm specifies the name of a program part:

The value of the fromPgm property is required and cannot include an asterisk (*).


Related concepts
Linkage options part
Run unit


Related tasks
Adding a linkage options part
Editing the transfer-related elements of a linkage options part


Related reference
toPgm in transfer-related linkage elements
transfer
transferToProgram element
linkType in transferToProgram element

linkType in transferToProgram element

The linkage options part, transferToProgram element, property linkType specifies the type of linkage to generate in relation to a transfer statement of type transfer to program. Valid values are as follows:

Dynamic (the default)
In programs that run on CICS for z/OS, an XCTL implements the transfer statement. In programs that run on z/OS outside of CICS, a dynamic COBOL call is generated in the first program in the run unit, and the EGL run-time handles processing so that the transfer simulates the behavior of a CICS-based program.

The target program is assumed to be produced by EGL or by VisualAge Generator.

Static
In programs that run on CICS for z/OS, an XCTL implements the transfer statement. In programs that run on z/OS outside of CICS, the following statements apply:

The target program is assumed to be produced by EGL or by VisualAge Generator.

ExternallyDefined
Specify the value ExternallyDefined if you are transferring to a program that was not produced by EGL or VisualAge Generator. In all COBOL target systems, an XCTL implements the transfer statement.

If the program property VAGCompatibility is set to yes, you can specify ExternallyDefined in the transfer statement, as noted in Compatibility with VisualAge Generator. It is recommended that the value be specified in the transferToProgram element instead, but the value is in effect if specified in either place.


Related concepts
Compatibility with VisualAge Generator
Linkage options part


Related tasks
Adding a linkage options part
Editing the transfer-related elements of a linkage options part


Related reference
fromPgm in transferToProgram element
toPgm in transfer-related linkage elements
transfer
transferToProgram element

toPgm in transfer-related linkage elements

In the transfer-related elements of the linkage options part, the required property toPgm specifies the name of the program part (or of the non-EGL program) that receives control.

If the function word sysVar.transferName is specified as the target in a transfer statement, do not specify that system variable in the related toPgm property. Instead, specify the program name that will be in sysVar.transferName when the program runs.


Related concepts
Linkage options part


Related tasks
Adding a linkage options part
Editing the transfer-related elements of a linkage options part


Related reference
sysVar.transferName
transfer


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]