IIS Debugging Notes

To enable debugging and clear all IDs and IP restrictions that may have been previously set for the current session, specify {{ Debug(OFF,ON) }}.

When a service is started and the debugging is enabled, the debugger will start running on the host machine's console. For this reason, it is desirable to restrict debugging to local host.

The Debug tag is always removed from the rendered page. If this is the last tag on the line, a newline is output unless this tag is immediately followed by a comment tag. See the Notes section of Comment Tags.

The Debug tag is ignored unless debugging is enabled in the BIS web server's configuration.

Tip: To configure debugging for all pages, place the list of authorized users and IPs into the web.config file and add this tag to all of your .srf files:

{{ Debug( ON,ID={%DEBUG_USERS, CONFIG%},IP={%DEBUG_IPS,CONFIG%} ) }}
{{ StartService( MAINPROGRAM ) }}
{{ Debug( OFF ) }}

Then, create or edit the web.config file in the directory containing the .srf file (or any parent) and add the variables below:

<app.config>
   <configuration>
        ...
      <configSections>
         <sectionGroup name="BIS">
            <sectionGroup name="Config">
               <section name="Variables" 
    type="System.Configuration.NameValueSectionHandler,System"/>
            </sectionGroup>
         </sectionGroup>
      </configSections>
        ...
      <BIS>
         <PreRender>
               <add tag=”Debug(ON,ID=Users,IP=ANY” />
         </PreRender>
         <Config>
            <Variables>
               <add key="DEBUG_USERS" value="[spaced-list]"/>
               <add key="DEBUG_IPS" value="[spaced-list]"/>
                 ...
            </Variables>
         </Config>
      </BIS>
        ...
   </configuration>
</app.config>

Debug tags are processed in the order that they are encountered during rendering. This means that, in this example:

{{ Debug( ON, IP=127.0.0.1 ) }}
{{ Debug( OFF ) }}
{{ StartService( MAINPROGRAM ) }}

Debugging of MAINPROGRAM will be disabled. However, in this case:

{{ Debug( ON, IP=127.0.0.1 ) }}
{{ StartService( MAINPROGRAM ) }}
{{ Debug( OFF ) }}

Debugging of MAINPROGRAM will be. Subsequent programs will not be debugged unless an intervening {{ Debug(ON) }} is rendered and a new ID and optional IP restriction is set.