









                            ADU/2 v2.0 Documentation

                  ***** Refers to ADU/2 Evaluation Copy ******




               Ŀ
                                      ADU /2                     
                    the professional tool for administrators     
                   of large disks especially in OS/2 networks.   
               


                  Copyright (c) 1991-1993 Th. Wentzlawski

                           General Distribution by:

                          VTS-Datensysteme GmbH & Co
                               2000 Hamburg 36
                               P.O. Box 305583
                         FAX +49 40 453873  (Germany)










          The evaluation copy of ADU /2 is free to use for a testing
          period of 30 days. You are free to copy and distribute this
          special ADU /2 Version providing that: NO FEE IS CHARGED FOR
          USE, COPYING OR DISTRIBUTION BEYOND REASONABLE HANDLING COSTS.






  DISCLAIMER Ŀ
                                                                              
  THE USER OF THE PROGRAM BY USING IT AGREES NOT TO HOLD THE AUTHOR NOR THE   
  DISTRIBUTOR LIABLE FOR ANY DAMAGE THAT MAY HAVE BEEN CAUSED BY EITHER THE   
  PROPER OR IMPROPER FUNCTIONING OR BY THE USE OR MISUSE OF THE ADU/2 SYSTEM. 
                                                                              


                                     - 1 -














                                TABLE OF CONTENTS



         1.  INTRODUCTION
             What is ADU/2 ..................................   2
             Main Highlights ................................   2
             ADU/2 Philosophy ...............................   3



         2.  RUNNING ADU/2
             Invoking ADU/2 .................................   3
             The ADU/2 Environment Variables ................   3



         3.  HOW CAN I ......................................   4




                                     - 2 -


  1.  INTRODUCTION.

  What is ADU/2 ?
  

  ADU/2 is a file and directory management tool intended for administrators
  of large disks running in an OS/2 environment. Two years ago it's main
  focus were great enterprise LAN's consisting of many IBM LAN-Servers
  or Microsofts LAN-Managers. (OS/2 Netware clients are appreciated as well
  especially if OS/2 naming support runs at the server). A GUI based tool
  may be nice, but if time is money .....

  In 1993 a lot of people run the superior OS/2 HPFS instead of the FAT file
  system and they would like to exploit the new features. And that's exactly
  what ADU/2 supports. It handles easily all of the trivial file and directory
  operations with LONG FILENAMES by preserving the EXTENDED ATTRIBUTES.

  ADU/2 is a fast filemanager with a text-based interface. ADU/2 runs either
  in a PM-Window or fullscreen session. 


  Main highlights
  

        - HPFS Support (EA's and Long Filenames)

        - No installation required

        - Small, so it is startable from diskette

        - Does not modify systems ini files nor create any unwanted files

        - Usable on diskette booted systems ( PM or WPS not required )

        - Save directory trees to user named files. That's very convenient
          for large and slow medias like CD-ROM or MO-Disks

        - Scanning, refreshing and display of subtrees is possible. Think of
          great server disks with thousends of directories requiring several
          minutes for scanning the whole directory tree.

        - detailed overview about the disk space consumption listed by
          directories and subtrees.

        - Very fast seek and scan files function with many options:
          filespec, attributes, last write , last access, creation,
          size, EA-Size, string pattern, base path.

        - An easy to use Hexeditor

        - Fine for IBM LAN-Server or Microsofts LAN-Manager network environments
          UNC-Names are supported for most of all operations.

                                     - 3 -



  ADU/2 Philosophy
  

  The ADU/2 user interface reflects the main intention of the ADU/2
  development: There should be no time consumption by opening, moving,
  sizing windows and menues. Each action should be invoked by one or
  two keys. The provided menu is not necessary for using ADU/2. The
  menu is for beginners and could be used as a help for learning the
  short cuts. The help function invoked by F1 represents only a condensed
  overview about ADU/2's keys and functions.

  ADU/2 needs only one file for operating and that's ADU.EXE. So no
  installion is required and for service and maintenance in an organisation
  it's startable from diskette. ADU/2 does not modify any system files or
  create files by itself because that is unacceptable in LAN environments.
  Mouse support is included even there is mostly no gain in time, but you
  may find it convenient if ADU/2 runs in a windowed session.


  2. RUNNING ADU/2

  Invoking ADU/2
  

  ADU/2 is simply invoked from an OS/2 command prompt either in a windowed
  or fullscreen session by typing ADU.

  Terminating ADU/2 is made easy. Experienced user will press ALT-X at any
  time they want to quit and there will be no boring prompt. Another way is
  to press ESCAPE until your are prompted for terminating ADU/2.



  The ADUEDIT Environment Variable
  

  Pressing the letter E in the File/Directory screen invokes the OS/2 systems
  editor e.exe with the highlighted entry as a parameter.
  If you would like to call your favorite editor you could specify it in the
  option menu. By terminating ADU/2 this information is lost. Setting the
  environment variable ADUEDIT will overcome this problem. For permanent use
  in all sessions you have to do it in the config.sys. For example if your
  favorite editor ist q.exe and you would like run q.exe in fullscreen mode
  add the following line to your config.sys:

                                SET ADUEDIT=Q.EXE /FS

  Other switches are /PM and /WIN. If no switch is given the program will
  determine the session mode.


                                     - 4 -


  3. HOW CAN I ...



  copy, move, rename, view, delete ...
  
  We think this is fairly self-explanatory.



  Display two file lists simultaneous
  
  For convenient file/directory move and copy operations you can open a
  second list by pressing CTRL RETURN. The inactive list is always the
  default target path. The TAB key changes the active list.



  Open a quick action context menu
  
  clicking the right mouse button in list area opens a special
  quick action menu refering to the highlighted or marked item(s).



  Show long filenames
  
  File/directory names exceeding the 8.3 FAT naming conventions may
  not be displayed with their full names. This is indicated by three
  succeeding dots. You can zoom the highlighted entry to the full name
  by pressing 'Z'. In the file/directory list it is also possible to
  scroll the names by pressing the right or left direction key.


  
  Display 'last access' and 'creation' date
  
  Pressing F2 switches the displayed file date mode. Default mode is the
  FAT supported last 'write access'. Pressing F2 once switches to
  'last access' mode and another F2 shows the file 'creation' date.



  Get a file list with EA size
  
  Ctrl-X toggles display mode: Extended Attributes size and time data.



  Get a detailed EA view
  
  Pressing X in the file list displays the EA Data for the highlighted entry

                                     - 5 -



  Print files,lists and trees
  
  Dependent on the work area pressing 'P' invokes the creation of tree or
  list print file. You will be prompted for the name of the print file.
  Specifying LPT1, for example will cause a direct print.

  You can print one or more ASCII-File(s) by invoking the copy function
  with 'C' or Ctrl-C and specify the target path as e.g. LPT1, LPT2 ...
  or an UNC-Name like \\server1\hplaser.



  Display the entry screen
  
  Pressing F12 in the file list area displays the entry screen from which
  ADU/2 was started.



  Group files and directories by using masks
  
  Advanced marking and unmarking files/directories for further processing
  could be done with '+' and/or '-'.


  Use list entries as execution arguments
  
  Alt-Return prompts you for an executable file e.g. VIEW, UNZIP ...
  which uses the highlighted entry as an argument. Additional arguments
  could be supplied.


  Control the confirm status
  
  The default status of the confirm toggle is ON. So you are prompted
  for confirmation in the case of:

  - deleting
  - overwriting
  - case changing

  ALT-C toggles the confirm status ( only in the file list screen )

  While processing a group of files/directories you can overide the
  confirm status temporary. Choose 'Rest without confirm' when the
  first confirmation prompt comes up.



  Change the case of file/directory names on HPFS drives
  
  Simply press F7 to swap the highlighted entry to upper case, Shift F7
  for lower case. Ctrl F7 refers to the marked list entries.



                                     - 6 -


  Read and refresh subtrees
  
  For extended directory structures it could save much time to scan
  only a subtree. Change to the desired basepath in file list screen
  and press then F9. Refreshing subtree data beneath a highlighted
  tree entry is done by pressing Ctrl-F5 in the tree display.



  Save and restore directory tree data to user named files
  
  For slow and large media like CD-ROM's and MO's it is very
  convenient to save a scanned tree. This is done by pressing
  ALT-W in the tree screen. ALT-R restores a previous saved
  tree. This could be done either in the file/directory list
  screen or the tree screen.


  Display space consumption listed by directory and subtrees
  
  Press F2 in the tree screen to change the size mode. The allocated
  space is shown beside each directory name. The following modes are
  available pressing F2 multiple times:

  - no size shown (default)
  - space allocated in directories
  - sum of space allocated in subtrees
  - extended attributes size related to the directory itself

  - a little dot preceding the directory name indicates the existence
    of extended attributes for this name. This is similar to the little
    'x' in the file list screen.


  Get a more handy tree display
  
  You can restrict the tree display to one or two levels by pressing
  '1' or '2'. Pressing '0' will expand all branches. Collapsing or
  expanding of a single branch could be done by pressing '-' or '+' for
  the highlighted tree entry. Clicking the left mouse button on the
  horizontal tree lines will hide the subtree. The tree line will then end
  with an arrow representing a hidden subtree. Clicking on these arrows
  will unhide the subtree.



                                     - 7 -



  Recall recent used move and copy target paths
  
  Whenever you are prompted for a target path of a copy or move operation,
  a list of recently used target paths could be provided. Simply press F4.



  Establish LAN-Connections
  
  Pressing 'J' assigns a drive to a LAN resource. Example : You got a
  IBM LAN-Server or a Microsoft LAN-Manager named APPSERV and shared
  resource named APPSDATA. After pressing 'J' the drive to assign is by
  default the next free unassigned drive. Type \\APPSERV\APPSDATA in the
  input field for the 'shared name'. 'K' release a LAN-Connection to drive.



  Edit input fields
  

  CTRL Y     deletes the rest of input field.
  CTRL T     delete the next word

  INSERT     toggles insert mode
  DEL        deletes the single character under the cursor
  BACKSPACE  deletes the single character left of the cursor

  Cursor placement
  CTRL ->          forward to the beginning of the next word
  CTRL <-          backward to the end of the previous word
  HOME             at the beginning of the input field
  END              after the last nonblank character
  CTRL HOME        in the first input field
  CTRL END         in the last input field
  TAB or          in the next input field
  SHIFT TAB or    in the previous input field

  Note:
  Some input fields are cleared automatically if the first pressed
  key is no direction key.
