Panamax VT1512-IP Manual - Page 5

1.Command Messages Command messages are sent to the VT1512-IP in order to have it perform a task. The task can be to perform a physical action, such as switching an outlet (referred to as an "action"). When the task is to transmit data, such as device status, it is referred to as a "query". Whether the task is an "action" or "query", the message is classified as a command and is contained within the element. Example Action Command Message - switch outlet 2 to OFF: 0 2.Response Messages In response to a query command, the VT1512-IP will send a reply message. The contents part of the message will be a set of elements enclosed in either the , or element, depending on the query. Example Response Message- response to "sendinfo" query command: This would be considered the "envelope" for all messages, where the "..." is to be considered the "contents" of the message. Since all messages include the "envelope", message details will only document the "contents". Message Types There are three types of messages: command messages, response messages and event messages. 0 By default, the VT1512-IP does not respond to action command messages. Example Query Command Message - send information Response PAVT1512PRO0X142160000000 1.0.0.12520 1.0 3194548209 1.0.0.12520 1300795003 5 42 65272 Response messages can be used to verify command message delivery. If a verifiable response message is desired from the VT1512-IP, the optional "xid" attribute is included in the element. All command messages with the "xid" attribute expressed will return a response message with the same "xid" attribute value enclosed in an element. This "xid" value can then be used to match responses to their corollary commands. Example 1: Action Command Message with xid - 0 Response Message with ack - www.panamax.com 5