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

1、ii ATIS-0300002.2018 (Revision of ATIS-0300002.2013) American National Standard for Telecommunications XML Schema Interface for POTS Service Test Alliance for Telecommunications Industry Solutions Approved June 2018 American National Standards Institute, Inc. Abstract This standard provides an XML s

2、chema information model for POTS Service Test based on ATIS-0300262.2007 and an XML schema interface for POTS Service Test function specified in the same ANSI standard. ATIS-0300002.2018 iii Foreword The information contained in this Foreword is not part of this American National Standard (ANS) and

3、has not been processed in accordance with ANSIs requirements for an ANS. As such, this Foreword may contain material that has not been subjected to public review or a consensus process. In addition, it does not contain requirements necessary for conformance to the Standard. The Alliance for Telecomm

4、unication Industry Solutions (ATIS) serves the public through improved understanding between carriers, customers, and manufacturers. The Telecom Management and Operations Committee (TMOC) formerly T1M1 -develops operations, administration, maintenance and provisioning standards, and other documentat

5、ion related to Operations Support System (OSS) and Network Element (NE) functions and interfaces for communications networks - with an emphasis on standards development related to U.S.A. communication networks in coordination with the development of international standards. ANSI guidelines specify t

6、wo categories of requirements: mandatory and recommendation. The mandatory requirements are designated by the word shall and recommendations by the word should. Where both a mandatory requirement and a recommendation are specified for the same criterion, the recommendation represents a goal currentl

7、y identifiable as having distinct compatibility or performance advantages. Suggestions for improvement of this document are welcome. They should be sent to the Alliance for Telecommunications Industry Solutions, TMOC, 1200 G Street NW, Suite 500, Washington, DC 20005. At the time it approved this do

8、cument, TMOC, which is responsible for the development of this Standard, had the following leadership: P. Galarza, TMOC Chair (iconectiv) T. Barrett, Technical Editor (AT Conventions for the Definition of OSI Services.6 ITU-T Recommendation X.680 | ISO/IEC 8824-1, Information technology - Abstract S

9、yntax Notation One (ASN.1): Specification of Basic Notation.6ITU-T Recommendation X.690, Information Technology - ASN.1 Encoding Rules: Specification of Basic Encoding Rules (BER), Canonical Encoding Rules (CER), and Distinguished Encoding Rules (DER).6 ITU-T Recommendation X.701 | ISO/IEC 10040, In

10、formation Technology - Open Systems Interconnection - System Management Overview.6 ITU-T Recommendation X.721 | ISO/IEC 10165-2, Information Technology - Open Systems Interconnection - Structure of Management Information: Definition of Management Information.6 ITU-T Recommendation X.722 | ISO/IEC 10

11、165-4, Information technology - Open Systems Interconnection - Structure of management information: Guidelines for the definition of managed objects.6 ITU-T Recommendation X.730 | ISO/IEC 10164-1, Information technology - Open Systems Interconnection - Systems Management: Object management function.

12、6 7This document is available from the Alliance for Telecommunications Industry Solutions (ATIS) at . 8This document is available from the Alliance for Telecommunications Industry Solutions (ATIS) at . 9This document is available from the Alliance for Telecommunications Industry Solutions (ATIS) at

13、. 10This document is available from the Alliance for Telecommunications Industry Solutions (ATIS) at . 11This document is available from the Alliance for Telecommunications Industry Solutions (ATIS) at . ATIS-0300002.2018 5 3 Definitions 3.1 Agent: As defined in ISO/IEC 10040, the System Management

14、Overview. 3.2 Customer: User, leaser, or purchaser of a service (e.g., subscriber, end user). 3.3 End User: End user is the user of the service. 3.4 Facility: A facility is a DS1/DS3 service type between a customer-designated premise and a SWC where multiplexing is provided. 3.5 Jurisdiction: Refers

15、 to the functional separation of telecommunications networks. A jurisdiction is one of the following four types: 1. Local Exchange Carrier Network; 2. Interexchange Carrier Network; 3. End User Network; or 4. Some combination of the above. 3.6 Manager: As defined in ISO/IEC 10040, the System Managem

16、ent 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), and from a customer premise to a switch or a node (CLS). 3.8 Service Customer: The service customer is anyon

