Export LDIF File (QgldExportLdif)

The Export LDIF File (QgldExportLdif) API exports the directory server contents to a Lightweight Directory Access Protocol Data Interchange Format (LDIF) file.

Authorities and Locks

Directory Authority

The caller must provide the administrator DN and password if the caller does not have *ALLOBJ and *IOSYSCFG special authorities and the caller is not a Directory Services administrator. The caller is a Directory Services administrator if the Directory Services server has been configured to grant administrator access to authorized users and the caller is authorized to the 'Directory Services Administrator' function of the operating system.

Object Authorities

The caller must have Execute (*X) authority to each directory in the path name preceding the name of the LDIF file. The caller must have Write (*W) authority to the LDIF file.

Required Parameter Group

Input data

INPUT; CHAR(*)

Input data required to identify the LDIF file and the administrator name and password. 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 data. The possible format name follows:

LDIF0100	Export LDIF file.
LDIF0200	Export LDIF file with options.

See Format of Input Data for a description of this format.

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 section. For details about the fields in each format, see Field Descriptions.

LDIF0100 Format

LDIF0200 Format

Offset		Type	Field
Dec	Hex
0	0	BINARY(4)	Offset to LDIF file
4	4	BINARY(4)	Length of LDIF file
8	8	BINARY(4)	Offset to administrator 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 subtree DN
28	1C	BINARY(4)	Length of subtree DN
32	20	BINARY(4)	Additional fields indicator
Additional fields if indicator is equal to 1 or greater:
36	24	BINARY(4)	Include cn=localhost
40	28	BINARY(4)	Include cn=pwdpolicy
44	2C	BINARY(4)	Include nested replication contexts
Additional fields if indicator is equal to 2 or greater:
48	30	BINARY(4)	Include operational attributes
Variable length string fields:
		CHAR(*)	LDIF file
		CHAR(*)	Administrator DN
		CHAR(*)	Administrator password
		CHAR(*)	Subtree DN

Field Descriptions

Additional fields indicator. Additional fields supplied for a format. See the format descriptions for possible uses and values of this field.

Administrator DN. The distinguished name of the server administrator. This field is specified in UCS-2 (CCSID 13488).

Administrator password. The password for the server administrator. This field is specified in UCS-2 (CCSID 13488).

Include cn=localhost. Indicates whether data located under the distinguished name cn=localhost should be included in the exported data. If format LDIF0100 is used, cn=localhost is not included in the exported data. The following values may be specified:

The value 1 can only be specified when no subtree DN is specified.

Include cn=pwdpolicy. Indicates whether data located under the distinguished name cn=pwdpolicy should be included in the exported data. If format LDIF0100 is used, cn=pwdpolicy is not included in the exported data. The following values may be specified:

The value 1 can only be specified when no subtree DN is specified.

Include nested replication contexts. Indicates whether nested replication contexts should be included in the exported data. For example, if a directory contains the replication contexts o=acme and cn=external users,o=acme, this option can be used to export data under the distinguished name o=acme while excluding all entries under the distinguished name cn=external users,o=acme. If format LDIF0100 is used, nested replication contexts are included in the exported data. The following values may be specified:

The value 0 can only be specified if a subtree DN is specified.

Include operational attributes. Indicates whether the following four operational attributes will be exported: creatorsName, createTimestamp, modifiersName, and modifyTimestamp. If no value is specified, these operational attributes will be included in the exported data. The following values may be specified:

LDIF file. The integrated file system path name of the LDIF file to be used. This field is specified in UCS-2 (CCSID 13488).

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

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

Length of LDIF file. The length, in Unicode characters, of the LDIF file field.

Length of subtree DN. The length, in Unicode characters, of the subtree DN field.

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 LDIF file. The offset, in bytes, from the start of the input data to the LDIF file field.

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

Subtree DN. The distinguished name (DN) of the root of a directory subtree to export to the LDIF file. This object, and all descendant objects will be exported. To export the entire directory tree, specify 0 (zero) for the offset to subtree DN and length of subtree DN fields. This field is specified in UCS-2 (CCSID 13488).

Error Messages