Adabas Cluster Operator Commands

#### Search Results

Search

# Adabas Cluster Operator Commands

This part of the documentation provides information on the operator commands for ADACOM and for an Adabas cluster nucleus.

This document covers the following topics:

- ADACOM Operator Commands

- Adabas Cluster Nucleus Operator Commands

## ADACOM Operator Commands

Special ADACOM operator commands exist to display and control the multiprocessing environment. These commands, which are similar to regular Adabas operator commands, are issued to the local ADACOM initialization job.

This section covers the following topics:

- ADACOM Environment

- ADACOM Command Syntax and Processing

- Controlling Subtasks

- Controlling PLXCBs

- DIM - Display Images

- DN - Display Active Nuclei

- DUMP - Dump Storage Areas

- SN - Set Nucleus Status

### ADACOM Environment

The main ADACOM task controls the initial processing and routing of operator commands. It also attaches and detaches a pair of subtasks (load modules ADACOT and ADADSP) for each specific SVC/DBID combination. After initialization ADACOT processes SVC/DBID-specific operator commands. ADADSP allocates, owns and deallocates dataspaces.

The SVC/DBID-specific subtasks may be attached as specified in ADACOM Initialization Parameters DDKARTE statements or by operator commands after ADACOM has initialized.

Note
ADACOM writes global ADACOM messages into the output data set with the DD name COMPRINT. It writes messages pertinent to an individual SVC/DBID combination into the output data set with the DD name 'Pssddddd', where ss is the last two digits of the SVC number and ddddd is the database ID. Similarly, dataspace-related messages are written to DD name ‘Dssddddd'

### ADACOM Command Syntax and Processing

When running the Adabas Cluster and Parallel Services routine ADACOM, the operator commands described in this section can be specified in following input formats:

where

jobname | name of the ADACOM job or started task
command | one of the operator commands described in this section

Every operator command is first processed by the ADACOM main task and is echoed with the message

    PLI060 SVC=svc DBID=dbid Operator Command:xxx

Certain SVC/DBID-specific commands must identify which SVC/DBID is being addressed:

After initialization, any command issued is directed to the last SVC/DBID pair encountered in the input. Whenever a new default SVC/DBID is established by an operator command this message will appear:

    PLI052 Commands will go to SVC=svc DBID=dbid

Commands to be serviced by the ADACOT SVC/DBID-specific subtask show this message:

    PLI062 Command queued

Message PLI062 is issued by the ADACOM main task. The subtask will respond to the command.

If you enter an operator command for an SVC/DBID and a previous command to the same SVC/DBID has not yet completed, you will receive message PLI062 but only one of the commands will be processed. If the first command has not yet been accepted by the subtask the second command will take precedence and the first command will be ignored. If processing has begun on the first command the second command will be ignored.

A command can be given only if the SVC/DBID subtasks are already active (has been specified before, and not terminated). Otherwise, specify the SVC/DBID pair without a command to activate the SVC/DBID (as shown above), and then issue the command separately (as shown below). If, when starting an SVC/DBID pair, a PLXCB is not found one will be allocated using default values. Specific values may also be given:

When you change or add a SVC/DBID, the new SVC/DBID becomes the default for all commands issued until the SVC/DBID is changed.

### Controlling Subtasks

The ADACOM subtasks used to allocate and monitor the PLXCB and subordinate data structures terminate after processing if CMDMGR=NO has been specified for that SVC/DBID pair. If CMDMGR=YES (the default setting) has been specified for the SVC/DBID pair, the ADACOM subtasks stay active and accepts operator commands for displaying and controlling the multiprocessing environment.

Any SVC/DBID pair specifying the PLXCB to be placed in a dataspace requires ADACOM to be running with active SVC/DBID subtasks.

Cluster Services (ALS) nuclei do not require ADACOM SVC/DBID subtasks to be active for normal operation. However, operator commands other than those that start the subtasks or terminate ADACOM cannot be issued unless the subtasks are active.

SVC/DBID subtasks may be terminated by sending an ADAEND command to the specific SVC/DBID:

| Warning: You must specify the SVC and DBID when terminating an SVC/DBID combination. Otherwise, the ADAEND command terminates the entire ADACOM job. The currently set default does not apply when using ADAEND.

The command will be rejected if there are active nuclei using the PLXCB.

When the subtasks terminate all dataspaces are deleted. The PLXCB remains unless it was allocated in a dataspace.

### Controlling PLXCBs

A PLXCB and associated structures (PLXNuc, PLXMap, PLXUser) must exist for each SVC/DBID combination with active nuclei. These are created as specified by DDKARTE initialization parameters or operator commands as described above. If there is no PLXCB, the first Cluster Services nucleus will allocate one using the nucleus ADARUN NU value and the defaults for the other parameters.

PLXCB parameters such as NU and LOC cannot be changed after the PLXCB is allocated. Any existing PLXCB must be deleted and a new one allocated. This is done automatically when ADACOM is started if the change is initiated by DDKARTE input statements as long as there are no active nuclei using the PLXCB. It is also done automatically if, when the first Cluster Services nucleus starts, there are no ADACOM SVC/DBID subtasks running and NU is different from the existing PLXCB.

