9 147 JSMX_OPEN

LANSA Technical

9.147 JSMX_OPEN

Þ Note: Built-In Function Rules.

This Built-In Function opens a connection to the JSM server, which starts a service thread to handle commands to be sent by the JSMX_COMMAND BIF.

JSMX_OPEN returns a handle, which identifies the JSM connection.

If no server argument is supplied, then the JSM server host is obtained by reading the JSMCLTDTA data area.

See also: 9.146 JSMX_COMMAND and 9.145 JSMX_CLOSE.

For use with

LANSA for i

YES

Only available for RDMLX.

Visual LANSA for Windows

YES

Only available for RDMLX.

Visual LANSA for Linux

YES

Only available for RDMLX.

 

 

Arguments

No

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

1

A

Opt

Server (host:port), Default is *BLANKS

1

50

 

 

 

 

Return Values

No

Type

Req/ Opt

Description

Min Len

Max Len

Min Dec

Max Dec

1

U

Req

Status

1

20

 

 

2

U

Req

Message

1

Unlimited

 

 

3

A

Req

Handle to connection

4

4

 

 

 

 

Examples

Example 1: Open a connection using server in JSMCLTDTA data area.

USE BUILTIN(JSMX_OPEN) TO_GET(#JSMSTS #JSMMSG #JSMHDNL)
 

Example 2: Open a connection specifying a server.

USE BUILTIN(JSMX_OPEN) WITH_ARGS(#JSMSRV) TO_GET(#JSMSTS #JSMMSG #JSMHDNL)