Configure Directory Server (QgldCfgDirSvr)

Required Parameter Group: 1 Input data Input Char(*) 2 Length of input data Input Binary(4) 3 Format name Input Char(8) 4 Error code I/O Char(*) Threadsafe: No

The Configure Directory Server (QgldCfgDirSvr) API creates the initial directory server configuration. This includes identifying the library that will contain the underlying database objects, the administrator of the server, and the initial set of suffixes to be present on the server.

Required Parameter Group

Input data

INPUT; CHAR(*)

Data that describes the desired directory server configuration. The content and format of this structure are determined by the format name. See Format of Input Data for a description of these formats.

Length of input data

INPUT; BINARY(4)

The length of the input data structure.

Format name

INPUT; CHAR(8)

The content and format of the input configuration data. The possible format names follow:

CFGD0100

Configure Directory Server.

See Format of Input Data for a description of these formats.

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error Code Parameter.

Format of Input Data

For details about the format of the input data, see the following sections. For details about the fields in each format, see Field Descriptions.

CFGD0100 Format

This format is used to provide initial configuration data about the directory server.

Offset		Type	Field
Dec	Hex
0	0	BINARY(4)	Offset to database path
4	4	BINARY(4)	Length of database path
8	8	BINARY(4)	Offset to administrator distinguished name (DN)
12	C	BINARY(4)	Length of administrator DN
16	10	BINARY(4)	Offset to administrator password
20	14	BINARY(4)	Length of administrator password
24	18	BINARY(4)	Offset to suffixes
28	1C	BINARY(4)	Number of suffixes
32	20	BINARY(4)	Reserved
		CHAR(*)	Database path
		CHAR(*)	Administrator DN
		CHAR(*)	Administrator password
Suffixes:
0	0	BINARY(4)	Displacement to next suffix
4	4	BINARY(4)	Displacement to suffix name
8	8	BINARY(4)	Length of suffix name
		CHAR(*)	Suffix name

Field Descriptions

Administrator DN. The distinguished name of a directory object that has access to all objects in the directory. This field is specified in UCS-2 (CCSID 13488).

Administrator password. The password used when you connect to the directory as the administrator. This field is specified in UCS-2 (CCSID 13488).

Database path. The path to an existing library containing the directory database objects. This is an integrated file system path name, for example, /QSYS.LIB/QDIRSRV.LIB. This field is specified in UCS-2 (CCSID 13488).

Displacement to next suffix. The displacement, in bytes, from the start of the current suffix entry to the next suffix entry.

Displacement to suffix name. The displacement, in bytes, from the start of the current suffix entry to the suffix name field.

Length of administrator DN. The length, in Unicode characters, of the administrator DN

Length of administrator password. The length, in Unicode characters, of the administrator password field.

Length of database path. The length, in Unicode characters, of the database path field.

Length of suffix name. The length, in Unicode characters, of the suffix name field.

Number of suffixes. The number of suffixes present in the suffix list.

Offset to administrator DN. The offset, in bytes, from the start of the input data to the administrator DN field.

Offset to administrator password. The offset, in bytes, from the start of the input data to the administrator password field.

Offset to database path. The offset, in bytes, from the start of the input data to the database path field.

Offset to suffixes. The offset, in bytes, from the start of the input data to the list of suffixes.

Reserved. A reserved field. This field must be set to zero.

Suffixes. The list of suffixes to be present on the server. At least one must be present in the initial configuration.

Suffix name. The distinguished name of the root of a directory tree present on the server. This field is specified in UCS-2 (CCSID 13488).

Error Messages

CPF2209 E

Library &1 not found.

CPFA0DB E

Object name not a QSYS object.

CPFA314 E

Memory allocation error.

GLD0205 E

Administrator DN not valid.

GLD020A E

Suffix not valid.

GLD021C E

*ALLOBJ and *IOSYSCFG special authority required.

GLD0223 E

Database path not valid.

GLD0228 E

Validation list not created.

GLD022A E

Server configuration cannot be modified while the server is active.