Changing the port used by your WebFacing applications

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
  1. Open the IDE and select the WebFacing Projects tab.
  2. 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.
  3. Open the Run Time > Properties > Project section of the properties page.
  4. Click the Change button next to the Host port field.
  5. 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
  1. Open the IDE and select the WebFacing Projects tab.
  2. 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.
  3. Open the Run Time > Properties > Project section of the properties page.
  4. Click the label for the CL command that you want to work with.
  5. Click the Change button next to the Host port field.
  6. Click Edit in the Host Selection dialog to change the Host port. Click OK when finished. Changes are saved to the web.xml file.

Feedback