home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 6 File / 06-File.zip / jsort13.zip / jsortpm.doc next >
Text File  |  1995-10-25  |  6KB  |  168 lines
  1. JSORTPM:
  2.  
  3.     Jsortpm is a shareware product that is release as a demonstration
  4. copy only. Please use it only to test and see if it fits your needs.
  5. If it doesn't fit your needs, but comes close please e-mail me with
  6. your changes and I will see if I can accomadate your changes. Use of
  7. this program is for limited use. Please register.
  8.  
  9. Why register:
  10.     Get the newest releases with bug fixes.
  11.     Get the newest functionality. 
  12.     Jsortpm is currently being improved and update with new options.
  13.             Like Numberical Sorting.
  14.             Full Drag and Drop.
  15.             Configuration saving.
  16.             Point and Click field setting from viewing first line.
  17.             Template Sorting.
  18.  
  19. JsortPm is a PM integrated sort program that is limited only by disk
  20. space that is available. It supports the use of networked drives for
  21. temp space. It also support unlimted keys to sort by. Although jsortpm
  22. needs disk space for temporary space it will sort large files relatively
  23. quickly. It will also not hog all of you memory and resources. Eventhough
  24. Jsortpm is a pm app it has the ability to support command line parameters
  25. and run from a batch file with errorlevel codes returned (see below). 
  26.  
  27. Note: Redirection is not supported since most users only redirect under
  28. 64K of data the sort that comes with Os/2 is sufficient.
  29.  
  30. USAGE: 
  31.  
  32.     1) From Icon on Desktop.
  33.     2) From Associatation.
  34.     3) From Command Line Interactive or NonInteractive.
  35.  
  36.  
  37. Command Line Options:
  38.  
  39.    USAGE:jsortpm [in file] [out file] [options] [-rmax rec. len] [-k key list]
  40.  
  41.    Option: -tdrive for a temp drive to place workfile if diskspace is 
  42.                    low on default drive
  43.  
  44.             : -c for command line full usage (No PM Window or Error messages and 
  45.                 automatic starting of sort. Might be used from a batch file. Will
  46.                 return error codes. 
  47.  
  48.     Note: If -c is not used pm interface will pop up with command line options
  49.             filled in the dialog windows. If everything looks ok just hit
  50.             start button.
  51.  
  52.    Max Rec Len: -r# Needed if variable sized records. If not given first line
  53.                          is the length used.
  54.  
  55.     Specify each key begining with -k. They are ordered in priorty with
  56.         respect to order in command line specification.
  57.  
  58.    Key List: Start:Length:[Field Options] (: for start and length)
  59.         or : Start-Ending:[Field Options] (- for start and end)
  60.  
  61.    Field Options: a or + = ascending (default)
  62.                 : d or - = descending
  63.                 : c = case sensitive (default)
  64.                 : i = case insensitve
  65.                 : n = field is translated to sort numerically
  66.                 : f = field is translated to sort numerically but field is a float value
  67.  
  68.    Notes: Number of Entries in Key List is limited to memory
  69.  
  70.    Example: jsort in_file out_file -c -r80 -k20-39:d -k40:20
  71.           : Sort infile to outfile with a max record length of 80 chars and
  72.           : Key positions 20 to 39 in desc 
  73.                 then pos. 40,20 chars long default asc
  74.  
  75.     
  76. PM Options:
  77.     
  78.     Field 1 (Input File Name): Just type in directory and file name or
  79.                                         Hit the locate button to find your file.
  80.     
  81.     Field 2 (Output File Name): Just type directory and name of output file
  82.                                          name or use locate to find location.
  83.                                          This field defaults to same directory and file
  84.                                          name with the exectension of .srt.
  85.     
  86.     Field 3 (Maximum Record Length): Type in max rec length if file has varialble
  87.                                                 length records or use arrow keys to change
  88.                                                 number.
  89.  
  90.     Field 4 (Use Temp Drive): Check if the default disk doesn't have enough space for
  91.                                       output file and temp file. If not sure jsort will return
  92.                                       an error.
  93.  
  94.     Field 5 (Temp Drive): Will show up if above is checked. Use arrow keys to scroll
  95.                                  through available drives.
  96.  
  97.     Key Fields: Start: Type in starting position of key or Use buttons or arrow keys
  98.                     End:   Type in length of field or Use buttons or arrow keys
  99.  
  100.                     Desc: Check if you want order to descend for this key.
  101.                             Defaults to ascending.
  102.  
  103.                     No Case: Check if you want order to be case-insensative.
  104.                                 Default to case-sensative.
  105.  
  106.     Hit Start to start sorting. When Jsort is done it will popup with a message showing that it
  107.     is done or an error message starting the problem and allowing you to fixit and restart it.
  108.  
  109.     Note: For Drag and Drop sorting defaulting to whole record as key and default to extension
  110.             of .srt for output file and autostart create an object with -c option in command args.
  111.  
  112.  
  113. Association:
  114.  
  115.     Under Setting Click on Associations and in the field New Name add for example *.dat if
  116.     most of your sortable files end in .dat.
  117.  
  118. Error Codes Returned for Batch Programming in cmd files:
  119.  
  120. 1   - Maximum Record length exceeded in record
  121. 2   - Invalid Command Line Argument
  122.     
  123. Greater than 9 and less than 30 are file errors
  124.  
  125. 10  - I/O Error on input file
  126. 11  - Error freeing input file
  127. 12  - I/O error on output file
  128. 13  - Not Enough Diskspace on Output File Drive
  129. 14  - Not Enough Diskspace on Work Disk Drive
  130. 15  - Not Enough Diskspace on Output File Drive and Work Drive
  131. 16  - Unable to open input file
  132. 17  - Unable to create output file
  133. 18  - Unable to create temporay sort file
  134. 19  - I/O error on intermediate file
  135. 20  - Unable to create output file
  136.  
  137. Greater than 29 are memory errors.
  138.  
  139. 30  - Memory error in Keys
  140. 31  - Memory Error: Merge Array
  141. 32  - Memory error: Merge Item
  142. 33  - Memory Error: Merge Buffer
  143. 34  - Memory Error: Out Buf Array Alloc
  144. 35  - Memory Error: Init of Data
  145. 36  - Memory Error: Key Entry
  146. 37  - Memory Error: Buffer Init
  147. 38  - Memory Error: Init of Sort Array
  148. 39  - Memroy Error: Sort Buffer
  149. 40  - Memory Error: Merge Entry
  150.  
  151.  
  152. History:
  153. Current Version 1.3
  154. Fixed resolution viewing for 640x480.
  155. Fixed command line option to work better.
  156. Fixed minor bugs.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.