NDC comm CompuFax User Manual

NETWORKING DYNAMICS CORPORATION

CompuFax User M anual



Networking Dynamics Corporation

101 North Garden Avenue, Suite 220

Clearwater, Florida 33755

Phone 727.446.4511 • Fax 727.446.4252

www.networkingdynamics.com

Janu a r y 2001

Copyright Notice

© C op yrigh t + 1992-- 2001, a n unpublished work by N etworking Dynamics Corporation. Po rtion s C opyright + 1988- -1996 b y Aladdin Ente r pris e s, Menlo Par k, Ca lif ornia. Po rtion s C opyright + 1990- -1991 b y Bits t ream Inc. Certain font s are licensed fr om Elf ring C on s ulting, Inc., 4N899 West Mary Drive, St . C har les , IL 60175. No part of this manual may be reproduced, stored in a retrieval system, or transmitted in any form or by any means, electronic, mechanical, recording, or otherwise, without the prior written permission of Networking Dynamics Corporation. The information in this manual is furnished for informational use only, is subject to change without notice, and should not be construed as a commitment by N etworking Dynamics Corporation. Networking D ynamics Corporation assumes no responsibility or liability for any errors or inaccuracies that may appear in this manual. The software described in this manual is furnished under license and may only be used or copied in accordance wit h t he ter m s o f s u ch license.

Com p uFax is a register ed trad em ar k o f Networ king Dynamics Co r por at io n .

D CL, VAX, VMS, Op enVMS and Alph a-AXP are r egister ed t rad em arks o f Co mp aq Com pu t er Co rp or atio n. H ewlett Packard, H P, Laserjet, PCL are registered tradem arks of H ewlett Packar d Corp oratio n. MultiTech , ZDX are registered trademarks of MultiTech Systems, Inc. PostScript is a registered trademark of Adobe Systems, I n c.

Restricted Rights Legend

Use, duplication or disclosure by the US Government is subject to restrictions as set forth in subparagraph (c)(1)(ii) o f the R ights in Technical Da ta and C ompute r Softwar e cla use a t 55.227- 7013. F or Civilian A gencies the restrictions are set forth in subparagraph (a) through (d) of the Commercial Computer Software Restricted Rights clause at 52.227- 19 a nd t he lim itat io n se t fo r th in Networking Dynamics Co rp oratio n' s st a nd ar d lice nse agreement for this software.

Unpublished rights reserved under the copyright laws of the United States of America.

NETWORKING DYNAMICS CORPORAT ION

SOFTWARE LICENSE AGREEMENT

1. P REACCEPT AN CE N O TI CE

1.1 READ THE TERMS AND CONDITIONS OF THIS AGREEMENT BEFORE OPENING THE MEDIA PACKAGE. YOU ACCEP T TH I S AGREEM E N T IF YO U O PE N TH E ME DI A PACK AGE , P LACE ANY SO F TWARE FRO M TH E

MEDIA PA CKAGE INTO USE OR IF YOU K EEP T HE SOFTWARE ME DIA PACKAGE FOR MORE T HAN T HIRT Y (30) DAYS. IF YOU DO NOT AGREE TO THE TERMS ON THIS AGREEMENT, YOU MUST RETURN THE UNOPENED MEDIA PACKAGE AND DOCUMENTATION WITHIN THIRTY (30) DAYS AND YOUR MONEY WILL BE REFUNDED (LESS NORMAL SHIPPING AND HANDLING).

2. TERM

2.1 This license is effective until terminated. You may terminate t his license upon 30 days’ written notice to Networking Dynamics Corporation

(NDC). NDC may terminate the license on 30 days’ written notice to you if you fail to comply with any term or condition of this agreement or fail to purchase a full license within thirty (30) days of or fail to pay NDC any monies due within ninety (90) days of the due date.

2.2 Upon termination, you agree to return to NDC or destroy all copies of the licensed software, documentation, modifications and merged portions in any form.

3. SCOPE OF USE

3.1 This license grants you the personal and non-exclusive right to use the licensed software solely (a) for your own purposes; (b) on the one

particular computer system, CPU or cluster on which the license key was originally installed; and (c) according to all the terms and conditions set forth in the license.

3.2 You assume responsibility for th e se lect io n o f t he licen sed sof t ware t o ach iev e your in t en ded res ult s a nd for it s in st alla t ion, use and obtained results.

3.3 You may not sublicense, copy, modify or transfer the licensed software except as expressly provided in this license.

3.4 You may permit others, including your employees, customers, consultants and contractors to use the licensed software if they agree to abide by

the terms and conditions of this agreement.

3.5 The storage media that you receive may contain certain demonstration software that you have not ordered. You agree that this so ft ware license applies to any and all software which you install from the distribution media, and that you will not place any such demonstration soft ware into use for more than a 30 day trial period without first purchasing a valid software license. NDC may incorporate technical means t o prevent you from having unlimited access to any such demonstration software.

4. PROPRIETARY RIGHTS

4.1 You agree that the licensed software is the valuable property of NDC, no part of which may be reproduced or transmitted in any form or by any

means, electronic, mechanical or otherwise, including photocopying and recording or in connection with any information storage or retrieval system without permission in writing from NDC.

4.2 You may not copy the licensed software or its documentation except for backup purposes or to load the licensed software into the comput er as part of installation or execution of the program. All other copies of the licensed software or its documentation are in violation of this license.

4.3 You acknowledge that the licensed software (a) contains valuable copyright, trade secret and other intellectual and proprietary information, and (b) remains the confidential property of NDC. You agree not to disclose or make available such information to any person for any purpose other than is necessary for your use of the licensed software as authorized by this Agreement.

4.4 You agree that NDC retains full ownership of the source code to the licensed software and that you shall have no access or rights to the source code. You agree not t o decompile or disassemble th e licensed software. You agree not t o create, or att empt t o create, o r permit or help others to create, the source code, or to reverse engineer or attempt to reveal NDC’s trade secrets and propriet ary rights, from the licensed software furnished pursuant to this Agreement.

4.5 Use, duplication or disclosure of the Product by the U.S. Government is subject to "Restricted Rights", as that term is defined in the Department of Defense ("DOD") Supplement to the Federal Acquisition Regulations ("DFARS") in paragraph 252.227-7013(c)(1) if to the DOD, or, if the Product is supplied to any unit or agency of the U.S. Government other than DOD , the G overnment's rights in t he Product will be as defined in paragraph 52.227-19(c)(2) of the Federal Acquisition Regulations ("FAR"). Use, duplication or disclosure by any foreign government is subject to equivalent restrictions as defined in that country's laws and/or regulations.

5. LIMITED WARRANTY

5.1 NDC warrant s th at the lice nse d so ft ware will p erfo rm su bst a nt ially in accordance with t he soft ware manual when delivered. ND C will provid e

all reasonable services to remedy any verified non-conformity to the software manual reported within the warranty period. The warranty period begins when the licensed software is installed or thirty (30) days after delivery to you, whichever occurs first, and ends ninety (90) days later. All warranty-related support for the licensed software will terminate upon the release of any subsequent version of the licensed software.

5.2 CORRE CT IO N O F REP O RT E D ERRORS B Y N D C I S THE SOLE AN D E XCLU SIVE RE ME DY U N DE R T HI S WARRAN T Y. THE LICENSED SOFTWARE AND DOCUMENTATION ARE PROVIDED WITHOUT ANY OTHER WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. NDC DOE S NOT WARRANT THAT THE LICENSED SOFTWARE WILL BE E RROR-FRE E, TH AT TH E LICEN SED SO F T WARE WILL OP ERA TE WITH ANY H A RD WARE O R SO FT WARE O TH ER T H AN T H AT SP ECI FI ED IN TH E SO FT WARE MANUAL, TH AT THE LICEN SE D SO FTWARE WILL SATISFY YO UR OWN SPECIF IC REQ UIRE ME N T S OR T H AT

