Handling Execution Errors and Status on the Command Line

This topic describes how to interpret the output of a configuration template execution and how you can use the status display and pre and post condition options to aid in creating your environments.

The console output displays a standard set of data to communicate states of each configuration plug-in invoked during a template run, such as status, description, severity and so on. There is also an overall indication of status at the end of the output, which applies to the template, not just the individual plug-ins. You can use scripts to interpret the console output and perform relative actions accordingly.

The following is an example of the command line console output:

###########################################################
  ######     AUTOMATED  CONFIGURATION  MANAGER     ######
###########################################################
 
PTEM_CONFIG:PTIBRenameNode: Rename the default local node
Configuring plug in : PTEM_CONFIG:PTIBRenameNode
STATUS: SUCCESS
DESCRIPTION: 
SEVERITY: 
Configuration completed : PTEM_CONFIG:PTIBRenameNode

PTEM_CONFIG:PTIBConfigureDBNode: Configure the DB node
Configuring plug in : PTEM_CONFIG:PTIBConfigureDBNode
STATUS: SUCCESS
DESCRIPTION: 
SEVERITY: 
Configuration completed : PTEM_CONFIG:PTIBConfigureDBNode

PTEM_CONFIG:PTIBConfigureGatewayNodes: Configure gateway URL, load connectors, define node in the gateway
Configuring plug in : PTEM_CONFIG:PTIBConfigureGatewayNodes
STATUS: WARNING
DESCRIPTION: 
Properties env.ib_appserver_host, env.ib_jolt_port are not configured correctly
Properties env.ib_appserver_host, env.ib_jolt_port are not configured correctly
SEVERITY: MAJOR
Configuration completed : PTEM_CONFIG:PTIBConfigureGatewayNodes

PTEM_CONFIG:PTIBConfigureGatewayProperties: Set keystore password, proxy host, p
roxy port, non proxy host in gateway properties file
Configuring plug in : PTEM_CONFIG:PTIBConfigureGatewayProperties
STATUS: ERROR
DESCRIPTION: Class PTIBConfigureGatewayProperties not found
SEVERITY: CRITICAL
Configuration failed : PTEM_CONFIG:PTIBConfigureGatewayProperties

****Successfully finished configuring the environment****
Configured environment in 9 seconds

OVERALL STATUS: ERROR
Application Engine program PTEM_CONFIG ended normally

Status Value

Description

STATUS

  • SUCCESS

  • WARNING

  • ERROR

DESCRIPTION

Various messages can be displayed, depending on the nature of the issue or error. In the case of warnings or errors, make sure you check all the details provided.

SEVERITY

  • WARNING: Verification of configuration failures.

  • CRITICAL: Configuration failure.

  • MEDIUM: Pre/Post condition failure.

  • SEVERE: Exceptions.

To access error codes:

  • UNIX: $ echo $?

  • Windows: C:\>echo %ERRORLEVEL%

Error Code

Description

0

Successful completion.

10

The specified template does not exist in the database.

11

Web history not found. Login to PIA, and re-run the program.

12

User ID specified does not have permission to execute any of the plug-ins.

13

Exiting configuration execution due to post-configuration condition.

14

Failure in running any plug-in in the template.

15

Warning in running any plug-in in the template.

This section provides some sample pre and post-conditions set in the template file and illustrates sample output for such conditions.

The feature related to setting pre and post-conditions with your configuration template executions is described in another topic in this product documentation. See Handling Errors During Plug-in Execution.

Sample Precondition

Property file:

plugin.prcs.1=PTEM_CONFIG:PTProcessSchedulerReportNode
PreConditionOnError=PTIBConfigureGatewayNodes,
PTIBConfigureGatewayProperties
env.wrkoperpswd=beaweb
env.url=http://abc00xyz.company.com:8000/psreports/ps

Console output:

PTEM_CONFIG:PTIBConfigureGatewayNodes: Configure gateway URL, load connectors, 
define node in the gateway
Configuring plug in : PTEM_CONFIG:PTIBConfigureGatewayNodes
STATUS: ERROR
DESCRIPTION:
Invalid Gateway User/Password. (158,171) PTEM_CONFIG.PTIBConfigureGatewayNodes.OnExecute  
Name:getIntegrationGatewayProperties  PCPC:21728  Statement:254
Called from:PTEM_CONFIG.PTIBConfigureGatewayNodes.OnExecute  
Name:configureNodeStatement:160
Called from:PTEM_CONFIG.PTIBConfigureGatewayNodes.OnExecute  
Name:configureEnvironment  Statement:73
Called from:PTEM_CONFIG.MAIN.GBL.default.1900-01-01.Step01.OnExecute  Statement:904
SEVERITY: SEVERE
Configuration failed : PTEM_CONFIG:PTIBConfigureGatewayNodes

