$Web Num LogMsg: Difference between revisions
m (1 revision) |
m (→Syntax) |
||
| Line 12: | Line 12: | ||
<var>$Web_Num_LogMsg</var> takes no arguments and returns a number. | <var>$Web_Num_LogMsg</var> takes no arguments and returns a number. | ||
If the port definition contains a LOGMSGI parameter | If the port definition contains a <var>[[LOGMSGI parameter|LOGMSGI]]</var> parameter, <var>$Web_Num_LogMsg</var> will always return a 0, otherwise it will return the number of messages issued to the <var class="product">[[Janus Web Server]]</var> thread's "terminal" at logon time. <var>$Web_Num_LogMsg</var> and <var>$Web_LogMsg</var> are probably most useful in a <code>JANUS WEB ON LOGONERR</code> routine but can be used in any <var>JANUS WEB ON</var> routine. | ||
<p class="code"> FOR %I FROM 1 TO $Web_Num_LogMsg | <p class="code">FOR %I FROM 1 TO $Web_Num_LogMsg | ||
%MSG = $Web_LogMsg(%I) | |||
IF $SUBSTR(%MSG, 1, 10) EQ 'M204.1500:' THEN | |||
JUMP TO GOTACF2MSG | |||
END IF | |||
END FOR | |||
</p> | </p> | ||
==Example== | |||
This is an example of how <var>$Web_Num_LogMsg</var> can be used to scan logon messages looking for an ACF2 message that perhaps indicates the reason for a logon failure. Depending on the reason (incorrect password, expired password, suspended account), appropriate action can be taken. | |||
==See also== | |||
<ul> | |||
<li><var>[[$Web_LogMsg]]</var> | |||
</ul> | |||
[[Category:Janus Web Server $functions|$Web_Num_LogMsg]] | [[Category:Janus Web Server $functions|$Web_Num_LogMsg]] | ||
Revision as of 22:52, 24 October 2012
<section begin="desc" />Number of saved logon messages<section end="desc" />
$Web_Num_LogMsg retrieves the number of saved logon messages.
Syntax
<section begin="syntax" />%count = $Web_Num_LogMsg <section end="syntax" />
$Web_Num_LogMsg takes no arguments and returns a number.
If the port definition contains a LOGMSGI parameter, $Web_Num_LogMsg will always return a 0, otherwise it will return the number of messages issued to the Janus Web Server thread's "terminal" at logon time. $Web_Num_LogMsg and $Web_LogMsg are probably most useful in a JANUS WEB ON LOGONERR routine but can be used in any JANUS WEB ON routine.
FOR %I FROM 1 TO $Web_Num_LogMsg %MSG = $Web_LogMsg(%I) IF $SUBSTR(%MSG, 1, 10) EQ 'M204.1500:' THEN JUMP TO GOTACF2MSG END IF END FOR
Example
This is an example of how $Web_Num_LogMsg can be used to scan logon messages looking for an ACF2 message that perhaps indicates the reason for a logon failure. Depending on the reason (incorrect password, expired password, suspended account), appropriate action can be taken.