cgin-connectivity 1.5.4.7
This release contains the following changes.
Bug fixes
* The BearerCapability datatype now correctly detects the presence of octet 5b
(layer 1 further information) when the layer 1 protocol is not
V110/I460/X30/V120. (CGIN-2100)
----
cgin-connectivity 1.5.4.6
This release contains the following changes.
Bug fixes
* The Simulated TCAP stack no longer incorrectly sets numberingPlan=1 for
outbound ITU TCAP requests with GTI=1, causing global title translation to
fail. (CGIN-2031)
----
cgin-connectivity 1.5.4.5
This release contains the following changes.
Improvements
* Extended the CGIN Trial package's OSS ASN.1 Compiler licence to 23
December 2018. Users of the trial CGIN package will need to upgrade to
this version to continue to use it in 2018. This change is not relevant to
users of the CGIN full package, which will continue to work indefinitely.
* The Simulated TCAP stack now supports ANSI (A7) SCCP addressing, including
global title translation. For partner products, use of tcapsim with A7
SCCP addressing requires IN Scenario Pack 1.5.4.3 or higher, or SIS
2.5.4.9 or higher. (CGIN-1947)
* Updated example CGIN RA configuration properties included in
deploy.properties. (CGIN-1944)
Bug fixes
* The CleanLostDialogs task will continue to clean lost dialogs even if it
encounters an unexpected exception while processing a lost dialog.
Previously this would stop and this could cause leaked dialogs.
(CGIN-1950)
----
cgin-connectivity 1.5.4.4
This release contains the following changes.
Improvements
* OCSS7: Upgraded the OCSS7 TCAP stack to the latest release of 2.0.0.x.
This version of the OCSS7 TCAP stack supports ANSI SCCP when connected
to SGCs with version at least 2.1.0.0 and remains backwards compatible
with 2.0.0.x SGCs when configured to use ITU SCCP. Refer to the OCSS7
changelog and documentation for details. (CGIN-1813)
* Added support for ANSI SCCP Network-Cluster-Member SCCP address format.
This is in addition to the existing Member/Cluster/Network format.
(CGIN-1846)
* Improved the SccpAddress and SccpAddressParser documentation of ANSI
point code integer formats. (CGIN-1917)
Bug fixes
* Corrected 7-bit GSM letter with encoding 1E to Eszett. (CGIN-1692)
----
cgin-connectivity 1.5.4.1
This release contains the following changes.
Improvements
* Extended CGIN Trial OSS ASN.1 Compiler licence to 23 December 2017.
----
cgin-connectivity 1.5.4.0
Improvements
* OCSS7: Upgraded the OCSS7 TCAP stack to the latest release of 2.0.0.x.
Refer to the OCSS7 changelog for details.
Bug fixes
* The Simulated TCAP stack now handles received provider aborts correctly.
(CGIN-1726, CGIN-1756)
----
cgin-connectivity 1.5.3.0
Improvements
* OCSS7: Upgraded the OCSS7 TCAP stack to the latest release of 1.1.0.x.
Refer to the OCSS7 changelog for details.
----
cgin-connectivity 1.5.2.19
Improvements
* OCSS7: Upgraded the OCSS7 TCAP stack to the latest release of 1.0.1.x.
Refer to the OCSS7 changelog for details.
----
cgin-connectivity 1.5.2.18
This release contains the following changes.
Improvements
* Extended CGIN Trial OSS ASN.1 Compiler licence to 23 December 2016.
----
cgin-connectivity 1.5.2.17
This patch release contains the following changes.
* OCSS7: Fixed a bug where the TCAP stack could stop trying to reconnect.
(SSSVN-344)
* Fixed a bug in the decoding of SMSDeliverReportError from its encoded
form. (CGIN-1715)
* Fixed some datatype codecs which were not thread safe. (CGIN-1515)
----
cgin-connectivity 1.5.2.15
This patch release contains the following changes.
Changes to OCSS7
* Internal OCSS7 components upgraded to version 1.0.1, bringing
various internal improvements specific to the use of the OCSS7 stack.
(CGIN-1704)
* An error is now returned to the CGIN user when attempting
to initiate a dialog to a global title longer than the supported
maximum. (SSSVN-53)
* OCSS7 connection heartbeat is now enabled by default and can be controlled
via a resource adaptor configuration property. (SSSVN-284 / SSSVN-277)
* Fixed an issue which could prevent OCSS7 registering with
the SGC properly when using IPv6. (SSSVN-119)
* Fixed a bug which could cause dialogs not to be properly cleaned up if the
underlying TCAP stack provider reported their state as lost. (CGIN-1711)
* OCSS7 TCAP stack will now raise alarms if it detects that the value of
ocss7.schNodeListSize is too small, as this can cause important dialog
timers not to fire. These alarms must be cleared manually. (SSSVN-269)
* Fixed a thread leak that occurred when the CGIN RA entity was deactivated
and reactivated (affecting users of CGIN 1.5.2.14-EA only) (SSSVN-313)
Changes to tcapsim
* Fixed a rare NPE that occurred when connecting to a remote peer.
(CGIN-1475)
----
cgin-connectivity 1.5.2.8
This patch release contains the following changes.
Improvements
* Extended CGIN Trial OSS ASN.1 Compiler licence to 23 December 2015.
----
cgin-connectivity 1.5.2.7
This release contains the following changes.
Bugfixes
* Corrected a defect in the MAP phase 1 ForwardSM interceptor that could
result in CGIN presenting a phase 1 MTForwardSM as MOForwardSM if the
ASN.1 length field was in long form. (CGIN-1693)
* OCSS7 stack support for the A, D and E sccp address global title digits
(defined as spare in Q.713). (SSSVN-42)
* Fixed issue that could prevent a SIS CGIN RA entity using the tcapsim
stack from being activated after it had been deactivated. (CGIN-1688)
----
cgin-connectivity 1.5.2.4
This release contains the following changes
* Added support for OpenCloud's SS7 stack (OCSS7), supporting ITU-T TCAP,
ITU-T SCCP, M3UA and SCTP
* Enabling DEBUG logging for cgin-slee and then receiving an undecodeable
message should no longer result in that message being ignored silently.
(CGIN-1539)
* References to CGIN TCAP stacks are now cleared promptly on CGIN RA entity
deactivation, to allow garbage collection to happen sooner. (CGIN-1624)
* Fixed an issue which could cause CGIN and the underlying TCAP stack to have
different state for a dialog, causing an extra abort to be sent to the TCAP
stack, which would then discard it. (CGIN-1658)
----
cgin-connectivity 1.5.0-protocol-patches.6
This patch release contains the following changes.
Bugfixes
* Enabling DEBUG logging for cgin-slee and then receiving an undecodeable
message should no longer result in that message being ignored silently.
(CGIN-1539)
----
cgin-connectivity 1.5.0-protocol-patches.3
This patch release contains the following changes.
Bugfixes
* Signalware backend version check now correctly requires -ignoreversioncheck
to ignore suspected Signalware version incompatibilities. (CGIN-1529)
* Fix IllegalStateException: stop() called in STOPPED state when stack is
deactivated and reactivated. (SIS-838)
----
cgin-connectivity 1.5.0-protocol-patches.2
This patch release contains the following changes.
Improvements
* Added hybrid ITU TCAP over ANSI SCCP backend. (CGIN-1504)
* Signalware backends rate limit the production of certain error messages.
(CGIN-1470)
Bugfixes
* Correct a tool chain bug that could cause the CGIN RA to refuse to send
some valid MAP error messages. (CGIN-1507)
----
cgin-connectivity 1.5.0-protocol-patches.1
This patch release contains the following changes.
Improvements
* Added RHEL6 backends for Signalware. (CGIN-1467)
* Modify MAP to use a 10-octet ISDN-AddressString. (CGIN-1497)
* Expose ECS1+ user information as an EncodedExternal, required for relay mode to work. (CGIN-1493)
----
cgin-connectivity 1.5.0-protocol-patches.0
This patch release contains the following changes.
Improvements
* Added methods to DialogOpenRequestEvent to provide access to the Layer 3
point codes for the L3 message that the TC-BEGIN arrived in. The Signalware
stack is the only stack to currently provide these values. (CGIN-1478)
Bugfixes
* Receipt of an ARI with invalid length correlationID should no longer result
in the entire message being ignored (CGIN-1479)
* Added absentSubscriber-v1 ERROR. Modified MAP ph1 operations that previously
used absentSubscriber ERROR to use absentSubscriber-v1 ERROR (CGIN-1480)
* SM-DeliveryFailure ERROR parameter is now compatible with MAP ph1, ph2 and R99+
(CGIN-1483)
* Renamed v1 SetMessageWaitingData operation to ReportSM-DeliveryStatus-v1
(CGIN-1484)
----
cgin-connectivity 1.5.0.13
This patch release contains the following changes.
Improvements
* Updated mach7 TCRA to version 1.15.2.3.b1 (CGIN-1439)
* The tcapsim stack now throws InvalidConfigurationException if the
provided local-sccp-address is missing either the point code or
the SSN (CGIN-469)
* Adjusted the severity of several low priority tcapsim log messages
from WARNING to FINE (CGIN-617)
* Added a system property to configure the tcapsim's dialog state map's
concurrency level (com.opencloud.concurrency_level) (CGIN-1406)
* CGIN dialog manager's state map now supports the new
com.opencloud.concurrency_level system property. (CGIN-1407)
* Increased SUA performance (CGIN-1411)
* The tcapsim now uses Netty 3.5.5, which resolves several connection-related
issues (CGIN-1430)
* Improved tcapsim scalability on highly parallel systems (CGIN-1450)
Bugfixes
* Fixed ASN1Time so that times can be written to various precisions, with
unspecified fields having default values, e.g. no seconds means
seconds=0. (CGIN-1331)
* The tcapsim now routes SCCP management errors for relayed dialogues to
the correct (originating) address (CGIN-1332)
* TimeAndTimeZone.timezone parameter on InitialDP now supports negative
values (CGIN-1338)
* Fixed a regression causing tcapsim global title translation to ignore
partially matching GT table entries. (CGIN-1340)
* The example scenario simulator Mach7 configuration properties and command
file names have been updated. (CGIN-1343)
* The UCS2Treatment bit is no longer decoded in an incoming MSClassmark2
message with revision < R_99 as this bit doesn't exist until R_99 (CGIN-1348)
* Fixed a bug in the constructor from int for types that extend
AbstractLazyEncodedNamedInteger and represent a SEQUENCE with only mandatory
fields (for example, LegType(int)). (CGIN-1362)
* The tcapsim now attempts to reconnect aborted connections (CGIN-1380)
* Fixed an UnsupportedDigitException during copyTo()/clone() on a type that
contains non-standard digits (CGIN-1393)
* Fixed EncodedStringWithIndicators.decode(), which did not decode the
StringIndicators. (CGIN-1401)
* Fixed StringIndicators.decode(), which failed to mark fields as present
(CGIN-1402)
* TimeAndTimezone decoding no longer ignores the sign bit. (CGIN-1448)
* Fixed an issue where the JavaDoc for TimeAndTimezone was incorrectly
described (CGIN-1452)
----
cgin-connectivity 1.5.0.8
This release contains the following changes.
New Features
* Added support for phase 1 of MAP, i.e. -v1 ACNs, in cgin-map. This
includes support for blue-book TCAP in CGIN Unified RA, with a new
counter OpenRequestNoInferredAC counting blue-book open requests for
which no ACN can be inferred. (CGIN-903)
* Allow multiple variants of a protocol on the external network to be
aliased to a single protocol in the CGIN RA, and allow a service to
nominate to which external protocol to map the internal protocol. This
replaces the acn-mappings configuration property, which was 1 to 1 and
used on both the inbound and outbound paths, by acn-inbound-aliases (n to
1) and acn-outbound-mappings (1 to 1). (CGIN-942)
* Added our own SUA layer and changed tcapsim to use that, involving two
new properties: tcapsim.remote-addresses and tcapsim.sctp-stack.
(CGIN-891)
* Added com.opencloud.slee.resources.cgin.xpath.CGINJXPathContext for
accessing fields in protocol messages via Apache's JXPath. (CGIN-1084)
* Implemented INAP1-SK support (CGIN-1076)
Improvements
* Added validation rule to prevent nested usage of the same ALIAS name in a
scenario. (CGIN-577)
* Changed interface StringCodec to use new StringIndicators that define
conversions between indicators so that String fields can be better
decoded speculatively by non-standard StringCodecs. (CGIN-677)
* Metadata class MAPMAP_EXTENSION is now used by other protocols rather
than each having a copy - for example CAP1MAP_EXTENSION. (CGIN-833)
* Changed CAP3's callGap operation to inherit from CallControl's. (CGIN-848)
* Performance: Improved the efficiency of a number of string equality
testing operations. (CGIN-854)
* Added support for alphanumeric CalledPartyBCDNumbers and AddressStrings
when used for SMS addresses in CAP-v4 (CGIN-860)
* Added new configuration property "relaxed-decoding" to ignore certain BER
decoding errors where the results are unambiguous. (CGIN-864)
* Added support for reflective access to fields: getFieldAccessors() for
all the fields of its type, and FieldAccessorFactory for a named field of
an AbstractFieldsObject. (CGIN-887)
* Added generation of new types between ExtendibleOctetString and existing
subclasses thereof, representing extendible OCTET STRINGs in the
callcontrol protocol, to limit which subclasses can be used. Changed
ExtendibleOctetString to be abstract. (CGIN-898)
* Added static T copyOf(superT) methods to all classes that correspond to
ASN.1 types. (CGIN-915)
* Changed setFieldPresent() methods to return this (were void). (CGIN-916)
* Added override setters in subclasses to use covariant return types.
(CGIN-919)
* Use AddressDelimiter for CAP4MidCallControlInfo's OCTET STRINGs.
(CGIN-930)
* Changed subtypes of NamedInteger so that methods getEncodedForm() and
fromValue() return the subtype rather than NamedInteger (CGIN-998)
* Changed method namedValues() in extensions of NamedInteger to return a
clone of the array rather than the original. (CGIN-1038)
* Change return type of ASN1Time.clone() and SccpAddress.clone() from
Object to specific type. (CGIN-1045)
* Added ParserFactory for parsers for ASN.1 values - the inverse of
toString(). (CGIN-1051)
* Changed APIs for some ASN.1 NULL fields to be like others: replace
AddressString.setSMSAddress(...) by AddressString.setSMSAddressPresent(...);
AddressString.getSMSAddress() by AddressString.hasSMSAddress();
SMS*.setOnlyHeader(...) by SMS*.setOnlyHeaderPresent(...);
SMS*.getOnlyHeader() by SMS*.hasOnlyHeader(). (CGIN-1052)
* Added static method staticGetNamedBits() to extensions of
BitStringWithNamedBits. (CGIN-1067)
* Reimplemented getFieldsMap() in terms of FieldAccessors, so that less
bytecode is generated. (CGIN-1069)
* Added hasField() and checkFieldSet() methods to all classes representing
ASN.1 types that didn't already have them. These enable checking whether
mandatory fields have been initialised. The affected classes now extend a
lazy-encoded DataObject rather than an eager-encoded DataObject.
(CGIN-1070)
* Moved UnsupportedDigitException from
com.opencloud.slee.resources.in.datatypes to
com.opencloud.slee.resources.cgin, as part of changes to make the
implementations of protocol APIs have less bytecode. (CGIN-1075)
* In the output of the print-status command, under "Last non-match
details", include details of why the preferred scenario was eliminated,
when appropriate. (CGIN-1083)
* Add a command line option "-l <log-file-name>" to the scenario simulator,
to support logging to a different log file within the logs directory.
(CGIN-1085)
* Added more methods to type ASN1Time, making it extend
AbstractFieldsObject. (CGIN-1086)
* Fields called genericNumber (in S7MPConnectArg and
S7MPContinueWithArgumentArg) are now represented by type GenericNumber
rather than byte[]. Also types MidCallInfoType and MidCallInfo are now
represented by type GenericDigits rather than byte[]. (CGIN-1121)
* Added method fromValue(int) to types in
com.opencloud.slee.resources.in.datatypes that implement ASN.1 ENUMERATED
types. (CGIN-1138)
* PersistCodec methods now return null if passed null. (CGIN-1156)
* Added configuration of interceptors for incoming messages that have no
dialog portion, e.g. acn-inbound-aliases={}:map.phase-1 (CGIN-1161)
* Changed TcapApplicationContext.getApplicationContextName() for MAP phase
1 application contexts to return null rather than a made-up OID that
doesn't appear on the wire. (CGIN-1164)
* Included stack trace in debug logging of ElementConversionExceptions.
(CGIN-1169)
* Reports of non-matches in scenario simulations now show the innermost
exception rather than the outermost. (CGIN-1185)
* Changed type Code so that its API follows the usual pattern for one
specified as an ASN.1 CHOICE type. (CGIN-1188)
* Changed representation of type PAbortCause from NamedInteger to enum.
(CGIN-1189)
* Make deserialization of SccpAddress objects more efficient. (CGIN-1222)
* Fixed a race condition around the handling of elements using both
the AUTO and ALIAS attributes, which could lead to a null pointer
at runtime in some scenarios. (CGIN-1226)
Bugfixes
* Reduced the tracing logged on starting the scenario simulator. (CGIN-786)
* Changed CGIN protocol adaptor log keys for consistency with the CGIN SLEE
resource adaptor, and updated the default logging configuration
accordingly:
- "cgin.stack" replaced by "cgin-tcap"
- "cgin" replaced with "sim-cgin" (CGIN-796)
* Scenario editor changes to help keep scenario names in sync with their
file names:
- Added checkbox to 'Save As' dialog to keep the names synced
- Added 'rename file' option to scenario properties editing dialog,
to renamed scenario files when renaming the scenario. (CGIN-815)
* Added EncodedStringWithIndicators, enabling conversion between
encoded and decoded forms of String fields, that require accompanying
indicators, in the scenario editor. (CGIN-837)
* Fixed the CAP4 collectInformation operation according to 3GPP change
request 29078_CR0396R1_(Rel-7)_C4-051724. (CGIN-849)
* Removed CAP4EventTypeBCSM.tBusy and CAP4EventTypeSMS.o-smsSubmission, as
the inherited constants tCalledPartyBusy and o-smsSubmitted suffice
respectively. (CGIN-874)
* Split MAP phase 2's forwardSM operation into MO and MT cases and made
those be parents of renamed -v3 operations. (CGIN-894)
* Changed CAP4 to use MAP's APIs for OfferedCamel4Functionalities and
SupportedCamelPhases rather than defining its own enums. (CGIN-904)
* Fixed CAP4's string fields to allow *, # and B as characters where
required by the standard. (CGIN-931)
* Removed log4j library from schemas directory. (CGIN-1062)
* Changed Signalware backend invoke timers to have a resolution of 200ms
instead of 1000ms. (CGIN-1077)
* Fixed encoding of SMS{Deliver,Submit}Report{Ack,Error} when UDL is
omitted and UD is empty (CGIN-1149)
* Fixed ArrayIndexOutOfBoundsException on decoding SMSDeliver or SMSSubmit
truncated invalidly to have no UserDataLength. (CGIN-1150)
* Fixed the protocol overview in the javadoc so that it isn't mostly in a
fixed-width font when viewed with firefox 10.0.2. (CGIN-1153)
* Fixed a NullPointerException which happened when converting between the
encoded and decoded forms of some values in the scenario editor.
(CGIN-1199)
* Fixed dialog correlation for scenarios which start with an outgoing
dialog. (CGIN-1203)
* Added skeleton APIs for some types, to enable addition of convenience
APIs for those types without having to upgrade to a new release.
(CGIN-761)
* Added type MeasuredCellList. (CGIN-1047)
* Add serial version UIDs to protocol schema classes, to prove more
flexible backwards compatibility for future revisions of the schema API.
(CGIN-908)
----
cgin-connectivity 1.4.2.8 (2012-02-17 12:50:26 +1300)
This release contains the following changes.
Bug fixes:
CGIN-1057 getFieldsMap() now catches unexpected exceptions from auxiliary
decoders and hence returns encoded forms of the corresponding
fields.
CGIN-1061 Fixed ArrayDataObject.toString() to produce curly braces rather
than square brackets, as required for ASN.1 value notation.
CGIN-1074 Fixed which bit is set by
SMSDataCodingScheme.MessageCodingScheme.setMessageCoding().
CGIN-1089 Fixed TcapError metadata for errors that have parents, i.e. MAP's
cug_Reject_v3, roamingNotAllowed_v3 and ss_SubscriptionViolation
(parent is _v1), and hence the send*Error() methods on the later
versions.
CGIN-1094 Fixed an issue where some TCAP validation rules were not being
checked for scenarios involving multiple schemas.
CGIN-1105 Fixed a memory leak on connection closing in the interface between
CGIN and Signalware.
CGIN-1110 Fixed Cause decoder to not throw ArrayIndexOutOfBoundsException on
bad encoded data.
CGIN-1122 Fixed SMSStatusReport so that its UserDataLength and UserData
fields are optional.
----
cgin-connectivity 1.4.2.4 (2011-10-05 18:22:55 +1300)
This release contains the following changes.
Packaging changes:
To reduce the size of a connectivity pack, some things that were
previously packaged redundantly now need to be unpacked explicitly.
For library jars, do
ant -f common.xml extract-library-jars
For javadoc, do
ant -f common.xml extract-javadoc
CGIN-775 Two additional deployable units are now deployed as part of the CGIN
RA: protobuf-library and oc-common. They are automatically deployed
by the deploy.xml Ant script included with the CGIN connectivity pack.
External scripts that do not use this Ant script will require updating.
Improvements:
CGIN-583 Added a validation rule for invalid table column references in
SELECT attributes, which point to table columns that do not exist
in the scenario.
CGIN-585 Allow simulation when connectivity to remote endpoints is limited.
Include a connectivity summary in the output of the 'print-status'
command. Note: this change allows simulation between two simulators
in loopback mode in the default configuration, without the need for
a third simulator.
CGIN-751 Added support for J7 format of SCCP address to Signalware back-end.
CGIN-775 Added support for the "fast persist" API, providing an API to
convert CGIN API objects to an intermediate form based on
Google Protocol Buffers messages, allowing messages to be
persisted (e.g. in CMP fields) more efficiently than when using
standard Java serialization (but with some additional restrictions).
For details, see the package javadoc for the
com.opencloud.slee.resources.cgin.persist package.
CGIN-855 Increased performance of scenario simulator by freeing message
objects earlier, hence increased tcapsim.max-dialogs from 5K to 20K.
CGIN-858 Improved the evolution history for four things in MAP javadoc.
CGIN-869 Added scenario validation rule to disallow the ALIAS and SELECT
attributes when the COUNT is 0.
CGIN-950 Raise validation warning for elements with empty binary or character
strings marked with the ALIAS or SELECT attributes.
CGIN-972 Added support for Telesys TCAP stack.
CGIN-981 Added a number of validation rules to cover common TCAP related
errors in scenarios.
CGIN-1000 Added validation rules related to Elements which specify both ALIAS
and AUTO attributes.
CGIN-1001 Added a validation rule to test for the ability to correlate
incoming dialogs, when dialogs share state.
CGIN-1017 Added validation rules to prevent ALIAS/SELECT usage for null types,
and for the combination of SELECT and AUTO attributes.
CGIN-1022 Added validation rule to detect multiple DIALOGS, ROLES and TABLES
container elements in a scenario.
Bug fixes:
CGIN-337 Fixed handling of some invalid scenarios involving unnamed Elements,
which would previously cause a NullPointerException.
CGIN-900 Fixed schema-initiated encoding of INAP variants of DateAndTime,
Signal and YearMonthDay.
CGIN-914 Fixed ASN1Time's milliseconds: in GeneralizedTime not UTCTime.
CGIN-930 Fixed javadoc for type AddressDelimiter's BCDStringCodec.
CGIN-970 Improved tcapsim's handling of a TC-CONTINUE received after a local
abort before when the open accept response would have been sent.
Removed attempt to send ABORT in response to TC-END that can't be
mapped locally.
CGIN-979 Fixed MIN_VALUE and MAX_VALUE for extendible enumerated types,
such as CAP2EventSpecificInformationBCSM.Choice, to account for
the separate ranges used by inherited values.
CGIN-982 Fixed encoding of a value of an extendible enumerated type that's
defined only in a parent protocol, such as analyzedInfoSpecificInfo
inherited from CC into CAP2EventSpecificInformationBCSM.Choice.
CGIN-992 Fixed order of initialisation so that getNamedValues() can't
return an array of nulls.
CGIN-996 Fixed the ability to simulate scenarios in which two or more
incoming dialogs occur after the first dialog. Such scenarios
will not work correctly under load, and as such are only suitable
for functional testing.
CGIN-1042 Handle badly formatted binary values for BER encoded fields
properly when validating scenarios.
----
cgin-connectivity 1.4.1.0 (2011-04-27 10:51:02 +1200)
This release contains the following changes.
Improvements:
CGIN-856 The MAP4toMAP conversion assistant is now more helpful,
while more cases that it doesn't automate have been documented.
Bug fixes:
CGIN-851 Added CONTAINING clause to CAP4's IPSSPCapabilities, so that the
contained value gets encoded/decoded.
----
cgin-connectivity 1.4.0.0 (2011-03-28 17:15:14 +1300)
This release contains the following changes.
Major backwards incompatibilities:
Services and scenarios that used the cgin-map-rel4 API will need to use
the cgin-map API instead. See $CGIN/tools/README-MAP4toMAP.txt for
more explanation of the incompatibilities and how to upgrade,
where $CGIN is the directory where your CGIN connectivity pack is installed.
Changes to schemas mean that all scenario files (*.scen) need to be revised.
This can be automated using the scenario editor's migration option, as follows:
$CGIN/tools/scenario-editor.sh -m `find $SCEN -name \*.scen -print`
where $CGIN is the directory where your CGIN connectivity pack is installed
and $SCEN is a directory that all your scenario files are beneath.
Improvements:
Added new protocol MAP, supporting all releases from phase 2 to release 10.
Changed protocols that used MAP-rel4 (such as CAP*) to use MAP instead.
CGIN-760 Deleted protocol MAP-rel4, which supported only release 4.
Added convertor MAP4toMAP, for use on service code and scenarios.
(For usage instructions, see tools/README-MAP4toMAP.txt.)
Added field LoopPrevention to types SMSDeliver and SMSStatusReport for use by
the new MAP.
Improved javadoc of open type extensions.
Improved javadoc concerning CAP4's inclusion of CAP3's GPRS ACs.
To provide support for more sub-protocols:
Changed FCIBillingChargingCharacteristics to allow alternative encodings.
Changed CGEncountered, CollectedInfo and ReceivedInformationArg to allow
additional alternatives.
Changed CCMessageID.text.attributes to allow alternative encodings (CGIN-639).
Changed CCConnectArg.destinationRoutingAddress to be OPTIONAL so that it
can be optional in sub-protocols (CGIN-624).
Required use of Signalware SP6.E (or compatible version).
CGIN-323 Added property signalware.dialog-pool-size to control the size of
the Signalware per-connection handle pool.
CGIN-352 Initialised deploy.properties' ${client.home} to be appropriate
if CGIN is installed as a subdirectory of the Rhino installation.
CGIN-427 Removed varargs from overloaded convenience methods on CGINProvider
(issueOpenRequest) and Dialog (acceptDialog, refuseDialog) that
would capture attempts to call another version of the overloaded
method with slightly incorrect arguments, hiding compile-time
errors.
CGIN-475 Added support for SCCP relay mode via stateless outgoing dialogs.
See CGINProvider.issueStatelessOpenRequest(), or the demo relay
service example code included in the examples/ directory.
CGIN-486 Introduced MSBearerCapability to represent mobile service bearer
capabilities such as GSM bearer capability.
CGIN-487 Added getters to Dialog for MTP priority, SCCP class and
SCCP return option.
CGIN-489 Improved operation/error codec lookup logic to be more protocol-
independent. Distinguished ASN.1 names from API names in metadata.
Added field names to metadata. (Related to CGIN-445 and CGIN-531.)
CGIN-600 Added overview to Javadoc, summarising the supported protocols,
their extension types and their octet string coverage.
CGIN-615 Renamed default endpoints, nodes and example commands in scenario
simulator to avoid confusion with Rhino nodes.
CGIN-626 Introduced AbstractInfoObject to define common behaviour for
information object class metadata classes.
CGIN-633 Allow use of newer Signalware versions that Ulticom indicates are
backward-compatible with supported versions without requiring an extra
backend command-line option.
CGIN-635 Explained FIELD_ABSENT and FIELD_UNINITIALISED in Javadoc of
getFieldsMap().
CGIN-643 Signalware and simulated TCAP stacks now use a configurable thread
pool for processing incoming work, providing better scalability across
CPU cores, and improving throughput when dialog correlation is used
(via CGIN-654).
CGIN-648 Cleaned-up use of generic-like notation in Javadoc of NamedInteger.
CGIN-652 Internal changes to RA configuration property handling. The expected
format of the signalware.node-weight and tcapsim.listen-address
properties have changed slightly.
CGIN-653 RA and TCAP stacks can now be re-configured while they're active,
with alarms raised on failures.
CGIN-655 Improved error reporting when the scenario simulator is given a bad
command-line argument.
CGIN-656 Added property default-activity-timeout to control the default
activity timeout used for new (inbound and outbound) dialogs. This
replaces the Signalware backend's -dialogtimeout command-line
option.
CGIN-658 Renamed RA configuration properties to use hyphens, not mixed-case,
consistently. Renamed the TCAP stack names to be consistent.
Changed TCAP stack specific property names so they are prefixed with
the TCAP stack name. Most configuration property names have changed
slightly as a result; deployment scripts will need to be updated.
CGIN-673 Added CCEstablishTemporaryConnectionArg.cginAssistingDialogCorrelationID
to support correlation of ARI using a correlation ID value that may be
different to the correlation ID sent to the network as part of ETC.
CGIN-679 Changed the Java representation of information object class metadata
to use Class<T> rather than Class for fields of ASN.1 open type.
CGIN-729 The simulated TCAP stack now logs more information when a connection
is lost.
CGIN-730 Switched to 4-digit version numbering, so we don't have to increment
the third digit just for a patch.
CGIN-734 Removed cache of last used StringCodec, so that when a getter or
setter for a String field is called with no explicit StringCodec,
the standard codec is determined and used rather than the cached one.
CGIN-742 Changed toString() on a character string field that fails decoding
using the standard codec so that the encoded form is shown rather
than a lax decoded form.
CGIN-748 Added Dialog.getDialogState() for inspecting the Dialog's state.
CGIN-762 Added Dialog.setRemoteAddress() - violates TCAP spec, but useful.
CGIN-765 Phrased the javadoc of each BCDStringCodec's CharCodec better.
CGIN-800 Added links from READMEs to on-line documentation for Signalware
and tcapsim.
CGIN-813 Improved error reports from scenario simulator and editor when
failing to encode or decode data. CGIN-817 ditto.
CGIN-837 Added decoded variants to schemas for String-valued fields,
in preparation for offering encoded variants in future.
PRD-232 Added support for re-mapping application context names.
Detriments:
CGIN-678 String fields in the scenario editor now have to be opened to
reveal their decoded form.
Bug fixes:
CGIN-308 Fixed NullPointerException from scenario simulator on receiving
OpenRequest with user information of unrecognised class.
CGIN-491 Fixed occasional NullPointerExceptions during codec initialization
due to a ThreadLocal initialization bug (see
http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6550283)
CGIN-507 Fixed initialization warnings from Google Collections code when
encoding user information objects for the first time.
CGIN-536 Fixed ITUDialogManager to not send Abort in response to TC-END, to
be consistent with the unknown dialog case.
CGIN-553 Dialog activity timeouts are now correctly applied to outgoing
dialogs.
CGIN-557 Fixed schema to allow ObjectID to be omitted from the encoded
external of a user information object.
CGIN-579 Fixed CAP4CAMEL-CallResult to inherit from CAP3 rather than CAP2,
renaming fields to make the inheritance work.
CGIN-595 Fixed DuplicateKeyException on reuse of leaked ETC/ARI correlation
id.
CGIN-606 Fixed GapIndicators in CAP3 and CAP4 to inherit interval field
from callcontrol.
CGIN-622 Removed checkFieldsSet() from generated APIs, as it failed for
fields that were inherited but with different optionality.
CGIN-625 Declared information object class metadata fields to be final,
to prevent modification.
CGIN-627 Fixed encode of CHOICE type with uninitialised choice discriminator
to throw EncodeException rather than NullPointerException.
CGIN-629 Fixed clone() in concocted CHOICE types to clone the choice
discriminator.
CGIN-631 Fixed issues with clone() and setReadOnly() on ArrayDataObject<T>,
introducing ArrayOfDataObject<T extends DataObject>.
CGIN-632 Fixed start-backend.sh -logpipe to work as documented
CGIN-637 Fixed checkFieldsSet() in SMSDeliverReport and SMSSubmitReport
to check that inherited fields are initialised.
CGIN-638 Changed representation of BIT STRING types with no named bits
so that size constraints can be honoured.
CGIN-641 Fixed sign-extension bug in LMSIAddress.getId().
CGIN-642 Fixed AbstractLazyEncodedDataObject.getEncodedForm() so that it
doesn't sometimes return an obsolete value, such as after a setter
is called on a nested AbstractLazyEncodedDataObject, and after
set*Present() is called to change the presence of a field.
CGIN-646 Changed address types that have a presentation indicator so that
when it's ADDRESS_NOT_AVAILABLE, other field values are validated
rather than being changed to what they should be.
CGIN-647 Refuse to send invokes/results/errors if the underlying operation or
error has a non-OPTIONAL parameter and a parameter value was not
provided by the service.
CGIN-666 Ensured that all subclasses of NamedInteger define MIN_VALUE,
MAX_VALUE, namedValues() and fromValue().
CGIN-671 Fixed the encoded value of BearerCapability's ModemType V32.
CGIN-674 Fixed getFieldCodec() methods to return null in the case where
the codec is determined by other fields whose values are not
initialised.
CGIN-733 Fixed decoding of MSBearerCapability.GSM.Content.NonSpeech.\
Layer1Capability.O6a.UserRate.
CGIN-743 In overload conditions, dialogs are refused with a user abort with
"no reason given", not with a misleading "unsupported ACN" reason.
CGIN-818 Fixed CAP metadata so that it refers to OpenId rather than Code.
CGIN-825 Avoided generation of unnecessary CAPnCode types.
CGIN-828 Fixed getContainedLength() in SMSDeliver, SMSStatusReport,
SMSAddress and SMSSubmit.ValidityPeriod so that it doesn't return
non-zero sometimes for insufficient/truncated data.
CGIN-831 Avoided generation of unnecessary CAPnExtensionId types.
CGIN-832 Avoided generation of unnecessary _oss_unique_index fields in
metadata.
Other changes:
CGIN-769 Classes AbstractInfoObject, AbstractEncodedDataObject,
AbstractLazyEncodedDataObject, AbstractLazyEncodedNamedInteger,
AbstractLazyEncodedByteArray, AbstractEagerEncodedNamedInteger,
AbstractEagerEncodedByteArray, EncodeException and DecodeException
have moved from package com.opencloud.util to package
com.opencloud.slee.resources.cgin.
----
cgin-connectivity 1.3.4 (2010-12-08 12:07:34 +1300)
This release contains the following changes.
Improvements:
CGIN-591 Javadoc of application contexts' metadata now includes OIDs and description.
Bug fixes:
CGIN-587 Fixed misinterpretation of SCCP address' GT from Signalware.
CGIN-589 Fixed SMSSubmit and SMSDeliver's methods hasProtocolId(), hasDataCodingScheme()
and hasUserDataLength() to return whether those fields have been initialised.
CGIN-593 Fixed decoding of SMSSubmit.ValidityPeriod.EnhancedValidityPeriod.SingleShotSM.
CGIN-596 Fixed a date-related issue that led to an IllegalStateException.
CGIN-604 Fixed SMSTimeStamp(Calendar) to include DST_OFFSET in SMS timezone.
CGIN-610 Fixed YearMonthDay encoding for CAP.
CGIN-616 Fixed ExtForwOptions to allow less than 5 octets.
----
cgin-connectivity 1.3.3 (2010-10-07 14:28:30 +1200)
Release number 1.3.3 was used for a patch release of 1.3.1.
----
cgin-connectivity 1.3.2 (2010-10-07 12:25:08 +1200)
Release number 1.3.2 was used for a patch release of 1.3.0.
----
cgin-connectivity 1.3.1 (2010-09-20 13:24:48 +1300)
This release contains the following changes.
Bug fixes:
CGIN-540 Phrased DecodeExceptions from APIs for OCTET STRING types properly.
CGIN-549 Fixed NPE on refusing a TC-BEGIN with no dialogue portion.
CGIN-564 For CAP4's SendChargingInformationArg's partyToCharge, used CAP3's legID.
CGIN-565 Fixed decoding of identifier fields that have only the global choice,
such as MAP_ExtensionDataTypes.PrivateExtension.
CGIN-568 Changed the scenario simulator's provided config files to load more schemas.
CGIN-569 Fixed SccpAddress.clone() - it wasn't copying the numbering plan.
CGIN-570 Remove correlation id mapping as soon as ARI is received, not on close,
to reduce chance of confusion should that id be reused meanwhile.
CGIN-578 Fixed leaking dialog states in tcapsim when dialogs are ended via prearranged=true
CGIN-584 Fixed ETC-ARI correlation in CAP-v4
Changes to CGIN schemas:
(CGIN-552): Added ProviderError and Reject messages to CGIN schemas.
----
cgin-connectivity 1.3.0 (2010-08-25 18:07:07 +1300)
This release contains the following changes.
Improvements:
Changes to helper classes:
(CGIN-486) Changed BearerCapability to be a CHOICE of the previous API
(under the ITU_T choice) and alternatives that are byte[] for now.
Changed ASN1Time's and BitStringWithNamedBits' setters to return this.
Changes to protocol callcontrol:
To provide support for more sub-protocols:
added operation callGap, along with auxiliary types;
made types CancelArg, ControlType, GapCriteria and GapTreatment be
extendible.
Changes to protocol ETSI INAP CS1:
To provide support for more sub-protocols:
changed types ExtensionType and ReleaseCallArg to be CHOICEs;
made types CancelArg, EventSpecificInformationCharging, EventTypeCharging,
ServiceInteractionIndicators and SFBillingChargingCharacteristics be
extendible.
Changes to protocol MAP rel4:
Changed representation of IMEI to use
com.opencloud.slee.resources.in.datatypes.cc.IMEIAddress.
Changes to protocol CAP v2:
To provide support for more sub-protocols:
made type DPSpecificCriteria be extendible.
Changes to protocol CAP v3:
To provide support for more sub-protocols:
renamed error canceled as cancelled;
made types GPRSEventType and EventSpecificInformationSMS be extendible.
Changed representation of CAP-datatypes.TPProtocolIdentifier
to use com.opencloud.slee.resources.in.datatypes.sms.SMSProtocolId.
Added new protocol CAP v4.
Added support for extension fields, i.e. SEQUENCE types with some fields
of open type and an identifier field, and a table of defined extensions.
Added generation of APIs for the extension fields referenced by the tables.
Changed the representation of an open type from ASN1Open to
ContainingOctetString, so that a specific extension type can be
accessed using the get/set/hasContainedValue() methods.
Adapted the representation of the associated identifier fields,
whose values determine the specific type of extension, to be the new
type OpenId for all protocols, so that there's a common representation
for services (and API generation).
Added generation of class OpenTypeExtensions in the metadata package,
containing definitions of defined extensions.
Added support for extension fields in protocol schemas, as drive
the scenario editor and scenario simulator.
(CGIN-472)
Changes to scenario simulator:
(CGIN-194) Added an IGNORE_ORDER attribute for use in scenario definitions.
(CGIN-504) Added a -schemas option to the create-local-endpoint command.
Changes to CGIN schemas:
(CGIN-526) Added a validation rule to check that each dialog is closed.
(CGIN-545) Order the structured views in a translatable type alphabetically.
(Multiple structured views arise only with extension fields.)
Changes to documentation:
(CGIN-455) Included in the documentation of a type's API the adaptation
requests that affect the APIs of the type's components.
(CGIN-456) Improved Javadoc of getChoice() method.
Some minor improved wording in other Javadoc.
Bug fixes:
(CGIN-128) Fixed get*() methods in CHOICE types in in-datatypes to throw
IllegalStateException for all but the current choice.
(CGIN-449) Fixed API of null fields that should be inherited from CHOICE types.
(CGIN-454) Fixed toString() in lazily-encoded types to return
"{ encodedValue ... }" if decoding fails, instead of an exception.
(CGIN-459) Fixed Signalware back-end to ignore TC-NOTICE that can't be
correlated to a local dialog (where we already sent TC-END).
(CGIN-474) Fixed BearerCapability to throw EncodeException if the specified
CodingStandard is not supported.
(CGIN-478) Fixed MAP4 unstructuredSS-Notify to allow a returned result.
(CGIN-481) Fixed handling of openRefuse in scenario simulator.
(CGIN-490) Fixed length checks in IMSIAddress.
(CGIN-492) Fixed DateAndTime's decoding of INAP 2-digit year to be in range
1970-2069 rather than 1900-1999, encoding any in range 0-9999.
(CGIN-503) Fixed array returned by an enumerated type's namedValues() method
to be initialised after the fields it references, so that it
doesn't contain nulls.
(CGIN-505) Fixed TcapApplicationContext.equals() to not give CCE on objects of
different types. Similarly TcapError.equals() and TcapOperation.equals().
(CGIN-508) Secured array-valued static fields by making their associated getters
return a clone of the array, to prevent modification of elements.
(CGIN-509) Added check that elements of SEQUENCE OF and SET OF arrays aren't
null on encoding.
(CGIN-516) Fixed encoding and decoding of values of extendible ENUMERATED types
for which names are not defined by the current protocol.
(CGIN-524) Fixed a scenario simulator bug that caused degraded performance
under load in multiple dialog scenarios, when the declared order of
dialogs differed from the order in which they are used in the
message flow.
(CGIN-534) Removed a potential dead-lock condition in the scenario simulator.
(CGIN-535) Fixed a scenario simulator bug that could prevent certain messages
from being sent, including CanceledError in the CAPv3 schema.
----
cgin-connectivity 1.2.2 (2010-05-25 15:05:20 +1300)
This release contains primarily bug-fixes and a few improvements.
Improvements:
(CGIN-288) Documented the need to deactivate and activate the RA after
installation of a license for a protocol to be enabled.
(CGIN-412) Scenario editor can now associate schema violations by highlighting
to a particular element attribute value.
(CGIN-423) Added support for proprietary externals in user information fields.
(CGIN-434) Allowed the argument of a CAP2SpecializedResourceReport operation
to be omitted, for an SRF that doesn't conform to the CAP2 standard.
Some minor improved wording in Javadoc.
Bug-fixes:
(CGIN-403) Fixed an ArrayIndexOutOfBoundsException in the unified RA
that could occur if invoke IDs of inbound or outbound operations
were used in a particular order.
(CGIN-411) Fixed an IllegalArgumentException from validation of element
attribute values in the scenario simulator and scenario editor.
(CGIN-413) Changed toString() to conform to the notation for ChoiceValues
specified by X.680.
(CGIN-418) Changed names of packages in some generated code to include protocol
name, so that things that have the same name but different
definitions aren't confused in the unified RA.
(CGIN-424) Fixed TCAP simulator to handle sending of local/remote aborts
correctly on receiving unexpected dialog messages.
(CGIN-431) Fixed NullPointerException in scenario simulator on dialog open
on an unknown application context - the dialog is now aborted.
(CGIN-435) Fixed handling of operations that return a result but not a value
in the Signalware back-end.
(CGIN-436) Fixed construction of SMSTimeStamp from a Calendar.
(CGIN-438) Fixed decoding of DateAndTime.
----
cgin-connectivity 1.2.1 (2010-04-30 11:44:47 +1300)
This release contains mainly API and RA bugfixes, scenario simulator bugfixes
and scenario simulator performance improvements.
This release now supports deployment of the RA using Rhino 2.1-02,
with some limitations:
* Use of separately licensed protocols still requires
Rhino 2.1-03 or later;
* Activating a CGIN RA entity using Rhino 2.1-02 can take one minute or
longer due to a classloading problem present in 2.1-02 but fixed in 2.1-03.
Also, the first few network messages processed may incur large latencies
(several seconds) as classloading completes.
Scenario simulator changes:
(CGIN-166) Fixed a scenario simulator matching problem when
multiple scenarios were loaded and one was a superset of another.
(CGIN-261) Scenario simulator could hang while sending an operation.
(CGIN-274) Improvements to the scenario simulator's tolerance of overload
conditions.
(CGIN-282) The scenario simulator now correctly supports CSV datasets.
(CGIN-305) Fixed lost/hanging dialogs on the scenario simulator when under
load.
(CGIN-314) Fixed unexpected exception from the scenario simulator when
receiving messages containing dialog-level user information.
(CGIN-317) Scenarios containing a dialog with no messages now cause a
validation error in the scenario simulator, not a NPE.
(CGIN-322) Improvements to the scenario simulator's tolerance of overload
conditions.
(CGIN-330) Fixed a memory leak in the scenario simulator
(CGIN-331) Make the scenario simulator correctly handle rejected tasks when
under load, which could otherwise result in hung scenario instances.
(CGIN-339) Improve scenario simulator performance by relaxing unnecessary
repeated scenario structural checks
(CGIN-347) Fix a NullPointerException in the scenario simulator protocol
adaptor in onOperationInvoke()
(CGIN-356) Fix unexpectedly duplicated messages when simulating a scenario
under load.
(CGIN-364) Fix an intermittent IllegalArgumentException when simulating a
scenario that has an invoke ID that has both ALIAS and AUTO set.
(CGIN-366) Generate a validation error if an explicit value is provided for
a scenario element that is marked AUTO.
(CGIN-377) Fix a race condition when matching scenarios that could cause
matching to incorrectly fail.
Bugfixes:
(CGIN-256) Fix a cluster of problems involving partially-decoded
representations of encoded data for many types in in-datatypes
(particularly address string types such as CallingPartyNumber).
This fixes various unexpected NullPointerExceptions on encode or
while manipulating a mutable copy of the datatype.
(CGIN-271) Removed a harmless warning message when deactivating the simulated
TCAP stack
(CGIN-277) Fixed confusion between two-digit and four-digit year
representations in SMSTimeStamp.
(CGIN-291) Fixed incorrect timer expiry duration for timers used by tcapsim.
(CGIN-292) Fixed incorrect timer expiry duration for timers used by the
Signalware backend processes.
(CGIN-299) Fixed serialization and CMP storage of address string types
(e.g. CalledPartyNumber), and any types that referenced them
(e.g. CS1InitialDPArg)
(CGIN-307) Fix serialization of API types generated from BIT STRINGs.
(CGIN-318) Allow fields of SMSTimeStamp to take any encodable value, as the
specification does not restrict them to conventional time limits.
(CGIN-319) Correctly name fractional timezones when formatting a date
string returned by SMSTimeStamp.toDateFormat()
(CGIN-324) Correctly set the month field when constructing a SMSTimeStamp via
SMSTimeStamp.<init>(Calendar)
(CGIN-327) Conversion of SMSTimeStamp 2-digit year into calendar year is now
deterministic and does not depend on the current system time.
(CGIN-341) Fix a NPE in the ARI interceptor if an empty assisting dialog
TC-BEGIN that does not contain an ARI is received
(CGIN-344) Fix tracing format of ASN.1-derived types passed over the TCAP
interface when tracing is enabled.
(CGIN-363) Fix duplication of tcapsim application ID if running two independent
simulators with the same endpoint names.
(CGIN-369) Fix interceptor confusion if more than one interceptor was
registered for the same ACN/direction pair.
(CGIN-370) Throw EncodeException, not ArrayIndexOutOfBoundsException, when
encoding an IPSSPCapabilities object with a bilateral part that is
the wrong length.
(CGIN-372) Fix a problem where user information provided when refusing a
dialog was discarded and not sent to the network.
(CGIN-379) Allow serialization of ASN1Null, ASN1Time, and ASN1Open objects.
(CGIN-395) When using the Signalware TCAP stack, fix message corruption or
backend crashes when receiving messages that were reassembled
from multiple XUDT messages.
(CGIN-396) Ensure that hashCode() on generated sequence types with absent
mandatory fields is constant between JVM instances.
(CGIN-397) Fix a ClassCastException in hashCode() on generated sequence types
that contain arrays of primitive types.
Other improvements:
(CGIN-286) Removed an obsolete documentation index.html (with broken links)
(CGIN-288) Refuse to activate a RA entity if any protocol license is missing,
rather than just disabling that protocol.
Notice license changes on RA entity activation, so artificially
reconfiguring the RA entry to notice a new license is no longer
necessary.
(CGIN-300) If a TC-BEGIN with an unsupported ACN is received, generate an
appropriate Fine-level trace message.
(CGIN-315) API javadoc now includes 'Use' crossreference pages.
(CGIN-338) Fix the default deployment properties for the tcapsim to include
localSccpAddress
(CGIN-343) Provide a better implementation of
ComponentRejectedEvent.toString()
(CGIN-358) Generate crosslinks to J2SE and SLEE javadoc in the CGIN API
javadoc.
(CGIN-371) Support deployment of the CGIN RA under Rhino 2.1-02, with some
limitatations.
(CGIN-388) When using the Signalware TCAP stack, attempting to use a
SccpAddress that has no Encoding Scheme set will now produce an
exception to the calling service when sending, rather than an
asynchronous error notification from the backend.
----
cgin-connectivity 1.2.0 (2010-03-04 15:23:29 +1300)
This release focuses on dialog correlation,
and improvements to existing APIs. It also includes changes to support
the use of SIS 2.2 on top of CGIN 1.2.
This release requires the use of at least Rhino 2.1_03. It will not deploy
in earlier Rhino versions.
Dialog correlation support:
In a clustered environment, incoming assisting dialogs containing an
AssistRequestInstructions operation are directed to the same cluster node as
the dialog that sent the corresponding EstablishTemporaryConnection operation.
This allows services to correlate the two dialogs without requiring use of
replicated SBBs.
API changes:
Widespread small API changes were made between 1.1 and 1.2. These include:
The components of a received TC-BEGIN are now available for
inspection in the open request event, via
DialogOpenRequestEvent.getComponents(). This can be useful when
writing initial event selectors.
DialogEvent.getUserInformation() is now guaranteed to return a non-null
array reference.
DialogOpenRequestEvent, DialogOpenAcceptEvent, DialogOpenRefuseEvent,
and DialogUserAbortEvent constructors now take an explicit user information
argument, not varargs.
Generated SEQUENCE types now extend AbstractFieldsObject, not
AbstractSequence.
equals() and hashCode() on generated sequence types have been
reimplemented to be consistent and symmetric, including between
sibling or subclass/superclass types.
Improvements to the formatting of values returned by the generated toString()
methods of sequence types.
Extensible OCTET STRING types are now represented by a single Java
class, ExtensibleOctetString. OCTET STRING types with a CONTAINING
constraint extend ExtensibleOctetString to add an accessor for
the contained value, in addition to the raw bytearray provided by
the superclass. Received octet strings contain both the raw
contents and (if present) a suitably decoded contained value.
When encoding, if both a contained value and a raw value are
present, the contained value is used.
The API for BIT STRINGs has substantially changed.
The API types of extendible OCTET STRING fields have changed from
a named subclass of AbstractOctetString to the concrete type of
ExtendibleOctetString. This affects:
CCApplyChargingArg.aChBillingChargingCharacteristics
CCSendChargingInfoArg.sCIBillingChargingCharacteristics
The following fields have changed from byte[] to
ExtendibleOctetString:
CCEstablishTemporaryConnectionArg.scfID
CAP3CompoundCriteria.scfID
CS1ConnectArg.scfID
Generated clone() methods now have a covariant return type that
matches the class they are implemented on.
For SEQUENCE types that have only mandatory fields, a new
constructor that takes all mandatory fields and constructs a
read-only object from them has been added.
Java enums corresponding to an ENUMERATED types now contain the
numeric enumeration values, accessible via the intValue() and
fromValue() methods
The following types have changed from Java enum types to subclasses of
NamedInteger:
CCEventTypeBCSM
CAP3EventTypeSMS
The following types are now extendible CHOICEs:
CCLegID
The following fields were mandatory in 1.1, but are optional in 1.2:
CCApplyChargingArg.aChBillingChargingCharacteristics
CCSendChargingInformationArg.sCIBillingChargingCharacteristics
Note that for most protocols, these fields are still mandatory at
the protocol level.
The version of all protocol components (RA types, library jars, and
events) has been incremented to 1.2 to reflect the API changes made in the
1.2 release.
Common event classes (e.g. ComponentRejectedEvent) now have a static final
field named ID that contains an instance of the EventTypeID they will be
fired with.
(CGIN-90) Added methods CGINProvider.isSupportedApplicationContext() and
DialogOpenRequestEvent.isSupportedApplicationContext() to allow
testing for application contexts supported by the underlying RA.
(CGIN-92) Added improved support for the MAP ISDN-SubaddressString datatype.
(CGIN-95) Added improved support for the MAP ExtForwOptions datatype.
(CGIN-97) Add a nullary constructor to generated BIT STRING types.
(CGIN-100) Move encode logic for BIT STRING types out of the API type, so the
API type is purely a data-holding object.
(CGIN-108) CCEventTypeBCSM is now a subclass of NamedInteger, not an enum.
(CGIN-109) Added an Event.getName() method to the common API.
(CGIN-118) Removed an unnecessary renaming of the InitialDP
redirectionInformation field to be consistent with the underlying
ASN.1 and other operations.
(CGIN-119) Added improved support for the CAPv3 RPCause datatype.
(CGIN-127) Added a new public method checkFieldsSet() on generated datatypes.
(CGIN-128) The API for CHOICE-like hand-coded datatypes now matches the
generated API for ASN.1 CHOICE datatypes.
(CGIN-129) Use only int and long, not byte and short, for ASN.1 INTEGER types.
(CGIN-130) Merge CAPv3's dpSpecificCriteria with CAPv2's dPSpecificCriteria,
rather than having two fields with different capitalization.
(CGIN-267) The static method fromValue() generated for enums derived from an
ASN.1 ENUMERATED type now throws IllegalArgumentException, not
AssertionError, if an out-of-range value is provided.
(CGIN-270) The API for invoke IDs specified as part of the Cancel operation
now correctly follows the underlying wire representation. The
class CCInvokeID no longer exists - invoke IDs are simply integers.
Other improvements:
(CGIN-25) The CAPv3 protocol implementation allows 7-octet RAIdentity values,
to allow interoperation with implementations based on older
revisions of 29.078 (v4.0.0 - v4.2.0)
(CGIN-89) All network-specific constraints in ETSI INAP CS1 (e.g. maximum
number of extensions) were raised to large values to allow
interoperation regardless of the particular limits used in a
network.
(CGIN-110) Document the event type used to fire ComponentRejectedEvent
(CGIN-120) Improved latency when allocating new outgoing dialogs via the
Signalware TCAP stack.
(CGIN-171) Simulator now allows sending of translatable types where an encoded
form is provided even if the encoded form cannot be decoded
successfully.
(CGIN-197) Reduced memory use when using the simulated TCAP stack under high
load.
(CGIN-199) A separate deployment script that deploys/undeploys only the RA,
excluding the example service, is now provided.
(CGIN-262) The default invoke timeout used by the scenario simulator is now
configurable via endpoint properties.
Bugfixes:
(CGIN-96) Check that all mandatory fields are set when encoding, and throw
an EncodeException rather than a less useful NullPointerException
if any are missing.
(CGIN-147) Corrected tcapsim behavior when sending an ABORT in the
Initiation Sent state
(CGIN-147) Corrected tcapsim behavior when receiving an ABORT in the
Initiation Received state
(CGIN-157) Fix misleading exception messages when attempting to send an invoke
in an inappropriate dialog state
(CGIN-168) Fix ArrayIndexOutOfBoundsException when encoding BIT STRING
values in the scenario simulator
(CGIN-219) Unlucky choices of node ID and RA entity name in a clustered
environment could confuse the simulated TCAP stack's connection
management logic.
Note: This bugfix changes the simulated-stack communication protocol
in an incompatible way. 1.2 simulated TCAP stacks will not
interoperate with 1.1 simulated TCAP stacks.
(CGIN-237) Fixed a scenario matching bug, in which matching against a binary
string would produce false positives.
(CGIN-246) Fix heap exhaustion when attempting to load a CSV file into the
scenario simulator.
(CGIN-248) Fixed NPE in toString() when mandatory fields of an API object were
not set. Missing mandatory fields now display with a value of
"-- UNINITIALISED --".
(CGIN-249) Use the API field name, not the underlying field name, when
testing for API object equality or when constructing a string to
return from toString()
(CGIN-256) Fix various cases where partially-decoded address objects could
lose decoded data if accessed/updated in particular ways.
(CGIN-257) Avoid NPE when encoding an IPSSPCapabilities with no BilateralPart
(CGIN-258) Don't include values for DEFAULT fields when encoding an ASN.1
SEQUENCE type when the corresponding field in the API object is
not present.
(CGIN-264) Avoid NPEs when dealing with CHOICE objects that have not yet had
a particular choice selected.
(CGIN-266) Allow simulation of messages that have empty mandatory fields with
have a non-empty ALIAS or SELECT attribute.
(CGIN-268) Ensure that field presence/absence indicators are always set
correctly on hand-coded datatypes.
(CGIN-270) The protocol-level encoding of InvokeID (used in the Cancel
operation of ETSI INAP CS1 and CAP v3) is now correctly formatted.
Changes to the scenario editor are documented separately within the editor's
internal changelog (accessible via Help > Changelog)
----
cgin-connectivity 1.1.4 (2010-02-11 14:52:46 +1200)
This release fixes the following issues.
(CGIN-199) Fix README.examples regarding how to deploy the example service
(CGIN-207) ArrayStoreException on decoding super-protocol objects into
sub-protocol[]
(CGIN-208) NullPointerException in AbstractLazyEncodedByteArray.clone()
(INCONN-235) Fix unintentional conversion of GT_0100 to GT_0011 in SCCP
address codec
----
cgin-connectivity 1.1.3 (2010-01-22 18:42:54 +1200)
This release is the first to have a freely-downloadable trial version.
It includes fixes for the following issues.
Documentation changes:
(CGIN-137) The main Javadoc index.html does not load sub pages when you click
the links
Scenario Editor changes:
(CGIN-179) Scenario editor doesn't show CGIN specific validation warnings in
the message window
Scenario Simulator changes:
(CGIN-144) Warning about trying to transition state machine for invoke that's
already finished after receiving TC_END
(CGIN-156) Fixed an issue where aliases on fields with different names would
fail to match
(CGIN-164) Added force-quit console command to scenario simulator
(CGIN-174) Fixed support for ASN.1 OpenTypes in the scenario simulator
(CGIN-188) Added partial support for SCCP addresses using global title routing:
global title information can be included with addresses which also
specify point code and SSN
Datatype / API changes:
(CGIN-148) Extensions of NamedInteger gave ClassCastException on casting an
inherited constant to a subclass. The API for such subclasses has
changed to permit inherited constants.
(CGIN-143) NPE in CAP2InitialDPArg.clone()
(CGIN-149) Incomplete code generated for CHOICE's setField method
(CGIN-150) clone() methods of concocted types don't do a deep copy
(CGIN-155) toString() can cause decoding of address fields using inappropriate
DigitCodec
(CGIN-158) toString() on uninitialised fields of ASN.1 NULL type throws NPE
(CGIN-170) ArrayStoreException in LazyEncodedByteArray.clone()
(CGIN-172) getAddress(DigitCodec) returns any previous result regardless of
DigitCodec
(CGIN-173) clone() doesn't copy inherited fields
(CGIN-192) Generated equals() methods on a sequence and an extension thereof
are not symmetric
(CGIN-195) Mandatory fields with default values are treated as absent
optional fields on decoding
(CGIN-201) Type ASN1Open's methods has array-related bugs
TCAP Simulator changes:
(CGIN-134) TCAP sim sometimes doesn't deliver ready notifications after
establishing all connections
(CGIN-159) TCAP sim stack treats all outgoing aborts as user aborts when
transitioning outstanding invokes
----
cgin-connectivity 1.1.2 (2009-11-16 10:51:58 +1200)
This release focuses on bugfixes, documentation updates, and scenario
simulator improvements.
General:
* Documentation updates
Simulator and editor changes:
* Throw a meaningful exception when trying to create a local endpoint with a
protocol adaptor type which isn't available.
* Expand the semantics of the set-preferred-scenario command to also influence
which scenario to use when generating load.
* Changes to ensure that the message ordering reported by the simulator's
console matches the actual ordering used on the network.
* Fixed a schema generation bug that would cause some datatypes to be omitted
from some protocol schemas.
* Fix simulator generation of BIT STRING values.
* Change default simulator logging configuration to avoid DEBUG output.
* Fix simulator shutdown sequence so it cleanly shuts down.
* Add LoadDataSet and BindTable to the scenario simulator's command list
* Several bugfixes related to matching scenarios under load, and matching
multiple correlated dialogs in a single scenario.
* Several bugfixes related to editing and validation of transaltable types.
* Added several new scenario validation rules.
Resource adaptor / core changes:
* Don't throw AssertionError after firing a ComponentRejectedEvent.
* Don't throw ClassCastException when trying to send a datatype that uses an
OCTET STRING with a (CONTAINING) constraint.
* Corrected the bit ordering of encoded BIT STRING types.
* Fixed the ASN.1 encoder/decoder debug tracing to correctly print
the values being encoded or decoded.
* Added debug tracing to the component rejection path to make it clear why a
component was rejected.
* Correct the exception message of exceptions thrown due to a missing
operation or error argument.
Datatype / API changes:
* Fix sign extension bugs in the encoding of CellGlobalId
* Fix return value of hasProtocolId(), hasDataCodingScheme() and
hasUserDataLength() in SMSDeliver and SMSSubmit PDUs.
* Fix encoding of SMSSubmitReport PDUs.
* Don't throw NullPointerException from Cause.toString() if no recommendation
value is present.
* Check that mandatory fields are set earlier, to avoid unexpected NPEs.
* Various documentation updates.
* Various updates to toString() on many types for consistency.
* Fixed the implementation of hashCode() and equals() on generated types that
contained array-type fields.
Signalware TCAP stack changes:
* Avoid a rare buffer truncation problem with very long backend logging.
* Include date as well as time in backend log messages.
Packaging / examples changes:
* Include localSccpAddress in the default TCAP simulator properties files
* Decrease DELAY values in example scenarios
* Changes to make the examples and example configuration selfconsistent.
* Added a top-level javadoc index page.
* Added various Windows batch scripts for the CGIN tools.
----
cgin-connectivity 1.1.1 (2009-10-19 16:29:25 +1200)
* Initial release.
----
