You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
288 lines
8.9 KiB
C
288 lines
8.9 KiB
C
1 year ago
|
/************************************************************************/
|
||
|
|
/* SISCO SOFTWARE MODULE HEADER *****************************************/
|
||
|
|
/************************************************************************/
|
||
|
|
/* (c) Copyright Systems Integration Specialists Company, Inc., */
|
||
|
|
/* 1986 - 1997, All Rights Reserved. */
|
||
|
|
/* */
|
||
|
|
/* MODULE NAME : mms_pprg.h */
|
||
|
|
/* PRODUCT(S) : MMSEASE, MMSEASE-LITE */
|
||
|
|
/* */
|
||
|
|
/* MODULE DESCRIPTION : */
|
||
|
|
/* This file has the data structures and function definitions */
|
||
|
|
/* required to interface with MMS program invocation management */
|
||
|
|
/* services at the primitive level. */
|
||
|
|
/* */
|
||
|
|
/* Parameters : In general, the first parameter is the channel */
|
||
|
|
/* that the request or response is to be sent over. */
|
||
|
|
/* For Responses, the second parameter is the Invoke */
|
||
|
|
/* ID to be used. The last parameter is used to pass */
|
||
|
|
/* operation specific information by pointer. */
|
||
|
|
/* */
|
||
|
|
/* Return */
|
||
|
|
/* Values : Request functions return a pointer to the pending */
|
||
|
|
/* request tracking structure, of type MMSREQ_PEND. */
|
||
|
|
/* In case of error, the pointer is returned == 0 */
|
||
|
|
/* and mms_op_err is written with the err code. */
|
||
|
|
/* Response functions return 0 if OK, else an error */
|
||
|
|
/* code. */
|
||
|
|
/* */
|
||
|
|
/* MODIFICATION LOG : */
|
||
|
|
/* Date Who Rev Comments */
|
||
|
|
/* -------- --- ------ ------------------------------------------- */
|
||
|
|
/* 08/14/97 RKR 02 Format changes */
|
||
|
|
/* 06/09/97 MDE 01 Added PI State defines (from mms_vprg.h) */
|
||
|
|
/* 04/02/97 DTL 7.00 MMSEASE 7.0 release. See MODL70.DOC for */
|
||
|
|
/* history. */
|
||
|
|
/************************************************************************/
|
||
|
|
|
||
|
|
#ifndef MMS_PPRG_INCLUDED
|
||
|
|
#define MMS_PPRG_INCLUDED
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C" {
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/************************************************************************/
|
||
|
|
/************************************************************************/
|
||
|
|
/* PROGRAM INVOCATION MANAGEMENT SERVICES */
|
||
|
|
/************************************************************************/
|
||
|
|
/* The structures below are used to pass PROGRAM INVOCATION MANAGEMENT */
|
||
|
|
/* information to/from the MMS primitives. */
|
||
|
|
/************************************************************************/
|
||
|
|
/* use these defines to determine whether string is simple or encoded */
|
||
|
|
/* If encoded, the data pointer points to a complete ASN.1 EXTERNAL */
|
||
|
|
|
||
|
|
#define ARG_TYPE_SIMPLE 0
|
||
|
|
#define ARG_TYPE_ENCODED 1
|
||
|
|
|
||
|
|
/************************************************************************/
|
||
|
|
/* CREATE PROGRAM INVOCATION */
|
||
|
|
/************************************************************************/
|
||
|
|
|
||
|
|
/* REQUEST : */
|
||
|
|
|
||
|
|
struct crepi_req_info
|
||
|
|
{
|
||
|
|
ST_CHAR piname [MAX_IDENT_LEN+1]; /* program invocation name */
|
||
|
|
ST_INT num_of_dnames; /* number of domain names */
|
||
|
|
ST_BOOLEAN reusable;
|
||
|
|
ST_BOOLEAN monitor_pres; /* monitoring present */
|
||
|
|
ST_BOOLEAN monitor; /* SD_TRUE : permanent monitoring */
|
||
|
|
/* SD_FALSE: current monitoring */
|
||
|
|
|
||
|
|
/* list of ptrs to domain names */
|
||
|
|
/* ST_CHAR *dnames_list [num_of_dnames]; */
|
||
|
|
SD_END_STRUCT
|
||
|
|
};
|
||
|
|
typedef struct crepi_req_info CREPI_REQ_INFO;
|
||
|
|
|
||
|
|
/* RESPONSE : NULL */
|
||
|
|
|
||
|
|
#ifndef MMS_LITE
|
||
|
|
MMSREQ_PEND *mp_crepi (ST_INT chan, CREPI_REQ_INFO *info);
|
||
|
|
ST_RET mp_crepi_resp (MMSREQ_IND *ind);
|
||
|
|
#else
|
||
|
|
ST_RET mpl_crepi (CREPI_REQ_INFO *info);
|
||
|
|
ST_RET mpl_crepi_resp (ST_UINT32 invoke);
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/************************************************************************/
|
||
|
|
/* DELETE PROGRAM INVOCATION */
|
||
|
|
/************************************************************************/
|
||
|
|
|
||
|
|
/* REQUEST : */
|
||
|
|
|
||
|
|
struct delpi_req_info
|
||
|
|
{
|
||
|
|
ST_CHAR piname [MAX_IDENT_LEN+1]; /* program invocation name */
|
||
|
|
};
|
||
|
|
typedef struct delpi_req_info DELPI_REQ_INFO;
|
||
|
|
|
||
|
|
/* RESPONSE : NULL */
|
||
|
|
|
||
|
|
#ifndef MMS_LITE
|
||
|
|
MMSREQ_PEND *mp_delpi (ST_INT chan, DELPI_REQ_INFO *info);
|
||
|
|
ST_RET mp_delpi_resp (MMSREQ_IND *ind);
|
||
|
|
#else
|
||
|
|
ST_RET mpl_delpi (DELPI_REQ_INFO *info);
|
||
|
|
ST_RET mpl_delpi_resp (ST_UINT32 invoke);
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/************************************************************************/
|
||
|
|
/* START */
|
||
|
|
/************************************************************************/
|
||
|
|
|
||
|
|
/* REQUEST : */
|
||
|
|
|
||
|
|
struct start_req_info
|
||
|
|
{
|
||
|
|
ST_CHAR piname [MAX_IDENT_LEN+1]; /* program invocation name */
|
||
|
|
|
||
|
|
ST_INT16 start_arg_type; /* start argument present */
|
||
|
|
ST_BOOLEAN start_arg_pres; /* start argument present */
|
||
|
|
ST_INT start_arg_len; /* Only used for ENCODED */
|
||
|
|
ST_UCHAR *start_arg; /* pointer to start argument */
|
||
|
|
SD_END_STRUCT
|
||
|
|
};
|
||
|
|
typedef struct start_req_info START_REQ_INFO;
|
||
|
|
|
||
|
|
/* RESPONSE : NULL */
|
||
|
|
|
||
|
|
#ifndef MMS_LITE
|
||
|
|
MMSREQ_PEND *mp_start (ST_INT chan, START_REQ_INFO *info);
|
||
|
|
ST_RET mp_start_resp (MMSREQ_IND *ind);
|
||
|
|
#else
|
||
|
|
ST_RET mpl_start (START_REQ_INFO *info);
|
||
|
|
ST_RET mpl_start_resp (ST_UINT32 invoke);
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/************************************************************************/
|
||
|
|
/* STOP */
|
||
|
|
/************************************************************************/
|
||
|
|
|
||
|
|
/* REQUEST : */
|
||
|
|
|
||
|
|
struct stop_req_info
|
||
|
|
{
|
||
|
|
ST_CHAR piname [MAX_IDENT_LEN+1]; /* program invocation name */
|
||
|
|
};
|
||
|
|
typedef struct stop_req_info STOP_REQ_INFO;
|
||
|
|
|
||
|
|
/* RESPONSE : NULL */
|
||
|
|
|
||
|
|
#ifndef MMS_LITE
|
||
|
|
MMSREQ_PEND *mp_stop (ST_INT chan, STOP_REQ_INFO *info);
|
||
|
|
ST_RET mp_stop_resp (MMSREQ_IND *ind);
|
||
|
|
#else
|
||
|
|
ST_RET mpl_stop (STOP_REQ_INFO *info);
|
||
|
|
ST_RET mpl_stop_resp (ST_UINT32 invoke);
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/************************************************************************/
|
||
|
|
/* RESUME */
|
||
|
|
/************************************************************************/
|
||
|
|
|
||
|
|
/* REQUEST : */
|
||
|
|
|
||
|
|
struct resume_req_info
|
||
|
|
{
|
||
|
|
ST_CHAR piname [MAX_IDENT_LEN+1]; /* program invocation name */
|
||
|
|
|
||
|
|
ST_INT16 resume_arg_type; /* resume argument present */
|
||
|
|
ST_BOOLEAN resume_arg_pres; /* resume argument present */
|
||
|
|
ST_INT resume_arg_len; /* Only used for ENCODED */
|
||
|
|
ST_UCHAR *resume_arg; /* pointer to resume argument */
|
||
|
|
};
|
||
|
|
typedef struct resume_req_info RESUME_REQ_INFO;
|
||
|
|
|
||
|
|
/* RESPONSE : NULL */
|
||
|
|
|
||
|
|
#ifndef MMS_LITE
|
||
|
|
MMSREQ_PEND *mp_resume (ST_INT chan, RESUME_REQ_INFO *info);
|
||
|
|
ST_RET mp_resume_resp (MMSREQ_IND *ind);
|
||
|
|
#else
|
||
|
|
ST_RET mpl_resume (RESUME_REQ_INFO *info);
|
||
|
|
ST_RET mpl_resume_resp (ST_UINT32 invoke);
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/************************************************************************/
|
||
|
|
/* RESET */
|
||
|
|
/************************************************************************/
|
||
|
|
|
||
|
|
/* REQUEST : */
|
||
|
|
|
||
|
|
struct reset_req_info
|
||
|
|
{
|
||
|
|
ST_CHAR piname [MAX_IDENT_LEN+1]; /* program invocation name */
|
||
|
|
};
|
||
|
|
typedef struct reset_req_info RESET_REQ_INFO;
|
||
|
|
|
||
|
|
/* RESPONSE : NULL */
|
||
|
|
|
||
|
|
#ifndef MMS_LITE
|
||
|
|
MMSREQ_PEND *mp_reset (ST_INT chan, RESET_REQ_INFO *info);
|
||
|
|
ST_RET mp_reset_resp (MMSREQ_IND *ind);
|
||
|
|
#else
|
||
|
|
ST_RET mpl_reset (RESET_REQ_INFO *info);
|
||
|
|
ST_RET mpl_reset_resp (ST_UINT32 invoke);
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/************************************************************************/
|
||
|
|
/* KILL */
|
||
|
|
/************************************************************************/
|
||
|
|
|
||
|
|
/* REQUEST : */
|
||
|
|
|
||
|
|
struct kill_req_info
|
||
|
|
{
|
||
|
|
ST_CHAR piname [MAX_IDENT_LEN+1]; /* program invocation name */
|
||
|
|
};
|
||
|
|
typedef struct kill_req_info KILL_REQ_INFO;
|
||
|
|
|
||
|
|
/* RESPONSE : NULL */
|
||
|
|
|
||
|
|
#ifndef MMS_LITE
|
||
|
|
MMSREQ_PEND *mp_kill (ST_INT chan, KILL_REQ_INFO *info);
|
||
|
|
ST_RET mp_kill_resp (MMSREQ_IND *ind);
|
||
|
|
#else
|
||
|
|
ST_RET mpl_kill (KILL_REQ_INFO *info);
|
||
|
|
ST_RET mpl_kill_resp (ST_UINT32 invoke);
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/************************************************************************/
|
||
|
|
/* GET PROGRAM INVOCATION ATTRIBUTE */
|
||
|
|
/************************************************************************/
|
||
|
|
|
||
|
|
#define PI_NON_EXISTENT 0
|
||
|
|
#define PI_UNRUNNABLE 1
|
||
|
|
#define PI_IDLE 2
|
||
|
|
#define PI_RUNNING 3
|
||
|
|
#define PI_STOPPED 4
|
||
|
|
#define PI_STARTING 5
|
||
|
|
#define PI_STOPPING 6
|
||
|
|
#define PI_RESUMING 7
|
||
|
|
#define PI_RESETTING 8
|
||
|
|
|
||
|
|
/* REQUEST : */
|
||
|
|
|
||
|
|
struct getpi_req_info
|
||
|
|
{
|
||
|
|
ST_CHAR piname [MAX_IDENT_LEN+1]; /* program invocation name */
|
||
|
|
};
|
||
|
|
typedef struct getpi_req_info GETPI_REQ_INFO;
|
||
|
|
|
||
|
|
/* RESPONSE : */
|
||
|
|
|
||
|
|
struct getpi_resp_info
|
||
|
|
{
|
||
|
|
ST_INT16 state; /* program invocation state */
|
||
|
|
ST_BOOLEAN mms_deletable; /* MMS deletable */
|
||
|
|
ST_BOOLEAN reusable; /* Reusable */
|
||
|
|
ST_BOOLEAN monitor; /* SD_TRUE : permanent monitoring */
|
||
|
|
/* SD_FALSE: current monitoring */
|
||
|
|
|
||
|
|
ST_INT16 start_arg_type; /* start argument present */
|
||
|
|
ST_INT start_arg_len; /* Only used for ENCODED */
|
||
|
|
ST_UCHAR *start_arg; /* pointer to start argument */
|
||
|
|
|
||
|
|
ST_INT num_of_dnames; /* number of domain names */
|
||
|
|
/* list of ptrs to domain names */
|
||
|
|
/* ST_CHAR *dnames_list [num_of_dnames]; */
|
||
|
|
SD_END_STRUCT
|
||
|
|
};
|
||
|
|
typedef struct getpi_resp_info GETPI_RESP_INFO;
|
||
|
|
|
||
|
|
#ifndef MMS_LITE
|
||
|
|
MMSREQ_PEND *mp_getpi (ST_INT chan, GETPI_REQ_INFO *info);
|
||
|
|
ST_RET mp_getpi_resp (MMSREQ_IND *ind, GETPI_RESP_INFO *info);
|
||
|
|
#else
|
||
|
|
ST_RET mpl_getpi (GETPI_REQ_INFO *info);
|
||
|
|
ST_RET mpl_getpi_resp (ST_UINT32 invoke, GETPI_RESP_INFO *info);
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#endif /* #define MMS_PPRG_INCLUDED */
|