ATIS 0300002-2013 XML Schema Interface for POTS Service Test.pdf

1、 AMERICAN NATIONAL STANDARD FOR TELECOMMUNICATIONS ATIS-0300002.2013 XML SCHEMA INTERFACE FOR POTS SERVICE TEST As a leading technology and solutions development organization, ATIS brings together the top global ICT companies to advance the industrys most-pressing business priorities. Through ATIS c

2、ommittees and forums, nearly 200 companies address cloud services, device solutions, emergency services, M2M communications, cyber security, ehealth, network evolution, quality of service, billing support, operations, and more. These priorities follow a fast-track development lifecycle from design a

3、nd innovation through solutions that include standards, specifications, requirements, business use cases, software toolkits, and interoperability testing. ATIS is accredited by the American National Standards Institute (ANSI). ATIS is the North American Organizational Partner for the 3rd Generation

4、Partnership Project (3GPP), a founding Partner of oneM2M, a member and major U.S. contributor to the International Telecommunication Union (ITU) Radio and Telecommunications sectors, and a member of the Inter-American Telecommunication Commission (CITEL). For more information, visit . AMERICAN NATIO

5、NAL STANDARD Approval of an American National Standard requires review by ANSI that the requirements for due process, consensus, and other criteria for approval have been met by the standards developer. Consensus is established when, in the judgment of the ANSI Board of Standards Review, substantial

6、 agreement has been reached by directly and materially affected interests. Substantial agreement means much more than a simple majority, but not necessarily unanimity. Consensus requires that all views and objections be considered, and that a concerted effort be made towards their resolution. The us

7、e of American National Standards is completely voluntary; their existence does not in any respect preclude anyone, whether he has approved the standards or not, from manufacturing, marketing, purchasing, or using products, processes, or procedures not conforming to the standards. The American Nation

8、al Standards Institute does not develop standards and will in no circumstances give an interpretation of any American National Standard. Moreover, no person shall have the right or authority to issue an interpretation of an American National Standard in the name of the American National Standards In

9、stitute. Requests for interpretations should be addressed to the secretariat or sponsor whose name appears on the title page of this standard. CAUTION NOTICE: This American National Standard may be revised or withdrawn at any time. The procedures of the American National Standards Institute require

10、that action be taken periodically to reaffirm, revise, or withdraw this standard. Purchasers of American National Standards may receive current information on all standards by calling or writing the American National Standards Institute. Notice of Disclaimer 2. Interexchange Carrier Network; 3. End

11、User Network; or 4. Some combination of the above. 3.6 Manager: As defined in ISO/IEC 10040, the System Management Overview. 3.7 Service: Any connection provided between two designated customer locations. There are several types of services: Common Language Facility (CLF) to an end-user premise (CLS

12、), and from a customer premise to a switch or a node (CLS). 3.8 Service Customer: The service customer is anyone who chooses to use the OS-to-OS interface to do network management across jurisdictions to achieve control of telecommunications services (or resources) provided by a service provider. 3.

13、9 Service Provider: The service provider is anyone who offers a standard interface to allow network management across jurisdictions of telecommunications services (or resources) they provide. The service provider acts in the agent role. 4 Functional Requirements 4.1 Service Test Function for POTS Se

14、rvices The service customer must be able to request that the service provider perform a test on a POTS service. The request can only be for a test on a single POTS service. The request from the service customer contains the following information: 1. The type of test to be performed, which can be one

15、 of the following: a) full b) quick c) central office d) loop e) startTone f) stopTone 2. The POTS service to test. The service is identified directly by sending the name of the POTS service (i.e., telephone number). Lineshare services may be identified by the Serial circuit ID rather than by the PO

16、TS telephone number. Upon receipt of a test request, the service provider will perform the test on the POTS service. If the service is currently in use, the service provider may notify the service customer that the service is in use and the service provider will be attempting the test again. The num

17、ber of retries is up to the implementation. Alternatively, the service provider may return an error stating the service is in use and discontinue processing the request. The service provider may return an error stating that the service customer is not authorized to request a test for this service. I

18、f a trouble report exists for the service, the service provider may return an error stating that testing cannot be performed while trouble repair is in progress. When the test is completed the results will be returned to the service customer. The results contain the following: ATIS-0300002.2013 5 1.

19、 The test results which include: a) A summary description of the test results. For a startTone, insure that the summary indicates that tone has been placed on the TN specified as the Service Id in the Service Test Request; for a stopTone, insure that the summary indicates that the tone has been remo

20、ved. b) For a quick test, include: i) Optionally, DC Signature results: Tip to ground resistance. Tip to ground voltage. Ring to ground resistance. Ring to ground voltage. Tip to ring resistance. ii) Optionally, AC Signature results: Number of ringers. Tip to ground resistance. Ring to ground resist

