Using the aasutil Batch Program

The aasutil.exe batch utility program allows you to perform Adabas Administration Services administration functions in a batch environment on the Adabas Administration Services installed on the local machine. The aasutil.exe program can be found in the /bin directory wherever Adabas Administration Services is installed.

This document covers the following topics:


Syntax for Starting the Utility

The syntax of the aasutil.exe batch program is:

aasutil [help=yes]

This command should be entered on the command prompt after switching to the /bin directory wherever Adabas Administration Services is installed.

After entering this command, the utility is started and the following instructions are displayed, prompting you to make a selection:

Software AG Adabas Administration Service 2.1 Utility Program
(c) Copyright Software AG 1998-2014. All Rights Reserved.
USAGE: aasutil [trace=tracevalue (0-65534)] [help=yes]
Adabas Administration Service URL
TCPIP://AMV76402:49155?AASSERVICE=ON&Version=2.1.0.0
AMV76402_1 is Active
Please, choose one of the following functions:
(1)  List Adabas Administration Service parameters
(2)  Show service statistics
(3)  List all databases
(4)  Show a database statistics
(5)  List listens
(6)  List all clients
(7)  Show a client statistics
(8)  Stop a client
(9)  Stop all clients
(10) List all ADABAS contexts
(11) Show a context statistics
(12) Delete a context
(13) Delete all contexts
(14) List all hosts
(15) Show a host statistics
(16) Disconnect a host
(17) Shutdown this service
(18) Exit this utility
:

Getting Help

To get help with the aasutil.exe batch program, enter the following command prompt after switching to the /bin directory wherever Directory Server is installed:

aasutil help=yes

Help for the aasutil.exe batch program displays on the screen.

Exiting the Utility

Start of instruction setTo exit the aasutil.exe batch program, complete the following steps:

  • Enter an "18" at the utility prompt to select function 8 (Exit this utility).

    The utility stops.

Listing Adabas Administration Services Parameters

Start of instruction setTo list the parameters in the configuration file for this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "1" at the utility prompt to select function 1 (List Adabas Administration Services parameters).

    A list of all parameters the Adabas Administration Services configuration file, sagadmin.config, displays on the screen.

Displaying Adabas Administration Services Statistics

Start of instruction setTo display statistics for this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "2" at the utility prompt to select function 2 (Show service statistics).

    Statistics associated with the Adabas Administration Services display on the screen.

Listing Databases Registered by this Adabas Administration Services

Start of instruction setTo list databases registered by this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "3" at the utility prompt to select function 3 (List all databases).

    A list of all databases registered by this Adabas Administration Services displays on the screen.

Displaying Statistics for a Database Registered by this Adabas Administration Services

Start of instruction setTo display statistics for a database registered by this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "4" at the utility prompt to select function 4 (Show a database statistics).

    You are prompted to enter a database ID (DBID).

  3. Enter a DBID at the utility prompt.

    Statistics for the database display on the screen.

    Statistics for all databases registered by this Adabas Administration Services display on the screen.

Listing Listens Performed by this Adabas Administration Services

Start of instruction setTo list the listens performed by this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "5" at the utility prompt to select function 5 (List listens).

    Listen statistics for this Adabas Administration Services display on the screen.

Listing Clients Registered by this Adabas Administration Services

Start of instruction setTo list the clients registered by this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "6" at the utility prompt to select function 6 (List all clients).

    A list of the clients registered by this Adabas Administration Services displays on the screen.

Displaying Statistics for a Client Registered by this Adabas Administration Services

Start of instruction setTo display statistics for a client registered by this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "7" at the utility prompt to select function 7 (Show a client statistics).

    You are prompted to enter a client ID.

  3. Enter a client ID at the utility prompt.

    Statistics for the client display on the screen.

Stopping a Client Registered by this Adabas Administration Services

Start of instruction setTo stop a client registered by this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "8" at the utility prompt to select function 8 (Stop a client).

    You are prompted to enter a client ID.

  3. Enter a client ID at the utility prompt.

    The selected client is stopped.

Stopping All Clients Registered by this Adabas Administration Services

Start of instruction setTo stop all clients registered by this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "9" at the utility prompt to select function 9 (Stop all clients).

    All clients registered to this Adabas Administration Services are stopped.

Listing All Adabas Contexts Registered by this Adabas Administration Services

Start of instruction setTo list all Adabas contexts registered by this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "10" at the utility prompt to select function 10 (Stop all Adabas contexts).

    All Adabas contexts registered to this Adabas Administration Services display on the screen.

Displaying Statistics for an Adabas Context Registered by this Adabas Administration Services

Start of instruction setTo display statistics for a context registered by this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "11" at the utility prompt to select function 11 (Show a context statistics).

    You are prompted to enter a context ID.

  3. Enter a context ID at the utility prompt.

    Statistics for the context display on the screen.

Deleting an Adabas Context Registered by this Adabas Administration Services

Start of instruction setTo delete an Adabas context registered by this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "12" at the utility prompt to select function 12 (Delete a context).

    You are prompted to enter a context ID.

  3. Enter a context ID at the utility prompt.

    The selected context is deleted.

Deleting All Adabas Contexts Registered by this Adabas Administration Services

Start of instruction setTo delete all Adabas contexts registered by this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "13" at the utility prompt to select function 13 (Delete all contexts).

    The contexts are deleted.

Listing All Hosts Registered by this Adabas Administration Services

Start of instruction setTo list all hosts registered by this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "14" at the utility prompt to select function 14 (List all hosts).

    A list of the hosts registered by this Adabas Administration Services displays on the screen.

Displaying Statistics for a Host Registered by this Adabas Administration Services

Start of instruction setTo display statistics for a host registered by this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "15" at the utility prompt to select function 15 (Show a host statistics).

    You are prompted to enter a host ID.

  3. Enter a host ID at the utility prompt.

    Statistics for the host display on the screen.

Disconnecting a Host Registered by this Adabas Administration Services

Start of instruction setTo display statistics for a host registered by this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "16" at the utility prompt to select function 16 (Disconnect a host).

    You are prompted to enter a host ID.

  3. Enter a host ID at the utility prompt.

    The selected host is disconnected.

Shutting Down this Adabas Administration Services

Start of instruction setTo shut down this Adabas Administration Services, complete the following steps:

  1. Start the utility, as described in Syntax for Starting the Utility.

  2. Enter a "17" at the utility prompt to select function 17 (Shutdown this service).

    The Adabas Administration Services is shut down.