User's Manual

Boomer II User Manual & Integrator’s Guide ______________________________________________ SDK SCRAPI
BM210012WT27 149 Wavenet Technology
 usVersion Set this value to zero to request the VDD DLL version or to any
other value to request the server application version
Output:
 Return value = 0 Operation was successful
 Return value ≠ 0 Operation failed. Value specifies the error type
 usVersion The upper 8 bits contain the major version and the lower 8 bits
contain the minor software version if the return value is zero
SCR Application Programmer’s Interface
The Standard Context Routing Application Programmer's Interface
(SCR API) is the server component of the SDK. The SCR API
provides routines for encoding and decoding SCR messages for
communication with the DataTAC
®
network switch or radio network
gateway (RNG). Decoded SCR messages are stored in structures
defined to represent SCR messages. Encoded messages are stored in
memory buffers.
To encode a message, an application will first set up a structure
representing the desired SCR message. This structure is then passed to
the encoding function, scr_Encode(), which encodes the message into a
memory buffer. The application can then send this encoded message to
the DataTAC network switch or RNG.
To decode an SCR message received from the network switch, the
application passes the received message buffer to the decode routine,
scr_Decode(), which decodes the message into a structure containing
the data from the message.
Routines are also provided to convert some of the message codes into
English language descriptions of the code.
The SCR API does not contain routines for reading the SCR messages
from the message switch interface or for sending encoded SCR
messages to the message switch. The connection to the message switch
is normally via an X.25 connection or a TCP/IP connection.
When you are using an X.25 connection to the network switch or RNG,
communication will be via an X.25 card. You will need to get an X.25
and appropriate drivers for this card. To develop your own application,
you will also need the developer's kit for your X.25 card. The sample
application has been written to use an EICON X.25 card. To run over
an X.25 connection, the sample application requires an EICON X.25
card, plus EICON WAN Services driver software. To modify and
compile the sample application, or to write your own application, you
will also need the EICON X.25 Development Tools for Win 32.
Contact EICON Technology (www.eicon.com) for more information
on these products.