Qp2EndPase()--End an IBM PASE for i Program


  Syntax 
 #include <qp2user.h>

 int Qp2EndPase(void);

  Service Program Name: QP2USER

  Default Public Authority: *USE

  Threadsafe: No

The Qp2EndPase() function ends any IBM® i PASE program currently running in the job.


Parameters

None.


Authorities

None.


Return Value

The function result is nonzero if an error is detected attempting to end the IBM PASE for i program.


Usage Notes

  1. Qp2EndPase is normally used to end an IBM PASE for i program that ran the _RETURN IBM PASE for i runtime function (to return without exiting). Such a program remains active (even if it exits or terminates due to an IBM PASE for i signal) until either Qp2EndPase is called or the ILE activation group that called the Qp2RunPase API exits. IBM PASE for i programs that do not use _RETURN are ended automatically before control returns from the Qp2RunPase API.

  2. Qp2EndPase returns without error when no IBM PASE for i program is running in the job.

  3. Undefined behavior results if Qp2EndPase is called while the Qp2RunPase API is running (in the same job), or if the job attempts to use the IBM PASE for i program (without restarting it) after Qp2EndPase is called.

Related Information


API introduced: V5R2

[ Back to top | IBM PASE for i APIs | APIs by category ]