# Change Control & Object Locks

> Inspect PeopleTools Change Control configuration and active definition checkout locks across all PeopleSoft objects.

---

LLMS index: [llms.txt](/llms.txt)

---

## 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**