PLI* - ADACOM Initialization Messages

ADACOM messages apply only to Adabas nucleus cluster environments.

All PLInnn messages are printed on the console. Messages in the range 0-49 are issued by the ADACOT module attached to a particular SVC/DBID set and are sent to the SYSOUT data set that is dynamically allocated for that particular module. Messages in the range 50 and above are issued by ADACOM and are written to the COMPRINT data set. Each message begins with a timestamp in the format "hh:mm:ss".

The following message groups are described:


Messages Issued by ADACOTs and Written to Own Data Sets (PLI002 - PLI049)

Overview of Messages

PLI002 | PLI003 | PLI004 | PLI005 | PLI009 | PLI010 | PLI012 | PLI013 | PLI014 | PLI015 | PLI016 | PLI017 | PLI018 | PLI019 | PLI020 | PLI021 | PLI022 | PLI023 | PLI024 | PLI027 | PLI028 | PLI030 | PLI031 | PLI032 | PLI034 | PLI035 | PLI036 | PLI038 | PLI039 | PLI040 | PLI041 | PLI042 | PLI048 | PLI049
PLI002 Initializing DBID=dbid SVC=svc message(s)
Explanation

This message identifies the ADACOM that is initializing by its database ID and SVC settings. It is followed by one or more relevant initialization message(s) (check the following possible PLI002 messages):

Message Text Explanation
Acquiring new PLXCB

Having determined that no Adabas cluster control block (PLXCB) currently exists, ADACOM is attempting to acquire a new one.

Cannot change number of users now. There are NUCS/ADACOMS active

Once the cluster is active; that is, once a nucleus or ADACOM starts, the PLXCB NU parameter is set and cannot be changed without bringing down the entire cluster, changing the parameter value, and restarting.

If you need to change the PLXCB NU parameter value, terminate all cluster nuclei, ADACOMs, and users and restart.

Cannot free PLXCB at this time. There are NUCS/ADACOMS active

Once the cluster is active; that is, once a nucleus or ADACOM starts, the PLXCB NU parameter is set and cannot be changed without bringing down the entire cluster, changing the parameter value, and restarting.

DBID is zero

This is an internal error. The ADACOM terminates abnormally (abends) the subtask for this DBID/SVC combination. Contact your Software AG technical support representative for assistance.

FORCE=YES detected -- initialization continues

The incompatible PLXCB version described in earlier lines will be released and initialization will continue.

Freeing old PLXCB

The NU parameter value is being changed or the FORCE option was specified for this DBID/SVC. The old environment is being freed.

GETMAIN failed for PLXCB

An attempt to acquire GETMAIN space for a new Adabas cluster control block (PLXCB) failed. The ADACOM subtask terminates abnormally (abends).

Ensure that sufficient space is available to allocate the PLXCB and resubmit the job.

IDTHPRFX not found

This is an internal error. Contact your Software AG technical support representative for assistance. ADACOM terminates abnormally (abends) the subtask for this DBID/SVC combination.

Max users capped at upper limit

The maximum size of the PLXUser pool is 14,913,014 elements.

Max users for image number-of-users

Displays the maximum number of users (NU) allowed for the operating system image.

Obtain of IDTHPRFX failed

The IDTH prefix created when the IDT was created accommodates 15 cluster DBIDs. It was necessary to acquire storage to extend the IDTH prefix for additional DBIDs. Insufficient storage was available (in z/OS this is ECSA).

Increase the region size to resolve this problem. For additional assistance, contact your Software AG technical support representative.

PLXCB is located at address

The location of the PLXCB, either new or existing, is provided. If the PLXCB was allocated in a dataspace the address is the ADACOM local storage into which it is mapped.

PLXCB version is vrs program
program level is vrs

An existing PLXCB is of a version incompatible with the specified program.

Incompatible ADASVC Version

ADASVC must be at the same or higher version and release as ADACOT.

PLXCB dataspace is name ALET ALET

The PLXCB dataspace was created.

Processed NU=O request

The system has processed the NU=0 parameter. The old environment has been freed and no new one was created.

