Entire Net-Work Utility Functions for the Directory Server (checkadi and setadi)

#### Search Results

Search

# Entire Net-Work Utility Functions for the Directory Server (checkadi and setadi)

Two Entire Net-Work utility functions with focus on the Adabas Directory Server availability and settings are provided for you to use in batch mode:

- Use the checkadi utility function to check for a Directory Server.

- Use the setadi utility function to set Directory Server access parameters for Entire Net-Work and Entire Net-Work Client.

This document describes both of these utilities.

- The checkadi Utility

- The setadi Utility

## The checkadi Utility

Use the checkadi utility to check for the existence of a Directory Server. The syntax of the checkadi function is:

    checkadi [host=host-name] [[port=]port-value]

Use the host or port arguments to check for the existence of a Directory Server on a specific host or port number. You can use both the host and port arguments to more specifically check for a Directory Server on a specific host and port.

#### Example 1

In the following example, a check is run for a Directory Server on the usaxxx2 host at port 12731:

    checkadi host=usaxxx2 port=12731

The following sample output from such a check might appear:

    Software AG Entire Net-Work, Copyright ©) 1997-2019 by Software AG
    USAGE: checkadi [host=hostname] [port]=portvalue]
    argv[1] host=usaxxx2
    Check host=usaxxx2
    argv[2] port=12731
    Check port=12731
    Port was set to 12731
    Check Host=usaxxx2
    Check Port=12731
    Server is Active; check if this is a Directory Server
    Select Data from Directory Server successful
    Bytes ready to read=309
    Response=0x010x33  0x760x310x090x720x650x730x700x6f0x6e0x730x650x090x09
    Expected=                 0x760x310x090x720x650x730x700x6f0x6e0x730x650x090x09
    Directory Server is Active
    Checkadi ending ...

#### Example 2

In the following example, a check is run to determine where a Directory Server exists:

    checkadi

The following sample output from such a check might appear:

    Software AG Entire Net-Work, Copyright ©) 1997-2019 by Software AG
    USAGE: checkadi [host=hostname] [port]=portvalue]
    Resolve SAGXTSDSHOST
    Failure Resolve Host Name; use localhost
    Port was not set, so we will use the default port=12731
    Check Host=usaxxx2.YYY.ww.zzz
    Check Port=12731
    Server is Active; check if this is a Directory Server
    Select Data from Directory Server successful
    Bytes ready to read=309
    Response=0x010x33  0x760x310x090x720x650x730x700x6f0x6e0x730x650x090x09
    Expected=          0x760x310x090x720x650x730x700x6f0x6e0x730x650x090x09
    Directory Server is Active
    Checkadi ending ...

## The setadi Utility

Use the setadi utility to set Directory Server access parameters for Entire Net-Work and Entire Net-Work Client. The syntax of the setadi function is:

    setadi {WCP|WCL} host=host-name port=port-value [XTSTRACE={value|65534}]

You must specify either "WCP" (to set the access parameters for Entire Net-Work) or "WCL" (to set access parameters forEntire Net-Work Client). You should also specify the host name and port number parameters. The XTSTRACE parameter is optional; if you do not specify it, a default value of "65534" is used.

Note
While you can use setadi to change the Directory Server used, the changes only affect the configuration of the services and agents. It will not change the Directory Server assigned to any existing Kernels.

#### Example 1

In the following example, help for setadi is displayed, but no access parameters are set.

    setadi

The following sample output from such a setadi request might appear:

    Software AG Entire Net-Work, Copyright ©) 1997-2019 by Software AG
    Usage: setadi <options...>
    The following options are supported:
    WCP|WCL
    HOST=host name
    PORT=port value
    XTSTRACE=value (65534)

    WCP|WCL -  the user selects which product to set, WCP or WCL

#### Example 2

In the following example, an Entire Net-Work entry for host "localhost" at port "12731" is defined. The default XTSTRACE value of "65534" is used.

    setadi WCP host=localhost port=12731

The following sample output from such a setadi request might appear:

    Software AG Entire Net-Work, Copyright ©) 1997-2019 by Software AG
    argv[2] host=localhost
    argv[3] port=12731
    Check Host=localhost
    Check Port=12731
    Server is Active; check if this is a Directory Server
    Select Data from Directory Server successful
    Bytes ready to read=309
    Response=0x010x33  0x760x310x090x720x650x730x700x6f0x6e0x730x650x090x09
    Expected=                0x760x310x090x720x650x730x700x6f0x6e0x730x650x090x09
    Directory Server is Active
    CODEPATH=C:\Program Files\Software AG\Entire Net-Work Server\v74\
    DATAPATH=C:\Documents and Settings\All Users\Application Data\Software AG\Entire Net-Work Server\
    Changing C:\Documents and Settings\All Users\Application Data\Software AG\Entire Net-Work Server\service74.config
    Changing C:\Documents and Settings\All Users\Application Data\Software AG\Entire Net-Work Server\agents\xts.config
    Configuration file change successful
    Setadi exiting ...

### On this page

- The checkadi Utility
- The setadi Utility