The WebFacing server acts as a gateway between WebSphere® Application
Server and your original i5/OS® application. The WebFacing server will listen
on a predefined TCP port to exchange data with WebFacing applications (Web
or portlet). All WebFacing applications connecting to the server on the same i5/OS need
to be configured to connect to the assigned TCP port. By default, the server
listens on port 4004. This value can be changed using the i5/OS WKSRVTBLE
command to modify the TCP service as-WebFacing. If you have changed the port
WebFacing server listens to on your i5/OS server (see Changing the port used by the WebFacing server),
you will need to change the port used by your WebFacing applications so your
WebFacing applications will work properly with the new port.
Changing
the WebFacing port number defined in your WebFacing projects
The
port number used by a WebFacing application to communicate with the WebFacing
server can be changed for the project as a whole or for individual CL commands.
Ports defined for CL commands take precedence over the port defined for your
project. Each CL command that your application uses will have a separate link
for it in the index.jsp file that is created by the WebFacing conversion.
If necessary, you can define a different host and associated port for each
link. One reason for defining CL commands that use different hosts or ports
is if you have a WebFacing project that accesses applications on more than
one server. Port changes for your project or CL commands are stored in the
deployment descriptor file web.xml.
Note: If you are changing a port setting
used by a project that has already been deployed, generally, you must re-deploy
and then restart the application in the WebSphere Administrative Console.
Alternatively, you can search for the IFS location on your i5/OS server
where your WebFacing Web application's web.xml file is installed and redeploy
from the workbench just that one file. This alternative method still requires
a restart of the application. However, it can be a convenient method of changing
the ID and password if your application is large.
Changing the
port for your project
- Open the IDE and select the WebFacing Projects tab.
- Access the properties page for your project. Select and right-click the
icon for the WebFacing project whose port you would like to change and then
select Properties. The Properties page opens.
- Open the section of the properties page.
- Click the Change button next to the Host
port field.
- Click Edit in the Host Selection dialog to change
the Host port. Click OK when finished. Changes are
saved to the web.xml file.
Changing the port for a CL command
- Open the IDE and select the WebFacing Projects tab.
- Access the properties page for your project. Select and right-click the
icon for the WebFacing project whose port you would like to change and then
select Properties. The Properties page opens.
- Open the section of the properties page.
- Click the label for the CL command that you want to work with.
- Click the Change button next to the Host
port field.
- Click Edit in the Host Selection dialog to change
the Host port. Click OK when finished. Changes are
saved to the web.xml file.