Advanced Message Processing System (AMPS) JavaScript Developer Guide

Version 5.3

Publication Date Sep 27, 2024

Contents:

• 1. Introduction
  • Prerequisites
  • JavaScript Support
• 2. Obtaining and Installing the AMPS Client
  • Manual Installation
  • Installation via Node Package Manager
• 3. Your First AMPS Program
  • About the Client Library
  • Including the Client in a Project
    • Node.js / CommonJS Module
    • ES6 / TypeScript Module
    • AMD / RequireJS Module
    • Global Import in a Browser Environment
  • Connecting to AMPS
    • Examining the Code
    • Syntax Convention
  • Client Names
  • Connection Strings
    • Providing Credentials in a Connection String
  • Next Steps
• 4. Subscriptions
  • Subscribing to a Topic
  • Understanding Promises and Message Handlers
  • Understanding Messages and Commands
    • Header Properties
    • Message Data
  • Unsubscribing
  • Advanced Messaging Support
    • Regex Subscriptions
    • Content Filtering
    • Updating the Filter on a Subscribe
  • Next Steps
• 5. Error Handling
  • Disconnect Handling
    • Using a Heartbeat to Detect Disconnection
    • Managing Disconnection
    • Replacing Disconnect Handling
  • Unhandled Errors
• 6. State of the World (SOW)
  • Performing SOW Queries
  • SOW and Subscribe
    • sowAndSubscribe()
    • Execute a Command
    • OOF Messages
  • Setting Batch Size
  • Managing SOW Contents
• 7. Using Queues
  • Backlog and Smart Pipelining
    • Subscription Backlog
    • Acknowledging Messages
    • Automatic Acknowledgment
    • Message Convenience Method
    • Acknowledgment Batching
    • Returning a Message to the Queue
    • Manual Acknowledgment
• 8. Delta Publish and Subscribe
  • Introduction
  • Delta Subscribe
  • Delta Publish
• 9. High Availability
  • Reconnection with Client
  • Choosing Store Durability
  • Connections and the Server Chooser
    • Setting a Reconnect Delay and Timeout
    • Implementing a Server Chooser
  • Heartbeats and Failure Detection
  • Considerations for Publishers
  • Considerations for Subscribers
    • Resubscription With SubscriptionManager
    • Bookmark Stores
  • Conclusion
• 10. AMPS Programming: Working with Commands
  • Understanding AMPS Messages and Commands
  • Creating and Populating a Command
  • Using Execute
  • Command Cookbook
  • Publishing
    • Basic Publish
    • Publish With CorrelationId
    • Publish With Explicit SOW Key
  • Subscribing
    • Basic Subscription
    • Subscription with Options
    • Subscription with Select List
    • Subscription with Content Filter
    • Conflated Subscription to a SOW Topic
    • Conflated Subscription to a Topic with No SOW
    • Bookmark Subscription
    • Rate Controlled Bookmark Subscription
    • Rate Controlled Bookmark Subscription with Maximum Gap
    • Bookmark Subscription with Completed Acknowledgment
    • Bookmark Subscription with Content Filter
    • Pausing a Bookmark Subscription
    • Resuming a Bookmark Subscription
    • Replacing the Filter on a Subscription
    • Subscribing to a Queue and Requesting a max_backlog
  • SOW Query
    • Basic SOW Query
    • SOW Query with Options
    • SOW Query with Ordered Results
    • SOW Query with TopN Results
    • SOW Query with Content Filter
    • Historical SOW Query
    • Historical SOW Query with Content Filter
    • SOW Query for Specific Records
    • SOW Query with Pagination
    • Aggregated SOW Query
  • SOW and Subscribe
    • Basic SOW and Subscribe
    • SOW and Subscribe with Options
    • SOW and Subscribe with Select List
    • SOW and Subscribe with Content Filter
    • Conflated SOW and Subscribe
    • Paginated SOW and Subscribe
    • Historical SOW and Subscribe
    • Historical SOW and Subscribe with Content Filter
    • Aggregated SOW and Subscribe
  • Delta Publishing
    • Basic Delta Publish
    • Delta Publish with CorrelationId
    • Delta Publish with Explicit SOW Key
  • Delta Subscribing
    • Basic Delta Subscription
    • Delta Subscription with Options
    • Delta Subscription with Content Filter
  • SOW and Delta Subscribe
    • Basic SOW and Delta Subscribe
    • SOW and Delta Subscribe with Options
    • SOW and Delta Subscribe with Content Filter
    • Paginated SOW and Delta Subscribe
    • Aggregated SOW and Delta Subscribe
  • SOW Delete
    • Delete All Records in a SOW
    • Delete SOW Records Matching a Filter
    • Delete a Specific Message by Data
    • Delete Specific Messages using Keys
    • Acknowledge Messages from a Queue
• 11. Message Types
  • Composite Message Types
    • Building Composite Messages
    • Parsing Composite Messages
  • Custom Message Types
    • Create New Type Helpers
    • Override Default Type Helpers
  • FIX / NVFIX delimiters
• 12. Advanced Topics
  • Transport Filtering
  • Using WebSocket over SSL
• 13. Performance Tips and Best Practices
  • Measure Performance and Set Goals
  • Simplify Message Format and Contents
  • Use Content Filtering Where Possible
  • Use Hash Indexes Where Possible
  • Use Error Handler
  • Reduce Bandwidth Requirements
    • Tune Batch Size for SOW Queries
    • Conflate Fast-Changing Information
    • Minimize Bandwidth for Updates
    • Conflate Queue Acknowledgments
    • Use a Transaction Log When Monitoring Publish Failures
    • Combine Conflation and Deltas
  • Limit Unnecessary Copies
  • Manage Publish Stores
  • Work with 60East as Necessary