PSW key pswkey not compatible with PLXCB key plxcbkey

A previously allocated PLXCB cannot be used because of a difference between the PSW and storage keys. Run ADACOM in the PLXCB key or delete the existing PLXCB and reallocate it in the desired key.

This SVC/DBID combination will terminate

Previously described errors prevent initialization. ADACOM terminates abnormally (abends) the subtask for this DBID/SVC combination.


PLI003 SVC=svc DBID=dbid OPERATOR COMMAND: command
Explanation

Confirms the operator command just issued and the SVC/DBID combination for which it is issued.


PLI004 imagename NUCID=nucid UP=x LO=y RO=z #USERS=n #CMNDS=n LURA=n RULA=n
PLI004 jobname nucid x y z n....... n........
Explanation

This message is issued in response to an ADACOM DN or DIM operator command. It displays the status of the cluster nuclei located on the named image, which may be local or remote images. There is one header line for each image which may be followed by detail lines for each active nucleus. The following table describes the components of this message:

Message Component Description
imagename The name of the local image.
NUCID=nucid The unique cluster nucleus identifier.
UP=x Specifies whether (Y or N) the specified nucleus is available for normal processing.
LO=y Specifies whether the specified nucleus is on the local image and open (Y); or on the local image and closed (N).
RO=z Indicates that the specified nucleus is not on a remote image (N).
#USERS=n The number of users that have been assigned to and are currently active for the specified nucleus.
#CMNDS=n The number of commands currently incomplete.
LURA=n The number of users remotely assigned to the local image.
RULA=n The number of users locally assigned to the remote image.
jobname The name of the ADACOM job or started task.

There may be conditions that prevent displaying active nuclei. These lines may appear instead of active nucleus detail lines.

Message Text Explanation
** Image has no active NUCs ** There are no active cluster nuclei to display on the local image.
* Local network down - no remote information * No information is available about remote images because the local Entire Net-Work is not active.
*No NUCs up or remote network down* No information is available from a remote image. Either there are no active nuclei on the remote image or the remote Entire Net-Work is not active.
* Remote images not detected * The specified image is not local and that ADACOM does not detect the presence of a remote image with the specified name.

PLI005 ** Image has no active NUCs **
Explanation

This message follows PLI004 for either a DIM or DN command when there are no active cluster nuclei to display on the local image.


PLI009 Invalid command: *
Explanation

The command entered is not a valid ADACOM command. This message follows PLI060, which displays the invalid command entered.

Action

Check the command used; reenter a valid ADACOM command.


PLI010 Command executed
Explanation

This message follows PLI060 for the SN command and indicates that the SN command with the parameters specified in PLI060 has been successfully executed.


PLI012 module load failed - exiting
Explanation

The module listed in the message (module) could not be loaded. The affected task abends.

Action

Ensure the named module is available in the load library concatenation. If you are unable to resolve the error, contact your Software AG technical support representative.


PLI013 Unable to set timer - exiting
Explanation

An internal error occurred while executing STIMERM. The affected ADACOT module abends.

Action

Contact your Software AG technical support representative.


PLI014 PSW key pswkey not compatible with PLXCB key plxcbkey
Explanation

A previously allocated PLXCB cannot be used because of a difference between the PSW and storage keys.

Action

Run the ADACOM in the PLXCB key, or delete the existing PLXCB and reallocate it in the desired key.


PLI015 Work area GETMAIN failed
Explanation

The attempt to allocate space for an ADACOT work area failed. The affected SVC/DBID combination abends.

Action

Increase the region size.


PLI016 IDTH prefix is not valid
Explanation

An internal error occurred: IDTHPRFX is invalid. The affected ADACOT module abends.

Action

Contact your Software AG technical support representative.


PLI017 Number of IDTE entries is zero
Explanation

An internal error occurred: the IDTH is invalid. The affected ADACOT module abends.

Action

Contact your Software AG technical support representative.


PLI018 ADACOT initialization failed
Explanation

The PLXINIT module failed during initialization. The affected ADACOT module abends.

Action

Contact your Software AG technical support representative.


PLI019 Get IDTH failed
Explanation

