15.10 - Request Mode - Call-Level Interface Version 2

Teradata Call-Level Interface Version 2 Reference for Mainframe-Attached Systems

prodname
Call-Level Interface Version 2
vrm_release
15.10
category
Programming Reference
featnum
B035-2417-035K

Request Mode is a one byte field that specifies the form that a request and optional data are passed from the application to CLIv2.

 

In this language...

The variable name for Request Mode is ...

COBOL

DBCAREA‑REQUEST‑MODE

PL/I

REQUEST_MODE

C

request_mode

IBM Assembler

DBOQMOD

 

This routine...

Does this for Request Mode...

DBCHINI

writes

DBCHCL

reads (CON; RSUP; IEPF; CRQ)

 

Request Mode is used by

To...

applications

write

Request Mode is initialized to the default value provided for Request Mode (IBOQMOD) in the HSHSPB.

When the value for Request Mode is not appropriate for the application, you should perform the following procedure before calling DBCHCL for the Initiate Request function:

1 Set Change Options to ‘Y‘.

2 Change the value for Request Mode as follows.

 

If the application is passing to CLIv2...

Then change the value for Request Mode to...

the Request parcel body and, optionally, the Using Data parcel body and parcel elements in a DBCAREA extension

P

a pre‑built buffer containing parcels

B

Use mnemonics for the codes. Mnemonics are provided in the language definition file for the DBCAREA.

An application that uses Buffer Mode is responsible for setting the Keep Response option and Response Buffer Size options consistent with the response parcel provided in the pre‑built request buffer. If any of the request parcels have the alternate parcel header then any of the response parcels may also have the alternate header. If the response requires use of the alternate header because the size of the parcel body will exceed 65535 bytes, then at least one of the request parcels built by the application must use the alternate header.

Note: The parcels included are sent to the Teradata Database. The application is responsible for building the parcel as demanded by the protocol being used.

This option is used by some of the defined protocols of Teradata, such as FastLoad, Hut, and MultiLoad. It is not recommended for use in Teradata sessions.

Variable Length Request Mode is supported with Buffer Mode Request Mode.

Request Mode is read by the call to DBCHCL for the connect and runstartup options and stored in the appropriate control blocks, but it is not used during either function.