When the subtasks aren’t running and no nuclei are using an existing PLXCB, an operator command directed to the SVC/DBID specifying or defaulting NU, LOC, FORCE or CMDMGR parameters will delete any existing PLXCB and allocate a new one using the specified parameters.

You can delete an existing PLXCB without allocating a new one as long as no nuclei are using the existing PLXCB by specifying NU=0 on either a DDKARTE statement or an operator command. Using the operator command requires the subtasks not be active.

The FORCE=YES operand will override the requirement that no active nuclei are using the existing PLXCB, as may be the case after certain abnormal terminations. Note that if one or more active nuclei are using the PLXCB they will ABEND after the existing PLXCB is deleted.

LOC=DSP requires the SVC/DBID subtasks be active.

### DIM - Display Images

This command is serviced by an SVC/DBID subtask.

Use DIM to display the number of commands processed and the number of currently active users for each active nucleus on every image known to the local image.

If the image name is specified, DIM displays the information for the specified image only.

#### Sample Output

    PLI060 SVC=svc DBID=dbid OPERATOR COMMAND:DIM
    PLI004 image-name NUCID UP LO RO -#USERS- -#CMNDS- LURA=  RULA=
           jobname    00001 Y  Y  N  00000152 00000001
    PLI007 image-name NUCID UP LO RO -#USERS- -#CMNDS- LURA=  RULA=
           jobname    00002 Y  ** NN 00000089 00000000

Nuclei on the local image start open; nuclei on remote images start closed to the local image. The display uses the following indicators:

image-name | the name of the image: in PLI004 displays, this is the local image; in PLI007 displays, this is a remote image
jobname | the job name of a cluster nucleus active on that image
NUCID | the unique cluster nucleus identifier between 1 and 65000
UP | whether (Y or N) the specified nucleus is available for normal processing
LO | whether the specified nucleus is on the local image and open for new users (Y); on the local image and closed for new users (N); or not on the local image (**)
RO | whether the specified local nucleus (PLI0004 message) is closed for new users from remote images (N) or open for new users from all images (G); or whether the specified remote nucleus (PLI007 message) is closed for new users from remote (as seen from that nucleus) images (NN), open for new users from this image (where DIM was issued) but not necessarily other images (LN), or open for new users from all images (NG and LG)
#USERS | the number of users currently assigned to the specified nucleus
#CMNDS | the number of commands currently in progress in the specified nucleus
LURA= | the number of local users currently assigned to a remote image
RULA= | the number of remote users currently assigned to the local image

### DN - Display Active Nuclei

This command is serviced by an SVC/DBID subtask.

Use DN to display the number of commands processed and the number of currently active users for each active nucleus on the local image only.

#### Sample Output

    PLI060 SVC=svc DBID=dbid OPERATOR COMMAND:DN
    PLI004 image-name NUCID UP LO RO -#USERS- -#CMNDS- LURA=  RULA=
           jobname    00001 Y  Y  N  00000152 00000001
    PLI004 image-name NUCID UP LO RO -#USERS- -#CMNDS- LURA=  RULA=
           jobname    00002 Y  Y  N  00000000 00000000

Nuclei on the local image start open. The display uses the following indicators:

image-name | the name of the image: in PLI004 displays, this is the local image name
jobname | the job name of the cluster nucleus active on the local image
NUCID | the unique cluster nucleus identifier between 1 and 65000
UP | whether (Y or N) the specified nucleus is available for normal processing
LO | whether the specified local nucleus is open (Y) or closed for new users (N)
RO | whether the specified nucleus is closed for new users from remote images (N) or open for new users from all images (G)
#USERS | the number of users currently assigned to the specified nucleus
#CMNDS | the number of commands currently in progress in the specified nucleus
LURA= | the number of local users currently assigned to a remote image
RULA= | the number of remote users currently assigned to the local image

### DUMP - Dump Storage Areas

This command is serviced by an SVC/DBID subtask.

The DUMP command displays internal information about various storage areas that Adabas Cluster Services and Adabas Parallel Services use for controlling the communication with the cluster nuclei. Use this command as directed by Software AG Support. Its output might be helpful in the diagnosis of communication-related problems with cluster databases.

where stg-area can be any of the following storage areas: CLUDSP, IDTE, IDTH, IDTHPRFX, PLXCB, PLXMAP, PLXNUC, PLXUSER, or SVC.

### SN - Set Nucleus Status

This command is serviced by an SVC/DBID subtask.

where

RMTALL | is REMOTE ALL: all nuclei on all remote images
OP | is OPEN
CL | is CLOSE
LCLALL | is LOCAL ALL: all nuclei on the local image
LCL | is LOCAL: local users
GBL | is GLOBAL: all sysplex cluster users

The possible options settings for the SN command are described as follows:

Option | Action
--- | ---
RMTALL {OP | CL} | open or close all nuclei on all remote images to the image issuing the command.
image-name {OP | CL} | open or close all nuclei on the specified remote image to the image issuing the command.
nucleus-id {OP | CL} | open or close the specified remote nucleus to the image issuing the command.
LCLALL {OP | CL} LCL | open or close all nuclei on the local image to local users. Information is not broadcast to other images.
nucleus-id {OP | CL} LCL | open or close the specified local nucleus to local users. Information is not broadcast to other images.
LCLALL {OP | CL} GBL | open or close all nuclei on the local image to all sysplex cluster users.
nucleus-id {OP | CL} GBL | open or close the specified local nucleus to all sysplex cluster users.