COPIES OF THE LICE NSED SOFTWARE OTHER THAN THO SE PROVIDED OR AUTHORIZ ED BY NDC WILL CONFORM TO THE SOFTWARE MANUAL.

5.3 It is expressly agreed t hat IN N O EVE N T will ND C be liab le for spe cial, ind irect , or con seque ntial d amages, or any da mages wha tsoever resulting from loss of use, data, or profits, re-runtime, inaccurate input or work delays, or any direct property damage arising out of or in connection with this agreement or the use or performance of the licensed software, whether in an action in contract or tort including negligence. NDC does not guarantee that all problems will be corrected or that any updates will be compatible with previous versions of the licensed software.

6. WARRANTY SERVICE

6.1 NDC will designate a service location that will accept written reports of non-conformance encountered when using the licensed software under

normal conditions, as defined by the software product description. You are responsible for the preparation and submission of a written problem report to the service location. FAILURE TO SUBMIT A WRITTEN PROBLEM REPORT OR SUPPLY NDC IN WRITING WITH DATA AND IN PU T NECE SSARY TO RE CREAT E ANY P ROG RAMMIN G ERRO R WILL VO ID N D C’s WARRANTY AND RELIEVE NDC OF ANY OBLIGATION RELATING TO THAT PROGRAMMING ERROR.

7. SUPPORT AN D UPDATE POLICY

7.1 The purchase price includes ninety (90) days of software support, available by lett er, FAX or telephone during business hours (Monday through

Friday, 8:30am to 4:30pm, Eastern time, excluding state and federal legal holidays). Software support is limit ed to ass ist an ce in ins t allat io n an d u se of the licensed software.

7.2 Additional years of software support are available at published prices. Payment must be made in advance and is non-refundable. You will b e contacted by NDC regarding additional software support before your present support service expires.

7.3 If you are currently covered by NDC support per Section 7.2 above, N DC will mak e availab le any impro vement s or updates t o the licensed software as they are released. If you are not covered by NDC support, software updates must be purchased (you must also assume the cost of shipping and media).

8. GENERAL TERMS

8.1 This license constitutes t he ent ire agreement bet ween you and NDC regarding the use of t he licensed software. Th is license may be modified

only by written agreement, signed by both you and NDC. This license agreement supersedes all prior representations, understandings or agreements between you and NDC.

8.2 Should any of the provisions of this license be declared invalid by any court of competent jurisdiction, the balance of the license will re main in full force and effect.

8.3 This license shall be governed by the laws of the State of Florida.

CompuFax® Version 4.3

Quick Installation Instructions

(For use on VAX or Alpha AXP Systems)

CompuFax contains a full fax server that runs on the primary computer node that has a fax modem device connected. CompuFax also contains a remote fax server that you can install on a remote node and send fax requests to the primary node. This procedure will allow installation of a Primary Fax Server. To install a Remote Fax Server system, please refer to Chapter 1, "CompuFax Installation."

IMPORTANT **** Primary Server and Remote Server never run on the same node ****

1. Log into the SYSTEM account and at the $ prompt type the following: !Use FAX for VAX system !Use FAX_AXP for Alpha system

@SYS$UPDATE:VMSINSTAL FAX

Location-of-distribution

…where "location-of-distribution" is either the name of the tape drive where the tape is mounted or the path name to the saveset on the CD. The path name to the saveset on the CD consists of the disk name for the CD Drive followed by [VAX ] or [Alpha] depending on which system it is being installed on. For example: @SYS$UPDATE:VMSINSTAL FAX DKA400:[VAX]

2. Answer these VMSINSTAL questions as shown below:

Is this node a FAX Full Device Server node? (Y/N) [Y]: Yes

Remote Server on same disk? (Y/N) [N]: No

* Do you want to purge files replaced by this installation [YES]? No

Will you be using a Multi-Tech fax modem? (Y/N) [Y]: Yes (N = no fax device)

Note: Even if you are not using a Multi-Tech modem, still select "YES".

If you are connecting a fax modem device, perform the Hardware Installation steps on the r everse side of this

sheet.

3.

Fo r t he P ri mar y Fa x Se r ve r no de w it h a fa x mod em, c o nfigur e the mo de m next . Ski p thi s s tep i f you ar e onl y evaluating the software.

$ EDIT SYS$SYSDEVICE:[FAX]FAX.OPTIONS !Modify the lines denoted by " ** " for site-specifications

4.

Start the CompuFax Primary Fax Server process:

$ @SYS$SYSDEVICE:[FAX]FAX_SYSTARTUP

5. Invoke the command below to create the symbol FAX as a command:

$ @FAX$DIR:FAX_SYLOGIN

Note: Enter the commands in Steps 4 and 5 into your system startup file and your system-wide login file, respectively.

6.

Allow a few minutes for CompuFax to establish communications with the fax modem and bring the device on-line. Test the Primary Fax Server:

$ FAX SHOW DEVICE

7. Verify operation by sending a fax:

$ FAX SEND filename/NUMBER=your-fax-number/AFTER=TOMORROW

$ FAX SHOW QUEUE

8. Remove the entry in the fax queue:

$ FAX DELETE/ENTRY=id-number

Refer to Chapter 1, "CompuFax Installation", or use the CompuFax on-line Help for additional information. We suggest you review the product release notes, located in the CompuFax directory, for additional information.

9. Print and read the CF.RELEASE_NOTES located in the FAX$DIR directory.

CompuFax® Hardware

Installa ti on and Configuration

