Package jain.protocol.ss7.tcap.component

This package contains the Event classes representing the component primitives and their specified parameters, if the coding of a paramater is not included in any specific class, it is common to all the specified components and therefore coded within that components parent class.

See:
Description

Class Summary

ComponentConstants	Constants used in package jain.protocol.ss7.tcap.component
ErrorIndEvent	An event representing a TCAP Error indication component primitive.
ErrorReqEvent	An event representing a TCAP Error request component primitive.
InvokeIndEvent	An event representing a TCAP Invoke indication component primitive.
InvokeReqEvent	An event representing a TCAP Invoke request component primitive.
LocalCancelIndEvent	An event representing a TCAP Local Cancel indication component primitive.
Operation	This class represents the Operation parameter of a TCAP Component primitive.
Parameters	Parameters is a parameter of a component.
RejectIndEvent	An event representing a TCAP Reject indication component primitive.
RejectReqEvent	An event representing a TCAP Reject request component primitive.
ResultIndEvent	An event representing a TCAP Result indication component primitive.
ResultReqEvent	An event representing a TCAP Result request component primitive.
TimerResetReqEvent	An event representing a TCAP Timer Reset request component primitive.
UserCancelReqEvent	An event representing a TCAP User Cancel request component primitive.

Package jain.protocol.ss7.tcap.component Description

This package contains the Event classes representing the component primitives and their specified parameters, if the coding of a paramater is not included in any specific class, it is common to all the specified components and therefore coded within that components parent class. The parent classes can be either ComponentIndEvent or ComponentReqEvent depending on whether the component is an indication or request primitive where:

• Indication component primitives - are primitives that can only be sent from a JainTcapProvider. to a JainTcapListener
• Request component primitives - are primitives that can only be sent from a JainTcapListener to a JainTcapProvider.

A generic set of Components primitives has been created that abstracts the functionality of the Component primitives for the supported variants. The mapping between these generic primitives and the variant specific primitives they represent is illustrated in Table 1:

Request Primitves	Indication Primitives	ITU�1993	ITU 1997	ANSI 1992	ANSI 1996
InvokeReqEvent	InvokeIndEvent	TC_INVOKE		TC_INVOKE TC_INVOKE_NL
ResultReqEvent	ResultIndEvent	TC_RESULT_L TC_RESULT_NL		TC_RESULT_L TC_RESULT_NL
ErrorReqEvent	ErrorIndEvent	TC_U_ERROR		TC_ERROR
RejectReqEvent	RejectIndEvent	TC_U_REJECT TC_L_REJECT (indication only) TC_R_REJECT (indication only)		TC_REJECT
	LocalCancelIndEvent	TC_L_CANCEL
UserCancelReqEvent		TC_U_CANCEL
TimerResetReqEvent			TC_TIMER_RESET

Table 1 : Mapping of Component primitives

NOTE:

• The InvokeReqEvent and the InvokeIndEvent can represent either a 'Last' or 'Not Last' Invoke Component primitive for the an ANSI implementation of the JAIN TCAP API, where a flag is included within the primitive to indicate the components function, this flag should be ignored within an ITU implementation.
• Similarly, the ResultReqEvent and the ResultIndEvent can represent either a 'Last' or 'Not Last' Result Component primitive, therefore a flag is also included in these Events to indicate which case applies for both an ITU and ANSI implementation of the JAIN TCAP API.
• Within the RejectIndEvent a flag will indicate whether the primitive is a 'User', a 'Local' or a 'Remote' Reject for an ITU implementation of the JAIN TCAP API.

Mapping of JAIN Mandatory and Optional parameters of Component primitives

The following tables identify the mapping between the ITU and ANSI TCAP Component primitives and parameters. The standards supported in JAIN TCAP v1.0 include:

• ITU-T (03/93) Q series (Q.771-775) � SS7 Functional description of Transaction Capabilities.
• ITU-T (06/97) Q series (Q.771-775) � SS7 Functional description of Transaction Capabilities.
• ANSI (1992) T1.114.1 - T1.114.5 � SS7 Transaction Capabilities Application Part.
• ANSI (1996) T1.114.1 - T1.114.5 � SS7 Transaction Capabilities Application Part.

Mandatory and Optional Parameters

Each of the supported standards defines mandatory and optional parameters for each primitive. As JAIN TCAP supports all the mandatory and optional parameters of each primitive of the supported variants within the one specification, it is necessary to redefine the mandatory and optional parameters of the standards. This new definition of mandatory and optional parameters will be referred to as JAIN TCAP mandatory and optional and will accommodate the mandatory and optional parameter differences within the standards supported.

