5 2 3 CONNECT

You are here:

5.2.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. If not specified, a default value of 80 is assumed.
	USESSL	*NO	Default. Use HTTP protocol.
	USESSL	*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)