6-MAY-83		    Miscellaneous tools

				GenRad, Inc.
			       300 Baker Ave.
			      Concord, MA. 01742

				       Authors: several
				       Contact: Stephen Klein


	In the following descriptions, upper case text should be typed as
shown, whereas lower case text is used for parameters which must be supplied
by the user.  Square brackets ("[" and "]") are used to indicate optional
parameters and are not part of the command syntax.  Several tools use ">" and
"<" in their command lines.  These symbols indicate redirection of standard
input ("<") or standard output (">"), and are part of the command syntax.
There must be no whitespace between the "<" or ">" and the corresponding
filespec.




	Command line				Function


"LOGINMSG"				This is used in a LOGIN.COM instead of
					"@sys$library:syslogin".  It has the
					same effects, except that it only
					displays the changes in the login
					message.  (author: Steve Klein).

"NATIVEC"				Defines several symbols which pre-
					answer the questions asked by
					sys$library:com.com - to select the
					Whitesmith Native mode C compiler with
					no debugger, and single module
					programs.  (author: Steve Klein).

"MUN MISCTLS:FLUSH,filespec"		"Flush" a text file.  This converts a
					text file from a weird format to the
					standard format (variable length
					records with implied carriage control).
					The command invokes TECO in MUNG mode,
					executing the teco macro FLUSH.TEC.
					This is most frequently used in command
					procedures, where the DCL OPEN/WRITE
					command produces a file with a strange
					format.  Note - this does not produce
					a new version of the file.  An
					alternate form is "outfile=infile"
					in place of "filespec", which does
					create a new file.
					(author: Gordon Weekly).

"CWL filespec [outfile]"		Count the number of characters, words,
					and lines in "filespec", optionally
					sending output to "outfile".  By
					default, output goes to the terminal.
					The output consists of one line with 3
					decimal numbers on it with a space used
					as the delimiter. (author: Steve Klein)

"CCOUNT filespec"			Column counter.  Makes it easy to count
					columns in a text file.  It displays
					lines of the file interspersed with a
					"ruler" which counts from 1 to 80.
					This is useful in conjunction with the
					reformatter (which can use column
					addressing).  (author: Steve Klein)

"CLEAN [directory]"			Clean a directory.  This command
					procedure walks you through the files
					in a directory and helps you decide
					what to keep.  If no directory is
					specified, the default directory is
					assumed.  Help is available by running
					the procedure.  (author: Steve Klein)

"FETCH node:wildspec"			This command is a work-around to the
					problems with pulling files over the
					network with DECNET.  "node" is a
					remote node, "wildspec" is a filespec
					which may contain wildcards.  Note -
					"wildspec" is actually interpreted by
					the DIRECTORY command, so specify a
					version number to avoid defaulting to
					all versions.  In any case, only one
					version of each output file is created.
					The output files are created in the
					default directory.(author: Steve Klein)

"SAMPLE infile [outfile] col1 width [-D]" Sample a text file ("infile") by only
					writing to "outfile" those lines which
					show a change in the specified field.
					This is useful after sorting a text
					file by sampling on the sort key to get
					one of each value that shows up in the
					sort field.  The leftmost column is
					column 1.  If no output file is
					specified, a new version of the input
					file is created.  Type "SAMPLE ?" for
					help. (-D reverses this behavior by
					keeping only duplicate lines).
					(author: Steve Klein).

"REFORMAT infile [outfile] [<template]"	Reformat a text file.  If outfile is
					not specified, a new version of the
					input file is created.  The "template"
					may be read from a file if desired.
					See MISCTLS:REFORMAT.DOC for a full
					description. Note - VMSTOOLS:CFCOMS.COM
					redefines this command to know about
					the current file. (Author: Steve Klein)

"DETAB infile [outfile] [-Mmargin] [-Ttabsize]"	Operates on a text file to
						convert tabs to an equivalent
						number of spaces.  The defaults
					are for no left margin (0 columns), and
					a tabsize of 8 spaces.  Note -
					VMSTOOLS:CFCOMS.COM redefines this
					command to know about the current file.
					If no output file is specified, a new
					version of the input file is created.
					(author: Steve Klein)

"SNOOP"					See what images everyone on the system
					is running.  This requires privilege.
					(author: Ken Budnik).

"CLR"					Clear the screen on a vt100
					(author: Mitch Brown).

"SCRL [topline] [bottomline]"		Set the scrolling region on a vt100.
					Line 1 is at the top of the screen.
					For example, "SCRL 13 24" sets up the
					bottom half of the screen as the
					scrolling region, and freezes the top
					half.  "SCRL" with no parameters resets
					the scrolling region to the entire
					screen.  (author: Mitch Brown).

"INFO processname"			Do a show process/continuous given
					a process name.  This works even for
					processes not in your UIC group.
					(author: Steve Klein).

