Status Tables and Status Files

The Dispatcher maintains in memory a status table that records the hardware setup of a specific fax channel and the processing status of fax files directed to that channel. Using the information on the status table, a status file can be created on disk that checks the state of the fax channels in a multiple-channel chassis or in multiple-chassis systems. Real-time status information can be obtained, and applications capable of response in real time can be built, using the status information.

Each chassis has only one status table and only one status file. Each fax channel in a chassis is represented by only one record in the status table or status file. When the status table is used on the chassis in which the boards are installed, the table should be used with the function gfdReadStatusMem for faster operation. The status table in memory and the status file on disk are a collection of records, one for each fax channel. That is, a chassis with four fax channels will have four records.

The format of a status record is listed in Table 38.

Table 38. Status Record Fields

Field Name	Data Type	Description
cp_channel	int	The physical-channel number.
cp_name [32]	char	The modem_id of a fax channel.
cp_list	int	The internal-buffer list number for transactions addressed to this fax channel.
cp_state	int	Indicates the state of the fax channel. The states include "idle," "sending," "receive," "offline," "dead," "reset," and "failed."
cp_pass	int	Not used; reserved for future use.
capabilities	unsigned	Not used; reserved for future use.
ProgramFile [64]	char	Not used; reserved for future use.
ProgramOptions	unsigned	Not used; reserved for future use.
numOpenFiles	int	The number of files a fax channel has open.
cp_fid [8]	int	The system-file numbers for the files the fax channel has open. Unopened files have a 0 or -1 here.
LastFileName [64]	char	The filename of the last file that was successfully opened.
gfxStatus	int	The last gfxStatus returned by the fax channel.
gfxState	int	The last gfxState returned by the fax channel. See values in gfxstate.h.
country	int	The country code for the fax channel. (This information is requested on startup.)
gfxDebug	int	Not used; reserved for future use.
ActiveHandle	int	Contains the queue record handle for the transaction currently on the fax channel.
ActiveQueueId	long	Not used; reserved for future use.
LastUserId[32]	char	The user_id field for the transaction currently on the fax channel.
numSend	long	Counts the number of outgoing transactions the fax channel has processed since the Dispatcher was last restarted.
TotalSend	long	The number of outgoing transactions the fax channel has processed since the status file was last reset. This field is restored from the status file when status-file processing is enabled.
numReceive	long	Counts the number of incoming transactions the fax channel has processed since the Dispatcher was last restarted.
TotalReceive	long	Counts the number of incoming transactions the fax channel has processed since the status file was last reset. This field is restored from the status file when status-file processing is enabled.
numFailed	long	Counts the number of failed transactions the fax channel has processed since the Dispatcher was last restarted. Failed transactions are also counted in numSend or numReceive as appropriate.
TotalFailed	long	Counts the number of failed transactions that the fax channel has processed since the log file was last reset. This value is restored from the status file when status-file processing is enabled. Failed transactions also are counted in TotalSend or TotalReceive, as appropriate.
ItemsSent	long	Counts the number of items (pages) sent since the Dispatcher was last restarted.
itemsReceived	long	Counts the number of items (pages) received since the Dispatcher was last restarted.
ConnectSeconds	long	Counts the number of seconds the phone line has been off hook since the on-board software was last restarted.
LastSpeed	int	Records the speed at which the last transaction took place. This field may be useful for locating bad phone lines.
LastError	int	Not used; reserved for future use.

Click here to contact Dialogic Customer Engineering