Events

This topic specifies the layout of the following events that are passed between the application and the ISUP layer implementation:

Connect

The ISUP Connect event structure is populated by the application when a circuit switch connection is requested. Information elements specific to the Japan/NTT variant are in bold.

typedef struct _siConEvnt      /* ISUP Connect Event                    */
{
    SiNatConInd      natConInd;      /* Nature of connection indicators       */
    SiFwdCallInd     fwdCallInd;     /* forward call indicators               */
    SiCgPtyCat       cgPtyCat;       /* calling party category                */
    SiTxMedReq       txMedReq;       /* transmission medium requirement       */
    SiTxMedReq       txMedReqPr;     /* transmission medium requirement prime */
    SiCdPtyNum       cdPtyNum;       /* called party number                   */
    SiTranNetSel     tranNetSel;     /* transit network selection             */
    SiCallRef        callRef;        /* call reference                        */
    SiCgPtyNum       cgPtyNum;       /* calling party number                  */
    SiOpFwdCalInd    opFwdCalInd;    /* optional forward call indicators      */
    SiRedirNum       redirgNum;      /* redirection number                    */
    SiRedirInfo      redirInfo;      /* redirection information               */
    SiCugIntCode     cugIntCode;     /* closed grp interlock code             */
    SiConnReq        connReq;        /* connection request                    */
    SiOrigCdNum      origCdNum;      /* original called number                */
    SiUsr2UsrInfo    usr2UsrInfo;    /* user to user information              */
    SiAccTrnspt      accTrnspt;      /* access transport                      */
    SiAppTransParam  appTransParam;  /* application transport as per          */
                                     /*   BICC req: Q.1902.3                  */
    SiChargeNum      chargeNum;      /* connected number                      */
    SiOrigLineInf    origLineInf;    /* originating line info                 */
    SiUsrServInfo    usrServInfo;    /* user service information              */
    SiUsr2UsrInd     usr2UsrInd;     /* user to user indicators               */
    SiPropDly        propDly;        /* propagation delay counter             */
    SiUsrServInfo    usrServInfo1;   /* user service info prime               */
    SiNetSpecFacil   netFac;         /* network specific facility             */
    SiSigPointCode   orgPteCde;      /* originating ISC pnt code              */
    SiGenDigits      genDigits;      /* generic digits                        */
    SiGenNum         genNmb;         /* generic number                        */
    SiRemotOper      remotOper;      /* remote operations                     */
    SiParmCompInfo   parmCom;        /* parameter compatibility information   */
    SiNotifInd       notifInd;       /* notification indicator                */
    SiInfoInd        infoInd;        /* information indicator                 */
    SiServiceAct     serviceAct;     /* service activation                    */
    SiMlppPrec       mlppPrec;       /* MLPP precedence                       */
    SiTxMedReq       txMedUsed;      /* transmission medium used              */
    SiBckCalInd      bckCallInd;     /* backward call indicators              */
    SiOptBckCalInd   optBckCalInd;   /* optional backward call indicators     */
    SiConnectedNum   connNum;        /* connected number                      */
    SiAccDelInfo     accDelInfo;     /* access delivery info                  */
    SiPropDly        cllHstry;       /* call history information              */
    SiRedirNum       redirNum;       /* redirection number                    */
    SiRedirRestr     redirRstr;      /* redirection restriction               */
    SiBusinessGrp    businessGrp;    /* business group                        */
    SiCarrierId      carrierId;      /* carrier identification                */
    SiCarrierSelInf  carSelInf;      /* carrier selection info                */

    SiEgress         egress;         /* egress service                        */
    SiGenAddr        genAddr;        /* generic address                       */
    SiInfoReqInd     infoReqInd;     /* info request indicators               */
    SiJurisInf       jurisInf;       /* jurisdiction information              */
    SiNetTransport   netTransport;
                                     /* network transport                     */
    SiSpecProcReq    specProcReq;    /* special processing req.               */
    SiTransReq       transReq;       /* transaction request                   */
    SiEchoCtl        echoControl;    /* echo control                          */
    SiCirAssignMap   cirAssignMap;
                                     /* circuit assignment map                */
    SiGenName        genName;        /* generic name                          */
    SiHopCount       hopCount;       /* hop counter                           */
    SiOpServInfo     opServInfo;     /* operator services information         */
    SiServiceCode    serviceCode;    /* service code                          */
    SiLocNum         locNum;         /* location number                       */
    SiMsgAreaInfo    msgAreaInfo;    /* message area information              */
    SiContractorNum  contractorNum;  /* contractor number                     */
    SiCgNumNonNotRsn cgNumNonNotRsn;
                                     /* calling number non-notification reason*/
    SiAddUsrId       addUsrId;       /* additional user identification        */
    SiCarrierInfoTrans carrierInfoTrans;
                                     /* carrier information transfer          */

    SiCCSS           cCSS;
    SiNetMngmtCtrls  netMngmtCtrls;
    SiCirAssMap      cirAssMap;
    SiCallDivTrtmnt  callDivTrtmnt;
    SiCdINNum        cdINNum;
    SiCallOffTrtmnt  callOffTrtmnt;
    SiConfTrtmnt     confTrtmnt;
    SiUIDCapInd      uIDCapInd;
    SiCollCallReq    collCallReq;
    SiBckGVNS        bckGVNS;
    SiFreePhnInd     freePhone;
    SiScfID          scfID;
    SiCorrelationID  corrId;
    SiElementExt     elementExt[NUM_EXT_ELMTS];
} SiConEvnt;

