3.1.1 JSM_OPEN

The JSM_OPEN Built-In Function is always executed first. It is used to connect the JSM client to the Java Service Manager and to start a thread for the service. Each client will have its own thread.

Syntax:

Arguments

No

Type

Required
Optional

Description

Min
Length

Max
Length

Min
Decimal

Max
Decimal

1

A

Optional

Server

50

50

 

 

 

 Return Values

No

Type

Required
Optional

Description

Min
Length

Max
Length

Min
Decimal

Max
Decimal

1

A

Required

Status

20

20

 

 

2

A

Required

Message

1

256

 

 

 

The server argument is optional for the connection. If the server argument is not supplied, or if the argument value contains blanks, then the remote host and port number is obtained from the data area JSMCLTDTA on IBM i or from file jsmcltdta.txt on Windows or Linux.

The server argument can have any of the following values:

host:port

Use specified host and port

host

Use host and get port from JSMCLTDTA

:port

Use port and get host from JSMCLTDTA

:

Get host and port from JSMCLTDTA

 

Get host and port from JSMCLTDTA

 

The JSM_OPEN must be executed before the JSM_COMMAND can be used.

The JSM_OPEN Built-In Function performs a DNS lookup to resolve the host name address. Using a dotted decimal IP address does not get around this DNS lookup.

If the JSM_OPEN Built-In Function is slow to open a connection then you could have a DNS lookup issue. Add an entry to the local host table to improve performance.

TCP/IP connection performance can be improved if the registered DNS servers are available and performing well.

 

Change TCP/IP Domain

Host name search priority           *LOCAL

Domain name server

Internet address                    139.130.4.4

                                    203.48.48.13

 

If the first Domain Name Server (DNS) in the list does not respond, the second DNS server in the list will be contacted. If the second DNS server does not respond, the third DNS server will be contacted.

See IBM i - Network Performance for further information.