21 Configuring SM-PME

The following sections describe how to configure SM-PME using the Service Broker Administration Console and Java MBeans:

Configuring SM-PME with the Administration Console
Understanding the SM-PME Mapping File
Configuring SM-PME with Java MBeans

Configuring SM-PME with the Administration Console

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.

Table 21-1 SM-PME Parameters

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: Continue Session Release Session 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

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:

Continue Session
Release Session

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

Understanding the SM-PME Mapping File

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>

Configuring SM-PME with Java MBeans

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

PmeMBean enables you to configure the SM-PME.

Factory Method

Created automatically

Attributes

MappingFileName
DefaultHandlingOnMappingError
MappingErrorResponse

For more information on these attributes, see Table 21-1.

Operations

None