Clipboard

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.

Don't confuse the PRPC clipboard — a structured server memory object — with your Microsoft Windows clipboard, a single space in the memory of your workstation.

Pages

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:

• Empty (also called null)
• Valid and appropriate for the property's definition and characteristics
• Invalid, not matching the property characteristics

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.

Top Level Pages

The clipboard contains these broad categories of top-level pages:

• User pages
• Data pages, produced by Data Page rules.
• Linked property pages
• System-managed pages, including the requestor page, process page, application page, thread page, Operator ID, Organization, OrgDivision, and OrgUnit.

Reviewing clipboard contents

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.

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 > Tools > System Management App, select a node, and then click the Requestor Management menu item.

	data page, embedded page, process page, page, property mode, results page, requestor page, thread page, user page
	About the Clipboard tool About the Performance tool

Definitions