1message(1F) FMLI Commands message(1F)
2
3
4
6 message - puts its arguments on FMLI message line
7
9 message [-t] [-b [num]] [-o] [-w] [string]
10
11
12 message [-f] [-b [num]] [-o] [-w] [string]
13
14
15 message [-p] [-b [num]] [-o] [-w] [string]
16
17
19 The message command puts string out on the FMLI message line. If there
20 is no string, the stdin input to message will be used. The output of
21 message has a duration (length of time it remains on the message line).
22 The default duration is "transient": it or one of two other durations
23 can be requested with the mutually-exclusive options below.
24
25
26 Messages displayed with message -p will replace (change the value of)
27 any message currently displayed or stored via use of the permanentmsg
28 descriptor. Likewise, message -f will replace any message currently
29 displayed or stored via use of the framemsg descriptor. If more than
30 one message in a frame definition file is specified with the -p option,
31 the last one specified will be the permanent duration message.
32
33
34 The string argument should always be the last argument.
35
37 -t Explicitly defines a message to have transient duration.
38 Transient messages remain on the message line only until the
39 user presses another key or a CHECKWORLD occurs. The
40 descriptors itemmsg , fieldmsg , invalidmsg , choicemsg ,
41 the default-if-not-defined value of oninterrupt , and FMLI
42 generated error messages (that is, from syntax errors) also
43 output transient duration messages. Transient messages take
44 precedence over both frame messages and permanent messages.
45
46
47 -f Defines a message to have "frame" duration. Frame messages
48 remain on the message line as long as the frame in which
49 they are defined is current. The descriptor framemsg also
50 outputs a frame duration message. Frame messages take prece‐
51 dence over permanent messages.
52
53
54 -p Defines a message to have "permanent" duration. Permanent
55 messages remain on the message line for the length of the
56 FMLI session, unless explicitly replaced by another perma‐
57 nent message or temporarily superseded by a transient mes‐
58 sage or frame message. A permanent message is not affected
59 by navigating away from, or by closing, the frame which gen‐
60 erated the permanent message. The descriptor permanentmsg
61 also outputs a permanent duration message.
62
63
64 -b[num] Rings the terminal bell num times, where num is an integer
65 from 1 to 10. The default value is 1. If the terminal has no
66 bell, the screen will flash num times instead, if possible.
67
68
69 -o Forces message to duplicate its message to stdout .
70
71
72 -w Turns on the working indicator.
73
74
76 Example 1 A sample output of message on the message line:
77
78
79 When a value entered in a field is invalid, ring the bell 3 times and
80 then display Invalid Entry: Try again! on the message line:
81
82
83 invalidmsg=`message -b 3 "Invalid Entry: Try again!"`
84
85
86
87
88 Display a message that tells the user what is being done:
89
90
91 done=`message EDITOR has been set in your environment` close
92
93
94
95
96 Display a message on the message line and stdout for each field in a
97 form (a pseudo-"field duration" message).
98
99
100 fieldmsg="`message -o -f "Enter a filename."`"
101
102
103
104
105 Display a blank transient message (effect is to "remove" a permanent or
106 frame duration message).
107
108
109 done=`message ""` nop
110
111
112
114 See attributes(5) for descriptions of the following attributes:
115
116
117
118
119 ┌─────────────────────────────┬─────────────────────────────┐
120 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
121 ├─────────────────────────────┼─────────────────────────────┤
122 │Availability │SUNWcsu │
123 └─────────────────────────────┴─────────────────────────────┘
124
126 sleep(1), attributes(5)
127
129 If message is coded more than once on a single line, it may appear that
130 only the right-most instance is interpreted and displayed. Use
131 sleep(1) between uses of message in this case, to display multiple mes‐
132 sages.
133
134
135 message -f should not be used in a stand-alone backquoted expression or
136 with the init descriptor because the frame is not yet current when
137 these are evaluated.
138
139
140 In cases where `message -f "string"` is part of a stand-alone back‐
141 quoted expression, the context for evaluation of the expression is the
142 previously current frame. The previously current frame can be the frame
143 that issued the open command for the frame containing the backquoted
144 expression, or it can be a frame given as an argument when fmli was
145 invoked. That is, the previously current frame is the one whose frame
146 message will be modified.
147
148
149 Permanent duration messages are displayed when the user navigates to
150 the command line.
151
152
153
154SunOS 5.11 5 Jul 1990 message(1F)