BIND
The BIND command is responsible for establishing a connection to the LDAP server.
A simple bind sends the user's DN and password. An anonymous bind may be established by not sending a password.
It is possible to establish a secure connection, using SSL, and this BIND command provides for this option.
Required
BIND ------------ HOST ------------ host ------------------------>
Optional
>-- PORT ------------ port ------------------------>
>-- SECURE ---------- *NO ------------------------->
*YES
>-- DN -------------- authentication name --------->
Conditional
>-- PASSWORD -------- value -----------------------|
Keywords
|
HOST |
The host address of the LDAP server you connecting to. This keyword is mandatory. |
|
PORT |
The port to connect to on the host. By default, this value will be 389 for a simple connection, or 636 for a secured connection. This keyword is optional. |
|
SECURE |
Used to specify whether you want to establish a secure connection to the server. The default value is *NO (for an unsecured connection). This keyword is optional. |
|
DN |
The authentication name. The DN may be used without a password, establishing an anonymous connection. It is also possible not to pass this value at all, also establishing an anonymous connection. This keyword is optional. |
|
PASSWORD |
This keyword must be passed, along with the DN keyword, if authentication is required. A DN value may be sent without a PASSWORD value, but a PASSWORD value may not be sent without a DN value. |
Examples
RDML
CHANGE FIELD(#JSMCMD) TO('''BIND HOST(<LDAP-server-name>) DN(cn=Administrator) PASSWORD(password)''')
USE BUILTIN(JSM_COMMAND) WITH_ARGS(#JSMCMD) TO_GET(#JSMSTS #JSMMSG)
RDMLX
#JSMCMD := 'Bind Host(<LDAP-server-name>) DN(cn=Administrator) Password(password)'
Use Builtin(JSMX_COMMAND) With_Args(#JSMHND #JSMCMD) To_Get(#JSMSTS #JSMMSG)