ADACOT was unable to obtain the address of the IDTH. The affected ADACOT module abends.

Action

Contact your Software AG technical support representative.


PLI020 SVC=svc DBID=dbid ADACOT {exiting | ended}
Explanation

This message occurs whenever an SVC/DBID combination terminates for any reason.


PLI021 Network detected down
Explanation

ADACOM detected that the local Entire Net-Work is not active.


PLI022 Network detected up and available
Explanation

ADACOM detected that the local Entire Net-Work is active and processing commands.


PLI023 No PARMs allowed for "DN"
Explanation

A parameter was supplied when issuing the ADACOM command DN. No parameters are allowed for the DN command. This message follows PLI060 which indicates the command and parameters issued.

Action

Remove the parameter(s) and issue DN again.


PLI024 Invalid system name
Explanation

The DIM command allows you to optionally supply an image name as a parameter. The DIM command was issued with a parameter value, but the value supplied is not a valid image name. This message follows PLI060 which indicates the command and parameters issued.

Action

Supply a valid image name and issue DIM again.


PLI027 CMDMGR=NO specified
Explanation

CMDMGR=NO was specified in the ADACOM; ADACOM quiesces after setting the environment.


PLI028 Net-Work not available RSP rc/sc
Explanation

ADACOM detected an active Entire Net-Work address space and issued a periodic internal command to verify that Entire Net-Work is accepting and processing commands. The internal command received an unexpected response code and subcode, which are given in the message (rc/sc). This usually indicates a problem with Entire Net-Work.

Action

Review the response code and subcode to determine the cause of the problem. If the problem persists, contact your Software AG technical support representative for assistance.


PLI030 Invalid NUC specification
Explanation

This message follows PLI060 for the SN command and indicates that the specified nucleus ID is not valid.

Action

Specify a valid nucleus ID and issue the command again.


PLI031 Command must specify "OP/CL"
Explanation

This message follows PLI060 for the SN command and indicates that the required parameters OP/CL were not specified.

Action

Specify the required parameters and issue the command again.


PLI032 Too many parameters
Explanation

This message follows PLI060 for the SN command and indicates that too many parameters have been specified when opening or closing one or more remote nuclei. Remote nuclei are always opened to local users only.

Action

Remove the erroneous parameter(s) and issue the command again.


PLI034 Local NUC(s) not found
Explanation

This message follows PLI060 for the SN command and indicates that the local nucleus specified was not found on the local image. If LCLALL was used in the command, no cluster nuclei were found on the local image.


PLI035 "ALL" not valid for "OP/CL"
Explanation

This message follows PLI060 for the SN command. "ALL" is not a valid parameter. You must indicate whether you want to open or close all local nuclei (LCLALL) or all remote nuclei (RMTALL). You cannot open or close all cluster nuclei on all images at once. You can, of course, open a specified nucleus or all nuclei on a specified remote image, if you choose.

Action

Specify the required parameters and issue the command again.


PLI036 Too few parameters - need "LCL/GBL"
Explanation

This message follows PLI060 for the SN command. When opening or closing nuclei on local images, you must indicate whether you are opening them to local users only (LCL) or to all cluster users (GBL).

Action

Specify the required information and issue the command again.


PLI038 Only "LCL" or "GBL" after "OP/CL"
Explanation

This message follows PLI060 for the SN command. When opening or closing nuclei on the local image, your only choices are to open the nuclei to local users only (LCL) or to all cluster users (GBL). No other options are allowed.

Action

Specify LCL or GBL and issue the command again.


PLI039 Remote NUC(s) not found
Explanation

This message follows PLI060 for the SN command and indicates that the remote nucleus specified was not found on any remote image. If a remote image was specified, no cluster nuclei were found on that image. If RMTALL was used in the command, no cluster nuclei were found on any remote image.


PLI040 Cannot exit now - dataspaces are allocated
Explanation

There are active Adabas Parallel Services nuclei that have active dataspaces, or a PLXCB dataspace is being used and one or more Adabas Parallel Services or Adabas Cluster Services nuclei are active.

Action

