IBM Support

LDAP (IBM Tivoli Directory Server) Fails to Start

Troubleshooting


Problem

Attempts to start any/all LDAP server instances fails reporting with message sequence GLD040B rc -456, GLD040A, GLD0416 and SQL0456. Both the GLD040B rc 456 and the SQL0456 pointed to QGLDRSDX already existing. Resolution is to drop the QGLDRSDX function.

Resolving The Problem

Attempts to start any or all LDAP server instances fails reporting with message sequence GLD040B rc -456, GLD040A, GLD0416 and SQL0456. Both the GLD040B rc 456 and the SQL0456 pointed to QGLDRSDX already existing. Resolution is to drop the QGLDRSDX function.

Here is an example of the error message highlighting the SQL function already exists:

SQL0456 Diagnostic 30 09/11/11 10:33:53.470978 QSQPROC QSYS *STMT
From user . . . . . . . . . : QSECOFR
From module . . . . . . . . : QSQPROC
From procedure . . . . . . : CLEANUP
Statement . . . . . . . . . : 45045
To module . . . . . . . . . : QSQPROC
To procedure . . . . . . . : CLEANUP
Statement . . . . . . . . . : 45045
Message . . . . : Specific name QGLDRSDX in QDIRSRV already exists.

Resolution in this case was to drop the existing QGLDRSDX function:
Identify whether you are using SYSTEM or SQL naming.

Issue the STRSQL command, press F13, Option 1, then check Naming convention. It will be either *SYS or *SQL:

o If *SYS , press F12 to get back to the SQL statement entry screen and run the following command:
DROP SPECIFIC FUNCTION QDIRSRV/QGLDRSDX

o If *SQL, run the following command:
DROP SPECIFIC FUNCTION QDIRSRV.QGLDRSDX

Once you have done this, you should exit SQL mode (F3, Option 1) and try starting the LDAP instance again (i.e. STRTCPSVR *DIRSRV).

Dropping the existing function will either allow the LDAP instance to start or get further in the startup process to the next issue.

The following PTFs permanently resolve the issue by using "CREATE OR REPLACE FUNCTION" instead of "CREATE FUNCTION" on the SQL statement executed by the IBM Tivoli Directory Server at startup.

APAR documenting this issue: SE71452
PTFs were generated for all current OS versions:
IBM i 7.4: 5770SS1-SI70236
IBM i 7.3: 5770SS1-SI70189
IBM i 7.2: 5770SS1-SI70235


Cross reference information
Product Component Platform Version Edition
IBM i 6.1
IBM i 7.1
IBM i 7.3
IBM i 7.2
IBM i 7.4 IBM i

Historical Number

610054932

Document information

More support for: IBM i

Component: Communications-TCP

Software version: 6.1, 6.1.0, 6.1.1, 7.1, 7.1.0, 7.2, 7.2.0, 7.3, 7.4

Operating system(s): IBM i

Reference #: N1011360

Modified date: 24 June 2019