Category : Word Processors
Archive   : VIEW97.ZIP
Filename : VIEW97.DOC

Output of file : VIEW97.DOC contained in archive : VIEW97.ZIP

VIEW - the file viewer Ý
Version 9.7 Ý

(formerly just plain VIEW!)

Note: this package contains the following files:

VIEW.EXE (file viewer version 9.7)
VW97CFG.COM (customizer)
VIEW97.DOC - this file
NEWIN97.DOC - history and new features
TROUBLE.DOC - possible problems, and solutions
HOWDOI.DOC - tips for using VIEW
(zipped with PKZIP 2.04g)


VIEW is a file viewing utility for DOS.

þ It allows you to view and print files in the following formats:

- Wordperfect versions 5.0 to 6.0
- Word for Windows versions 1.0 to 6.0
- Word for DOS
- Ami Pro
- Wordstar
- Windows Write files
- Windows Notepad files (which use the ANSI character set)
- Windows CLP (clipboard) text files
- ASCII files
- ANSI files (e.g. created under UNIX)
- Compuserve mail and messages

þ You can print or save all or part of the files viewed.

þ You can print or save to file only those lines containing or omitting
specified text.

þ Printing can be done directly via the compressed print routines 2COL and
JETCOL (if you have them). These shareware programs by Tony Caine are
provided to those who register VIEW.

þ Windows help files can be viewed via a link to an external program HLP2DOC
(which is a freeware utility available on many BBS and provided to those
who register VIEW).

þ VIEW allows you to search for text strings (both case-sensitive and
case-insensitive), including across multiple files.

þ You can also print or convert files to ASCII directly from the file

selection menu.

þ You can convert between ASCII and ANSI

þ You can save files in a format suitable for importing into word
processors without a hard return at the end of every line.

þ Together, VIEW and 2COL/JETCOL offer a powerful file printing utility
that can be run under a wide variety of DOS and Windows shells and file

þ VIEW can be identified as the file viewer for a wide range of DOS and
Windows shells and file managers, including archive display programs.

þ VIEW is ideal as a viewer for e-mail attachments.

þ VIEW can be customized for display color, and also its printing,
display and memory features.

Note: as shipped VIEW is configured NOT to use the Windows help file
translator HLP2DOC. You must have this utility in a directory that is
referred to in your PATH statement. The link to HLP2DOC can be ebnabled by
using the configration program VW97CFG.

IMPORTANT!! (The fine print) Ý

The author makes no warranty that the software in this package will work
with your particular hardware configuration. You use the programs entirely
at your own risk, and the author will not be held liable for any damage
caused to your hardware or software through their use, nor for any
consequential damages, loss of earnings, or loss of life, limb, health,
sanity or personal realtionship. Legalities aside, you should not run into
difficulties with this software.


