$SirWarn: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (misc cleanup)
 
(21 intermediate revisions by 3 users not shown)
Line 2: Line 2:
<span class="pageSubtitle">Send warning or message to user(s)</span>
<span class="pageSubtitle">Send warning or message to user(s)</span>


<p class="warning">Most Sirius $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $SirWarn function, because it is very easy to do the same thing using a [[Daemon methods|Daemon]].</p>
<p class="warn"><b>Note: </b>Many $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $SirWarn function, because it is very easy to do the same thing using a [[Daemon class|Daemon]].</p>


The $SirWarn function is used to send a warning or message to the specified user or users. If the user invoking $SirWarn is a system manager or system administrator, $SirWarn acts like a WARN command; otherwise it acts like an MSG command.  
The <var>$SirWarn</var> function is used to send a warning or message to the specified user or users. If the user invoking <var>$SirWarn</var> is a system manager or system administrator, <var>$SirWarn</var> acts like a <var>WARN</var> command; otherwise it acts like an <var>MSG</var> command.  


<var>$SirWarn</var> accepts two arguments and returns a number.
==Syntax==
<p class="syntax"><span class="term">%rc</span> = $SirWarn (<span class="term">user</span>, <span class="term">message</span>)
</p>


The first argument identifies the user(s) to receive the warning. If this argument is the string <tt>OPR</tt>, the warning is sent to the operator's console (or virtual console under CMS). If this argument is a valid user number, the warning is sent to the indicated user number. If the first argument is neither <tt>OPR</tt> nor a valid user number, it is treated as a userid, and the warning is sent to every user logged on to this userid.
===Syntax terms===
<table>
<tr><th>%rc</th>
<td>A numeric variable that is set to indicate the success of the function.</td></tr>


The second argument is the text of the warning to be sent to the user(s) indicated by the first argument.
<tr><th>user</th>
<td>Identifies the user(s) to receive the warning.
<p>
If this argument is the string <code>OPR</code>, the warning is sent to the operator's console (or virtual console under CMS). If this argument is a valid user number, the warning is sent to the indicated user number. If it is neither <code>OPR</code> nor a valid user number, it is treated as a userid, and the warning is sent to every user logged on to this userid. </p></td></tr>


==Syntax==
<tr><th>message</th>
<p class="syntax"><section begin="syntax" />%rc = $SirWarn (user, message)
<td>The text of the warning to be sent to the user(s) indicated by the <var class="term">user</var> argument.</td></tr>
<section end="syntax" /></p>
</table>
<p class="caption">$SirWarn Function
</p>
<p class="caption">%RC is set to indicate the success of the function.</p>


<p class="code">  
===Return codes===
0 - Warning issued
<p class="code">0 - Warning issued
1 - User(s) not logged on
1 - User(s) not logged on
2 - Insufficient storage
2 - Insufficient storage
3 - Parameter missing (either userid or message)
3 - Parameter missing (either userid or message)
</p>
<p class="caption">$SirWarn return codes
</p>
</p>


The following statement sends a warning of an application error to the operator:
==Examples==
 
<ol>
<p class="code"> %RC = $SirWarn('OPR', -
<li>The following statement sends a warning of an application error to the operator:
'Severe application error for user' WITH $USER)
<p class="code">%rc = $SirWarn('OPR', 'Severe application error for user' WITH $USER)
</p>
</p>


This statement sends a warning to user 57 to leave subsystem BARNEY:
<li>This statement sends a warning to user 57 to leave subsystem <code>BARNEY</code>:


<p class="code"> %RC = $SirWarn(57, 'Please leave subsystem BARNEY')
<p class="code">%rc = $SirWarn(57, 'Please leave subsystem BARNEY')
</p>
</p>


This statement sends a warning to all users logged on as HOMER to call Marge:
<li>This statement sends a warning to all users logged on as <code>HOMER</code> to call <code>Marge</code>:
 
<p class="code">%rc = $SirWarn('HOMER', 'Please call Marge')
<p class="code"> %RC = $SirWarn('HOMER', 'Please call Marge')
</p>
</p>
</ol>


==Products authorizing {{PAGENAMEE}}==
<ul class="smallAndTightList">
<ul class="smallAndTightList">
<li>[[Sirius functions]]
<li>[[List of $functions|Sirius functions]]
</ul>
</ul>
<p class="caption">Products authorizing $SirWarn
</p>


[[Category:$Functions|$SirWarn]]
[[Category:$Functions|$SirWarn]]

Latest revision as of 00:04, 7 October 2015

Send warning or message to user(s)

Note: Many $functions have been deprecated in favor of Object Oriented methods. There is no OO equivalent for the $SirWarn function, because it is very easy to do the same thing using a Daemon.

The $SirWarn function is used to send a warning or message to the specified user or users. If the user invoking $SirWarn is a system manager or system administrator, $SirWarn acts like a WARN command; otherwise it acts like an MSG command.

Syntax

%rc = $SirWarn (user, message)

Syntax terms

%rc A numeric variable that is set to indicate the success of the function.
user Identifies the user(s) to receive the warning.

If this argument is the string OPR, the warning is sent to the operator's console (or virtual console under CMS). If this argument is a valid user number, the warning is sent to the indicated user number. If it is neither OPR nor a valid user number, it is treated as a userid, and the warning is sent to every user logged on to this userid.

message The text of the warning to be sent to the user(s) indicated by the user argument.

Return codes

0 - Warning issued 1 - User(s) not logged on 2 - Insufficient storage 3 - Parameter missing (either userid or message)

Examples

  1. The following statement sends a warning of an application error to the operator:

    %rc = $SirWarn('OPR', 'Severe application error for user' WITH $USER)

  2. This statement sends a warning to user 57 to leave subsystem BARNEY:

    %rc = $SirWarn(57, 'Please leave subsystem BARNEY')

  3. This statement sends a warning to all users logged on as HOMER to call Marge:

    %rc = $SirWarn('HOMER', 'Please call Marge')

Products authorizing $SirWarn