|
| QWS3270 COM .NET Help |
| Application..::.Start Method (String, String, String%, Int32, String, String) |
| Application Class Example See Also Send Feedback |
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 fully qualified path to the QWS program to use.
hostname Type: System..::.StringHost name or IP address of the host you want to connect to.
sessionID Type: System..::.String %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 port number the host is listening on for incoming connections.
termType Type: System..::.StringRequested 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 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. |