ANSI C, C++

#include <dcmcf.h> int dc_mcf_tdctcn (DCLONG action, dcmcf_tdctcnopt *cnopt, char *proinf, DCLONG *resv02, char *resv03, char *resv04)

K&R C

#include <dcmcf.h> int dc_mcf_tdctcn (action, cnopt, proinf, resv02, resv03, resv04) DCLONG action; dcmcf_tdctcnopt *cnopt; char *proinf; DCLONG *resv02; char *resv03; char *resv04;

The dc_mcf_tdctcn() function releases a connection.

Normal termination of the dc_mcf_tdctcn() function indicates that the connection release request was accepted successfully by the protocol product. However, this does not necessarily mean that the connection with the remote system has been released.

If you intend to perform any connection-related operation after calling the dc_mcf_tdctcn() function, first use the dc_mcf_tlscn() function to check the status of the connection.

action

Depending on the communication protocol, specify in one of the following formats the method used to specify for this function the connection that is released:

 
{DCMCFLE|DCMCFCN}[|DCMCFFRC][|DCMCFPRO]
 

DCMCFLE

Specifies that a logical terminal name is specified for the connection that is released.

This argument is not supported by TP1/NET/NCSB or TP1/NET/X25-Extended.

DCMCFCN

Specifies that a connection ID is specified for the connection that is released.

DCMCFFRC

Specifies that a connection is released forcibly.

DCMCFPRO

Specifies that the function depends on the communication protocol being used.

cnopt

Set in the dcmcf_tdctcnopt structure the connection information to be the subject of this function's processing.

The following shows the format of the structure:

 
typedef struct {
                DCLONG    mcfid;        ...MCF communication
                                           process identifier
                char      resv01[4];    ...Reserved
                char      idnam[9];     ...Logical terminal name
                                           or connection ID
                char      resv02[7];    ...Reserved
                char      resv03[112];  ...Reserved
                char      scnnam[9];    ...Area used by MCF
                char      resv04[7];    ...Reserved
                char      resv05[360];  ...Reserved
                } dcmcf_tdctcnopt;
 

• mcfid
  Specify the MCF communication process identifier of the MCF communication service for the connection to be processed. The permitted value range is from 0 to 239.
  This argument is ignored when a logical terminal name is used to request a connection release.
  If you specify 0, the system searches for the MCF communication service to which the specified connection ID belongs. In a configuration where many MCF communication services are running or when you issue this function many times from a UAP, we recommend that you specify the MCF communication process identifier.
  
• resv01
  Fill the area with null characters.
  
• idnam
  Specify the logical terminal name or connection ID of the connection to be released. The logical terminal name or connection ID must be specified as a maximum of 8 bytes of characters and must end with the null character.
  
• resv02, resv03, scnnam, resv04, resv05
  Fill the areas with null characters.
  

proinf

Specify a protocol-specific area.

If you do not use a function that depends on the communication protocol, specify NULL.

The following shows the format of a protocol-specific area:

The maximum size of a protocol-specific area is 1024 bytes.

The permitted value depends on the communication protocol being used. For details, see the applicable OpenTP1 Protocol manual.

resv02, resv03, resv04

Specify NULL.

Return value	Return value (numeric)	Explanation
DCMCFRTN_00000	0	Normal termination.
DCMCFRTN_71001	-12001	The dc_mcf_tdctcn() function cannot be accepted because the MCF is under start processing.
DCMCFRTN_71002	-12002	The dc_mcf_tdctcn() function cannot be accepted because the MCF is under termination processing.
DCMCFRTN_71004	-12004	A memory shortage occurred during dc_mcf_tdctcn() 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_71007	-12007	The specified connection name has not been registered.
DCMCFRTN_71008	-12008	The specified logical terminal name has not been registered.
DCMCFRTN_71009	-12009	The dc_mcf_tdctcn() function is not supported by the applicable MCF communication process.
DCMCFRTN_71010	-12010	Although the request to release the connection was issued to the MCF communication process, the request was not accepted. For the cause, see the message log file.
DCMCFRTN_71011	-12011	The dc_mcf_tdctcn() function cannot be accepted because the connection has been deleted.
DCMCFRTN_71014	-12014	The specified logical terminal name belongs to TP1/NET/NCSB or TP1/NET/X25-Extended; or, the specified connection group name belongs to TP1/NET/OSI-TP or TP1/NET/TCP/IP.
DCMCFRTN_72050	-13050	An unsupported flag is set in action.
DCMCFRTN_72051	-13051	NULL is set in cnopt.
DCMCFRTN_72052	-13052	When DCMCFPRO is not set in action: NULL is not set in proinf.
		When DCMCFPRO is set in action: A value smaller than 0 or a value 1025 or greater is specified for the size of protocol-specific area L pointed to by proinf.
DCMCFRTN_72053	-13053	NULL is not set in resv02.
DCMCFRTN_72054	-13054	NULL is not set in resv03.
DCMCFRTN_72055	-13055	NULL is not set in resv04.
DCMCFRTN_72060	-13060	DCMCFLE and DCMCFCN cannot be specified together in action.
DCMCFRTN_72061	-13061	A value smaller than 0 or a value 240 or greater is specified for mcfid in dcmcf_tdctcnopt.
DCMCFRTN_72062	-13062	resv01 in dcmcf_tdctcnopt is not filled with null characters.
DCMCFRTN_72063	-13063	idnam in dcmcf_tdctcnopt begins with the null character.
DCMCFRTN_72064	-13064	resv02 in dcmcf_tdctcnopt is not filled with null characters.
DCMCFRTN_72065	-13065	resv03 in dcmcf_tdctcnopt is not filled with null characters.
DCMCFRTN_72066	-13066	scnnam in dcmcf_tdctcnopt is not filled with null characters.
DCMCFRTN_72067	-13067	resv04 in dcmcf_tdctcnopt is not filled with null characters.
DCMCFRTN_72069	-13069	resv05 in dcmcf_tdctcnopt is not filled with null characters.
DCMCFRTN_72073	-13073	The character string set in idnam in dcmcf_tdctcnopt is 9 or more bytes in length.
DCMCFRTN_72074	-13074	The character string set in idnam in dcmcf_tdctcnopt contains an invalid character.