Fdbsenddata, Fdbsetfield | NDC comm CompuFax manual

10.1.3.9 FDB_SEND_DATA

This routine is used to send to the requestor a message that has been built with the fdb_set_* functions. If the status returned is a success, then at least the phone number must have been set. The message is deallocated after being sent. The user need not deallocate it.

Calling Sequence:

FDB_SEN D_DATA stream_id, message

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

This is the target database stream identifier. This stream must have be open and have an unanswered lookup request outstanding.

name: message

type: unsigned longword

access: read only

mechanism: by reference

This is the message object that was previously allocated with FDB_START_MSG.

Return Value:

FDB$_N ORMAL N ormal successful completion

FDB$_IVMSG If the message does not contain a phone number

FDB$_N OREQUEST If there is no lookup request outstanding for the stream FDB$_N OSTREAM If the stream is not open

10.1.3.10 FDB_SET_FIELD

This routine is used to set the value of a database field in a message that was previously allocated with fdb_start_msg. Use of this function is optional. Up to 10 different fields may be set with successive calls to this function.

Database fields may be used in mailmerge operations to do automatic text substitution in documents at the time the document is sent.

Field names are not case sensitive and multiple spaces and/ or tabs are reduced to a single space.

Calling Sequence:

FDB_SET_FIELD message, fieldname, fieldvalue

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: fieldname

type: charactercoded text string

access: read only

8 6

Image 110

