luwControl in callLink element

The linkage options part, callLink element, property luwControl specifies whether the caller or called program controls the unit of work. This property is applicable only in the following situation:

• The value of property type is remoteCall; and

• You are generating a Java program or wrapper--
  • If you are generating a Java program, property pgmName refers to a CICS-based program that is called by the program being generated

  • If you are generating a Java wrapper, pgmName refers to a CICS-based program that is called by way of the Java wrapper

Select one of the following values:

CLIENT

Specifies that the unit of work is under the caller's control. Updates by the called program are not committed or rolled back until the caller requests commit or rollback. If the called program issues a commit or rollback, a run-time error occurs.

CLIENT is the default value, unless a caller-controlled unit of work is not supported on the platform where the called program resides.

CLIENT is available if the caller is a Java wrapper or program that communicates with an iSeries-based COBOL program by way of the IBM Toolbox for Java. In this case, the value of remoteComType for the call is JAVA400.

SERVER

Specifies that a unit of work started by the called program is independent of any unit of work controlled by the calling program. In the called program, these rules apply:

• The first change to a recoverable resource begins a unit of work

• Use of the system functions sysLib.commit and sysLib.rollback are valid

On a call from EGL-generated Java code to a VisualAge Generator COBOL program, a commit (or rollback on abnormal termination) is issued automatically when the called program returns. That command affects only the changes that were made by the called program.

When the property type is ejbCall, the run-time behavior is as described for SERVER.

Related concepts
Linkage options part
Logical unit of work

Related tasks
Editing the callLink element of a linkage options part

Related reference
callLink element
sysLib.commit
sysLib.rollback
pgmName in callLink element
type in callLink element