halt (with numeric-expression)? halt-everything (with numeric-expression)?
halt action terminates an OmniMark program. No further OmniMark rules or actions are
performed. Processing of all output files is completed, including processing of referents. Any
referent resolution errors that occur will be reported.
halt will run
always clauses in
all active scopes.
If you need to halt the OmniMark program without trying to finish writing to files or resolving
halt-everything terminates the
program in the same manner as
halt, except that referents are not resolved and no errors indicating
unresolved referents are issued. No user code is run at all.
The following fragment ends the program if more than 50 SGML errors occur and returns the number of SGML
errors encountered to the operating system:
markup-error do when #markup-error-count > 50 put #error "Terminating because more than 50 SGML errors occurred%n" halt with #markup-error-count done
halt-everything is an extreme action intended to shut down the OmniMark process immediately. It
relies on the operating system to perform any cleanup required. In situations where OmniMark is running in a
thread (as it does in a WSB service, or a Java or ActiveX component), the resources allocated by the thread may
not be freed until the calling program exits.
halt-everything should be avoided in these situations.