By default, nuclei start open to local users and closed to remote users.

After the nuclei start, the SN operator commands may be used to exercise some control over the assignment of users to nuclei. For example, in a node with no active local nuclei, it is necessary to open at least one remote nucleus to users from the local node in order to run user programs in that node.

## Adabas Cluster Nucleus Operator Commands

The following console operator commands can be issued against a local Adabas cluster nucleus. In addition, the console operator commands documented in Adabas Operations documentation can be issued against any local nucleus.

Command | To ...
--- | ---
CLUFREEUSER | Delete leftover cluster user table elements (UTEs or PLXUSERs) in common storage that are no longer associated with user queue elements (UQEs) in a nucleus
CLUPUBLPROT | Dynamically modify the setting of the ADARUN CLUPUBLPROT parameter
DMEMTB | Display information about active Adabas cluster nuclei
DNFV | Display information about current file use
DPARM | Display Adabas session parameters currently in effect
DPPT | Display information about the nucleus's own PPT block
DRES | Display the allocated pool space and the highest use level (high water mark) during current session
DTARG | Display the system image currently servicing commands routed using the Entire Net-Work DBID target
DXCACHE | Display the primary cache-related statistics
DXFILE | Display the cache-related statistics for 1 to 5 files
DXLOCK | Display the lock-related statistics
DXMSG | Display the Adabas Cluster Services messaging performance statistics
DXSTAT | Display all cache- and lock-related statistics
DXWORK | Display the I/O statistics for WORK datasets of peer nuclei in the cluster
MXCANCEL | Dynamically change the ADARUN MXCANCEL setting
MXCANCELWARN | Dynamically change the ADARUN MXCANCELWARN setting
MXMSG | Dynamically change the ADARUN MXMSG setting
MXMSGWARN | Dynamically change the ADARUN MXMSGWARN setting
MXSTATUS | Dynamically change the ADARUN MXSTATUS setting
MXWTOR | Dynamically change the ADARUN MXWTOR setting
SMFDETAIL | Dynamically select the detail section types in SMF Interval and Termination records
TARGET | Route commands to a specified target.

Note
See the Adabas Cluster Services Operations documentation for information about issuing Adabas utility ADADBS OPERCOM commands against the local cluster nucleus, a specified cluster nucleus, or all cluster nuclei.

### CLUFREEUSER Command: Delete Leftover Cluster User Table Elements

Note:
The CLUFREEUSER command is only valid in cluster environments. It can be issued against the local nucleus only or, with the GLOBAL option, against all active and inactive nuclei in the cluster.

Use the CLUFREEUSER command to delete leftover cluster user table elements (UTEs or PLXUSERs) in common storage that are no longer associated with user queue elements (UQEs) in a nucleus.

TNA | TNA specifies a decimal number specifying the timeout value in seconds (max-time). PLXUSERs that are not used during the time specified may be deleted if other conditions are fulfilled. If TNA= is not specified, PLXUSERs may be deleted without regard to their recent use.
UID |
UID specifies a character string or hexadecimal byte string format user ID (userid) as follows:
cccccccc | where the argument is 1-8 letters, digits, or embedded '-' signs without surrounding apostrophes.
'cccccccc' | where the argument is 1-8 characters with surrounding apostrophes.
X'xxxxxxxxxxxxxxxx' | where the argument is an even number of 2-16 hexadecimal digits enclosed by X' '.
A character string must be enclosed in apostrophes if it contains characters other than letter, digits, or embedded '-' signs. If a specified character string is less than eight characters long, it is implicitly padded with blanks. If a specified hexadecimal string is shorter than 16 hexadecimal digits, it is implicitly padded with binary zeros. If the last eight bytes of a user's 28-byte communication ID match a specific user ID or user ID prefix (UIDPRFX parameter), that user's PLXUSER may be deleted if other conditions are fulfilled. If UID is not specified, PLXUSERs may be deleted regardless of their user IDs. "UID" may be abbreviated to "U". UID and UIDPRFX are mutually exclusive; one or the other, but not both, can be specified.
UIDPRFX | UIDPRFX accepts the same operands as UID. It operates in the same manner as UID, except that the operand is considered a prefix and there is no implicit padding. If the operand matches the initial bytes of the last eight bytes of the 28-byte communication ID, that PLXUSER may be deleted if other conditions are fulfilled. "UIDPRFX" may be abbreviated to "UP". UID and UIDPRFX are mutually exclusive; one or the other, but not both, can be specified.
FORCE | FORCE indicates that leftover PLXUSERs are to be deleted even if the users are due a response code 9 (ADARSP009), subcode 20. If FORCE is not specified, such PLXUSERs are not deleted. Before using the FORCE parameter, ensure that the users owning the PLXUSERs to be deleted will not expect any of their transactions to remain open.
GLOBAL | GLOBAL indicates that leftover PLXUSERs throughout the Adabas cluster are to be deleted if they are no longer associated with UQEs and are eligible according to the other specified parameters. Additionally and subject to the other rules, leftover PLXUSERs are deleted if their assigned nuclei have terminated since their last use. If GLOBAL is not specified, only PLXUSERs assigned to the local nucleus and used since the nucleus start are eligible for deletion.