Connect Status

The Connect Status event structure is filled by the application to signal connection status information to the far exchange while the connection is established. Connection status information includes address complete, progress, information request, and general information. Information elements specific to the Japan/NTT variant are in bold.

typedef struct _siCnStEvnt       /* Connect Status Event                */
{
    SiSubNum         subNum;         /* subsequent number                   */
    SiBckCalInd      bckCallInd;     /* backward call indicators            */
    SiChargeNum      chargeNum;      /* connected number                    */
    SiOptBckCalInd   optBckCalInd;   /* optional backward call indicators   */
    SiCauseDgn       causeDgn;       /* cause indicators                    */
    SiConnectedNum   connNum;        /* connected number                    */
    SiUsr2UsrInd     usr2UsrInd;     /* user to user indicators             */
    SiUsr2UsrInfo    usr2UsrInfo;    /* user to user information            */
    SiRedirInfo      redirInfo;      /* redirection information             */
    SiAccTrnspt      accTrnspt;      /* access transport                    */
    SiAppTransParam  appTransParam;  /* application transport as per        */
                                     /*   BICC req: Q.1902.3                */
    SiCalModInd      calModInd;      /* call modification indicators        */
    SiEvntInfo       evntInfo;       /* event information                   */
    SiRedirNum       redirNum;       /* redirection number                  */
    SiInfoInd        infoInd;        /* info indicators                     */
    SiInfoReqInd     infoReqInd;     /* info request indicator              */
    SiRedirNum       redirgNum;      /* redirecting number                  */
    SiCgPtyCat       cgPtyCat;       /* calling party category              */
    SiCgPtyNum       cgPtyNum;       /* calling party number                */
    SiIndex          index;          /* index                               */
    SiConnReq        connReq;        /* connection request                  */
    SiCallRef        callRef;        /* call reference                      */
    SiNotifInd       notifInd;       /* notification indicator              */
    SiTxMedReq       txMedUsed;      /* transmission medium used            */
    SiEchoCtl        echoControl;    /* echo control                        */
    SiAccDelInfo     accDelInfo;     /* access delivery information         */
    SiGenNum         genNmb;         /* generic number                      */
    SiGenDigits      genDigits;      /* generic digits                      */
    SiParmCompInfo   parmCom;        /* parameter compatibility information */
    SiCllDiverInfo   cllDivr;        /* call Diversion information          */
    SiNetSpecFacil   netFac;         /* network specific facility           */
    SiRemotOper      remotOper;      /* remote operations                   */
    SiServiceAct     serviceAct;     /* service activation                  */
    SiRedirRestr     redirRstr;      /* redirect restriction                */
    SiMcidReqInd     mcidReq;        /* MCID request indicators             */
    SiMcidRspInd     mcidRsp;        /* MCID response indicators            */
    SiMsgCompInfo    msgCom;         /* msg compatibility information       */
    SiOrigLineInf    origLineInf;    /* originating line information        */
    SiBusinessGrp    businessGrp;    /* business group                      */
    SiNetTransport   netTransport;   /* network transport                   */
    SiMsgAreaInfo    msgAreaInfo;    /* message area information            */
    SiChargeInfo     chargeInfo;     /* charge information                  */
    SiChargeInfoType chargeInfoType; /* charge information type             */
    SiChargeInfoDly chargeInfoDly;   /* charge information delay            */
    SiCarrierInfoTrans carrierInfoTrans; /* carrier information transfer     */

    SiConfTrtmnt   confTrtmnt;
    SiUIDActionInd uIDActionInd;
    SiCallXferNum  callXferNum;
    SiBckGVNS      bckGVNS;
    SiCCNR         cCNR;
    SiElementExt   elementExt[NUM_EXT_ELMTS];
} SiCnStEvnt;

Information

The Information event structure is populated while sending user-to-user information associated with an established connection to the far party.

 typedef struct _siInfoEvnt      /* Information Event        */
{
    SiCallRef     callRef;       /* call reference           */
    SiPassAlng    passAlng;      /* pass along               */
    SiUsr2UsrInfo usr2UsrInfo;   /* user to user information */
    SiAccTrnspt   accTrnspt;     /* access transport         */
    SiElementExt  elementExt[NUM_EXT_ELMTS];
} SiInfoEvnt;

Resume

The Resume event structure indicates that a suspended connection has resumed and sends a RESUME message to the far exchange.

