dc_mcf_tlscom - Acquire the status of MCF communication services

Format

ANSI C, C++

#include <dcmcf.h>
int dc_mcf_tlscom (DCLONG action, char *resv01, DCLONG *infcnt,
dcmcf_svinf *inf, char *resv02)

K&R C

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

Description

The dc_mcf_tlscom() function acquires the statuses of the MCF communication services or application start services.

Arguments whose values are set in the UAP

action

Specify DCNOFLAGS.

resv01

Specify NULL.

infcnt

Specify the number of dcmcf_svinf areas used to store the statuses of the MCF communication services or application start services.

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

inf

Specify the dcmcf_svinf area used to store the statuses of the MCF communication services or application start services.

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

resv02

Specify NULL.

Arguments whose values are returned from OpenTP1

infcnt

Returns the number of application start services or MCF communication services that have been registered in the MCF service.

inf

Returns the dcmcf_svinf structure that contains information about the application start services or MCF communication services registered in the MCF service.

The following shows the format of the structure:

typedef struct {
               DCLONG    mcfid;       ...MCF communication
                                         process identifier or
                                         Application start
                                         process identifier
               char      svname[9];   ...MCF communication
                                         service name
               char      resv01[7];   ...Reserved
               char      pnam[20];    ...Protocol type
               DCLONG    status;      ...Status of MCF
                                         communication service
               char      resv02[20];  ...Reserved
               } dcmcf_svinf;

Return values

Return valueReturn value (numeric)Explanation
DCMCFRTN_000000Normal termination.
DCMCFRTN_71001-12001The dc_mcf_tlscom() function cannot be accepted because the MCF is under start processing.
DCMCFRTN_71004-12004A memory shortage occurred during dc_mcf_tlscom() 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_72013-13013The number of MCF communication services or application start services exceeded the value specified in infcnt. Information about the excess services was discarded.
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_72076-13076A value of 0 or smaller is set in infcnt.