### CLUPUBLPROT Command: Dynamically Change CLUPUBLPROT Parameter Setting

Use the CLUPUBLPROT command to dynamically modify the setting of the ADARUN CLUPUBLPROT parameter. For more information, read CLUPUBLPROT Parameter: Publishing of Protection Data.

The CLUPUBLPROT command is only valid in cluster environments. It is global by definition and affects all nuclei in the cluster.

### DMEMTB Command: Display Member State Table

The DMEMTB command can be issued against Adabas cluster nuclei to display the member state table, which provides information about all of the active nuclei in an Adabas cluster. The information produced by this command may be used by Software AG technical support.

The output produced by the DMEMTB command includes a third flag that indicates whether a system- or message-level XCF status monitoring exception has been encountered and whether a message was issued for the exception.

#### Sample Output

    ADAX61 00226 2009-06-24 16:53:26 Member Status Table
    ADAX61 00226 2009-06-24 16:53:26 Other members:        1
    ADAX61 00226 2009-06-24 16:53:26   This system:        1
    ADAX61 00226 2009-06-24 16:53:26
    ADAX61 00226 2009-06-24 16:53:26         NUCID:    2,261
    ADAX61 00226 2009-06-24 16:53:26   Internal ID:        2
    ADAX61 00226 2009-06-24 16:53:26        System: DA2F
    ADAX61 00226 2009-06-24 16:53:26      Job Name: USACHPD1
    ADAX61 00226 2009-06-24 16:53:26   Flags 1/2/3: 11/00/00
    ADAX61 00226 2009-06-24 16:53:26
    ADAX61 00226 2009-06-24 16:53:26         NUCID:    2,262
    ADAX61 00226 2009-06-24 16:53:26   Internal ID:        3
    ADAX61 00226 2009-06-24 16:53:26        System: DA2F
    ADAX61 00226 2009-06-24 16:53:26      Job Name: USACHPD2
    ADAX61 00226 2009-06-24 16:53:26   Flags 1/2/3: D7/00/00
    ADAN41 00226 2009-06-24 16:53:26 Function completed

Flags 1, 2, and 3 in this report are hexadecimal values that provide the following information about each nucleus:

Flag | Provides
--- | ---
1 | The cluster member service summary, as a combination of one or more of the following values: X’80’ – All services are active X’40’ – Work data set is needed for recovery X’10’ – Accepting and processing intracluster commands X’04’ – Cache services are available X’02’ – Lock services are available X’01’ – Messaging services are available For example, a value of 97 for Flag 1 indicates that all services are active (X’80’), the nucleus is accepting and processing intracluster commands (X’10’), and cache (X’04’), lock (X’02’) and messaging (X’01’) services are all available (80+10+4+2+1=97).
2 | The cluster member failure status, as a combination of one or more of the following values: X’80’ – All services are down X’40’ – Canceled by this nucleus X’10’ – Abnormal termination of intracluster command processing occurred X’04’ – Abnormal exit from cache occurred X’02’ – Abnormal exit from lock occurred X’01’ – Abnormal exit from the XCF group (messaging) occurred
3 | The cluster XCF status monitoring summary, as a combination of one or more of the following values: X’80’ – A system-level XCF status monitoring exception occurred. X’40’ – A member-level XCF status monitoring exception occurred. X’02’ – A warning message was issued for the system-level XCF status monitoring exception. X’01’ – A warning message was issued for the member-level XCF status monitoring exception. For example, a value of 41 for Flag 3 indicates that a member-level XCF status monitoring exception occurred (X’40’) and that a warning message (X’01’) was issued for it (40+1=41).

### DNFV Command: Display Nucleus File Variables

Use the DNFV command to display information about current file use.

This command provides information about the files in use at a particular point in time. It also indicates which other nucleus has exclusive file control if, for example, a user program receives a response 148 (ADARSP148), subcode 15.

Here is some sample output:

    ADAI29 OPER CMD: DNFV

    FNR=00008  A=Y U=Y ID=      CA=00000   CU=00001

where;

FNR=nnnnn | is the file number
A={Y | N} | (yes or no) indicates whether the file is used for access (read and/or search)
U={Y | N} | (yes or no) indicates whether the file is used for update. Use for update includes use for access.
ID=nucid | is the ID of the nucleus that owns the file lock, if the file is locked.
CA=nnnnn | is the number of users on this nucleus who are currently accessing this file.
CU=nnnnn | is the number of users on this nucleus who are currently updating this file.

### DPARM Command: Display Adabas Session Parameters