"BINFO jobname"				Do a show process/continuous on a batch
     or					job given the job name (which by
"BINFO _jobnumber"			default is the name of the command
					file), or job number.  Examples:
					"BINFO COMPILE", "BINFO _322"
					(author: Steve Klein).

"KILL processname"			Do a stop process given a process name.
					(author: Steve Klein).

"BKILL jobname"				Do a stop process on a batch job given
     or					its job name or job number (preceded by
"BKILL _jobnumber"			an underscore).  (author: Steve Klein)

"LOO filespec"				Looks at a file a screen at a time. One
					can move forward and backward screens,
					and search for a "regular expression".
					Type "LOO" for help.  (from a DECUS
					tape).

"GREP [flags] expr files"		GREP stands for Get Regular Expression
					and Print!  It allows one to search
					multiple files for all occurrences of a
					string or pattern.  The advantage over
					the DCL search command is that regular
					expressions are more versatile than
					literal strings.  Type "GREP ?" for
					help.  (from a DECUS tape).

"SYSEDT filespec"			SYSEDT is used to edit a file which
					must be read or executed by someone
					else.  It first checks that a .JOU file
					does not exist to prevent simultaneous
					edits. It then calls EDT to perform the
					edit.  (The user must define the symbol
					EDT).  After the edit is complete the
					file protection is set to S:RWED O:RWED
					G:RWE W:RE and the file ownership is
					changed to the owner of the directory. 
					(author: Ken Budnik).

"NAMES [someone's_last_name]"		NAMES looks up someone's last name in a
					datafile, and if the name is found,
					prints the person's name, telephone
					extension, and electronic mail address.
					It is also possible to specify only the
					first few letters of the last name, in
					which case NAMES will show all the
					lines in the datafile for which the
					first few letters match.  "NAMES B"
					would list all the people whose last
					name starts with B.  If no parameter
					is specified, the entire datafile is
					listed.  (author: Ken Budnik).

"UPDATE copy_dir master_dir [NOTE]"	UPDATE is useful for applying
					incremental changes to a copy directory
					after changes have been made and
					checked out in the master directory.
					UPDATE creates a command procedure in
					the default directory called UPDATE.OUT
					which contains the copy and delete
					commands necessary to make copy_dir a
					faithful copy of master_dir.  Actually,
					the copy commands are implemented as
					type/output commands so that they will
					work over the network!  It is
					recommended that you read UPDATE.OUT
					before executing it so you have a
					chance to verify the files which will
					be deleted when it runs!  If the
					keyword "NOTE" is specified as the
					third argument, a note will be printed
					if a file is discovered in the copy
					directory which is more recent than
					the corresponding file in the master
					directory.  This makes it possible for
					one to detect all differences between
					the two directories.
					(author: Steve Klein).

"TSEARCH file(s) string(s) [flags] [>outfile]"	Token search.  TSEARCH searches
						one or more files for all
					occurrences of one or more strings, and
					prints lines containing matches.  The
					strings are matched as tokens - that
					is, a match only occurs if the string
					has delimiting characters adjacent to
					it.  The tokens found are highlighted
					by displaying them in reverse video.
					Type "TSEARCH ?" for more help.
					(author: Steve Klein).

"REMOVE [<infile] [>outfile] [-flag] ... [-flag]"    Remove unwanted parts of
						     a C program.  This program
					can remove comments, quoted strings,
					quoted characters, anything inside { },
					multiple blank lines, all of the above,
					or any combination.  Type "REMOVE ?"
					for help.  (author: Steve Klein).


"CRYPT [<infile] [>outfile] [-D] -Kkey"		Encrypt a text file.
		and				   (-D = decrypt)
"DECRYPT [<infile] [>outfile] -Kkey"		Decrypt a text file.

					Type "CRYPT ?" for help.
					(author: Steve Klein).


"BTT  infile  [outfile]  [*EXPAND]"	Convert a binary file to a text file.
              or					or
"TTB  infile  [outfile]  [*EXPAND]"	Convert a text file to a binary file.
					Type "BTT ?" for help.  Possible uses
					are to encrypt binary data by first
					making it a text file; editing an
					executable image with EDT....
					(author: Steve Klein).

"TAIL filespec [-n]"			Print the tail end of a text file.
					If specified, n is the number of lines
					to print.  The default is to print the
					last 10 lines of the file.  Type
					"TAIL ?" for help.(author: Steve Klein)

"CRYPTEDT filespec"			Edit (or create) an ecncrypted file.
					It prompts you for the encryption key.
					It invokes "EDT" - so you must be sure
					that this symbol is defined. To recover
					from a crash, re-issue the original
					command.  It will notice the presence
					of the journal file and ask you if you
					want to recover.  Read
					SR:[TOOLS.EDTMACRO]SAMPLEEDT.COM for
					more information on recovery.
					(authors: Ken Budnik, Steve Klein).