Running the PTEM_CONFIG Application Engine Program
From PeopleTools 8.59, the DPK deployment process executes the utility script, psrunACM.bat or psrunACM.sh, in order to control the execution of ACM plug-ins in cases where it may encounter failures thereby ensuring that the DPK deployment process continues smoothly or is aborted when certain conditions are not fulfilled. The PS_WRITE_ACM_LOG environment variable enables logging of the ACM plug-in execution and generates a JSON file containing the status of each executed plug-in, thus giving you greater control on running the DPK deployment process. The utility script provides the following return codes:
| Return Code | Description |
|---|---|
|
0 |
Successful completion. |
|
10 |
The template under consideration does not exist in the database. |
|
11 |
Web history is not found. Login to PIA, and re-run the program. |
|
12 |
User does not have permission to execute any of the plug-ins. |
|
13 |
Exiting configuration as per post-configuration condition. |
|
14 |
Failure when running any plug-in in the template. |
|
15 |
Warning when running any plug-in in the template. |
In the same command line session where you set PS_FILEDIR to point to your environment variables template file, launch the PTEM_CONFIG Application Engine program.
Change directories to PS_HOME\bin\client\winx86 and submit the following command line parameters to the Application Engine executable (psae.exe) replacing the values in <> with appropriate values.
For example:
psae.exe -CT <DB type> -CS <server name> -CD <DB name> -CO <user> -CP <password> -R <runid> -AI PTEM_CONFIG -I <instance number>| Parameter | Description |
|---|---|
|
-CT |
Database type (connection type). |
|
-CS |
Server name (used only for specific database types). |
|
-CD |
Database name. |
|
-CO |
User ID connecting to the database. |
|
-CP |
Password associated with the user ID. |
|
-R |
Run control ID. |
|
-AI |
Application Engine program name (Application ID) |
|
-I |
Instance number. |
See the Application Engine documentation for more information on other optional command line parameters.
After the PTEM_CONFIG program processes all the configuration properties for the configuration plug-ins contained in the environment variables template file, you should see a message indicating the successful program run.