Use the DPARM command to display the Adabas session parameters currently in effect. Here is an example:

    15:54:43 ADAI29 Oper cmd: DPARM
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 AOSLOG=NO
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 ARNWORKBUFFERS=5
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 ASSOSPACEWARN=0
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 ASYTVS=YES
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 AUTOCQENV=ALL
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 AUTOCQTIME=0
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 CLOGMRG=NO
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 CLUCACHENAME=SAG1_CACHE
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 CLUGROUPNAME=SAG1CLU
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 CLULOCKNAME=SAG1_LOCK
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 CLUPUBLPROT=YES
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 CLUSTER=SYSPLEX
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 CLUWORK1CACHE=5
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 CT=900
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 DATASPACEWARN=0
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 DIRRATIO=4
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 ELEMENTRATIO=1
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 FMXIO=1
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 INDEXCROSSCHECK=YES
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 INDEXUPDATE=ADVANCED
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 INTNAS=3,600
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LARGEPAGE=NO
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LBP=104,858,624
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LCP=10,000
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LDEUQP=7,000
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LFIOP=90,000
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LFP=100,000
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LI=4,000
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LOGCB=YES
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LOGFB=NO
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LOGGING=NO
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LOGIB=NO
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LOGIO=NO
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LOGMB=NO
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LOGRB=NO
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LOGSB=NO
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LOGUX=NO
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LOGVB=NO
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LOGVOLIO=NO
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LOGWARN=0
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LP=1,200
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LQ=30,000
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LRDP=10,485,760
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LS=19,968
    15:54:43 ADAN16 00035 2016-11-29 15:54:42 LU=655,350
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 LWP=5,242,880
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 MXCANCEL=6,000
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 MXCANCELWARN=1,500
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 MXMSG=6,000
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 MXMSGWARN=1,500
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 MXSTATUS=6,000
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 MXTNA=3,600
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 MXTSX=3,600
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 MXTT=3,600
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 MXWTOR=0
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 NC=500
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 NCLOG=0
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 NH=8,000
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 NISNHQ=1,999
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 NONDES=YES
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 NPLOG=0
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 NPLOGBUFFERS=5
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 NQCID=250
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 NSISN=100
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 NT=20
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 NU=500
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 NUCID=10,001
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 NWORK1BUFFERS=50
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 READONLY=NO
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 REFSTPRT=YES
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 REVIEW=NO
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 RIAFTERUPDATE=NO
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 SECUID=ALLOW
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 SMF=NO
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 TLSCMD=20
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 TNAA=1,800
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 TNAE=1,800
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 TNAX=1,800
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 TT=1,800
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 UPDATECONTROL=NODELAY
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 UTIONLY=NO
    15:54:44 ADAN16 00035 2016-11-29 15:54:42 V64BIT=NO
    15:54:44 ADAN41 00035 2016-11-29 15:54:42 Function completed

Additional Adabas add-on products and nucleus components may display more parameters than are shown in this sample.

### DPPT Command: Display Parallel Participant Table (PPT)

Use the DPPT command to display the parallel participant table (PPT) block for a nucleus.

This command produces internal information for use by Software AG technical support.

#### Sample Output

    ADAI29 Oper cmd: DPPT
    ADAN24 00199 2009-01-27 22:31:35 Display PPT RABNs 00000083 to 000000A2
    ADAN24 00199 2009-01-27 22:31:35
    ADAN24 00199 2009-01-27 22:31:35          PPT RABN: 00000083
    ADAN24 00199 2009-01-27 22:31:35 Number of entries: 05
    ADAN24 00199 2009-01-27 22:31:35 Nucleus indicator: E2
    ADAN24 00199 2009-01-27 22:31:35             NUCID: 0000
    ADAN24 00199 2009-01-27 22:31:35    Session number: 0005
    ADAN24 00199 2009-01-27 22:31:35   Last PLOG block: 00000000
    ADAN24 00199 2009-01-27 22:31:35    PLOG block ind: 00
    ADAN24 00199 2009-01-27 22:31:35  PPT Entry length: 0023
    ADAN24 00199 2009-01-27 22:31:35          Entry ID: E6
    ADAN24 00199 2009-01-27 22:31:35 Dataset=/SAGUID/PLX2/V7/WORKR1/
    ADAN24 00199 2009-01-27 22:31:35  PPT Entry length: 0023
    ADAN24 00199 2009-01-27 22:31:35          Entry ID: 61
    ADAN24 00199 2009-01-27 22:31:35 Dataset=/ SAGUID /PLX2/V7/PLOGR1/
    ADAN24 00199 2009-01-27 22:31:35  PPT Entry length: 0023
    ADAN24 00199 2009-01-27 22:31:35          Entry ID: 62
    ADAN24 00199 2009-01-27 22:31:35 Dataset=/ SAGUID /PLX2/V7/PLOGR2/
    ADAN24 00199 2009-01-27 22:31:35  PPT Entry length: 0023
    ADAN24 00199 2009-01-27 22:31:35          Entry ID: 41
    ADAN24 00199 2009-01-27 22:31:35 Dataset=/ SAGUID /PLX2/V7/CLOGR1/
    ADAN24 00199 2009-01-27 22:31:35  PPT Entry length: 0023
    ADAN24 00199 2009-01-27 22:31:35          Entry ID: 42
    ADAN24 00199 2009-01-27 22:31:35 Dataset=/ SAGUID /PLX2/V7/CLOGR2/
    ADAN41 00199 2009-01-27 22:31:35 Function completed

