messgen - Compile message definition files to produce various include files

Function

Compile message definition files to produce various include files

Synopsis

     messgen [-cofpdtl] [-C cname] [-F fname] [-P pname]
             filename[.msg]

Description

This program compiles a message definition file. It is capable of producing include files defining constants for message codes in The C, Fortran and Pascal languages. Additionally, it can produce a message table, which can be supplied in a call to MessPutFacility() to make the message details available to calls to MessGetMsg().

The C lanaguage include files are bracketed in an #ifdef statement such that they are only included once.

Options

-c
Generate a C language include file which defines constants of the form "PrefixName", for each message. The definitions are written to the file "basename.h".
-C cname
As per -c, but the definitions are written to the file "basename.cname".
-f
Generate a Fortran language include file which defines constants of the form "PrefixName", for each message. The definitions are written to the file "basename.f" on unix machines and the file "basename.for" on VMS machines
-F cname
As per -f, but the definitions are written to the file "basename.fname".
-p
Generate a Pascal language include file which defines constants of the form "PrefixName", for each message. The definitions are written to the file "basename.pin".
-P cname
As per -p, but the definitions are written to the file "basename.pname".
-d
Generate a TCL language include file which defines variables of the form "PrefixName", for each message. The definitions are written to the file "basename.tcl".
-D dname
As per -p, but the definitions are written to the file "basename.dname".
-o
When writing include files, generate the symbol "PrefixOK", with a value of 0.
-t
Generate a message table which can be used when calling MessPutFacility. This is written to the file "basename_msgt.h"
-l
Log the opening of input and output files.

-j
Produce Java to the file "basename.java". Note, the class name will be "basename". The resulting class extends DramaStatus.
-J package
Produce java, but to be within the specified package. File is "basename".java. Note, the class name will be "basename". The resulting class extends DramaStatus.
-x filename
Specifies the output file name explicity. If used, only one output type can be selected.

basename is part after the last slash if any, minus the suffix ".msg" if it exists.

See Also

MessPutFacility(), MessGetMsg(), Vax/VMS message utility manual.

Support

Tony Farrell, AAO

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

 For more information, contact tony.farrell@mq.edu.au