Oracle® Communications Service Broker Configuration Guide Release 5.0 Part Number E15182-01 |
|
|
View PDF |
The following sections describe how to configure SM-PME using the Service Broker Administration Console and Java MBeans:
This section describes how to configure the SM-PME using the Service Broker Administration Console.
To access the SM-PME Configuration screen:
In the Domain Navigation pane, select OCSB > Processing Tier > Supplementary Modules. The list of currently deployed supplementary modules is displayed.
In the list of the deployed modules, select the module instance that you want to configure. The module instance configuration screen is displayed in the Configuration pane.
The configuration screen of the SM-PME contains the parameters described in Table 21-1.
Name | Type | Description |
---|---|---|
Mapping File Name |
STRING |
Specifies the path of the parameter mapping file. For more information on the format of an SM-PME mapping file, see |
Default Handling on Mapping Error |
INT |
Specifies whether SM-PME releases or continues a session when the mapping engine fails. Possible values:
Default value: Release Session |
Mapping Error Response |
INT |
Specifies the SAL error response code that SM-PME returns when the mapping engine fails. The error response code is regarded only when Default Handling on Mapping Error is set to Release Session. Default value: 487 |
Application servers may impose format requirements on the messages they receive from Service Broker. This might include limitations to the structure or contents of message headers or bodies.
The SM-PME enables you to transform a structure and contents of headers and body of SAL messages generated by Service Broker to a structure and format required by an application server that receives the message. For example, you can transform a XER representation of IN messages to make CAMEL FurnishChargingInformation to fit the format required by an application server.
The OE can send a message to the SM-PME at any point of service orchestration as defined in the orchestration logic.
You can transform a structure and contents of headers and body generated by Service Broker by coding an XSL stylesheet. An XSL stylesheet must be wrapped into an XML file, known as SM-PME mapping file, that has the following structure:
<mapping> <body> <Content-Type>type of content of a Service Broker message</Content-Type> <xsl> <![CDATA[<xsl:stylesheet version="1.0"xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> XSL transformation ]]> </xsl> </body> </mapping>
For example, the following SM-PME mapping file transforms a CAP phase 4 message. In this example, an XSL stylesheet parses the InitialDP message generated by Service Broker and changes the value of the Service Key parameter to 17. The rest of the message and parameters of this message remain unchanged.
<?xml version="1.0" encoding="UTF-8"?> <mapping> <body> <Content-Type>application/cap-phase4+xml</Content-Type> <xsl> <![CDATA[ <xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"> <xsl:template match="text()" /> <xsl:template match="/Cap4"> <Cap4><xsl:apply-templates/></Cap4> </xsl:template> <xsl:template match="initialDP"> <initialDP> <serviceKey>17</serviceKey> <xsl:copy-of select="node()[(name()!='serviceKey')]" /> </initialDP> </xsl:template> </xsl:stylesheet> ]]> </xsl> </body> </mapping>
Service Broker provides the PmeMBean that enables you to configure the SM-PME through JMX. This section contains reference information on PmeMBean.
Note:
MBeans described in this guide may include additional advanced attributes, which are not described in the guide. Advanced attributes are reserved for internal use. Do not change these attributes.PmeMBean enables you to configure the SM-PME.
Created automatically
MappingFileName
DefaultHandlingOnMappingError
MappingErrorResponse
For more information on these attributes, see Table 21-1.
None