| 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.
No | Type | Req/ Opt | Description | Min Len | Max Len | Min Dec | Max Dec |
|---|---|---|---|---|---|---|---|
1 | A | Opt | Server (host:port), Default is *BLANKS | 1 | 50 |
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 |
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)