Go to primary content
Oracle® Communications Diameter Signaling Router Service Capability Exposure Function User's Guide
Release 8.4
F12301-02
Go To Table Of Contents
Contents

Previous
Previous
Next
Next

3 Managed Objects

SCEF works with Common (including SCS/AS and System Options), AppWorks, and NIDD (including NIDD and APN Configuration) managed objects described in this chapter.

SCS/AS

The SCS/AS managed objects exist for each SCS/AS that needs to communicate with DSR's SCEF application. This managed object allows the customer to configure an SCS/AS by specifying its properties and associate an APN to it. Attributes listed in Table 3-1 are used to configure the SCS/AS managed object.

Table 3-1 SCS/AS Attribute Descriptions

Attribute Description
scsAsId The SCS/AS identifier.
niddCfgSetName The NIDD Configuration Set managed object associated to this SCS/AS. When this attribute is populated, the NIDD feature is enabled.
apnCfgSetName The APN Configuration Set managed object associated to this SCS/AS. This attribute must be populated if the niddConfigSetName is populated.
monitoringEventCfgSetName The Monitoring Events Configuration Set managed object associated to this SCS/AS.
deviceTriggeringCfgSetName The Device Triggering Configuration Set managed object associated to this SCS/AS.
aclId Associated AclId with SCS.
callbackUrl Destination URL for any notification messages for this SCS/AS.
smsScFqdn FQDN of SMS-SC.
smsScRealm Realm of SMS-SC.
scsAsIsdn ISDN number of the SCS/AS in international ISDN number format.
isEcrAllowed Value of this attribute decides if Enhanced Coverage Restriction Control is allowed or not.

System Options

The System Options managed objects allow the customer to specify routing configurations and system defaults that apply to a DSR node. Attributes listed Table 3-2in are used to configure the System Options managed object.

Table 3-2 System Options Attribute Descriptions

Attribute Description
art Application Routing Table instance used to route any Diameter request messages generated by the SCEF application.
prt Peer Routing Table instance used to route any Diameter request messages generated by the SCEF application.
apiGwIpList A comma separated list of IPv4 addresses of the DSR API Gateway application server. The SCEF application distributes the HTTP request messages toward the DSR API Gateway among the IP addresses listed in the apiGwIpList attribute.
priority DRMP priority of NIR, ACR, and CMR messages originated by SCEF.
retryDbUpdate The number of times the SCEF MP server may retry when an attempt to update a context in the USBR server fails due to concurrent update checksum mismatch.
servingPlmnRateControlEnabled This option allows the customer to enable or disable Mobile Terminating PDU rate control based on the Serving PLMN Rate Control configuration requested by MME/SGSN.
scefWaitTime The duration of time in seconds the SCEF application may wait for a Diameter Answer message for any request sent to the MME/SGSN. The scefWaitTime attribute should match the Pending Answer Timeout value in the Diameter configuration.
binaryEncoder The Binary-To-Text encoding scheme to use to transcode binary data while sending to or receiving from the SCS/AS in JSON-encoded HTTP message. Allowed values are:
  • Base2
  • Base16
  • Base64
  • ASCII

AppWorks

The AppWorks managed objects (Server Groups, Resource Domains, Places, and Place Associations) require the following changes described in this section.
  • All DA-MP servers that running the SCEF application need to be configured in a Place Association of type Application Region.
  • All DA-MP servers that running the SCEF application need to be configured in a Resource Domain with a Application MPs profile.

NIDD Configuration Set

An NIDD Configuration Set managed object exists for each instance of an NIDD Configuration Set. This managed object allows the customer to create instances of NIDD Configuration Sets as needed. The NIDD Configuration Set specifies various attributes that controls the processing of NIDD-related messages, and safeguards the operator from unacceptable request parameters, for example, an authorization duration that is too long.

Table 3-3 Non-IP Data Delivery Attribute Descriptions

Attribute Description
name A name that uniquely defines the NIDD Configuration Set.
maxAuthDuration Maximum time in seconds the NIDD configuration is valid.
pdnEstablishmentOptionEnabled Applicability of the PDN Establishment Option IE received in the NIDD Configuration message and/or Downlink Data Delivery messages received for this NIDD configuration.
pdnEstablishmentOption

Default PDN Establishment Option to apply if the NIDD Configuration message and any subsequent Downlink Data Delivery message(s) do not contain the PDN Establishment Option IE.

Note: This attribute is applicable only if the pdnEstablishmentOptionEnabled is set to true.

Any change made to the pdnEstablishmentOptionEnabled attribute takes effect when the next Downlink Data message is received from the SCS/AS.

dataDuration The maximum time in seconds a Downlink Data Delivery message is considered to be valid when it is buffered by the SCEF application. If dataDuration is set to 0, then SCEF does not buffer NIDD MT data messages irrespective of maxOnholdDataMsg configuration and maximum message latency value received in the MT NIDD submit request from SCS/AS.
maxOnholdDataMsg The maximum number of messages for each UE that can be buffered by SCEF application.
priority The default priority associated to a Downlink Data Delivery message when the same is not present in the message received from the SCS/AS.
minRetransmissionTime

The minimum time in seconds the SCEF application requires to buffer a Downlink Data Delivery message in the USBR database and then retransmit it to the MME/SGSN.

Note: This attribute becomes more significant in slow WAN networks.

APN Configuration

An APN Configuration Set managed object instance exists for each Access Point Name that the customer servers by SCEF signaling. An APN Configuration Set managed object is associated to an SCS/AS. This managed object specifies various attributes that controls the processing of signaling messages that belong to that APN, for example the rate control attributes.

Table 3-4 Access Point Name Attribute Descriptions

Attribute Description
Name Access Point Name.
maxPacketSize Maximum Packet Size (Uplink or Downlink) in bytes that is allowed to be transmitted through the SCEF application.
maxPacketBufferSize Maximum Packet Size (Downlink) in bytes that is allowed to be buffered by the SCEF application.
downlinkApnRateControlUnit The unit for Downlink APN rate control. Any change made to the downlinkApnRateControlUnit attribute takes effect when the next Downlink Data message is received from the SCS/AS.
downlinkApnRateControlVal Multiple of Downlink APN rate control unit. Any change made to the downlinkApnRateControlVal attribute takes effect when the next Downlink Data message is received from the SCS/AS.
downlinkApnMessageRate The maximum Downlink message rate for this APN. Any change made to the downlinkApnMessageRate attribute takes effect when the next Downlink Data message is received from the SCS/AS.
uplinkApnRateControlUnit The unit for Uplink APN rate control. Any change made to the uplinkApnRateControlUnit attribute takes effect when the next Downlink Data message is received from the SCS/AS.
uplinkApnRateControlVal Multiple of Uplink APN rate control unit. Any change made to the uplinkApnRateControlVal attribute takes effect when the next Downlink Data message is received from the SCS/AS.
uplinkApnMessageRate The maximum Uplink message rate for this APN. Any change made to the uplinkApnMessageRate attribute takes effect when the next Downlink Data message is received from the SCS/AS.