17、e 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.9 Service Provider: The service provider is anyone who offers a standard interface to allow network management

18、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 Services The service customer must be able to request that the service provider perform a test on a POTS service.

19、 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 of the following: a) full b) quick c) central office d) loop e) startTone f) stopTone 2. The POTS service to t

20、est. 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 POTS telephone number. Upon receipt of a test request, the service provider will perform the test on the POTS ser

21、vice. 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 number of retries is up to the implementation. Alternatively, the service provider may return an error stating the

22、 service is in use and discontinue processing the request. The service ATIS-0300002.2018 6 provider may return an error stating that the service customer is not authorized to request a test for this service. If a trouble report exists for the service, the service provider may return an error stating

23、 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: 1. The test results, which include: a) A summary description of the test results. For a startTone, insure that th

24、e 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 removed. b) For a quick test, include: i) Optionally, DC Signature results: Tip to ground resistance. Tip to groun

25、d 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 resistance. Tip to ring resistance. iii) Optionally, balance results: Capacitive (percent). Longitudinal (decibels).

26、 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 resistance. Tip to ground voltage. Ring to ground resistance. Ring to ground voltage. Tip to ring resistance. ii) O

27、ptionally, AC Signature results: Ringers. Tip to ground resistance. Ring to ground resistance. Tip to ring resistance. iii) Optionally, Balance results: Capacitive (percent). Longitudinal (decibels). iv) Optionally, central office results: Line circuit status (character string). ATIS-0300002.2018 7

28、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 resistance. ii) Optionally, AC Signature results: Number of ringers. Tip to ground resistance.

29、 Ring to ground resistance. Tip to ring resistance. iii) Optionally, Balance results: Capacitive (percent). Longitudinal (decibels). iv) Optionally, central office results: Line circuit status (character string). Dial tone status (character string). e) For a full test, optionally include quick, cent

30、ral 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 from requesting tests on services. Authentication of the entity requesting the test is required to ensure that a

31、ccess control can be performed. 5 POTS Service Test: UML WITH SYNTAX STF.TroubleRepairInProgress; BEHAVIOUR troubleRepairInProgressBehaviour BEHAVIOUR DEFINES AS “This parameter is used in the case where the test performer does not allow the test requester to request tests on services for which trou

32、ble has been reported.”; REGISTERED AS stfParameter 2; GraphicStringType(f ro m t ML -T A B a se)TroubleRepairInProgressTypeATIS-0300002.2018 14 ASN.1 Notation TroubleRepairInProgress:=GraphicString ATIS-0300002.2018 15 5.2 POTS Service Test Service Mapping Rules The tML Service Test interface is de

33、veloped 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 lists comparisons between the tML Service Test interface and POTS Service Test funct

34、ion and parameters specified in Informative Annex A. Table 5.6 - Comparison between Service Test Function/Service and the tML Service Test Interface POTS Test Functional Unit Service Test Action and Parameters XML Interface Uncontrolled POTS Test TestRequestUncontrolled M_ACTION potsUncontrolledTest

35、Request potsUncontrolledTestResults POTSUncontrolledTestRequest/Response ATIS-0300002.2018 16 Table 5.7 - Service Test Function for POTS Services Request/Response Excerpt from ATIS-0300262 UML Model (Request) Schema (Request) 5.1.1 Service Test Function for POTS Services The request can only be for

36、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 TestRequestUncontrolledInfo in the M-ACTION request will contain the following: 1)

37、 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 UncontrolledTestRequest ACTION. 6.8.1.2 Template potsUncontrolledTestRequest PARAMETER CONTEXT Te

