5.3.3 CONNECT
The CONNECT command is used to connect to an aXes server and signon the 5250 session using the server identification and user credentials provided.
To exchange field RTNSIG and RTNSCREEN values, you will need to specify the SERVICE_EXCHANGE(*FIELD) in the command string.
Syntax:
|
Command |
Keyword |
Value |
Developer notes |
|
CONNECT |
HOST |
value |
Required. The host name or IP address of the machine hosting the aXes terminal server to which you wish to connect. |
|
USER |
value |
Required. The user name used to connect to the aXes terminal server. This must be the name of an authorised i/OS user profile. |
|
|
PASSWORD |
value |
Required. The password for the user name specified in the USER keyword. |
|
|
PORT |
value |
Optional. The port number to be used to connect to the aXes terminal server. |
|
|
USESSL |
*NO |
Default. Use HTTP protocol. |
|
|
*YES |
Optional. Use HTTPS protocol. |
||
|
PROJECT |
value |
The aXes project to use for this session. A project contains user defined definitions of screens and fields. For example, you can assign a name to a screen or a field, and later use that name to refer to the screen or the field in your code. Although aXes projects can either be stored in a file on the file system or on the aXes server, you may only specify here an aXes server-based project. |
|
|
RTNSIG |
field-name |
The name of a field exchanged between your client program and the JSM that will receive the screen signature of the screen that is present, following the successful connection. |
|
|
RTNSCREEN |
field-name |
The name of a field exchanged between your client program and the JSM that will receive the name of the screen that is present following the successful connection. The screen name is the user-defined name if an aXes project name was specified on the CONNECT command and a name was assigned to the screen. Otherwise the screen signature is returned. |
Example
CONNECT HOST(host) USER(user) PASSWORD(password) SERVICE_EXCHANGE(*FIELD)