- Preface
- Chapter 1 - Overview
- Chapter 2 - SOAP/XML Environment
- Chapter 3 - Data Model
- Chapter 4 - PCSP SOAP API
- Chapter 5 - PCSP Rules and Mapping
- Chapter 6 - PCSP Objects � XML Example (PUT)
- Chapter 7 - Performance Considerations
- Chapter 8 - PCSP Subscriber Provisioning
- Chapter 9 - Troubleshooting Guide
- Appendix A - Cisco BTS 10200 Extensions for PCSP Objects
- Appendix B - Sample Entity Encodings
PCSP Subscriber Provisioning
Provisioning a Subscriber with the Minimum Number of Features
From the PCSP interface, use the following instructions to provision a subscriber with the minimum number of features and extensions and place the subscriber and features and extensions in service.
While the following steps are executed, the PSCP adapter
•Changes termination.id to subscriber-id
•Changes subscriber.mgw-id to termination.mgw-id
•Changes subscriber.term-id to termination.id
•Changes subscriber.term-type to none
•Equips or unequips and places the subscriber-termination in the requested AdminStatus state
Step 1 Add a new MTA (bts: mgw).
"put mta"
CmdStatus=1
Example:
<PcspMta>
<MtaFqdn>brandont1</MtaFqdn>
<ListenPort>2427</ListenPort>
<CmtsFqdn>sim-SYS14CA146.ipclab.cisco.com:9146</CmtsFqdn>
<MtaProfile>c5350-59-140</MtaProfile>
<Timezone>-0500</Timezone>
<Protocol>MCGP 1.0 NCS 1.0</Protocol>
<Codec>1</Codec>
<IPSecControl>true</IPSecControl>
<Extension xmlns:ext="http://www.cisco.com/CmsExtension">
<ext:id>bdmta</ext:id>
<ext:aggr_id>c7246-227-77</ext:aggr_id>
<ext:node>test</ext:node>
<ext:type>RGW</ext:type>
</Extension>
</PcspMta>
Step 2 Place the MTA in-service.
"control mta" in-service
Example:
<CiscoBtsCliObj>
<Request Verb='control' Noun='mgw'>
<Entry Key='id' Value='brandont1'></Entry>
<Entry Key='target_state' Value='INS'></Entry>
<Entry Key='Wait' Value='y'></Entry>
<Entry Key='mode' Value='FORCED'></Entry>
</Request>
<Extension xmlns:ext="http://www.cisco.com/BtsCliExtension">
<ext:key>1266645536</ext:key>
</Extension>
</CiscoBtsCliObj>
Step 3 Add a new service (bts: subscriber) with term-type=NONE.
"put subscriber"
CmdStatus=1
ext:term_type=none
Example:
<PcspService xmlns="http://www.cablelabs.com/Pcsp/I01/schema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:pcsp="http://www.cablelabs.com/Pcsp/I01/schema">
<ServiceId format="NSN">2146255555</ServiceId>
<AdminStatus>1</AdminStatus>
<BillingId>2146255555</BillingId>
<ExternalId>brandontest</ExternalId>
<IsPrimary>true</IsPrimary>
<PrimaryRing>R1</PrimaryRing>
<DisplayName>John Q Public</DisplayName>
<DisplayNumber>2146255555</DisplayNumber>
<Password>45hjg3j6gkg6h54j6gkj3g6</Password>
<Announcements>
<Language>EN</Language>
<Timezone>+0500</Timezone>
</Announcements>
<InterExchange>
<PIC>0123</PIC>
<LPIC>0123</LPIC>
<IPIC>0123</IPIC>
</InterExchange>
<LNP>
<PortingStatus>0</PortingStatus>
<LNPT>0</LNPT>
</LNP>
<ListOfCallFeatures>
<CfAC>
<Subscribed>true</Subscribed>
<AdminStatus>1</AdminStatus>
</CfAC>
</ListOfCallFeatures>
<Extension xmlns:ext="http://www.cisco.com/CmsExtension">
<ext:sub_profile_id>tb14-cable</ext:sub_profile_id>
<ext:term_type>NONE</ext:term_type>
<ext:ListOfServicePkg>
<ext:pkgid>bus-gold</ext:pkgid>
</ext:ListOfServicePkg>
</Extension>
</PcspService>
Step 4 Add a new endpoint (bts: termination) and specify the subscriber-id that was added in Step 3.
"put endpoint"
CmdStatus=1
ext:sub_id=<newly_created_subscriber_above>
AdminStatus=1 (in-service)
Example:
<PcspEndpoint>
<EndpointId>brandon1@bdmta</EndpointId>
<AdminStatus>0</AdminStatus>
<Extension>
<ext:sub_id>brandontest</ext:sub_id>
<ext:key>1337593914</ext:key>
</Extension>
</PcspEndpoint>
Provisioning a Subscriber with a Feature
From the PCSP interface, use the following instructions to provision a subscriber with a feature and place the subscriber and feature in-service.
While the following steps are executed, the PSCP adapter
•Changes termination.id to subscriber-id
•Changes subscriber.mgw-id to termination.mgw-id
•Changes subscriber.term-id to termination.id
•Changes subscriber.term-type to none
•Places the subscriber-termination in the requested AdminStatus state
Step 1 Add a new MTA (bts: mgw).
"put mta"
CmdStatus=1
Example:
<PcspMta>
<MtaFqdn>brandont1</MtaFqdn>
<ListenPort>2427</ListenPort>
<CmtsFqdn>sim-SYS14CA146.ipclab.cisco.com:9146</CmtsFqdn>
<MtaProfile>c5350-59-140</MtaProfile>
<Timezone>-0500</Timezone>
<Protocol>MCGP 1.0 NCS 1.0</Protocol>
<Codec>1</Codec>
<IPSecControl>true</IPSecControl>
<Extension xmlns:ext="http://www.cisco.com/CmsExtension">
<ext:id>bdmta</ext:id>
<ext:aggr_id>c7246-227-77</ext:aggr_id>
<ext:node>test</ext:node>
<ext:type>RGW</ext:type>
</Extension>
</PcspMta>
Step 2 Place the MTA in-service.
"control mta" in-service
Example:
<CiscoBtsCliObj>
<Request Verb='control' Noun='mgw'>
<Entry Key='id' Value='brandont1'></Entry>
<Entry Key='target_state' Value='INS'></Entry>
<Entry Key='Wait' Value='y'></Entry>
<Entry Key='mode' Value='FORCED'></Entry>
</Request>
<Extension xmlns:ext="http://www.cisco.com/BtsCliExtension">
<ext:key>1266645536</ext:key>
</Extension>
</CiscoBtsCliObj>
Step 3 Add a new service (bts: subscriber) with term-type=NONE.
"put subscriber"
CmdStatus=1
ext:term_type=none
Example:
<PcspService xmlns="http://www.cablelabs.com/Pcsp/I01/schema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:pcsp="http://www.cablelabs.com/Pcsp/I01/schema">
<ServiceId format="NSN">2146255555</ServiceId>
<AdminStatus>1</AdminStatus>
<BillingId>2146255555</BillingId>
<ExternalId>brandontest</ExternalId>
<IsPrimary>true</IsPrimary>
<PrimaryRing>R1</PrimaryRing>
<DisplayName>John Q Public</DisplayName>
<DisplayNumber>2146255555</DisplayNumber>
<Password>45hjg3j6gkg6h54j6gkj3g6</Password>
<Announcements>
<Language>EN</Language>
<Timezone>+0500</Timezone>
</Announcements>
<InterExchange>
<PIC>0123</PIC>
<LPIC>0123</LPIC>
<IPIC>0123</IPIC>
</InterExchange>
<LNP>
<PortingStatus>0</PortingStatus>
<LNPT>0</LNPT>
</LNP>
<ListOfCallFeatures>
<CfAC>
<Subscribed>true</Subscribed>
<AdminStatus>1</AdminStatus>
</CfAC>
<CfCFBL>
<Subscribed>true</Subscribed>
<AdminStatus>1</AdminStatus>
<UserParams>
<Active>true</Active>
<Always>0</Always>
<ForwardTo>9785551212</ForwardTo>
</UserParams>
</CfCFBL>
</ListOfCallFeatures>
<Extension xmlns:ext="http://www.cisco.com/CmsExtension">
<ext:account_id>test</ext:account_id>
<ext:address1>test</ext:address1>
<ext:address2>test</ext:address2>
<ext:city>test</ext:city>
<ext:country>test</ext:country>
<ext:esrn>2345</ext:esrn>
<ext:forced>true</ext:forced>
<ext:grp>true</ext:grp>
<ext:immediate_release>true</ext:immediate_release>
<ext:sdt_mwi>true</ext:sdt_mwi>
<ext:send_bdn_as_cpn>true</ext:send_bdn_as_cpn>
<ext:send_bdn_for_emg>true</ext:send_bdn_for_emg>
<ext:state>test</ext:state>
<ext:sub_profile_id>tb14-cable</ext:sub_profile_id>
<ext:terminating_immediate_rel>test</ext:terminating_immediate_rel>
<ext:usage_sens>true</ext:usage_sens>
<ext:vmwi>true</ext:vmwi>
<ext:zipcode>75082</ext:zipcode>
<ext:billing_type>FR1</ext:billing_type>
<ext:category>INDIVIDUAL</ext:category>
<ext:cwt_type>WT1</ext:cwt_type>
<ext:offhook_trigger_type>NONE</ext:offhook_trigger_type>
<ext:ohd_timer>0</ext:ohd_timer>
<ext:privacy>FULL</ext:privacy>
<ext:term_type>NONE</ext:term_type>
<ext:ListOfServicePkg>
<ext:pkgid>bus-gold</ext:pkgid>
<ext:pkgid>ivr</ext:pkgid>
</ext:ListOfServicePkg>
</Extension>
</PcspService>
Step 4 Add a new endpoint (bts: termination) and specify the subscriber-id that was added in Step 3.
"put endpoint"
CmdStatus=1
ext:sub_id=<newly_created_subscriber_above>
AdminStatus=1 (in-service)
Example:
<PcspEndpoint>
<EndpointId>brandon1@bdmta</EndpointId>
<AdminStatus>0</AdminStatus>
<Extension>
<ext:sub_id>brandontest</ext:sub_id>
<ext:key>1337593914</ext:key>
</Extension>
</PcspEndpoint>
Step 5 Set the MTA to command status 1.
"put mta; CmdStatus=1"
Modifying a Subscriber Feature
To modify existing features of a current subscriber, use the following instructions:
Execute a put service command for the feature modifications.
"put service"
CmdStatus=2
Example:
<PcspService xmlns="http://www.cablelabs.com/Pcsp/I01/schema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:pcsp="http://www.cablelabs.com/Pcsp/I01/schema">
<ServiceId format="NSN">2146255555</ServiceId>
<AdminStatus>1</AdminStatus>
<BillingId>2146255555</BillingId>
<ExternalId>brandontest</ExternalId>
<IsPrimary>true</IsPrimary>
<PrimaryRing>R1</PrimaryRing>
<DisplayName>John Q Public</DisplayName>
<DisplayNumber>2146255555</DisplayNumber>
<Password>45hjg3j6gkg6h54j6gkj3g6</Password>
<Announcements>
<Language>EN</Language>
<Timezone>+0500</Timezone>
</Announcements>
<InterExchange>
<PIC>0123</PIC>
<LPIC>0123</LPIC>
<IPIC>0123</IPIC>
</InterExchange>
<LNP>
<PortingStatus>0</PortingStatus>
<LNPT>0</LNPT>
</LNP>
<ListOfCallFeatures>
<CfSPCALL>
<Subscribed>true</Subscribed>
<AdminStatus>1</AdminStatus>
<UserParams>
<ListOfSpeedDial>
<SdPair>
<SdNum>2</SdNum>
<ServiceId>2762223900</ServiceId>
</SdPair>
<SdPair>
<SdNum>3</SdNum>
<ServiceId>2762223901</ServiceId>
</SdPair>
</ListOfSpeedDial>
</UserParams>
</CfSPCALL>
<CfCND>
<Subscribed>true</Subscribed>
<AdminStatus>1</AdminStatus>
</CfCND>
<CfACR>
<Subscribed>true</Subscribed>
<AdminStatus>1</AdminStatus>
<UserParams>
<Active>true</Active>
</UserParams>
</CfACR>
</ListOfCallFeatures>
<Extension xmlns:ext="http://www.cisco.com/CmsExtension">
<ext:ListOfServicePkg>
<ext:pkgid>bus-gold</ext:pkgid>
<ext:pkgid>ivr</ext:pkgid>
</ext:ListOfServicePkg>
</Extension>
</PcspService>
Adding Features to a Subscriber
To add features to an existing subscriber, use the "Modifying a Subscriber Feature" section.