Terminate any Adabas Parallel Services or Adabas Cluster Services nuclei and try again.


PLI041 Valid PARMs: PLXCP, PLXNUC, PLXMAP, IDTE, FIIBS, PLXUSER, CLUDSP, IDTH, IDTHPRFX
Explanation

A DUMP operator command was entered with an operand other than one of the valid ones listed in the message.

Action

Reissue the command with a correct operand.


PLI042 message-text
Explanation

Various message texts are associated with this message number. Each is described in the following table:

Message Text Explanation
Only N=X, where X is prefix, is valid A DUMP PLXUSER command was entered with an invalid operand.

Action: Reissue the command with a correct operand.

The prefix is missing or now "=" specified A DUMP PLXUSER command was entered with invalid syntax or an invalid operand.

Action: Reissue the command with a correct operand.

There are no active users at this time A DUMP PLXUSER command was entered. There is nothing to list.

Action: No action is necessary for this informational message.

There are no active IDTEs at this time A DUMP IDTE command was entered. There is nothing to list.

Action: No action is necessary for this informational message.

Extended storage IIBs are not in use A DUMP FIIBS command was entered. There is nothing to list.

Action: No action is necessary for this informational message.

Extended storage but fat IIBS not in use A DUMP FIIBS command was entered. There is nothing to list.

Action: No action is necessary for this informational message.

No FIIBS in use at this time A DUMP FIIBS command was entered. There is nothing to list.

Action: No action is necessary for this informational message.

There are no valid maps at this time A DUMP PLXMAP command was entered. There is nothing to list.

Action: No action is necessary for this informational message.

There are no active entries A DUMP IDTHPRFX command was entered. There is nothing to list.

Action: No action is necessary for this informational message.

There are no active NUCs at this time A DUMP PLXNUC command was entered. There is nothing to list.

Action: No action is necessary for this informational message.

dbid Unable to allocate PLXMAP for system-target on system-name A PLXMAP update was received from a remote system for which there was no existing PLXMAP. A free PLXMAP slot could not be located. The update is discarded.

Action: This may occur if systems containing cluster nuclei were removed from the sysplex and other systems containing nuclei were added. If ADACOM is running, issue the DUMP PLXMAP command to examine the assignment of each PLXMAP. Contact your Software AG technical support representative for assistance.


PLI048 Unable to DEQ resource
Explanation

An internal error occurred: ADACOT was unable to release serialization for the named resource. The affected ADACOT module abends.

Action

Contact your Software AG technical support representative.


PLI049 RSP rsp/node-subcode from target system
Explanation

An attempt was made to update PLXCB structures on another operating system image participating in Adabas Cluster Services (ALS). The response code (rsp) and subcode (subcode) given in the message indicate an unexpected condition. The Entire Net-Work node ID may also be given in the message (node) if Entire Net-Work does not have connectivity to the remote system or if there are problems in the PLXCB structures on the remote system.

Action

If the reason for the response code is not clear and you cannot resolve the error by analyzing it, contact your Software AG technical support representative.


Messages Issued by ADACOM and Written to COMPRINT Data Set (PLI050 - PLI079)

Overview of Messages

PLI050 | PLI052 | PLI053 | PLI054 | PLI055 | PLI056 | PLI057 | PLI058 | PLI059 | PLI060 | PLI062 | PLI063 | PLI064 | PLI065 | PLI066 | PLI068 | PLI069 | PLI070 | PLI071 | PLI072 | PLI073 | PLI074 | PLI076 | PLI077 | PLI078 | PLI079 | PLI080 | PLI090 | PLI093 | PLI910 | PLI920 | PLI930
PLI050 Initializing ADACOM
Explanation

This is the first message produced when ADACOM is starting.


PLI052 Commands will go to SVC=svc,DBID=dbid
Explanation

A MODIFY command was issued to change the SVC/DBID combination that is to receive all following MODIFY commands.


PLI053 Remainder of input line ignored
Explanation

Characters were found at the end of a SVC=svc,DBID=dbid when no comma follows the SVC/DBID combination. Note that the SVC=svc and DBID=dbid can be in any order.


