NDC comm CompuFax User Manual

Page 112

Advertising
background image

8 8

This is the message object that was previously allocated with fdb_start_msg.
name: phone number
type: charactercoded text string
access: read only
mechanism: by descriptorfixed length string descriptor

The value of the phone number for this database record.

10.1.3.13 FDB_SET_STATUS

Used to set the value of the lookup status in a message that was previously allocated with fdb_start_msg. Use
of this function is optional. If the status value is not a success code (success has the low order bit set, failure
does not) then the requestor will close the database stream and will display the VMS message associated with
the status value.

If the status that is set is not a success, the match key, number and field values are ignored. If this function is
not used to set the status, a success status will be sent to the requestor.

Note: Returning a failure status does not automatically close the stream. If the user does not call
FDB_CLOSE for this stream a future call to FDB_GET will return a FDB$_CLOSE status.

Calling Sequence:
FDB_SET_STATUS message, status code

Arguments
name: message
type: unsigned longword
access: read only
mechanism: by reference

This is the message object that was previously allocated with fdb_start_msg.
name: statuscode
type: longword unsigned
access: read only
mechanism: by reference

The status value to send.

10.1.3.14 FDB_START_MSG

This routine is used to allocate a message for sending back a database lookup record. The general sequence of
returning a database record is as follows:

1.

Allocate a message using this procedure.

2.

Fill it in using FDB_SET_MATCH, FDB_SET_NUMBER, FDB_SET STATUS, and
FDB_SETFIELD. The last two are optional.

3.

Return it to the requestor using FDB_SEND_DATA.

Calling Sequence:
FDB_START_MSG message

Arguments

Advertising