User's Manual

SDK SCR-API ______________________________________________ Boomer II User Manual & Integrator’s Guide
Wavenet Technology 162 BM210012WT27

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
#include <scrapi.h>
{
SCRMsg lmsg; /* SCR message struct */
char *lreason; /* reason code string */
. . .
/* receive a message and decode it into lmsg */
. . .
if (lmsg.msg_type == SCR_AC) {
lreason = scr_ACReasonText(lmsg.u.ac.reason_code);
if (lreason != (char *)NULL) {
printf(“Activity Confirmation LLI %08X -
reason '%s'\n”, lmsg.u.ac.lli, lreason);
}
}
}

scr_DIReasonText()
Prototype:
char *scr_DIReasonText(char *l_reason_code)
Description