21、ance. Tip to ring resistance. iii) Optionally, balance results: Capacitive (percent). Longitudinal (decibels). iv) Optionally, loop results, one of the following: Total loop. Open distance from the central office. c) For a central office test: i) Optionally, DC Signature results: Tip to ground resis

22、tance. Tip to ground voltage. Ring to ground resistance. Ring to ground voltage. Tip to ring resistance. ii) Optionally, AC Signature results: Ringers. Tip to ground resistance. Ring to ground resistance. Tip to ring resistance. iii) Optionally, Balance results: Capacitive (percent). Longitudinal (d

23、ecibels). iv) Optionally, central office results: Line circuit status (character string). Dial tone status (character string). d) For a loop test: i) Optionally, DC Signature results: Tip to ground resistance. Tip to ground voltage. Ring to ground resistance. Ring to ground voltage. Tip to ring resi

24、stance. ii) Optionally, AC Signature results: Number of ringers. Tip to ground resistance. Ring to ground resistance. Tip to ring resistance. iii) Optionally, Balance results: Capacitive (percent). Longitudinal (decibels). ATIS-0300002.2013 6 iv) Optionally, central office results: Line circuit stat

25、us (character string). Dial tone status (character string). e) For a full test, optionally include quick, central office, and loop results. 2. Optionally, if the test fails, a description of possible corrective actions. 4.2 Security Requirements Access control should prevent unauthorized entities fr

26、om requesting tests on services. Authentication of the entity requesting the test is required to ensure that access control can be performed. 5 POTS Service Test: UML WITH SYNTAX STF.TroubleRepairInProgress; BEHAVIOUR troubleRepairInProgressBehaviour BEHAVIOUR DEFINES AS “This parameter is used in t

27、he case where the test performer does not allow the test requester to request tests on services for which trouble has been reported.”; REGISTERED AS stfParameter 2; GraphicStringType(from tML-TABase)TroubleRepairInProgressTypeASN.1 Notation TroubleRepairInProgress:=GraphicString ATIS-0300002.2013 13

28、 5.2 POTS Service Test Service Mapping Rules The tML Service Test interface is developed based on the analysis on uncontrolled POTS Service Test service definitions in Informative Annex A The tML Service Test interface consists of two message categories: Request and Response. The following table lis

29、ts comparisons between the tML Service Test interface and POTS Service Test function and parameters specified in Informative Annex A. Table 6 - Comparison between Service Test Function/Service and the tML Service Test Interface POTS Test Functional Unit Service Test Action and Parameters XML Interfa

30、ce Uncontrolled POTS Test TestRequestUncontrolled M_ACTION potsUncontrolledTestRequest potsUncontrolledTestResults POTSUncontrolledTestRequest/Response ATIS-0300002.2013 14 Table 7 - Service Test Function for POTS Services Request/Response Excerpt from ATIS-0300262 UML Model (Request) Schema (Reques

31、t) 5.1.1 Service Test Function for POTS Services The request can only be for a single POTS service. The request from the service customer contains the following information: 1. The type of test to be performed 2. The POTS service to test 6.1.1 Support of the Test Function for POTS Services The TestR

32、equestUncontrolledInfo in the M-ACTION request will contain the following: 1) The testCategoryInformation 6.8.1 potsUncontrolledTestRequest 6.8.1.1 Description The potsUncontrolledTestRequest parameter is used to convey the type of test to performon a POTS service when using the UncontrolledTestRequ

33、est ACTION. 6.8.1.2 Template potsUncontrolledTestRequest PARAMETER CONTEXT Test-ASN1Module. TestRequestUncontrolledInfo. testCategoryInformation; WITH SYNTAX STF.PotsTestRequest; BEHAVIOUR potsUncontrolledTestRequestBehaviour BEHAVIOUR DEFINED AS “This parameter is used to request the service test f

34、unction to be performed on a POTS service”; REGISTERED AS stfParameter 1; POTSUncontrolledTestRequest Customer : IdentityType TestRequestType : PotsTestRequestType ManagedObjectInstance : ManagedObjectInstanceTypeATIS-0300002.2013 15 Table 7 - Service Test Function for POTS Services Request/Response

35、 (cont) Excerpt from ATIS-0300262 UML Model (Response) Schema (Response) 5.1.1 Service Test Function for POTS Services When the test is completed, the results will be returned to the service customer. The results contain the following: 1. The test results, which include: 2. Optionally, if the test f

36、ails, a description of possible corrective actions. 6.1.1 Support of the Test Function for POTS Services The TestRequestUncontrolledInfo in the M-ACTION reply will contain the following: 1) testOutcome field will 6.8.2 potsUncontrolledTestResults 6.8.2.1 Description The potsUncontrolledTestResults p

