Hot SKU control parameters

Ensure to specify the Hot SKU control parameters to avoid performance degradation.

Note: The Hot SKU component is a very powerful feature that can be deployed if your organization is experiencing a true high Hot SKU contention. You might experience performance degradation, if the values of the parameters are incorrectly set. Verify that you have a true Hot SKU contention before enabling this feature or modifying any settings. For any clarification, call Technical Support.

In the customer_overrides.properties file, specify the following Hot SKU control parameters.

Table 1. Hot SKU control parameters.

Specify the Hot SKU control parameters in the customer_overrides.properties file.

Hot SKU Control Parameter Description
yfs.yfs.hotsku.useHotSKUFeature Control used to enable/disable the Hot SKU feature.

By default, this parameter is set to N.

yfs.yfs.hotsku.useTimeOutLocking Control used to enable or disable the lock request timeout option in the Hot SKU feature. By default, the parameter is set to "N".
yfs.yfs.hotsku.registerAvailabilityOnLockTimeout If the value of this property is set to Y, and the SKU turns hot for the first time, and if availability is not yet registered, then availability is registered without lock. Based on the availability picture, the normal hot SKU logic determines whether lock is needed.
Note: Ensure that the yfs.yfs.hotsku.useTimeOutLocking parameter is enabled by setting the value to Y.
yfs.yfs.hotsku.useAvailabilityAcrossNodes This property controls whether the safety level is checked across nodes or for a single node. By default, the value of this property is set to N.
  • If the value is set to N, the lock occurs for a hot SKU when the availability for a single node is below the safety level.
  • If the value is set to Y, the lock occurs for a hot SKU when the availability across the requested nodes is below the safety level.
yfs.yfs.hotsku.secondsToClassifyAsAbnormalTime Threshold used to determine when a lock request is "abnormal".

If a lock request exceeded this threshold, that lock request is counted as an "abnormal" lock request.

Defaults to 0.5 seconds.

yfs.yfs.hotsku.windowTimeInMinutes Interval of one tracking window during which "abnormal" lock requests are tracked. A subsequent window begins once the first window ends.

Default interval is 10 minutes.

yfs.yfs.hotsku.numberOfAbnormalLocks
ForSwitchToHotSKU
Threshold used to determine when to promote an inventory item to Hot SKU status.

If the number of "abnormal" lock requests for an item exceeds this value within the tracking window, that item is promoted to Hot SKU status.

see Three usage scenarios for recommended settings.

yfs.yfs.hotsku.numRequestsInTrackingWindow
ToKeepAsHotSku
Minimum number of requests needed within the tracking window to keep the item in Hot SKU status.
yfs.yfs.hotsku.showExtraMessagesAsInfo Enables extra messages to be displayed at info logging level.

Default value is "N".

yfs.yfs.hotsku.itemMapPurgeLeadTime This parameter is used when the number of Hot SKU items in the cache has reached its limit (specified by yfs.yfs.hotsku.maxItem MapSizeInMemory). When cache is full, eject Hot SKU if it has not been accessed in yfs.hotsku.itemMapPurgeLeadTime minutes. Default value is 10.
yfs.hotsku.lockOnlyOnLowAvailability

This property determines whether locking should be avoided until availability gets low. By default, the property assumes that the availability is checked for the first time and all the items have high availability.

If this property is set to Y, then, it is assumed that the availability is high and lock will be avoided. If the property is set to Y, then, the availability calculation will not lock the YFS_INVENTORY_ITEM if the INV_INVENTORY_ITEM_LOCK doesn’t exist for the demand type.
yfs.hotsku.assumeUnavailableOnLockTimeout This property determines whether an item should be assumed unavailable if in case the lock cannot be acquired. This property is applicable only when yfs.hotsku.lockOnlyOnLowAvailability is set to Y.

If the yfs.hotsku.useTimeOutLocking property and yfs.hotsku.assumeUnavailableOnLockTimeout is set to Y, it will be assumed that there is no inventory available for this item if a timeout occurs. Inventory will be assumed unavailable for this sourcing rule detail. If there are multiple sourcing rule details, then normal expansion will continue and lock will be attempted again.

For Sterling Selling and Fulfillment Foundation Internal Use Only
yfs.yfs.hotsku.qtyMultiplier Defaults to 30. Do not modify without IBM® guidance.
yfs.yfs.hotsku.highRequestQuantityMultiplier Defaults to 2. Do not modify without IBM guidance.
yfs.yfs.hotsku.maxItemMapSizeInMemory Defaults to 1000. Do not modify without IBM guidance.