Client Version 1.4.1
 —  Entire Net-Work Client Installation and Administration  —

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

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

This document describes both of these utilities.


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-2011 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-2011 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 ...

Top of page

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-2011 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-2010 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 ...

Top of page