Change Control & Object Locks

PeopleTools Change Control & Object Locks

In PeopleSoft development environments, PeopleTools Change Control prevents simultaneous modifications to application metadata objects by allowing developers to check out and lock definitions (e.g. Records, Pages, Components, PeopleCode, App Engines, Component Interfaces).

psLens automatically inspects system-wide Change Control configuration (PSCHGCTLDEF) and active checkout locks (PSCHGCTLLOCK) whenever you view definition metadata or related project associations.

How psLens Displays Object Lock Status

When inspecting any PeopleSoft definition in psLens (such as a Record, Page, Component, or Field), the Included in Projects panel surfaces Change Control state in real-time:

• Locked Objects: If a developer has checked out the object in Application Designer, psLens displays a prominent lock banner showing:
  • Operator ID (OPRID): The developer holding the active lock.
  • Lock Timestamp: When the object was checked out.
  • Associated Project: Direct link to the project (PSPROJECTDEFN) under which the definition is locked.
  • Developer Comments: Any check-out justification comments provided.
• Unlocked Objects: When Change Control is enabled in the database and no active lock exists, psLens displays a green status badge confirming the object is available for checkout.
• Change Control Disabled: If Change Control is disabled system-wide in the environment, psLens cleanly renders project associations without lock overhead.

Supported Object Types

Change Control and lock tracking is supported across all major PeopleSoft metadata definitions:

• Records & Tables (PSRECDEFN)
• Fields (PSDBFIELD)
• Pages (PSPNLDEFN)
• Components (PSPNLGRPDEFN)
• Menus (PSMENUDEFN)
• Application Engine Programs (PSAPPLDEFN)
• Component Interfaces (PSBCDEFN)
• Integration Nodes & Messages (PSMSGNODEDEFN, PSMSGDEFN)
• BI Publisher Reports & Templates (PSXPRPTDEFN)
• HTML Definitions, Style Sheets, and URLs