From:	MERC::"uunet!WKUVX1.BITNET!goathunter"  3-JUN-1992 16:44:15.19
To:	temporary@WKUVX1.BITNET
CC:	
Subj:	Help file for DX (at last)

Hi.  My records show you picked up DX from FILESERV@WKUVX1.BITNET.  The
author of DX just sent me (finally) the on-line help file for DX.  I've
enclosed it below for your convenience.

Hunter
------
Hunter Goatley, VMS Systems Programmer, Western Kentucky University
goathunter@WKUVX1.BITNET, 502-745-5251

$! ------------------ CUT HERE -----------------------
$ v='f$verify(f$trnlnm("SHARE_VERIFY"))'
$!
$! This archive created by VMS_SHARE Version 7.2-007  22-FEB-1990
$!   On  3-JUN-1992 13:52:35.81   By user GOATHUNTER (@WKUVX1.BITNET)
$!
$! This VMS_SHARE Written by:
$!    Andy Harper, Kings College London UK
$!
$! Acknowledgements to:
$!    James Gray       - Original VMS_SHARE
$!    Michael Bednarek - Original Concept and implementation
$!
$! TO UNPACK THIS SHARE FILE, CONCATENATE ALL PARTS IN ORDER
$! AND EXECUTE AS A COMMAND PROCEDURE  (  @name  )
$!
$! THE FOLLOWING FILE(S) WILL BE CREATED AFTER UNPACKING:
$!       1. DX_HELP.README;1
$!       2. DX.HLP;1
$!
$set="set"
$set symbol/scope=(nolocal,noglobal)
$f=f$parse("SHARE_TEMP","SYS$SCRATCH:.TMP_"+f$getjpi("","PID"))
$e="write sys$error  ""%UNPACK"", "
$w="write sys$output ""%UNPACK"", "
$ if f$trnlnm("SHARE_LOG") then $ w = "!"
$ ve=f$getsyi("version")
$ if ve-f$extract(0,1,ve) .ges. "4.4" then $ goto START
$ e "-E-OLDVER, Must run at least VMS 4.4"
$ v=f$verify(v)
$ exit 44
$UNPACK: SUBROUTINE ! P1=filename, P2=checksum
$ if f$search(P1) .eqs. "" then $ goto file_absent
$ e "-W-EXISTS, File ''P1' exists. Skipped."
$ delete 'f'*
$ exit
$file_absent:
$ if f$parse(P1) .nes. "" then $ goto dirok
$ dn=f$parse(P1,,,"DIRECTORY")
$ w "-I-CREDIR, Creating directory ''dn'."
$ create/dir 'dn'
$ if $status then $ goto dirok
$ e "-E-CREDIRFAIL, Unable to create ''dn'. File skipped."
$ delete 'f'*
$ exit
$dirok:
$ w "-I-PROCESS, Processing file ''P1'."
$ if .not. f$verify() then $ define/user sys$output nl:
$ EDIT/TPU/NOSEC/NODIS/COM=SYS$INPUT 'f'/OUT='P1'
PROCEDURE Unpacker ON_ERROR ENDON_ERROR;SET(FACILITY_NAME,"UNPACK");SET(
SUCCESS,OFF);SET(INFORMATIONAL,OFF);f:=GET_INFO(COMMAND_LINE,"file_name");b:=
CREATE_BUFFER(f,f);p:=SPAN(" ")@r&LINE_END;POSITION(BEGINNING_OF(b));
LOOP EXITIF SEARCH(p,FORWARD)=0;POSITION(r);ERASE(r);ENDLOOP;POSITION(
BEGINNING_OF(b));g:=0;LOOP EXITIF MARK(NONE)=END_OF(b);x:=ERASE_CHARACTER(1);
IF g=0 THEN IF x="X" THEN MOVE_VERTICAL(1);ENDIF;IF x="V" THEN APPEND_LINE;
MOVE_HORIZONTAL(-CURRENT_OFFSET);MOVE_VERTICAL(1);ENDIF;IF x="+" THEN g:=1;
ERASE_LINE;ENDIF;ELSE IF x="-" THEN IF INDEX(CURRENT_LINE,"+-+-+-+-+-+-+-+")=
1 THEN g:=0;ENDIF;ENDIF;ERASE_LINE;ENDIF;ENDLOOP;t:="0123456789ABCDEF";
POSITION(BEGINNING_OF(b));LOOP r:=SEARCH("`",FORWARD);EXITIF r=0;POSITION(r);
ERASE(r);x1:=INDEX(t,ERASE_CHARACTER(1))-1;x2:=INDEX(t,ERASE_CHARACTER(1))-1;
COPY_TEXT(ASCII(16*x1+x2));ENDLOOP;WRITE_FILE(b,GET_INFO(COMMAND_LINE,
"output_file"));ENDPROCEDURE;Unpacker;QUIT;
$ delete/nolog 'f'*
$ CHECKSUM 'P1'
$ IF CHECKSUM$CHECKSUM .eqs. P2 THEN $ EXIT
$ e "-E-CHKSMFAIL, Checksum of ''P1' failed."
$ ENDSUBROUTINE
$START:
$ create 'f'
XDX.HLP is the help file for DX.  To build the library, execute the following
Xcommand:
X
X`09$ LIBRARY/CREATE/HELP DXHELP DX.HLP
$ CALL UNPACK DX_HELP.README;1 1459951728
$ create 'f'
X1 DX
XDX (Directory eXtension) is a VAX/VMS utility that performs various
Xfile operations on a VT100 or upper terminals.  It allows you to
Xdelete, type, copy, set protection, compare, and edit one or more
Xfiles at once.  DX is a customizable, flexible, real-time directory
Xbrowser/editor.  You can use it to open multiple windows on the
Xsame or different directories.
X
XDX provides the following main features:
X
Xo  Flexible display and sorting
X
Xo  Pull-down menu for point-and-shoot interface
X
Xo  Display sub-directories and directory contents with flexible
X   "filters"
X
Xo  Multiple inclusion/exclusion patterns in file operations
X
Xo  Multiple windows provides different views
X
Xo  Display a tree-like directory structure in a scrollable window
X
X
X*****
XVAX and VMS are trademarks of Digital Equipment Corporation.
X
X2 Getting_Started
XDX provides multiple windows and point-and-shoot menus that
Xgreatly simplify file operations including delete, copy, type,
Xrename, set protection and many more.
X
X
XFormat:
X
X`09$ DX filespec`5B,...`5D
X
X3 Parameters
X
X4 filespec`5B,...`5D
XSpecifies one or more files to be listed.  Wildcard characters
Xcan be used to specify the directory specification, file name,
Xfile type, or version number fields of a file.  If you specify
Xmore than one file, separate the file specifications with either
Xcommas (,)  or plus signs (+).
X
X3 Command_Qualifiers
X
X4 /INITIAL_FILE=init_file
XWhen DX is started, it normally loads various settings from
Xthe file 'DX$STARTUP.DAT' in your current directory.  If it
Xdoesn't exist, DX tries your home directory.  The command
Xqualifier /INITIAL_FILE can be used to load an init file
Xwith another name or from another directory.
X
X4 /SORT_BY=criteria
XDX provides several way to sort the files.  You can sort
Xfiles by NAME, TYPE, SIZE, DATE, or MARK.  The default is
Xsort by NAME.
X
X4 /ASCENDING
XSorts the files in ascending order; this is the default
Xsetting.
X
X4 /DESCENDING
XSorts the files in descending order.
X
X4 /BRIEF
XLists the files in multiple column output; only the file name,
Xfile type, and version are displayed.
X
X4 /DETAIL
XLists in long format, giving file name, file type, version,
Xdate, size in blocks, and protections.  Depending on the
Xdate type you specified, the date can be displayed in
Xcreation date, last modified date, expired date, or backup
Xdate.
X
X4 /BEFORE=time
XLists only the files that was created before the specified
Xdate.  You can use the following values:
X
Xo  TODAY
X
Xo  YESTERDAY
X
Xo  TOMORROW
X
Xo  absolute time (dd-mmm-yy:hh:mm:ss.tt)
X
X4 /SINCE=time
XLists only the files that was created after the specified
Xdate.  You can use the following values:
X
Xo  TODAY
X
Xo  YESTERDAY
X
Xo  TOMORROW
X
Xo  absolute time (dd-mmm-yy:hh:mm:ss.tt)
X
X4 /CREATED
XLists with the creation date; this is the default setting.
X
X4 /MODIFIED
XLists with the last modified date.
X
X4 /EXPIRED
XLists with the expired date.
X
X4 /BACKUP
XLists with the backup date.
X
X4 /MAXIMUM=blocks
XLists the files that are equal or smaller than the specified
Xblocks.
X
X4 /MINIMUM=blocks
XLists the files that are at least as large as the specified
Xblocks.
X
X4 /EXCLUDE=filespec
XLists only the files that are excluding from the specified
Xfilespec.
X
X3 Examples
X1. Lists the files in the current directory.
X
X`09$ DX
X
X
X2. Lists all the files in SYS$USER02:`5BJDOL.DOC`5D and all the
X.com files in SYS$USER05:`5BDREMKER`5D.  The output is sorted by
Xlast modified date in descending order.
X
X`09$  DX/SORT=MODIFIED/DESCENDING SYS$USER02:`5BJDOL.DOC`5D, -
X`09_$ SYS$USER05:`5BDREMKER`5D*.COM
X
X
X3. Lists all the .doc and .exe files in the current directory
Xthat are larger than or equal to 50 blocks.  Only the file name
Xis listed.
X
X`09$  DX/MIN=50/BRIEF *.DOC, *.EXE
X
X2 Pulldown_Menus
XThe main menu for DX displays a row of choices across the top
Xof the screen.  All other menu are sub-menus of the main menu
Xand appear as vertical lists of choices.
X
XYou can select a menu choice by typing the capital letter of
Xthe desired item.  For example, press the letter w (or W)
Xto bring up the Window sub-menu.
X
XWithin the sub-menu, you can use the UP or DOWN arrow keys
Xto position the cursor to desired item (shown by the
Xhighlighting) and press RETURN.  Alternately, you can type the
Xcapital letter of the item;  DX executes it immediately if it
Xcan be uniquely identified.  You can also move between menu
Xchoices using the LEFT and RIGHT arrow keys.
X
XIf you accidentally call up the sub-menu and want to cancel
Xit, simply press the keypad 0 key and the sub-menu disappears.
X
X2 Window_Menu
XThe Window_Menu provides window management operation, which
Xcan display parts of different directories, or different parts
Xof one directory.
X
XThe following list summarizes the supported functions.
X
XSplit window     Splits the selected window in two, with all
X                 the windows get the same number of lines.
X                 Depending on the terminal you used, the number
X                 of windows splited can be ranging from three
X                 to seven.
X
XDelete window    Gets rid the selected window.
X
XOne window       Gets rid of all windows except the selected
X                 one.
X
XNext window      Selects the next window.
X
XPrevious window  Selects the previous window.
X
XeXit             Quits DX and set default directory to the
X                 current directory.
X
X2 Action_Menu
XThe Action_Menu provides all the VMS file management
Xoperations.  And multi-file mode let you work with one
Xfile or several hundred files with equal ease.
X
XThe following list summarizes the supported functions.
X
XType             Reads the file and display it on the
X                 terminal.  It normally pauses after
X                 each screenful.  If you press DOWN
X                 arrow, one more page is displayed.
X                 If you press UP arrow, previous page
X                 is displayed.  You can press keypad 0
X                 key to return to DX.
X
XEdit             Edits the highlighted file use desired
X                 editor.  See Editor under the
X                 Customize_Menu for more detail.
X
X
XDelete           Deletes the highlighted file.
X
XPurge            Purges the highlighted file.
X
XRename           Renames the highlighted file.  You
X                 are prompted to provide a new name.
X
XCopy             Copys to another file.
X
XAppend           Appends to another file.
X
XSet protection   Changes the file protections.
X
XPrint            Outputs the file to a printing device.
X                 Currently, only SYS$PRINT is supported.
X
XShow             Shows the details of the file attributes.
X
XFind             Searchs the file for lines matching a
X                 pattern.  The patterns are fixed strings.
X
XRun              Executes the file.  Normally, you select
X                 this option to execute on the .COM or
X                 .EXE files.
X
XCompare          Differential file comparator.
X
XpacK             Compresses a file.  All the file
X                 attributes are preserved along with
X                 the file contents.
X
XUnpack           De-compresses a file.  The original
X                 file attributes are also restored.
X
X2 Execute_Menu
XThe Execute_Menu allows you to execute DCL commands
Xwithout leaving DX.
X
XCommand          Executes a DCL command.
X
XVMS Gateway      Spawns a subprocess.  You can type
X                 "LOGOFF" to kill the subprocess and
X                 return to DX.
X
X2 Sort_Menu
XSorts the files in different ways.
X
XThe following list summarizes the supported functions.
X
Xby Name          Sorts files by name.
X
Xby Type          Sorts files by type.
X
Xby Date          Sorts files by date.
X
Xby Size          Sorts files by size.
X
Xby Marked        Sorts files by marked.
X
X2 Filter_Menu
XThe Filter_Menu allows you to use different selection
Xcriteria to select any subset of files you need.
X
XThe following list summarizes the supported functions.
X
XName             Selects files by name.  You can specify
X                 one or more regular VMS file specifications,
X                 separated the file specifications by commas
X                 (,) or plus signs (+).
X
XExclude          Selects files that are not in the specified
X                 file specification.
X
XSince            Selects files that were created after
X                 the specified date.
X
XBefore           Selects files that were created before
X                 the specified date.
X
XmaXimum          Selects files that are less than or equal to
X                 the specified blocks.
X
XMinimum          Selects files that are larger than or equal
X                 to the specified blocks.
X
X2 Option_Menu
XThe Option_Menu provides additional directory or file
Xmanagement operations.
X
XThe following list summarizes the supported functions.
X
XDirect tree      Displays a graphic directory tree, starting
X                 from the current root directory.
X
XUpdate           Refreshs the screen by re-reading the
X                 files from the disk.
X
XMkdir            Creates a new directory.
X
Xshow Buffer      Displays information about the buffers.
X                 DX keeps the file information in a buffer
X                 each time you visit a directory.
X
XWrite            Outputs the listing to an external file.
X
XGoto             Goto the specified page.
X
XShort form       Lists the files in multiple column output;
X                 only the file name, file type, and version
X                 are displayed.
X
XLong form        Lists in long format, giving file name, file
X                 type, version, date, size in blocks, and
X                 protections.
X
XInclude all      Marks all files to be included in multiple
X                 mode.
X
XExclude all      Un-marks all files.
X
XRe-include all   Marks all the files that have been executed
X                 during previous multiple operation.
X
XAbout DX         Displays DX version information.
X
X3 Moving_Around_Dirtree
XFor details, please see the topics under Keypad.
X
X2 Customize_Menu
XThe Customize_Menu allows you to tailor to your personal
Xpreferences (i.e. the editor you want to use, or confirmation
Xbefore each file deletion.)
X
XThe following list summarizes the supported functions.
X
XEditor           Specifies the desired editor.  The valid
X                 value are: EDT and TPU.  (You can also
X                 specify LSE if your site have it installed.)
X
XDisplay with date
X                 Specifies the kind of date to disply on
X                 the screen.  The valid values are:
X                 CREATION DATE, MODIFIED DATE, BACKUP DATE,
X                 and EXPIRED DATE.
X
XType file        Specifies whether the Type operation should
X                 pauses after each screenful of display.
X
XAuto update      Specifies whether DX should re-read from
X                 the disk after an edit, execute DCL command,
X                 or VMS gateway operation is performed.
X
XDelete confirm   Specifies whether DX should prompt you
X                 for confirmation every time a deletion
X                 operation is performed.
X
XPurge confirm    Specifies whether DX should prompt you
X                 for confirmation every time a purge
X                 operation is performed.
X
XShow clock       Specifies whether DX should display a
X                 clock at the upper right corner of the
X                 screen.
X
XFlash clock colon
X                 Specifies whether DX should flash clock
X                 colon on and off.
X
XSave settings    Saves the current settings to a file.
X
XRestore settings Restores the settings from a file.
X
XUse defaults     Use the default settings.
X
X2 Multiple_Mode
XDX normally operates in single mode; a file
Xoperation only affects the highlighted file.  If,
Xhowever, you want to perform a file operation on
Xmore than one files, you can use multiple mode as
Xfollows:
X
Xo  Move the cursor to the desired file and press
X   keypad 7.  You will notice an inclusion mark,
X   expressed as an asterisk (*) sign, is displayed
X   to the left of the file.  Repeat this step as
X   needed.
X
Xo  Press keypad 9.  Now the mode in the status line
X   changes from SINGLE to MULTIPLE.
X
Xo  Select a file operation and start execution.
X   As DX is visiting each file, the inclusion mark
X   is replaced by a plus (+) sign.
X
X2 Keypad
XYou move the cursor from one file to another using arrow
Xkeys and the keypad keys.  For example, when you press
Xkeypad 8, DX scrolls up or down one screenful of files.
XYou can press keypad 2 to toggle the direction.
X
XHere is a summary of the functions that the keypad performs:
X
X  KEYPAD  FUNCTION
X  ------  ------------------------------------------------
X    1     Display this help text.
X    2     Toggle direction between forward and backup.
X    3     Search the file or directory matching a pattern
X    4     Search next file or directory.
X    5     Move to the first file or directory.
X    6     Move to the last file or directory.
X    7     Toggle multiple inclusion flag in FILER mode;
X          or move to the initial directory in DIRECTORY
X          mode.
X    8     Scroll up or down one screenful of display.
X    9     Toggle between SINGLE and MULTIPLE mode (in
X          FILER mode).
X    0     Cancel current operation.
X
X2 Entering_Input
XThere are several function keys you can use when DX
Xprompts you for some input:
X
Xo  CTRL/U      Delete the whole input line
Xo  CTRL/J      Delete the previous word
Xo  CTRL/H      Move the cursor to beginning of the input line
Xo  CTRL/E      Move the cursor to end of the input line
Xo  CTRL/A      Toggle overwrite or insert mode
Xo  UP arrow    Restore the previous input from the buffer
Xo  DOWN arrow  Restore the next input from the buffer
Xo  Keypad 0    Cancel current operation
X
X2 Warranty
XDISTRIBUTION AND COPYRIGHT:
X
XCopyright (C) 1989, 1992 Chau-Kuang Hung
XThis program is free software; permission is granted to any
Xindividual or institution to use, copy, or redistribute this
Xsoftware so long as it is not sold for profit, provided this
Xcopyright notice is retained.
X
XDISCLAIMER:
X
XThis software and its documentation are provided "AS IS" and
Xwithout any expressed or implied warranties whatsoever.  No
Xwarranties as to performance, merchantability, or fitness for
Xa particular purpose exist.
X
XIn no event shall any person or organization of people be
Xheld responsible for any direct, indirect, consequential
Xor inconsequential damages or lost profits.
X
X2 Problems_and_Comments
X  Please direct all comments, suggestions, and bugs to
X
X      Chau-Kuang Hung (chung@appseq.us.oracle.com)
X      Oracle Corporation
X      300 Oracle Parkway
X      BOX 659304
X      Redwood Shores, CA 94065
$ CALL UNPACK DX.HLP;1 454255613
$ v=f$verify(v)
$ EXIT
