Namespace: JollyGiant.Emulation
Assembly: JGSComdotNet (in JGSComdotNet.dll) Version: 1.0.0.0 (1.0.0.0)
Syntax
| C# |
|---|
public StatusCode Start( string qwsPath, string hostname, ref string sessionID, int port, string termType, string luName ) |
| Visual Basic (Declaration) |
|---|
Public Function Start ( _ qwsPath As String, _ hostname As String, _ ByRef sessionID As String, _ port As Integer, _ termType As String, _ luName As String _ ) As StatusCode |
| Visual C++ |
|---|
public: virtual StatusCode Start( String^ qwsPath, String^ hostname, String^% sessionID, int port, String^ termType, String^ luName ) sealed |
| JavaScript |
|---|
function Start(qwsPath, hostname, sessionID, port, termType, luName); |
Parameters
qwsPath
Type: System..::.StringThe String
The fully qualified path to the QWS program to use.
hostname
Type: System..::.StringHost String
Host name or IP address of the host you want to connect to.
sessionID
Type: System..::.String %One
One character session ID to use. The specified ID is only a request to the program. If the requested ID is already in use by another program instance, the last unused ID (Z-A) will be selected and returned in this parameter.
You will need this ID to establish a logical connection to the session before you can exchange information with it.
port
Type: System..::.Int32The Int32
The port number the host is listening on for incoming connections.
termType
Type: System..::.StringRequested String
Requested terminal type string (IBM-3278-2-E"). If this parameter is null or empty, the program default terminal type will be used.
luName
Type: System..::.StringLogical String
Logical Unit name requested. This can be null or an empty string.
Return Value
The StatusCode indicating the result of the operation.This can be one of the following values:
| Status code | Description |
|---|---|
| Ok | The new program instance was started successfully. |
| InvalidPsId | The requested session ID was not a valid (A-Z,a-z) character. |
| WHLLTOOMANYSESSIONS | All 26 session IDs are already in use. |
| WHLLSTARTPROCFAILED | Unable to start the new process. |
| WHLLUNKNOWN | An unknown error occurred. |
Implements
IApplication..::.Start(String, String, String%, Int32, String, String)Examples
string qwsPath = @"C:\Program Files\QWS3270 PLUS\qws3270p.exe"; string hostName = @"jollygiant.dnsalias.com"; string termType = @"IBM-3279-4-E"; string luName = @"myluname"; string id = "A"; int port = 1023; StatusCode sc = qws.Start(qwsPath, hostName, ref id, port, termType, luName);
Exceptions
| Exception | Condition |
|---|---|
| System..::.ArgumentException | Program path or host name are null or empty strings. |
| System.IO..::.FileNotFoundException | The file specified in qwsPath could not be found. |