dc_mcf_adltap - Delete an application timer start request

Format

ANSI C, C++

#include <dcmcf.h>
int dc_mcf_adltap (DCLONG action, dcmcf_adltapopt *apopt,
char *resv01, DCLONG *resv02,
char *resv03, char *resv04)

K&R C

#include <dcmcf.h>
int dc_mcf_adltap (action, apopt, resv01, resv02, resv03, resv04)
DCLONG action;
dcmcf_adltapopt *apopt;
char *resv01;
DCLONG *resv02;
char *resv03;
char *resv04;

Description

The function dc_mcf_adltap() deletes a specified application timer start request and cancels startup of the application. Note that this function cannot delete application timer start requests of the ans and cont types.

Arguments whose values are set in the UAP

action

Specify DCMCFAP to indicate that an application name is to be specified.

apopt

Set in a dcmcf_adltapopt structure the connection information that is to be the subject of this function's processing.

The following shows the format of the structure:

typedef struct {
               DCLONG    mcfid;        ...Application start
                                          process identifier
               char      resv01[4];    ...Reserved
               char      idnam[9];     ...Application name
               char      resv02[7];    ...Reserved
               char      resv03[112];  ...Reserved
               char      resv04[376];  ...Reserved
               } dcmcf_adltapopt;

resv01, resv02, resv03, resv04

Specify NULL.

Return values

Return valueReturn value (numeric)Explanation
DCMCFRTN_000000Normal termination.
DCMCFRTN_71001-12001The dc_mcf_adltap() function cannot be accepted because the MCF is under start processing.
DCMCFRTN_71002-12002The dc_mcf_adltap() function cannot be accepted because the MCF is under termination processing.
DCMCFRTN_71004-12004A memory shortage occurred during dc_mcf_adltap() function processing.
DCMCFRTN_71005-12005A communication error occurred. For the cause, see the message log file.
DCMCFRTN_71006-12006An internal error occurred. For the cause, see the message log file.
DCMCFRTN_71007-12007The specified application name has not been registered.
No timer start request has been issued for the specified application name.
The specified application name belongs to an application whose type is inquiry-response or continuous-inquiry-response.
DCMCFRTN_71009-12009The dc_mcf_adltap() function is not supported by the applicable application start process.
DCMCFRTN_71010-12010Although the request to delete the specified application timer start request was issued, the request was not accepted. For the cause, see the message log file.
DCMCFRTN_72050-13050DCMCFAP is not specified in action.
An unsupported flag is set in action.
DCMCFRTN_72051-13051NULL is set in apopt.
DCMCFRTN_72052-13052NULL is not set in resv01.
DCMCFRTN_72053-13053NULL is not set in resv02.
DCMCFRTN_72054-13054NULL is not set in resv03.
DCMCFRTN_72055-13055NULL is not set in resv04.
DCMCFRTN_72061-13061A value of 0 or smaller or of 240 or greater is specified for mcfid in dcmcf_adltapopt.
DCMCFRTN_72062-13062resv01 in dcmcf_adltapopt is not filled with null characters.
DCMCFRTN_72063-13063idnam in dcmcf_adltapopt begins with the null character.
DCMCFRTN_72064-13064resv02 in dcmcf_adltapopt is not filled with null characters.
DCMCFRTN_72065-13065resv03 in dcmcf_adltapopt is not filled with null characters.
DCMCFRTN_72067-13067resv04 in dcmcf_adltapopt is not filled with null characters.
DCMCFRTN_72073-13073The character string set in idnam in dcmcf_adltapopt is 9 bytes or more in length.
DCMCFRTN_72074-13074The character string set in idnam in dcmcf_adltapopt contains an invalid character.