OpenTP1 Version 7 Programming Reference C Language
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;
Value of status | Library function availability | |
---|---|---|
dc_mcf_tonln() | dc_mcf_tofln() | |
DCMCF_LNST_LISTEN | N | Y |
DCMCF_LNST_RETRY | N | Y |
DCMCF_LNST_ONLN_W | Y | Y |
DCMCF_LNST_INIT | Y | N |
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. |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.