OpenTP1 Version 7 Programming Reference C Language

[Contents][Index][Back][Next]

dc_mcf_contend - Terminate continuous-inquiry-response processing

Format

ANSI C, C++

#include <dcmcf.h>
int  dc_mcf_contend(DCLONG action,char *resv01)

K&R C

#include <dcmcf.h>
int  dc_mcf_contend (action, resv01)
DCLONG   action;
char       *resv01;

Description

The function dc_mcf_contend() terminates continuous-inquiry-response processing. Before terminating continuous-inquiry-response processing, verify that nextap of the function dc_mcf_reply() called from the MHP is a null character and that the function dc_mcf_execap() for activating a cont-type MHP has not been called. If the MHP to be activated next is specified for nextap of the function dc_mcf_reply() or if the function dc_mcf_execap() for activating a cont-type MHP has been called, the function dc_mcf_contend() returns with an error.

After the function dc_mcf_contend() is called, the dc_mcf_tempget() function and the function dc_mcf_tempput() for accessing temporary-stored data cannot be called.

Arguments whose values are set in the UAP

action

Specify DCNOFLAGS.

resv01

Specify a null character.

Return values

Return value Return value (numeric) Explanation
DCMCFRTM_00000 0 Normal termination.
DCMCFRTN_72000 -13000

Return at MHP execution
The function dc_mcf_contend() was called out of sequence. The function dc_mcf_contend() was called before the function dc_mcf_receive() (for receiving the first segment) was called from the MHP.

Return at SPP execution
The function dc_mcf_contend() cannot be called from an SPP.
DCMCFRTN_72016 -13016

The value specified for action is invalid.
The value of the area pointed to by resv01 is not a null character.
DCMCFRTN_72101 -13101 The function dc_mcf_contend() was called from an MHP for which continuous-inquiry-response type (type=cont) was not specified in the MCF application definition.
DCMCFRTN_72107 -13107 The function dc_mcf_contend() was called.
DCMCFRTN_72111 -13111 The continuous-inquiry-response type application to be activated next was specified, a response message was sent (value specified for nextap of the function dc_mcf_reply()), then the function dc_mcf_contend() was called.
The function dc_mcf_execap() that specified the continuous-inquiry-response type application to be activated next was called, then the function dc_mcf_contend() was called.
Other than the above An unprecedented error (e.g., program damage) occurred.