Chapter 9. Performance tuning 263
9.3.4 Changing the subsystem Workplace Services Express jobs run in
The default subsystem for all Workplace Services Express servers is the QEJBAS5
subsystem. There are times when it might be more appropriate to run a Workplace Services
Express server in a separate subsystem. Some reasons include, but are not limited to, better
control over memory management, better control over run priorities, or aid in JVM heap
A sample utility allows Workplace Services Express servers to be moved to a run in a
different subsystem. This utility is a set of CL programs that are packaged in a save file. See
Appendix C, “Additional material” on page 359, for information about downloading this save
Installing the utility on the iSeries server
Perform the following steps to install the library that contains the CL programs for changing
the subsystem in which the Workplace Services Express server jobs run.
1. Download the save file. See Appendix C, “Additional material” on page 359, for
information about downloading this save file.
2. Create a library on the iSeries to hold the contents of the save file using the Create Library
(CRTLIB) CL command. In this example, we enter:
3. Create a save file in the library that you just created to hold the save file that you
downloaded in step 1 using the Create Save File (CRTSAVF) CL command, for example:
4. Send the utility from your PC to the iSeries server using File Transfer Protocol (FTP):
a. Open a DOS prompt command and change to the directory on the PC where you
downloaded the savefile.
b. Using FTP as explained in the following steps, send the savefile to the savefile that you
just created on your iSeries server. See Figure 9-5 for an example.
i. Type the following command
ii. Enter your iSeries user name.
iii. Enter your iSeries password.
iv. Type the following commands in the order shown when prompted:
put wsetools.savf /qsys.lib/wsetools.lib/wsetools.savf
264 Deploying IBM Workplace Services Express on the IBM Eserver iSeries Server
Figure 9-5 Sending the WSETOOLS savefile to the iSeries using FTP
5. Now that the utility is sent to the iSeries server, restore the objects from the save file, using
the following Restore Objects (RSTOBJ) CL command:
RSTOBJ OBJ(*ALL) SAVLIB(WSETOOLS) DEV(*SAVF) SAVF(WSETOOLS/WSETOOLS)
6. Add the WSETOOLS library to your library list using the following Add Library List Entry
(ADDLIBLE) CL command:
You are now ready to use the CL programs in WSETOOLS library to change the subsystem in
which the Workplace Services Express server jobs run.
Creating a new subsystem description
The CL program provided in the WSETOOLS library to start a Workplace Services Express
server requires that a new subsystem description is created. The name of the subsystem
description should match the name of your Workplace Services Express server.
To create the new subsystem description, use the following CRTWSESBS command:
This command creates a subsystem called ITSOWSE2 in library WSETOOLS. Replace the
instance name, itsowse2, with the name of your Workplace Services Express server.
Starting a Workplace Services Express server in its own subsystem
Next you must start the Workplace Services Express server in the new subsystem that you
just created. You do this by issuing the Start Workplace Express Server (STRWSESVR)
command, for example:
When you type this command, you see the Start Workplace Express Server display shown in
Figure 9-6. Provide the name of the Workplace Services Express server and specify which
server jobs you want to start.
Connected to RCHAS12.rchland.ibm.com.
220-QTCP at RCHAS12.RCHLAND.IBM.COM.
220 Connection will close if idle more than 166666 minutes.
User (RCHAS12.rchland.ibm.com:(none)): kgreene
331 Enter password.
230 KGREENE logged on.
200 Representation type is binary IMAGE.
ftp> put wsetools.savf /qsys.lib/wsetools.lib/wsetools.savf
200 PORT subcommand request successful.
150 Sending file to member WSETOOLS in file WSETOOLS in library WSETOOLS.
250 File transfer completed successfully.
ftp: 494208 bytes sent in 0.98Seconds 501.73Kbytes/sec.
221 QUIT subcommand received.