1 11/06/89  query
 2 
 3 Syntax as an active function:  [query arg {-control_args}]
 4 
 5 
 6 Function:  asks the user a question and returns the value true if the
 7 user's answer to the question is "yes" or false if the user's answer is
 8 "no"; if the user's answer is anything else, the query active function
 9 prints a message asking for a "yes" or "no" answer.
10 
11 
12 Arguments:
13 arg
14    is the question to be asked.  If the question contains spaces or
15    other command language characters, it must be enclosed in quotes.
16 
17 
18 Control arguments:
19 -brief, -bf
20    suppresses extra spacing and newlines when asking questions.
21 -disable_cp_escape, -dcpe
22    disables the ability to escape to the command processor via the ".."
23    response.  See "Notes on command processor escape" below.
24 -enable_cp_escape, -ecpe
25    enables the ability to escape to the command processor via the ".."
26    response.  See "Notes on command processor escape" below.
27 -input_switch STR, -isw STR
28    specifies the I/O switch to use for input of the user's response.
29    The default is user_i/o.
30 -long, -lg
31    adds a leading newline and three trailing spaces to the question.
32    This is the default.
33 
34 
35 -no_trim
36    do not trim trailing spaces from the question argument.
37 -output_switch STR, -osw STR
38    specifies the I/O switch to use for output of the question to the
39    user.  The default is user_i/o.
40 -repeat DT, -rp DT
41    repeats the question every DT if the user has not responded where DT
42    must be in a form suitable for input to the convert_date_to_binary_
43    subroutine.
44 -trim
45    trim trailing spaces from the question argument. (Default)
46 
47 
48 Notes:  The format_line active function can be used to insert other
49 active function values into the question.
50 
51 
52 Notes on command processor escape:  The -disable_cp_escape and
53 -enable_cp_escape control arguments override the system or subsystem
54 default.  The system default is "enabled".  Subsystems may define the
55 default to be either "enable" or "disable".  See the command_query_
56 subroutine for details.