PSTools Section

Use this section to specify a character set. The default value is UTF-8.

Parameter Description

Enable Remote Administration

Set the value to 1 to enable embedded JMX agents, 0 to disable embedded JMX agents. JMX agents must be enabled to use the PeopleSoft Health Center.

Remote Administration Port

Specify the port number to use for remote administration of domain processes. All embedded JMX agents will use the port in the JMX service URL.

Remote Administration UserId

Specify the username for remote administration connections.

Remote Administration Password

Specify the pscipher encrypted password for remote administration connections. See Integration Broker Administration: Encrypting Passwords.

Remote Administration SSL Enabled

Set this parameter to 1 to enable SSL for JMX Agents and to 0 to disable SSL for JMX Agents. Default is 0 i.e. SSL for JMX Agents will be disabled. Other settings are optional if SSL for JMX Agents is disabled.

Remote Administration SSL Keystore

Specify the location of the Keystore file for remote administration connections.

Remote Administration SSL Keystore Password

Specify the pscipher encrypted Keystore password for remote administration connections.

Remote Administration SSL Keystore Type

Specify the Keystore type for the keystore you had created for enabling SSL. Options are PKCS12 or JKS.

See the documentation for Java Security Standard Algorithm Names in Oracle Help Center.

Remote Administration SSL Truststore

Specify the location of the Truststore file for remote administration connections.

Remote Administration SSL Truststore Password

Specify the pscipher encrypted Remote Administration SSL Truststore Password.

Remote Administration SSL Truststore Type

Specify the Truststore's Keystore type for the truststore you had created for enabling SSL. Options are PKCS12 or JKS.

See the documentation for Java Security Standard Algorithm Names in Oracle Help Center.

EnablePPM Agent

Controls whether the Performance Monitor agent runs and collects performance monitor data. Enter 1 to enable the Performance Monitor agent, and 0 to disable the Performance Monitor agent. This setting overrides the value for this parameter that is set in the database.

JavaVM Shared Library

Indicate which Java Virtual Machine (JVM) library to use.

Note: You must manually update the psprc.cfg file, as this option is not available using the PSADMIN utility.

Add to CLASSPATH

The Add to CLASSPATH parameter tells the Java Virtual Machine (JVM) where to find the Java class libraries, including user-defined class libraries. Because PeopleTools automatically generates CLASSPATH entries for core delivered class libraries, use this field to specify any custom or additional class libraries that must be accessed by PeopleTools or PeopleCode.

The PeopleCode API Reference provides details on where you can place custom and third-party Java classes.

See PeopleCode API Reference: Java Packages and Classes Delivered with PeopleTools.

JavaVM Options

Set options to the list of parameters required. Use a space to separate parameters (for example, -Xmx256m -Xms128m).

The following setting is used to enable communication with the REN server using SSL protocols that adhere to corporate security standards:

-Dhttps.protocols=TLSv1.1,TLSv1.2

If this option is not already set, either add it manually to the JavaVM Options section in psprcs.cfg and then restart the process scheduler domain or take the latest patch, then drop and recreate the process scheduler domain.

Set option -Xrs if you have PeopleSoft Process Scheduler set up as a Windows service on Windows.

Options must be set if you are using HTTP transfer protocol and receiving Java exception thrown: java.lang.OutOfMemoryError.

AIX customers should set this option to -Xrs -Djava.awt.headless=true -Xcheck:jni

Note: You must manually update the psprc.cfg file, as this option is not available using the PSADMIN utility.

Character Set

Specify the default character set for non-Unicode processing performed by this process server. The default value is UTF-8. This is the character set that PeopleSoft supports for use with all Western European languages, including English. If the process server will be used only to process Western European data, accept the default. Otherwise, select one of the valid character set choices listed later in this section.

Note: The character set selected for the process server should be the same as the character set specified for the application sever.

Proxy Host

This setting is used by the distribution agent if your architecture includes a firewall between the process scheduler server and the report repository (webserver).