### DRES Command: Display Allocated Pool Space and High Water Marks

Use the DRES command to display the allocated pool space and the highest use level (high water mark) during current session. Here is an example:

    17:32:07 ADAI29 Oper cmd: DRES
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 Resource       Size       Current    Highwater
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 AB  -Pool    1228800          N/A        1536
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 CQ  -Pool      96000            0         192
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 DUQ -Pool       7000            0           0
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 FI  -Pool     100000            0         160
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 HQ  -Pool     416000            0        5200
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 Redo-Pool   10485760            0         176
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 Sec -Pool      10000            0           0
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 TBI -Pool       4000            0           0
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 TBS -Pool      30000            0           0
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 UQ  -Pool     183456         1092        1456
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 UQF -Pool      48384           72         144
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 Wrk1-IO B         50            0           5
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 WORK-Pool    5242880          128       34584
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 Work Part1      1200            0           7
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 Work Pt 1b         4            4           4
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 Work Part2        20            0           0
    17:32:07 ADAN28 00035 2016-11-29 17:32:05 Work Part3       270            0           0
    17:32:07 ADAN41 00035 2016-11-29 17:32:05 Function completed

Note:
The usage of the protection data extension area (resource name `Work Pt 1b`) reflects the number of WORK blocks that the nucleus is keeping/has kept in the global cache. The protection data extension area provides space for these WORK blocks for the case that the nucleus occasionally does not participate in a buffer flush performed by a peer nucleus in the cluster.

### DTARG Command: Display System Image

Use the DTARG command to display the system image currently servicing commands routed using the Entire Net-Work DBID target. This command can be issued against Adabas cluster nuclei.

The Entire Net-Work DBID target is used to route commands from users on remote systems with no active PLXCB. Such systems may be part of the z/OS sysplex or other Entire Net-Work nodes outside the sysplex.

### DXCACHE Command: Display Cache Statistics

Issue the DXCACHE command against cluster nuclei to display the primary cache-related statistics. Statistics are displayed in messages on the console. The kinds of statistics displayed are described in External Cache Statistics (Cluster Nucleus Only).

The full set of statistics shown in this output is displayed only for users who have the selectable unit Adabas Online System (AOS) installed.

If you have installed only the demo version of AOS delivered with Adabas, only the statistics in the sections Totals, Data Storage, and Normal Index are displayed using this command.

### DXFILE Command: Display Cache Statistics for Files

Issue the DXFILE command against cluster nuclei to display cache-related statistics for one to five files.

Statistics are displayed in messages on the console. The kinds of statistics displayed are described in External Cache Statistics (Cluster Nucleus Only).

### DXLOCK Command: Display Lock Statistics

Issue the DXLOCK command against cluster nuclei to display lock-related statistics. Statistics are displayed in messages on the console. The kinds of statistics displayed are described in External Lock Statistics (Cluster Nucleus Only).

### DXMSG Command: Display Messaging Performance Statistics

The DXMSG command can be used to display the messaging performance statistics available for Adabas Cluster Services or Adabas Parallel Services. Statistics are displayed in messages on the console. The kinds of statistics displayed are described in Messaging Statistics, in the Adabas Cluster Services Operations Guide or Adabas Parallel Services Operations Guide.

The statistics produced by the DXMSG command can be used to determine the impact of messaging on system performance and to determine how to set the ADARUN MXMSG parameter.

### DXSTAT Command: Display Cache and Lock Statistics

Use the DXSTAT command against cluster nuclei to display all cache- and lock-related statistics as well as I/O statistics for WORK datasets in the cluster. Statistics are displayed in messages on the console. The kinds of statistics displayed are described in External Cache Statistics (Cluster Nucleus Only), External Lock Statistics (Cluster Nucleus Only) and WORK Data Set I/O Statistics (Cluster Nucleus Only) .

The full set of external cache statistics shown in this output is displayed only for users who have the selectable unit Adabas Online System (AOS) installed.

If you have installed only the demo version of AOS delivered with Adabas, only the external cache statistics in the sections Totals, Data Storage, and Normal Index are displayed using this command. All file cache statistics for files and all external lock statistics are displayed.

### DXWORK Command: Display I/O Statistics for WORK Datasets

Use the DXWORK command to display the read and write I/O statistics for the accesses to the WORK datasets of peer nuclei by a particular nucleus in the cluster. The DXWORK command may or may not display I/O statistics for a nucleus’ own WORK dataset. Here is an example:

    17:04:58 ADAI29 Oper cmd: DXWORK
    17:04:58 ADAX61 00035 2016-12-01 17:04:57 WORK dataset I/O statistics:
    17:04:58 ADAX61 00035 2016-12-01 17:04:57
    17:04:58 ADAX61 00035 2016-12-01 17:04:57 Internal NUCID :               2
    17:04:58 ADAX61 00035 2016-12-01 17:04:57 External NUCID :           10002
    17:04:58 ADAX61 00035 2016-12-01 17:04:57  Reads         :               3
    17:04:58 ADAX61 00035 2016-12-01 17:04:57  Writes        :               0
    17:04:58 ADAX61 00035 2016-12-01 17:04:57
    17:04:58 ADAX61 00035 2016-12-01 17:04:57 Internal NUCID :               3
    17:04:58 ADAX61 00035 2016-12-01 17:04:57 External NUCID :           10001
    17:04:58 ADAX61 00035 2016-12-01 17:04:57  Reads         :               1
    17:04:58 ADAX61 00035 2016-12-01 17:04:57  Writes        :               0
    17:04:58 ADAN41 00035 2016-12-01 17:04:57 Function completed

