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 valueReturn value (numeric)Explanation
DCMCFRTN_000000Normal termination.
DCMCFRTN_71001-12001The dc_mcf_tlsln() function cannot be accepted because the MCF is under start processing.
DCMCFRTN_71002-12002The dc_mcf_tlsln() function cannot be accepted because the MCF is under termination processing.
DCMCFRTN_71004-12004A memory shortage occurred during dc_mcf_tlsln() 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_71009-12009The dc_mcf_tlsln() function is not supported by the applicable MCF communication process.
DCMCFRTN_71010-12010Although 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-13050DCNOFLAGS is not set in action.
DCMCFRTN_72052-13052NULL is not set in resv01.
DCMCFRTN_72053-13053NULL is not set in resv02.
DCMCFRTN_72056-13056NULL is set in infcnt.
DCMCFRTN_72057-13057NULL is set in inf.
DCMCFRTN_72061-13061A value of 0 or smaller or of 240 or greater is specified for mcfid.
DCMCFRTN_72076-13076The value 1 is not set in infcnt.