38、st-ASN1Module. TestRequestUncontrolledInfo. testCategoryInformation; WITH SYNTAX STF.PotsTestRequest; BEHAVIOUR potsUncontrolledTestRequestBehaviour BEHAVIOUR DEFINED AS “This parameter is used to request the service test function to be performed on a POTS service”; REGISTERED AS stfParameter 1; POT

39、SUncontrolledTestRequest Customer : IdentityType TestRequestType : PotsTestRequestType ManagedObjectInstance : ManagedObjectInstanceTypeATIS-0300002.2018 17 Table 5.7 - Service Test Function for POTS Services Request/Response (cont) Excerpt from ATIS-0300262 UML Model (Response) Schema (Response) 5.

40、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 fails, a description of possible corrective actions. 6.1.1 Support of the Te

41、st 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 parameter is used to convey the results of a test performed on a POTS servic

42、e when using the UncontrolledTestRequest ACTION 6.8.2.2 Template potsUncontrolledTestResults PARAMETER CONTEXT Test-ASN1Module. TestRequestUncontrolledResult. additionalInformation; WITH SYNTAX STF.PotsTestResults; BEHAVIOUR potsUncontrolledTestResultsBehaviour BEHAVIOUR DEFINED AS “This parameter c

43、ontains the result of the service test function to be performed on a POTS service”; REGISTERED AS stfParameter 1; POTSUncontrolledTestResponse ManagedObjectInstance : ManagedObjectInstanceType AdditionalText : GraphicStringType PotsTestResponse : PotsTestReplyTypePotsTestReplyTypeNormal : PotsTestRe

44、sultsTypeException : ExceptionPotsTestTypeATIS-0300002.2013 18 5.3 UML Diagrams for tML Service Test Base 5.3.1 Attribute Types & Data Types Used in POTS Service Test Figure 5.1 - Data Types Used in POTS Service Test GraphicStringType(from tM L-T ABase)PercentTypePotsTestRequestTypeFull : 1Quick : 2

45、CentralOffice : 3Loop : 4StartTone : 5StopTone : 6CentralOfficeTestResultsTypeDecibelsTypeKiloOhmsTypeLengthTypeVoltsTypeTroubleRepairInProgressTypeServiceInUseTypeLoopTypeTotalLoop : LengthTypeOpenDistanceFromCentralOffice : LengthTypeAcSignatureType Ringers : Integer TipToRingResistance : KiloOhms

46、Type TipToGroundResistance : KiloOhmsType RingToGroundResistence : KiloOhmsTypeDc Si gnat ure Ty pe TipToRingResistance : KiloOhmsType TipToGroundResistance : KiloOhms Type TipToGroundVolts : V oltsType RingToGroundRes istance : KiloOhmsType RingToGroundVolts : VoltsTypeFullTestResultsType DcSignatu

47、re : DcS ignatureType AcSignature : AcS ignatureType CentralOffice : CentralOfficeType Balance : BalanceType Loop : LoopTypeCentralOfficeType LineCircuitStatus : GraphicStringType DialToneStatus : GraphicStringTypeBalanceType Capacitive : PercentType Longitudinal : DecibelsTypePotsTestResultsChoiceT

48、ypeFull : FullTestResultsTypeQuick : QuickTestResultsTypeCentralOffice : CentralOfficeTestResultsTypeLoop : LoopTestResultsTypeStartTone : StartToneTestResultsTypeStopTone : StopToneTestResultsTypeLoopTestResultsTypeQuickTestResultsType DcSignature : DcSignatureType AcSignature : AcSignatureType Bal

49、ance : BalanceType Loop : LoopTypePotsTestResultsType Summary : GraphicStringType Results : PotsTestResultsChoiceTypeExc eptionGenericType AccessDenied : AccessDeniedType InvalidDataReceived : InvalidDataReceivedType ProcessingFailure : ProcessingFailureErrorType DuplicatedInvocation : DuplicatedInvocationType ResourceLimitation : ResouceLimitationType InvalidFunctionReceived : InvalidFunctionReceivedType(from tM L-T ABase)ExceptionPotsTestType NotFound : NotFoundType Mis