### MXCANCEL Command: Dynamically Change MXCANCEL Parameter Setting

The MXCANCEL command can be used against cluster nuclei to dynamically change (while the Adabas nucleus is running) the setting of the MXCANCEL ADARUN parameter for a nucleus. This command can be used to specify the maximum number of seconds for which one cluster nucleus waits for the termination of another nucleus in the cluster that it has canceled for not responding to an internal, intracluster command. Valid values range from 15 through 2147483647.

If the new MXCANCEL value is less than or equal to the current MXCANCELWARN setting, the MXCANCELWARN setting is automatically set to zero (0). (You can then use the MXCANCELWARN command to dynamically set the MXCANCELWARN setting appropriately.)

For more information about the MXCANCEL setting for a nucleus, read about the ADARUN MXCANCEL parameter in the Adabas Operations Manual.

### MXCANCELWARN Command: Dynamically Change MXCANCELWARN Parameter Setting

The MXCANCELWARN command can be used to dynamically change (while the Adabas nucleus is running) the setting of the MXCANCELWARN ADARUN parameter for a nucleus. This command can be used to specify the number of seconds after an intracluster cancellation request is made when the cluster nucleus requesting the cancellation should issue warnings about the inability of the canceled peer nucleus to terminate. Valid values can be zero (0) or an integer ranging from 4 through the value of MXCANCEL minus 1 (MXCANCEL-1).

The value of the MXCANCELWARN setting must be less than the value of the MXCANCEL setting. If MXCANCELWARN is set to a value greater than or equal to the value specified for MXCANCEL, the value is rejected. If MXCANCELWARN is set to zero, no warnings are issued about canceled cluster nuclei that are slow to terminate.

For more information about the MXCANCELWARN setting for a nucleus, read about the ADARUN MXCANCELWARN parameter in the Adabas Operations Manual.

### MXMSG Command: Dynamically Change MXMSG Parameter Setting

The MXMSG command can be used to dynamically change (while the Adabas nucleus is running) the setting of the MXMSG ADARUN parameter for a cluster nucleus. This command can be used to specify the maximum number of seconds in which one cluster nucleus waits for the response of another nucleus in the cluster to an internal, intracluster command. Valid values range from 15 through 32767.

If the new MXMSG value is less than or equal to the current MXMSGWARN setting, the MXMSGWARN setting is automatically set to zero (0). (You can then use the MXMSGWARN command to dynamically set the MXMSGWARN setting appropriately.)

For more information about the MXMSG setting for a nucleus, read about the ADARUN MXMSG parameter in the Adabas Operations Manual.

### MXMSGWARN Command: Dynamically Change MXMSGWARN Parameter Setting

The MXMSGWARN command can be used to dynamically change (while the Adabas nucleus is running) the setting of the MXMSGWARN ADARUN parameter for a cluster nucleus. This command can be used to specify the number of seconds after an intracluster request is made when the cluster nucleus issuing the intracluster request should issue warnings about the failure of the target cluster nucleus to respond. Valid values can be zero (0) or an integer ranging from 4 through the value of MXMSG minus 1 (MXMSG-1).

The value of MXMSGWARN must be less than the value of MXMSG. If MXMSGWARN is set to a value greater than or equal to the value specified for MXMSG, the value is rejected. If MXMSGWARN is set to zero, no warnings are issued about cluster nuclei that are slow to respond.

For more information about the MXMSGWARN setting for a nucleus, read about the ADARUN MXMSGWARN parameter in the Adabas Operations Manual.

### MXSTATUS Command: Dynamically Change MXSTATUS Parameter Setting

The MXSTATUS command can be used to dynamically change (while the Adabas nucleus is running) the setting of the MXSTATUS ADARUN parameter for a cluster nucleus. This command can be used to specify the number of seconds between member-level XCF status monitoring heartbeats. Valid values range from 15 through 21474836.

Note
The MXSTATUS command is only used for Adabas Cluster Services and not for Adabas Parallel Services. Adabas Parallel Services does not use XCF and ignores the setting.

The MXSTATUS command can only be used to change the value of the MXSTATUS parameter if the ADARUN MXSTATUS parameter is not zero (0). This command cannot be used to turn status monitoring on (by specifying a nonzero value if the ADARUN MXSTATUS setting is zero) or to turn it off (by specifying a value of zero when the ADARUN MXSTATUS setting is nonzero). However, setting MXSTATUS to a very high value is effectively the same as turning status monitoring off (monitoring will occur very infrequently at least).

For more information about the MXSTATUS setting for a nucleus, read about the ADARUN MXSTATUS parameter in the Adabas Operations Manual.

### MXWTOR Command: Dynamically Change MXWTOR Parameter Setting