(As shipped, CompuFax is set up to transmit faxes TTA0: device. It can easily be configured to send to a null device for testing. This allows you to demo the software without using a real fax device.

A. SETTING UP A TERMINAL SERVER PORT. (Skip to step B if using a direct connect.)

$ MCR LATCP CREATE PORT LTAxxxx (xxxx is arbitrary #) $ MCR LATCP SET PORT LTAxxxx/ NODE=server_name/ PORT= PORT_n (n is the port # )

(Add the previous two lines to your LAT$SYSTARTUP.COM)

$ MCR NCP NCP>CONNECT NODE servername #ACCESS (or whatever login password has been set for your site) Local> SET PRIV Password> SYSTEM (or password for your site) Local> DEFINE PORT n MODEM CONTROL DISABLED (n is the port #) Local> DEFINE PORT n FLOW CONTROL XON Local> DEFINE PORT n ACCESS REMOTE Local> DEFINE PORT n BROADCAST DISABLED Local> DEFINE PORT n SPEED 19200 Local> DEFINE PORT n INACTIVITY LOGOUT DISABLED Local> DEFINE PORT n AUTOBAUD DISABLED Local> LOGO UT PORT n Local> SET NOPRIV Local> LOGO UT # Ctrl-D (Ctrl-W=Ctrl-D if using MultiSessions with original hotkeys) NCP> EXIT

These commands may not apply to your server. If they do not, set up the port t he same way you would set up a printer port.

B. SETTING UP DIRECT CONNECT LINES. $SET TERM portname:/ SPEED= 19200/ NO MODEM/ PERM

C. CONNECTING THE PORT TO THE FAX DEVICE. Application Programming Interface (API) Class II - (Multi-Tech MT2834ZDX recommended.) Needs a standard modem cable. However, only: (2:Transmit, 3:Receive, 7:Signal Ground) must be connected.

D. CONFIGURING PORT - Type the following line:

$ SET TERM portname:/ ALTYPEAHD/ PERM

and add the above line (and the lines from Step B if you are using a direct connect line) to your OpenVMS Sy stem startup file. The r ecommended App licatio n P r ogr amming In t er face Class I I mod em is t he Mult i-Tech® MT2834Z D X. All Mu lt i-

Tech faxmodems have worked with current proms. Multi-Tech API Class II modems are the only ones recommended. E. TESTING THE CONNECTION. CLASS II (Application Programming Interface Class II, Multi-Tech recommended)

$ SET HOST/ DTE portname: ATQ0 (As soon as the modem says OK, you have communication.) AT+FCLASS=2 (If errors, try again. OK=Modem is FAX API CLASSII) Ctrl-/Ctrl-\ (Normal exit from SET HOST/ DTE)

Note: If device does not respond, recheck these steps.

Preface

Overview

CompuFax will run on VAX/ VMS and OpenVMS versions 5.4 through 7.1, as well as on Alpha-AXP Op enVMS vers io ns 6. 1 th r ou gh 7.1.

Fax documents may be created as ordinary text files and sent with a simple command. D ocuments may be sent eit h er via the Com puF ax co mman d pr ocesso r , via the VMS print mechanism, or via VMS MAIL .

Starting with CompuFax Version 3.2, faxes may be received and printed or viewed. File conversion and bitm a p edit ing fa c ilities have bee n add e d t o fa c ilitat e th e c r e a tio n o f o ve r la y files.

Starting with CompuFax Version 4.0, faxes may also be submitted to the CompuFax fax server from a Personal Computer (PC).

CompuFax permits inter-node communications; that is, fax documents may be sent across a network to another node, which then transmits them by fax modem.

CompuFax provides for automatic look-up of fax phone numbers in a database. Automatic look-up may be wildcarded, which permits sending the same document to multiple destinations (broadcasting,) with a single command.

Com mand s m ay be issued f rom th e com man d line, via a com man d f ile, or via direct ives embed ded in a t ext file that is to be faxed. Multiple files may be concatenated into a single fax document. Using embedded directives, a single text file may be separated into multiple sections, which are then transmitted as individual documents. Documents are queued and may be scheduled for later transmission. Documents may be ass igned d iffe r e nt pr ior ities a nd w ill be tra nsmit ted in prior ity or der .

If a document cannot be sent immediately, it is automatically re-queued for later retransmission. The maximum number of retries and the length of time between retries are selectable.

Mail-merge (form letter) operations are supported where information from a database may automatically be insert ed in to each copy of a docu ment sent . Full activity and st atus rep ortin g is supported with notification via VMS Mail and/ or a broadcast message to the user on completion of document transmission. Status reporting optionally may be enabled or disabled. A library of callable routines has been provided, which allows users to customize CompuFax to use their own database, instead of the one that is provided with CompuFax.

Co mp uFa x c an con trol u p t o 100 f ax devic es (mo dem s ) s imu lt a neou s ly an d will r ou te f ax tra nsmiss ion s t o th e device with the shortest queue. Multiple data formats may be faxed, including ASCII text, T4 format and PostScript files. Text files may be landscaped (rotated by 90 degrees) to allow documents with long text lines to be transmitted.

Two different fonts are provided with CompuFax and users have the option of adding more. Various fonts may be selected within a docu ment. Com puFax f iles may be o verlaid (mer ged) with T4 fo rmat image f iles. Fax coversheets are supported.

Intended Audience

T his manu a l is int e nd e d f or us ers who want to become f amiliar wit h Com pu Fax, Syst e m Man a gers w is hin g t o install and main t ain Co m puF ax an d Pr o grammer s wish in g to int er face oth er applicatio n s with Comp uFax.

How To Use This Manual

T his man ual h as been fu lly revis ed fr om earlier issu es, wit h co ncen tr atio n on legib ility, us efuln ess, accuracy, completeness and aesthetics. Chapter One contains installation instructions, Chapters Two through Four are a tutorial on how to use CompuFax. Chapter Five covers Receive to Disk and related topics. Chapter Six explains about the PC Interface. Th e remaining ch apters co ntain o ther impo rtant info rmatio n. Ap pend ix A con t ain s t he Com puF ax Release No tes (refer t o text file CF32.RELEASE_NOTES, ship p ed with Compu F ax, for the latest additions.) A glossary and an index have been added to make this manual even more useful.

Table of Contents

PREFACE

................................

....

IX

O

VERVIEW

................................

...

IX

TABLE OF CONTENTS

................................

..............

XI

COMPUFAX INSTALLATION

................................

...

1

1.1 O

VERVIEW

................................

..............................

1

1.2 H

ARDWARE INSTALLATION

................................

.....

2

1.2.1 Fax Modem Device

................................

.........

2

1.2.2 Modem Cabling

................................

...............

2

1.2.3 Terminal Port Characteristics

................................

........................

2

1.2.4 Server Port Characteristics

................................

............................

3

1.2.5 Multiple Systems

................................

.............

3

1.3 S

OFTWARE INSTALLATION

................................

......

3

1.3.1 Evaluation Without Modem

................................

............................

3

1.3.2 Full Device Server Installation

................................

......................

4

1.4 C

USTOMIZATION

................................

.....................

4

1.4.1 Full Device Server Setup

................................

4

1.4.2 Full Device Server Startup

................................

.............................

5

1.4.3 Remote Fax Server Installation

................................

......................

5

1.4.4 Remote Fax Server Setup

................................

6

1.5 R

EMOTE FAX SERVER STARTUP

................................

...............................

6

GETTING STARTED AS A COMPUFAX USER

................................

......

7

2.1 W

HAT IS COMPUFAX

?

................................

...........

7

2.2 G

ETTING STARTED

................................

..................

7

2.3 S

ENDING A FAX

................................

......................

8

2.4 C

HECKING IF YOUR FAX WAS SENT

................................

.......................

8

2.4.1 An Even Simpler Way to Send

................................

.........................

9

2.5 E

MBEDDING FAX NUMBERS INTO DOCUMENTS

................................

.......

9

2.6 "P

RINTING

" TO T

HE FAX DEVICE

................................

............................

9

2.7 S

ENDING FAXES USING

VMS M

AIL

................................

.......................

10

2.7.1 Using CompuFax Qualifiers with VMS Mail

................................

...............................

10

2.7.2 Embedding Numbers in VMS Mail

................................

...............

10

2.8 G

ETTING HELP

................................

......................

11

MORE ABOUT SENDING FILES

................................

..............................

3

3.1 S

ENDING MULTIPLE FILES

................................

.......

3

3.2 S

ENDING DIFFERENT FILE TYPES

................................

............................

3

3.2.1 Text Files

................................

.........................

4

3.2.2 Bitmapped Files

................................

..............

4

3.2.3 PostScript Files

................................

...............

4

3.3 U

SING DIFFERENT FONTS

................................

........

5

3.4 S

ENDING LANDSCAPED FILES

................................

..

5

3.5 S

ENDING FILES WITH OVERLAYS

................................

............................

6

3.6 S

ENDING FAXES WITH COVERSHEETS

................................

.....................

6

3.7 S

ENDING BREAKUP FILES

................................

........

7

3.8 U

SING THE LOOKUP FEATURE

................................

.

9

3.9 L

OOKUP WITH WILDCARD

................................

....

10

3.10 B

ROADCASTING FAXES

................................

.......

10

3.11 P

ERSONALIZING BROADCAST FAXES

................................

...................

10

3.12 M

ERGING FROM THE COMMAND LINE

................................

................

11

3.13 D

EFERRED SENDING

................................

............

12

3.14 D

ELETING ENTRIES AFTER SENDING

................................

...................

12

3.15 S

ETTING PRIORITIES

................................

............

13

3.16 L

OGOS AND LETTERHEADS

................................

..

13

OTHER COMMANDS

................................

...............

14

4.1 U

SING COMMAND FILES

................................

.......

14

4.2 T

HE

VERIFY C

OMMAND

................................

......

15

4.3 T

HE

DELETE C

OMMAND

................................

.....

16

4.4 K

EEPING TRACK OF WHAT YOU DID

................................

....................

17

RECEIVE TO DISK

................................

....................

18

5.1 O

VERVIEW

................................

............................

18

5.2 R

ECEIVING FAXES

................................

.................

18

5.3 P

RINTING FAXES

................................

...................

19

5.3.1 Fax Printer Setup

................................

..........

21

5.3.2 Verifying Printer Options

................................

.............................

22

5.3.3 The PRINT Command

................................

....

22

5.4 V

IEWING FAXES

................................

....................

22

5.4.1 The VIEW command

................................

......

23

5.4.2 Using CF_REC_TOOLS.COM

................................

......................

23

5.5 C

ONVERTING FAX FILES

................................

.......

24

5.5.1 The CONVERT Command

................................

.............................

24

5.5.1.1 Qualifiers

................................

...................

24

5.5.1.2 Examples

................................

....................

25

THE PERSONAL COMPUTER INTERFACE

................................

........

27

6.1 I

NTRODUCTION

................................

.....................

27

6.2 I

NSTALLATION

................................

......................

27

6.3 P

OSTSCRIPT DRIVER INITIALIZATION

................................

....................

28

6.3.1 Adding a Printer Driver

................................

29

6.3.2 Adding a Port Name

................................

......

30

6.3.3 Windows 3.1 PostScript Driver Initialization

................................

..............................

30

6.3.4 Disclaimer

................................

.....................

30

6.4 U

SING THE

PC I

NTERFACE

................................

.....

30

6.4.1 Requirements

................................

.................

30

6.4.2 Features

................................

........................

31

6.4.3 Sending a Fax

................................

................

31

6.4.4 The Destination Screen

................................

.

31

6.4.5 Help Screens

................................

.................

32

6.4.6 T

HE LOOKUP SCREEN

................................

........

32

6.4.6.1 The Lookup File

................................

.........

32

6.4.6.2 Adding Lookup Entries

................................

...............................

32

6.4.6.3 Selecting

................................

.....................

32

6.4.6.4 Broadcasting

................................

..............

32

6.4.6.5 Deleting an Entry

................................

.......

32

6.4.6.6 Editing an Entry

................................

.........

33

6.4.7 The Coversheet Screens

................................

33

6.4.7.1 The Coversheet Selection Screen

................................

...............

33

6.4.7.2 The Coversheet Information Screen

................................

..........

33

6.4.8 The Options Screen

................................

.......

33

6.4.8.1 Logo

................................

............................

33

6.4.8.2 When to Send

................................

..............

34

6.4.8.3 Resolution

................................

..................

34

6.4.8.4 File List

................................

......................

34

6.4.8.5 The Buttons

................................

................

34

6.5 Setup

................................

.

34

6.5.1[Server] Path

................................

.................

35

6.5.2 [Defaults]

................................

......................

35

6.5.3 [Coversheets]

................................

................

35

6.5.4 [Files]

................................

...........................

36

6.6 M

AKING THINGS EASIER

................................

.......

36

6.6.1 Saving Fax Numbers

................................

.....

36

6.6.2 Looking Up a Saved Fax Number

................................

.................

36

6.6.3 Setting Up a Default Recipient

................................

.....................

36

6.6.4 Adding, Changing or Deleting a Lookup Entry

................................

............................

36

6.6.5 Sending The Same Fax to Multiple Destinations

................................

.........................

36

6.6.6 Sending Routine Faxes

................................

..

36

6.6.7 Frequently Used Files

................................

...

37

6.7 H

OW TO MODIFY A COVERSHEET

................................

..........................

37

6.7.1 Sample Configuration File

................................

...........................

37

6.7.2 Sample File Explained

................................

..

38

6.7.3 The Include File

................................

............

38

SUMMARY OF COMMANDS AND DIRECTIVES

................................

40

7.1 C

OMMANDS

................................

..........................

40

7.2 D

IRECTIVES

................................

...........................

55

7.2.1 File Directives

................................

..............

55

7.2.2 Mail-Merge Directives

................................

.

57

COMPUFAX FILES AND LOGICAL NAMES

................................

........

59

8.1 D

IRECTORIES

................................

........................

59

8.2 F

ILES

................................

....

59

8.3 C

OMPUFAX LOGICAL NAMES

................................

63

COMPUFAX MESSAGES

................................

.........

65

9.1 I

NTRODUCTION

................................

.....................

65

9.1.1 Facility Codes

................................

...............

65

9.1.2 Severity Levels

................................

..............

65

9.1.3 Message Routing

................................

...........

66

9.2 A

LPHABETICAL LISTING OF MESSAGES

................................

..................

66

PROGRAMMING INFORMATION

................................

.........................

78

CompuFax provides two facilities to customize its user interface:

................................

......

78

•

Database Interface

................................

..............

78

•

Callable Command Interface.

................................

.............................

78

10.1 U

SER-WRITTEN DATABASE APPLICATIONS

................................

..........

78

10.1.1 Working With CompuFax

................................

............................

78

10.1.2 Using The FDB Routines

................................

............................

79

10.1.3 CompuFax Database Function Library

................................

......

80

10.1.3.1 FDB_CLOSE

................................

............

80

10.1.3.2 FDB_DELETE_MSG

................................

80

10.1.3.3 FDB_GET

................................

.................

80

10.1.3.4 FDB_GET_CONTEXT

................................

..............................

82

10.1.3.5 FDB_INIT

................................

.................

83

10.1.3.6 FDB_NOMATCH

................................

......

84

10.1.3.7 FDB_SAVE_CONTEXT

................................

............................

84

10.1.3.8 FDB_SCAN

................................

...............

85

10.1.3.9 FDB_SEND_DATA

................................

...

86

10.1.3.10 FDB_SET_FIELD

................................

..

86

10.1.3.11 FDB_SET_MATCH

................................

87

10.1.3.12 FDB_SET_NUMBER

................................

..............................

87

10.1.3.13 FDB_SET_STATUS

................................

88

10.1.3.14 FDB_START_MSG

................................

.

88

10.1.4 TESTDB.EXE

................................

...............

89

10.1.4.1 LOOKUP

................................

..................

89

10.1.4.2 CLOSE

................................

......................

89

10.1.4.3 SHUTDOWN

................................

.............

89

10.2 T

HE COMPUFAX CALLABLE INTERFACE

................................

..............

90

10.2.1 Callable Commands

................................

....

90

10.2.1.1 FAX_CMD_PROC

................................

....

90

10.2.1.2 FAX_CMD_SET_HANDLE

................................

......................

90

10.2.1.3 FAX_CMD_SET_INPUT

................................

..........................

91

10.2.1.4 FAX_CMD_SET_OUTPUT

................................

......................

91

10.2.1.5 FAX_CMD_SET_USER

................................

............................

92

10.2.1.6 FAX_CMD_FORCE_EXIT

................................

.......................

92

10.2.1.7 Linking Modules

................................

......

93

APPENDIX A

................................

...............................

95

A.1 R

ELEASE

3.1.00 C

HANGES

................................

...

95

A.2 R

ELEASE

3.0.01 C

HANGES

................................

...

95

A.3 K

NOWN PROBLEMS

................................

..............

96

A.4 R

ELEASE

2.2.00 C

HANGES

................................

...

97

A.5 R

ELEASE

2.1.00 C

HANGES

................................

...

97

A.6 R

ELEASE

1.2.04 C

HANGES

................................

...

99

G

LOSSARY

................................

101

1

C ompuFax Installation

1.1 Overview

Several configuration decisions should be made prior to installation of the CompuFax product. This overview has been provided for your convenience and may be used as a guideline in making those decisions. Fax modem hardware may be installed on one or more VAX or Alpha AXP computer nodes. Multiple fax modems may be connected to a single system or distributed over several nodes. Nodes with attached fax modems are referred to as Full Device Server nodes. In addition, you may elect to have other systems on a network or cluster use CompuFax to transmit files. The other systems may be configured as Remote Fax Server systems. Although Remote Fax Server systems do not have actual fax modem devices connected, they are par t of t h e Comp uFax system.

Full Device Server---the main function of the software is to transmit faxes via one or more fax modems to their destinations.

Remote Fax Server---the software is designed to send faxing information and fax commands to the Full Device Server node, from which faxes are then transmitted. On a multi-node system, prior to installation, you will n ee d t o es tablish which s ystem s ar e to be Fu ll Device Server nodes and which systems will b e th e Remo te Fax Server nodes. In addition, it is necessary to distinguish VAX from Alpha AXP systems, when loading CompuFax software, as their executable files are unique (although functionally the same.) Typically, systems capable of higher traffic volumes would be assigned as the Full Device Server nodes. The decision of how many fax modems to allocate depends primarily on how many fax lines will be required to handle the estimated fax traffic.

The CompuFax installation procedures contain both hardware and software installation. The Hardware Installation section contains details on configuring the fax modem device(s), while the Software I nstallation section includes specific instructions for loading the software. The following sections provide explicit instr uctio n s p er tinen t t o each oper at io n.

T he C om pu Fax installation proce du res a re id e nt ic a l, wheth e r you a r e installing t he VAX product or the Alpha AXP product, although there are distinct procedures depending on whether you are loading Full Device Server or Remote Fax Server software.

For limited evaluation purposes, the CompuFax software may be installed without a fax modem device, which means that faxes cannot be transmitted. H owever, the user interface feat ures m ay be test ed without the actual hardware. The fax hardware may be installed at a later date, if desired. I f you are planning only to evaluate the product without the use of a modem device, please proceed t o th e s ect io n ent it led Sectio n 1. 3.1.

1

2

1.2 Hardware Installation

This procedure is performed only for Full D evice Server software.

1.2.1 Fax M odem Devic e

A Class II fax modem device is required for use with the CompuFax product. The MultiTech MT2834ZDX fax mo d em (19,200 dat a/ 14, 400 fax) has been t est ed fo r p er fo rm an ce an d relia bilit y, an d is th e re co mm en de d modem device.

1.2.2 Modem Cabling

A stan d ar d serial mo dem cable can b e u s ed to connect t he mo dem t o the ter m in al server (LAT) o r har d-wired term in al p ort (T X, TT, et c. ). The f ollowing signal lines m u s t be connect ed:

Pin 2 T ransmit Pin 3 Receive Pin 7 Signal G round

1.2.3 Terminal Port Characteristics

To ensure transmission of files via CompuFax, the terminal port or LAT port characteristics must be co nfig ure d cor r e c tly. T hes e ter min a l par a met e rs will be th e s a me whet her t he mo dem devic e is co nn ected to a D E C server or to a d irect-co nn ect p or t (TX, TT , etc.). U se th e examples sh own her e as th e pro p er sett ing of th e p ort ch ar acteristics.

$ SHOW TERMINAL T erminal: _ L TA9008: Device_Type : Un know n Owner : F ax Server U s e rn a me: SYSTEM LAT Ser ver / Por t: DS100/ POR T_8 Input: 19200 LF f ill: 0 Width : 80 Par it y: Non e Ou tp ut : 19200 C Rfill: 0 Pa ge: 24 1--2 CompuFax Installation

Ter minal Char act er ist ics: I n teract ive No Ech o Type_ahead No E scape Hostsync T Tsync Lo wer case Tab No Wrap Scope N o Remote Eight-bit No Broadcast No Readsync Form Fulldup No Modem No Local_echo No Autobaud H angup No Brdcstmbx N o DMA Altypeahd Set_speed No C om msyn c No Line Edit ing Overstr ike edit ing No F allbac k No Dialup No Secure server No Disconnect Pasthru No Syspasswor d No SIXE L Gr ap hics No Sof t Charact er s No Prin t er P o r t Numeric Keypad No ANSI_CRT No Regis No Block_mode No Advanced_video No Edit_mode No DEC_CRT No DEC_CRT2 No DEC_CRT3 No DE C_CRT4 VMS Style Input

3

1.2.4 Server Port Characteristics

$ MCR NCP NCP> Connect NODE nodename Local> SHOW PO RT n (n = port number) Por t 8: (Remot e) Character Size: 8 Input Speed: 19200 Flo w C on trol: XON O utpu t Spe ed: 19200 Parity: N one Access: Remote Lo cal Switch: No ne Backw ard s Sw itch : None Name: POR T_8 Break: Disabled Session Limit: 4 Forwards Switch: None Type: ANSI Pref er red Service: Authorized Groups: 0 (Current) Groups: 0 Enabled Charact erist ics: Autoconnect, Autoprompt, Input Flow Control, Loss Notification, Message Codes, Output Flow Control, Verification

1.2.5 Mult iple System s

The CompuFax software is shipped as a saveset on tape. If you plan to load the software on multiple systems, you may fin d th e in s talla tio n will p ro ceed faster if t he saveset is cop ied fro m the d istribu tion m edia to d isk, moved to the designated systems and then inst alled from disk. Fo r multiple systems follow the st eps listed here:

Create a t empo r ar y target d irector y in which to lo ad the f iles: CompuFax Installation 1—3 $ CREATE / DIRE CTOR Y target-directo r y

Move to t he tar get d ir ect o r y you just cr eat ed: $ SET DEFAULT target-directory

Mount the tape drive unit for reading: $ MO U NT t ape-drive: N DC

Move the savesets from tape to disk using the command below. Substitute the correct product name; FAX031.A f or a VAX s yste m or F AX_AXP 031.A for a n Alpha AXP s ystem. $ CO PY tape-drive:product [ ]

1.3 Software Installation

1.3.1 Evaluation Without Modem

If you are planning only to evaluate the product without the use of a modem device or any fax hardware, please install the product as indicated in the procedure below and enter 'No' when prompted for the modem. CompuFax will automatically configure the software accordingly for a null device. Then, proceed to the section entitled Sectio n 1.4.2.

4

1.3.2 Full Device Server Installation

If you do not plan on using the Remote Fax Server on other nodes, perform each step related to a Full D evice Server on ly. Place t he d istrib ut ion m edia in t he d rive to begin th e installatio n. U se VMSINSTAL to load th e correct files on to your system. If you perfo rmed th e step s in t he Sectio n 1.2.5 sect ion an d co pied th e saveset t o disk, rep lace t ap e- drive: with t h e name o f the t ar get - directo r y you creat ed ear lier.

$ @SYS$UPDATE:VMSIN STAL product tape-drive:

Substitute the correct product name in the above command; FAX for a VAX system or FAX_ AXP f or an Alph a AXP s ystem.

Answer the VMSIN STAL questions as shown below:

Is this node a FAX Full D evice Server node? (Y/ N) [Y]: Yes Remot e Se rve r o n s am e dis k ? (Y/ N) [N]: No * Do you want t o purge files rep laced by this inst allatio n [YES]? No Will yo u b e using a Mult iTec h f a x mo dem? (Y/ N) [Y]: Yes (N = n o f a x devic e )

Not e: Even if you ar e n ot using a MultiTech modem select ' YE S'.

1.4 Customiza tion

O nce t he Co mp uF ax soft ware h as been loaded , you m ust cust om ize defau lt values for each system that will be running CompuFax. This step is not performed if you are only evaluating the software, without a modem device.

1.4.1 Full Device Server Setup

Edit the CompuFax options file to include site-specific information and modify the section containing information lines for a Class II m od em:

$ EDI T installation_disk:[FAX]FAX.OPTI ON S

A sample of the lines that should be modified in the FAX.OPTIO NS file, is shown here:

! **** F or a Class II fax mod em remove th e e xclamation marks a t th e start of ! each line below an d chan ge t he device n am e an d area co de, as ap pro priate. !device TT A1: - ! **Change to port name of modem. ! / prefix=(rem ove= ("1818")) - ! **Change to your area code. !- ! Called Sub scr ib er Id entificat ion: ! / cs i= " (818) 248-5253" - ! **Change to your fax number or other !- ! text to identify you as the sender !- ! of a f ax (up to 20 ch ar act er s. ) T he !- ! csi is includ ed in t h e header line !- ! of the faxes you send. ! / d evice_ t ype=CLASS_2 - ! Modem type. ! / n oreceipt - ! Receive no t implemen t ed yet. ! / class=0 - ! Com puF ax classification. ! / speed= 19200/ s peed2= 19200 - ! Speed in data mode and fax mode.

5

1.4.2 Full Device Server Startup

CompuFax is composed of a main executable image and several other images that support various features. The st ar t u p comman d file def ines lo gicals, creat es directories an d in s t alls the cor r ect im ages o n the system.

Start the Co mpuFax Full D evice Server $ @FAX$DIR:F AX_SYSTARTU P

Warning: Full Device Server and Remote Fax Server startup procedures are never executed on the same node. Verify the startup procedure was successful and CompuFax processes are running:

$ SHOW SYSTEM VAX/ VMS V5.5 on node TEST 3-JUL-1995 10:35:01.25 Up time 21 03:57:37 Pid Process N ame State Pri I/ O CPU Page flts Ph.Mem 00000120 Fax DB LEF 4 19 0 00:00:01.00 232 223 00000122 Fax Ser ve r L EF 9 162722 0 00:40:31.54 88398 841 00000126 Fax_Mail LEF 9 2914 0 00:02:21. 77 62141 101 S 00000127 Fax_Cvt L EF 2 77 0 00:00:22.63 4233 1155

I n vo ke t he com mand belo w t o creat e t h e s ymbol FAX as a co m m and: $ @FAX$DIR:F AX_SYLO GIN Enter the @FAX$DIR:FAX_SYSTARTUP command in into your system startup command file and the @F AX$DIR :FAX _SYLOG I N in t o yo ur syst em -wid e lo gin file , wh ich will cau s e th e C o mp u Fax so ft war e to be st ar t ed each time the system is rebooted. Allow a few minutes for CompuFax to establish communications with t he fax modem and brin g the device o n - line. Verif y that the device is ready:

$ FAX SHOW DEVICE Index Device name Type Class State Entries # Sent # Rec 1 LTA9008: Clas s 2 0 On Lin e 0 0 0

Note: If you are evaluating the product without a modem, the device name will b e NLA0.

Once comm unicat ion has b een established and t he device is on-line t he inst allatio n is comp let e.

1.4.3 Remote Fax Server Installation

Use VMSINSTAL to load the correct files onto your system. If you performed the steps described in the Section 1.2.5 section and co pied t he save set to disk, replace t ape-dr ive: below wit h the n ame of t he target direct o r y you creat ed ear lier.

$ @SYS$UPDATE:VMSIN STAL product tape-drive:

Substitute the correct product name in the above command; FAX for a VAX system or FAX_ AXP f or an Alph a AXP s ystem.

After VMSINSTAL begins to restore the product save set, you will b e asked sever al qu estio ns. Answ er th e ones displayed here as follows:

Is this node a FAX Full D evice Server node? (Y/ N) [Y]: N o * Do you want t o purge files rep laced by this inst allatio n [YES]? No

6

1.4.4 Remote Fax Serv er Setup

Configure the Remote Fax Server startup options to indicate the node(s) you have designated as your Full Device Server systems(s). Edit the Remote Fax Server startup command file to include the node name(s) of the system(s) this node will u s e as Full Device Ser ve r fo r tr a nsmit tin g faxes :

$ EDIT F AX$DIR:F AX_REMSTART. COM Search for the line containing "**" and add the node name(s).

Here is an example of the line that should be modified: $ DEFINE/SYSTEM/NOLOG FAX$SERVER_NODE NODE1, NODE2

!**Change NODE1 ... to your !node name(s) with Fax Device Full servers.

1.5 Remote Fax Server Startup

The startup command file will info rm the CompuFax Remot e Fax Server p rocess wh ich system h as been designat ed as t h e F ull D evice Server system.

Start the Co mpuFax rem ote ser ver pro cess : $ @FAX$DIR:F AX_REMSTART

I n vo ke t he com mand belo w t o creat e t h e s ymbol FAX as a co m m and: $ @FAX$DIR:F AX_SYLO GIN

Enter the @FAX$DIR:FAX_REMSTART command into your system startup command file and the @F AX$DIR :FAX _SYLOG I N in t o yo ur syst em -wid e lo gin file , wh ich will cau s e th e C o mp u Fax so ft war e to be st ar t ed each time the system is rebooted.

Verify that the CompuFax Remote Fax Server software is running:

$ FAX SHOW SER VER Comp uF ax r e mo t e s er ve r up s ince 3- JU L -1995 12:34:35 FAX server nodes assigned to this node: TEST Current FAX server node is TEST

If the Server node is not displayed, check that the Full Device Server processes are running.

7

G etting Started As a C ompuFax User

2.1 W ha t Is CompuFax?

CompuFax is a collection of computer programs that lets you send fax document files directly from your VAX or Alph a-AXP VMS ter min al or wor kstat ion . Co mp u Fax is a so ft ware p ackage with m any op tio ns an d supporting features that make it powerful, yet easy to use.

2.2 G etting S tarted

A CompuFax user can verify that CompuFax is running on the system with the FAX SHOW QUEUE com m and. Here is an examp le:

$ FAX SHOW QUE UE CompuFax queu e repo rt as of 27- JUN -1994 12:51:58.11 0 FAX server queue entries

If you do not get this type of display, contact your System Manager, as CompuFax may not have been installed yet, or is not running. Chapter 1 provides information on how to install and start up CompuFax. Loo king at the above example, the word q ueu e refers to a list of f axes th at are waitin g to be sen t. T h e qu eue is empt y here, so th ere are n o f axes to s end . T he d ollar sign ($) in th e example ind icates th e system p ro mp t, which may be different on your system.

Gett in g Started As a Comp uFax U ser 2-- 1

2

8

2.3 Sending a Fax

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

Usin g your favorite t ext editor , create a sh ort t ext file, called T EST FAX.1 and ent er t he fo llo wing lines o f text:

This is a tes t. I am sending a short message with CompuFax. CompuFa x make s fax ing ea s y!

Send you r f ile to your office f ax machine, using t h e exam ple below:

$ F AX F AX> SEN D TESTFAX.1 / NU MBER=123-4567 (Su bstitu te you r fa x n u mber) FAX> EXIT

Within minutes your fax should print out on your fax machine.

2.4 Checking If Your F ax W as S ent

How do you tell if a fax has been sent? When you tell CompuFax to send a fax, you should get a D CL or FAX> promp t back almost im m ediately, but all th at means is t hat Co m p uFax has r eceived the co mman d an d has p laced t he inf o r m ation in t o a queue, until the f ax can be sent.

The document may not be sent right away, depending on several factors. For example, another user may be busy sending, or the recipient's phone line may be busy.

The SH OW QUEUE command shows the status of your fax, as shown in the example below:

$ FAX SHOW QUE UE CompuFax queu e repo rt as of 24- MAY-1994 09:22:26.77 Conversion queue : ID User Priority State Activation Time 2 P _SMIT H 100 Convert 1 FAX server queue entries

The above example shows one queue entry (fax document), which is being converted into the correct format for s e nd ing. Aft er t he f a x docu ment has been s ent , you w ill ge t som ethin g like th is :

2--2 Getting Start ed As a Com puF ax U s er

$ FAX SHOW QUE UE CompuFax queu e repo rt as of 24- MAY-1994 09:26:34.26 0 FAX server queue entries

As you can see, the queue entry that was there before is now gone, indicating that the fax has been sent. (Note: The SH OW Q UEUE command only shows your own queue entries, not those of other users. To see everyone's queue entries, use SHO W QUEUE / ALL.)

9

2.4.1 An Even Simpler Way to Send

Instead of going into the CompuFax program first, you can enter the command directly from the DCL com m and line:

$ F AX SEN D TESTFAX. 1 / NUMBER=123-4567

Com p uFax execut es t he above com m and an d then r et urn s contro l to DCL. More examples of entering fax phone numbers:

$ F AX SEN D TESTFAX. 1 / NUMBER=1234567 $ F AX SEN D TESTFAX. 1 / NUMBER=1-555-123-4567 $ F AX SEN D TESTFAX. 1 / NUM=15551234567 $ F AX SEN D TESTFAX. 1 / NUM="9,15551234567"

The hyphens may be eliminated and the / NUMBER qualifier may be abbreviated to 3 characters. If it is necessar y to dial an acces s cod e to get an o ut side line, enclose t he acces s co de, a com ma and th e f ax phone number in quotation marks, as in the last example above.

2.5 Embedding F ax Numbers Into Documents

There is another way of communicating a fax phone number to CompuFax. The fax number may be included (embedded) in the document itself, using a CompuFax file directive. Modify TESTFAX.1 by adding a line with the fax phone number at the top and save the file as TESTFAX.2:

# # N UMBER 1-555-123-4567 This is a tes t. I am sending a short message with CompuFax. CompuFa x make s fax ing ea s y!

Now, you can send the fax without having to specify the phone number on the command line:

$ FAX SEN D TEST FAX.2

T he file will be f a xe d t o t he phone number you embedded in the text file.

2.6 "Printing" T o The Fax D e vice

There is yet another way to send your fax. This is especially useful if you have programs that can send documents to a printer. Many times, this feature enables you to fax documents from such a program without making any changes to the program and without leaving the program.

This command sends the TE STFAX.2 file with the embedded fax phone number:

$ PRINT / QUEUE= SYS$FAX TESTFAX.2

To verify that your file is being faxed, use the command:

$ FAX SHOW QUE UE

10

2.7 Sending Faxes Using VMS Mail

Here is a way you can send a fax fr om within VMS Mail:

$ MAIL MAI L > SEND TEST FAX.1 To: FAX%1-555-123-4567 Subj: Sending File T ESTF AX. 1 MAIL>

At the To: prompt, enter FAX% followed by the fax phone number, without any spaces between t h em.

2.7.1 Using CompuFax Qualifiers with VMS Mail

To include qualifiers with a fax sent from VMS Mail, enter the qualifiers after the fax phone number. E nclose the fax phone number and qualifiers within quotation marks.

For exam ple:

MAI L > SEND TEST FAX.1 To: FAX%" 1-818-248-525 / AFTER= TO MORRO W" Subj: Test Fax He ld U ntil Next Day MAIL>

The / AFTER= TO MORROW qualifier tells CompuFax to hold the fax and not send it until the following day.

2.7.2 Embedding Numbers in V M S Mail

It is not necessary to enter the fax phone number when faxing a file using VMS MAIL. T he fax number may be embedded within the file and at the To: prompt simply enter the FAX% with a "null string" (two quotation marks.)

Use the second file you created for the next example:

MAI L > SEND TEST FAX.2 To: FAX%"" Subj: Using Em be dde d P ho ne N um be rs MAIL>

Or, with a qualifier only:

MAI L > SEND TEST FAX.2 To: F AX%" / AFT ER=TO MORROW" Subj: U s ing Qualifiers With Em bedde d Numbers MAIL>

No te: If you send a f ax message via VMS Mail, th e result ing mes s ag e w ill r e s e mb le a typica l VMS Mail message, as sh o wn in t h e exam p le b elo w:

11

F rom: VS4000::P _SMITH 15-JUN -1994 11:52:38.95 To: FAX%"" CC: P_SMI TH Subj: Sending File T ESTF AX. 1 This is a tes t. I am sending a short message with CompuFax. CompuFa x make s fax ing ea s y!

2.8 G etting Help

You can basically teach you r self Comp uFax b y studying the Help t ext . F rom t he DCL comm and line, you can enter:

$ F AX HE L P

A H elp s creen disp lays, fro m which you can th en select a t opic t o study. Th e Co mpu Fax Help text wor ks just like the VMS Help t ext. You can also access H elp f rom within Com pu Fax by enter ing t he H E LP co mm and from the FAX> prompt. As in DCL, you exit Help by pressing Return in answer to the T opic? prompt.

2

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

3

More About S ending F iles

I n the pr evious chap ter, we covered som e simp le ways to sen d faxes. Since t he SE N D co mm and is th e mo st important command in CompuFax, we devote this chapter to more of its options. (This does not complete th e list, however , sin ce s o m e option s ar e r elat ed t o System Managemen t . F or a co mplet e list, s ee Ch apter 7.)

3.1 Sending Multiple Files

You can send multiple files, all as part of the same fax. For example, if you have five files (named doc.1 through doc.5) to send in a single fax, you can give the command:

$ F AX SEN D do c.1, d oc.2, do c.3, d oc .4, d oc. 5 / N UM BER=1-555- 123-4567

These files are joined together (concatenated) to make up a single document. For example, if each of the ab ove five files co nt ain s te n line s of tex t, th e f in al d ocu m en t will co nt ain 50 lin es of te xt o n a s ingle pa ge. I f each o f t he files is supposed to start on a new page, this may be done by embedding a ##PAG E directive at th e en d of each f ile, except th e last . See Ch ap t er 7 f o r m ore inf orm at io n . In s t ead o f # # P AGE you can ins er t a Con t r ol-L ch ar act er in t o th e t ext f ile, wh erever a p age b r eak is t o occur .

3.2 Sending Different File Types

In addition to regular text files, as we did in our earlier examples, you can also send compressed bitmap files, called T 4 files, an d Po s t Scrip t f iles. Th ese t hree file types ar e exp lained below.

3

4

3.2.1 Text Files

Th e simp lest file type is a regu lar text f ile, such as th e on es we sent in t he examp les of th e previo us chap ter . These files are also referred to as printer format files or ASCII (American Standard Code for Information I n terch an ge) files. This t ype o f f ile can b e cr eated with a simp le t ext ed it o r .

3.2.2 Bit mapped Files

In addition to text files, there are also graphics or bitmapped files. The difference between a text file and a bitmapped file is that in a text file, the letter A, for example, is represented by a number, while in a bitmapped file the s ame lett er is rep resen ted as a pat tern of black and white d ot s (bits) t hat ar e arran ged in the sh ape of the letter A.

T he e xa mp le below illustra tes th is :

TEXT (ASCII) GRAPHICS (BITMAPPED) o ooooo A = 65 o o o E = 69 o o oooo o o o o o o o ooooo

The ASCII system is the more efficient method of transmitting data, but is limited to text only. To send pictures, you need bitmapped files. All files, including text files, are actually sent from one fax modem to another, as bitmapped files. When you send a text file, CompuFax first converts it into a bitmapped file befo re send ing it on t o th e receiving f ax station . Since b itmapp ed files are mu ch bigger t han text files and therefore take longer to transmit, various compression methods have been devised, to reduce the file size. T he compression method used by fax modems is called the T.4 standard format), or T4 for short.

3.2.3 PostScript Files

Another type of file is a PostScript file, which is actually a text file that describes how a page is to be printed. If you try to print a PostScript file to a printer that does not "understand" the PostScript language, you get a lot of gobbledygook.

CompuFax has a built-in PostScript interpreter. 1 , which converts the PostScript file you may wish to send into a T4 bitmapped image of how the final result is supposed to look on the page and then transmits it to the receiving fax stat io n, wher e it is p r o ces sed like a regular fax d o cumen t. To m ake it eas y for CompuF ax to tell th e differen ce between t he t hree t ypes of files, it assu mes t hat all T4 file nam es have a .T 4 file exten sion and all PostScript files have a .PS extension. Any other extension is considered to refer to a text file, although your System Manager may have changed these rules. 1 PostScript file conversion requires a PostScript license option.

If you are sending files that do not follow the above rules, you can use the / FORMAT qualifier to specify the corr ect f ile fo r mat. F or example:

$ F AX SEN D FIL E.COMPRESSED / FORMAT = T4 / NU M = 1-555-123-4567

5

3.3 Using Different Fonts

Th e wor d font is a prin ting term, which d enot es letters o f a certain st yle (called a typef ace) and of a cert ain size. When Co mpuF ax converts a text file into the T 4 format , it uses a sp ecial file, called a fon t file, in its conversio n. Two differen t font files are shipped with CompuFax; one of the font files will p rint at least 8 ch aracter s p er in c h and th e ot her w ill print a t least 1 2 c har a cters per inch.

Other fonts can be added as needed 2 To change the font in a fax from the default font, add th e / FONT q ualifier. For example:

$ FAX SEN D TEST FAX.2 / FO N T=132

T his examp le a ctivat es th e FAX$F ON T_DIR :132.FNT f on t file. You can also chan ge th e f on t with a # # FONT f ile direct ive insid e a text file. For exam p le:

##FONT 132

Som e com pu t er gener at ed do cu m ent s con t ain t ext with u p t o 132 cha ract er s pe r lin e. Co m pu Fa x can han d le these by using the alter nat e f on t file (132. f nt ) and la nd sc ape orient atio n (see the next s ec tion.)

3.4 Sending Landscaped Files

A landscaped page is a page whose image has been turned on its side, as opposed to a page in portrait orientation, such as the one you are reading now. You may wish to use landscaping 3 if your fax has lines of text that are too long to fit on a regular printed page, which is about 8 inches wide by 10.5 inches high. Normally, you get about ten characters per inch, so a landscaped page allows for about 105 ch aracters per line, as opposed to about 80 with portrait orientation. If you need more than 105 cha ract er s p er lin e, you can res or t to th e a lt e rn ate f on t (132.f nt , ) which will yield over 140 ch a r a c t e rs per line in lan dsc ape or ient a tio n.

Font files must reside in the FAX$FON T_DI R: directory (this is usually the same directory as FAX$D IR:) and must have a file name extension of .FNT. The default font file is always FAX$FONT _DIR:STD FONT .FN T. The font files used by CompuFax are so-called soft-font files, of the type that is compatible with Hewlett Packard LaserJet printers. Several vendors market these fonts inexpensively.

Landscaping requires the Overlay/ Landscape license option. The landscaping feature operates on text files only. It is ignored in other file formats.

Lan dsc ape or ient atio n is achieve d with the / L AN D SCAPE qu alifier . T his q ualif ier is p osit ion al: if it occu rs be fo re th e n am e o f t h e f irst f ile t o b e s en t, it a pp lies to all t he f ile na me s th at fo llo w it ; o th er wise, it ap p lies on ly to t h e f ile name th at imm ed iat ely preced es t he qualifier.

Landscape exam ple:

$ FAX SEN D TESTF AX. 2 / L ANDSCAPE

I n s t ead of a / L ANDSCAPE q u alifier in the comm an d line, you can in clu d e a # # LANDSCAPE file d irective in the text file you want to send. If you do this, make sure that the ##LAND SCAPE directive appears right at th e s tar t of t he fax p age you wan t t o lan ds cap e, ot h er wise la nd sc ap ing w ill st art wit h t he n ext fax p age (if any.)

6

3.5 Sending F iles With Overlays

An o verlay, in terms of Comp uFax, is an im age t h at is s u perimp osed o n anoth er image. An examp le of th is is a form o verlay, su ch as an invo ice, which is overlaid o n (merged wit h) the text that is t o be p rinted o n th e for m . An overlay file must always be in T 4 f o r m at. Overlay files are specified with a / OVERLAY qualifier in the SEND command 4 .

Here is an example:

$ F AX SEN D MEMO .TXT / OVERLAY=(FIL E: D RAW.T4, REPEAT) / N UM=123-4567

I n t he above examp le, MEMO.TXT is th e t ext f ile to be o verlaid. T he / OVE RL AY q u alifier tells Co m puF ax that we have one overlay file, called DRAW.T4 and that this overlay is to be repeated for every page of the fax. See Chapter 7 for more information on overlays.

3.6 Sending Faxes With Co versheets

A coversh eet is a page th at preced es the act ual text b ein g sent and which us ually cont ains th e name of t he person to whom the fax is addressed, the name of that person's company, the sender's name and company name, the total number of pages being sent, and other similar information. (There are no fixed rules about what go es into a co versheet , but t he abo ve are prett y com mon. ) Cover sheets are o ften o verlaid with some kind of image, such as a box around the text, or some interesting picture to draw attention. Frequently, a coversheet will also h ave the sen ding com pany's letterhead , with its address, voice phone number and fax phone number. Creating coversheets can be a little complicated, because the t ext an d its o verlay 4 need to be lined up properly. The necessary information can be tied together into a special file, called a coversheet configuration file.

Overlays require the Overlay/ Lan d s cap e licens e o ptio n .

Below is a simp le examp le 5 o f how t o sen d a f ax with coversh eet :

$ FAX SEN D BI L L.CFG

Her e a r e th e c on tent s of file BILL. CFG, wh ic h will be analyzed in th e s ec tio n im mediately following:

## RE MARK This is a coversheet configuration file. # # O VERLAY_FILE FAX$DI R:ST DCOVER.T4 ##POSITION _CURSOR IN CH 0.5 3.1 # # CHARACTER_SI ZE IN CH 0. 52 # # N UMBER 1-555-123-4567 ## RE MARK Fill in the following be twee n the lines o f as terisks: ##REMARK To: ##REMARK Company: ##REMARK Sender: ##REMARK Subject: ##REMARK Total Pages: ## REMARK ********************************************************************** William B aile y Sweet H omes , I nc. Mary Bailey You know w hat 1

NDC comm CompuFax User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual