The WebFacing server acts as a gateway between WebSphere® Application Server
and your original IBM® i application. The WebFacing server
will listen on a predefined TCP port to exchange data with WebFacing
applications. All WebFacing applications connecting to the server
on the same IBM i 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 IBM i WKSRVTBLE
command to modify the TCP service as-WebFacing. If you have changed
the port WebFacing server listens to on your IBM i 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 IBM i 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.
- Select the check box for Override project
settings with this command.
- 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.