When CICS is started, the LNKENAB component displays several informational or error messages on the system console. These often contain the addresses of key Adabas and CICS control blocks which are useful in problem determination.
Be sure that the console messages indicate that the Adabas TRUE environment has been properly established.
If an error message is produced, note the CICS EIBRESP, EIBRESP2, and EIBRCODE, which is displayed.
Note any Adabas response code (ACBRSP) displayed by the LNKENAB program at CICS startup.
The variable data in the LNKENAB messages is described as follows:
true-name | the name of the Adabas task-related user exit module |
link-name | the name of the Adabas command-level link module |
sss | the ADAGSET SVCNO parameter as set in LNKOLSC |
dddd | the ADAGSET LOGID parameter as set in LNKOLSC |
aaaaaaaa | the hexadecimal address |
nnnnn | the ADAGSET NUBS parameter as set in LNKOLSC |
Note:
The values for "sss", "dddd" and "nnnnn" are given in decimal. All
other displayed numeric values are presented in hexadecimal.
The following LNKENAB messages occur during CICS PLTPI processing. They are provided for information only but may be used for problem determination:
ADAK040 | ADAK041 | ADAK042 | ADAK043 | ADAK044 | ADAK045 | ADAK046 | ADAK047 | ADAK048 | ADAK049 | ADAK050 | ADAK051 | ADAK052 | ADAK053 | ADAK054 | ADAK055 | ADAK056 | ADAK057 | ADAK058 | ADAK059
ADAK040 | ENABLING ADABAS TASK RELATED USER EXIT |
Explanation: |
The Adabas task-related user exit has been enabled. |
ADAK041 | EXTRACTING GLOBAL WORK AREA (GWA) |
Explanation: |
CICS is determining the location of the global work area (GWA) for the command-level link components. |
ADAK042 | INITIALIZING ADABAS LINK ROUTINE |
Explanation: |
An initialization call is being made to the command-level link routine. |
ADAK043 | INITIALIZING ADABAS SVC COMMUNICATION |
Explanation: |
The Adabas SVC environment is being established. |
ADAK044 | ADABAS Vvrs CICS ENVIRONMENT ESTABLISHED |
Explanation: |
The CICS environment needed for the command-level link components has been built. |
ADAK045 | T.R.U.E. true-name IS IN USE BY ADABAS LINK ROUTINE link-name |
Explanation: |
This message displays the task-related user exit name and the Adabas link routine with which it is associated. |
ADAK046 | SVC NUMBER: svc DEFAULT DBID: dbid |
Explanation: |
This message displays the default SVC number and DBID. |
ADAK047 | UB POOL ADDRESS: aaaaaaaa NUBS: nnnnn |
Explanation: |
This message displays the UB pool address and NUBS value. |
ADAK048 | USER EXIT AFTER (A) ADDRESS: { aaaaaaaa | NOT IN USE } |
Explanation: |
This message displays the address of the Adabas user exit A or "not in use" if user exit A is not in use. |
ADAK049 | USER EXIT BEFORE (B) ADDRESS: { aaaaaaaa | NOT IN USE } |
Explanation: |
This message displays the address of the Adabas user exit B or "not in use" if user exit B is not in use. |
ADAK050 | REVIEW EXIT ADDRESS: { aaaaaaaa | NOT IN USE } |
Explanation: |
This message displays the address of the Adabas Review exit, or "not in use" if the Adabas Review exit is not in use. |
ADAK051 | ADABAS SAF SECURITY (ADASAF) IN USE |
Explanation: |
The Adabas external security interface (ADASAF) is in use. This message is not displayed if ADASAF is not in use. |
ADAK052 | ADABAS TRANSACTION MANAGER (ATM) IN USE |
Explanation: |
Adabas transactions are being coordinated through the CICS Resource Manager Interface (RMI) using the Adabas Transaction Manager (ATM). This message is not displayed if the RMI is not in use. |
ADAK053 | ADABAS BRIDGE FOR VSAM (AVB) IN USE |
Explanation: |
The Adabas Bridge for VSAM (AVB) is in use. This message is not displayed if AVB is not in use. |
ADAK054 | T.R.U.E. GLOBAL WORK AREA (GWA) ADDRESS: aaaaaaaa |
Explanation: |
This message displays the address allocated to the global work area. |
ADAK055 | ADABAS LINK ROUTINE EPA: aaaaaaaa |
Explanation: |
This message displays the entry point address (EPA) of the Adabas link routine. |
ADAK056 | ADABAS LINK ROUTINE D.C.I. EPA: aaaaaaaa |
Explanation: |
This message displays the entry point address (EPA) of the Adabas link routine direct call interface (DCI). |
ADAK057 | ADABAS SVC IDTH ADDRESS: aaaaaaaa |
Explanation: |
This message displays the address of the Adabas SVC IDT header. |
ADAK058 | RESYNC COMMAND ISSUED |
Explanation: |
The CICS RMI for Adabas is in use and resynchronization will now take place for any incomplete transactions involving Adabas databases. |
ADAK059 | ATM INACTIVE; RESYNC DEFERRED |
Explanation: |
The CICS RMI for Adabas is in use and resynchronization may be required for incomplete transactions involving Adabas databases. However, the Adabas Transaction Manager (ATM) is not currently active. Resynchronization will occur when ATM is restarted. |
The following LNKENAB messages may appear if an error occurs in the installation or execution of the command-level link routine, the PLT-enable program, or the task-related user exit.
Note:
In the following error messages, values displayed as "xxx.." are
hexadecimal, while those displayed as "nnn.." are decimal.
ADAK061 | ADAK062 | ADAK063 | ADAK064 | ADAK065 | ADAK066 | ADAK068 | ADAK069 | ADAK070 | ADAK071
ADAK061 | ADATRUE - ENABLE STAGE FAILED EIBRESP: xxxxxxxx EIBRESP2: xxxxxxxx |
Explanation: |
The task related user exit could not be enabled due to the EIB response code "xxxxxxxx" and EIB response code 2 "xxxxxx". |
Action: |
Consult the appropriate CICS documentation to determine the cause of the error in the exec interface block (EIB). |
ADAK062 | ADATRUE EXTRACT GWA FAILED EIBRESP: xxxxxxxx EIBRESP2: xxxxxxxx |
Explanation: |
The requested task-related user exit global storage could not be EXTRACTed due to the EIB response and response 2 codes given as "xxxxxxxx". |
Action: |
Consult the appropriate CICS documentation to determine the cause of the error in extracting the global work area. |
ADAK063 | INITIALIZATION CALL TO LINK ROUTINE FAILED EIBRCODE: xxxxxxxx ADARSP: nnnn |
Explanation: |
The Initialize Link command (IL) could not be executed because of EIB response code "xxxxxxxx", or Adabas response code "nnnn". |
Action: |
If the EIBRCODE field returns a non-zero value, consult the appropriate CICS documentation to determine the cause of the error. If the ADARSP returns a non-zero value, consult the response codes in chapter 2. |
ADAK064 | ADABAS CALL TO ESTABLISH IDTH FAILED |
Explanation: |
The close command (CL) to Adabas failed due a response code other than response 148. |
Action: |
Most often, this is caused by an incorrect Adabas SVC number in the ADAGSET macro; otherwise, check to see that the Adabas SVC is installed, and at the correct version. |
ADAK065 | INVALID D.C.I ADDRESS - CANNOT CONTINUE |
Explanation: |
The IDTH address was not set by the command-level link routine during the CL command. |
Action: |
Verify that the correct version of the Adabas command-level link routine is installed, and that the entry point name "ENTPT=" in ADAGSET is correct. |
ADAK066 | ADAENAB VERSION: version DOES NOT MATCH ADABAS LINK |
Explanation: |
The ADAENAB version does not match the version of the ADATRUE or "ADABAS" link routine being installed. All three modules must be at the same version for the install to succeed. |
Action: |
Verify that the correct version of all three modules is installed. |
ADAK068 | RMI INITIALIZATION ERROR: CMD: cmd RESP: resp RC: rc |
Explanation: |
The RMI initialization routine could not complete its processing due to the indicated error. The message may provide a failing CICS command ("cmd") and response code ("resp"), or an ATM error code ("rc") and, if relevant, Adabas response code ("resp"). |
Action: |
Investigate the meaning of the displayed response code and/or error code. If possible, correct the error; otherwise, report the details to your Software AG technical support representative. |
ADAK069 | LOAD of ACI link routine failed EIBRCODE: eibrcode |
Explanation: |
The load of the Adabas command-level link routine module failed. The hexadecimal representation of the CICS EIBRCODE (eibrcode) returned by the failing EXEC CICS LOAD command is given in the message. |
Action: |
Determine the cause of the failure. The reason for the failure may be determined by examining previous messages produced by the ADAENAB installation program. These messages are written to the JES joblog for z/OS and to SYSLOG for VSE. For more information please consult your Adabas installation documentation. |
ADAK070 | Adabas T.R.U.E. disabled module-name |
Explanation: |
A failure occurred during the execution of the enhanced installation program. The Adabas TRUE (Task Related User Exit) is disabled. The name of the Adabas TRUE module being installed is given in the message (module-name). |
Action: |
Determine the cause of the failure. The reason for the failure may be determined by examining previous messages produced by the ADAENAB installation program. These messages are written to the JES joblog for z/OS and to SYSLOG for VSE. For more information please consult your Adabas installation documentation. |
ADAK071 | Adabas link routine released module-name |
Explanation: |
A failure occurred during the execution of the enhanced installation program. The CICS command-level link routine has been released. The name of the Adabas CICS command-level link routine being installed is given in the message (module-name). |
Action: |
Determine the cause of the failure. The reason for the failure may be determined by examining previous messages produced by the ADAENAB installation program. These messages are written to the JES joblog for z/OS and to SYSLOG for VSE. For more information please consult your Adabas installation documentation. |