The zlogcoverage statement allows instrumentation coverage to be turned on or off within a procedure.
Parameters
This statement has one parameter:
mode – instrumentation coverage mode, may be “always”, “never” or “normal” (empty text is treated as “normal”).
Description
This statement allows instrumentation coverage to be turned on or off within a procedure. Usually coverage is enabled or disabled in the Instrumentation panel (see Debug Instrumentation), but this statement allows this to be done in the program itself.
zlog "This will appear if coverage is enabled in Instrumentation panel."
zlogcoverage "always"
zlog "This will always appear."
zlogcoverage "never"
zlog "This will never appear."
zlogcoverage "normal"
zlog "Again, this will appear if coverage for this procedure is enabled in Instrumentation panel."
Note that coverage is only enabled for this exact procedure, not for any subroutines called by this procedure.
One application for this statement is to enable log coverage for a web publishing procedure, where it might be inconvenient to use the Instrumentation panel to enable log coverage on the server. Instead you can use the zlogcoverage statement to enable coverage, uploading the procedure with this statement included. (Of course you’ll still need to access the server computer to view the log.) When you are done, remove the zlogcoverage statement, or change the statement to zlogcoverage "normal"
, and upload to the server again.
See Also
History
Version | Status | Notes |
10.2 | New | New in this version. |