NOAUTODONE (JANUS DEFINE parameter): Difference between revisions
m (1 revision) |
mNo edit summary |
||
| Line 1: | Line 1: | ||
<span class="pageSubtitle"><section begin="desc" />Prevent automatic $Web_Done.<section end="desc" /></span> | <span class="pageSubtitle"><section begin="desc" />Prevent automatic $Web_Done.<section end="desc" /></span> | ||
<var>NOAUTODONE</var> is a parameter on <var>[[JANUS DEFINE]]</var>, which defines and sets characteristics of a Janus port. | <var>NOAUTODONE</var> is a parameter on <var>[[JANUS DEFINE]]</var>, which defines and sets characteristics of a Janus port. | ||
This parameter prevents | This parameter prevents <var class="product">[[Janus Web Server]]</var> from treating a return to command mode after all port and ON rules <var>[[CMD (JANUS DEFINE parameter)|CMD]]</var>s have been processed as an implicit <var>[[$Web_Done]]</var>. | ||
While for simple demo applications such as one that simply returns the results of a ''Model 204'' VIEW command, it is convenient to treat the return to command mode as an implicit | While for simple demo applications such as one that simply returns the results of a ''Model 204'' VIEW command, it is convenient to treat the return to command mode as an implicit <var>$Web_Done</var>, it makes error detection for more complex applications difficult. Many application problems from subsystems not being started to coding errors that cause premature exit from a procedure to invalid included procedure name to a user not being authorized to run a subsystem would cause raw ''Model 204'' error messages or, in certain cases, partial HTML pages to be returned to an end-user. By specifying <var>NOAUTODONE</var> on the port definition, these errors can be caught and a "neater" error page can be sent to the user. This "neater" error page could be either the standard "No $WEB_DONE" page sent by <var class="product">Janus Web Server</var> or it could be one produced by a <code>JANUS WEB ON NODONE</code> rule. | ||
The default setting for <var>[[AUTODONE (JANUS DEFINE parameter)|AUTODONE]]</var>/<var>NOAUTODONE</var> is <var>AUTODONE</var>. | The default setting for <var>[[AUTODONE (JANUS DEFINE parameter)|AUTODONE]]</var>/<var>NOAUTODONE</var> is <var>AUTODONE</var>. | ||
The setting of <var>NOAUTODONE</var> (or <var>AUTODONE</var>) applies to all URLs on the port unless explicitly overridden by an <var>AUTODONE</var> (or <var>NOAUTODONE</var>) parameter on a JANUS WEB ON rule. The recommended setting for this parameter is <var>NOAUTODONE</var> with <var>AUTODONE</var> added to any JANUS WEB ON rule where the implicit | The setting of <var>NOAUTODONE</var> (or <var>AUTODONE</var>) applies to all URLs on the port unless explicitly overridden by an <var>AUTODONE</var> (or <var>NOAUTODONE</var>) parameter on a <var>[[JANUS WEB ON]]</var> rule. The recommended setting for this parameter is <var>NOAUTODONE</var> with <var>AUTODONE</var> added to any <var>JANUS WEB ON</var> rule where the implicit <var>$Web_Done</var> is really required. | ||
Valid only for <var>[[JANUS DEFINE#type|WEBSERV]]</var> ports. | Valid only for <var>[[JANUS DEFINE#type|WEBSERV]]</var> ports. | ||
Revision as of 18:05, 1 March 2012
<section begin="desc" />Prevent automatic $Web_Done.<section end="desc" />
NOAUTODONE is a parameter on JANUS DEFINE, which defines and sets characteristics of a Janus port.
This parameter prevents Janus Web Server from treating a return to command mode after all port and ON rules CMDs have been processed as an implicit $Web_Done.
While for simple demo applications such as one that simply returns the results of a Model 204 VIEW command, it is convenient to treat the return to command mode as an implicit $Web_Done, it makes error detection for more complex applications difficult. Many application problems from subsystems not being started to coding errors that cause premature exit from a procedure to invalid included procedure name to a user not being authorized to run a subsystem would cause raw Model 204 error messages or, in certain cases, partial HTML pages to be returned to an end-user. By specifying NOAUTODONE on the port definition, these errors can be caught and a "neater" error page can be sent to the user. This "neater" error page could be either the standard "No $WEB_DONE" page sent by Janus Web Server or it could be one produced by a JANUS WEB ON NODONE rule.
The default setting for AUTODONE/NOAUTODONE is AUTODONE.
The setting of NOAUTODONE (or AUTODONE) applies to all URLs on the port unless explicitly overridden by an AUTODONE (or NOAUTODONE) parameter on a JANUS WEB ON rule. The recommended setting for this parameter is NOAUTODONE with AUTODONE added to any JANUS WEB ON rule where the implicit $Web_Done is really required.
Valid only for WEBSERV ports.