View source for $SirWarn

{{DISPLAYTITLE:$SirWarn}}
<span class="pageSubtitle"><section begin="desc" />Send warning or message to user(s)<section end="desc" /></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>

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. 

$SirWarn accepts two arguments and returns a number. 

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. 

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

==Syntax==
<p class="syntax"><section begin="syntax" /> %RC = $SirWarn (user, message)
<section end="syntax" /></p>
<p class="caption">$SirWarn Function
</p>
<p class="caption">%RC is set to indicate the success of the function.</p>

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

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

<p class="code"> %RC = $SirWarn('OPR', -
 'Severe application error for user' WITH $USER)
</p>

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

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

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

<p class="code"> %RC = $SirWarn('HOMER', 'Please call Marge')
</p>

<ul class="smallAndTightList">
<li>[[Sirius functions]]
</ul>
<p class="caption">Products authorizing $SirWarn
</p>


[[Category:$Functions|$SirWarn]]