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.

8 9

Page 113
Image 113
NDC comm CompuFax user manual Look UP, Close, Shutdown, This sends a shutdown message to the database application