These programs are distributed as shareware, AND ARE NOT CRIPPLED!!. Nor
do they contain "nag" screens. (Editorial note: I don't support
"crippleware" - I want to know EXACTLY what I'm expected to pay for!
Crippleware is, in my opinion, like test driving a Mercedes that's been
fitted with a lawnmower engine! There, that's said - but each to his own.)

You do not have to register as a user, nor are you under any
obligation to buy the program(s). However, they are not free, and in
the spirit of shareware, you are requested to make a small
donation to the author if you find the software in this package useful,
and if you continue to use it after an evaluation period of 30 days. This
would both fulfill your moral obligation and help ensure the viability of
the shareware concept, from which we all benefit.

The suggested contribution is $25 US (12 pounds sterling), but less
(or more!) would be fine. Pay what you think the software is worth to
you. If you pay the recommended amount or more, I will send you a diskette
with the latest version plus a selection of other shareware for you to
evaluate, including Tony Caine's excellent 2COL and JETCOL utilities and
some useful freeware programs.

Should you decide to make a contribution, please remit to:

Malcolm Drury
11 Adele Crescent
ON K2J 2T7

Internet [email protected]
Compuserve 70574,3457

Bank notes in your local currency would be fine! Thank you. Please tell me
where you got the software from and, most importantly, which version it is.

Please contact me if you would like to negotiate a price for multiple
copies. I accept purchase orders, but cannot accept credit card orders.


Please note that at the low contribution requested, I cannot provide DIRECT
technical support, nor automatically send upgrades, should they
become available. If you have comments, questions, bug reports etc., please
leave a message at my Compuserve or INTERNET address, or write to me via
snail mail. I will endeavor to fix any problems you might encounter.
Users who have paid may, of course, download future upgrades free of charge.
VIEW is widely available on Bulletin Board Systems.

The software is supplied on an "as is" basis. You are free to distribute
this software package provided that you distribute the ENTIRE package,
including this documentation file. (This is necessary for others to be able
to use it properly. I've downloaded too many shareware packages that had
been posted without accompanying documentation!).

I hope you find this package useful.

Now to the fun stuff!



view [d:][path][filename] [/switch1] [/switch2] [/switch3] [text string to find]

where /switch1, /switch2 and /switch3 can be:

(in which nnn is a three digit number)

/mnnn - set aside nnn memory allocation units (see below)
/wnnn - set line wrap to nnn
/cfilename.cnv - convert selected file to filename.cnv directly (i.e.
without viewing it)
/print - print selected file directly (without viewing it)

NOTE 1: if you use both /c and /print, only the first one to appear in the
command line will be used.

NOTE 2: the order of the switches is unimportant (except regarding Note 1)

NOTE 3: if you use any of the switches, you MUST include at least a drive
letter on the command line. If not VIEW will tell you something
like "can't find /m056".

If you just type VIEW you will get a list of files on the current drive and
directory, from which you can select the one to view. Similarly, if you
type VIEW plus drive and directory parameters, you'll get a list of files
on that drive and directory. From the file selection menu, you can
change to any directory on the drive, or to any other drive. Note that
VIEW supports the * wild card character.

Purpose of switches


If you include the switch /mnnn you will be able to allocate more memory for
use by JETCOL, 2COL or HLP2DOC (see below). The more memory you allocate
for these programs the less is available to VIEW for loading files. If you
only use JETCOL, 2COL or HLP2DOC occasionally you should leave the memory
allocation at the default level and use the /mnnn switch when you do want
to use them. If you use them frequently, you should probably permanently
allocate sufficient memory using the configuration program VW97CFG.COM.
See later in this information file for more information on running JETCOL
and 2COL.


If you use the /wnnn switch the line wrap is set at a maximum of 132
columns and a minimum of 20. The number of columns you want is determine
by "nnn" which MUST be a three digit number (e.g. 070, 120). In this mode
you can use the left and right arrow keys to scroll the display to the left
and right. This mode is useful if you want to print files for which the
line wrap is greater than 80 - for instance, program listings. Note that
VIEW will also run in true 132 mode (i.e. 132 columns actually displayed
on screen if you have a video adapter that allows that mode).

(NOTE: when you use the /wnnn switch, the help line at the bottom
of the screen will refer to "Cursor arrows". When it is not used the
left and right arrow function are disabled and the help line refers to "Up
and down arrows").


To print a file directly use the /print switch. The settings for number of
lines per page, left column indent etc. used are those you have configured
for VIEW.


To convert a file to ASCII directly, use the /c switch - that is, /c
followed immediately by the name of the CONVERTED file. For example, to
write a converted file called myfile.cnv the format of the switch would be
/cmyfile.cnv The name of the converted file can include a full path (drive
and directory plus sub-directory) if you wish, or it could be an alternate
printer port.

text string

The text string to find MUST come after the filename, and after any
switches used. It allows you to search for the string in all files
viewer until the "text search" function is switched off (see later). Text
entered from the command line is assumed to be case-insensitive.

You can use the * wild-card character in a file name. Then you will get a
list of files in the default or specified directory that match the
* criteria. Any string identified on the command line for the text
search function will be active for all files specified by the wild
card option (unless it is changed or switched off when viewing one
of the files).

e.g. view *.doc - list of files with extension doc in the current

view d:\docs - list of all files on drive d, directory docs

view d:\docs\*.txt - as above, but only files with extension txt

view myfile.doc this is a string - open myfile doc and search for
"this is my string"

view myfile.doc /m060 - open file myfile.doc after allocating 60
block of memory for use by JETCOL, 2COL or

view d: /m050 - list all files on root directory of drive d: after
allocating extra memory.

view *.txt /w132 - list all matching files and display them in
emulated 132 column mode.

view myfile.doc /w120 /print - print the file myfile.doc directly,
using 120 column word wrap.

view another.doc /cnew.doc - convert "another.doc" and save
converted file as "new.doc"

view d:\docs\*.doc another string - list all matching files, and as
each is opened look for "another
string". This search is in
effect for all subsequent files
until it is switched off.

view d:\docs\*.doc /w120 yet another string - display all matching
files in emulated 120
column mode, and look
for the string "yet
another string".

Note on text search: VIEW will only find matches in complete lines, i.e.
it will not find text that has wrapped. For example, if the text to find
is "cat sat on the mat" it would find the following:

One fine day the cat sat on the mat and ate a rat.

but not:

One fine day, the cat sat on
the mat and ate a rat.

Note that VIEW reads as much of a file as possible into memory, but if
not all of a file can be read in it won't display the full file. This
allows you to skip instantly to any part of the file in memory without
disk reads. If you are not using DOS 5.0 or later, or a memory manager
such as QEMM386 or 386MAX, I strongly recommend you do so. If a file is
too big, an overflow file is created; you can switch quickly between the
two. The overflow should, in most circumstances, allow you to see all of
the original file, unless it is really big. If the file IS really big,
you can convert it to ASCII (from the file selection menu) and then split it
into smaller components using a text editor. When you convert to ASCII
from the file selection menu the entire file is converted even if it is too
big to view via VIEW.

VIEW will automatically detect WordPerfect 5.0 and later, Microsoft Word,
Ami Pro and Windows WRITE formats. It attempts to detect other files that
may not be ASCII and gives you the opportunity to display them as straight
ASCII, as Wordstar - i.e. with the high-order characters stripped
out, or in preview mode, or in preview mode. It will automatically force
to ASCII certain standard types of non-ASCII file (e.g. EXE, COM, DLL etc.).

Using VIEW is pretty straightforward. Pressing F1 brings up a help menu,
and the key features of the menu are permanently displayed on the bottom
line. The help menu looks like this:

³ VIEW version 9.7 Copyright (c) Malcolm Drury 1994 ³
³ ³
³ Up and down arrow keys - scroll up or down 1 line ³
³ PgUp, PgDn - scroll up or down 1 screen ³
³ Home, End - go to beginning or end of document ³
³ Esc - exit to DOS ³
³ ³
³ F2 - text search (case insensitive) ³
³ F3 - text search (case sensitive) ³
³ F4 - switch string search off ³
³ When text search is on a * appears at the bottom right ³
³ F5 - go to particular line ³
³ F6 - write copy of file to printer or disk ³
³ ShF6 - reset HP and HP compatible printer mode ³
³ F7 - print lines including/excluding string ³
³ F8 - print file directly via 2COL or JETCOL ³
³ F9 - toggle for selecting block to print ³
³ (First time, top line is start of block to print) ³
³ (Second time, top line is end of block to print) ³
³ F10 - convert ANSI to ASCII Sh F10 - - convert ASCII to ANSI³
³ Space bar - leave menu ³
³ *** Press appropriate function key *** ³

Every feature is accessible directly from the view screen, or from the menu


The keys:

Navigate through the file using the cursor keys.

F1 - help menu; all menu items are available directly from this menu
(i.e., while the menu is displayed, pressing F2 will activate
the appropriate function for that key).
F2 - case-INSENSITIVE text search - matching text is shown in the
highlight color. Unless the string to find has been defined from
the command line, the first time you press F2 the string is
defined. Subsequent presses of F2 find the next occurrence.
F3 - as for F2, but for case-SENSITIVE text.
F4 - toggle off text search

NOTE: when the text search function is enabled an asterisk (*) appears at
the bottom right corner of the screen.

F5 - go to a particular line number
F6 - print all of file to printer or disk
Shift F6 - set or reset HP and HP compatible printers that use the PCL4
command set (portrait or landscape mode, normal or compressed
print). This includes a user-definable command.
F7 - print all lines that specifically include or exclude a
particular text string
F8 - print file directly via 2COL or JETCOL
F9 - this is a toggle for printing (to printer or disk) a block of
text. The first time you press F9, the current top line
is set as the beginning of the block. The second time, the
current top line is set as the end of the block, and the block
is printed to the location you specify. While block select is
on, you will see a message at the bottom-left of the screen
telling you the starting line of the block.

F10 - changes the character set of the file being displayed from ANSI to
ASCII. If you print to file after this conversion is made, the
file you print will use the converted (i.e. ASCII) character
set. This feature is useful for converting Windows NOTEPAD
files and others created with the ANSI set (e.g. text files
created under UNIX).

Shift F10- changed the character set of the file being displayed from
ASCII to ANSI. As with F10, files printed to disk will contain
the ANSI character set.

Space bar- leave menu without enabling any of the features.

If you have read in a large file that has resulted in a temporary overflow
file being created, the following keys are also activated:

n - move to overflow file ("n" means "next")
p - move to original file ("p" means "previous")

If you hear a "beep" the function is not currently activated (e.g. already
in that file, or you have blocked off text but not yet printed it).

When in "overflow" mode an identifying letter appears at the bottom-left
of the display. "p" means you are in the second level, i.e. overflow
file, and "n" means you are in the top level, i.e. original file.
Note that in the second level, you will be told that the file is ASCII, and
called overflow.viw. Not to worry: it still contains the overflow from
the file you called to read. Pressing the letter takes you to the

revious or ext part of the file.


Note: for the print functions, you have the following choices:

- print to printer
- save to file (and you can also use this for printing to an alternate
printer port - just use the port name as the name of the file to be
- print directly via 2COL or JETCOL
- save file in format suitable for importing into word processor (as far
as possible VIEW puts hard returns where they are needed and omits
them where they are not).

F6 - F9 allow you to print to file, to printer, or via 2COL/JETCOL. The
latter function produces a file called cainelnk.fil, which is
deleted when processing has finished. If you have not set aside
memory for 2COL/JETCOL (see configuration, VW97CFG) you can
simply write a file (converted to ASCII) to disk and process it
separately with 2COL or JETCOL. Alternatively, you can load
VIEW with the /mnnn command to allow to to allocate (temporarily)
enough memory to run 2COL or JETCOL.

F6 print entire file. You can include line numbers if you wish.

F7 print only those lines containing or omitting a text string you

F8 Allows you to access JETCOL or 2COL directly (assuming you have
them of course!) to print the entire file.

Pressing F8 allows you to enter a command line for JETCOL or 2COL,
thereby allowing you to set switches individually. You should
NOT enter a file name - VIEW does this for you, as it uses a
special ASCII file. The true file name will be added to the end
of the printout. If JETCOL or 2COL do not exist in a directory
that your PATH statement specifies, you must include the full
path in your command line.

Example: c:\jetcol\jetcol -W70 - prints the file using
JETCOL, which is in directory c:\jetcol; the single W switch
is activated.

If when you try to print via JETCOL or 2COL nothing happens
except that the display returns immediately to VIEW, one of
two things is the probable culprit. Either JETCOL/2COL has not
been found, or you have not set aside enough memory for
VIEW to link to JETCOL/2COL. For the former, check that
you entered the path properly. For the latter, reconfigure
VIEW using VW97CFG.COM and set aside 50 or so "memory
blocks" (the configuration program will tell you when to do
this), or load VIEW with the /mnnn command.

F9 This key is a toggle to allow you to select a block of text for
printing. The first time you press it the block starts at the
line currently at the top of the display; the second time the
line at the top is the end of the block. Once selected, the
block can be printed as for the F6 key.


If you are viewing anything other than a straight ASCII or ANSI file, it
will not look the same as the version that you print from the word processing
software. If the document uses a proportional font, or contains columns
or tables, the appearance under VIEW will in all probability be different.
This is because of the way VIEW simplifies the formatting built into such
documents. If VIEW were to be designed to show all formatting faithfully,
it would be at least as big as the executable files used by the word
processors themselves and would therefore lose its point as a quick viewer.

I have attempted to cover all formatting and embedded code possibilities,
but with the power of WordPerfect, Word and Ami Pro, the possibilities
are mind-boggling! If you come across a file that does not seem to
display properly - e.g. hangs mid-way through or displays garbage -
please send it to me and I will attempt to fix the problem.

Note that Wordstar files may contain some extraneous characters,
including "dot commands" such as .PA - however, they should
certainly be readable.


VIEW will automatically detect Word, Ami Pro, WinWrite and WordPerfect
text files. For others, it may tell you that the format is unknown, and
give you some options:

³ Undetermined file format - please select display option: ³
³F1 show as ASCII F2 - assume Wordstar F3 preview F4 don't view ³
³ Suggest F3 if you have not previously viewed this file ³

F1 - means show the file as if it were a true ASCII file. VIEW will
automatically assign certain types of file (e.g. EXE, COM, BIN,
DLL) to this display mode.

F2 - means assume the file is Wordstar, and show it as a 7-bit ASCII
file (i.e. with high-order characters converted to the appropriate
low-order). VIEW alerts you to the fact that the file MAY be

F3 - means show the file with high-order characters omitted. Useful for
scanning for text strings and previewing files of unknown format.

F4 - means don't try to show the file.

If you choose F1 or F2, you will be asked which line wrap you want - that
coded directly into the file, or the VIEW default. You should choose
the former first, as it will be appropriate for files with fewer than 80
characters per line. If the file has more than 80 characters per line,
however, this display will cause lines to break within words. In that
case, try choosing VIEW's defaults. Just go with whichever suits you!


If you have called VIEW without specifying a particular file, you have
access to the file selection menu, which looks like this:-

D:\VIEW97\*.* - 9 item(s) (0 read)
Keys: PgDn PgUp Home; Enter - select; Esc - exit; F1 - help
ASCII line wrap OFF
³ .. ³
³ file_id.diz ³
³ newin97.doc ³
³ trouble.doc ³
³ view.exe ³
³ view97.doc ³
³ ³
| |
³ ³
³ UPPER CASE - directories lower case - files m - show memory parameters ³
³ F2 - set line wrap F3 - toggle ASCII line wrap on/off F4 - Wordstar ³
³ F5 - preview mode F6 - convert/print F7 - new drive F10 - ANSI on/off ³


Use the arrow and cursor keys to scroll through the list of files, and
press Enter to view the highlighted file or to change to the highlighted

F1 - brings up a help menu

F2 - allows you to change the column at which lines wrap.

F3 - toggles line wrap on and off. When toggled OFF, line wrap occurs
according to the file's setting and ignores VIEW's setting. In
this mode, lines in ASCII and Wordstar files may wrap within words.
When toggled ON VIEW prevents (as far as possible) breaks
appearing within words. You can use this feature to reformat ASCII
files; for example, to change the width of lines.
NOTE: line wrap toggle is only used for ASCII or pseudo-ASCII
(e.g. Wordstar) files. It has no effect on WordPerfect, Word
etc. files.

F4 - tells VIEW to treat the file as Wordstar.

F5 - tells VIEW to treat the file as "unknown format". High-order
characters are stripped out and error trapping routines are initiated
during the file read (e.g. missing end-of-file)

F6 - allows you to convert a file to ASCII or print it directly without
viewing it, including via 2COL/JETCOL.

Shift F6 - allows you to reset HP and HP-compatible printer mode for those
printers that recognize the PCL4 command set.

F7 - allows you to change to another drive. A list of available drives is
displayed. Just type in the drive letter you want and press "Return".
Note: this function default the file listing parameter to *.*, i.e.
it results in all files on the drive and directory shown being listed.

F10- the next file to be viewed will have its character set converted from
assumed ANSI (e.g. Windows NOTEPAD) to ASCII. F10 is a toggle -
press it a second time and this feature is switched off.

m - tells you how many display lines are available and how many 2000 byte
memory blocks you have set aside.

Esc- exit to DOS



usage: vw97cfg [filename]

where filename is view.exe or an exact copy with some other file
name. If the wrong version of VIEW is found, VW97CFG will
tell you so. NOTE: you may wish to rename this file to something

This program allows you to customize VIEW.EXE.

Setting colors is self-explanatory. However, VW97CFG also allows you to set
some print parameters, such as number of lines per printed page, number of
spaces to expand tabs, and number of spaces to leave for the left margin.

After setting colors, VW97CFG allows you to override the default number of
lines of display and display speeds. VIEW as shipped is configured
for normal display speed and hard coded to display 25 lines by 80 columns.
Try experimenting with the display parameters to get maximum benefit; if
your system crashes - and there's a lot of non-standard hardware and BIOS
software out there - just reconfigure VIEW to a lower display standard.

Next, you to choose whether the "delete file?" feature of VIEW is
activated. As a safety measure, you may wish to set this to "off". Even
with the feature on, a file will not be deleted until you have
answered an "are you sure?" question. Protected (read-only) files cannot
be deleted directly from VIEW.

You can also configure some display and print parameters - the number of
lines per printed page, the default printer port, and the offset from the
left margin or printed output.

VW97CFG allows you to set the column at which lines wrap. The default is
66 - that is, VIEW counts characters per line and if it is within 14 of
the rightmost screen column puts in a line feed if it finds a space. This
is not absolutely foolproof; you may find that setting the line wrap column
to less than 66 gives better performance. (NOTE: you can temporarily
over-ride the default setting from the file selection menu).

Next, VW97CFG allows you to change the default number of files that can
be read in sequence from the file selection menu. Each time you read a file
a small amount of memory is lost to the system (until you exit to DOS, when
it is fully restored). To prevent memory allocation errors VIEW exits to
DOS after a certain number of files have been read. The default is 50. If you
wish to experiment with a higher number, you can do so via VW97CFG. Don't
go above 100. If you find that your setting does cause a system freeze,
just reduce the number. There is no "best" value - it depends on the amount
of free RAM on your system, the nature and operations of any TSRs or memory
managers you have running, etc. You should have no problems going with the
default of 50.

Finally, VW97CFG allows you to reserve some memory for use by 2COL
or JETCOL. When it loads, VIEW uses all available conventional memory
for displaying files, in 80 column lines. You must set aside memory for
2COL or JETCOL, in 2000 byte blocks, equivalent to 25 lines of file.
There is a trade-off - the more memory you set aside for
2COL/JETCOL, the fewer the lines before getting a "file too big" message.
Currently, 2COL and JETCOL require you to reserve about 50 blocks;
if you don't want direct access to them you can reduce this. However,
VIEW itself needs some memory in reserve. When asked to enter a
number of 2000 byte blocks, you should enter at least 10, and
probably 13 or 14, and at least 48 for access to 2COL and JETCOL.
You may need to experiment a little to find the minimum number of
memory blocks you need to allocate, as this will depend to some
extent on how much conventional memory your computer has available.

SUGGESTION: Configure two versions of VIEW, one with and one without
2COL/JETCOL access.

Malcolm Drury
October 9th, 1994


Look for the following shareware on Compuserve/Ziffnet or your
favorite BBS. I post it as ZIP files, but it may also appear
as ARJ (or other format) files if re-posted by others.

VGAPAL40.ZIP - customize up to 4 VGA text color palettes, choosing from more
than 250,000 colors! (And see how many you can actually
discern!). One palette can be used to create a small (2k) TSR
program that maintains your chosen scheme. Alternatively, you
can set any of the palettes, or a grey-scale scheme, from a
non-TSR if memory is a problem. (On CIS Ziffnet as

DDIR98.ZIP - double-column directory display that highlights new files,
flags system, hidden and read-only files, and optionally shows
the "dead" space on disk associated with each file or the total
space each file actually uses. Full file list sorting, and
can scroll back and forth within the file list. Has file
delete and protect/unprotect functions. Links to VIEW,
LIST and VPIC. Also archive/unarchive files via libks to
PKZIP/PKUNZIP, ARJ and LHA. (On Compuserve Ziffnet as in forum ZNT:TIPS) BBS search: DDIR??.*

DSPACE63.ZIP - shows graphically hard disk space installed, used and free,
for all drives; second program shows graphically space on
designated drive (including floppy), and reports on installed
and available RAM, including XMS and EMS memory. (On CIS
Ziffnet as, in ZNT:TIPS).


You can also search your favorite BBS for 2COL and JETCOL. Use the search
terms 2COL????.* and JETCOL??.* Current versions are 2COL 5.3 and JETCOL

CIS 70574,3457
INTERNET [email protected]

Malcolm Drury
11 Adele Crescent
Ont. K2J 2T7


This document was prepared using the BOXER (TM) text editor version 6.0a