Topaz, and GemStone sessions in general, have an RPC interface supporting only multiple RPC sessions, and a linked interface that supports one linked and multiple RPC sessions.
To invoke the linked version, the topaz -l flag is used, which leaves the gemnetid field empty or set to a placeholder, this is used during login to indicate that the session should be linked. Subsequently, you can set the gemnetid (to gemnetobject or equivalent) to login an additional RPC session.
However, if you have a .topazini that sets gemnetid, the .topazini is executed as usual when topaz -l is started. This sets the gemnetid so the first login is RPC, not linked.
In v3.4 and later, the -L option instead of -l suppresses set gemnetid statements in topazini files. It is recommended to use this option when you need to start a linked topaz, to avoid any risk from topazini files.
Use caution in specifying a gemnetid in a topazini file.
Using separate topazini files and using -I to explicitly provide the filename, or -i to suppress the default topazini, can avoid problems.
If you are expecting a linked login, note a prompt such as
topaz 2 >
which indicates an RPC login.
Last updated: 10/30/17