Programmer 7500

home *** CD-ROM | disk | FTP | other *** search

/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / HARDWARE / FAXPAK.ZIP / FAXPAK.PRN < prev next >

Wrap

Text File | 1990-01-18 | 46.0 KB | 1,717 lines

FAXPAK Command Line Utilities for the Intel Connection Coprocessor Copyright (C) Jeff Hofstetter 1989,1990 TABLE OF CONTENTS INTRODUCTION.....................................1 FAXPAK IS SHAREWARE!.............................1 FAX.EXE - send a fax from the DOS command line...2 SPECIFYING FILE NAMES TO SEND................2 SPECIFYING the PHONE NUMBER..................3 MODIFYING THE COMMAND USING SWITCHES.........3 ENTERING DATES...............................4 ENTERING TIMES...............................4 ENTERING ADDRESSEE...........................5 ENTERING A FROM NAME.........................5 SPECIFYING TRANSMISSION TYPE.................5 SPECIFYING THE WIDTH OF A FAX................6 SPECIFYING A COVER SHEET.....................6 FAX.EXE EXAMPLES.............................6 USING A LOGO FILE............................7 MANUAL OPERATIONS............................7 GETTING QUICK HELP...........................7 USING THE DOS ENVIRONMENT....................8 CAUTIONS and other notes.....................8 ADVANCED USE.................................9 LOOKING UP the PHONE NUMBER.................11 FAXA.EXE - cancel the current transmission......13 FAXNEXT.EXE - display pending transmission(s)..14 FAXDEL.EXE -- delete a pending transmission.....15 FAXANS.EXE -- set status of auto answer.........16 FAXLOG.EXE -- print log/clear logged entries....17 PRINTING THE LOG............................17 CLEARING THE LOG............................18 FINAL NOTES ABOUT FAXLOG....................19 FAXSTAT.EXE - display status of FAX board.......20 FAXRECV.EXE - move files to DOS files...........21 INSTALLATION....................................23 COPYRIGHT.......................................24 WARRANTY........................................24 SUPPORT.........................................24 FaxPak (TM) Documentation (Version 1.3) Page 1 INTRODUCTION Faxpak consists of several small programs to be used with the Intel Connection CoProcessor board (CCP). The programs are: FAX.EXE sends faxes from the DOS command line FAXNEXT.EXE lists the next fax(es) to be transmitted FAXA.EXE aborts the currently transmitting fax FAXDEL.EXE deletes pending fax transmissions FAXANS.EXE sets auto answer state of the fax hardware FAXLOG.EXE prints logged events/clears log entries FAXSTAT.EXE displays status of Connection CoProcessor FAXRECV.EXE move received files/faxes to DOS files. Please read the following instructions for a full explanation of how they work. Also be sure to read the COPYRIGHT, WARRANTY, SUPPORT... section for VITAL information. FAXPAK is SHAREWARE! Faxpak is distributed as "shareware". This means that you get to try it out BEFORE you buy it. It is NOT public domain software. If you find that Faxpak is a useful tool, you must register it by sending in the registration fee of $ 25.00 (US). You can try Faxpak for up to 30 days. At the end of that trial period, you must either register the software or stop using it. To register, send a check or money order for $ 25.00 to me at: Jeff Hofstetter FAXPAK Utilities 1722 Drake Street Longmont, Colorado 80503 USA Intel and Connection CoProcessor are trademarks of Intel Corporation Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 2 FAX.EXE - send a fax from the DOS command line If you have one (or several) files that you want to fax to someone, you can do that without loading up the CONNECT software included with your CCP. All you have to do is type (at the DOS prompt!): FAX filename phone# and the file you specify will be setup to be faxed to the phone number you enter. This is the simplest form of using FAX. When you use this form, your fax will be sent with the following default conditions: transfer type: 100x200 dots/inch fax date/time: immediately addressee: phone number width of paper: 80 columns from name: name entered when you installed your CCP logo file: file specified when you installed CCP SPECIFYING FILE NAMES TO SEND You can send several files at the same time by using this form: FAX file1, file2, file3 phone# As many files as will fit on the DOS command line can be sent (don't forget the phone number!). If you have several files to send that can be specified using normal DOS wild card characters (* and ?), you can do that as well. FAX *.doc phone# will send all files (in the current directory) that end with .DOC. You can also specify the directory name if needed: FAX C:\WP\*.DOC phone# You can also send several files at the same time by using this special form: FAX @filename phone# See the ADVANCED USE section later for information on this option as well as another option that allows you to send one or more files to a group of different locations. Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 3 When you give a filename to FAX.EXE it tries to find the file as follows: If the filename includes a path (i.e. C:\DIR\FILENAME.EXT), FAX will ONLY look for that file in the specified directory. If the filename doesn't include a path (i.e. FILENAME.EXT), FAX searches for the file in the following places (in order): The current directory Check to see if FAXPAK has been defined in the DOS environment. If so, look in that directory. Check to see if PATH has been defined in the DOS environment. If so, look in the directories specified. If all those places fail to turn up the filename you entered, FAX gives up and displays a message. See the section USING THE DOS ENVIRONMENT later for more information about this topic. SPECIFYING the PHONE NUMBER It is important that you DO NOT INCLUDE SPACES in your phone number! If you do, you will not get proper results. You can include dashes to separate parts of the number if you wish. Also, you can include one (or more) commas to signify a pause (generally 2 seconds per comma) if you need to wait for a dial tone after dialing a 9 for example. MODIFYING THE "STANDARD" COMMAND USING SWITCHES By using option switches on the command line, you can alter the default setup. To use an option switch, type a hyphen (-) followed by the option character (described below). Some options require that you enter additional information after the option switch. In that case, you must put at least one SPACE after the option switch before typing the additional information. Here are the option switches: Switch Additional Data Explanation ------- --------------- ----------------------------------- -d 12/31/1989 date to send the fax -t 17:30 time to send (24-hour time) -a "To field" addressee (must be in quotes) -0 <none> send fax 200x200 dots/inch -1 <none> send fax 100x200 dots/inch -2 <none> send as CCP file transfer -3 <none> send COVER SHEET ONLY mode -w <none> wide fax (132 columns) -c filename.ext filename to use as cover sheet Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 4 -l logofilename filename of logo file to send -r <none> do "polled" receive -s <none> do "polled" send -m <none> "manual" receive (see below) -f "from name" name must be in quotes. ENTERING DATES Remember, if you don't enter a date, the default date is TODAY. If you enter an invalid date (like 02/31/1989), the default is used. You can enter only a month, a month and day, or a full date. If you enter partial dates, the rest of the date is filled out from today's date. For example, if you enter -d 6/10 the date will actually be entered as 06/10/1989. If you enter -d 8 the date will be 8/13/1989 assuming that today is 3/13/1989. If you enter a year, you must enter four digits - 1989 not 89. valid date entries: (assuming today is 3/13/1989) -d 6/15/1989 fully specified date -d 8 month only (date used is 8/13/1989) -d 12/15 partial (date used is 12/15/1989) invalid dates: -d /15 no month! -d 1/21/93 year MUST have four digits! -d no date entered! Don't put the -d! ENTERING TIMES If no time is specified or an invalid time is entered, NOW is used. As with dates, you can enter partial times. You can enter only the hour or both the hour and minute. Missing minutes are filled in with the current minute. You must use the 24 hour clock to enter hours. 17:30 is 5:30pm, 23:30 is 11:30 pm. 0:30 is 12:30 am. valid times: (assuming it is 10:45 am) -t 8:30 8:30 am -t 9 time used - 9:45 invalid times: -t 24:30 hour is 0 - 23 -t :15 no hour specified! Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 5 ENTERING ADDRESSEE If you wish to have a TO: on your fax, you need to specify it using the -a switch. Put "marks" around the addressee. If you don't, you will have problems. -a "Jeff Hofstetter" makes the TO: entry ME! ENTERING A FROM NAME When you installed your CCP, you were able to enter your name so that all of your faxes would have your name on them. If you wish to have a different FROM name appear on a fax, you can use the -f switch. This name will then appear as the FROM name. Be sure to enclose the name in quotes! SPECIFYING TRANSMISSION TYPE The CCP can send faxes in two resolutions (100x200 dots/inch or 200x200 dots/inch) and it can send files (but only to other CCPs!). By using the transfer type switches, you specify what you want to do. Note that you can only specify one type per command. So even if you enter several filenames, they will all be sent using the same transfer method. Although you can specify more than one type, only the last one you enter is used. -0 200x200 dpi fax transfer -1 100x200 dpi fax transfer -2 file transfer mode (other CCPs only). -3 Special COVER SHEET ONLY transmission The -3 indicator is used to indicate that you want to send a fax that consists of a COVER SHEET only. This special mode is used as follows: FAX cover.txt 1-303-440-7683 -3 -a "Jeff Hofstetter" -d 10/1 This sample causes FAX.EXE to insert the text found in the file 'cover.txt' into the cover sheet. If you have a default LOGO file specified in your CCP setup, the cover sheet will have three parts to it: at the top of the page will be your logo, next will be a "routing" section which consists of the TO: and FROM: fields, and finally will be the cover sheet text. NOTE...NOTE...NOTE! This special mode works ONLY with version 1.1 (or later) of the Intel Connection Coprocessor software. Earlier versions will not allow a transmission of 0 files. If you don't have the correct software version, contact Intel and request the update. The Intel documentation gives an example of what the cover page will look like if you send a cover sheet only fax. Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 6 Using the -3 switch DOES NOT PREVENT you from also using either the -1 or -2 switch. In other words, FAX cover.txt 1-303-440-7683 -3 -2 is a valid command line. SPECIFYING THE WIDTH OF A FAX CCP allows you to send "normal" and "wide" faxes. A normal one is 80 columns wide, and a wide one is 132 columns. If you have a 132 column file to send, use the -w option. SPECIFYING A COVER SHEET If you wish to create a standard cover sheet to be sent with your fax, you can give the file name along with the -c switch. This cover sheet file shouldn't be more than 36 lines long. If it is, it will be truncated when transmitted! FAX.EXE EXAMPLES 1. FAX myfile.dat 1-303-440-7683 This is the simple form. Myfile.dat will be faxed (100x200 dpi) to phone number 1-303-440-7683 right away (or as soon as possible). 2. FAX file1.txt, c:\doc\message.txt, file3.doc 440-7683 -2 This sends 3 files (file1.txt, message.txt, and file3.doc) to the phone number as FILE TRANSFERS (note the -2 switch). As you can see, you can specify a path along with a file name. 3. FAX file1.txt 4407683 -d 4/15/1989 -t 22:30 -a "Jeff H" -0 Send file1.txt on April 15, 1989 at 10:30pm as a 200x200 dpi fax note the -0 switch. Put Jeff H as the TO: field. 4. FAX file1.txt 4407683 -c mycover.dat Send file1.txt NOW and send the file mycover.dat as a cover sheet. 5. FAX @myfiles.dat 440-7683 Look in the disk file 'myfiles.dat' and read the list of files to send from there. Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 7 USING A LOGO FILE When you first setup your CONNECT software, you can specify the name of a logo file to send with each fax. A logo file is simply a graphics file you create using the GRAPHICS utility. Intel includes one or two sample logo files to get you started. If you don't setup your CONNECT software to send a logo, you can tell FAX.EXE to send one for you. You can also override the default logo file by telling FAX.EXE to use a different file. To tell FAX.EXE to use a logo file, use the -l switch: FAX filename phone# -l logofile.pcx This example would send the file LOGOFILE.PCX as the logo. Note that the logo is printed as the FIRST page of a fax transmission. Also, if you specify to send cover sheet text, the logo prints first followed by your cover sheet text ON THE FIRST PAGE. MANUAL OPERATIONS If your CCP shares a phone line with a regular telephone you can take advantage of "manual" operations. I share my CCP and regular phone line, so if someone tries to send me a fax, my phone rings, I answer it and find that a FAX is calling me (a high-pitched beeping tone). Even if you don't share the CCP with your regular phone, sometimes it is desirable to call someone before sending them a fax or file. Once the voice part of the call is finished, you can then send (or receive). FAX.EXE allows you to do this. If you are to be the "receiving" party, simply type this command at the DOS prompt: FAX -m This special format will then cause the CCP to use the currently active phone connection and attempt to receive from the distant fax machine. So if my phone rings, I answer and find that it is a fax, I can now just type FAX -m, and the fax will be received okay. If you are the "sending" party, you use FAX.EXE exactly as usual except that you specify M for the phone number (capital M) and your fax will be transmitted using the current phone connection. GETTING QUICK HELP Type FAX and press ENTER for a brief summary of the options. Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 8 USING THE DOS ENVIRONMENT This discussion is a little technical, so if it doesn't make sense, don't worry about it. FAX.EXE will work fine without using this feature. DOS allows users to create "environment variables" that can be used by programs for special purposes. The most widely use one is the PATH variable. If you type SET PATH=C:\MYDIR;D:\DOS <enter> at the DOS prompt, you create an environment variable called PATH. DOS uses PATH internally to find programs that you try to run. For example, if you type CONNECT and press <enter> DOS looks in the current directory to see if a program called CONNECT exists. If it does, it runs that program. If it doesn't find it in the current directory, it then looks to see if you have create a PATH statement (like above). If it finds a PATH variable, if looks for a program called CONNECT in each of the directories found in the PATH variable. In our example, DOS would look in C:\MYDIR then in D:\DOS for the CONNECT program. You can create other environment variables. FAX.EXE looks for one called FAXPAK for some functions. If you want to create the FAXPAK variable, simply type SET FAXPAK=C:\MYDIR and press <enter>. It also could be included in your AUTOEXEC.BAT. Don't put spaces before or after the equal sign! See your DOS manual for more information about using the SET command. CAUTIONS and other notes FAX will allow you to send several files to the same destination by using the @filename method or specifying several files on the DOS command line. If you attempt to send TOO MANY, you will get an error message. The exact number depends on how long the filenames are, a total of about 1000 characters is allowed. If a file you want to send ends in .PCX or .DCX, FAX assumes that that file is ACTUALLY a graphics file and sets the file type accordingly. In most cases, this is desirable, but if you are an "ornery" type and create plain text (ASCII) files and use .PCX or .DCX as the file extension, you're on your own as far as the results go. For example, if you type FAX thisfile.pcx 440-7683 It will be transmitted as a GRAPHICS (PC Paintbrush format) FAX. If thisfile.pcx actually contains a letter to your pen pal in Paducah that you wrote using EDLIN, what your pen pal actually receives is questionable! Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 9 This works the other way, too. If you type FAX thisfile.txt 440-7683 FAX assumes that 'thisfile.txt' is NOT a graphics file, and treats it as a plain text file. If it IS a graphics file, tsk- tsk. Bottom line, use .PCX (or .DCX) for graphics file that match the PC Paintbrush format, and any other file extension for text files. ADVANCED USE You can send many files to a single addressee by using the special command format FAX @filename phone# [options] where 'filename' is the name of a plain text (ASCII) disk file that contains one file name per line. Do not use a word processor to create this file unless you can save in "DOS format" or ASCII with no word processor control codes in the file. Note the required '@' at the front of the file name! Here is a sample of what the disk file should look like: file1.dat <--- notice only one file per line! file2.dat c:\letters\file3.dat <--- note full path and file name You can send the same file (or group of files) to many addressees by using this special command format: FAX filename @phonefile [options] where phonefile is the name of a specially prepared disk file containing addressees, phone numbers, times, and dates. This specially prepared file is a plain text file formatted with one addressee per line as follows: phone # | addressee | time | date The order is IMPORTANT! You can leave out the addressee, time, and date, but you must not skip any. Here's an example of this file: 9,1,303 440-7683 | Jeff H. | 23:30 9,555-1212 | Washington Irving 9,555-2121 | Irving Washington | 15:45 9,1,212-555-1234 | Ed Koch | 1:15 | 5/31/1989 9,555-8989|Bill S|12:45 Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 10 A few things to notice: the second line (to Washington Irving) doesn't include a time, so the time will be either immediately or whatever time you specified with the "-d" option on the FAX command line. The fourth line contains both a time and a date. The special character '|' is a required separator between fields. You DO NOT have to line up the rows under one another, but it looks neater (see line 5). Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 11 For a real thrill, you can combine both of these special uses: FAX @filefile @phonefile [options] This would send all of the files listed in filefile to all of the addressees listed in phonefile! LOOKING UP the PHONE NUMBER If you send faxes to the same people frequently, you certainly don't want to have to remember and type in the phone number every time. FAX allows you to do a simple phone lookup by examining a plain text file that contains an abbreviation for the person, the phone number, and (if desired) the TO name. This file MUST be called FAXPAK.PH and must be in a directory that is in your PATH (or in the current directory when you type FAX). The format of this file is as follows: abbrev|phone#|Person's name abbrev|phone#... Here's an example FAXPAK.PH: jh | 1-303-440-7683 | Jeff Hofstetter billw | 555-1234 | Bill Wannamaker joanj | 555-4321 | Joan Jett artk | 555-2111 | Art King home | 555-6789 NOTE: the entry for 'home' doesn't have a NAME with it The abbrev can be any number of characters, but you will probably want to make it short and sweet. The phone number can contain all of the usual control characters (like , for pause). You can put the person's full name in also. It will become the TO of the fax. Note the special character '|' used to separate the information. You can spread the entries out like I have in the example above, or you can pack them in tight like this: jh|1-303-440-7683|Jeff Hofstetter Spaces before and after each entry are removed. Once you have this file created and stored in a directory on your PATH, you can then use FAX.EXE as follows: FAX filename ?jlh [options] The question mark (?) and the abbreviation (jlh in the example) MUST NOT be separated by a space! FAX will then attempt to locate the abbreviation in the FAXPAK.PH file. If it finds it, it uses the phone number and the full name (if used) to complete the fax transmission. Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 12 When doing the lookup, FAX ignores upper and lower case letters. That is, JLH will match jlh and Jlh and JLh, etc. If the abbreviation is not found, FAX issues an error message and the fax transmission is not completed. FAX does not use a sophisticated searching technique, so I wouldn't think that you would want to have a real large FAXPAK.PH file. I've tried it with up to 100 names or so and it seems acceptable to me. There isn't any real limit on the maximum number except for your patience while it searches for your abbreviations. Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 13 FAXA.EXE - cancel the currently sending transmission If you wish to abort the fax (or file transfer) that the CCP is currently sending, just type FAXA and it will be cancelled. Note that it may not quit instantly, it may take up to 30 seconds for it to actually stop. If the transmission can't be stopped, you get an error message to that effect. Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 14 FAXNEXT.EXE - display pending transmission(s) You can use the CONNECT software provided with your CCP to view the pending transmissions, or you can use FAXNEXT which is used from the DOS command line. If you type FAXNEXT and press ENTER, you will see the next fax waiting to be transmitted. If you type FAXNEXT -a and ENTER you will see a list of ALL of the pending fax transmissions. The format of the list is ----- ---------- ----- ---- ----- ---------------- ------------ ID# Date Time Type Num Phone To ----- ---------- ----- ---- ----- ---------------- ------------ 4017 03/15/1989 16:30 FILE 2 1-303-440-7683 Jeff H 8112 03/15/1989 22:45 FAX 1 1-303-440-7683 Jeff H ----- ---------- ----- ---- ----- ---------------- ------------ Of particular interest is the ID# entry. The number is used internally by the CCP software to keep track of transmissions. The only use you might have for this number is you need to know it if you wish to use FAXDEL which allows you delete pending transmissions. FAXDEL requires that you provide the ID# to delete. The Type column indicates whether the transmission is a FAX or FILE TRANSFER. The Num columns tells how many faxes or files are being sent to the given phone number. The TO column may be the same as the Phone column if you did not provide the -a option switch when you used the FAX command. Adding -v to the command (i.e. FAXNEXT -a -v) will display the name(s) of the file(s) to be sent. Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 15 FAXDEL.EXE -- delete a pending transmission If you wish to delete a pending fax transmission, FAXDEL allows you to do it quickly from the DOS command line. To use this function type FAXDEL ID# ID# is the number obtained using the FAXNEXT -a command. For example, if you wished to delete the transmission going to Jeff H at 22:45 on 3/15, you would type FAXDEL 8112 Deleting is a permanent process. Once you delete a pending transmission, you must reFAX (is that a new word?) it. Note that deleting a pending transmission DOES NOT delete the files you were going to transmit. Only the FAX control record is deleted. Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 16 FAXANS.EXE -- set status of auto answer When you first setup your CCP, you had the chance to specify whether or not to have the hardware automatically answer the phone and after how many rings. If you're like me and have to share a voice line with your CCP, it would be nice to be able to have the CCP answer sometimes and not other times. That is what FAXANS does. To disable auto answer (for the CCP) just type FAXANS 0 at the DOS command line. To have CCP answer the phone on the third ring, type FAXANS 3. Note that FAXANS only remains in effect until you reboot your system (or some event reboots it for you). Typing FAXANS by itself will show you the current auto answer state along with a short instruction for using FAXANS. Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 17 FAXLOG.EXE -- print log/clear logged entries FAXLOG allows you to print (to the screen or elsewhere) a list of logged events. A logged event is a record of a fax you sent or received. Each event is recorded along with its "status". An event's status can be "complete", "aborted", or "failed (error)". Logged events take up disk space and if you have lots of them hanging around, your use of CONNECT tends to slow down somewhat. So a little house cleaning is in order from time to time. FAXLOG allows you to CLEAR the log file selectively. You can clear only aborted events, only ones with errors, only completed events, or ALL events. PRINTING THE LOG In its simplest form, just type FAXLOG and press enter and you will get a "short form" log displayed on your screen. FAXLOG also accepts options like the other FAXPAK programs: -w print a WIDE log (132 characters). -p 50 print 50 events per page (space after -p is required and you must enter a number if you use - p) -r print events in reverse order (newest -> oldest) -v verbose. Display the name(s) of the file(s) received. -n don't print the log header information -l 5 limit the number of lines printed to 5. This is a special switch designed for one user! If you only want to see the last 5 events in the log, use this switch. Note that the switch is the small L not the number 1! The -w (wide), -p (print), and -n (no header) options are mainly intended to be used when you want to print the log to a printer. In order to print to a printer you must "re-direct" the log to the printer. The normal way to do this from DOS is to type >PRN at the end of the DOS command line. For example: FAXLOG -w -p 50 >PRN This will send the log to the printer instead of the screen. I haven't tested this on every computer, so you might have to try >LPT1 or something like that on your machine. You can also use this "re-direct" feature to send the log to a disk file: Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 18 FAXLOG -w -p 50 >MYFILE.DAT If you use the -p option, FAXLOG prints a header followed by the number of lines you tell it to print, followed by a normal "form feed" character (decimal 12). Most modern printers respond to this character by ejecting to the top of the next page. If your printer doesn't, sorry! You can use the -w and -p options without the "re-direct" feature, but your screen (probably) won't display 132 characters on a line so the extra part of each line will be displayed below the first part (messy). Also, if you use the -p option, you will see a funny character before each header. That is the form feed character. CLEARING THE LOG USE AT YOUR OWN RISK! Once you delete events from the log, they are gone. To clear the log, you use FAXLOG with the -c options: -c a clears events that were ABORTED -c e clears events that had ERRORS -c c clears events that were COMPLETED -c * clears ALL events!!!!!! -c x clears ALL events without asking for verification Note that FAXLOG always prints a log when you use it, so if you type FAXLOG -c * you will first get a log of events and they will be cleared as they are displayed. When you request a CLEAR, FAXLOG displays a warning message: Press Y to clear ??? events: and waits for you to press Y (or y). Any other key will cancel the clear. Note that the '???' above will be replaced with a message telling you the kind of clear you requested. CAUTION! If you use the -c X option, you WILL NOT be asked to confirm the deletion! If you are going to use the clear option, I recommend that you use the "re-direct" feature. First, this insures that you have a permanent copy of the events, second, when FAXLOG clears an event, it displays a message telling you that it deleted it. If you are displaying the log on the screen, this message will get "mingled" in with the log display. Here's how I clear stuff: FAXLOG -r -w -p 50 -c * >PRN Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 19 This does these things: -r print log in reverse order (newest -> oldest) -w print 132 character lines (more information) -p 50 print 50 lines per page -c * clear ALL events >PRN send log to printer FINAL NOTES ABOUT FAXLOG If you don't want to use the CLEAR option, simply don't use the - c option. As long as you don't use that, nothing will ever be removed from the log. Although, you are going to want to clear it someday (perhaps using CONNECT?). Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 20 FAXSTAT.EXE - display status of FAX board; FAXSTAT simply displays the status of the fax board. Information included is the number of "pending" events in the task queue, the number of received items, and the number of logged items. Also displayed are the Intel CAS software version number, the name of the default LOGO file (if any), the default sender name (this is sent out as the FROM name), the CCIT identification number (this is the phone number that you enter when you do SETUPCC - you can put anything you want in this space, not just the phone number!), and the state of the auto answer function. Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 21 FAXRECV.EXE - move files to DOS files When a fax or file is received by the CCP board, it stores the information internally to the Intel software. You can't access the fax or file using your normal DOS tools. Plus, if someone sends you a program file, you won't be able to use it until you move it from the CCP internal storage to a normal DOS directory. The CONNECT software allows you to do this, but you have to do it one file at a time. FAXRECV.EXE allows you to easily move all of the received faxes and files to a normal DOS directory. As usual, FAXRECV.EXE has some "switches" you must provide depending on what you want to do: -m Move the files (if not present, files are displayed not moved) -d Allows you to specify a particular directory for the files. -x Delete the control record if files are moved properly. -? Displays quick help information. The -m switch controls whether or not FAXRECV.EXE actually moves the internal files or whether it just displays them. If you don't use the -m switch, FAXRECV will only display the files that it finds in the receive queue. FAXRECV will show you the file name, file size, and status of the files in the receive queue. If a fax is received, it will not have a name, so FAXRECV will display <<fax file>> and will show how many pages are included. Status is "new", "read", "moved", "deleted", or "other". New files are ones that have never been examined by you, files that you have looked at (but nothing else) are "read", "moved" files are ones that you have already use FAXRECV on, files with a status of "deleted" have been deleted by you and are no longer on your computer disk. If you use -m, FAXRECV will display the internal names of the files as well as the new DOS filename. For example, if you receive a file called "myfile.dat" then use FAXRECV with -m, you will see something like this: myfile.dat --> .\MYFILE.DAT This means that the internal file has been moved to the current directory (note that .\ represents the current directory). Regular FAXes (not file transfers) don't have a REAL file name. FAXRECV will generate a unique filename and display it when the fax is moved to a file. Normally, FAXes are created with a .DCX file extension. This signifies that it is a multi-page graphics file. You would need to use the Intel GRAPHICS function (or possibly another graphics program you have) to view or print it. Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 22 The -d switch allows you to specify which directory you want to put the files in when they are moved. For example FAXRECV -m -d C:\NEWFILES will move any available files/faxes to the directory C:\NEWFILES. If that directory does not already exist, you will be asked if you wish to create it. Answer Y or N as you desire. If you proceed you will see: myfile.dat --> C:\NEWFILES\MYFILE.DAT The -x switch is used to "cleanup" the internal receive queue. When CCP gets an incoming fax or file, it creates a "control" record which contains the names of the faxes/files actually received along with some other internal information. In addition to this record, CCP creates a separate record for each fax/file received. When you MOVE files, the individual file records are used to create the DOS files, but the control record remains showing the fact that the files have been moved. If you don't need to keep this control record, include -x with FAXRECV and it will be removed. You might want to keep a permanent record of files received and moved, if so, include the "redirection" command when you use FAXRECV. For example: FAXRECV -m -d C:\NEWFILES -x >RECEIVE.LOG This will move all available faxes/files to C:\NEWFILES, delete the internal control record, and save the FAXRECV output in a file called RECEIVE.LOG. You could use >>RECEIVE.LOG to add the new information to any information that already existing in RECEIVE.LOG. Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 23 INSTALLATION No special installation is necessary to make these programs work. It makes sense to place them in a directory that is in your PATH. If you don't know about PATH type stuff, consult any good DOS book (or even your DOS manual!). Naturally, you must have a properly installed CCP and you must have the "resident fax manager" software running. The resident manager is called CCAM (from Intel) and will be running if you are able to use your CCP! Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683) FaxPak (TM) Documentation (Version 1.3) Page 24 COPYRIGHT These programs are all Copyright (C) Jeff Hofstetter 1989, 1990 WARRANTY I have exercised reasonable care in writing these programs, but I offer no warranty of any kind, actual or implied, including warranties of merchantability and fitness for a particular purpose. I can't be held liable for any special, incidental, or consequential damages arising out of or resulting from the use of these programs. SUPPORT I will provide support to REGISTERED users of FAXPAK via phone, fax, or email. Fixes and upgrades will be distributed via Connection CoProcessor. All comments, questions, etc. should be directed to me on Compuserve via EasyPlex. I also visit the Compuserve Intel PCEO forum frequently. You can call me or fax me at the number shown below. NOTICE that I'm sharing a voice and fax line, so send faxes at the right time! These programs were developed with Microsoft C v5.1 using the DCA/Intel Communicating Applications Specification. Jeff Hofstetter Compuserve ID 70365,110 voice phone (303) 440-7683 fax phone (after 10pm Mountain time!) (303) 440-7683 1722 Drake Street Longmont, Colorado 80503 USA Copyright (C) 1990, Jeff Hofstetter (ph: 303.440.7683)