home *** CD-ROM | disk | FTP | other *** search
/ 8bitfiles.net/archives / archives.tar / archives / genie-commodore-file-library / C128CPM / SETPTH10.LBR / SETPTH10.DOC < prev    next >
Encoding:
Text File  |  2019-04-13  |  2.0 KB  |  65 lines
  1. SETPATH is derived from PATH and differs primarily in that it supports an
  2. additional syntax form as follows:
  3.  
  4.     SETPATH [option element-list] ... [option element-list]
  5.  
  6. where the following options are supported:
  7.  
  8.     /C    Clear path and put in new element list
  9.     /P    Prefix list of elements to the beginning of the current path
  10.     /A    Append list of elements to the end of the current path
  11.     /D    Delete listed elements from the path starting from the
  12.         beginning of the current path
  13.     /R    Remove listed elements from the path starting from the
  14.         end of the current path
  15.  
  16. Here are some examples of these commands.  Assume that the initial path is
  17. "A0 $$ A0" before each of these commands is executed.
  18.  
  19.     command:    SETPATH /A A15
  20.     resulting path:    A0 $$ A0 A15
  21.  
  22.     command:    SETPATH /P A1 B1
  23.     resulting path:    A1 B1 A0 $$ A0
  24.  
  25.     command:    SETPATH /D A0
  26.     resulting path:    $$ A0
  27.  
  28.     command:    SETPATH /R A0
  29.     resulting path:    A0 $$
  30.  
  31.     command:    SETPATH /P A1 /R A0 /A A$
  32.     resulting path:    A1 A0 $$ A$
  33.  
  34.  
  35. SETPATH performs each operation independently.  Consequently, the command
  36.  
  37.             SETPATH /P A1 /A B1
  38.  
  39. is equivalent to the command
  40.  
  41.             SETPATH /P B1 A1
  42.  
  43. and NOT            SETPATH /P A1 B1
  44.  
  45.  
  46.  
  47. The temporary prefix and temporary append buffers are each limited in size
  48. to the size of the system's symbolic path buffer.
  49.  
  50.  
  51. SETPATH sets the program error flag in the ZCPR3 message buffer to reflect
  52. the result of the command operation.  If all succeeded, the error flag is
  53. cleared to a value of zero.  Otherwise it is set to one of the following
  54. values to show the type of error that occurred:
  55.  
  56.     1.    there is no external path buffer
  57.     2.    the wheel byte is not set
  58.     3.    an illegal option was specified
  59.     4.    the final path is empty
  60.     5.    too many elements for the temporary path buffer
  61.     6.    too many elements in final symbolic path
  62.     7.    too many elements in the temporary prefix buffer
  63.     8.    too many elements in the temporary append buffer
  64.     9.    bad path expression (e.g., nonexistent directory name
  65.