OSI/AS Programming Manual

ManualsBrandsHP ManualsServerHP NonStop G-Series

181

182

183

184

185

186

187

188

189

190

APS_TYPEDDATA_REQ_

APS Procedure Calls

3–106 056783 Tandem Computers Incorporated

data-operation

input

INT:value

is an optional parameter that determines how the user data is to be sent. You can

send the data in a single procedure call or in a series of calls. The following values

are acceptable for this parameter:

ZAPS-VAL-DATA-MORE

ZAPS-VAL-DATA-ABORT

ZAPS-VAL-DATA-NOVALUE

If you do not supply this parameter or if you specify ZAPS-VAL-DATA-

NOVALUE, the API sends data to the TAPS process and ends the primitive. For a

nowait connection, call MFM_AWAITIOX_ to complete the procedure.

Use the value ZAPS-VAL-DATA-MORE to indicate that there is more data to

send. When you use ZAPS-VAL-DATA-MORE, the API sends data to the TAPS

process and does not end the primitive. Call the procedure without providing the

data-operation

parameter (or set

data-operation

to ZAPS-VAL-DATA-

NOVALUE) to send the last piece of data and end the primitive. For a nowait

connection, call MFM_AWAITIOX_ to complete the procedure.

Use the value ZAPS-VAL-DATA-ABORT to indicate that the primitive is to be

ended abruptly in these two situations:

If you have canceled the primitive by calling MFM_CANCELREQ_ , the

primitive may or may not have completed. Use ZAPS-VAL-DATA-ABORT to

make sure that OSI/AS completes the primitive. If you do not abort the typed

data request, OSI/AS returns the error condition ZAPS-ERR-PRIMITIVE-

UNFINISHED if you attempt to start another primitive.

If you receive an error condition after you have successfully begun the

primitive, you should either abort (set the value to ZAPS-VAL-DATA-

ABORT) or end the primitive (send no data and set the value to ZAPS-VAL-

DATA-NOVALUE). These actions are preferable to sending more data, since

it is unknown how much data was sent. OSI/AS considers a primitive to be

successfully begun after the procedure has succeeded at least once when

data-operation

is set to ZAPS-VAL-DATA-MORE.

When you use ZAPS-VAL-DATA-ABORT, the

user-data

parameter is not

required and is ignored if it is present.