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;

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

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.

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;
 

• mcfid
  Sets an application start process identifier or MCF communication process identifier.
  
• svname
  Sets the MCF communication service name.
  
• resv01
  Fills the area with null characters.
  
• pnam
  Sets the protocol type.
  

  'MCF'

  Application start service for TP1/Message Control

  'UserAgent'

  TP1/NET/User Agent (OSAS/UA protocol)

  'HDLC'

  TP1/NET/HDLC (HDLC protocol)

  'X25'

  TP1/NET/X25 (X.25 protocol)

  'TP'

  TP1/NET/OSI-TP (OSI TP protocol)

  'XMAP3'

  TP1/NET/XMAP3

  'HSC'

  TP1/NET/HSC (HSC protocol)

  'NCSB'

  TP1/NET/NCSB (NCSB protocol)

  'OSAS-NIF'

  TP1/NET/OSAS-NIF (NIF/OSI protocol)

  'NET/SLUP2'

  TP1/NET/Secondary Logical Unit - TypeP2 (SLUTYPE-P protocol (secondary station))

  'TCP/IP'

  TP1/NET/TCP/IP (TCP/IP protocol)

  'X25-EX'

  TP1/NET/X25-Extended (X.25 protocol)

  'UDP/IP'

  TP1/NET/User Datagram Protocol (UDP protocol)

• status
  Sets one of the following values as the status of the MCF communication service or application start service:
  

  DCMCF_SVST_OFLN

  Service is stopped.

  DCMCF_SVST_START

  Service is under preparation processing.

  DCMCF_SVST_ONLN

  Service has started or is under preparation processing for termination.

  DCMCF_SVST_PREEND

  Service is under preparation processing for terminating partial stop.

  DCMCF_SVST_END

  Service is under stop processing.

• resv02
  Fills the area with null characters.
  

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