Every connected PRPC requestor (including browser-based user, even if unauthenticated guest users) has an associated temporary memory area on the server known as the clipboard. The clipboard has a hierarchical structure, consisting of nodes known as pages, most of which have a name and an associated class.
Pages act as buffers or temporary copies of object instances (of that class) that are copied from, or may later be stored into, the PegaRULES database or another database.
Do not confuse the PRPC clipboard — a structured server memory object — with your Microsoft Windows clipboard, a single space in the memory of your workstation.
The contents of a page are an unordered list of unique property names (defined as Rule-Obj-Property instances within that class) and optionally a value for each property. On the page, the property value may be:
Properties are added to the clipboard by activities as they execute, and by user input received through <FORM > inputs and Submit buttons. In addition to property names and values, pages can contain messages.
Some clipboard pages may contain other pages, either as embedded pages or as the value of a property that has a property mode of Page
, Page List
or Page Group
. These pages may in turn contain other pages.
The clipboard contains these broad categories of top-level pages:
The Clipboard tool provides you a way to review the contents of your clipboard. When appropriate to support debugging, you can use the Clipboard tool to directly update parts of your clipboard.
Caution: Direct alteration of clipboard values and contents through the Clipboard tool is generally unnecessary and can affect the integrity of your system and its data.
Use the Clipboard tool to view the contents of your clipboard, as a learning aid and debugging aid.
Use the Performance tool to learn the size in bytes of your entire clipboard. Click the Add Reading with Clipboard Size link.
Using the System Management Application (SMA), you can learn the size of each requestor's clipboards, and the size of each page. Start the SMA using> System > Operations > System Management App, select a node, and then click the Requestor Management menu item.