Running Application Engine Processes on the Server

PeopleSoft Upgrade Assistant uses the PROCESSREQUEST component interface object to submit jobs to run on the PeopleSoft Process Scheduler server. You must configure your environment for PeopleSoft Upgrade Assistant to submit processes.

This chapter discusses how to:

Click to jump to top of pageClick to jump to parent topicConfiguring Process Scheduler and Application Server

You must first configure and run a Process Scheduler and Application server against the target database.

See Also

Setting Application Server Domain Parameters

Click to jump to top of pageClick to jump to parent topicConfiguring the Portal

You must configure the portal to update user security.

See the PeopleTools 8.46 Installation Guide for your platform, "Setting Up the PeopleSoft Internet Architecture."

Click to jump to top of pageClick to jump to parent topicBuilding the PROCESSREQUEST Component Interface

To configure the PROCESSREQUEST component interface:

  1. Open PeopleSoft Application Designer.

  2. Select File, Open.

  3. For the definition, select Component Interface.

  4. Click Open to display a list of component interfaces.

  5. Select PROCESSREQUEST and click Open again.

  6. Select Build, PeopleSoft APIs.

    The PeopleSoft API Bindings dialog box appears.

  7. Select the Build check box in the COM Type Library group box.

  8. In the Target Directory field, enter the directory in which you want the COM type library to be created: typically <PS_HOME>\bin\client\winX86. It must be a local directory.

  9. In the COM Server DLL Location field, enter the server location to specify where the PeopleSoft API Adapter (psapiadapter.dll) is located: <PS_HOME>\bin\client\winX86.

  10. (Optional) Select the AutoRegister check box to execute the registry file immediately upon building the API. This causes your client machine registry to be immediately updated without having to register it manually.

  11. (Optional) Select the Clean-up Registry check box to clean up the registry if you’ve applied previous versions of Peoplesoft_Peoplesoft.reg.

    This is needed so that the older registry settings don’t remain and conflict with settings made by the latest version.

    Note. Make sure the Build check box in the Java Classes group box is not selected.

  12. Click OK to build the bindings that you selected.

    The system builds the PROCESSREQUEST component interface object to the location that you specified (<PS_HOME>\bin\client\winx86 directory). If the operation was successful, a done message appears in the PeopleSoft Application Designer Build window.

Click to jump to top of pageClick to jump to parent topicSetting System Variables

You must also set up the workstation running PeopleSoft Upgrade Assistant to access the component interface API using COM.

Setting Up Windows 2000 Workstations

To set system variables for Windows 2000 workstations:

  1. Select Start, Settings, Control Panel, System, Advanced, Environment Variables.

  2. Append the <PS_HOME>\jre\bin\client directory to your system variable Path.

  3. In addition, append the <PS_HOME>\class directory to the system variable CLASSPATH to include the psjoa.jar file.

Setting Up XP Workstations

To set system variables for Windows XP workstations:

  1. Select Start, Control Panel, System, Environment, System Variables.

  2. Include a path to the bin directory.

    This must be the same directory that you specified as the Target Directory on the Build PeopleSoft API Bindings dialog box.

  3. In this same location, set the system variable CLASSPATH to include the psjoa.jar file.

Click to jump to top of pageClick to jump to parent topicEditing Component Interface Security

You must edit security permissions to run the PROCESSREQUEST object.

To set up component interface security:

  1. Log in to PeopleSoft through the browser.

  2. Select PeopleTools, Security, Permissions & Roles, Permission Lists.

  3. Select the permission list for which you want to set security.

    The Permission List component appears.

  4. Access the component interfaces page and select the PROCESSREQUEST component interface.

  5. Click Edit.

    The Component Interface Permissions page appears, showing all of the methods (both standard and user-defined) in the component interface and their method access.

  6. Set the access permission for each method.

    Select Full Access or No Access. You must grant full access to at least one method to make the component interface available for testing and other online use.

  7. Click OK when finished.

  8. Click Save.

Click to jump to top of pageClick to jump to parent topicEditing Step Properties

Access the Step Properties page for the Application Engine process upgrade step.

Make sure that the Run Location of the Application Engine process is set to Server.

PeopleSoft Upgrade Assistant can then run Application Engine processes against a Process Scheduler located on your server.

See Also

Editing Steps