2.1 Task: Configure the Java Service Manager on IBM i

After you have installed the LANSA Integrator, you must check that the default instance values are suitable.

Before You Begin

1.  Review the work management objects created in the Java Service Manager library.
A library (default JSMLIB) is created during the install and stores objects used by the Java Service Manager. This includes a number of work management objects such as the JSM subsystem description and JSM job description.

2.  If you specified a LANSA program library when installing the Java Service Manager then the work management objects will have been adjusted to use the correct LANSA libraries.

Step 1. ADDLIBLE JSMLIB

Use the ADDLIBLE LIB(<jsmlib>) (e.g. JSMLIB) command to include the JSM library to your library list.

Step 2. Go JSM

1.  Use the command GO JSM to call the Java Service Manager Administrator Menu.

Step 3. Check configuration values

1.  Check the *DEFAULT value of the JSM instance directory to confirm that the location is the same as the directory to which the JSM manager was restored.

DSPDTAARA DTAARA(JSMMGRDTA)

 

Data area . . . . . . . :   JSMMGRDTA  

Library . . . . . . . . :   DEVJSM   

Type  . . . . . . . . . :   *CHAR      

Length  . . . . . . . . :   50         

Text  . . . . . . . . . :   JSM Manager Configuration          

                

Offset      *...+....1....+....2....+....3....+....4....+....5 

     0      '/lansa_<jsmlib>/jsm/instance          '

2.  Check the default value of the JSMClient host and port value. This value must match the tcp.interface and tcp.port entry from the manager.properties file.

DSPDTAARA DTAARA(JSMCLTDTA)

 

Data area . . . . . . . :   JSMCLTDTA     

Library . . . . . . . . :     DEVJSM      

Type  . . . . . . . . . :   *CHAR         

Length  . . . . . . . . :   100           

Text  . . . . . . . . . :   JSM Client Configuration              

                   

Offset      *...+....1....+....2....+....3....+....4....+....5 

     0      'LOCALHOST:4560            '   

    50      'JSM                       '   

3.  Use menu option 4. Edit Manager Properties of the Java Service Manager Administrator Menu, to display the contents of the manager.properties file.

Edit File: /devjsm/instance/system/manager.properties

 

#             

# Java Service Manager configuration  

#             

tcp.port=4560 

tcp.backlog=20

tcp.interface=*all  

#             

console.tcp.port=4561    

console.tcp.backlog=5     

console.tcp.interface=*all     

 

The tcp.interface value of *all means all interfaces on the machine, so LOCALHOST is valid.

Step 4. Optimize Java Service Manager

If you did not run this process when you installed LANSA Integrator, you will need to optimise the supplied jar files now.

The optimize process uses the CRTJVAPGM command to create IBM i objects from the JSM jar files.

These IBM i objects are used by the JAVA command for direct program execution.

Use option 3. Optimize Java Service Manager of the Java Service Manager Administrator Menu.

Note that this job is submitted to batch and is a long running task.

You have now completed the Java Service Manager installation.