Fdbget, Fdbclose streamid, Fdbdeletemsg message | NDC comm CompuFax

8.Wait for another request using FDB_GET.

9.When no more matches exist for a particular key, either use FDB_NOMATCH or FDB_CLOSE to return this status to the requestor.

10.1.3Com puFax Dat abase Func t ion Library 10.1.3.1 FDB_CLOSE

This function closes a database stream. It should be called when FDB$_CLOSE is returned by FDB_GET. It may also be called any time the user desires to end a lookup sequence.

When a lookup sequence is complete, the user has the option of either returning a .no match. to the requestor in which the requestor will close the stream or it may close the stream itself which will cause a .no match. response to be automatically sent to the requestor.

Calling Sequence:

FDB_CLOSE stream_id

Arguments name: stream_id type: longword signed access: read only mechanism: by reference

This is the ID of the stream to close. If the specified stream is not open, no action is taken.

10.1.3.2 FDB_DELETE_MSG

This function de-allocates a message that was allocated with FDB_START_MSG without sending the message. It would be used if an operation is aborted after a message is allocated. This function is used as an alternative to sending the message. It should not be used for messages that have been sent.

Calling Sequence:

FDB_DELETE_MSG message

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.

10.1.3.3 FDB_GET

This function waits for a message and returns a message when one is received. This procedure may operate either synchronously if no AST routine is passed or asynchronously if an AST routine is passed. If the server shuts down while a GET is active or if it has shut down since the last GET, a failure status of FDB$_SERDOWN is returned. Normally the database would exit on receipt of this status. If it does not shut down, it should cancel any lookups in progress as the requests will be reissued by the server the next time it starts.

Calling Sequence:

FDB_GET stream_id, lookup_key [,key_length]

8 0

Image 104

NDC comm CompuFax user manual Com puFax Dat abase Func t ion Library 10.1.3.1 Fdbclose, Fdbget, Fdbclose streamid

Contents