JAIN TCAP MANDATORY: A JAIN TCAP mandatory parameter is a parameter within a primitive that is mandatory for all the supported variants. In the tables below if any parameter is mandatory (M) for all the variants then it will be mandatory for that JAIN TCAP primitive.

JAIN TCAP OPTIONAL: A JAIN TCAP optional parameter is a parameter within a primitive that is either optional or not supported by any of the supported variants. In the tables below if a parameter is regarded as mandatory for a specific variant and optional or not supported by the other variant it will be regarded as a JAIN TCAP optional.

Table Key:

M = mandatory
O = optional
Blank = not-supported

Invoke Req	TC_INVOKE		TC_INVOKE_NL TC_INVOKE
	ITU 1993	ITU 1997	ANSI 1992	ANSI 1996
Dialogue Id	M	M	M	M
Class	M	M
Invoke Id	M	M	O	O
Linked Id (Correlation Id)	O	O	O	O
Operation	M	M	M	M
Parameters	O	O	M	M
Timeout	M	M
Last Invoke Event			M	M

Table 2 : Mapping of the Invoke Request Component Parameters

Invoke Ind	TC_INVOKE		TC_INVOKE_NL TC_INVOKE
	ITU 1993	ITU 1997	ANSI 1992	ANSI 1996
Dialogue Id	O (see note)	O (see note)	M	M
Invoke Id	M	M	O	O
Linked Id (Correlation Id)	O	O	O	O
Operation	M	M	M	M
Parameters	M	O	M	M
Last Component	M	M	M	M
Last Invoke Event			M	M

Table 3 : Mapping of the Invoke Indication Component Parameters
NOTE: the Dialogue Id is Mandatory in ITU except for the invocation
of a class 4 operation received in a Unidirectional message.

Result Req	TC_RESULT_L TC_RESULT_NL		TC_RESULT_L TC_RESULT_NL
	ITU 1993	ITU 1997	ANSI 1992	ANSI 1996
Dialogue Id	M	M	M	M
Invoke Id (Correlation Id)	M	M	O	O
Last Result Event	M	M	M	M
Operation	O	O	O	O
Parameters	O	O	M	M

Table 4 : Mapping of the Result Request Component Parameters

Result Ind	TC_RESULT_L TC_RESULT_NL		TC_RESULT_L TC_RESULT_NL
	ITU 1993	ITU 1997	ANSI 1992	ANSI 1996
Dialogue Id	M	M	M	M
Invoke Id (Correlation Id)	M	M	O	O
Parameters	O	O	M	M
Operation	O	O	O	O
Last Component	M	M	M	M
Last Result Event	M	M	M	M

Table 5 : Mapping of the Result Indication Component Parameters

Error Req	TC_U_ERROR		TC_ERROR
	ITU 1993	ITU 1997	ANSI 1992	ANSI 1996
Dialogue Id	M	M	M	M
Invoke Id (Correlation Id)	M	M	O	O
Parameters	O	O	M	M
Error	M	M	M	M

Table 6 : Mapping of the Error Request Component Parameters

Error Ind	TC_U_ERROR		TC_ERROR
	ITU 1993	ITU 1997	ANSI 1992	ANSI 1996
Dialogue Id	M	M	M	M
Invoke Id (Correlation Id)	M	M	O	O
Parameters	O	O	M	M
Error	M	M	M	M
Last Component	M	M	M	M

Table 7 : Mapping of the Error Indication Component Parameters

Reject Req	TC_U_REJECT		TC_REJECT
	ITU 1993	ITU 1997	ANSI 1992	ANSI 1996
Dialogue Id	M	M	M	M
Invoke Id (Correlation Id)	M	M	O	O
Parameters			M	M
Problem Code	M	M	M	M

Table 8 : Mapping of the Reject Request Component Parameters

Reject Ind	TC_R_REJECT TC_U_REJECT TC_L_REJECT		TC_REJECT
	ITU 1993	ITU 1997	ANSI 1992	ANSI 1996
Dialogue Id	M	M	M	M
Invoke Id (Correlation Id)	M	M	O	O
Parameters			M	M
Problem Code	M	M	M	M
Last Component	M	M	M	M
Reject Type	M	M	O	O

Table 9 : Mapping of the Reject Indication Component Parameters

LocalCancel Ind	TC_L_CANCEL
	ITU 1993	ITU 1997
Dialogue Id	M	M
Invoke Id	M	M

Table 10 : Mapping of the Local Cancel Indication Component Parameters

UserCancel Req	TC_U_CANCEL
	ITU 1993	ITU 1997
Dialogue Id	M	M
Invoke Id	M	M

Table 11 : Mapping of User Cancel Request Component Parameters