3 3 ILE RPG Client

LANSA Integrator

3.3 ILE RPG Client

WARNING. The RDML BIF has been changed to support 256 byte message and command parameters.
Any ILE RPG program binding to the DCXS882X service program must still use 255 byte parameters.

Four API calls are required for an ILE RPG client to have complete interaction with the Java Service Manager services.

These APIs only allow a single connection within the same job.

3.3.1 JSMOPEN

Open service.

3.3.2 JSMCMD & JSMCMDX

Send command.

3.3.3 JSMCLOSE

Close service.

The RPG developer only needs to understand how to use the commands offered by the JSM services.

The overall structure of the RPG programs will be the same.

The program will perform the following operations:

  • OPEN connection to the Java Service Manager.
  • Issue a COMMAND to LOAD the service.
  • Execute COMMANDs supported by the service.
  • Issue a COMMAND to UNLOAD the service
  • CLOSE connection to the Java Service Manager

On IBM i the ILE RPG client program needs to be bound to service program DCXS882X and this service program needs to be shipped with the client program. The client program is also dependent on data area JSMCLTDTA and JSMMSGF message file.

Example source code and how to create a program are located in files QRPGLESRC and QCLSRC in the JSM library (as nominated during the LANSA Integrator install).

Overview of field and list exchange

Command

No fields

No list

Command SERVICE_STRUCTURE(...)

Fields

No list

Command SERVICE_STRUCTURE(...) OCCURS(...) SIZE(...) COUNT(...)

No fields

List

 

Note: You cannot have both fields and a list.