Epicenter Server Commands - Extreme Networks EPICenter Software Installation Manual

EPICenter External Access Protocol
5 The external application sends a "dbquery" command request and arguments to the EPICenter
server.
6 The EPICenter server sends a response back to the external application.
7 Step 4 through 5 may be repeated as many times as needed.
8 The external application sends a "logout" command request to the EPICenter server.
9 The EPICenter server closes the TCP connection with the external application.
The EPICenter server accepts a maximum of 5 simultaneous external connections. The next section
describes the set of commands understood by the EPICenter server.

EPICenter Server Commands

Login Command
The external application should send the following data to login:
<command><param>login</param><param>name</param><param>password</param></command>
and should be substituted by the external application.
name password
If the login is successful, the server sends:
<H2>REQUEST COMPLETE, welcome to the EPICENTER server</H2>
If the login failed, the server sends:
<H2>ERROR, Invalid login, try again.</H2>
The external application should check the result code in the message to determine the success or failure
of the login. "REQUEST COMPLETE" is login successful, "ERROR" is login failed.
Dbquery Command
The external application may send the following to issue a dbquery command:
<command><param>dbquery</param><param>sql</param>[<param>variable
1</param>...]</command>
is a SQL SELECT statement that may contain ? characters for variable substitution. For each ? in the
sql
SQL statement, there must be a corresponding
be placed in the location of the ? character when the server process the SELECT statement. For example:
<command><param>dbquery</param><param>select * from Employee where name =
'Bob'</param></command>
<command><param>dbquery</param><param>select * from Employee where name = ?
</param<PARAM>Bob</PARAM></command>
Both query command produces the same result. But the second form of the SQL query using the ?
substitution allows the external application to specify values without using any special quoting.
For example, given the following SQL query:
select * from Store where name = 'Al's Brewery'
496
<PARAM> variable </PARAM>
where the will
variable
EPICenter Software Installation and User Guide