NDC comm CompuFax User Manual

NETWORKING DYNAMICS CORPORATIONCompuFax User Manual Networking Dynamics Corporation101 North Garden Avenue, Suite 220Clearwater, Florida 33755Phone

Intended AudienceThis manual is intended for users who want to become familiar with CompuFax, System Managers wishing toinstall and maintain CompuFax

76in the server options file have been changed since the last time the server was started.User action: Delete the file FAX$DIR:FAX.QUEUE and restart

77Description: Indicates the CompuFax server has successfully initialized and is running.User action: None.SHUTDOWNMessage: %FAX-I-SHUTDOWN, CompuF

78Programming InformationCompuFax provides two facilities to customize its user interface:• Database Interface• Callable Command Interface.10.1 User-W

79routines. The format and use of the lookup key is left entirely up to the database application. It is passed fromthe source (command processor or do

808. Wait for another request using FDB_GET.9. When no more matches exist for a particular key, either use FDB_NOMATCH or FDB_CLOSE toreturn this st

81[, username] [, priority] [, status][, astrtn] [, astprm]Argumentsname: stream_idtype: longword signedaccess: write onlymechanism: by referenceOn co

82This is the address of an optional AST procedure to execute when a request is received. If this parameter isnot passed or is passed as zero, FDB_GET

83This parameter gives the address of the context data area in the user program that is to receive the saved usercontext. The contents of this area ar

84The effect of setting this parameter FALSE will be that any active lookups will be started from the beginningeach time the database is restarted. If

85This parameter gives the address of the context data area in the user program. The contents of this area arecompletely user defined.name: sizetype:

Table of ContentsPREFACE...

8610.1.3.9 FDB_SEND_DATAThis routine is used to send to the requestor a message that has been built with the fdb_set_* functions. If thestatus returne

87mechanism: by descriptorfixed length string descriptorThis is the field name. This name is compared with the field name the sender has embedded in t

88This is the message object that was previously allocated with fdb_start_msg.name: phone numbertype: charactercoded text stringaccess: read onlymecha

89name: messagetype: unsigned longaccess: write onlymechanism: by referenceOn successful completion, this contains the message object that will be pas

9010.2 The CompuFax Callable Interface10.2.1 Callable CommandsThe CompuFax command interface is available as a shareable image that may be called from

91The user condition handler may force the command processor to exit by modifying the severity of the firststatus value in the signal array to be SEVE

92Calling Sequence:FAX_CMD_SET_OUTPUT [output_proc]Argumentsname: output_proctype: entry maskaccess: callmechanism: by referenceThis routine will be e

9310.2.1.7 Linking ModulesThe user application would link with a linker options file specifying the command processor as a shareableimage. The followi

94

95Appendix ARelease NotesA.1 Release 3.1.00 Changes1. CompuFax has been converted to run Alpha AXP in addition to VAX. Functionally CompuFax isidenti

3.16 LOGOS AND LETTERHEADS...

96See FAX>HELP FILE_DIRECTIVE POSITION_CURSOR3. File Breakup. Many users have software that generates large text files, such as financial reports,

97A.4 Release 2.2.00 ChangesDisk Space Limitation. The new Class 2 FAX modems, which CompuFax now supports, require bit mappedfiles in T4 format. Thes

982. The install procedure now asks for the disk to install CompuFax on. This should be a disk that ismounted and available during system startup.3.

99A.6 Release 1.2.04 Changes1. The / DELETE option may now be used on the VMS PRINT command when it is used to send FAXes.A new directory, FAX$SCRATC

100

101Glossaryaccess methodA way to get to and use CompuFax.Alpha-AXPA computer type, built by Digital Equipment Corporation, on which CompuFax is design

102A file that has been made smaller than an uncompressed bitmapped file by counting groups of black andwhite dots and representing those with special

103faxAn electronically transmitted facsimile of a document. A machine that will transmit and receive suchdocuments. The action of transmitting such a

104header lineThe line of text right at the top of a fax, which contains identifying information, such as date and time oftransmission, sender's

105null stringAn absence of text where text may be expected or required, usually indicated by a pair of quotation marks("").overlayIn image

6.6.3 Setting Up a Default Recipient...

106recordA collection of data elements grouped together by some commonality.remote serverIn CompuFax, a program which sends commands and information a

107A file used as a model for creating other files, such as for the creation of a coversheet. The purpose of atemplate is to simplify the task of crea

108

109Please feel free to report any other difficulties encountered with this product to:Product Support ManagerNetworking Dynamics Corporation101 North

10.2.1.5 FAX_CMD_SET_USER...9

1CompuFax Installation1.1 OverviewSeveral configuration decisions should be made prior to installation of the CompuFax product. This overviewhas been

21.2 Hardware InstallationThis procedure is performed only for Full Device Server software.1.2.1 Fax Modem DeviceA Class II fax modem device is requir

31.2.4 Server Port Characteristics$ MCR NCPNCP> Connect NODE nodenameLocal> SHOW PORT n (n = port number)Port 8: (Remote)Character Size: 8 Input

41.3.2 Full Device Server InstallationIf you do not plan on using the Remote Fax Server on other nodes, perform each step related to a FullDevice Serv

51.4.2 Full Device Server StartupCompuFax is composed of a main executable image and several other images that support various features.The startup co

January 2001Copyright Notice© Copyright + 1992--2001, an unpublished work by Networking Dynamics Corporation.Portions Copyright + 1988--1996 by Alad

61.4.4 Remote Fax Server SetupConfigure the Remote Fax Server startup options to indicate the node(s) you have designated as your FullDevice Server sy

7Getting Started As a CompuFaxUser2.1 What Is CompuFax?CompuFax is a collection of computer programs that lets you send fax document files directly fr

82.3 Sending a FaxTo send a fax, you need two things:The name of the document (file) you want to sendThe fax phone number you want to send the fax to.

92.4.1 An Even Simpler Way to SendInstead of going into the CompuFax program first, you can enter the command directly from the DCLcommand line:$ FAX

102.7 Sending Faxes Using VMS MailHere is a way you can send a fax from within VMS Mail:$ MAILMAIL> SEN D TESTFAX.1To: FAX%1-555-123-4567Subj: Sen

11From: VS4000::P_SMITH 15-JUN -1994 11:52:38.95To: FAX%""CC: P_SMITHSubj: Sending File TESTFAX.1This is a test.I am sending a short message

2The next chapter gives further information on how faxes may be sent.

3More About Sending FilesIn the previous chapter, we covered some simple ways to send faxes. Since the SEND command is the mostimportant command in Co

43.2.1 Text FilesThe simplest file type is a regular text file, such as the ones we sent in the examples of the previous chapter.These files are also

53.3 Using Different FontsThe word font is a printing term, which denotes letters of a certain style (called a typeface) and of a certainsize. When Co

NETWORKING DYNAMICS CORPORATIONSOFTWARE LICENSE AGREEMENT1. PREACCEPTAN CE N OTICE1. 1 READ THE TERMS AND CONDITIONS OF THIS AGREEMENT BEFORE OPENING

63.5 Sending Files With OverlaysAn overlay, in terms of CompuFax, is an image that is superimposed on another image. An example of this isa form overl

7# # REMARK **********************************************************************# # REMARK Below, we indent the text 1.2 inches and reset the charac

8##BREAKUP (This section of text is not faxed)..##NEWFAX# # N UMBER 123-4567 (This section is faxed to 123-4567)..##ENDFAX (This section of text is no

9This directive indicates the end of a section. Any further text will be ignored, except for a # # NEWFAXdirective, which would indicate the start of

10The / LOOKUP qualifier causes CompuFax to look up Fred's number (1-818-555-1111) automatically andsend the fax to that number. Or, instead of

11Here is a sample fax file (MERGE.TXT) we could send:##MERGE_ENABLE%%Internal_Address%%%%Sa l u t a t i o n %%:Just wanted to say 'Hello.'L

123.13 Deferred SendingYou can tell CompuFax to wait until late at night to send a fax, when the phone rates may be lower, or thereis less chance of g

133.15 Setting PrioritiesSome faxes are more urgent than others and sometimes you may want to push a certain fax to the head of thequeue. CompuFax use

14Other Commands4.1 Using Command FilesYou can use command files with CompuFax. This can be very useful for routine work or large tasks.Command files

153 P_SMITH 100 Pending3 FAX server queue entriesAfter we submitted the command file, we did an initial display of our queue, which was empty. Next, w

COPIES OF THE LICENSED SOFTWARE O THER THAN THOSE PROVIDED OR AUTHORIZED BY NDC WILL CONFORM TO THESOFTWARE MANUAL.5.3 It is expressly agreed that IN

164.3 The DELETE CommandThe DELETE command lets you delete queue entries that are waiting to be sent, or even while in the processof being transmitted

174.4 Keeping Track Of What You DidYou can record what you type at the fax prompt. This is particularly useful if you are sending a lot of faxes.To st

18Receive to Disk5.1 OverviewStarting with CompuFax Version 3.2, fax documents can now be received to disk and printed or viewed. Inaddition, a CONVER

19faxes after they have been received. It is advisable to print and delete the received files routinely, since a singlefax page may easily take up sev

20to set / NOBEST_WAY, in which case the compression method specified by the / MODEL qualifier willalways be used.The / [NO]BURST qualifier specifies

21defined as an actual print queue on the system. See VMS System Manager documentation on managingqueues.The / [NO]RECEIVE qualifier defines whether o

22lost whenever CompuFax is restarted. Operator privilege is required to make use of the FAX SET PRINTERcommand.5.3.2 Verifying Printer OptionsThe new

235.4.1 The VIEW commandThe CompuFax VIEW command options are explained in detail in Chapter 6. However, here are someexamples:$ FAX VIEW FAX$REC_DIR:

245.5 Converting Fax FilesWith the overlay facilities in CompuFax it becomes desirable to have some means of modifying bitmappedimages, in order to pr

25FAX or T4PRINTER or TEXTPCLPOSTSCRIPT and PS are synonyms. FAX and T4 are also synonyms, as are PRINTER and TEXT. Printerformat is the normal defaul

CompuFax® Version 4.3Quick Installation Instructions(For use on VAX or Alpha AXP Systems)CompuFax contains a full fax server that runs on the primary

26For example:$ FAX CON VERT IN.X / PRIN T$%DCPS-I-JOBSTART, Job IN (queue SYS$FAX, entry 3) started on SYS$FAX$ COPY IN .PCL OUT.PCLJob IN (queue SY

27The Personal Computer Interface6.1 IntroductionStarting with Release 4.0 of CompuFax, you can send faxes from Personal Computers (PCs), which arecon

282. Execute the command (batch) file CFINSTAL.BAT, using as argument the path to the PCIF directory onthe server (With Windows 95 you can execute thi

29to set up the PostScript driver, so it will operate correctly with the CompuFax PC Interface. Both Windows3.1 and Windows 95 come with PostScript pr

306.3.2 Adding a Port Name(Go to the Details window of the selected PostScript printer driver. Refer to the PostScript DriverInitialization section ab

31The server must be a VAX or Alpha running VMS version 5.4 or aboveThe server must be running CompuFax Release 4 Full Device Server softwareThe clien

326.4.5 Help ScreensAs shown on the Destination screen, you can bring up a Help screen from any of the PC Interface mainscreens, simply by pressing th

336.4.6.6 Editing an EntryYou can edit an entry by selecting it and then clicking on the < Back button. This takes you back to theDestination scree

34logo differs from a coversheet in that it covers only a few inches at the top of the page, while a coversheettakes up an entire page and usually inc

35for the PC Interface to work properly. These entries should be correct if the PC Interface software wasinstalled properly and the server path was en

$ FAX DELETE/ENTRY=id-numberRefer to Chapter 1, "CompuFax Installation", or use the CompuFax on-line Help for additional information. Wesugg

366.5.4 [Files]01 The first default file in the File List on the Options screen. The full file path should be given. This file maybe removed from the

376.6.7 Frequently Used FilesFrequently used files may be saved in a special format to make sending faxes more efficient. If the fileconsists of plain

38# # NOTE % Add a note to the coversheet.WriteVariableInfoshowpage % The page is complete.# # *** End of File ***6.7.2 Sample File ExplainedThe file

39Next follows the Named Constants section, which is of greater interest. Note that the page dimensions aregiven as 11 inches high by 8.5 inches wide.

40Summary of Commands andDirectivesThis chapter is an alphabetical listing of CompuFax commands and directives, as given in the CompuFaxHelp facility.

41Description: Specifies the amount of white space between the left edge of the document and thebitmapped image in the outfile. This is measured in d

42DELETEFormat: DELETE / ENTRY = (n, ...) [ / ALL] [/ LOCAL]Description: This command is used to delete one or more queue entries. Entry numbers ca

43Description: The first command parameter is the name of the input file. This must be a journal file whichwas created by CompuFax. While it can be c

44Format: / DELETE/ NODELETEDescription: Specifies whether the T4 file is to be deleted after printing. This qualifier overrides thedefault setting

45/FONTFormat: / FONT[=filespec]Description: This qualifier specifies the font to be used when converting a text file into T4 format. Thefont file m

CompuFax® HardwareInstallation and Configuration(As shipped, CompuFax is set up to transmit faxes TTA0: device. It can easily be configured to send to

46Description: This qualifier forces or suppresses the sending of MAIL messages on fax completion. If/ MAIL is specified, MAIL notification will alwa

47Format: / PORTRAIT (D)Description: Specifies that the current document is to be sent without any rotation sideways./ LANDSCAPE and / PORTRAIT appl

48/ NORECEIVE / RESOLUTION/ SPEED / SPEED2In order to use the following qualifiers the device must be taken off line(STOP/ DEVICE) first:/ CLASS / CSI

49Control Language) type printers, such as the HP LaserJet 4 series, are supported. The initial setup is done atCompuFax startup time and may be modif

501 = Run Length Encoding0 = No CompressionIf the / BEST_WAY qualifier is also enabled, the actual method used may vary between zero and the numbersel

51/SIZEFormat: / SIZE=LETTER (D)/ SIZE=LEGAL/ SIZE=A4/ SIZE=EXECUTIVEDescription: This qualifier determines the maximum dimensions of a printed imag

52Format: / CONVERSION (D)/ NOCONVERSIONDescription: This qualifier controls the display of the queue of entries which are waiting for theconversion

53Format: / USERNAME= (username [,...])Description: This qualifier causes the report to be filtered by username. Only those entries which wereorigin

54Description: This qualifier is used to delete one or more entries from the queue. The entry number is thenumber from a SHOW ENTRY report. Up to 32

55Description: Directs display output to a file instead of to the screen. The created file can later be displayedon a suitable terminal, using the DC

56Description: Specifies that the current file is to be a Breakup file, which means that selected portions ofthe file are to be treated as though the

57Description: Includes an explicit phone number to use for sending the FAX. The syntax of the number isthe same as the SEND command / NUMBER qualifi

58ending delimiter. Trailing spaces and multiple imbedded spaces are removed from field names. If the end of aline is encountered before the field nam

59CompuFax Files And LogicalNames8.1 DirectoriesFAX.DIRThis is the main CompuFax directory, which is created when you install CompuFax.PS.DIRThis is a

60ASCJN L.COMThis command file allows you to display formatted fax journal data located in FAX_JOURNAL.DAT, whichis an ASCII file created from the jou

61FAX_CMD_SHARE.EXEThis shareable image contains the callable command processor, which is required by CompuFax and may alsobe accessed by user applica

62This program is the print symbiont that allows documents to be sent using the VMS PRINT command. Thisfile is placed in the SYS$SYSTEM directory duri

63This is the default font file that CompuFax uses when converting text files to fax format. This font fileproduces text at about 80 characters per li

64The file containing CompuFax Full Device Server start-up information. Defaults toFAX$DIR:FAX.OPTIONS.FAX$PS_DIRThe subdirectory where certain files

65CompuFax Messages9.1 IntroductionCompuFax provides error messages, which can help you sort out the cause of various problems you mayencounter. This

PrefaceOverviewCompuFax will run on VAX/ VMS and OpenVMS versions 5.4 through 7.1, as well as on Alpha-AXPOpenVMS versions 6.1 through 7.1.Fax documen

66time.F Fatal. The attempted action did not work.In the previous example, the first message has an "F" severity level and the second one h

67Description: This indicates an internal error has occurred.User action: Any information available about the circumstances should be reported to ND

68Message: %FAX-I-DEVMOD, Device xxxx modified by user yyyyDescription: Device has been modified by userUser action: None.DEVONLINEMessage: %FAX-F

69Message: %FAX-I-ENTRYID, Queue entry ID nnDescription: This message is appended to other messages to specify the queue entry ID the messageapplies

70protection is such that users are allowed read action.ILLNUMMessage: %FAX-F-ILLNUM, Illegal phone numberDescription: Indicates that a phone number

71IVDEVINDMessage: %FAX-W-IVDEVIND, Invalid device index nn ignoredDescription: An out of range device index was specified.User action: Device indi

72MBXWRITEERRMessage: %FDB-F-MBXWRITEERR, Error writing to mailbox xxxxDescription: Indicates an unexpected error has occurred writing.User action:

73had been previously saved.User action: See the documentation on the FDB routines for a description of streams and contexts.N ODEVICEMessage: %FAX-

74while a fax is being sent with the VMS Mail interface, check that the process has TMPMBXpriv.NOMATCHMessage: %FAX-E-NOMATCH, No database matchesDes

75Message: %FDB-F-NOSTREAM, Specified database stream not openDescription: An attempt was made to reference a database stream that is not currently