API functions

Defines
#define	MSG_AP_FE_SEP   1750
#define	MSGS_ORIG   0x01
#define	MSGS_ISO   0x02
Functions
int	msgs_charcode (int code)
int	msgs_get (int condno, int *pano, char *buffer, int buflen, char *ident, int identlen)
int	msgs_fac (int facno, char *buffer, int buflen)
int	msgs_severity (int severityno, char *buffer, int buflen)
int	msgs_inf (int condno, int *facility, int *severity)

---

Define Documentation

#define MSG_AP_FE_SEP   1750

Facility number to seperate FE facilities from AP facilities. Any factility bigger than this value is considered to be AP facility, any facility less (if not system facility) is considered to FE facility.

---

Function Documentation

int msgs_charcode

(

int

code

)

Set char coding to retrieve text messages

Parameters:

code

MSGS_ORIG to get original coding, MSGS_ISO to get isolatin

Returns:

• 0: ok
• !0: error

int msgs_fac	(	int	facno,
		char *	buffer,
		int	buflen
	)

Writes facility text corresponding to facility-id to buffer with len buflen

Parameters:

	facno	facility number
	buffer	where the facility text is written to
	buflen	the length of supplied buffer

Returns:

• length of data written to buffer
• <0: error

int msgs_get	(	int	condno,
		int *	pano,
		char *	buffer,
		int	buflen,
		char *	ident,
		int	identlen
	)

Writes message corresponding to conditional value to buffer

Parameters:

	buffer	where message is written to
	buflen	the length of supplied buffer
	pano	where the number of fao arguments is written to

Returns:

• 0: ok
• !0: error

int msgs_inf	(	int	condno,
		int *	facility,
		int *	severity
	)

retrieves facility number and severity from conditional value

Parameters:

	condno	the conditional value
	facility	where the facility number is written to
	severity	where the severity number is written to

Returns:

• 0: ok
• !0: error

int msgs_severity	(	int	severityno,
		char *	buffer,
		int	buflen
	)

writes severity text corresponding to severity id to buffer

Parameters:

	severity	number
	buffer	where the severity text is written to
	buflen	the length of supplied buffer

Returns:

• length of data written to buffer
• <0: error

---