Locate Mode - Call-Level Interface Version 2

Locate Mode

Usage Notes

The Locate Mode field specifies where the data returned is to be made available.

Language	Variable Name
COBOL:	DBCAREA-LOC-MODE
C: DBCAREA.H:	loc_mode

Routine	Action Taken
DBCHINI:	writes
DBCHCL:	reads (CON; RSUP: IRQ)

Used by	Action Taken
application program	writes

Locate Mode is initialized by DBCHINI to the default value provided for Locate Mode in the site’s SPB.

If the value provided is not appropriate for the application, before calling DBCHCL for the Connect, Run Startup, or Initiate Request function, the application program may set:

Change Options to Y, and

Locate Mode to:

Y, if the data returned is to be made available in the response buffer.

N, if the data returned is to be made available in the Move area.

A Locate Mode of Y is known as Locate Node. A Locate Mode of N, with Parcel Mode Fetch of Y, is known as Move Mode. (Locate Mode operates in conjunction with Parcel Mode Fetch.)

The setting of Locate Mode affects the use of Fetch Maximum Data Length, Fetch Data Pointer, Fetch Returned Data Length, Fetch Parcel Flavor, and Fetch Error Indicator.

Do not set both Variable Length Fetch and Locate Mode to Y.