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

8 8

Page 112
Image 112
NDC comm CompuFax user manual Fdbsetstatus message, status code, Fdbstartmsg message