PLI054 Duplicate SVC= or DBID=
Explanation

A MODIFY command to change the SVC/DBID combination for commands was issued with more than one SVC= or DBID=.

Action

Reissue the command with only one SVC/DBID parameter set.


PLI055 Invalid SVC or DBID number
Explanation

A MODIFY command to change the SVC/DBID combination for commands was issued with a nonnumeric, invalid, or out of range SVC or DBID number.

Action

Reissue the command with a valid SVC/DBID parameter set.


PLI056 Invalid character in command
Explanation

A MODIFY command to change the SVC/DBID combination for commands was issued and no comma between SVC=svc and DBID=dbid.

Action

Correct the format and reissue the command.


PLI057 DBID= or SVC= missing
Explanation

A MODIFY command to change the SVC/DBID combination for commands was issued and either SVC= or DBID= missing.

Action

Add the required parameter and reissue the command.


PLI058 SVC/DBID pair not active in this ADACOM
Explanation

A MODIFY command to change the SVC/DBID combination for commands was issued and the SVC/DBID pair was not specified in the input stream.

Action

Specify the required parameters and reissue the command.


PLI059 SVC/DBID pair processing has ended
Explanation

A MODIFY command to change the SVC/DBID combination for commands was issued and the SVC/DBID pair processing has ended either from NU=0 or an abend.

Action

If you are unable to determine and correct the problem, contact your Software AG technical support representative.


PLI060 SVC=svc DBID=dbid operator command : command
Explanation

This message indicates that the specified command has been issued from the ADACOM identified by the SVC and DBID listed.


PLI062 Command queued
Explanation

A command is queued for execution. The results of the command will appear in the output data set for the SVC/DBID combination to which the command was issued.


PLI063 Processing: ADACOM SVC=svc,DBID=dbid,NU=users text
Explanation

Issued during initialization for each input line from DDKARTE or for an ADACOM operator command establishing or modifying support for a DBID/SVC pair. The text of the line appears to the right of the colon.

text Explanation
Initialization complete Issued as text for PLI063 if NU does not equal 0 and the startup for the SVC/DBID pair was successful.
program Initialization failed or incomplete Issued as text for PLI063 when the initialization process encounters an error for a SVC/DBID pair. The error may indicate a problem allocating a corresponding SYSOUT data set. Initialization for the other pairs continues.
program detached in initialization An error in initialization was detected. The ADACOM subtask for program was detached.
Processing ended normally Issued as text for PLI063 if NU=0 was specified and the PLXCB was processed normally.
Action

If you are unable to determine and correct the problem with the SVC/DBID parameter set, contact your Software AG technical support representative.


PLI064 ADACOM exiting
Explanation

This is the last message produced when the ADACOM job is terminating as a result of an ADAEND command or an error situation.


PLI065 Initialization complete for all DBID/SVC pairs
Explanation

ADACOM has initialized all specified DBID/SVC pairs. See the preceding PLI063 messages for the status of each pair's initialization.

Action

No action is necessary for this informational message.


PLI066 Minimum ADASVC level is V84 for PLXCB dataspace
Explanation

A request to create a PLXCB dataspace failed because ADASVC is not at the proper minimum level.

Action

Upgrade ADASVC or request the PLXCB be allocated in common memory.


PLI068 Unrecognized parameter
Explanation

During initialization when processing input from DDKARTE, an unrecognized parameter was encountered on the card. ADACOM abends.

Action

Check the DDKARTE parameters. If you are unable to determine and correct the problem, contact your Software AG technical support representative.


PLI069 Duplicate parameter
Explanation

Issued on initialization when processing input from DDKARTE and a duplicate parameter entry is seen. ADACOM abends.

Action

Correct the parameter entries and rerun the job.


PLI070 Invalid numeric
Explanation

Issued on initialization when an SVC or DBID number is recognized as invalid. ADACOM abends.

Action

Correct the parameter entries and rerun the job.


PLI071 SVC or DBID not specified
Explanation

Issued on initialization when an SVC or DBID number is recognized as invalid. ADACOM abends.

Action

Correct the parameter entries and rerun the job.


