Deploying IBM Workplace Services Express on the IBM eServer iSeries Server

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

analysis.

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

file.

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:

crtlib wsetools

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:

crtsavf file(wsetools/wsetools)

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

ftp iSeriesServerName

ii. Enter your iSeries user name.

iii. Enter your iSeries password.

iv. Type the following commands in the order shown when prompted:

bin

put wsetools.savf /qsys.lib/wsetools.lib/wsetools.savf

quit

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:

ADDLIBLE LIB(WSETOOLS)

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:

WSETOOLS/CRTWSESBS INSTANCE(itsowse2)

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:

WSETOOLS/STRWSESVR

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.

C:\>ftp rchas12

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.

Password:

230 KGREENE logged on.

ftp> bin

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.

ftp> quit

221 QUIT subcommand received.