User Manual

Boomer II User Manual & Integrator’s Guide
________________________________
____________
SDK – SCR API
BM210012WT09 75 Wavenet Technology
q scr_ACReasonText()
Prototype:
char *scr_ACReasonText(char *I_reason_code)
Description
For the DataTAC 5000 Network Only.
This routine converts a reason code from an Activity Confirmation
(AC) message into a text string describing that code. The returned
pointer is a pointer to a static text string within the library. This string
must not be overwritten or freed. This string pointer stays valid for the
duration of the program's execution. The text strings correspond to the
text given in the DataTAC 5000 System Host Application
Programmer's Manual.
Input:
Ø *l_reason code The reason code from the AC message
Output:
× Return !NULL Operation successful. Value a char pointer to a text string buffer
containing an English description for the meaning of the given
response code.
× Return NULL Operation failed.
Example
#i n c l ude <s c r a p i . h >
{
SCRMs g l ms g; / * SCR me s s a ge s t r u c t */
c ha r * l r e a s on; / * r e a s o n c od e s t r i ng * /
. . .
/ * r e c e i ve a me s s a g e a n d d e c ode i t i nt o l ms g * /
. . .
i f ( l ms g. ms g_ t yp e == SCR_ AC) {
l r e a s on = s c r _ACRe a s o n Te xt ( l ms g . u. a c . r e a s on _ c od e ) ;
i f ( l r e a s on ! = ( c h a r *) NULL) {
pr i nt f ( “ Ac t i v i t y Con f i r ma t i on LLI %0 8X -
r e a s on ' %s ' \ n ” , l ms g . u . a c . l l i , l r e a s on ) ;
}
}
}