The optional MXWTOR command can be used to dynamically change (while the Adabas nucleus is running) the setting of the MXWTOR ADARUN parameter for a cluster nucleus. This command can be used to specify the maximum number of seconds that a cluster nucleus should wait for an operator response to a self-terminating operator query. Valid values range from 15 through 64800 or zero (0).

If MXWTOR is set to zero, the operator query does not occur (no ADAX9J messages are written) and no operator intervention is expected.

For more information about the MXWTOR setting for a nucleus, read about the ADARUN MXWTOR parameter in the Adabas Operations Manual.

### SMFDETAIL Command: Select the Detail Section Types in SMF Interval and Termination Records

Adabas SMF records can contain a variable set of detail sections in Interval and Termination records (subtypes 2 and 3). This command allows you to override the setting of the SMFDETAIL ADARUN parameter defined for this Adabas sesssion. Using this command you can select the detail section types in Interval and Termination records that should be included in the Adabas SMF records. Unlike the SMFDETAIL ADARUN parameter, the value or values you specify for the SMFDETAIL command do not need to be enclosed in parentheses. If you specify NONE or ALL, they should be specified alone. However, you can specify one or more of the other detail section names (CMD, CSHB, CSHF, CSHG, CSHP, FILE, IODD, LOCK, MSGB, MSGC, MSGH, PARM, STG, THRD, ZIIP or USER) in one SMFDETAIL parameter, separating each value with a comma.

The following table describes the meaning of the possible detail section names that can be used in the SMFDETAIL command:

Detail Section Name | Description
--- | ---
ALL | Generate all possible detail sections in the Adabas SMF records. If this value is specified, no others can be specified on the SMFDETAIL parameter.
CMD | Generate Adabas command activity detail sections in the Adabas SMF records.
CSHB1 | Generate global cache activity by block detail sections in the Adabas SMF records.
CSHF1 | Generate global cache activity by Adabas file number detail sections in the Adabas SMF records.
CSHG1 | Generate global cache activity detail sections in the Adabas SMF records.
CSHP2 | Generate Adabas Parallel Services cache activity detail sections in the Adabas SMF records.
FILE | Generate Adabas file activity detail sections in the Adabas SMF records.
IODD | Generate I/O activity by DD statement detail sections in the Adabas SMF records.
LOCK1 | Generate global lock activity detail sections in the Adabas SMF records.
MSGB1 | Generate internucleus messaging control block activity detail sections in the Adabas SMF records.
MSGC1 | Generate internucleus messaging count detail sections in the Adabas SMF records.
MSGH1 | Generate internucleus messaging service time histogram detail sections in the Adabas SMF records.
NONE | Generate no detail sections in the Adabas SMF records. If this value is specified, no others can be specified on the SMFDETAIL parameter.
PARM | Generate ADARUN parameter value detail sections in the Adabas SMF records.
STG | Generate Adabas storage pool detail sections in the Adabas SMF records.
THRD | Generate thread activity detail sections in the Adabas SMF records.
ZIIP | Generate zIIP statistics detail sections in the Adabas SMF records.
USER | Generate user-defined details sections in the Adabas SMF records. If USER is specified, a value for the UEXSMF parameter should also be specified to identify the user exit to be invoked to generate the user-defined detail section.
1 Available only in cluster environments (Adabas Cluster Services or Adabas Parallel Services must be installed). 2 Available only in cluster environments with Adabas Parallel Services installed.

### TARGET Command: Route Commands to Specified Target

Use this command against an Adabas Cluster Services nucleus to specify the system on which the Entire Net-Work DBID target for the cluster database is to be established. Specify a system name or the NUCID of a cluster nucleus on that system. The DBID target can be established on any system where a nucleus of the cluster is active. It is used to route commands from users on remote systems with no active PLXCB. Such systems may be part of the z/OS sysplex or other Entire Net-Work nodes outside the sysplex.

The command instructs Entire Net-Work to route requests to an Entire Net-Work node on an implicitly or explicitly specified system image. All future commands will be routed to the new destination. If there are existing users who have been routed using the DBID target and the target is relocated to another Entire Net-Work node, they will be reassigned to any cluster nuclei on the new node. These users lose their existing sessions with their previously assigned nuclei. As a consequence, they may receive response code 9 (ADARSP009) on the first command after the target is moved. Furthermore, they may receive response code 21 (ADARSP021) if they attempt to reuse previously defined command IDs (logical read sequences or search results).

Several possible operands can be used to specify the desired DBID target assignment, as described in the following table.

Operand | Description
--- | ---
* | Specify an asterisk (*) to assign the DBID target to the Entire Net-Work node associated with the nucleus receiving the command.
nucid | Specify the nucleus ID (as defined in the ADARUN NUCID parameter) of an active cluster nucleus to assign the DBID target to the Entire Net-Work node associated with that nucleus.
sysname | Specify a system name (LPAR name) to assign the DBID target to the Entire Net-Work node associated with an active cluster nucleus on that system.

Note
The DBID target identifies an Entire Net-Work node, not a specific nucleus on a system. The DBID target is jointly serviced by all nuclei on that Entire Net-Work node.

### On this page

- ADACOM Operator Commands
- Adabas Cluster Nucleus Operator Commands