NDC comm CompuFax - Manual (Page 113)

8 9
name: message
type: unsigned long
access: write only
mechanism: by reference
On successful completion, this contains the message object that will be passed to the other fdb_ functions.
On failure this is 0.
Return Value:
The status of the operation is returned as a normal VMS status value.
10.1.4 TESTDB.EXE
This is a test program to allow database applications to be tested. It writes requests to the database and
displays the responses. This program is provided in executable form and is an interactive program which
would be run from a terminal.
This program should not be run while the CompuFax server is up. It simulates some of the activities of the
server and can confuse normal operations.
The TESTDB main menu contains the following options:
•
Issue lookup request
•
Close stream
•
Send shutdown
10.1.4.1 LOOK UP
The first menu option is used to send a lookup request to the database application. The user enters a stream
ID. This is number from 1 - 20. If it identifies a stream that is not currently open, then this request will result
in a new stream for the database.
If it identifies a stream that is open this will not be a new stream for the database application. A stream is
open if a request has been issued on it and neither the database application or TESTDB has closed it. After
the stream ID, the user enters the lookup key that is to be sent to the application. Then the user may specify
that the lookup is to be automatically reissued until the stream is closed. This option is particularly useful in
testing wildcard type operations.
10.1.4.2 CLOSE
This option issues a close stream message to the database. The stream ID to close is requested and should be
specified as a number that was previously used in a lookup request.
10.1.4.3 SHUTDOWN
This sends a shutdown message to the database application.