jbschkds (Windows only)

Organization of this page

Function
Format
Required execution permission
Command directory
Arguments
Return values
Example

Function

The jbschkds command displays the settings of the directory server linkage, the result on connecting to the directory server, and the result of user authentication, while the directory server linkage is enabled. The following are displayed:

Whether the directory server linkage function is enabled
Directory server name
Port number
Whether SSL is to be used
Information-search user ID
ID (JP1 user)
Result on connecting to the directory server
Result of information-search user authentication
Result of user authentication (JP1 user)

This command should be executed on an authentication server where the directory server linkage function has been enabled.

To Page Top

Format

jbschkds [-h logical-host-name]
         [-u JP1-user-name -p password]

To Page Top

Required execution permission

Administrators. (If User Account Control (UAC) for Windows is enabled, you must execute the command from the administrator console.)

To Page Top

Command directory

installation-folder\bin\

To Page Top

Arguments

`-h` `logical-host-name`

When using JP1/Base in a cluster system, specify the logical host for which you want to execute this command. If you omit this option, the host name set in the environment variable JP1_HOSTNAME is assumed. If the environment variable JP1_HOSTNAME is not set, the physical host name is assumed.

`-u` `JP1-user-name`

Specify a JP1 user name that is authenticated on the directory server.

`-p` `password`

Specify the password for the user specified by the -u option.

To Page Top

Return values

`0`	Normal end
`2`	Invalid arguments
`4`	Insufficient system resource such as memory
`64`	No execution permission
`128`	Inconsistency in internal processing (a C++ exception)
`255`	Other error

To Page Top

Example

The following shows examples of output.

When the directory server linkage function is disabled

>jbschkds 
The directory server linkage functionality is disabled.

When the directory server linkage function is enabled and the JP1 user is successfully authenticated (when the SEARCH_USER_DN parameter is enabled)

>jbschkds -u jp1user -p password
Directory server settings
  Directory server name host-A
  Port number 636
  SSL Use
  Information-search user distinguished name CN=Groupcsearcher,OU=GroupC,DC=netmanage,DC=local
  Search-startpoint container object OU=GroupC,DC=netmanage,DC=local
  Authentication attribute sAMAccountName
The directory server is now connected.
The information-search user was successfully authenticated.
User authentication succeeded.

When the directory server linkage function is enabled and the JP1 user is successfully authenticated (when the SEARCH_USER_DN parameter is disabled)

>jbschkds -u jp1user -p password
Directory server settings
  Directory server name host-A 
  Port number 636
  SSL Use
  Distinguished name CN=jp1user,CN=Users,DC=netmanage,DC=local
The directory server is now connected.
User authentication succeeded.

When the directory server linkage function is enabled and the directory server connection failed.

>jbschkds 
Directory server settings:
Directory server name:host-A 
Port number: 636
SSL Use
KAVA5810-E A connection to the directory server could not be established.
Server Down

To Page Top