Understanding Implementing Handlers Using Application Engine Programs
Application engine handlers are available for notification events (OnNotify) and schedule an application engine program to run within PeopleSoft Process Scheduler to process service operation content. This handler is a good alternative for long-running programs or service operations that have large amounts of data to process, since processing is performed by PeopleSoft Process Scheduler and not in the PeopleSoft Integration Broker runtime environment.
After the service operation is invoked, you can track the process by viewing the subscription contract in the Service Operations Monitor.
When you implement a handler using an application engine program, you must retrieve the transaction ID that you use to get message data from within the application engine program. The run control record PSIBRUNCNTL is populated with the transaction ID prior to scheduling the actual application engine program. Note that it is not required to retrieve the transaction ID, therefore any application engine program can be scheduled that does not require initialization parameters via a run control table.
The process for implementing a handler using and application engine program is:
-
Develop the application engine program.
Developing application engine programs is discussed elsewhere in the PeopleTools product documentation.
-
Add a handler to the service operation.
This process is discussed elsewhere in this topic.
-
Specify general handler details.
This process is discussed elsewhere in this topic.
-
Specify application engine handler implementation details.
This process is discussed in this section.
See Specifying Application Engine Handler Implementation Details.
-
Retrieve service operation content from the application engine program.
This process is discussed in this section.
See Retrieving Service Operation Content from Application Engine Programs.
-
View subscription contract status.
This process is discussed in this section.