89
name: message
type: unsigned long
access: write only
mec hani sm: b y refe renc e
On succe ssfu l com plet ion , th is con tain s t he m essage o bjec t th at will b e p assed to the oth er f db_ functions.
On failu re this is 0.
Return Value:
The status o f t h e operation is retur n ed 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 LOOKUP
The first menu option is used to send a lookup request to the database application. The user enters a stream
ID. T his is num b er from 1 - 20. If it iden t ifies a stream t hat is no t curren tly open, then th is reques t will result
in a new stream for t h e database.
If it ide ntif ies a st ream th at is o pen th is will no t b e a n ew str eam f or t he d ata base a pp licatio n. A str eam is
open if a request has been issued on it and neither the database application or TESTDB has closed it. After
the stream ID, t he u ser en ter s th e looku p key that is to be sen t t o t he ap plication . T hen th e us er 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.