1 11/06/89  forum request:  set_message
 2 
 3 Syntax:  set_message {-control_args}
 4 
 5 
 6 Function:
 7 Allows the chairman to set the "chairman's message" (cmsg), which will
 8 be printed the first time a user enters a transaction after entering a
 9 meeting.  It will also be printed the first time a user enters a
10 meeting after the message has changed.  The message may be up to 256
11 characters long.
12 
13 
14 Control arguments:
15 -fill, -fi
16    specifies that the transaction should be filled after the user has
17    exited input mode. This is the default, unless the -input_file
18    control argument is used or unless the -no_input_fill (-nif) control
19    argument was given with the invocation of forum.  The default fill
20    width is 72, but the user can specify the fill width via the
21    -line_length NN (-ll NN) control argument to the forum command.
22 -input_file pathname, -if pathname
23    specifies that the segment identified by pathname be entered into
24    the meeting. The default is to input the message from the terminal.
25 
26 
27 -no_fill, -nfi
28    specifies that the transaction not be filled to the default fill
29    width when entered.  The default is to fill the transaction, unless
30    the -input_file control argument is specified or the -no_input_fill
31    (-nif) control argument was specified when forum was invoked.  The
32    fill width defaults to 72, unless specified differently via the
33    -line_length NN (-ll NN) control argument was specified when forum
34    was invoked.
35 
36 
37 -no_request_loop, -nrql
38    causes the message to be entered into the forum without first
39    entering the forum request loop. (Default unless -if given)
40 -request_loop, -rql
41    causes the forum request loop to be entered before the message is
42    entered in the meeting. (Default if -if is given)
43 -terminal_input, -ti
44    Specifies that the message be input from the user's terminal.
45    (Default)
46 
47 
48 Terminal input:
49 Unless the user makes use of the -input_file control argument, the
50 message will be built by taking lines from the user's terminal.  There
51 are three methods of exiting from terminal input mode:
52 
53    line consisting of the single character period (.)
54           Enters the message as is, returns to forum request level.
55 
56    \f
57           Exits terminal input mode and invokes 'qedx' editor on message.
58 
59    \q or \fq
60           Exits terminal input mode and enters forum request loop.
61 
62 
63 Notes:
64 A message which was not entered via the period (.) exit from terminal
65 input mode may be entered from forum request level via the 'enter'
66 request.  Type 'help enter' from forum request level for details.
67 
68 The chairman's message can be referred to by the transaction specifier
69 "cmsg".  For more information see the help info for "trans_specs".
70 
71 An existing chairman's message can be changed by writing it out to a
72 file, then using that file as input to the "set_message" command:
73      forum:  w cmsg -pn foo
74      forum:  set_message -if foo.trans
75       (edit the unprocessed chairman's message, write, and quit editor)
76      forum:  enter