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