Usage Notes

The connection configuration string is implementation-specific. Different implementations of the lsxECLConnMgr class may require different formats or information in the configuration string. The new connection is started upon return from this call, but it may or may not be connected to the host.

PROFILE=[']<filename>['] [NAME=<c>] [WINSTATE=<MAX|MIN|RESTORE|HIDE>]

Optional parameters are enclosed in square brackets []. The parameters are separated by at least one blank. Parameters may be in upper, lower, or mixed case and may appear in any order. The meaning of each parameter is as follows:

• PROFILE=<filename>: Names the Personal Communications workstation profile (.WS file), which contains the configuration information. This parameter is not optional; a profile name must be supplied. If the file name contains blanks the name must be enclosed in single quotation marks. The <filename> value may be either the profile name with no extension, the profile name with the .WS extension, or the fully qualified profile name path.
• NAME=<c> specifies the short ID of the new connection. This value must be a single, alphabetic character (A-Z or a-z). If this value is not specified, the next available connection ID is assigned automatically. If a connection already exists with the specified ID a connection not Open error is thrown.
• WINSTATE=<MAX|MIN|RESTORE|HIDE> specifies the initial state of the emulator window. The default if this parameter is not specified is RESTORE.