Copyright Digital Equipment Corp. All rights reserved.

Arguments

 

resultant-string

   OpenVMS usage:char_string
   type:         character string
   access:       write only
   mechanism:    by descriptor

   String that LIB$GET_COMMAND gets from SYS$COMMAND. The resultant-
   string argument is the address of a descriptor pointing to this
   string.
 

prompt-string

   OpenVMS usage:char_string
   type:         character string
   access:       read only
   mechanism:    by descriptor

   Prompt message that LIB$GET_COMMAND displays on the controlling
   terminal. The prompt-string argument is the address of a
   descriptor pointing to the prompt. Any string can be a valid
   prompt. By convention however, a prompt string consists of text
   followed by a colon (:),  a space, and no carriage-return/line-
   feed combination. The maximum size of the prompt message is 255
   characters. If the controlling input device is not a terminal,
   this argument is ignored.
 

resultant-length

   OpenVMS usage:word_unsigned
   type:         word (unsigned)
   access:       write only
   mechanism:    by reference

   Number of bytes written into resultant-string by LIB$GET_
   COMMAND, not counting padding in the case of a fixed string.
   The resultant-length argument is the address of an unsigned word
   containing this length. If the input string is truncated to the
   size specified in the resultant-string descriptor, resultant-
   length is set to this size. Therefore, resultant-length can
   always be used by the calling program to access a valid substring
   of resultant-string.