4.4.3. Facility Message (Q.931)

Use the gc_Extension( ) function in synchronous mode with an ext_ id (extension ID) of IPEXTID_SENDMSG to send facility (Q.931 Facility) messages. At the receiving end, a GCEV_EXTENSION event with the same ext_id value is generated. The metaevent associated with the GCEV_EXTENSION event will contain all of the data in the message.

The relevant parameter set IDs and parameter IDs are:

• IPSET_MSG_Q931
  • IPPARM_MSGTYPE - Set to IP_MSGTYPE_Q931_FACILITY.
• IPSET_NONSTANDARDDATA
  • IPPARM_NONSTANDARDDATA_OBJID - Object ID string.
  • IPPARM_NONSTANDARDDATA_DATA - Actual nonstandard data.

Notes:

1. The message type (IPPARM_MSGTYPE) is mandatory. At least one other information element must be included.
2. The gc_Extension( ) function must be called in synchronous mode, that is, the mode parameter must be set to EV_SYNC.

See Section 6.5, "IPSET_MSG_Q931 Parameter Set" and Section 6.6, "IPSET_NONSTANDARDDATA Parameter Set" for more information.

The following code shows how to set up and send a Q.931 facility message.

.
.
/* Q931 Facility Message */

rc = gc_util_insert_parm_val(&t_PrmBlkp, IPSET_MSG_Q931, IPPARM_MSGTYPE,
                             sizeof(int), IP_MSGTYPE_Q931_FACILITY);

rc = gc_util_insert_parm_ref(&t_PrmBlkp, IPSET_NONSTANDARDDATA,
                      IPPARM_NONSTANDARDDATA_OBJID, ObjLen+1, ObjId);

rc = gc_util_insert_parm_ref(&t_PrmBlkp, IPSET_NONSTANDARDDATA,
                      IPPARM_NONSTANDARDDATA_DATA, DataLen+1, data + ObjLen + 1);

if (rc == -1) {
    printf("Fail to insert parm");
    return -1;} 
else
    printf("Sending IP Q931 Facility Message");

gc_Extension(GCTGT_GCLIB_CRN, crn, IPEXTID_SENDMSG, t_PrmBlkp, &t_RetBlkp,
             EV_SYNC);
gc_util_delete_parm(t_PrmBlkp);
.
. 

Click here to contact Telecom Support Resources