DbsName (Imagine property)
Jump to navigation
Jump to search
DbsName: Return the DBS name for the current connection
The DbsName method returns the DBS name for the current Imagine connection as a String.
If no DBS name was sent by the broker, an empty string is returned.
This is a shared, read-only method.
Syntax
%name = %(imagineObject):DbsName
Return value
A String containing the DBS name for the current connection (up to 63 characters), or an empty string if no DBS name was provided.
Usage
Use DbsName to determine which DBS instance the connecting broker requested during the handshake. This is useful in APSY code that needs to identify the target DBS on a port with APSYSUFFIX defined.
This is new as of Model 204 version 8.0.
Example
%dbsName = %(system):DbsName If %dbsName NE Then Print 'DBS: ' %dbsName End If