High Level Messages
SwService
The Switching Service (SwService) is used to process Web Switching Sheets that are generated or updated by the services. It accepts the following High Level Messages:
Action any.SwService <command> <arguments>
 
Where:
Command
Arguments
Description
debug
<N>
Sets the debug level:
• 0 = Debug off
• 1 = Debug on
• 2 = Further details about database queries
• 3 = Full debug
relock [Sheet Handle]
 
When no argument is given, then unlock all the switching sheets and send a request to each of the clients asking them to reestablish their single user switching sheet locks. This command can be used to clear up any orphaned locks that may still be active after an application lost network connectivity or crashed.
 
When a switching sheet handle in the form of "<Sheet Cls>.<Sheet Idx>" is given, then only that one sheet is unlocked.
 
Web Switching and Web Safety
The Web Switching client application utilizes High Level Messages to receive broadcast messages. These messages are configured in the SwmanPerforms.inc file.
Web Safety messages are configured in the SafetyStartup.xml and SafetyTool.xml files. SafetyStartup.xml configuration is used by safety documents linked to switching sheets and for stand-alone safety documents; SafetyTool.xml is only used by safety documents linked to switching sheets.
The syntax for configuring HLM message receivers in the Web Switching and Web Safety tools should look like the following example.
<Perform name="HLM" category="onMessage"
type="HLM_SOME_SPECIAL_MESSAGE">
<Command value="SomeCommand"/>
</Perform>
 
From an external system or from the command line, the following action can be made to send the message out to every switching sheet or safety documented registered to listen for this message.
Action -java any.any HLM_SOME_SPECIAL_MESSAGE
 
To send the message to just the switching sheets, use the following command options.
Action -java any.swSheet HLM_SOME_SPECIAL_MESSAGE