Redistribute the client runtime for iSeries

If you have written a client application that accesses resources and enterprise applications within WAS, and you want to distribute that application to third-party iSeries customers who have not purchased WAS v5.0, you need to also provide the third-party customers with the WebSphere client run time. To do this, redistribute the client run time.

The WAS for iSeries product provides a QShell script which you can invoke to create a save file (SAVF) which contains the J2EE and Java thin client run times. This save file can be distributed to iSeries customers who have not purchased the WAS product.

The list below describes the steps you (the distributor) and your customer (third-party) must perform to redistribute and install the client run time:

1. The distributor saves the client application in a save file.

2. The distributor invokes the createClientRuntime QShell script to create the save file containing the WebSphere client run time. Perform these steps to invoke the createClientRuntime script:

   1. Enter the Start QShell (STRQSH) CL command on the OS/400 command line.
   2. Invoke the createClientRuntime script. The createClientRuntime syntax is:

      /QIBM/ProdData/WebAS5/Base/bin/createClientRuntime -library savefilelibrary
      -savefile saveFileToCreate
      

      where saveFileLibrary is the name of the library in which to create the save file and saveFileToCreate is the name of the save file in which to save the client runtime.

      The library specifed for the -library parameter must exist. If the save file specified for the -savefile parameter already exists in the specified library, the contents of the save file are replaced.

3. The distributor may save the client runtime save file and the client application save file into a single save file or elect to provide two save files. The save file is redistributed to the third-party.

4. If a single save is provided, the third-party uses the Restore Object (RSTOBJ) command to restore the save files to a library. For example:

   RSTOBJ OBJ(WASCLIENT MYCLIENT) SAVLIB(LIBRARY) DEV(*SAVF)
   OBJTYPE(*FILE) SAVF(LIBRARY/DISTCLIENT) RSTLIB(CUSTLIB)

5. The third-party restores the client run time from the client run time save file with this command:

   RST DEV('/QSYS.LIB/LIBRARY.LIB/client.FILE')  
   OBJ(('/WebSphere/AppClient' *INCLUDE '/WebSphere/AppClient'))

   where LIBRARY is the name of the library specified for the -libary parameter on the clientClientRuntime invocation and client is name of the save file specified for the -savefile parameter on the clientClientRuntime invocation.

6. After the client runtime is restored, the third-party uses the Restore (RST) command to restore the distributor's client application. For example:

   RST DEV('/QSYS.LIB/LIBRARY.LIB/APPCLIENT.FILE') 
   OBJ(('/DISTCLIENT' *INCLUDE '/WebSphere/AppClient'))

After the client run time and the client application have been restored, the customer can follow the instructions for Run a J2EE application client or Run a thin or pluggable application client to run the client application.