PLI072 IDTH not found
Explanation

Issued during initialization when the required IDTH control block cannot be found. ADACOM abends.

Action

If you are unable to determine and correct the problem, contact your Software AG technical support representative.


PLI073 Number of IDTEs is zero
Explanation

Issued during initialization when the number of IDTEs specified in the IDTH is zero. ADACOM abends.

Action

If you are unable to determine and correct the problem, contact your Software AG technical support representative.


PLI074 Duplicate SVC/DBID combo
Explanation

Issued during initialization if two input cards from DDKARTE specify the same SVC/DBID combination. ADACOM abends.

Action

Correct the parameter entries and rerun the job.


PLI076 Input must begin with "ADACOM"
Explanation

Issued during initialization when an input card from DDKARTE does not begin with "ADACOM" followed by at least one space. ADACOM abends.

Action

Correct the format of the parameter entries and rerun the job.


PLI077 ADACOM IS SHUTTING DOWN [ SVC=svc,DBID=dbid ADACOM PROCESSING COMPLETE ]
Explanation

Issued as the result of an ADAEND command or internal error causing an orderly shutdown. The part of the message enclosed in brackets is issued when an SVC/DBID combination has ended processing.

Action

If you are unable to determine and correct the problem, contact your Software AG technical support representative.


PLI078 Previous task has not ended
Explanation

Duplicate SVC/DBID combination in startup JCL. ADACOM abends.

Action

Correct the JCL and rerun.


PLI079 Error obtaining {CLUCONB | CLUDSPB }
Explanation

This message indicates a GETMAIN failure at startup (ADACOM abends) or while dynamically adding an SVC/DBID combination (the system continues running).

Action

At startup, increase the region size and rerun. When dynamically adding an SVC/DBID combination, either terminate ADACOM, increase the region size, and rerun; or start a second ADACOM.


PLI080 UID mismatch freeing PLXUSER/UTE at address attempting to delete UID uid1 UTE uid2
Explanation

ADACOM did not find the expected user ID string when attempting to release a PLXUSER (UTE).

Action

If the UTE value is all zeros, the UTE was already free. This can come about if an error recovery routine such as a z/OS ESTAE attempts to clean up by issuing CL commands. Natural has error recovery that may do this, particularly if a Natural program is canceled. If this is not the case, or the UTE is non-zero, this is an internal logic error. Contact your Software AG technical support representative.


PLI090 Not APF authorized - exiting
Explanation

ADACOM must run with z/OS APF authorization.

Action

Ensure that all load libraries are APF-authorized and rerun.


PLI093 PLXUSER X2/code RSP rsp/node-subcode target
Explanation

An Adabas ADACOM job servicing Adabas Cluster Services or Adabas Parallel Services nuclei issued an internal X2 command to release a PLXUSER representing a user either originating from or routed to another system. Such users have PLXUSERs on both systems. The command failed with the displayed response code and subcode.

The code listed in the message identifies the reason for the X2 command:

Code X2 Command Reason
8014 Delete PLXUSER on remote system.
8020 Query PLXUSER status for a user originating from a remote system.
8024 Query PLXUSER status for a local user assigned to a remote system.
Action

If the PLXUSER cannot be released at this time, attempts will be made at intervals to release it. Contact your Software AG technical support representative for assistance if the reason for the response code cannot be identified.


PLI910 Unable to determine Net-Work DBID target holder
Explanation

No image in the network holds the DBID as a network target and this nucleus failed in its attempt to establish it. This is an error condition. Commands from users in an image with no active nucleus and no active ADACOM l get response code 148 (ADARSP148).

Action

Either start up a different node in the network or shut down and restart an existing node to see if the problem resolves itself. If the problem persists, the user should contact Software AG Customer Support.


PLI920 NET-WORK DBID target held by image-system-name
Explanation

The remote image, identified in the message by its system name, holds the DBID as a network target.

Action

No action is required for this informational message.


PLI930 NET-WORK DBID target owned on this image
Explanation

The image in which this nucleus is active holds the DBID as a network target.

Action

No action is required for this informational message.