General Information

Adabas RESTful administration consists of three main access parts:


Adabas Administration and Monitor Handler

The Adabas administration and monitor handler supports:

Resource Description
Adabas Database An Adabas database can be created or deleted on the server.
Adabas Runtime Adabas can be started or stopped using the possibilities that Adabas provides. User queue and UCB entries can be managed. Provides Adabas Nucleus log.
Monitor Display Adabas user queue, command queue and hold queue. Adabas high water mark and buffer pool statistics are available. All possible monitor features can be found in the Swagger definition.
Adabas Files Provide the creation and deletion of new Adabas files (online) .
Adabas Fields Inside the Adabas file, Adabas fields can be modified in the frame of the Adabas functionality.

Job Control

Inside the RESTful server it is possible to start scripts for Adabas utilities. The scripts can be triggered asynchronously. After the job is finished, the corresponding log output can be retrieved using a RESTful access.

Detailed information about the RESTful interface is described in the Swagger definition.

File Transfer Handler

The RESTful server provides an interface to upload or download files to or from the server. The server only provides access to restricted, defined directories. The directories have to be configured in the configuration file.

Each configuration entry can be accessed via a given name. All subdirectories under the configured one can be accessed and files can be transferred.

If a job creates output, the created file can be transferred to the HTTP client (browser or RESTful client).

Technical Insight

Adabas RESTful administration includes standard RESTful HTTP access methods. It supports two types of response formats:

  • JSON is the standard supported response format you can use.

  • XML can be used for read requests.

Adabas RESTful administration uses HTTP or SSL-secured HTTPS connections. HTTPS connections are recommended. To validate certificates, you can exchange the SSL certificate to fit to your environment.

The Adabas RESTful administration configuration contains the file reference and password to the key file that contains the certificate. The file is in Java keystore JKS format.

<KeyStore file="keys/keystore.jks"/>
<KeyPassword password="test123"/>

Adabas RESTful administration provides the following HTTP request types:

  • GET: Retrieve administration or monitor information

  • PUT: Change an administration value or parameter in the Adabas database configuration

  • PUSH: Create new objects such as Adabas database files or an Adabas database

  • DELETE: Delete a resource inside the Adabas database

The Adabas REST administration server is open to be used by any RESTful client. There are no restriction by Software AG components. The RESTful definition is provided in the Swagger file located in the product installation. You can use the Swagger/OpenAPI infrastructure to use the Swagger file.

Adabas Batch Administration

On the Software AG GITHUB page, you can download a batch administration client. The client application can access all flavors of Adabas administration tasks that the Adabas RESTful administration server provides.

The GITHUB page can be found at <https://github.com/SoftwareAG/adabas-admin-restful-client>.

The following example shows the batch command to list all available databases on the remote server:

client -url <host>:<port> list

The output of this example out would look something like this:

2018/10/10 12:40:54 Adabas Administration RESTful client started

2018/10/10 12:40:54 Server: linhost:8390
2018/10/10 12:40:54 User:   admin

Enter Password:
 Dbid   Name                  Active    Version

  001 [TestDatabase    ]      false    Adabas v6.6 (20)
  015 [SAMPLE_DB       ]      false    Adabas v6.6 (20)
  050 [GENERAL_DATABASE]      false    Adabas v6.5 (19)
  075 [GENERAL_DATABASE]      false    Adabas v6.7 (21)
  102 [GENERAL_DATABASE]      false    Adabas v6.6 (20)
  155 [SAMPLE_DB       ]      false    Adabas v6.7 (21)
  195 [DEMODB          ]      false    Adabas v6.7 (21)


2018/10/10 12:40:57 Adabas Administration RESTful client took 61.262267ms terminated

In batch mode, the ADABAS_ADMIN_URL envrionment points to the Adabas RESTful administration server, and the ADABAS_ADMIN_PASSWORD environment can contain the user password.

The Adabas batch client supports the following commands/functionality:

Command Functionality
env List Adabas environment version
list List all Adabas databases
start Start Adabas database
shutdown Shutdown Adabas database
cancel Cancel Adabas database
abort Abort Adabas database
info Retrieve Adabas database information
userqueue Display current user queue
cmdqueue Display current command queue
holdqueue Display current hold queue
highwater Display high water mark
commandstatsv Display Adabas command statistics
bp Display Adabas buffer pool statistics
activity Display Adabas activity
threadtable Display Adabas thread table
createdatabase Create new Adabas database
deletedatabase Delete an Adabas database
renamedatabase Rename an Adabas database
parameter List database parameter information
parameterinfo| List database parameter information with minimum and maximum ranges
setparameter Set database parameter
nucleuslog Display Adabas nucleus log
files Display Adabas file list
file Display Adabas file
deletefile Delete Adabas file
fields Display Adabas file definition table
information Display Adabas database information
container Display Adabas database container
renamefile Rename Database file
createfile Create Database file
checkpoints Display Database checkpoints. Without parameter it shows one day.
joblist Job control list
jobstart Start a specific job
deletejob Delete a specific job and the execution log
deletejobexec Delete the execution log of a job
createjob Create a new specific job
joblog Job entry log
listucb List Adabas UCB entries
deleteucb Delete Adabas UCB entry
addfields Add Adabas fields
status Adabas database online state
filelocations List all available file locations
listfiles List file in file location
downloadfile Download file from the file location
uploadfile Upload file to file location

Merge Adabas RESTful Server

The Adabas client for Java contains a module to access Adabas database data content. It is possible to enable the data access in the Adabas RESTful administration server. Please contact Softwarea AG support for the steps required to enable this data access.