1、 Access to Additional Content for ECMA 354, Dated: June 2004 (Click here to view the publication) This Page is not part of the original publication This page has been added by IHS as a convenience to the user in order to provide access to additional content as authorized by the Copyright holder of t
2、his document Click the link(s) below to access the content and use normal procedures for downloading or opening the files. ECMA 354 Extra Files Information contained in the above is the property of the Copyright holder and all Notice of Disclaimer & Limitation of Liability of the Copyright holder ap
3、ply. If you have any questions, or need technical assistance please contact IHS Support. IHS Additional Content Page ECMA-354 1stEdition / June 2004 Application Session Services Standard ECMA-354 1stEdition / June 2004 Application Session Services Ecma International Rue du Rhne 114 CH-1204 Geneva T/
4、F: +41 22 849 6000/01 www.ecma-international.org IW ECMA-354.doc 01.07.2004 09:18 . Brief history This Standard defines Ecma Application Session Services a set of XML-based services used to establish and maintain an application session for exchanging application messages. The application session est
5、ablished by this Standard 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 this Standard. This Ecma Standard has been adopted by the General Assembly of J
6、une 2004. Table of contents 1 Scope 1 1.1 Overview 1 1.2 Template Description 2 Conformance 1 2.1 Application Conformance 2.2 Server Conformance 2 3 Informative References 4 Service Definitions 3 4.1 Start Application Session 4.1.1 Service Request 3 4.1.2 Service Response 4 4.1.3 Functional Requirem
7、ents 4.2 Stop Application Session 5 4.2.1 Service Request 5 4.2.2 Service Response 4.2.3 Functional Requirements 4.3 Reset Application Session Timer 6 4.3.1 Service Request 6 4.3.2 Service Response 4.3.3 Functional Requirements 4.4 Application Session Terminated 7 4.4.1 Service Request 7 4.4.2 Servi
8、ce Response 4.4.3 Functional Requirements 5 Schema Definitions 8 5.1 Start Application Session 5.2 Stop Application Session 10 5.3 Reset Application Session Timer 12 5.4 Application Session Terminated 14 Annex A (informative) - Examples 15 Annex B (informative) - CSTA Usage Notes 19 - i - 1 Scope Th
9、e services defined in this Standard 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 this Standard this relationship is called an application session. Application protocols, such as ECMA-323,
10、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 ASCE uses ASN.1 encoding for its services, it is not desirable for use
11、with XML based protocols such as ECMA-323. This Standard provides an XML-based alternative for establishing application sessions. 1.1 Overview The Ecma Application Session Services consist of the following services: Start Application Session. This service is used by an application to establish an ap
12、plication 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 Session. This service is used by an application to stop an application sessio
13、n. 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 be terminated. Application Session Terminated This service is used by the serve
14、r 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 following columns: Parameter Name the name that is used to reference the paramete
15、r. 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 aspect of the parameter. Mandatory parameters must be included in the corresponding
16、XML instance document while optional parameters may be omitted. Description Describes the purpose of the parameter. 2 Conformance This Clause specifies the conformance requirements for an application and a server to conform to this Standard. 2.1 Application Conformance In order to conform to this St
17、andard an application shall: 1. Support the following services as follows: a. Sending the Start Application Session service and all of the mandatory aspects of this service as specified in Clause 4. b. Sending the Stop Application Session service and all of the mandatory aspects of this service as s
18、pecified in Clause 4. - 1 - c. Sending the Reset Application Session service and all of the mandatory aspects of this service as specified in Clause 4. d. Receiving the Application Session Terminated service and all of the mandatory aspects of this service as specified in Clause 4. 2. Send and recei
19、ve XML Instance documents according to the XML Schema specified in Clause 5 in this Standard for the services listed in item 1. 2.2 Server Conformance In order to conform to this Standard a server shall: 1. Support the following services as follows: a. Receiving the Start Application Session service
20、 and all of the mandatory aspects of this service as specified in Clause 4. b. Receiving the Stop Application Session service and all of the mandatory aspects of this service as specified in Clause 4. c. Receiving the Reset Application Session service and all of the mandatory aspects of this service
21、 as specified in Clause 4. d. Sending the Application Session Terminated service and all of the mandatory aspects of this service as specified in Clause 4. 2. Send and receive XML Instance documents according to the XML Schema specified in Clause 5 in this Standard for the services listed in item 1.
22、 3 Informative References ECMA-269 Services for Computer Supported Telecommunications Applications (CSTA) Phase III, 6th edition, June 2004 ECMA-323 XML Protocol for Computer Supported Telecommunications Applications (CSTA) Phase III, 3rd edition, June 2004 ISO/IEC 8649:1996 Information technology -
23、 Open Systems Interconnection - Service definition for the Association Control Service Element (this corresponds to ITU-T Rec. X.217 1995) - 2 - 4 Service Definitions 4.1 Start Application Session The Start Application Session service is used to initiate an application session between an application
24、 and a server. A globally unique identifier, called a sessionID, is returned in the positive service response that identifies the application session. Once an application session is established, the server must maintain information associated with the application session. When the application sessio
25、n is terminated, the application context information is cleared. The application session exists until: it is stopped by using a Stop Application Session service the session is abnormally terminated by the server as indicated by the Application Session Terminated service (e.g., due to the session tim
26、er expiry) etc. 4.1.1 Service Request Table 4-1 - Start Application Session Service Request Parameter Name Type M/O Description applicationInfo Sequence M Specifies information associated with the application requesting the application session. This information consists of: applicationID (M) a chara
27、cter string that identifies the application requesting the application association. applicationSpecificInfo (O) this consists of a list of one or more implementation specific attributes associated with the application requesting the application association. requestedProtocolVersions List of characte
28、r strings M Specifies one or more application protocol versions that the application wishes to use for the application association. 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 pro
29、tocol version in the positive response. The character string specifying a specific protocol must be a globally unique string (e.g., a standardized namespace (URI) that indicates a given protocol version). requestedSessionDuration Value O Specifies the length of time (in seconds) that the application
30、 session should be maintained. The sessionDuration timer can be periodically refreshed via the Reset Application Session Timer service. If the requestedSessionDuration is not provided the server will choose a default sessionDuration value. extensions Sequence O Specifies non-standardized information
31、. - 3 - 4.1.2 Service Response 4.1.2.1 Positive Acknowledgement Table 4-2 - Start Application Session 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. act
32、ualProtocolVersion Character String M Specifies the protocol version that is being used for the application 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) tha
33、t the application session will be maintained by the server. This value may be less than or equal to 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 applic
34、ation session. extensions Sequence O Specifies non-standardized information. 4.1.2.2 Negative Acknowledgement 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 a
35、n application specific error may be used. The standardized set of errors are: invalidApplicationInfo the server is unable to establish an application session due to invalid or unrecognized information in the applicationInfo parameter. requestedProtocolVersionNotSupported none of the requested protoc
36、ol versions specified in the service request are supported. serverResourcesBusy the server cannot 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
37、sessions (e.g. license/provisioning limitations). extensions Sequence O Specifies non-standardized 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 inclu
38、des the actual value of the sessionDuration used for the specified application session. This value 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 ser
39、vice. 4. Once the sessionDuration timer expires the server shall terminate the application session and clear any application context information associated with the application session. - 4 - 5. Mechanisms defined outside of this Standard may be used to authenticate a user before an application sess
40、ion is started. 4.2 Stop Application Session The Stop Application 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 Speci
41、fies 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. The standardized set
42、of reasons are: normal the application is no longer interested in maintaining this application association. extensions Sequence O Specifies non-standardized information. 4.2.2 Service Response 4.2.2.1 Positive Acknowledgement Table 4-5 - Stop Application Session Positive Service Response Parameter N
43、ame Type M/O Description extensions Sequence O Specifies non-standardized information. 4.2.2.2 Negative Acknowledgement Table 4-6 - Stop Application Session Negative Service Response Parameter Name Type M/O Description errorCode Character String M Specifies the type of error. Either a standardized e
44、rror or an application specific error may be used. The standardized set of errors are: invalidSessionID the sessionID is not valid or known by the server. extensions Sequence O Specifies non-standardized information. 4.2.3 Functional Requirements 1. If the server does not recognize the sessionID in
45、the service request it shall provide a negative service response with the error code “invalidSessionID”. - 5 - 4.3 Reset Application Session Timer The Reset Application Session Timer service is used by the application to reset the duration that an existing application session should be maintained. 4
46、.3.1 Service Request Table 4-7 - Reset Application Session Timer Service Request Parameter Name Type M/O Description sessionID Character String M Specifies the globally unique identifier associated with the application session whose timer is being reset. requestedSessionDuration Value O Specifies th
47、e new value for the length of time (in seconds) that the application requests that the server maintain the application session. extensions Sequence O Specifies non-standardized information. 4.3.2 Service Response 4.3.2.1 Positive Acknowledgement Table 4-8 - Reset Application Session Timer Positive S
48、ervice Response Parameter Name Type M/O Description actualSessionDuration Value M Specifies the new 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 to the requestedSessionDuration in the service request. If
49、 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.3.2.2 Negative Acknowledgement Table 4-9 - Reset Application Session Timer 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 stand
