๐ When transforming phone numbers in VOS3000 dial plans, there are times when you need to insert or change a prefix while preserving the exact digits that follow at their original positions. This is where the VOS3000 position keeper dollar sign ($) becomes indispensable. The dollar sign in a Target Prefix tells VOS3000 to keep and not change the digit at that position from the original number โ essentially โpassing throughโ the matched digit unchanged while allowing other transformations around it. ๐ง
โ๏ธ The VOS3000 2.1.9.07 manual ยง4.3.1 provides the definitive example: Original Prefix โ0134โ, Target Prefix โ$$$โ, input number โ0134131โ becomes โ013131โ. The three dollar signs in the target prefix retain the last three digits (โ131โ) from the original number while the prefix โ0134โ is replaced. This behavior โ preserving positional digits during transformation โ makes the VOS3000 position keeper dollar sign one of the most powerful tools for building precise number manipulation rules. ๐
๐ฏ This guide covers every aspect of the VOS3000 position keeper dollar sign: how it preserves digit positions, practical transformation examples from the manual, how it interacts with wildcards and other dial plan features, and real-world scenarios where positional retention is essential. Need expert help? WhatsApp us at +8801911119966 for professional VOS3000 configuration support. ๐
โฑ๏ธ The VOS3000 position keeper dollar sign ($) is a special character used in the Target Prefix field of dial plan rules. When VOS3000 encounters a dollar sign in the target prefix, it retains the digit at the corresponding position from the original dialed number without any modification. The manual ยง4.3.1 states it clearly: โ$ means keep and not change dial plan the position.โ ๐
๐ก Why positional retention matters: Consider a scenario where you need to remove an area code prefix while preserving the subscriber number that follows. Without the position keeper, you would need to know the exact digits of every possible subscriber number โ an impossibility in a production VoIP environment. The dollar sign lets you say โkeep whatever digit is at this positionโ without knowing the actual digit value, enabling generic transformation rules that work across thousands of different numbers.
๐ Location in VOS3000 Client: Operation management โ Gateway operation โ Routing gateway โ Dial plan (also available in Mapping gateway and Phone dial plans)
๐ Understanding the difference between the dollar sign ($) and the asterisk (*) is essential for correct dial plan configuration:
| Feature | Dollar Sign ($) | Asterisk (*) |
|---|---|---|
| Used in | Target Prefix only | Both Original and Target Prefix |
| Behavior | Keeps one specific digit position unchanged | Carries forward all digits matched by * in original |
| Granularity | Per-digit โ each $ preserves one position | Per-group โ * preserves entire matched digit sequence |
| Position control | Exact position โ $ at position 3 keeps digit at position 3 | Relative โ * appends all matched digits after the target prefix |
| Best for | Removing prefix while keeping known-length remainder | Adding prefix while keeping all remaining digits |
๐ Key distinction: The asterisk carries forward all digits as a group at the end of the target prefix, while the dollar sign preserves digits at specific individual positions. The dollar sign gives you positional precision โ you can skip certain positions and keep others โ while the asterisk is a bulk operation that preserves everything matched.
๐ง The VOS3000 manual ยง4.3.1 provides the clearest example of the VOS3000 position keeper dollar sign in action:
| Original Prefix | Target Prefix | Input Number | Result | Explanation |
|---|---|---|---|---|
| 0134 | $$$ | 0134131 | 013131 | $ means keep and not change dial plan the position |
๐ก Breaking down the example: The input number is โ0134131โ. The Original Prefix โ0134โ matches the first four digits. The remaining digits after the prefix are โ131โ (three digits). The Target Prefix โ$$$โ contains three dollar signs, which means โkeep the next three digits from the remaining portion unchanged.โ The result โ013131โ can be understood as: โ013โ (first three digits of original) + โ1โ (first kept digit) + โ3โ (second kept digit) + โ1โ (third kept digit). The dollar signs preserve the positional digits from the portion after the matched original prefix.
| Step | Description | Value |
|---|---|---|
| 1. Match Original Prefix | โ0134โ matches first four digits of โ0134131โ | 0134 โ matched |
| 2. Identify remaining digits | Digits after the matched prefix: โ131โ | 131 |
| 3. Apply $ position keepers | Each $ preserves one digit position from the remaining portion | $=1, $=3, $=1 |
| 4. Construct result | Original prefix portion kept as-is + position-kept digits | 013 + 131 = 013131 |
๐ Important note: The exact behavior of how the original prefix digits are handled in the result depends on whether the Target Prefix contains only dollar signs or a combination of fixed digits and dollar signs. When the Target Prefix is โ$$$โ only, the result reconstructs using the positional mapping described above. The VOS3000 manual ยง4.3.1 confirms the example: โ0134โ โ โ$$$โ transforms โ0134131โ to โ013131โ.
๐ฏ The VOS3000 position keeper dollar sign is most useful in scenarios where you need to strip or modify a prefix while preserving a known number of subsequent digits. Here are practical examples:
| Scenario | Original Prefix | Target Prefix | Input | Output |
|---|---|---|---|---|
| Strip 4-digit area code, keep 7-digit subscriber | 0134 | $$$$$$$ | 01341234567 | 0131234567 |
| Strip prefix and add new prefix with position keeping | 0134 | 025$$$$$$ | 01341234567 | 0251234567 |
๐ก Combining $ with fixed digits: The Target Prefix can mix dollar signs with literal digits. For example, Target Prefix โ025$$$$$$โ means: output the literal digits โ025โ followed by six position-kept digits from the remaining portion of the original number. This lets you remove one area code prefix and replace it with another while preserving the subscriber number โ one of the most common VOS3000 position keeper dollar sign use cases in carrier interconnect scenarios.
๐ Symptom: The transformed number has missing or extra digits compared to the expected result.
๐ก Cause: The number of dollar signs in the Target Prefix does not match the number of remaining digits after the Original Prefix match.
โ Solutions:
๐ Symptom: The transformed number contains literal dollar sign characters instead of preserved digits.
๐ก Cause: The dial plan rule may not be matching the intended Original Prefix, causing the $ characters to be treated as literal text rather than position keeper operators.
โ Solutions:
| Best Practice | Recommendation | Reason |
|---|---|---|
| ๐ Count digits precisely | Use exactly the right number of $ signs for remaining digits | โ Prevents truncation or padding errors |
| ๐ง Use * for variable-length | Switch to * when remaining digit count varies | ๐ฏ $ requires exact digit count knowledge |
| ๐ Combine $ with fixed digits | Prepend new prefix before $ signs when replacing area codes | ๐ก๏ธ Enables prefix swap + digit preservation |
| ๐ Test edge cases | Verify with shortest and longest expected numbers | ๐ Ensures $ works across all number formats |
| ๐ Document $ usage | Add memo comments explaining $ position mapping | ๐ง Future maintainability |
๐ก Pro tip: The VOS3000 position keeper dollar sign is most effective when combined with callee rewrite rules and the rate prefix settings. For number formatting standards, see ITU-T E.164. Use dial plan $ rules for routing-level number transformation, callee rewrite rules for account-level adjustments, and rate prefixes to ensure the billing engine sees the correct number format. For complex multi-stage transformations, reach us at +8801911119966. ๐ง
๐ Complete reference sourced from the VOS3000 2.1.9.07 manual ยง4.3.1:
| Element | Description | Manual Example |
|---|---|---|
| $ in Target Prefix | Keeps and does not change the digit at that position from the remaining portion of the original number | 0134 โ $$$ transforms 0134131 to 013131 |
| Multiple $ signs | Each $ preserves one digit position; three $$$ preserves three positions | $$$ preserves three digits |
| $ with fixed digits | Combine $ with literal digits in Target Prefix for prefix insertion + digit preservation | 025$$$$$$ inserts 025 and preserves 6 digits |
โฑ๏ธ The VOS3000 position keeper dollar sign ($) is a special character used in the Target Prefix field of dial plan rules. It tells VOS3000 to preserve the digit at the corresponding position from the original number without modification. According to the VOS3000 manual ยง4.3.1, โ$ means keep and not change dial plan the position.โ Each dollar sign preserves exactly one digit position, enabling precise number transformation where you remove or modify a prefix while keeping the subsequent digits intact at their exact positions.
๐ง The dollar sign ($) preserves individual digit positions one at a time, while the asterisk (*) carries forward all matched digits as a group. With โ$$$โ, you preserve exactly three specific digit positions. With โ*โ, you preserve all remaining digits after the target prefix in a single operation. The dollar sign gives you positional precision โ you can choose which positions to keep โ while the asterisk is a bulk preservation of everything matched. Use $ when you know the exact number of digits to preserve, and * when the remaining digit count varies.
|carrier interconnect number formatting per ITU-T E.164 standards
๐ If you use more dollar signs than there are remaining digits after the Original Prefix match, the extra dollar signs may produce unexpected results or be treated as having no corresponding digit to preserve. If you use fewer dollar signs, only the first N digits will be preserved and the rest truncated. Always count the exact number of digits that follow the Original Prefix in your input numbers and use exactly that many dollar signs. For variable-length numbers, consider using the asterisk (*) wildcard instead of the dollar sign.
๐ No, the dollar sign position keeper is designed for use in the Target Prefix field only. In the Original Prefix, use exact digits, the asterisk (*) wildcard, or the question mark (?) wildcard for pattern matching. The dollar signโs purpose is specifically to preserve digit positions during the transformation output โ it does not have a matching function in the input pattern. The VOS3000 manual ยง4.3.1 only documents the $ symbolโs behavior in the Target Prefix context.
๐ The VOS3000 position keeper dollar sign works alongside other dial plan features including wildcards (* and ?), escape characters (L/E/G/F), and semicolons. However, mixing $ with ? in the same Target Prefix requires careful attention โ the ? generates a random digit while $ preserves an existing digit. Similarly, using $ within semicolon-separated targets means each target option can independently use dollar signs for positional retention. Always test combined configurations thoroughly to verify the expected transformation behavior.
๐ Still have questions? WhatsApp us at +8801911119966 for quick answers. ๐
๐ง Proper VOS3000 position keeper dollar sign configuration is essential for accurate number transformation, prefix replacement with digit preservation, and clean carrier interconnect formatting per ITU-T E.164 standards. Misconfigured position keeper rules lead to truncated numbers, missing digits, and failed call routing. Whether you need help designing dollar sign patterns, combining $ with other dial plan features, or troubleshooting number transformation issues, our team is ready to assist. Reach us on WhatsApp at +8801911119966 for professional VOS3000 support and configuration services. ๐
For professional VOS3000 installations and deployment, VOS3000 Server Rental Solution:
๐ฑ WhatsApp: +8801911119966
๐ Website: www.vos3000.com
๐ Blog: multahost.com/blog
๐ฅ Downloads: VOS3000 Downloads
Master VOS3000 password policy configuration with SERVER_PASSWORD_LENGTH and SERVER_TERMINAL_ADDITIONAL_CHARACTERS. Enforce strong passwords for telecom security.
Configure VOS3000 login brute-force lockout with SERVER_LOGIN_FAILED_DISABLE_TIME. Lock accounts after repeated failed logins and prevent…
Configure VOS3000 concurrent call abuse blacklist with SS_BLACK_LIST_CALLER_CONCURRENT. Auto-block callers exceeding concurrent limits, stop SIM-box…
Configure VOS3000 no-answer auto-blacklist with SS_BLACK_LIST_NO_ANSWER. Block dead-end numbers, prevent wasted port capacity, and optimize…
Master VOS3000 malicious caller blacklist with SS_BLACK_LIST_CALLER_MALICIOUS_CALL. Configure auto-blacklist for flagged callers, block duration, and…
Master VOS3000 system white list for global allow-list configuration. Learn how system-level trusted numbers override…