CPYFRMLDIF

La commande Copier depuis LDIF (CPYFRMLDIF) permet de copier des entrées d'annuaire depuis un fichier STREAM au format LDIF (LDAP Data Interchange Format) vers l'annuaire d'une instance de Directory Server. Directory Server fournit un serveur LDAP (Lightweight Directory Access Protocol) sur IBM i. La commande ne peut servir qu'à ajouter de nouvelles entrées à l'annuaire ; elle ne peut ni modifier ni supprimer des entrées déjà présentes dans l'annuaire. The Copy From LDIF (CPYFRMLDIF) command is used to copy directory entries from a LDAP Data Interchange Format (LDIF) stream file to the directory for a Directory Server instance. The Directory Server provides a Lightweight Directory Access Protocol (LDAP) server on IBM i. The command can only be used to add new entries to the directory, it cannot change or delete entries already in the directory.

Restriction : Vous devez remplir l'une des conditions suivantes pour utiliser cette commande : Restriction: You must do or satisfy one of the following conditions to use this command:

• Posséder les droits spéciaux sur tous les objets (*ALLOBJ) et de configuration des E/S système (*IOSYSCFG). Have all object (*ALLOBJ) and input/output system configuration (*IOSYSCFG) special authorities.
• Fournir le nom distinctif et le mot de passe de l'administrateur. Supply the administrator distinguished name and password.
• Être administrateur Directory Services. L'appelant est un administrateur Directory Services si le serveur Directory Services a été configuré pour accorder l'accès d'administrateur aux utilisateurs autorisés et que l'appelant est autorisé à la fonction « Directory Services Administrator » du système d'exploitation. Be 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.

Paramètres

Fichier STREAM LDIF (LDIFSTMF)LDIF stream file (LDIFSTMF)

Indique le chemin d'accès, dans le système de fichiers intégré, du fichier STREAM au format LDIF (LDAP Data Interchange Format). Specifies the integrated file system path to the LDAP Data Interchange Format (LDIF) stream file.

Ce paramètre est obligatoire. This is a required parameter.

chemin-d'accès

Indiquez le chemin d'accès du fichier STREAM LDIF qui contient les entrées d'annuaire à copier dans l'annuaire de l'instance de Directory Server. Specify the path name of the LDIF stream file that contains the directory entries to be copied into the directory for the Directory Server instance.

Instance (INSTANCE)

Indique le nom de l'instance de Directory Server dans l'annuaire de laquelle les entrées d'annuaire sont copiées. Specifies the Directory Server instance name whose directory the directory entries are copied to.

QUSRDIR

Le nom de l'instance par défaut du serveur d'annuaire du système. The name of the system default Directory Server instance.

nom

Indiquez le nom d'une instance de serveur d'annuaire. Le nom comporte de un à huit caractères. Specify a Directory Server instance name. The name has a minimum of one character and a maximum of eight characters.

Administrateur (ADMIN)Administrator (ADMIN)

Indique l'administrateur de Directory Server. S'il n'est pas indiqué, l'utilisateur doit posséder les droits spéciaux *ALLOBJ et *IOSYSCFG. Specifies the Directory Server administrator. If not specified, the user must have *ALLOBJ and *IOSYSCFG special authorities.

Élément 1: Distinguished name

valeur-caractère

Indiquez le nom distinctif de l'administrateur de Directory Server, par exemple cn=administrator. Un maximum de 50 caractères est autorisé. Specify the distinguished name for the Directory Server administrator, for example, cn=administrator. A maximum of 50 characters is allowed.

Élément 2: Password

valeur-caractère

Indiquez le mot de passe de l'administrateur de Directory Server. Le mot de passe respecte la casse et doit être placé entre apostrophes. Un maximum de 50 caractères est autorisé. Specify the password for the Directory Server administrator. The password is case sensitive and must be enclosed in apostrophes. A maximum of 50 characters is allowed.

Répliquer les données importées (REPLICATE)Replicate imported data (REPLICATE)

Indique si les entrées d'annuaire copiées doivent être répliquées vers les serveurs Directory Server réplicas. Cette option peut être utilisée, par exemple, lors de l'initialisation d'un serveur maître supplémentaire afin qu'il ne tente pas de répliquer des données vers des serveurs Directory Server qui contiennent déjà ces entrées d'annuaire. Specifies whether copied directory entries should be replicated to replica Directory Servers. This option could be used, for example, when initializing an additional master server so that it does not attempt to replicate data to Directory Servers already containing these directory entries.

*YES

Les entrées d'annuaire copiées sont répliquées. Copied directory entries are replicated.

*NO

Les entrées d'annuaire copiées ne sont pas répliquées. Copied directory entries are not replicated.

Exemples

Exemple 1 : Copie vers l'annuaire QUSRDIR Example 1: Copy to the QUSRDIR Directory

CPYFRMLDIF   LDIFSTMF('/ldap/qusrdir.ldif') INSTANCE(QUSRDIR)

Cette commande copie les entrées d'annuaire du fichier STREAM qusrdir.ldif du répertoire ldap vers l'annuaire Directory Server de l'instance QUSRDIR. L'utilisateur qui exécute la commande de cette manière doit posséder les droits spéciaux sur tous les objets (*ALLOBJ) et de configuration des E/S système (*IOSYSCFG). This command copies the directory entries from the qusrdir.ldif stream file in the ldap directory to the Directory Server directory for the QUSRDIR instance. The user running the command this way must have all object (*ALLOBJ) and input/output system Configuration (*IOSYSCFG) special authorities.

Exemple 2 : Copie vers l'annuaire QUSRDIR avec réplication Example 2: Copy to the QUSRDIR Directory and Replicate

CPYFRMLDIF   LDIFSTMF('/ldap/qusrdir.ldif') INSTANCE(QUSRDIR)
             REPLICATE(*YES) ADMIN('cn=admin' 'secret')

Cette commande copie les entrées d'annuaire du fichier STREAM qusrdir.ldif du répertoire ldap vers l'annuaire Directory Server de l'instance QUSRDIR. Les données copiées sont répliquées vers les serveurs Directory Server réplicas. This command copies the directory entries from the qusrdir.ldif stream file in the ldap directory to the Directory Server directory for the QUSRDIR instance. The copied data will be replicated to the replica Directory Servers.

Exemple 3 : Copie vers l'annuaire DOGGIES Example 3: Copy to the DOGGIES Directory

CPYFRMLDIF   LDIFSTMF('/ldap/doggies.ldif') INSTANCE(DOGGIES)
             ADMIN('cn=fluffy' 'poodle')

Cette commande copie les entrées d'annuaire du fichier STREAM doggies.ldif du répertoire ldap vers l'annuaire Directory Server de l'instance DOGGIES. This command copies the directory entries from the doggies.ldif stream file in the ldap directory to the Directory Server directory for the DOGGIES instance.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

GLD0202

Le nom distinctif (DN) ou le mot de passe de l'administrateur n'est pas correct. Administrator DN or password not correct.

GLD0213

Erreur lors de l'ouverture ou de la création du fichier. Error opening or creating file.

GLD0215

L'instance de serveur d'annuaire &1 est introuvable. Directory server instance &1 not found.

GLD0218

Droits insuffisants, ou nom distinctif et mot de passe incorrects. Not enough authority or incorrect distinguished name and password specified.

GLD0225

&1 éléments ajoutés à l'annuaire, &2 éléments non ajoutés. &1 items added to directory, &2 items not added.

GLD0226

Demande du client rejetée. Le serveur d'annuaire est en lecture seule. Client request rejected. Directory server is read only.