Note: If your architecture includes a firewall between the process scheduler server and the report repository (webserver), the distribution agent must tunnel through this firewall via a proxy server in order to transfer reports successfully. Set this value to the domain name of the proxy server only if your architecture includes a firewall between the process scheduler and the report repository (web server). Configure the firewall to allow outgoing HTTP or TCP connections to originate only from the proxy server host. You can configure the proxy server to restrict access to only PeopleSoft and perform tasks, such as logging HTTP activity.

Proxy Port

If PeopleSoft Process Scheduler is behind a proxy server, set this value to the port of the proxy server.

Non Proxy Hosts

Enter a list of the hosts that should be connected to directly, not through a proxy server. Separate the host names with a pipe symbol ( | ). You can use an asterisk (*) as a wildcard character to specify a pattern of similar host names.

For example, localhost|*.example.com indicates that the local host and all hosts with names ending in .example.com will be accessed directly.

DbFlags

Enter 0 to issue the command to update table statistics to the database. Programs like PeopleSoft Application Engine and COBOL use the metaSQL %UpdateStats to run the command that runs statistics to a specific table. Otherwise, select one of the valid choices listed later in this section.

Note: The Update Table Stats on Purge parameter is ignored if this parameter is disabled.

Suppress App Error Box

Use to suppress the console's Application Error dialog box after an application error occurs. Y suppresses the dialog box.

Process exit grace period

When a PeopleSoft Application Engine job completes, it has a specified number of seconds to exit. If the process has not exited when the grace period expires, it is terminated through a psreaper process. A grace period of 0 disables the psreaper process.

ScheduledQuery-CSVUnicodeEncoding

This setting is used to configure CSV output encoding for scheduled PSQueries. The default value is UTF8. The other valid encoding settings are UCS2, UTF8BOM, and ASCII. This setting applies only when OutputUnicode property of query class is set to True and scheduled query is set to ‘TXT’ format.

Note: This is not a required setting. If it is not set, the CSV output encoding will be UCS2 with BOM.

The following table lists valid character set choices:

Character Set Description

latin1

Latin–1- ISO 8859-P1 - Microsoft codepage 1252

sjis

Japanese Shift-JIS - Microsoft codepage 932

big5

Traditional Chinese - Microsoft codepage 950

gb

Simplified Chinese - Microsoft codepage 936

ks-c-5601-1987

Korean Wansung - Microsoft codepage 949

ks-c-5601-1992

Korean Johab - Microsoft codepage 1361

See Global Technology.

The following table lists possible values for DBFlags bitfield:

Bit Description

0

(Default) Issue the command to update table statistics to the database.

1

Ignore metaSQL to update database statistics (shared with COBOL).

2

Not yet allocated.

4

Disable second database connection.

8

Disable persistent secondary database connection.

16

Not yet allocated.

32

Not yet allocated.

64

Not yet allocated.

128

Not yet allocated.

256

Not yet allocated.

Note:

The JavaVM Options parameter specified in the [PSTOOLS] section specifies global JavaVM options used by every server process in a domain. To override this global value for a particular server process, you can apply custom JavaVM options to individual server processes by adding the JavaVM Options parameter manually to the configuration section for that server process.

JavaVM Options can appear multiple times in a single PSAPPSRV.CFG or PSPRCS.CFG file. While the JavaVM Options value in the [PSTOOLS] section applies to all server processes governed by a particular configuration file, the system only uses the JavaVM Options value in the [PSTOOLS] section for server processes that do not have the JavaVM Options parameter added to its configuration settings section.

For example, if the JavaVM Options parameter has been added to the [PSAPPSRV] section of the PSAPPSRV.CFG file and has been assigned a value, then that value will be used when loading the JVM as a thread of that PSAPPSRV process. If the JavaVM Options parameter does not appear, or has no value, in the [PSAPPSRV] section, then the system uses the value specified in the [PSTOOLS] section when loading the JVM as a thread of the PSAPPSRV process. This applies to any server process: PSAPPSRV, PSQRYSRV, PSAESRV, and so on.