OpenTP1 Version 7 Programming Reference C Language

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

dc_mcf_tlsln - Acquire the acceptance status for a server-type connection establishment request

Format

ANSI C, C++

#include <dcmcf.h>
int dc_mcf_tlsln (DCLONG action, DCLONG mcfid, char *resv01,
DCLONG *infcnt, dcmcf_lninf *inf, char *resv02)

K&R C

#include <dcmcf.h>
int dc_mcf_tlsln (action, mcfid, resv01, infcnt, inf, resv02)
DCLONG action;
DCLONG mcfid;
char *resv01;
DCLONG *infcnt;
dcmcf_lninf *inf;
char *resv02;

Description

The dc_mcf_tlsln() function acquires the acceptance status for a server-type connection establishment request.

Arguments whose values are set in the UAP

action

Set DCNOFLAGS.

mcfid

Specify the MCF communication process identifier of the MCF communication service that is to be processed. The permitted value range is from 1 to 239.

resv01

Specify NULL.

infcnt

Specify 1 as the number of dcmcf_lninf areas to be used to store the acceptance status of the server-type connection establishment request.

When the processing is completed, the number of corresponding MCF communication services is returned.

inf

Specify a dcmcf_lninf area to be used to store the acceptance status of the server-type connection establishment request.

The size of this area must be at least the size of the dcmcf_lninf structure x infcnt.

resv02

Specify NULL.

Arguments whose values are returned from OpenTP1

infcnt

Returns the number of MCF communication services that were processed by this function.

inf

Returns the dcmcf_lninf structure containing the acceptance status of the server-type connection establishment request for the MCF communication service that was processed by this function.

The following shows the format of the structure:

 
typedef struct {
                DCLONG    status;       ...Acceptance status
                char      resv01[60];   ...Reserved
                } dcmcf_lninf;
 

Legend:
Y: Can be used
N: Cannot be used

Return values

Return value Return value (numeric) Explanation
DCMCFRTN_00000 0 Normal termination.
DCMCFRTN_71001 -12001 The dc_mcf_tlsln() function cannot be accepted because the MCF is under start processing.
DCMCFRTN_71002 -12002 The dc_mcf_tlsln() function cannot be accepted because the MCF is under termination processing.
DCMCFRTN_71004 -12004 A memory shortage occurred during dc_mcf_tlsln() function processing.
DCMCFRTN_71005 -12005 A communication error occurred. For the cause, see the message log file.
DCMCFRTN_71006 -12006 An internal error occurred. For the cause, see the message log file.
DCMCFRTN_71009 -12009 The dc_mcf_tlsln() function is not supported by the applicable MCF communication process.
DCMCFRTN_71010 -12010 Although the request to acquire the acceptance status of the server-type connection establishment request was issued to the MCF communication process, the request was not accepted. For the cause, see the message log file.
DCMCFRTN_72050 -13050 DCNOFLAGS is not set in action.
DCMCFRTN_72052 -13052 NULL is not set in resv01.
DCMCFRTN_72053 -13053 NULL is not set in resv02.
DCMCFRTN_72056 -13056 NULL is set in infcnt.
DCMCFRTN_72057 -13057 NULL is set in inf.
DCMCFRTN_72061 -13061 A value of 0 or smaller or of 240 or greater is specified for mcfid.
DCMCFRTN_72076 -13076 The value 1 is not set in infcnt.