mms_ms.h

ICCP Toolkit 是在 Tru64下开发Tase.2通信协议的开发包

/************************************************************************/
/* SISCO SOFTWARE MODULE HEADER *****************************************/
/************************************************************************/
/*   (c) Copyright Systems Integration Specialists Company, Inc.,	*/
/*      	  1986 - 1997, All Rights Reserved.		        */
/*									*/
/* MODULE NAME : mms_ms.h						*/
/* PRODUCT(S)  : MMSEASE						*/
/*									*/
/* MODULE DESCRIPTION : 						*/
/*	This module contains definitions related to MMSEASE support	*/
/*	functions.							*/
/*									*/
/* MODIFICATION LOG :							*/
/*  Date     Who   Rev			Comments			*/
/* --------  ---  ------   -------------------------------------------	*/
/* 04/02/97  DTL   7.00    MMSEASE 7.0 release. See MODL70.DOC for	*/
/*			   history.					*/
/************************************************************************/

#ifndef MMS_MS_INCLUDED
#define MMS_MS_INCLUDED

#ifdef __cplusplus
extern "C" {
#endif

#include <stdio.h>
#include "mms_mp.h"

/************************************************************************/
/************************************************************************/
/* This function must be called before using MMS, initilizes variables	*/
/* then calls SUIC startup function.					*/

ST_RET strt_MMS (ST_VOID);
ST_RET end_MMS (ST_VOID);

/************************************************************************/
/* COMUNICATIONS SERVICE FUNCTIONS					*/
/* The functions below perform all required message handling services.	*/
/************************************************************************/
/************************************************************************/
/* This function is a general purpose service function, and may be used */
/* instead of calling the other service functions. It invokes all req'd */
/* service functions.							*/

ST_RET ms_comm_serve (ST_VOID);

/************************************************************************/
/* Function get messages from LLP and operate on them as required.	*/
/* Decodes all messages, puts them into indication que, sets confirms	*/
/* received, etc.							*/

ST_RET mms_llp_serve (ST_VOID);

/************************************************************************/
/* This function is to be called to service incoming indications, calls */
/* u_xxx_ind functions. Also invokes service functions on outstanding	*/
/* indications. 							*/

ST_RET mms_ind_serve (ST_VOID);

/* Set this variable SD_TRUE to allow unrestricted manipulation of 	*/
/* indications during service; not normally required.			*/
extern ST_BOOLEAN m_ind_serve_unrestricted;

/************************************************************************/
/* This function is used to check for confirms received, calls the	*/
/* u_xxxx_cfrm functions.						*/

ST_RET mms_conf_serve (ST_VOID);

/************************************************************************/
/* This function is used with applications that use the 'done_sem'	*/
/* feature of the MMSREQ_PEND structure. This function free's the 	*/
/* request control and it contents.					*/

ST_VOID ms_free_req_ctrl (MMSREQ_PEND *req_ptr);

/************************************************************************/
/************************************************************************/
/* This function is called to give a textual description of an error	*/
/* code									*/

ST_VOID ms_perror (ST_RET code);
ST_VOID ms_perror_log (FILE *fp, ST_RET code);
ST_VOID ms_perror_str (ST_CHAR *dest, ST_INT dest_len, ST_RET code);

/************************************************************************/
/************************************************************************/
/* This function is used to concatenate a list of strings referneced by */
/* the fname member of the file_name structure.  The value returned is  */
/* the total length of the resulting string.				*/

ST_INT ms_fname_cat (FILE_NAME *fn, ST_INT num_fn, 
			ST_CHAR *dest, ST_INT dest_len);

/************************************************************************/
/* REQUEST & INDICATION PENDING COUNT FUNCTIONS				*/
/************************************************************************/

ST_INT ms_count_ind_pend (ST_INT chan);
ST_INT ms_count_req_pend (ST_INT chan);

/************************************************************************/
/* Function for checking the service set.				*/
/************************************************************************/

ST_VOID ms_service_check (ST_INT chan, ST_INT service, 
                      ST_BOOLEAN *req_supported, 
                      ST_BOOLEAN *resp_supported);

#ifdef __cplusplus
}
#endif

#endif		/* MMS_MS_INCLUDED  */