Events

This topic specifies the layout of the events passed between the application and NMS TUP:

Connect request

typedef struct tupConEvnt          /* TUP Connect Event  */
{
    CallPartyCat     cgPtyCat;     /* IAM, IAI           */
    IAMMessageInd    msgInd;       /* IAM, IAI           */
    AddrSigs         addrSigs;     /* IAM, IAI           */
    LineID           cgPtyNum;     /* IAI                */
    LineID           origCdNum;    /* IAI                */
    ClosedUserGroup  clUsrGrp;     /* IAI                */
} TupConEvnt;

Connect response

typedef struct tupConRspEvnt
{
    AnswerType       answerType;    /* ANC, ANN, ANU  */
} TupConRspEvnt;

Connect status

typedef struct  tupCnStEvnt
{
    RespInd respInd;          /* GRQ, GSM   */
    MsgInd msgInd             /* ACM, ACC   */
    TupAutoCongLvl congLvl;   /* ACC        */
    AddrSigs addrSigs;        /* SAM, SAO   */
    CallPartyCat cgPtyCat;    /* GSM        */
    LineID cgPtyNum;          /* GSM        */
    LineID origCdNum;         /* GSM        */
    TrunkID trunkID;          /* GSM        */
    ChargeInfo chargeInfo;    /* MPM        */
} TupCnStEvnt;

Status

typedef struct tupStaEvnt   /* Status Event   */
{
    MsgInd msgInd;          /* EUM            */
    PointCode pointCode;    /* EUM            */
    Range  range;           /* all GRM's      */
} TupStaEvnt;

Release

typedef struct tupRelEvnt  /* Release Event    */
{
    Cause cause;           /* NOT USED         */
} TupRelEvnt;

All events

This structure is filled if there is an error to report. It is included in the TupAllSdus structure. The evntType field of the information block is filled with ERRORIND in the error report case. Refer to TUPRetrieveMessage.

typedef struct tupErrInfo
{
    U8 origIndType;   /* original indicator       */
    U8 origEvntType;  /* original event type      */
    U32 errorCode;    /* error code - see below   */
} TupErrInfo;

 

errorCode is filled with one of the following values:

Inex

Value

Description

1

TUP_NOMEM

No memory

2

TUP_INVNSAP

Invalid NSAP

3

TUP_INVUSAP

Invalid USAP

4

TUP_INVGRP

Invalid group number

5

TUP_INVCIRC

Invalid circuit index

6

TUP_SAPEXIST

SAP exists already

7

TUP_CIRCEXIST

Circuit exists already

8

TUP_MTPERR

Error received from MTP

9

TUP_INVSTATE

Circuit is in invalid state for this action

10

TUP_UNKEVT

Unknown event

11

TUP_INVENT

Invalid entity

12

TUP_INVPKT

Invalid packet received

13

TUP_INVINST

Invalid instance

14

TUP_BLOCKED

Circuit is blocked

15

TUP_INVSWITCH

Invalid switch type


 

This union is the returned structure from TUPRetrieveMessage in the event parameter:

typedef struct tupAllSdus        /* all SDU messages */
{
    union
    {
      TupConEvnt conEvnt;
      TupConRspEvnt conRspEvnt;
      TupCnStEvnt conStEvnt;
      TupRelEvnt relEvnt;
      TupStaEvnt staEvnt;
    } m;
    TupErrInfo errInfo;
} TupAllSdus;