9.125 JSMX_OPEN

Note: Built-In Function Rules     Usage Options

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.124 JSMX_COMMAND and 9.123 JSMX_CLOSE.

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)