DulReadFacility - Reads a message facility table (_msgt.h) file

Function

Reads a message facility table (_msgt.h) file and dynamically adds the facility to the current program.

Description

The message facility table file is a C include file is generated by the messgen program and defines a couple of structures which are normally passed directly to MessPutFacility. This normally means all facilities must be known at compile type. This function reads such an include file and creates the required structures dynamically. It then makes this facility known using MessPutFacility This allows facilities not known at compile time to be added.

Language

Call

(void) = DulReadFacility (filename, status)

Parameters

(">" input, "!" modified, "W" workspace, "<" output)

>	filename	const char `*`	Name of the message facility table file.
>	status	StatusType `*`	Modified status

Include File

dul.h

External functions used

MessPutFacility	Mess	Put a facility
ErsRep	Ers	Report an error
strlen	Crtl	return the length of a string
strcpy	Crtl	copy one string to another
malloc	Crtl	allocate memory
fopen	Crtl	Open a file
fgets	Crtl	Read a line from a file
ftell	Crtl	Return the current position in a file
fseek	Crtl	Goto a positon in a file
fclose	Crtl	Close a file

Support

Tony Farrell, AAO

Click here for the DRAMA home page and here for the AAO home page.

For more information, contact tjf@aaoepp.aao.gov.au