4 1 4 JSMDirect Set up on Windows

4.1.4 JSMDirect Set up on Windows

If IIS is installed on the target PC, the install/upgrade will automatically configure IIS so that the physical folder JSMCGI is mapped to the virtual folder cgi-bin.

If IIS is not installed, you will need to manually configure the Web Server.

You must manually specify the Windows logon for executing the jsmdirect.exe CGI program.

By default, IIS would use the default Windows logon IUSR_<machinename> to execute CGI programs.

Note that the specific Windows logon must have read/write access rights to the LANSA installation directory, as a minimum, in order to run LANSA applications properly. (Normally, the default Windows logon does not have enough privileges to access the LANSA installation directory and will not be able to run LANSA applications properly.)

The specific Windows logon is also required for obtaining log files from jsmdirect.exe. For more details refer to Log files (Windows).

Ensure that x_lansa.pro contains an entry USER=<the LANSA user profile that JSM http requests will be given> or PSTC=Y. When a request is received by JSM to run a function, this is the LANSA user profile that the job will run under. Also provide the DBUS and PSWD parameters, unless database trusted connections are being used or the user id and password are contained in the ODBC DSN.

To specify the Windows logon:
(This description is based on the Internet Services Manager for Windows 2000. The equivalent administration programs in other Windows versions may be slightly different.)

1.  Start the Internet Services Manager.

2.  Browse to the appropriate virtual directory eg. cgi-bin and right click on the file jsmdirect.exe in the virtual directory and select menu item Properties.

3.  The jsmdirect.exe Properties dialog box will open. Select the File Security tab and then the Edit button in the frame titled Anonymous access and authentication control.

4.  The Authentication Methods dialog box will open. Check (select) the Anonymous access option and press the Edit button next to the Account used for anonymous access label.

5.  The Anonymous User Account dialog box will open. Uncheck (i.e. deselect) the Allow IIS to control password option - this is IMPORTANT if you specify a Windows logon username which is not located on the workstation - then specify the Windows logon username and password of the user profile used to run LANSA applications. The case of the password must match the case of the password as it was entered into Windows user maintenance. Note that if a workstation belongs to a Windows domain and a Windows User exists on both the Domain and the Local (on the workstation), the Domain User logon takes precedence.

6.  Close all the above dialogs by clicking on the OK button.