ŠĻą”±į > ž’ \ ^ ž’’’ W X Y Z [ ł & č } Ū ’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’’ģ„Į Ā ųæ Ō< bjbjĢĢ >Ö ®š ®š ś& ņ ē
’’ ’’ ’’ · lQ lQ ±^ ±^ h h h ’’’’ „h „h „h 8 Żh ¤ j Ä „h ų r Eo l
±y p !z !z !z £ø ņæ x ģ6 Æ x ÷ ÷ ÷ ÷ ÷ ÷ ÷ , zü ² ,’ ÷ h łŹ ’² ¤ £ø łŹ łŹ ÷ QĢ ±^ ±^ !z !z Ž8 Ā÷ QĢ QĢ QĢ łŹ ¾ ±^ !z h !z ÷ QĢ łŹ ÷ QĢ QĢ )ķ l Ńe Ą =š ’’’’ P:f8ŲĻ ’’’’ ·Ė ī k÷ Ų÷ 0 ų ļ ( 2 QĢ 2 X =š QĢ =š h Kõ łŹ łŹ łŹ ÷ ÷ QĢ łŹ łŹ łŹ ų ’’’’ ’’’’ ’’’’ ’’’’ ’’’’ ’’’’ ’’’’ ’’’’ ’’’’ ’’’’ ’’’’ ’’’’ ’’’’ ’’’’ ’’’’ ’’’’ ’’’’ 2 łŹ łŹ łŹ łŹ łŹ łŹ łŹ łŹ łŹ lQ w] :
Maintenance Ticketing Gateway
CenturyLink
Interface Specification
September 25, 2014
For MTG Software Version 1.7
Versioning
All releases of this document are listed in chronological order.
There is no relationship between the document number and the software release number.
Document ReleaseDateDescription0.1August 5, 2011Early draft.
An official documentation review will be held at a later date to review the details of this document.0.2August 24, 2011The document is ready for official documentation review.1.0September 2, 2011The document is published.
Technical corrections are in Appendix A.
Added notes to last two rows of the table in Section 3, MTG Ticketing System XSD Usage.
Added missing ACKs to diagrams in Section 1.5, Customer-CenturyLink MTG Transactions.
Added sentence (Please refer to the MTG Implementation Document for additional required elements by transaction.) to Section 4, Required Data, Per Transaction.
Restructured version numbering system to show this version as release 1.0 and previous versions as point releases/drafts.1.1September 21, 2011Updated tML-TABase.xsd1.2October 8, 2012Updated Section 6.2, Response Normal (Full TestRequestType is 1)1.3 DraftDecember 19, 2012Added clarification to Authentication section(2.3.1) and Response WSDL section(2.4.2).1.3 FinalJanuary 18, 2013Added clarification to Authentication section(2.3.1) and Response WSDL section(2.4.2). For production March 4, 20131.4 DraftFebruary 26, 2013Added clarification to the Authentication section (2.3.1). For production April 20, 20131.4 FinalMarch 15, 2013Added clarification to the Authentication section (2.3.1). For production April 20, 20131.5 DraftApril 19, 2013Added clarification to the TrackID information in section 2.4.4. For June 30, 20131.5 FinalMay 16, 2013Added clarification to the TrackID information in section 2.4.4. For June 30, 20131.6 DraftJune 11, 2014Updated the examples of tML-TA for GMT with the suffix Z in Sections 5.2, 5.8, 5.13.1, 5.13.2, 5.13.3, 5.13.4 and 5.13.5. 1.7 Draft
August 28, 2014Document update in support of the added functionality to perform Client Self Test before creating Design repair ticket. For production date of November 09th, 2014.1.7 FinalSeptember 25, 2014Document update in support of the added functionality to perform Client Self Test before creating Design repair ticket. For production date of November 09th, 2014.
Copyright and Trademarks
( 2014 CenturyLink, Inc. All Rights Reserved. The CenturyLink mark, pathways logo and certain CenturyLink product names are the property of CenturyLink, Inc. All other marks are the property of their respective owners.
Disclaimer
This document provides an overview of a CenturyLink service. It is intended to assist users in determining the type and structure of information requested and returned by the service.
The information contained herein does not constitute an offer by CenturyLink to provide services, equipments, or materials. Any such services and items will only be provided pursuant to an effective agreement between CenturyLink and the customer.
Contents
TOC \o \f \h \z \u HYPERLINK \l "_Toc398208595" 1 Introduction PAGEREF _Toc398208595 \h 6
HYPERLINK \l "_Toc398208596" 1.1 Using these CenturyLink Business Services PAGEREF _Toc398208596 \h 7
HYPERLINK \l "_Toc398208597" 1.2 Other Documents PAGEREF _Toc398208597 \h 7
HYPERLINK \l "_Toc398208598" 1.3 Implemented Requests, Responses, and Notifications PAGEREF _Toc398208598 \h 7
HYPERLINK \l "_Toc398208599" 1.4 Mapping CenturyLink and Customer Transactions to the ATIS Services PAGEREF _Toc398208599 \h 8
HYPERLINK \l "_Toc398208600" 1.5 Customer-CenturyLink MTG Transactions PAGEREF _Toc398208600 \h 9
HYPERLINK \l "_Toc398208601" 1.5.1 Customer-initiated Create Ticket PAGEREF _Toc398208601 \h 9
HYPERLINK \l "_Toc398208602" 1.5.2 Customer-initiated Update Ticket PAGEREF _Toc398208602 \h 9
HYPERLINK \l "_Toc398208603" 1.5.3 Customer-initiated Cancel Ticket PAGEREF _Toc398208603 \h 10
HYPERLINK \l "_Toc398208604" 1.5.4 Customer-initiated Retrieve Ticket PAGEREF _Toc398208604 \h 10
HYPERLINK \l "_Toc398208605" 1.5.5 CenturyLink-initiated Update Ticket (Status/Log Notes Update) PAGEREF _Toc398208605 \h 10
HYPERLINK \l "_Toc398208606" 1.5.6 CenturyLink-initiated Cleared Ticket (Design Service) PAGEREF _Toc398208606 \h 11
HYPERLINK \l "_Toc398208607" 1.5.7 CenturyLink-initiated Cleared/Closed Ticket (POTS Service) PAGEREF _Toc398208607 \h 11
HYPERLINK \l "_Toc398208608" 2 Communication Protocol PAGEREF _Toc398208608 \h 12
HYPERLINK \l "_Toc398208609" 2.1 Communication Requirements PAGEREF _Toc398208609 \h 12
HYPERLINK \l "_Toc398208610" 2.2 Access Topology PAGEREF _Toc398208610 \h 12
HYPERLINK \l "_Toc398208611" 2.3 Security PAGEREF _Toc398208611 \h 13
HYPERLINK \l "_Toc398208612" 2.3.1 Authentication PAGEREF _Toc398208612 \h 13
HYPERLINK \l "_Toc398208613" 2.3.2 Validation of Ownership (Authorization) PAGEREF _Toc398208613 \h 14
HYPERLINK \l "_Toc398208614" 2.4 WSDL PAGEREF _Toc398208614 \h 14
HYPERLINK \l "_Toc398208615" 2.4.1 Request WSDL PAGEREF _Toc398208615 \h 14
HYPERLINK \l "_Toc398208616" 2.4.2 Response WSDL PAGEREF _Toc398208616 \h 16
HYPERLINK \l "_Toc398208617" 2.4.3 SOAP Interface PAGEREF _Toc398208617 \h 17
HYPERLINK \l "_Toc398208618" 2.4.4 tMLHeader PAGEREF _Toc398208618 \h 17
HYPERLINK \l "_Toc398208619" 2.5 Request/Response PAGEREF _Toc398208619 \h 19
HYPERLINK \l "_Toc398208620" 2.5.1 Sample SOAP Request to CenturyLink Request Web Service PAGEREF _Toc398208620 \h 19
HYPERLINK \l "_Toc398208621" 2.5.2 Sample SOAP ACK Message from CenturyLink PAGEREF _Toc398208621 \h 19
HYPERLINK \l "_Toc398208622" 2.5.3 Sample SOAP Response to Customers Result Web Service PAGEREF _Toc398208622 \h 19
HYPERLINK \l "_Toc398208623" 2.5.4 Sample SOAP ACK Message from Customers Result Web Service PAGEREF _Toc398208623 \h 19
HYPERLINK \l "_Toc398208624" 2.5.5 Sample SOAP Fault Message (NACK) from CenturyLink PAGEREF _Toc398208624 \h 19
HYPERLINK \l "_Toc398208625" 2.5.6 Sample SOAP ACK Message from CenturyLink for Full, Loop Back and Supplemental Intrusive Client Self Test PAGEREF _Toc398208625 \h 20
HYPERLINK \l "_Toc398208626" 3 MTG Ticketing System XSD Usage PAGEREF _Toc398208626 \h 21
HYPERLINK \l "_Toc398208627" 4 Required Data, Per Transaction PAGEREF _Toc398208627 \h 22
HYPERLINK \l "_Toc398208628" 4.1 RequestTroubleReportCreationRequest PAGEREF _Toc398208628 \h 22
HYPERLINK \l "_Toc398208629" 5 Examples of tML-TA for Trouble Ticketing PAGEREF _Toc398208629 \h 24
HYPERLINK \l "_Toc398208630" 5.1 RequestTroubleReportCreationRequest PAGEREF _Toc398208630 \h 24
HYPERLINK \l "_Toc398208631" 5.2 RequestTroubleReportCreationResponse PAGEREF _Toc398208631 \h 29
HYPERLINK \l "_Toc398208632" 5.3 ModifyAttributesRequest PAGEREF _Toc398208632 \h 30
HYPERLINK \l "_Toc398208633" 5.4 ModifyAttributesResponse PAGEREF _Toc398208633 \h 31
HYPERLINK \l "_Toc398208634" 5.5 CancelTroubleReportRequest PAGEREF _Toc398208634 \h 31
HYPERLINK \l "_Toc398208635" 5.6 CancelTroubleReportResponse PAGEREF _Toc398208635 \h 32
HYPERLINK \l "_Toc398208636" 5.7 RetrieveAttributesByTroubleReportIdRequest PAGEREF _Toc398208636 \h 32
HYPERLINK \l "_Toc398208637" 5.8 RetrieveAttributesByTroubleReportIdResponse PAGEREF _Toc398208637 \h 33
HYPERLINK \l "_Toc398208638" 5.9 VerifyRepairCompletionRequest PAGEREF _Toc398208638 \h 39
HYPERLINK \l "_Toc398208639" 5.10 VerifyRepairCompletionResponse PAGEREF _Toc398208639 \h 40
HYPERLINK \l "_Toc398208640" 5.11 AddTroubleInfoRequest PAGEREF _Toc398208640 \h 40
HYPERLINK \l "_Toc398208641" 5.12 AddTroubleInfoResponse PAGEREF _Toc398208641 \h 41
HYPERLINK \l "_Toc398208642" 5.13 AttributeValueChangeNotification PAGEREF _Toc398208642 \h 41
HYPERLINK \l "_Toc398208643" 5.13.1 Event Notification (Additional Trouble Status Info Added) PAGEREF _Toc398208643 \h 41
HYPERLINK \l "_Toc398208644" 5.13.2 Design Services Cleared Notification PAGEREF _Toc398208644 \h 42
HYPERLINK \l "_Toc398208645" 5.13.3 Design Services Closed Notification PAGEREF _Toc398208645 \h 44
HYPERLINK \l "_Toc398208646" 5.13.4 POTS Cleared Notification PAGEREF _Toc398208646 \h 44
HYPERLINK \l "_Toc398208647" 5.13.5 POTS Closed Notification PAGEREF _Toc398208647 \h 45
HYPERLINK \l "_Toc398208648" 6 Examples of tML for POTS Service Test PAGEREF _Toc398208648 \h 47
HYPERLINK \l "_Toc398208649" 6.1 Request PAGEREF _Toc398208649 \h 47
HYPERLINK \l "_Toc398208650" 6.2 Response Normal (Full TestRequestType is 1) PAGEREF _Toc398208650 \h 47
HYPERLINK \l "_Toc398208651" 6.3 Response Normal (Quick TestRequestType is 2) PAGEREF _Toc398208651 \h 48
HYPERLINK \l "_Toc398208652" 6.4 Response Normal (Central Office TestRequestType is 3) PAGEREF _Toc398208652 \h 49
HYPERLINK \l "_Toc398208653" 6.5 Response Normal (Loop Test TestRequestType is 4) PAGEREF _Toc398208653 \h 50
HYPERLINK \l "_Toc398208654" 7 Examples of tML for Client Self Test PAGEREF _Toc398208654 \h 52
HYPERLINK \l "_Toc398208655" 7.1 Request PAGEREF _Toc398208655 \h 52
HYPERLINK \l "_Toc398208656" 7.2 Response - Normal PAGEREF _Toc398208656 \h 52
HYPERLINK \l "_Toc398208657" 7.3 Response Error Exception PAGEREF _Toc398208657 \h 53
HYPERLINK \l "_Toc398208658" 8 Glossary PAGEREF _Toc398208658 \h 55
HYPERLINK \l "_Toc398208659" Appendix A: Corrections PAGEREF _Toc398208659 \h 56
Introduction
This document is intended for organizations wishing to implement electronic trouble ticketing capabilities with CenturyLink for the exchange of Trouble Ticket information for various CenturyLink products and services purchased by the customer.
CenturyLinks Maintenance Ticketing Gateway (MTG) provides a mechanism to automate communication and the processing of trouble ticket information. This mechanism is available for use by Wholesale customers of legacy Qwest.
MTG provides an electronic bonding facility that enables CenturyLink customers of legacy Qwest to use their own repair/ticketing system to manage troubles on their CenturyLink products and services in legacy Qwest territory. This application is used primarily to mechanically process telephone circuit repair activities including repair ticket generation, MLT (Mechanized Loop Tests) and CST (Client Self Test).
MTG is available for use only in legacy Qwest territories in the following states:
Arizona
Colorado
Idaho
Iowa
MinnesotaMontana
Nebraska
New Mexico
North Dakota
OregonSouth Dakota
Utah
Washington
Wyoming
The CenturyLink MTG Ticketing System is based on:
ATIS Standard XML Schema Interface for Fault Management (Trouble Administration), ATIS-0300003.2010, an industry standard for exchange of trouble ticket information
ATIS- 0300079 tML Transport Profile: This document recommends a Transport Profile Specification to support the Telecommunications Markup Language (tML) Framework. The intent is to facilitate the interchange of XML formatted business transactions between service requestor and service provider. MTG does not implement every detail of the transport profile, but does use many of the asynchronous concepts described within the guidelines.
XML POTS Service Test ATIS-0300002.2009, XML Schema Interface for POTS Service Test. This standard provides an XML schema 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.
This service uses Telecommunication Markup Language (tML).
Example tMLs in this document demonstrate requests, responses, and notifications for particular situations.
Using these CenturyLink Business Services
The use of the CenturyLink Maintenance Ticketing Gateway via tML provides an effective mechanism to automate the communication and processing of trouble ticket information. If you determine that your company can support a tML environment, and you would like to conduct business with CenturyLink via the CenturyLink Maintenance Ticketing Gateway (MTG), contact your CenturyLink Service Manager (SM).
This document provides business service overviews, designed to help you in understanding requests, responses, and notifications, and how those data are organized in the XSD request, response (if any), and standalone notifications.
Because this is a web services interface, there are no dedicated circuit requirements for access. Customers must have internal policies and processes in place to support sending and receiving trouble ticket transactions over the public Internet.
Other Documents
Detailed implementation specifics will be provided in the MTG Implementation Document.
Implemented Requests, Responses, and Notifications
The following requests, responses, and notifications are used:
Request/Response
RequestTroubleReportCreation
CancelTroubleReport
VerifyRepairCompletion
ModifyAttributes
RetrieveAttributesByTroubleReportId
AddTroubleInfo
POTSUncontrolledTest
Notifications
AttributeValueChangeNotification
The mapping of CenturyLink/Customer business transactions and the ATIS services shown above is detailed in the mapping section of this specification document.
Mapping CenturyLink and Customer Transactions to the ATIS Services
The table below maps transaction types to ATIS-specified services.
Transaction TypeATIS XSDCustomer Create Ticket ServicesCustomer creates a Trouble Ticket.RequestTroubleReportCreationRequestCenturyLink response that Ticket was created or that an exception occurred.RequestTroubleReportCreationResponseCustomer Update/Cancel Ticket ServicesCustomer updates attributes on ticket (e.g., notes, A loc information, authorizations, escalates, managed access hours).ModifyAttributesRequestCenturyLink acknowledges attributes were updated on ticket or that an exception occurred. ModifyAttributesResponseCustomer updates notes on ticket. (Call Log/Notes update).AddTroubleInfoRequestCenturyLink acknowledges notes were updated on ticket or that an exception occurred. (Call Log/Notes update) AddTroubleInfoResponseCustomer closes ticket.
Customer requests cancellation of ticket.CancelTroubleReportRequestCenturyLink acknowledges ticket cancel request was received ok or that an exception occurred. CancelTroubleReportResponseCustomer Retrieve Ticket ServicesCustomer Retrieve Ticket RequestRetrieveAttributesByTroubleReportIdRequestCenturyLink sends Customer Retrieve Ticket Response details or that an exception occurred.RetrieveAttributesByTroubleReportIdResponseCenturyLink Close Ticket ServicesCenturyLink sends request to close a ticket with cleared status (for Design Services see 1.5.6 information).AttributeValueChangeNotificationFor Design Services, Customer sends verification of issue resolution.VerifyRepairCompletionRequestCenturyLink acknowledges verify request was received ok or that an exception occurred.VerifyRepairCompletionResponseNotification ServicesCenturyLink sends Status Update notification (for POTS see 1.5.7 information).AttributeValueChangeNotificationCenturyLink sends a Ticket Log Update Notification (includes escalation information). AttributeValueChangeNotification
Customer-CenturyLink MTG Transactions
Customer-initiated Create Ticket
SHAPE \* MERGEFORMAT
Customer-initiated Update Ticket
SHAPE \* MERGEFORMAT
Customer-initiated Cancel Ticket
SHAPE \* MERGEFORMAT
Customer-initiated Retrieve Ticket
SHAPE \* MERGEFORMAT
CenturyLink-initiated Update Ticket (Status/Log Notes Update)
SHAPE \* MERGEFORMAT
CenturyLink-initiated Cleared Ticket (Design Service)
SHAPE \* MERGEFORMAT
CenturyLink-initiated Cleared/Closed Ticket (POTS Service)
SHAPE \* MERGEFORMAT
Communication Protocol
The CenturyLink MTG Ticketing System uses an asynchronous request/response model based on an implementation of the Alliance for Telecommunications Industry Solutions (ATIS) tML Transport Profile.
This interface has been designed to send and receive electronic transactions using SOAP over HTTP(s).
A partner sends a request to the CenturyLink Request Listener web service. CenturyLink will then validate that the request passes authentication and the XSD schema check, and return an acknowledgement or SOAPFault to the customer. This means the requester is not required to stay connected to the provider while a potentially lengthy request is processed. This approach allows for better error recovery (often without involving the business customer) and provides a more secure and robust interaction.
When a response to a customer request or an attribute value change notification for an existing ticket is ready for delivery, CenturyLink will attempt to push (send) the result to the customer. If the send fails because a customers system is not available due to planned maintenance outage or any other unexpected system or communication failure, CenturyLink will attempt one retry. If that retry fails, the payload of the failed transaction will not be delivered to the customer. The customer can later retrieve currentor latestticket attributes.
When communication is restored and verified, the customer may follow late bonding procedures described in the MTG Implementation Document to electronically bond any tickets created in CenturyLink during the outage period.
Communication Requirements
In order to transmit and receive data, CenturyLink customers must build their own XML client interface.
CenturyLink customers must have an XML Server Interface. The application is solely business to business (B2B).
CenturyLink customers must provide their own Internet access.
CenturyLink customers must abide by the CenturyLink XML Schema design.
Access Topology
The following diagram is an overview of the access topology into the CenturyLink XML Interface for electronic bonding trouble administration.
EMBED Visio.Drawing.11
Figure 1: CenturyLink Maintenance Ticketing Gateway
Security
Authentication
CenturyLink customers must have a Digital Certificate to make use of CenturyLink XML API.
MTG uses two-way Secure Socket Layer/Transport Layer Security (SSL/TLS) communication. The SOAP header is not used for transport security.
Please follow the X.509v3 standard.
For inbound transactions, the customer must send the CenturyLink-provided digital certificate.
For outbound transactions, CenturyLink will send the customer-provided digital certificate for client authentication.
CenturyLink has an additional option available to include partner provided username, password in plain text format under WSSE security header/ Usernametoken section inside SOAP header in the CenturyLink outbound request. With this option, the customer-provided digital certificate for client authentication is not required.
MTGs current implementation (both as client and server) is compliant with RFC 5746 and allows secure renegotiations. However, on outbound communication from MTG to Partner, if the partner server doesn't support secure renegotiations, MTG client has an option to turn off session reuse upon partners request.
Validation of Ownership (Authorization)
Create Request
The CenturyLink MTG gateway validates that a serviceId (circuit/TN) entered belongs to the Manager (i.e., customer) via MCN or ACNA/RSID comparison.
All Other Requests (After Successful Create Request)
The CenturyLink MTG gateway validates that a trouble report entered belongs to the Manager (i.e., customer).
WSDL
CenturyLink exposes two asynchronous WSDLs (document/literal wrapped SOAP Binding) for Request and Response / Attribute Value Change Notification (AVCN) messages compliant with SOAP 1.1 specifications.
CenturyLink uses XML Namespace to avoid name conflicts between tML definitions and application-specific definitions.
CenturyLink Implemented Web Services:
Process Report
Required Customer Implemented Web Services:
Process Result
Request WSDL
The Request WSDL exposes the operation named processReport.
The processReport operation accepts a String parameter (the SOAP request body contains the tML Request compliant with the tML-TA.xsd).
When message processing is successful, the CenturyLink hosted web service generates a synchronous acknowledgment, which means that the XML request was well formed and is a tML-TA compliant message.
Any exceptions in receiving the message will be communicated back to the customer as SOAPFaults.
Response WSDL
The Response WSDL must be implemented by the customer to be able to receive CenturyLink Response or AttributeValueChangeNotification transactions.
This WSDL exposes the operation name processResult.
The processResult accepts a String parameter (containing the Response or AttributeValueChangeNotification XML compliant with the tML-TA.xsd). This operation will be invoked by CenturyLink when sending Responses or AttributeValueChangeNotifications.
In SOAP Response to Customers Result Web Service, CenturyLink will send the payload wrapped in a CDATA section inside the resultString element.
SOAP Interface
The SOAP request body contains the tML Request. The SOAP response body contains the tML response or a fault message.
A SOAPFault will be generated whenever a schema validation error, data storage error, or other internal error occurs. The generated SOAPFault will include an Exception Description element that provides diagnostic information.
If a SOAPFault is received by the customer when invoking an operation it means request transaction was not processed by CenturyLink and it is the customers responsibility to resend the message, if appropriate.
tMLHeader
The tMLHeader is a required part of the payload for all request and responses to the CenturyLink MTG. The tML header is a part of the TCIF tML Transport Profile (per the tML Header Component of the tML Transport Profile (ATIS-0300079)), and is used to allow a customer to correlate asynchronous responses and trouble tickets with status updates.
The tMLHeader will include the following information.
Note: These formats are suggested implementations based on ATIS-0300079. The customer is responsible for the uniqueness of the CorrelationID and TrackID.
CorrelationID will be used to correlate a particular request or response with the acknowledgement. It is also used to specify the result to be retrieved. The CorrelationID must be unique for each request. Maximum size is 64 alphanumeric. Below is a suggested format of this field:
FROM field (up to 10 characters) (This is the UserId. Indicates where the request originates.)
TO field (up to 10 characters, after the FROM field) (This is CTL. Indicates the identity of the destination service provider.)
Send Timestamp field (maximum 30 characters) (Note: Time zone information is specified in this format see tML Header Schema Definition).
Static CorrelationID abbreviation String :CI: (4 characters)
Unique Number generated by originator (maximum 10 characters, recommended for uniqueness)
TrackID will be used to correlate multiple messages for a particular business transaction lifecycle, including requests, responses and acknowledgements. The TrackID is unique and persistent for the life of the ticket. MTG will allow the re-use of trackId, only if MTG fails to create and return TicketId in MTG response to the create ticket request. MTG will also allow the re-use of trackID on MLT and CST requests that failed to process in MTG. Maximum size is 64 alphanumeric. Below is a suggested format of this field:
FROM field (up to 10 characters) (This is the UserId. Indicates where the request originates.)
TO field (up to 10 characters, after the FROM field) (This is CTL. Indicates the identity of the destination service provider.)
Send Timestamp field (30 characters) (Note: Time zone information is specified in this format see tML Header Schema Definition).
Static TrackID abbreviation String :TI: (4 characters)
Unique Number generated by originator (10 characters)
Request/Response
Sample SOAP Request to CenturyLink Request Web Service
tML TA Request goes here...
Sample SOAP ACK Message from CenturyLink
Sample SOAP Response to Customers Result Web Service
tML TA Result in CDATA goes here...
Sample SOAP ACK Message from Customers Result Web Service
Sample SOAP Fault Message (NACK) from CenturyLink
SOAP-ENV:Client
Validation Error
Detailed error message here
Sample SOAP ACK Message from CenturyLink for Full, Loop Back and Supplemental Intrusive Client Self Test
Warning this is an Intrusive Test. The circuit will be taken out of service for the duration of the test
MTG Ticketing System XSD Usage
The four XSDs shown in the table below are in the embedded files below.
Note: Not all elements contained in the XSDs are supported in the MTG implementation. Please see MTG Implementation document for details.
Schema NameDescriptionNotestML-TA.xsdIndustry schema that defines TML TA interface.CenturyLink adds complex elements to the ATIS specification.tML-TABase.xsdAn industry schema that defines TML TA base elements.CenturyLink adds complex elements to the ATIS specification.tML-ServiceTest.xsdIndustry schema that defines POTS Service Test interface.Used for MLT (Mechanized Loop Tests).tML-ServiceTestBase.xsdIndustry schema that defines the POTS Service Test base elements.PotsTestRequestType of 6 (StopTone) not supported.tML-ServiceTest.xsdSchema that defines ClientSelfTest interface.Used for CST (Client Self Test).tML-ServiceTestBase.xsdSchema that defines ClientSelfTest base elements.Used for CST (Client Self Test).
EMBED Package
EMBED Package
EMBED Package
EMBED Package
Required Data, Per Transaction
Please refer to the MTG Implementation Document for additional required elements by transaction.
Most of the elements in the XSDs are optional from an XSD validation standpoint. However, CenturyLink will require some optional elements to be populated.
See XSD for other required elements along with the elements shown below.
Create Request
ManagedObjectInstance Standard Relative Distinguish Name (RDN) string values that identify networkId, accountName, and serviceId.
TroubleReportFormatId and data per 4.1 TRFD table.
All Other Requests (After Successful Create Request)
TargetObjectName Standard Relative Distinguish Name (RDN) string values that identify networkId, accountName, and troubleReportId.
RequestTroubleReportCreationRequest
The following table shows required sections and elements based on the TRFD TroubleReportFormatId element value on the create request.
Bold = elementsNon-bold = sections
Blank = Not required/applicable
TRFD1: Services with a premise address.
TRFD2: Services without a premise address.
TRFD3: Resold POTS.
ATIS Create Request Element or SectionTRFD 1TRFD 2TRFD 3RequestTroubleReportCreationRequest/
ManagedObjectInstance/Must be presentMust be presentMust be presentRequestTroubleReportCreationRequest/
TroubleType/Must be presentMust be presentMust be presentRequestTroubleReportCreationRequest/
AdditionalTroubleInfoList/Must be presentMust be presentMust be presentRequestTroubleReportCreationRequest/
AdditionalCreateInfo/
ALocationAccessAddress/
Must be present RequestTroubleReportCreationRequest/
AdditionalCreateInfo/
ALocationAccessHours/
Must be present
Must be presentRequestTroubleReportCreationRequest/
AdditionalCreateInfo/
ALocationAccessPerson/
Must be present RequestTroubleReportCreationRequest/
AdditionalCreateInfo/
AuthorizationList/
Must be present
Must be present RequestTroubleReportCreationRequest/
AdditionalCreateInfo/
CustomerTroubleTickNum
Must be present
Must be present RequestTroubleReportCreationRequest/
AdditionalCreateInfo/
EscalationList/RequestTroubleReportCreationRequest/
AdditionalCreateInfo/
ManagedObjectAccessHours/
Must be present
Must be present RequestTroubleReportCreationRequest/
AdditionalCreateInfo/
ManagerContactPerson/
Must be present
Must be present
Must be presentRequestTroubleReportCreationRequest/
AdditionalCreateInfo/
TroubleReportFormatId
Must be present
Must be present
Must be present
Examples of tML-TA for Trouble Ticketing
Note: The examples below are not an exhaustive set of attributes that could be included in each transaction. Please see the tML-TA.xsd, tML-TABase.xsd, and MTG Implementation document for details.
RequestTroubleReportCreationRequest
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:CI:1234567890
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
TELCO-INC
RESELLER
1.2.320.10015.0.6.55
networkId
4679
accountName
TELCO-INC
serviceId
26/HCGS/123456//MS
1230
Fail to loop Smartjack-5-Bit
1
Main Office
931 14th Street
Denver
CO
80202
true
false
false
false
false
false
false
08:00:00
23:59:00
false
true
false
false
false
false
false
00:00:00
23:59:00
false
false
true
false
false
false
false
00:00:00
23:59:00
false
false
false
true
false
false
false
00:00:00
23:59:00
false
false
false
false
true
false
false
00:00:00
23:59:00
false
false
false
false
false
true
false
00:00:00
23:59:00
false
false
false
false
false
false
true
00:00:00
23:59:00
TELCO-INC NOC
3035551212
2
false
false
false
true
false
false
false
false
false
false
SMITH J
3035551234
2
false
false
false
false
false
true
false
false
false
false
SMITH J
3035551234
2011-04-27T18:51:42-05:00
CUSTICK123456
1
2011-04-26T16:50:31-05:00
SMITH J
3035551234
0
true
false
false
false
false
false
false
08:00:00
23:59:00
false
true
false
false
false
false
false
00:00:00
23:59:00
false
false
true
false
false
false
false
00:00:00
23:59:00
false
false
false
true
false
false
false
00:00:00
23:59:00
false
false
false
false
true
false
false
00:00:00
23:59:00
false
false
false
false
false
true
false
00:00:00
23:59:00
false
false
false
false
false
false
true
00:00:00
23:59:00
SMITH J
3035551234
0
1
0
0
0
RequestTroubleReportCreationResponse
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:CI:1234567890
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
networkId
4679
accountName
TELCO-INC
serviceId
26/HCGS/123456//MS
2011-04-26T16:52:57Z
DE123456
1
2
2011-04-26T16:52:57Z
CTL
3035551234
2011-04-28T16:08:57Z
ModifyAttributesRequest
TELCO-INCCTL2011-04-27T10:50:31.097-05:001:CI:1234512345
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
TELCO-INC
RESELLER
networkId
4679
accountName
TELCO-INC
troubleReportId
DE123456
DE123456
Please provide status
ModifyAttributesResponse
TELCO-INCCTL2011-04-27T10:50:31.097-05:001:CI:1234512345
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
networkId
4679
accountName
TELCO-INC
troubleReportId
DE123456
CancelTroubleReportRequest
TELCO-INCCTL2011-04-29T15:50:31.097-05:001:CI:1234599999
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
TELCO-INC
RESELLER
networkId
4679
accountName
TELCO-INC
troubleReportId
DE123456
DE123456
true
This trouble report is no longer valid
My Name
3035551234
931 14th Street
Denver
CO
80202
CancelTroubleReportResponse
TELCO-INCCTL2011-04-29T15:50:31.097-05:001:CI:1234599999
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
networkId
4679
accountName
TELCO-INC
troubleReportId
DE123456
RetrieveAttributesByTroubleReportIdRequest
TELCO-INCCTL2011-04-29T17:50:31.097-05:001:CI:1234512345
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
TELCO-INC
RESELLER
networkId
4679
accountName
TELCO-INC
troubleReportId
DE123456
DE123456
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
true
RetrieveAttributesByTroubleReportIdResponse
TELCO-INCCTL2011-04-29T17:50:31.097-05:001:CI:1234512345
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
networkId
4679
accountName
TELCO-INC
troubleReportId
DE123456
INTEGRATION TESTING
5-9-11 retesting an external log update
true
false
false
false
false
false
false
08:00:00
23:59:00
false
true
false
false
false
false
false
00:00:00
23:59:00
false
false
true
false
false
false
false
00:00:00
23:59:00
false
false
false
true
false
false
false
00:00:00
23:59:00
false
false
false
false
true
false
false
00:00:00
23:59:00
false
false
false
false
false
true
false
00:00:00
23:59:00
false
false
false
false
false
false
true
00:00:00
23:59:00
Main Office
931 14th Street
Denver
CO
80202
TELCO-INC NOC
3035551212
2
false
false
false
true
false
false
false
false
false
false
SMITH J
3035551234
2
false
false
false
false
false
true
false
false
false
false
SMITH J
3035551234
2011-04-27T18:51:42Z
CUSTICK123456
1
2011-04-26T16:50:31Z
SMITH J
3035551234
0
true
false
false
false
false
false
false
08:00:00
23:59:00
false
true
false
false
false
false
false
00:00:00
23:59:00
false
false
true
false
false
false
false
00:00:00
23:59:00
false
false
false
true
false
false
false
00:00:00
23:59:00
false
false
false
false
true
false
false
00:00:00
23:59:00
false
false
false
false
false
true
false
00:00:00
23:59:00
false
false
false
false
false
false
true
00:00:00
23:59:00
networkId
4679
accountName
TELCO-INC
serviceId
26/HCGS/123456//MS
APIUSER
3035551234
2011-05-09T10:14:35Z
DE123456
1
1
2
2011-05-09T10:15:14Z
1230
VerifyRepairCompletionRequest
TELCO-INCCTL2011-04-28T15:50:31.097-05:001:CI:5432112345
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
TELCO-INC
RESELLER
networkId
4679
accountName
TELCO-INC
troubleReportId
DE123456
DE123456
1
verified fix
Smith J
3035551234
VerifyRepairCompletionResponse
TELCO-INCCTL2011-04-28T15:50:31.097-05:001:CI:5432112345
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
networkId
4679
accountName
TELCO-INC
troubleReportId
DE123456
AddTroubleInfoRequest
TELCO-INCCTL2011-05-01T18:50:31.097-05:001:CI:1234598765
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
TELCO-INC
RESELLER
networkId
4679
accountName
TELCO-INC
troubleReportId
DE123456
DE123456
Please provide status
AddTroubleInfoResponse
TELCO-INCCTL2011-05-01T18:50:31.097-05:001:CI:1234598765
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
networkId
4679
accountName
TELCO-INC
troubleReportId
DE123456
AttributeValueChangeNotification
Event Notification (Additional Trouble Status Info Added)
TELCO-INCCTL2011-04-29T14:55:31.097-05:001:CI:5432154321
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
10100
2011-04-29T14:30:06Z
networkId
4679
accountName
TELCO-INC
troubleReportId
DE123456
DE123456
TECHNICIAN HAS BEEN DISPATCHED ON YOUR TICKET.ETA : 45MIN
Design Services Cleared Notification
TELCO-INCCTL2011-04-29T12:50:31.097-05:001:CI:5432154321
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
10046
2011-04-29T12:48:06Z
networkId
4679
accountName
TELCO-INC
troubleReportId
DE123456
DE123456
0
3
30
0
0
true
false
false
false
false
false
true
false
false
false
false
0
4
30
0
0
true
false
false
false
false
false
false
false
true
false
false
Trouble Cleared Awaiting Customer Verification.
CenturyLink requests authorization to close ticket.
true
2
1
30
0
0
2011-04-29T12:48:06Z
6
3
26
2011-04-29T12:48:06Z
Design Services Closed Notification
TELCO-INCCTL2011-04-29T14:55:31.097-05:001:CI:5432154321
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
10299
2011-04-29T12:48:06Z
networkId
4679
accountName
TELCO-INC
troubleReportId
DE123456
DE123456
Trouble ticket closed.
4
27
2011-04-29T14:55:25Z
POTS Cleared Notification
TELCO-INCCTL2011-04-28T12:45:31.097-05:001:CI:5432154321
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
10250
2011-04-28T12:45:30Z
networkId
4679
accountName
TELCO-INC
troubleReportId
0654321
0654321
Trouble ticket cleared.
3
25
2011-04-28T12:45:30Z
POTS Closed Notification
TELCO-INCCTL2011-04-29T20:50:31.097-05:001:CI:5432154321
TELCO-INCCTL2011-04-26T16:50:31.097-05:001:TI:0987654321
10056
2011-04-29T20:48:06Z
networkId
4679
accountName
TELCO-INC
troubleReportId
0654321
0654321
Trouble ticket closed.
Disposition Code: 1001. Definition: CenturyLink Toll Cable Cut/Damaged. Cause Code: 600. Definition: Unknown
true
2
1
30
0
0
2011-04-28T12:45:30Z
29
4
27
2011-04-29T20:48:06Z
Examples of tML for POTS Service Test
Note: The examples below are not an exhaustive set of attributes that could be included in each transaction. Please see the tML-ServiceTest.xsd, tML-ServiceTestBase.xsd, and MTG Implementation document for details.
Request
TELCO-INCCTL2011-05-20T18:50:31.097-05:001:CI:1234598765
TELCO-INCCTL2011-05-20T16:50:31.097-05:001:TI:0987654321
TELCO-INC
RESELLER
1
networkId
4679
accountName
TELCO-INC
serviceId
7035556778
Response Normal (Full TestRequestType is 1)
TELCO-INCCTL2011-05-20T18:50:31.097-05:001:CI:1234598765
TELCO-INCCTL2011-05-20T16:50:31.097-05:001:TI:0987654321
networkId
4679
accountName
TELCO-INC
serviceId
7035556778
This is a summary...
10
1000
50
200
10
2
1000
1000
200
OK
Not OK
99
20
15
Response Normal (Quick TestRequestType is 2)
TELCO-INCCTL2011-05-20T17:45:31.097-05:001:CI:1234598765
TELCO-INCCTL2011-05-20T15:45:31.097-05:001:TI:0987654321
networkId
4679
accountName
TELCO-INC
serviceId
7035556778
This is a summary...
1812
3500
0
3500
0
10
99
103
99
20
19700
Response Normal (Central Office TestRequestType is 3)
TELCO-INCCTL2011-05-20T22:35:31.097-05:001:CI:1234598765
TELCO-INCCTL2011-05-20T20:30:31.097-05:001:TI:0987654321
networkId
4679
accountName
TELCO-INC
serviceId
7035556778
This is a summary...
10
1000
50
200
10
2
1000
1000
200
OK
Not OK
99
20
15
Response Normal (Loop Test TestRequestType is 4)
TELCO-INCCTL2011-05-20T07:22:31.097-05:001:CI:1234598765
TELCO-INCCTL2011-05-20T05:11:31.097-05:001:TI:0987654321
networkId
4679
accountName
TELCO-INC
serviceId
7035556778
This is a summary...
1450
3500
0
3500
0
9
95
86
OK
Not OK
99
65
19800
Examples of tML for Client Self Test
Note: The examples below are not an exhaustive set of attributes that could be included in each transaction. Please see the tML-ServiceTest.xsd, tML-ServiceTestBase.xsd, and MTG Implementation document for details.
Request
TELCO-INCCTL2014-08-28T18:50:31.097-05:001:CI:1234598765
TELCO-INCCTL2014-08-28T18:50:31.097-05:001:TI:0987654321
TELCO-INC
WHOLESALE
1
networkId
4679
accountName
TELCO-INC
serviceId
26/HCGS/123456//MS
false
Response - Normal
TELCO-INCCTL2014-08-28T18:50:31.097-05:001:CI:1234598765
TELCO-INCCTL2014-08-28T18:50:31.097-05:001:TI:0987654321
networkId
4679
accountName
TELCO-INC
serviceId
26/HCGS/123456//MS
W-2jaksc
NTA
No test access available - Please open a ticket.
CHNHMNBJ
2014-08-05T12:58:00Z
Response Error Exception
TELCO-INCCTL2014-08-28T18:50:31.097-05:001:CI:1234598765
TELCO-INCCTL2014-08-28T18:50:31.097-05:001:TI:0987654321
networkId
4679
accountName
TELCO-INC
serviceId
26/HCGS/123456//MS
MTG1000
Cannot access INTAS Service
Glossary
ATISAlliance for Telecommunications Industry Solutions: A standards body for the Telecommunications Industry. http://www.atis.org.CSTClient Self TestMTGCenturyLink Maintenance Ticketing Gateway: CenturyLinks business-to-business Electronic Ticketing trouble administration gateway.TCIFTelecommunications Industry ForumtML-TATelecommunications Markup Language-Trouble Administration: The ATIS XSD/XML standard for trouble administration.TMOCATIS Telecom Management and Operations Committee (formerly, T1M1).TRFDTrouble Report Format Definition
Appendix A: Corrections
Shown below are corrections for the September 2, 2011 release of this document. These are changes from the review document of August 24, 2011.
SectionChange5.1 Request Trouble Report Creation RequestAdded missing closing bracket to:
5.6 CancelTroubleReportResponseBeginning at the eleventh line of the WSDL, removed the following:
TELCO-INC
RESELLER
5.2 RequestTroubleReportCreationResponseCommittmentTime, with two ts in Committment, has been corrected to CommitmentTime. For example:
5.12 AddTroubleInfoResponseRemove white space from parent tags:
5.7 RetrieveAttributesByTroubleReportIdRequestAdded the following (missing) end tag:
5.5 CancelTroubleReportRequestAdded the missing "/tML-TA:" after opening bracket:
trueSection 6 Examples of tML for POTS Service TestAll POTS examples have been replacedSection 5.13 AttributeValueChangeNotificationReplaced sections 5.13.1 to 5.13.5
STYLEREF "service name" \* MERGEFORMAT Maintenance Ticketing Gateway Specification STYLEREF "category name" \* MERGEFORMAT CenturyLink
STYLEREF "category name" \* MERGEFORMAT CenturyLink STYLEREF "service name" \* MERGEFORMAT Maintenance Ticketing Gateway Specification
- Internal Use Only - PAGE 20 ( 2014 CenturyLink, Inc. All Rights Reserved. September 25, 2014
- Internal Use Only -
September 25, 2014 ( 2014 CenturyLink, Inc. All Rights Reserved. PAGE 19
Internal Use Only -Disclose and distribute only to CenturyLink employees and authorized persons working for CenturyLink. Disclosure outside of CenturyLink is prohibited without authorization.
( 2014 CenturyLink, Inc. All Rights Reserved.
RequestTroubleReportCreationRequest
Receive and acknowledge request.
Submit Create Ticket request.
CenturyLink processing.
Receive Create Ticket notification.
Submit Create Ticket notification.
RequestTroubleReportCreationResponse
ACK/NACK (HTTP Response Message)
ACK/NACK (HTTP Response Message)
Receive and acknowledge request.
Submit Update Ticket request.
CenturyLink processing.
Receive Update Ticket notification.
Submit Update Ticket notification.
ACK/NACK (HTTP Response Message)
ModifyAttributesResponse
ModifyAttributesRequest
ACK/NACK (HTTP Response Message)
CancelTroubleReportRequest
Receive and acknowledge request.
Submit Cancel Ticket request.
ACK/NACK (HTTP Response Message)
CenturyLink processing.
Receive Cancel Ticket notification.
Submit Cancel Ticket notification.
ACK/NACK (HTTP Response Message)
CancelTroubleReportResponse
Receive and acknowledge request.
Submit Retrieve Ticket request.
CenturyLink processing.
Receive Retrieve Ticket notification.
Submit Retrieve Ticket notification.
RetrieveAttributesByTroubleReportIdResponse
ACK/NACK (HTTP Response Message)
RetrieveAttributesByTroubleReportIdRequest
ACK/NACK (HTTP Response Message)
Submit Update Ticket (status / log notes update) notification.
Receive Update Ticket (priority / log notes update) notification.
ACK/NACK (HTTP Response Message)
AttributeValueChangeNotification
Receive Cleared Ticket notification.
Submit verification of issue resolution
AttributeValueChangeNotification
VerifyRepairCompletionRequest
Process request
Receive verification response
VerifyRepairCompletionResponse
Submit verification response
Receive Closed Ticket notification.
Submit Closed Ticket notification.
AttributeValueChangeNotification
After 24 hours of no response, no dispute, or immediately upon acceptance, the ticket may be closed.
Cleared state (3), status (26), status time, activity duration, close out narrative, trouble found, maintenance service charge, and outage duration, restored time.
Closed state (4), status (27), status time, additional trouble status info.
Submit Cleared Ticket notification.
ACK/NACK (HTTP Response Message)
ACK/NACK (HTTP Response Message)
ACK/NACK (HTTP Response Message)
ACK/NACK (HTTP Response Message)
Receive Cleared Ticket notification.
AttributeValueChangeNotification
Receive Closed Ticket notification.
Submit Closed Ticket notification.
AttributeValueChangeNotification
Cleared state (3), status (25), status time, additional trouble status info.
Closed state (4), status (27), status time, close out narrative, trouble found, maintenance service charge, outage duration, restored time.
Submit Cleared Ticket notification.
ACK/NACK (HTTP Response Message)
ACK/NACK (HTTP Response Message)
E F I U Z [ \ ] v w y D K L R ` ” ¹ » Å Ś Ū Ø
Ę
Č
É
’
2 Ź Ķ Š Ö é
7
?
A
Ń
8 > H ¼ ļėÖėŅĪŹĪėĘĀŅė»ė»ė“ė“ė“ė»ėė¦ėėėĘĪĘĀ hŽ hĶOā h)7 hĶ6ó h÷)Ś h{ō h|wĆ h{? hŲz¢ h³ hŲz¢ hĄwÜ hŲz¢ hŗlį hŲz¢ h9(å hŲz¢ h$\
håP§ h'Ø h+j hpt )jĘ h h B*UmH nH ph ’ uhŲz¢ j hžYØ h UmH nH u3 - E G H I ] z Ē . 3 ? ż ū ł ÷ õ õ õ ó ń ģ ź ź ä ä ä - $If ( gdŲz¢ E W K Q I ? @ D S ` Ę P J A A A > $If gdŲz¢ > $If Æ kd: $$If l Ö ÖF
ī% ģ b ° Ö Ö ’ąąą ’ąąą ’ąąą Ö0 öžö Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’4Ö 4Ö
l aöpÖ ’ąąą ’ąąą ’ąąą yt(? Ę Ē Ė Ū
u o f o > $If gdŲz¢ > $If kd $$If l Ö ÖF
ī% ģ b ° Ö0 öžö Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’4Ö 4Ö
l aöyt(?
+
F
o
É
! Å A u o f f f f f f ] > $If gd(? > $If gdŲz¢ > $If kd $$If l Ö ÖF
ī% ģ b ° Ö0 öžö Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’4Ö 4Ö
l aöyt(? A B F Y p s m d d > $If gdŲz¢ > $If kd, $$If l Ö “ÖF
ī% ģ b ° Ö0 öžö Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’4Ö 4Ö
l aöyt(? p q u
Ģ u o f f > $If gdŲz¢ > $If kd½ $$If l Ö ÖF
ī% ģ b ° Ö0 öžö Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’4Ö 4Ö
l aöyt(? Ģ Ķ × é @
u o f ] > $If gd÷)Ś > $If gdŲz¢ > $If kdJ $$If l Ö ÖF
ī% ģ b ° Ö0 öžö Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’4Ö 4Ö
l aöyt(? @
A
K
\
Š
u o f ] > $If gd÷)Ś > $If gdŲz¢ > $If kd× $$If l Ö ÖF
ī% ģ b ° Ö0 öžö Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’4Ö 4Ö
l aöyt(? Š
Ń
Ū
ķ
G u o f ] > $If gd+j > $If gdŲz¢ > $If kdd $$If l Ö ÖF
ī% ģ b ° Ö0 öžö Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’4Ö 4Ö
l aöyt(? G H R a » u o f ] > $If gd+j > $If gdŲz¢ > $If kdń $$If l Ö ÖF
ī% ģ b ° Ö0 öžö Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’4Ö 4Ö
l aöyt(? » ¼ Ę Õ ( u o f ] > $If gd+j > $If gdŲz¢ > $If kd~ $$If l Ö ÖF
ī% ģ b ° Ö0 öžö Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’4Ö 4Ö
l aöyt(? ' ) ¬ Ų Ü ć ē ( * ą ā ź ė £ „ ¬ ® Č É Ķ Ī h i } ~ ¬ üųüōšģčģčģšįŁįÕĪĘĪ½¹µ¬µØµ
w_w .h hņd% 5CJ OJ PJ QJ aJ mH nH u h
-O hņd% 0J= mH nH uhÓ-Ź j hÓ-Ź UhŲz¢ mH nH uj h·n UmH nH u h'Ø j ÓšhŲz¢ aJ hŲz¢ hpt h hpt aJ hpt hpt H*hpt hpt hß` hpt hß` H*hpt hß` hē7Ś h(? hi hŽ hSė h$\
"( ) 3 @ u o f ] > $If gd+j > $If gdŲz¢ > $If kd $$If l Ö ÖF
ī% ģ b ° Ö0 öžö Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’4Ö 4Ö
l aöyt(? ¬ ) u o f ] > $If gdē7Ś > $If gdŲz¢ > $If kd $$If l Ö ÖF
ī% ģ b ° Ö0 öžö Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’4Ö 4Ö
l aöyt(? ) * 4 5 E ź u l c l Z > $If gdōTś $If gdń,© > $If gdń,© kd%” $$If l Ö ÖF
ī% ģ b ° Ö0 öžö Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’4Ö 4Ö
l aöyt(? ź ė õ u l l c > $If gdōTś > $If gdń,© kd²” $$If l Ö ÖF
ī% ģ b ° Ö0 öžö Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’4Ö 4Ö
l aöyt(? ® Æ Č £ ® g ^ h Ī = u p k f d b b d ` ^ ( gdŲz¢ ( gdŲz¢ > gdŲz¢ kd?¢ $$If l Ö ÖF
ī% ģ b ° Ö0 öžö Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’Ö ’ ’ ’4Ö 4Ö
l aöyt(?
¬ ® Č É Ź Ė Ģ Ķ Ī Ļ ķ ī ń ņ 7 8 9 : ; < = > \ ] ` a p q r ± ² µ ¶ õęõŌęõęĘ®¦¢¦®õęõęõęĘ®¦¢¦®õęõpęõęĘ®¦¢¦®#jĘ£ h·n UmH nH u#jI£ h·n UmH nH uh
-O hņd% 0J= mH nH uhÓ-Ź j hÓ-Ź U.h hņd% 5CJ OJ PJ QJ aJ mH nH u j hÓ-Ź UmH nH u #jĢ¢ h·n UmH nH uj h·n UmH nH uhņd% mH nH u,=
ż e Ķ 6 ” ' „ ( ä : ą P š F ļ F Å 6 “ 7 ± b! ż ż ż ż ū ū ū ū ū ū ū ł ż ż ż ū ū ż ū ū ū ū ż ū ū ū ū ū ū A ¶ č é ź
) * - . p q r ± ² µ ¶ Ū Ü Ż ÷ ų ł ś ū ü ż ž ńę×ęÅ×ę×·ńńę×ę×ę×·ńńę×ęo×ę×· #j=„ h·n UmH nH u#jĄ¤ h·n UmH nH uhÓ-Ź j hÓ-Ź U.h hņd% 5CJ OJ PJ QJ aJ mH nH u j hÓ-Ź UmH nH u #jC¤ h·n UmH nH uj h·n UmH nH uhņd% mH nH u h
-O hņd% 0J= mH nH u + " # C D E _ ` a b c d e f
« ¬ Ē Č É Ź Ė Ģ Ķ Ī ģ ķ ņ ó / 0 1 3 4 5 6 7 U V [ \ ~ óāŁŌŹŌ½ŹŌŹµāµ±µóāŁŌŹŌ¤ŹŌŹµāµ±µóāŁŌŹŌŹŌŹµāµ±µóāŁŌŹŌŹŌ j1§ h·n U j“¦ h·n U j7¦ h·n U hÓ-Ź j hÓ-Ź Ujŗ„ h·n U j h·n U hņd% h
-O hņd% 0J= h hņd% CJ OJ PJ QJ aJ h
-O hņd% 0J= OJ QJ 6 ” ¢ Ą Į Ę Ē ! " $ % & ' ( F G L M ¢ £ ¤ „ ¦ Ä Å Ź Ė ! " # % & ' ( ) G H I öīŻīŁīĢŻĆ¾ö¾±ö¾öīŻīŁīĢŻĆ¾ö¾¤ö¾öīŻīŁīĢŻĆ¾ö¾ö¾öīŻīŁī h
-O hņd% 0J= mH nH ujØØ h·n U j+Ø h·n U j®§ h·n U hņd% h
-O hņd% 0J= h
-O hņd% 0J= OJ QJ hÓ-Ź h hņd% CJ OJ PJ QJ aJ j hÓ-Ź Uj h·n U4I J ` a b | } ~ ¢ £ ¦ § Į Ā Ć Ż Ž ß į ā ć ä å 3 4 5 7 8 9 : ; Y Z čŚĻĄĻ®ĄĻĄ čŚčŚĻĄĻĄĻĄ čŚčŚĻĄĻpĄĻĄ č#jŖ h·n UmH nH u#j¢© h·n UmH nH uhÓ-Ź j hÓ-Ź Uj hÓ-Ź UmH nH u #j%© h·n UmH nH uj h·n UmH nH uhņd% mH nH u h
-O hņd% 0J= mH nH u.h hņd% 5CJ OJ PJ QJ aJ mH nH u,Z ] ^ f g h Ø © ® Æ ½ ¾ æ Ł Ś Ū Ż Ž ß ą į ’ ńŁńĪæĪæĪæŁulg]gP]g]u j« h·n U j h·n U hņd% h
-O hņd% 0J= h hņd% CJ OJ PJ QJ aJ h
-O hņd% 0J= OJ QJ hÓ-Ź j hÓ-Ź Uj hÓ-Ź UmH nH u #jŖ h·n UmH nH uj h·n UmH nH uhņd% mH nH u .h hņd% 5CJ OJ PJ QJ aJ mH nH u h
-O hņd% 0J= mH nH u - . / I J K M N O P Q o p s t x y z ŗ » Ą Į ļęį×įŹ×į×ĀļĀ¾Ā°°~l~~^Ā¾ĀQļ h
-O hņd% 0J= OJ QJ j hÓ-Ź UmH nH u #j¬ h·n UmH nH uj h·n UmH nH uhņd% mH nH u .h hņd% 5CJ OJ PJ QJ aJ mH nH u h
-O hņd% 0J= mH nH uhÓ-Ź j hÓ-Ź Uj« h·n U j h·n U hņd% h
-O hņd% 0J= h hņd% CJ OJ PJ QJ aJ Į Ķ Ī Ļ é ź ė ķ ī ļ š ń # $ % ? @ A C D E F G e f k l z { | ¼ ½ Ā Ć Ģ Ķ Ī č é ź ģ ķ ī ÷ņčņŪčņčÓĀÓ¾Ó±Ā÷ņčņ¤čņčÓĀÓ¾Ó±Ā÷ņčņčņčÓĀÓ¾Ó±Ā÷ņčņčņčÓ j® h·n U j h·n U j
h·n U h
-O hņd% 0J= OJ QJ hÓ-Ź h hņd% CJ OJ PJ QJ aJ j hÓ-Ź Uj¬ h·n U j h·n U hņd% h
-O hņd% 0J= 6ī ļ š # $ % ? @ A C D E F G e f k l ¢ £ ¤ ¾ æ Ą Ā Ć Ä Å ļēćēÕ½Õ²£²£²£½ēćēvļmh^hQ^h^ēļ jÆ h·n U j h·n U hņd% h
-O hņd% 0J= h
-O hņd% 0J= OJ QJ j hÓ-Ź UmH nH u #j® h·n UmH nH uj h·n UmH nH uhņd% mH nH u .h hņd% 5CJ OJ PJ QJ aJ mH nH u h
-O hņd% 0J= mH nH uhÓ-Ź j hÓ-Ź U h hņd% CJ OJ PJ QJ aJ Å Ę ä å ź ė / 0 1 3 4 5 6 7 U V [ \ ® Æ ± ² ³ “ µ Ó Ō Ł Ś 0 1 2 4 5 6 7 8 V W \ ] ÷ó÷ęÕĢĒ½Ē°½Ē½÷Õ÷ó÷ęÕĢĒ½Ē£½Ē½÷Õ÷ó÷ęÕĢĒ½Ē½Ē½÷Õ÷ó÷Õ hpt hņd% 0J= OJ QJ jx° h·n U jūÆ h·n U j~Æ h·n U j h·n U hņd% h
-O hņd% 0J= h hņd% CJ OJ PJ QJ aJ h
-O hņd% 0J= OJ QJ hÓ-Ź j hÓ-Ź U 2] Ŗ « ¬ ® Æ ° ± ² Š Ń Ö × ?! @! A! [! \! ]! _! `! a! b! c! ! ! ! ! ¢! £! ¤! ¾! ÷ļāļŅāļāŹ¹ŹµŹØ¹÷ļāļāļāŹ¹ŹµŹrgXg j h·n UmH nH uhņd% mH nH u .h hņd% 5CJ OJ PJ QJ aJ mH nH u h
-O hņd% 0J= mH nH ujr± hpt h·n U hpt hņd% 0J= OJ QJ hÓ-Ź h hņd% CJ OJ PJ QJ aJ j hÓ-Ź Ujõ° hpt h·n U j hpt h·n U hpt hņd% hpt hņd% 0J= "¾! æ! Ą! Ā! Ć! Ä! Å! Ę! ä! å! ę! ē! " " " !" "" #" %" &" '" (" )" G" H" K" L" o" p" q" " " " " " " " " ±" ²" ³" “" Ü" Ż" ķŽÓŽÅ„”„ÓŽÓŽÓŽÅ„”„ÓŽÓoŽÓŽÅ„”„Ó #jé² h·n UmH nH u#jl² h·n UmH nH uh
-O hņd% 0J= mH nH uhÓ-Ź j hÓ-Ź U.h hņd% 5CJ OJ PJ QJ aJ mH nH u j hÓ-Ź UmH nH u hņd% mH nH u j h·n UmH nH u#jļ± h·n UmH nH u +b! Å! (" " ’" i# Ō# 2$ $ ņ$ T% Å% 7&