The ConnectPS (call number 1) is used to connect to either a new or existing Screen Tools session. The datastring parameter of the HLLAPI call is used to pass the target session. With FlyHLLAPI, not only the target session but also some additional connection options may be passed.
Use each time you are performing operations on a screen session. You must provide a session ID or "A..Z" for the session to connect to.
Affected by FlyHLLAPI session options: AUTOSTART, ADMINSTART, EXTSTART and STDSTART (see following section).
FlyHLLAPI Extension: Numeric Identifier
With FlyHLLAPI, you can utilise a numeric session identifier instead of a single letter. When requesting a session with a numeric ID, more than one character may be used in the datastring.
When you do this, note that there are other calls besides ConnectPS that use the session ID that only provide room for a single letter...if your server is not licensed for over 26 sessions, you may choose to utilize the letter as the session identifier. If you do use the numeric identifier, when using calls that can specify a sessionID, try to use the "blank" option, or "currently connected session".
FlyHLLAPI Extension: Auto-allocated Session
With FlyHLLAPI, you can use the asterisk (*) for "next available"... note that this may be a new session or one that is already active and has been disconnected using the keepopen option.
FlyHLLAPI Extension: Connection Options
Optional parameters-- follow session ID with a blank, then {...} where inside the curly braces are connection style settings:
hostName:nameAsDefinedInRegistry (use this alone for specific host, without, first is default)
{othervalue:setting;another:setting;yetanother:setting}
All names match the registry names under the Hosts key subkeys, separated by semicolons (like a style sheet definition) such as:
Protocol:TN3270
Address:localhost
CodePageTable:CP037
TNLevel:basic | tn3270 | tn3270e
ConnectTestColumn:7
ConnectTestRow:12
ConnectTestText:LOGON"
ConnectSilentCount:23
ConnectTimeoutCount:200
ScreenRowsNorm:24
ScreenColsNorm:80
ScreenRowsAlt:27
ScreenColsAlt:132
IgnoreHostDrop:no
TransitionTimeout:20000
TerminalType:IBM-3278-2
