1、 ETSI TS 102 344 V1.1.1 (2004-07)Technical Specification Application session servicesETSI ETSI TS 102 344 V1.1.1 (2004-07) 2 Reference DTS/ECMA-00290 Keywords CSTA, service ETSI 650 Route des Lucioles F-06921 Sophia Antipolis Cedex - FRANCE Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16 Siret N 348
2、623 562 00017 - NAF 742 C Association but non lucratif enregistre la Sous-Prfecture de Grasse (06) N 7803/88 Important notice Individual copies of the present document can be downloaded from: http:/www.etsi.org The present document may be made available in more than one electronic version or in prin
3、t. In any case of existing or perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF). In case of dispute, the reference shall be the printing on ETSI printers of the PDF version kept on a specific network drive within ETSI Secretariat. Use
4、rs of the present document should be aware that the document may be subject to revision or change of status. Information on the current status of this and other ETSI documents is available at http:/portal.etsi.org/tb/status/status.asp If you find errors in the present document, send your comment to:
5、 editoretsi.org Copyright Notification No part may be reproduced except as authorized by written permission. The copyright and the foregoing restriction extend to reproduction in all media. European Telecommunications Standards Institute 2004. All rights reserved. DECTTM, PLUGTESTSTM and UMTSTM are
6、Trade Marks of ETSI registered for the benefit of its Members. TIPHONTMand the TIPHON logo are Trade Marks currently being registered by ETSI for the benefit of its Members. 3GPPTM is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. ETSI ETSI TS
7、 102 344 V1.1.1 (2004-07) 3 Contents Intellectual Property Rights4 Foreword.4 Brief history4 1 Scope 5 1.1 Overview 5 1.2 Template description 5 2 Conformance 6 2.1 Application conformance .6 2.2 Server conformance6 3 References 6 4 Service definitions7 4.1 Start Application Session .7 4.1.1 Service
8、 Request 7 4.1.2 Service response .8 4.1.2.1 Positive acknowledgement8 4.1.2.2 Negative acknowledgement 8 4.1.3 Functional requirements .8 4.2 Stop Application Session9 4.2.1 Service Request 9 4.2.2 Service Response 9 4.2.2.1 Positive Acknowledgement.9 4.2.2.2 Negative Acknowledgement .9 4.2.3 Funct
9、ional Requirements 9 4.3 Reset Application Session Timer .10 4.3.1 Service Request 10 4.3.2 Service Response 10 4.3.2.1 Positive Acknowledgement.10 4.3.2.2 Negative Acknowledgement .10 4.3.3 Functional Requirements 10 4.4 Application Session Terminated.11 4.4.1 Service Request 11 4.4.2 Service Respo
10、nse 11 4.4.3 Functional Requirements 11 5 Schema definitions .12 5.1 Start Application Session .12 5.2 Stop Application Session13 5.3 Reset Application Session Timer .14 5.4 Application Session Terminated.15 Annex A (informative): Examples.16 A.1 Starting an Application Session .16 A.1.1 Basic Examp
11、le16 A.1.2 Application Protocol Negotiation.17 A.1.3 Vendor Specific Application Information 17 A.2 Stopping an Application Session18 A.3 Resetting an Application Session Timer 18 A.4 Application Session Terminated 19 Annex B (informative): CSTA usage notes 20 History 21 ETSI ETSI TS 102 344 V1.1.1
12、(2004-07) 4 Intellectual Property Rights IPRs essential or potentially essential to the present document may have been declared to ETSI. The information pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found in ETSI SR 000 314: “Intellect
13、ual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in respect of ETSI standards“, which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web server (http:/webapp.etsi.org/IPR/home.asp). Pursuant to the ETSI IPR Policy, no investigat
14、ion, including IPR searches, has been carried out by ETSI. No guarantee can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web server) which are, or may be, or may become, essential to the present document. Foreword This Technical Specificati
15、on (TS) has been produced by ECMA on behalf of its members and those of the European Telecommunications Standards Institute (ETSI). Brief history The present document defines Ecma Application Session Services - a set of XML-based services used to establish and maintain an application session for exc
16、hanging application messages. The application session established by the present document is independent of the underlying transport protocol (TCP, HTTP, etc.) for exchanging application messages. Sessions for application protocols such as CSTA-XML (ECMA-323) may be established using the present doc
17、ument. ETSI ETSI TS 102 344 V1.1.1 (2004-07) 5 1 Scope The services defined in the present document are used to establish and maintain a relationship between an application and a server for the purpose of exchanging application messages. For the purpose of the present document this relationship is c
18、alled an application session. Application protocols, such as ECMA-323, require that an application session is established before application messages are exchanged. ECMA-269 specifies several mechanisms for establishing an application context. One possible mechanism is ACSE (ISO/IEC 8649) but since
19、ASCE uses ASN.1 encoding for its services, it is not desirable for use with XML based protocols such as ECMA-323. The present document provides an XML-based alternative for establishing application sessions. 1.1 Overview The ECMA Application Session Services consist of the following services: Start
20、Application Session. This service is used by an application to establish an application session with a server. A globally unique sessionID is returned by the server in the response message. The sessionID is used in other services to address the session as long as the session exists. Stop Application
21、 Session. This service is used by an application to stop an application session. Reset Application Session Timer. This service is used by an application to reset the timer associated with an application session. If the application timer is not reset before it expirers, the application session will b
22、e terminated. Application Session Terminated - This service is used by the server to indicate that the application session has been abnormally terminated (i.e. not via the Stop Application Session service). 1.2 Template description The services specified in clause 4 include tables that contain the f
23、ollowing columns: Parameter Name: The name that is used to reference the parameter. This corresponds to the XML element name specified in clause 5. Type: The format of the parameter. This corresponds to the XML element type used in the XML schema definition in clause 5. M/O: The Mandatory/Optional a
24、spect of the parameter. Mandatory parameters must be included in the corresponding XML instance document while optional parameters may be omitted. Description: Describes the purpose of the parameter. ETSI ETSI TS 102 344 V1.1.1 (2004-07) 6 2 Conformance This clause specifies the conformance requirem
25、ents for an application and a server to conform to the present document. 2.1 Application conformance In order to conform to the present document an application shall support the following services as follows: Sending the Start Application Session service and all of the mandatory aspects of this serv
26、ice as specified in clause 4. Sending the Stop Application Session service and all of the mandatory aspects of this service as specified in clause 4. Sending the Reset Application Session service and all of the mandatory aspects of this service as specified in clause 4. Receiving the Application Ses
27、sion Terminated service and all of the mandatory aspects of this service as specified in clause 4. Send and receive XML Instance documents according to the XML Schema specified in clause 5 in the present document for the services listed in item 1. 2.2 Server conformance In order to conform to the pr
28、esent document a server shall support the following services as follows: Receiving the Start Application Session service and all of the mandatory aspects of this service as specified in clause 4. Receiving the Stop Application Session service and all of the mandatory aspects of this service as speci
29、fied in clause 4. Receiving the Reset Application Session service and all of the mandatory aspects of this service as specified in clause 4. Sending the Application Session Terminated service and all of the mandatory aspects of this service as specified in clause 4. Send and receive XML Instance doc
30、uments according to the XML Schema specified in clause 5 in the present document for the services listed in item 1. 3 References ECMA-269: “Services for Computer Supported Telecommunications Applications (CSTA) Phase III,“ 6th edition. (June 2004). ECMA-323: “XML Protocol for Computer Supported Tele
31、communications Applications (CSTA) Phase III,“ 3rd edition. (June 2004). ISO/IEC 8649: “Information technology - Open Systems Interconnection - Service definition for the Association Control Service Element“ (1996). (This corresponds to ITU-T Recommendation X.217 1995). ETSI ETSI TS 102 344 V1.1.1 (
32、2004-07) 7 4 Service definitions 4.1 Start Application Session The Start Application Session service is used to initiate an application session between an application and a server. A globally unique identifier, called a sessionID, is returned in the positive service response that identifies the appl
33、ication session. Once an application session is established, the server must maintain information associated with the application session. When the application session is terminated, the application context information is cleared. The application session exists until: it is stopped by using a Stop A
34、pplication Session service; the session is abnormally terminated by the server as indicated by the Application Session Terminated service (e.g. due to the session timer expiry); etc. 4.1.1 Service Request Table 4.1: Start Application Session - Service Request Parameter Name Type M/O Description appl
35、icationInfo Sequence M Specifies information associated with the application requesting the application session. This information consists of: applicationID (M) a character string that identifies the application requesting the application association. applicationSpecificInfo (O) this consists of a l
36、ist of one or more implementation specific attributes associated with the application requesting the application association. requestedProtocolVersions List of character strings M Specifies one or more application protocol versions that the application wishes to use for the application association.
37、The list is ordered by highest priority protocol version first. The server shall choose the highest priority protocol version that it supports and return the chosen protocol version in the positive response. The character string specifying a specific protocol must be a globally unique string (e.g. a
38、 standardized namespace (URI) that indicates a given protocol version). requestedSessionDuration Value O Specifies the length of time (in seconds) that the application session should be maintained. The sessionDuration timer can be periodically refreshed via the Reset Application Session Timer servic
39、e. If the requestedSessionDuration is not provided the server will choose a default sessionDuration value. extensions Sequence O Specifies non-standardized information. ETSI ETSI TS 102 344 V1.1.1 (2004-07) 8 4.1.2 Service response 4.1.2.1 Positive acknowledgement Table 4.2: Start Application Sessio
40、n - Positive Service Response Parameter Name Type M/O Description sessionID Character String M Specifies the globally unique identifier associated with the application session that has been created. actualProtocolVersion Character String M Specifies the protocol version that is being used for the ap
41、plication session. This protocol version shall be one of the protocol versions specified in the service request. actualSessionDuration Value M Specifies the value for the length of time (in seconds) that the application session will be maintained by the server. This value may be less than or equal t
42、o the requestedSessionDuration in the service request. If the requestedSessionDuration is not provided in the service request, the server shall provide a default value which shall be used for the application session. extensions Sequence O Specifies non-standardized information. 4.1.2.2 Negative ackn
43、owledgement Table 4.3: Start Application Session - Negative Service Response Parameter Name Type M/O Description errorCode Character String M Specifies the type of error. Either a standardized error or an application specific error may be used. The standardized set of errors are: invalidApplicationI
44、nfo the server is unable to establish an application session due to invalid or unrecognized information in the applicationInfo parameter. requestedProtocolVersionNotSupported none of the requested protocol versions specified in the service request are supported. serverResourcesBusy the server cannot
45、 establish an application session due to internal resource constraints. maxNumberSessions the server cannot create an application session because it has reached the maximum number of allowed application sessions (e.g. license/provisioning limitations). extensions Sequence O Specifies non-standardize
46、d information. 4.1.3 Functional requirements 1) The sessionID returned in the response is used in other ECMA Application Session services to manage the application session. 2) The positive response includes the actual value of the sessionDuration used for the specified application session. This valu
47、e may be less than what the application requested in the service request. 3) For an existing session, an application can restart the sessionDuration timer by using the Reset Application Session Timer service. 4) Once the sessionDuration timer expires the server shall terminate the application sessio
48、n and clear any application context information associated with the application session. 5) Mechanisms defined outside of the present document may be used to authenticate a user before an application session is started. ETSI ETSI TS 102 344 V1.1.1 (2004-07) 9 4.2 Stop Application Session The Stop Ap
49、plication Session service is used by the application to terminate an existing application session. 4.2.1 Service Request Table 4.4: Stop Application Session - Service Request Parameter Name Type M/O Description sessionID Character String M Specifies the globally unique identifier associated with the application session that is being stopped. sessionEndReason Character String O Specifies the reason that the application session is being stopped. Either a standardized reason or an application specific reason may be used. T