T WO R KI N G D Y N a M I C S C O R P O R a T I O N Copyright Notice January Networking Dynamics Corporation Software License Agreement Warran TY Service CompuFax Version Quick Installation Instructions Page CompuFax Hardware Installation and Configuration Page Preface Overview Intended Audience Table of Contents Other Commands Summary of Commands and Directives Appendix a CompuFax Installation Hardware Installation Fax Modem Devic eModem Cabling Term inal Port Charac t erist ic s Software Installation Server Port Charac t erist ic sMult iple Syst em s Evaluat ion Wit hout Modem Full Devic e Server Inst allat ion Full Devic e Server Set upCustomization Full Devic e Server St art up Rem ot e Fax Server Inst allat ion$ Show System $ FAX Show Device Rem ot e Fax Server Set up Remote Fax Server Startup$ Edit FAX$DIRFAXREMSTART.COM $ FAX Show Server What Is CompuFax? Getting Started As a CompuFax UserGetting Started $ FAX Show Queue Sending a Fax Checking If Your Fax Was Sent$ FAX FAX Exit Embedding Fax Numbers Into Documents Printing To The Fax DeviceAn Even Sim pler Way t o Send $ FAX SEN D TESTFAX.2 Em bedding Num bers in VMS Mail Sending Faxes Using VMS MailUsing Com puFax Qualifiers w it h VMS Mail Getting Help From VS4000PSMITH 15-JUN -1994 To FAX%CC Psmith $ FAX HelpPage More About Sending Files Sending Multiple FilesSending Different File Types $ FAX SEN D doc.1, doc.2, doc.3, doc.4, doc.5 / N UMBER= Tex t Files Bit m apped FilesPost Sc ript Files $ FAX SEN D FILE.COMPRESSED / FORMAT= T4 / N UM= Using Different Fonts Sending Landscaped Files$ FAX SEN D TESTFAX.2 / FON T= # # FON T # # Remark This is a coversheet configuration file Sending Files With OverlaysSending Faxes With Coversheets $ FAX SEN D BILL.CFG Sending Breakup Files # # Breakup # # N Ewfax# # EN Dfax # # N Umber Using The Lookup Feature $ FAX SEN D FILE.A, FILE.B, FILE.CThis results $ FAX SEN D TESTFAX.1 / LOOKUP= Fred Smith Lookup With Wildcard Broadcasting FaxesPersonalizing Broadcast Faxes $ FAX SEN D TESTFAX.1 / LOOKUP= F Merging From The Command Line $ FAX SEN D MERGE.TXT / LOOKUP= CITY= Los Angeles Deferred Sending Deleting Entries After Sending$ FAX SEN D TESTFAX.2 / AFTER= 12-APR-199621530 $ FAX SEN D TESTFAX.2 / Delete Setting Priorities Logos and LetterheadsCompuFax queue report as of 10-JUN -1995 $ FAX SEN D TESTFAX.2 / N Ologo Other Commands Using Command FilesNext we execute it $ @REPORTSEN D FAX @REPORTSEN D.FAXCMD Show Queue Verify CommandShow Queue $ FAX Delete / EN TRY= 4 / ALL $ FAX Show Queue Delete Command$ FAX SEN D TESTFAX.1 / LOOKUP= $ FAX Show Queue Keeping Track Of What You Did FAX Logoutput TEST.LOG Receive to Disk Receiving Faxes Qualifier Default value Printing FaxesPrin TER / N Obestway / Bestway / N Oburst / N Oburst Osheetfeed / N Osheetfeed / SIZE= XXX / SIZE= LetterPage Fax Print er Set up Viewing Faxes Verifying Print er Opt ionsPrint Com m FAX Show Prin TER Using CFRECTOOLS.COM View c om m Converting Fax Files Convert Com mQualifiers $ FAX SET Prin TER / Receive / N Odelete / N Otify Ex am ples FAX or T4 Prin TER or TextPCL Here are some conversion examples $ FAX CON Vert in .X / Prin T Introduction InstallationPersonal Computer Interface PostScript Driver Initialization \ Cfin Stal E\ FAX\ Pcif Adding a Print er Driver \ CFTEMP.PS Unknown local port Using the PC Interface Adding a Port Nam eWindow s 3.1 Post Sc ript Driver Init ializat ion Disc laim er Dest inat ion Sc reen Feat uresSending a Fax Lookup Screen Edit ing an Ent ry Coversheet Sc reensCoversheet Selec t ion Sc reen Coversheet Inform at ion Sc reen When t o Send Set upResolut ion File List Coversheet s Default s1Server Pat h Making Things Easier Frequent ly Used Files How to Modify a CoversheetSam ple Configurat ion File Sam ple File Ex plained Inc lude FilePage Summary of Commands Directives CommandsCON Vert Format FAX CON Vert in .X / FORMAT= Text OUT.Y / FORMAT= PCL OtifyTopmargin Delete ALLLocal Exit After BeforeSIN CE User Quit SEN DClass Commen T FON T Postscript or PS FAX or T4 Prin TER or TextLAN Dscape Logo Merge UmberOverlay Portrait Resolution Resolution = FineResolution = Standard Portrait D Oreceive / Resolution Speed / SPEED2 DisableCompletion SON LY EN Able Copies FlagForm Model = Run Length Encoding = N o Compression OTEQueue Sheetfeed Trailer SH OWShow Device Full Usern AME Show Prin TER Show ServerShutdown Start Verify on Verify OFF ViewDown Scale Maxpages Directives File Direc t ivesStartpage Breakup CH Aractersize # # Charactersize Millimeters 4.0EN Dfax # # FON T Stdfon T LAN Dscape Mail-Merge Direc t ives Overlayfile# # Portrait Position Cursor Mergedisable Mergeen AbleMergeen D Mergestart Files CompuFax Files And Logical NamesDirectories Ascjn L.COM CF31.RELEASEN OtesCFREC.H COMPUFAX.PS, COMPUFAX.T4, COMPUFAX2.PS, COMPUFAX2.T4 Faxcmdsh ARE.EXE FAXCVT.EXEFAXDB.DAT FAXDB.EXE Faxsylogin .COM FAXSYSTARTUP.COMFON Tmap GIRL.PS CompuFax Logical Names FAX$PSDIR FAX$QUEUEFAX$RECDIR FAX$SCRATCH CompuFax Messages Fac ilit y CodesSeverit y Levels FAX Alphabetical Listing of Messages Message Rout ing Devaccess CalltermClose Cmdreaderr Devrespfail DevstartDevstatfail Devstop Faxcomplete FaxdeviceFaxdon E Faxfail Illn UM IllpriIllserreq Illsqueue Ivdevin D VEN TRYIvmsg Ivqsize Memallocfail EwstreamOdbn Umber Odest Odevice OefnOfaxclass Ofile Omatch OmorefieldsOpriv Ormal Priadjust Otin QueuePH on Ebusy PN Umber Queuefull RemcsiRetry SEN Ddon E SH Utdown StatsTaken Down Tooman Yfax Work ing Wit h Com puFax Programming InformationUser-Written Database Applications Using The FDB Rout ines Com puFax Dat abase Func t ion Library 10.1.3.1 Fdbclose FdbgetFdbclose streamid Fdbdeletemsg messagePage Type userdefined Access write only Mechanism by reference Fdbgetcon Text streamid, context , maxsize , size Arguments FdbinitFdbin IT contextsize, savecontext One. Errors are signaled Type userdefined access read only Mechanism by referenceFdbnomatch Fdbn Omatch streamid One FdbscanFdbscan scancontext, streamid Type charactercoded text string Access read only FdbsenddataFdbsetfield Fdbsen Ddata streamid, message Fdbsetmatch FdbsetnumberMechanism by descriptorfixed length string descriptor Fdbsetmatch message, matchkey value Fdbsetstatus FdbstartmsgFdbsetstatus message, status code Fdbstartmsg message Look UP CloseShutdown This sends a shutdown message to the database application Faxcmdproc commandline CompuFax Callable InterfaceCallable Com m ands Faxcmdproc Faxcmdsethan DLE handleraddress Faxcmdsetin PUT inputproc, parminputproc Faxcmdforceexit Faxcmdsetoutput outputprocFaxcmdsetuser username Link ing Modules Dbcon DKEY.C DBGETDIR.C Dbmain .C DBN EXTREC.C FAXCMD.CPage Release 3.0.01 Changes Appendix aRelease 3.1.00 Changes Known Problems SolutionSee FAX Help Filedirective Position Cursor # # FON T filename See FAX Help Filedirective FON T Release 2.2.00 Changes Release 2.1.00 ChangesPage Release 1.2.04 Changes Page AXP GlossaryAscii CSI FAX% Faxdb Help Null string OverlayPending Percent sign % Record Remote serverScaleable font Secondary key VMS TSIVAX Page 446-4511