message(1f) - osol9

1message(1F)                      FMLI Commands                     message(1F)
2
3
4

NAME

6       message - puts its arguments on FMLI message line
7

SYNOPSIS

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

DESCRIPTION

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

OPTIONS

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

EXAMPLES

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

ATTRIBUTES

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

NOTES

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)