


      GGGGeeeettttAAAArrrrggggssss((((3333BBBB))))                  ((((RRRRiiiiddddggggeeee))))                  GGGGeeeettttAAAArrrrggggssss((((3333BBBB))))



      NNNNAAAAMMMMEEEE
           GetArgs - get command arguments

      SSSSYYYYNNNNTTTTAAAAXXXX
           FUNCTION GetArgs (var argc : Integer) : PStringVector;

      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
           _G_e_t_A_r_g_s is used by a command process to retrieve its command
           arguments from the User Monitor.  The command arguments are
           typically file names to be operated on, or options to
           control the execution of the program.  The invoking process,
           usually the Shell, accumulates the command arguments and
           passes them to the User Monitor via StartCommand when a
           command process is started.

           GetArgs sets the argument count into aaaarrrrggggcccc and returns a
           pointer to an array of strings, as described by the
           following Pascal type definitions:

           PStringVector = ^ StringVector;
           StringVector  = Array [0..0] of String;

           The array is indexed from zero, and actually contains aaaarrrrggggcccc+1
           elements, where the last element is the value Nil.

           By convention, the string at position zero is the name of
           the command process, and the other strings are the command
           arguments in sequence.  Thus aaaarrrrggggcccc is always at least one.

      SSSSEEEEEEEE AAAALLLLSSSSOOOO
           StartCommand (3B)

      NNNNOOOOTTTTEEEESSSS
           The strings returned by GetArgs should not be deallocated
           via Dispose since they are not allocated by NewString.




















      Page 1                                                   (9010-E)



