Registering Functions for JSMDirect

On IBM i the JSMDirect program locates the LANSA function to be executed by performing a keyed lookup on file DC@W29V1.

The Host Name is the host component of the request URL this is determined by the HTTP protocol Host keyword.

If the URL is http://www.lansa.com/cgi-bin/jsmdirect then the Host Name is WWW.LANSA.COM:80.

If the URL is http://10.1.2.3/cgi-bin/jsmdirect then the Host Name is 10.1.2.3:80.

This allows multi-homing where the IP address of www.lansa.com and 10.1.2.3 are the same but the HTTP client program specifies the host name in the HTTP protocol allowing the HTTP server to treat www.lansa.com and 10.1.2.3 as different hosts.

A Host Name of *DEFAULT means any host.

JSMDirect first does a keyed lookup for on the Application Name and Host Name, if an entry does not exist then a second keyed lookup on Application Name and *DEFAULT is done.

To update the DC@W29 file use LANSA Integrator Studio or you may use Data File Utility or SQL commands on the file.

Refer to Maintaining Registration File DC@W29.

Structure of file DC@W29:

K

W29SRV

Application Name

Name identifying the application to be executed. This is the name entered as part of the URL.

K

W29LHO

Host Name

Host Name specified either as *DEFAULT or HostName:Port.

 

W29MOD

Process

LANSA process.

 

W29FMT

Function

LANSA function to be executed.

 

W29P#I

Partition

LANSA partition. The process and function must be located in the specified partition.

 

W29PLN

Language

Execution language for the function.

 

W29PGM

Program

3GL program to be executed. If a 3GL program is specified, then the process, function, partition and language fields should be blank.

 

W29RDX

RDMLX

Flag function as an RDML or RDMLX function.

 

W29WSD

WSDL Path

Location of WSDL file.

 

 

Note: The language code is an optional value in the registration of functions in the IBM i DC@W29 but is a required one in dc_w29.txt on Windows. If you don't register the language code in DC@W29, LANSA will run the server function using the partition's default language. If you don't register the language code in dc_w29.txt, JSMDirect will end with an error.

Example (without Program parameter):

 

ORDERENTRY   MYCOMPUTER:80   JSERVICE   JS015   WIZ   ENG

ORDERENTRY   *DEFAULT        JSERVICE   JS016   WIZ   ENG