37、arameter is used to convey the results of a test performed on a POTS service when using the UncontrolledTestRequest ACTION 6.8.2.2 Template potsUncontrolledTestResults PARAMETER CONTEXT Test-ASN1Module. TestRequestUncontrolledResult. additionalInformation; WITH SYNTAX STF.PotsTestResults; BEHAVIOUR

38、potsUncontrolledTestResultsBehaviour BEHAVIOUR DEFINED AS “This parameter contains the result of the service test function to be performed on a POTS service”; REGISTERED AS stfParameter 1; POTSUncontrolledTestResponse ManagedObjectInstance : ManagedObjectInstanceType AdditionalText : GraphicStringTy

39、pe PotsTestResponse : PotsTestReplyTypePotsTestReplyTypeNormal : PotsTestResultsTypeException : ExceptionPotsTestTypeATIS-0300002.2013 16 5.3 UML Diagrams for tML Service Test Base 5.3.1 Attribute Types & Data Types Used in POTS Service Test GraphicStringType(from tM L-T ABase)PercentTypePotsTestReq

40、uestTypeFull : 1Quick : 2CentralOffice : 3Loop : 4StartTone : 5StopTone : 6CentralOfficeTestResultsTypeDecibelsTypeKiloOhmsTypeLengthTypeVoltsTypeTroubleRepairInProgressTypeServiceInUseTypeLoopTypeTotalLoop : LengthTypeOpenDistanceFromCentralOffice : LengthTypeAcSignatureType Ringers : Integer TipTo

41、RingResistance : KiloOhmsType TipToGroundResistance : KiloOhmsType RingToGroundResistence : KiloOhmsTypeDc Si gnat ure Type TipToRingResistance : KiloOhmsType TipToGroundResistance : KiloOhms Type TipToGroundVolts : V oltsType RingToGroundResistance : KiloOhmsType RingToGroundVolts : VoltsTypeFullTe

42、stResultsType DcSignature : DcS ignatureType AcSignature : AcS ignatureType CentralOffice : CentralOfficeType Balance : BalanceType Loop : LoopTypeCentralOfficeType LineCircuitStatus : GraphicStringType DialToneStatus : GraphicStringTypeBalanceType Capacitive : PercentType Longitudinal : DecibelsTyp

43、ePotsTestResultsChoiceTypeFull : FullTestResultsTypeQuick : QuickTestResultsTypeCentralOffice : CentralOfficeTestResultsTypeLoop : LoopTestResultsTypeStartTone : StartToneTestResultsTypeStopTone : StopToneTestResultsTypeLoopTestResultsTypeQuickTestResultsType DcSignature : DcSignatureType AcSignatur

44、e : AcSignatureType Balance : BalanceType Loop : LoopTypePotsTestResultsType Summary : GraphicStringType Results : PotsTestResultsChoiceTypeExceptionGenericType AccessDenied : AccessDeniedType InvalidDataReceived : InvalidDataReceivedType ProcessingFailure : ProcessingFailureErrorType DuplicatedInvo

45、cation : DuplicatedInvocationType ResourceLimitation : ResouceLimitationType InvalidFunctionReceived : InvalidFunctionReceivedType(from tM L-T ABase)ExceptionPotsTestType NotFound : NotFoundType MissingData : MissingDataType ServiceInUse : ServiceInUseType TroubleRepairInProgress : TroubleRepairInPr

46、ogressTypePotsTestReplyTypeNormal : PotsTestResultsTypeException : ExceptionPotsTestTypeGraphicStringType(from tM L-T ABase)StartToneTes tResultsTypeStopToneTestResultsTypeFigure 1 - Data Types Used in POTS Service Test ATIS-0300002.2013 17 5.4 POTS Service Test XML Schemas 5.4.1 Overview of tML Ser

47、viceTest Schema Packages 5.4.1.1 tML ServiceTest Schema Packages The suggested tML Service Test schema packages dependency is the following: tML-ServiceTesttML-ServiceTestBasetML-TABaseFigure 2 - Data Types Used in POTS Service Test The impact of the dependencies in tML Service Test and tML TABase S

48、chemas is shown in the following subclauses. 5.4.1.2 tML-ServiceTest Package Wu Liu 08-05-2002 This schema contains uncontrolled POTS Service Test service ATIS-0300262.2007 ATIS-0300002.2013 18 5.4.1.3 tML-ServiceTestBase Package Wu Liu 08-05-2002 This schema contains Attribute Types defined in ATIS

49、- 0300262.2007 and related documents. It also provides data types used in POTS Service Test services (tML-ServiceTest schema) ATIS-0300262.2007 ATIS-0300002.2013 19 5.5 Schema for tML-ServiceTest 5.5.1 Request Portion75.5.2 Response Portion 5.6 Schema for tML ServiceTestBase 5.6.1 Attribute Types 7Message Identification (commonly known as Request Id) is used to correlate a request and a corresponding response for a specific tML message exchanged between a Service Provide