NDC comm CompuFax user manual Fdbsenddata, Fdbsen Ddata streamid, message, Fdbsetfield message, fieldname, fieldvalue

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 Modem Cabling Hardware InstallationFax Modem Devic e Term inal Port Charac t erist ic s Mult iple Syst em s Software InstallationServer Port Charac t erist ic s Evaluat ion Wit hout Modem Full Devic e Server Inst allat ion Full Devic e Server Set upCustomization $ Show System Full Devic e Server St art upRem ot e Fax Server Inst allat ion $ FAX Show Device $ Edit FAX$DIRFAXREMSTART.COM Rem ot e Fax Server Set upRemote Fax Server Startup $ FAX Show Server Getting Started What Is CompuFax?Getting Started As a CompuFax User $ FAX Show Queue $ FAX Sending a FaxChecking If Your Fax Was Sent FAX Exit An Even Sim pler Way t o Send Embedding Fax Numbers Into DocumentsPrinting To The Fax Device $ 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 CC Psmith Getting HelpFrom VS4000PSMITH 15-JUN -1994 To FAX% $ FAX HelpPage Sending Different File Types More About Sending FilesSending Multiple Files $ FAX SEN D doc.1, doc.2, doc.3, doc.4, doc.5 / N UMBER= Post Sc ript Files Tex t FilesBit m apped Files $ FAX SEN D FILE.COMPRESSED / FORMAT= T4 / N UM= $ FAX SEN D TESTFAX.2 / FON T= Using Different FontsSending Landscaped Files # # FON T Sending Faxes With Coversheets # # Remark This is a coversheet configuration fileSending Files With Overlays $ FAX SEN D BILL.CFG Sending Breakup Files # # EN Dfax # # Breakup# # N Ewfax # # N Umber This results Using The Lookup Feature$ FAX SEN D FILE.A, FILE.B, FILE.C $ FAX SEN D TESTFAX.1 / LOOKUP= Fred Smith Personalizing Broadcast Faxes Lookup With WildcardBroadcasting Faxes $ FAX SEN D TESTFAX.1 / LOOKUP= F Merging From The Command Line $ FAX SEN D MERGE.TXT / LOOKUP= CITY= Los Angeles $ FAX SEN D TESTFAX.2 / AFTER= 12-APR-199621530 Deferred SendingDeleting Entries After Sending $ FAX SEN D TESTFAX.2 / Delete CompuFax queue report as of 10-JUN -1995 Setting PrioritiesLogos and Letterheads $ FAX SEN D TESTFAX.2 / N Ologo Next we execute it Other CommandsUsing Command Files $ @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 Prin TER / N Obestway / Bestway / N Oburst / N Oburst Qualifier Default valuePrinting Faxes Osheetfeed / N Osheetfeed / SIZE= XXX / SIZE= LetterPage Fax Print er Set up Print Com m Viewing FaxesVerifying Print er Opt ions FAX Show Prin TER Using CFRECTOOLS.COM View c om m Qualifiers Converting Fax FilesConvert Com m $ FAX SET Prin TER / Receive / N Odelete / N Otify PCL Ex am plesFAX or T4 Prin TER or Text 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 Window s 3.1 Post Sc ript Driver Init ializat ion Using the PC InterfaceAdding a Port Nam e Disc laim er Dest inat ion Sc reen Feat uresSending a Fax Lookup Screen Coversheet Selec t ion Sc reen Edit ing an Ent ryCoversheet Sc reens Coversheet Inform at ion Sc reen Resolut ion When t o SendSet up 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 CON Vert Summary of Commands DirectivesCommands Format FAX CON Vert in .X / FORMAT= Text OUT.Y / FORMAT= PCL OtifyTopmargin Local DeleteALL Exit SIN CE AfterBefore User Class QuitSEN D Commen T LAN Dscape FON TPostscript or PS FAX or T4 Prin TER or Text Logo Overlay MergeUmber Portrait Resolution = Standard ResolutionResolution = Fine Portrait D Completion SON LY Oreceive / Resolution Speed / SPEED2Disable EN Able Form CopiesFlag Model Queue = Run Length Encoding = N o CompressionOTE Sheetfeed Show Device TrailerSH OW Full Usern AME Shutdown Show Prin TERShow Server Start Down Scale Verify on Verify OFFView Maxpages Startpage DirectivesFile Direc t ives Breakup EN Dfax CH Aractersize# # Charactersize Millimeters 4.0 # # FON T Stdfon T LAN Dscape # # Portrait Mail-Merge Direc t ivesOverlayfile Position Cursor Mergeen D MergedisableMergeen Able Mergestart Files CompuFax Files And Logical NamesDirectories CFREC.H Ascjn L.COMCF31.RELEASEN Otes COMPUFAX.PS, COMPUFAX.T4, COMPUFAX2.PS, COMPUFAX2.T4 FAXDB.DAT Faxcmdsh ARE.EXEFAXCVT.EXE FAXDB.EXE FON Tmap Faxsylogin .COMFAXSYSTARTUP.COM GIRL.PS CompuFax Logical Names FAX$RECDIR FAX$PSDIRFAX$QUEUE FAX$SCRATCH Severit y Levels CompuFax MessagesFac ilit y Codes FAX Alphabetical Listing of Messages Message Rout ing Close DevaccessCallterm Cmdreaderr Devstatfail DevrespfailDevstart Devstop Faxdon E FaxcompleteFaxdevice Faxfail Illserreq Illn UMIllpri Illsqueue Ivmsg Ivdevin DVEN TRY Ivqsize Odbn Umber MemallocfailEwstream Odest Ofaxclass OdeviceOefn Ofile Opriv OmatchOmorefields Ormal PH on Ebusy PriadjustOtin Queue PN Umber Retry QueuefullRemcsi SEN Ddon E Taken Down SH UtdownStats Tooman Yfax Work ing Wit h Com puFax Programming InformationUser-Written Database Applications Using The FDB Rout ines Fdbclose streamid Com puFax Dat abase Func t ion Library 10.1.3.1 FdbcloseFdbget Fdbdeletemsg messagePage Type userdefined Access write only Mechanism by reference Fdbgetcon Text streamid, context , maxsize , size Arguments FdbinitFdbin IT contextsize, savecontext Fdbnomatch One. Errors are signaledType userdefined access read only Mechanism by reference Fdbn Omatch streamid One FdbscanFdbscan scancontext, streamid Fdbsetfield Type charactercoded text string Access read onlyFdbsenddata Fdbsen Ddata streamid, message Mechanism by descriptorfixed length string descriptor FdbsetmatchFdbsetnumber Fdbsetmatch message, matchkey value Fdbsetstatus message, status code FdbsetstatusFdbstartmsg Fdbstartmsg message Shutdown Look UPClose This sends a shutdown message to the database application Callable Com m ands Faxcmdproc commandlineCompuFax Callable Interface 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 See FAX Help Filedirective Position Cursor Known ProblemsSolution # # 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 Pending Null stringOverlay Percent sign % Scaleable font RecordRemote server Secondary key VMS TSIVAX Page 446-4511