Contents
Contents

OnPreNotify

Struggling to bridge the legacy gap? Cedar Hills Group provides specialized PeopleSoft integration consulting to help teams design, build, and optimize their connection strategies.

The OnPreNotify handler executes on the subscribing node prior to the creation and execution of subscription contracts. In the PeopleSoft Service Operation Handler definition, this handler type is designated by Handler ID PRNF and labeled “On Pre Notify”.

While standard OnNotify subscription handlers execute per contract to process application business logic, OnPreNotify runs once when the message arrives. It has access to all segments of data in a partitioned or segmented message.

Common Use Cases

  • Table Truncation and Prep: Truncating staging tables before batch message data is inserted by subscription handlers.
  • Pre-allocation: Generating run control records, session tokens, or batch sequence headers before individual contracts process.
  • Pre-validation: Verifying prerequisites or environment locks before spawning asynchronous worker contracts.

Interface Definition

Handlers configured for OnPreNotify must implement the PS_PT:Integration:IPrePostNotification interface:

import PS_PT:Integration:IPrePostNotification;

class MyPrePostHandler implements PS_PT:Integration:IPrePostNotification
   method OnPreNotify(&message As Message);
   method OnPostNotify(&message As Message);
   method OnError(&request As Message);
end-class;

method OnPreNotify
   /+ &message as Message +/
   /+ Extends/implements PS_PT:Integration:IPrePostNotification.OnPreNotify +/
   
   /* Pre-processing logic before subscription contracts run */
end-method;

method OnPostNotify
   /+ &message as Message +/
end-method;

method OnError
   /+ &request as Message +/
end-method;

Delivered Implementation Example

In PeopleTools Application Data Set (ADS) processing, service operation PT_ADS_PROCESS registers handler class ADS_SYSTEM:PT_ADS_PROCESS for both pre-notification and post-notification events.

In OnPreNotify, it calls ADSTableTruncation() to ensure staging tables are cleared before the inbound dataset contracts run:

import PS_PT:Integration:IPrePostNotification;

class PT_ADS_PROCESS implements PS_PT:Integration:IPrePostNotification
   method PS_ADS_PROCESS();
   method OnPreNotify(&message As Message);
   method OnPostNotify(&message As Message);
end-class;

/* Constructor */
method PS_ADS_PROCESS
end-method;

method OnPreNotify
   /+ &message as Message +/
   /+ Extends/implements PS_PT:Integration:IPrePostNotification.OnPreNotify +/
   
   /* Truncate ADS staging tables prior to contract execution */
   &message.ADSTableTruncation();
end-method;

method OnPostNotify
   /+ &message as Message +/
   /+ Extends/implements PS_PT:Integration:IPrePostNotification.OnPostNotify +/
   
   Local boolean &bRet;
   &bRet = %IntBroker.ADSSync(&message.ParentTransactionId, &message.PubNodeName);
end-method;
psLens Platform
psLens Operations & Intelligence

Look up any record, field, page, or component, audit security, and monitor Integration Broker across every database — in seconds.

  • 30+ object types browsable
  • 16 real-time alert types
  • Read-only by design
  • No App Designer or SQL required
Learn More
psLens Platform
psLens Operations & Intelligence

A web console built for the PeopleSoft community — operational monitoring, security auditing, and metadata browsing in one tool.

  • Sub-second object search
  • Catch stuck IB messages before users do
  • Audit service permissions from one screen
  • Works in any browser
Learn More
psLens Platform
psLens Operations & Intelligence

On-demand security and operational reports for your PeopleSoft environment — no client install required.

  • 14 on-demand reports
  • Markdown export for AI/LLM workflows
  • No shared tenancy
  • Built on 25+ years of PeopleSoft expertise
Learn More
psLens Platform
psLens Operations & Intelligence

Research any PeopleSoft object and monitor system health from a single browser tab — no App Designer, no SQL.

  • 30+ PeopleSoft object types browsable
  • Real-time alerts before users report problems
  • Read-only and secure
  • Private alpha — early access now
Learn More
Author Profile
Chris Malek

Chris Malek is a PeopleTools® Technical Consultant with over two decades of experience. He is available for consulting engagements.

Work with Chris
Subscribe to Updates
SWS Bolt-On
PeopleSoft Simple Web Services

SWS turns SQL into production REST APIs — ready for AI, modern apps, and partner integrations. One install, unlimited potential.

  • Configuration-driven, no coding required
  • JSON, XML, and CSV output
  • Works across all PeopleSoft pillars
  • Built on 25+ years of PeopleSoft expertise
Read More & Purchase
SWS Bolt-On
PeopleSoft Simple Web Services

A powerful PeopleSoft bolt-on that makes REST web services easy. You bring the SQL, SWS handles the rest.

  • Go from idea to production in minutes
  • Zero code migrations after install
  • JSON, XML, and CSV output supported
  • No PeopleCode or Integration Broker expertise required
Read More & Purchase
SWS Bolt-On
PeopleSoft Simple Web Services

Traditional PeopleSoft web services cost $3,600–$13,000 each to develop. SWS deploys production REST APIs in under 5 minutes through configuration alone.

  • No PeopleCode or Integration Broker expertise required
  • Works across Campus Solutions, HCM, and Financials
  • Built-in pagination, caching, and nested data structures
  • Trusted by institutions across higher education and government
Read More & Purchase
SWS Bolt-On
PeopleSoft Simple Web Services

Turn PeopleSoft data into clean REST APIs for AI integrations, modern applications, and vendor data feeds. Configuration-driven — no PeopleCode required.

  • Deploy production APIs in under 5 minutes
  • AI and LLM ready (RAG, chatbots, intelligent search)
  • JSON, XML, and CSV output
  • Zero modifications to delivered PeopleSoft objects
Read More & Purchase