Configuring the WebFacing server for multiple interactive subsystems

Depending on the number of users that you have and the number of WebFacing jobs that are created on your system, you may want to configure additional interactive subsystems to handle WebFacing jobs. Using multiple interactive subsystems improves the scalability of WebFacing by:
  • Increasing the total number of WebFacing jobs that can be run on your machine.
  • Load balancing: WebFacing jobs are assigned in a distributed manner so that they are spread optimally among configured subsystems.

Up to 16 additional subsystems can be configured for WebFacing. If no other subsystems are configured, by default, WebFacing jobs run in the QINTER subsystem. Assess the need for using additional subsystems based on your knowledge of how many users you have and the capabilities of your hardware. Keep in mind that an interactive job is created for each user logon whether the logon is through a 5250 session or a WebFacing session. Note, when additional subsystems are configured for WebFacing, QINTER is no longer used for WebFacing interactive jobs.

WebFacing interactive jobs are named by using a device name convention QQFn* where n represents which subsystem is being used in a sequence of up to 16. The value for n follows hex numbering conventions. In hex, the first 10 values for n are represented with the numbers 0 through 9 and the next six values (values 10 to 15) are represented with the letters A through F. For example, names for jobs in the first subsystem will begin with QQF0*, names for jobs in the twelfth subsystem will begin with QQFB*. If no additional subsystems are configured, WebFacing interactive jobs can be identified in the QINTER subsystem by names beggining with the string QQF0*.

  1. If necessary, modify the QINTER subsystem so that WebFacing jobs are no longer processed there. This is required if *ALL is the value currently used in the Work station name field for Work Station Entry values in QINTER. Use the DSPSBSD command to view your current settings. If required, replace *ALL with the display device name convention used for your system. For example, some systems use QPADEV*.
  2. Create additional interactive subsystems for WebFacing jobs. These subsystems should be modelled after QINTER. Create these subsystems by creating subsystem descriptions using the CRTSBSD command.
  3. When the WebFacing server is installed, a data area called QQFCONFIG is created for it in the library QQFTEMP. Change the SBS value in the QQFTEMP/QQFCONFIG data area to the number of interactive subsystems to be used for WebFacing. In this data area, a default name/value pair of SBS=01; is created to define the number of interactive subsystems to be used for WebFacing. To change the default value, use the command WRKDTAARA DTAARA(QQFTEMP/QQFCONFIG) . Choose option 2=Change and then in the New value field enter SBS=nn; where nn is the number of subsystems you will be using for WebFacing. This can be from 1 to 16. For example, SBS=16;. Although you enter the value in decimal notation, at run-time the SBS number is displayed in hexadecimal format. If you want to display your current values, use the command DSPDTAARA DTAARA(QQFTEMP/QQFCONFIG) .
  4. Using the ADDWSE command, add work station entries for WebFacing for each additional subsystem that you are going to use. Populate the Work station name field of the Add Work Station Entry screen with the WebFacing device name to be used for that subsystem. Follow the hex numbering conventions described earlier to determine what values to use. Hex values for the first 10 subsystems are 0 to 9. Hex values for the next six subsystems (10 to 15) are A to F. For example, in the ADDWSE screen for the first subsystem, enter QQF0*. For the second subsystem, enter QQF1*. For the sixteenth subsystem, enter QQFF*.
  5. For these changes to take effect, stop and then start the WebFacing server. For V4R5, to stop the WebFacing server, use the command ENDWFSVR . To start the server, use the command STRWFSVR . For V5R1 and later, to stop the WebFacing server, use the command ENDTCPSVR SERVER(*WEBFACING) . To start the server, use the command STRTCPSVR SERVER(*WEBFACING) .

Feedback