PTEM_CONFIG:PTIBConfigureGatewayProperties: Set keystore password, proxy host,
proxy port, non proxy host in gateway properties file

Configuring plug in : PTEM_CONFIG:PTIBConfigureGatewayProperties
STATUS: ERROR
DESCRIPTION:
Invalid Gateway User/Password. (158,171) PTEM_CONFIG.PTIBConfigureGatewayNodes.OnExecute  
Name:getIntegrationGatewayProperties  PCPC:21728  Statement:254
Called from:PTEM_CONFIG.PTIBConfigureGatewayProperties.OnExecute  
Name:configureEnvironment  Statement:58
Called from:PTEM_CONFIG.MAIN.GBL.default.1900-01-01.Step01.OnExecute  Statement:904
SEVERITY: SEVERE
Configuration failed : PTEM_CONFIG:PTIBConfigureGatewayProperties

PTEM_CONFIG:PTProcessSchedulerReportNode: Configure Process Scheduler Report Node 
configuration
Configuring plug in : PTEM_CONFIG:PTProcessSchedulerReportNode
STATUS: ERROR
DESCRIPTION:
Skipping Configuration for: PTEM_CONFIG:PTProcessSchedulerReportNode 
since Pre-Condition Check failed
SEVERITY: MEDIUM
Configuration failed : PTEM_CONFIG:PTProcessSchedulerReportNode

****Completed environment configuration****
Configured environment in 37 seconds
Application Engine program PTEM_CONFIG ended normally

Sample Post-Condition

Property file:

plugin.ib.2=PTEM_CONFIG:PTIBConfigureGatewayNodes
PostCondition=EXIT
env.gateway_user=administrator
env.gateway_password=Passw0rd
env.ib_appserver_host=SLC00FEQ
env.ib_jolt_port=9032
env.ib_node_proxy_userid=PTDMO
env.ib_node_proxy_password=PTDMO
env.ib_appserver_domain_password=password

Console output:

Configuring plug in : PTEM_CONFIG:PTIBConfigureGatewayNodes
STATUS: ERROR
DESCRIPTION:
Invalid Gateway User/Password. (158,171) PTEM_CONFIG.PTIBConfigureGatewayNodes.OnExecute  
Name:getIntegrationGatewayProperties  PCPC:21728  Statement:254
Called from:PTEM_CONFIG.PTIBConfigureGatewayNodes.OnExecute  
Name:configureNodeStatement:160
Called from:PTEM_CONFIG.PTIBConfigureGatewayNodes.OnExecute  
Name:configureEnvironment  Statement:73
Called from:PTEM_CONFIG.MAIN.GBL.default.1900-01-01.Step01.OnExecute  Statement:904
SEVERITY: SEVERE
Configuration failed : PTEM_CONFIG:PTIBConfigureGatewayNodes
EXITING CONFIGURATION AS PER POST-CONFIGURATION CONDITION: 
PTEM_CONFIG:PTIBConfigureGatewayNodes
Configured environment in 34 seconds
Application Engine program PTEM_CONFIG ended normally

When creating scripts to run configuration templates, you may want to reduce the output to only the essential information required for building your error handling. You can pass the QUIET parameter when calling Application Engine to: This feature helps which helps in scripting based on the console output.

  • Hide the console headers and footers.

  • Displaying only essential details of a configuration template execution.

For example, using the QUIET parameter:

%PS_HOME%\bin\client\winx86\psae.exe -CT %DBTYPE% -CS %SERVER% -CD %DBNAME% -CO %USER% -CP 
%PASS%  -R RUN023 -AI PTEM_CONFIG -I 2 -QUIET Y

Produces output similar to:

###########################################################
########     AUTOMATED  CONFIGURATION  MANAGER     ########
###########################################################
PTEM_CONFIG:PTIBRenameNode: Rename the default local node
Configuring plug in : PTEM_CONFIG:PTIBRenameNode
STATUS: SUCCESS
DESCRIPTION: NONE
SEVERITY: NONE
Configuration completed : PTEM_CONFIG:PTIBRenameNode
PTEM_CONFIG:PTIBConfigureDBNode: Configure the DB node
Configuring plug in : PTEM_CONFIG:PTIBConfigureDBNode
STATUS: SUCCESS
DESCRIPTION: NONE
SEVERITY: NONE
Configuration completed : PTEM_CONFIG:PTIBConfigureDBNode
****Completed environment configuration****
Configured environment in 7 seconds