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