Getting a DBG99001E ERROR DETECTED IN CA APAS COMMAND STREAM, PROCESSING TERMINATED followed by an ADAM99 Abend Code 4000001A (User 26) abend when the first command is processed by an ADABAS MPM with CA APAS installed.

Document ID : KB000052891
Last Modified Date : 14/02/2018
Show Technical Document Details

Description:

DBG99001E indicates that there was an error or errors in the CA APAS DBGIN control card input data set and the CA APAS GLOBALS parameter IGNORE-INIT-ERRORS was set to NO or allowed to default to NO.

This document explains how to locate the error(s) and how the CA APAS GLOBALS parameter IGNORE-INIT-ERRORS can be used to control the issuance of the DBG99001E error and User 26 (4000001A) abend.

Solution:

The IGNORE-INIT-ERROR GLOBALS parameter is used during initialization of the CA APAS Data Collector to determine how any errors detected in the CA APAS DBGIN control card input data set are to be handled.

If the IGNORE-INIT-ERROR GLOBALS parameter is set to a value of NO or if the parameter is not specified and allowed to default, the MPM session is immediately terminated with a User 26 (Abend code 4000001A 00000000) and the CA APAS error message DBG99001E is written to the JES Message Log and the CA APAS DBGPRINT data set:

DBG99001E date time ERROR DETECTED IN CA APAS COMMAND STREAM, PROCESSING TERMINATED
ADAM99 dbid ADABAS Abend code 4000001A 00000000

If a value of YES is specified and a syntax error is detected in DBGIN, the MPM is allowed to start up normally and the error is flagged with a DBG99002W warning message written to the CA APAS DBGPRINT data set:

DBG99002W date time ERROR DETECTED IN CA APAS COMMAND STREAM, PROCESSING CONTINUES

If a GLOBAL parameter was in error, the parameter is ignored. Depending on the GLOBALS parameter in error, it could cause the CA APAS Data Collector to not compute some derived fields correctly such as COMMAND-COST and/or EST-CPU-TIME.

An error in a CA APAS request being automatically started with the MPM by including it in DBGIN results in the request in error not being added. The CA APAS Data Collector does not accumulate the information expected for that request.

To determine the cause of the DBG99001E error and User 26 abend, examine the CA APAS DBGPRINT data set for the abending MPM and check for errors in the GLOBALS and/or in the CA APAS requests being started via DBGIN. The CA APAS syntax checker flags all errors with an appropriate DBG error message. Review and correct the errors.

Note that the CA APAS control cards can be syntax checked prior to including them in DBGIN and the MPM by using the CA APAS batch utility program, APASENSU. See Support Online Knowledge Base Technical article - TEC502354.

Each CA APAS user must determine on an ADABAS MPM by MPM basics how they want CA APAS DBGIN start up errors to be handled. If it is imperative that the GLOBALS parameters and all requests started with the MPM are correct and started for billing, charge back, or auditing purposes, then specifying IGNORE-INIT-ERRORS=NO could be appropriate so that you are immediately aware of any DBGIN start up problems. However, if having the MPM start up regardless of whatever errors maybe contained in DBGIN, then specify IGNORE-INIT-ERRORS=YES.