The following byte ordering conventions are for 16-bit and 32-bit parameters in the messages to and from the monitor task. The host application is responsible for converting between network and host byte order, if necessary, in both the send and receive directions.
Note: The byte ordering convention used with NA SS7 Monitor Software is not the same convention used for short and long integers on Intel 80x86 machines.
The CPI library provides the following macros that enable applications to transparently handle host and TX board numeric representation issues:
Macro |
Task |
cpi htocp l |
Converts 32-bit value from the host format to the board format. |
cpi htocp s |
Converts 16-bit value from the host format to the board format. |
cpi cptoh l |
Converts 32-bit value from the board format to the host format. |
cpi cptoh s |
Converts 16-bit value from the board format to the host format. |
The Message Length field is part of the dual-ported RAM (DPR) header interface between the host application and the host device driver, and must be passed in host native byte order, not the byte order shown in this topic. The Message Start and End offsets, on the other hand, are part of the interface between the host application and the NA SS7 Monitor Software process and must be passed in the network byte order shown in the following example:
The following nomenclature is used for data types:
Data type |
Description |
U8 |
Unsigned 8-bit quantity |
S16 |
Signed 16-bit quantity |
U32 |
Unsigned 32-bit quantity |