Description

   The CLI$DCL_PARSE routine supplies a command string to DCL for
   parsing. DCL parses the command string according to the syntax in
   the command table specified in the table argument.

   The CLI$DCL_PARSE routine can prompt for required parameters if
   you specify a parameter routine in the routine call. In addition,
   the CLI$DCL_PARSE routine can prompt for entire or continued
   command lines if you supply the address of a prompt routine.

   If you do not specify a command string to parse and the user
   enters a null string in response to the DCL prompt for a command
   string, CLI$DCL_PARSE immediately terminates and returns the
   status CLI$_NOCOMD.

   If DCL prompts for a required parameter and the user presses
   Ctrl/Z, CLI$DCL_PARSE immediately terminates and returns the
   status CLI$_NOCOMD, regardless of whether you specify or do not
   specify a command string to parse. If DCL prompts for a parameter
   that is not required and the user presses Ctrl/Z, CLI$DCL_PARSE
   returns the status CLI$_NORMAL.

   Whenever CLI$DCL_PARSE encounters an error, it both signals and
   returns the error.