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.
Note: You usually need to specify SERVICE_EXCHANGE(*FIELD) in the command string in order to receive the return values into your client program variables named on keywords beginning with RTNxxx. Refer to 5.41.2 Using the AxesTerminalService for more information.
Required
CONNECT --------- HOST ------------ value ---------------------->
>-- USER ------------ value ---------------------->
>-- PASSWORD -------- value ---------------------->
Optional
>-- PORT ------------ 80 ---------------------->
value
>-- USESSL ---------- *NO ---------------------->
*YES
>-- PROJECT --------- value ---------------------->
>-- RTNSIG ---------- field-name ----------------->
>-- RTNSCREEN ------- field-name -----------------|
Keywords
|
HOST |
Required. The host name or IP address of the machine hosting the aXes terminal server to which you wish to connect. |
|
USER |
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 |
Required. The password for the user name specified in the USER keyword. |
|
PORT |
The port number to be used to connect to the aXes terminal server. If not specified, a default value of 80 is assumed. |
|
PROJECT |
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 |
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 |
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. |
Examples
RDML Example:
DEFINE FIELD(#MYSCREEN) REFFLD(#STD_TEXT)
CHANGE FIELD(#JSMCMD) TO('CONNECT HOST(MYSERVER) USER(QUSER) PASSWORD(QUSER) RTNSCREEN(MYSCREEN) SERVICE_EXCHANGE(*FIELD)'
USE BUILTIN(JSM_COMMAND) WITH_ARGS(#JSMCMD) TO_GET(#JSMSTS #JSMMSG)
RDMLX Example:
define field(#myscreen) reffld(#std_text)
#jsmcommand := 'CONNECT HOST(MYSERVER) USER(QUSER) PASSWORD(QUSER) RTNSCREEN(MYSCREEN) SERVICE_EXCHANGE(*FIELD)'
use builtin(jsmx_command) with_args(#jsmhandle #jsmcommand) to_get(#jsmstatus #jsmmessage)