typedef struct _siResmEvnt     /* resume event              */
{
    SiSusResInd  susResInd;    /* Suspend/Resume indicators */
    SiCallRef    callRef;      /* call reference            */
    SiElementExt elementExt[NUM_EXT_ELMTS];
} SiResmEvnt;

Status

The Status event structure is populated while a global or circuit specific status message is sent to the far exchange.

typedef struct _siStaEvnt         /* Status Event */
{
    iRangStat            rangStat;        /* range and status                        */
    iCirGrpSupMTypInd    cgsmti;          /* circuit grp. supervision msg. type ind. */
    SiCirStateInd        cirStateInd;     /* circuit state indicators                */
    SiContInd            contInd;         /* continuity indicator                    */
    SiCauseDgn           causeDgn;        /* cause indicators                        */
    SiParmCompInfo       parmCom;         /* parameter compatibility information     */
    SiNatConInd          natConInd;       /* Nature of connection indicators         */
    SiCirAssignMap       cirAssignMap;    /* circuit assignment map                  */
    SiMsgCompInfo        msgCom;          /* message compatibility information       */
    SiAppTransParam      appTransParam;   /* application transport as per            */
                                          /*  BICC req: Q.1902.3                     */
    SiOptBckCalInd       optBckCalInd;    /* optional backward call indicators       */
    SiOpFwdCalInd        opFwdCalInd;     /* optional forward call indicators        */
    SiCallXferRef        callXferRef;
    SiLoopPrevInd        loopPrevInd;
    SiElementExt         elementExt[NUM_EXT_ELMTS];  /* extended elements */
} SiStaEvnt;

Release

The Release event structure is populated while a circuit switched connection is released. The associated event generates a RELEASE message to the far exchange.

typedef struct _siRelEvnt        /* Release Event                       */
{
    SiCauseDgn     causeDgn;     /* cause indicators                    */
    SiRedirInfo    redirInfo;    /* redirection information             */
    SiRedirNum     redirNum;     /* redirection number                  */
    SiRedirgNum    redirgNum;    /* redirection number                  */
    SiCallRef      callRef;      /* call reference                      */
    SiCugIntCodeA  cugIntCodeA;  /* closed group interlock code         */
    SiSigPointCode sigPointCode; /* signalling point code               */
    SiAccTrnspt    accTrnspt;    /* access transport                    */
    SiUsr2UsrInfo  usr2UsrInfo;  /* user to user information            */
    SiAutoCongLvl  autoCongLvl;  /* auto congestion level               */
    SiAccDelInfo   accDelInfo;   /* access delivery information         */
    SiParmCompInfo parmCom;      /* parameter compatibility information */
    SiNetSpecFacil netFac;       /* network specific facility           */
    SiRedirRestr   redirRstr;    /* redirection restriction             */
    SiUsr2UsrInd   usr2UsrInd;   /* user to user indicators             */
    SiChargeNum    chargeNum;    /* charge number                       */
    SiGenAddr      genAddr;      /* generic address                     */
    SiServiceAct   serviceAct;   /* service activation                  */
    SiElementExt   elementExt[NUM_EXT_ELMTS];
} SiRelEvnt;

Suspend

The Suspend event structure sends a suspend request to the far exchange and the associated API call starts timer T2. If no resume or release is received before timer T2 expires, the circuit is released. A release indication is sent to the application and an REL message is sent to the far exchange.

typedef struct _siSuspEvnt     /* suspend event             */
{
    SiSusResInd  susResInd;    /* suspend/resume indicators */
    SiCallRef    callRef;      /* call reference            */
    SiElementExt elementExt[NUM_EXT_ELMTS];
} SiSuspEvnt;

Facility

The Facility event structure is populated while a facility request is sent to the far exchange.

typedef struct _siFacEvnt      /* facility event                 */
{
    SiFacInd       facInd;     /* facility indicator             */
    SiFacInfInd    facInfInd;  /* facility information indicator */
    SiCdPtyNum     cdPtyNum;   /* called party number            */
    SiCgPtyNum     cgPtyNum;   /* calling party number           */
    SiCallRef      callRef;    /* call reference                 */
    SiUsr2UsrInd   usr2UsrInd; /* user to user indicator         */
    SiCallRef      callRef;    /* call reference                 */
    SiCauseDgn     causeDgn;   /* cause indicator                */
    SiMsgCompInfo  msgCom;     /* msg compatibility info         */
    SiParmCompInfo parmCom;    /* param compatibility info       */
    SiRemotOper    remotOper;  /* remote operations              */
    SiServiceAct   serviceAct; /* service activation             */
    SiCallXferNum  callXferNum;
    SiAccTrnspt    accTrans;
    SiNotifInd     notifInd;
    SiElementExt   elementExt[NUM_EXT_ELMTS];
} SiFacEvnt;

Raw ISUP packet

Use the Raw ISUP event structure to send raw ISUP message data to the far exchange.

typedef struct _siRawEvnt        /* Raw message  */
{
    U8 length;
    U8 data[MAX_ISUP_PACKET];
} SiRawEvnt;