When decoding information elements and analyzing them the library fills an array in the context with the identifiers of IEs that had errors. This is the size of this array.
UNI_NUM_IE_GIT( 3)
A message is allowed to contain more than one General Identifier Transport information element. This is the maximum supported number of these IEs.
UNI_NUM_IE_BLLI( 3)
The maximum number of BLLI information elements in a SETUP message.
UNI_NUM_IE_CALLEDSUB( 2)
The maximum number of Called Subaddress information elements in a SETUP message.
UNI_NUM_IE_CALLINGSUB( 2)
The maximum number of Calling Subaddress information elements in a SETUP message.
UNI_NUM_IE_TNS( 4)
The maximum number of Transit Network Selection information elements in a SETUP message.
UNI_TNS_MAXLEN( 4)
The maximum size of a name in the TNS IE.
UNI_UU_MAXLEN( 128)
Maximum size of user data in the UU IE.
UNI_ADDR_MAXLEN( 20)
Maximum address size.
UNI_SUBADDR_MAXLEN( 20)
Maximum subaddress size.
UNI_NUM_IE_DTL( 10)
Maximum number of DTL information elements in a SETUP message.
UNI_DTL_MAXNUM( 20)
Maximum number of identifiers in one DTL information element.
For information elements in PNNI message the pass fields contains the pass along flag from the IE header.
The present field is a bit field, which contains four common bits describing the current state of the information element. The rest of the bits are used by the information elements to indicate which of the optional fields of the IE are present. Most of the IE header files contain definitions for those bits. The common bits are:
#define UNI_IE_EMPTY 0x80000000
#define UNI_IE_PRESENT 0x40000000
#define UNI_IE_ERROR 0x20000000
#define UNI_IE_XXX 0x10000000
The flag UNI_IE_EMPTY indicates that the information element is present, but empty (its length is zero). This is legal for all information elements. The flag UNI_IE_PRESENT indicates that the IE is present in the message and the flag UNI_IE_ERROR indicates that the IE had an error. The flag UNI_IE_XXX is currently not used.
The following macros may be used to test or change these flags:
IE_ISPRESENT
Check whether the IE is present and not empty. Returns true in this case.
IE_SETPRESENT
Set the IE to be present and not empty.
IE_ISEMPTY
Check whether the IE is present and empty. Returns true in this case.
IE_SETEMPTY
Set the IE to be present and empty.
IE_ISERROR
Check whether the IE is present and has an error. Returns true in this case.
IE_SETERROR
Sets the IE to be present and to have an error.
IE_ISGOOD
Checks whether the IE is present, not empty and without error. Returns true in this case.
For each IE type there is an .Vt enum uni_ietype definition of the form UNI_IE_* in uni_hdr.h.
unistruct.h contains a .Vt union uni_ieall that is the union of all IE structures and a
struct uni_ie {
enum uni_ietype ietype;
union uni_ieall u;
};
The pass field is the pass along indicator in the case of PNNI messages.
For each message type there is a .Vt enum uni_msgtype definition of the form UNI_* in uni_hdr.h. uni_struct.h contains a .Vt union_msgall that is the union of all message structures and a
struct uni_all {
enum uni_msgtype mtype;
union uni_msgall u;
};
This is an array consisting of the following structures:
struct uni_ierr {
enum uni_ierr_type err; /* what error */
enum uni_ieact act; /* the action indicator */
u_int ie:8; /* the ie type */
u_int man:1; /* mandatory flag */
u_int epref:1;/* Q.2971 9.5.3.2.1 low-pri epref */
};
When decoding information elements the information about IEs with errors is stuffed into this array.
errcnt
The current number of IEs in err.
q2932
Enable the Q.2932.1 Generic Functional Protocol. Currently only message and IE decoding/encoding is supported. The signalling part is still missing.
pnni
Enable PNNI extensions. Currently only message and IE decoding/encoding is supported. The signalling part is still missing.
git_hard
Do hard checking on GIT information elements.
bearer_hard
Do hard checking on Broadband Bearer IEs. This involves rejecting old bearer type values.
cause_hard
Do hard checking on Cause information elements.
multiline
This is used by the printing routines. Legal values are 0 to 4 and give different kinds of printout.
tabsiz
The size of tabulation to use in printing. 4 is a good value.
