Maintaining application property information
In the application ruleform, on the Definition tab, the Place properties on thread page only (5-4 or later) check box is a setting that determines where certain application property information is maintained. The information will be maintained either on the pxThread page or on both the pxThread and pxRequestor pages.
The Place properties on thread page only (5-4 or later) check box on the application ruleform
pxThread page
The pxThread page is the top-level thread page of the clipboard for every authenticated requestor. It is a reserved, system-maintained page; your application can read but not directly set these values.
The pxThread page typically contains the Code-Pega-Thread class, which contains standard Pega Platform™ properties.
pxRequestor page
The pxRequestor page is the top-level page in the clipboard of every authenticated requestor. It is created at login and contains information about your access roles, ruleset list, and TCP and HTTP protocol parameters.
The pxRequestor page typically contains standard properties in the Code-Pega-Requestor class.
Place properties on thread page only (5-4 check box) check box
In PRPC 5.3 and earlier versions, many properties that describe the behavior of the user session were stored on the pxRequestor page. Starting in PRPC 5.4, features were introduced that allow users to have multiple threads with different settings by moving some values to the pxThread page and removing them from the pxRequestor page.
For backward compatibility, a setting in the application, the Place properties on thread page only (5-4 or later) check box, was created.
By default, the Place properties on thread page only (5-4 or later) check box is enabled for application rules created in PRPC 5.4 or later versions and disabled for application rules created in PRPC 5.3 or earlier versions. Generally, it is recommended that you accept the default settings.
Clear this check box for rulesets created in PRPC 5.3 or earlier where development is complete (and all ruleset versions are locked) and you want to execute the rules in the ruleset in PRPC 5.3 compatibility mode as far as the location of these properties.
- When the check box is selected, at run time, the system examines the pxThread page for the current values of certain system-maintained properties that in PRPC 5.3 were maintained only on the pxRequestor page. The system then places and maintains these properties on the pxThread page.
- When this check box is not selected, the properties are maintained on both the pxRequestor and pxThread pages. However, only the pxRequestor values are accurate; the system examines the requestor level (pxRequestor) page.
Properties on pxThread and pxRequestor pages
The following properties have correct values on the thread pages and are not displayed on the pxRequestor page when the Place properties on thread page only (5-4 or later) check box is selected. Instead, they are displayed on both a pxThread page and the pxRequestor page, with correct values displayed only on the pxRequestor page when the check box is not selected.
- pxApplicationRuleSets
- pxDesktopType
- pxDevelopRuleSet
- pxDevelopVersion
- pxHomeDirectory
- pyUserPortals
- pyUserWorkPools
If any of the properties listed above are referenced for application rules created in PRPC 5.4 or later versions, you must ensure that the Place properties on thread page only (5-4 or later) check box is selected so that they obtain their data from the pxThread page only.
Search the application for one or more properties. If your application references one of these properties, ensure that the property obtains its data only from the pxThread page by opening the application ruleform and ensuring that the Place properties on thread page only (5-4 or later) check box is selected.