RCLDLO

La commande RCLDLO (Récupérer des documents ou dossiers) permet de récupérer :

• un document
• un dossier
• un dossier et tous les documents et dossiers qu'il contient, directement ou indirectement
• des documents ou dossiers système internes
• des documents ou dossiers système internes, des documents de distribution non classés et tous les dossiers et documents sur le système. Les descripteurs de documents connexes sont synchronisés.
• des documents ou dossiers système internes et tous les dossiers et documents classés dans un pool de mémoire secondaire. Les descripteurs de documents connexes sont synchronisés.

Cette commande vous permet de récupérer tous les documents ou dossiers en les synchronisant avec l'index des descripteurs de recherche et sur l'index de recherche de texte. La synchronisation avec l'index de recherche de texte se termine après le traitement de toutes les demandes de mise à jour de ce dernier, qui sont générées à l'aide de la commande RCLDLO.

Restrictions :

• Pour récupérer les objets internes ou tous les objets de la bibliothèque de documents, vous devez disposer du droit spécial *ALLOBJ (tous les objets) ou *SECADM (administrateur de la sécurité). De plus, aucun document ou dossier ne doit être en cours d'utilisation.
• Vous devez bénéficier de l'usage exclusif du document ou du dossier à récupérer, mais il n'est pas nécessaire que vous déteniez un droit sur celui-ci ni que vous soyez inscrit dans le répertoire de distribution du système.
• Lors de l'utilisation de cette commande, un message d'erreur indiquant que des objets internes sont verrouillés peut apparaître. Des fonctions de la bibliothèque de documents peuvent être simultanément employées par un autre utilisateur et, par conséquent, la commande RCLDLO ne peut pas s'exécuter. Relancez-la lorsque les autres tâches sur la bibliothèque de documents auront pris fin.

Paramètres

Document ou dossier (DLO)

Nom de l'objet à récupérer.

Ce paramètre est obligatoire.

*FLR

Le dossier et tous les dossiers et documents qu'il contient directement ou indirectement doivent être récupérés.

*SYSOBJNAM

Le dossier ou le document que vous réclamez est identifié par un nom d'objet système. Ce paramètre doit être utilisé lorsque le document récupéré n'est pas dans un dossier comprenant des documents internes et des distributions.

*INT

Les documents ou dossiers internes doivent être récupérés.

Remarque :Les documents ou dossiers internes sont utilisés pour la gestion des documents et dossiers du système. RCLDLO DLO(*INT) n'est requis que si les objets internes sont endommagés. Dans ce cas, toute tentative d'accès aux documents et dossiers génère le message CPF8A46 (Des objets internes du système sont endommagés), éventuellement suivi du message CPF9032 (Session d'échange de documents non lancée).

*DOCDTL

Les documents ou dossiers internes et les descripteurs de documents doivent être récupérés. DLO(*DOCDTL) synchronise les relations entre l'ensemble des documents ou dossiers et leurs descripteurs et corrige les incohérences éventuelles entre ces objets.

Remarque :L'exécution de la commande RCLDLO DLO(*DOCDTL) peut être très longue, puisqu'elle exécute un sous-ensemble de fonctions de la commande RCLDLO DLO(*ALL) afin de garantir une cohérence entre les objets système internes, les descripteurs de document et les documents ou dossiers.

*ALL

Les objets système internes de la bibliothèque de documents, ainsi que tous les documents et dossiers (tels qu'indiqués avec le paramètre ASP) doivent être récupérés. DLO(*ALL) permet de synchroniser les relations entre tous les objets de la bibliothèque de documents et leurs détails ; vous pouvez l'utiliser pour résoudre les incohérences éventuelles.

Remarque :L'exécution de la commande RCLDLO DLO(*ALL) peut durer un certain temps, en fonction du nombre de documents et dossiers sur le système. Si vous envisagez d'émettre cette commande, vous êtes invité à éviter d'utiliser le système jusqu'à ce que le temps nécessaire soit planifié.

nom

Indiquez le nom du document ou du dossier à récupérer.

Dans le dossier (FLR)

Dossier contenant le dossier ou le document à récupérer, ou dossier à récupérer avec tous les documents et dossiers qu'il contient directement ou indirectement. Le nom d'un dossier est obligatoire si un nom de dossier ou de document ou *FLR est indiqué dans le paramètre Document ou dossier (DLO).

*NONE

Le dossier ou le document à récupérer n'est pas dans un dossier.

nom

Indiquez le nom du dossier contenant le document ou le dossier à récupérer, ou celui du dossier à récupérer avec tous les dossiers et documents qu'il contient directement ou indirectement.

Nom d'objet système (SYSOBJNAM)

Nom d'objet système de l'objet à récupérer. Le nom d'objet système est obligatoire lorsque la valeur *SYSOBJNAM est indiquée dans le paramètre Document ou dossier (DLO).

Attributs objet système (SYSOBJATR)

Attributs de l'objet à récupérer. Vous pouvez indiquer une valeur autre que *NONE pour ce paramètre uniquement si *SYSOBJNAM est indiqué dans le paramètre Document ou dossier (DLO).

*NONE

Aucun attribut n'est indiqué pour l'objet.

*INTDOC

L'objet à récupérer est un document interne.

*DST

L'objet à récupérer est une distribution.

ID pool mémoire secondaire (ASP)

Indique l'ID pool de mémoire secondaire de l'objet de la bibliothèque de documents à récupérer. Une valeur autre que *ANY peut être indiquée à ce paramètre uniquement si *ALL ou *DOCDTL est précisé au paramètre DLO.

*ANY

Les objets à récupérer se trouvent dans un pool de mémoire secondaire. Lorsque *ALL est indiqué au paramètre DLO, tous les objets de la bibliothèque de documents sur le système sont récupérés.

1-32

Seuls les objets de la bibliothèque de documents se trouvant dans le pool de mémoire secondaire indiqué doivent être récupérés. Tous les objets de la bibliothèque de documents se trouvant dans d'autres pools sont ignorés. La valeur indiquée doit désigner un ASP contenant des objets de bibliothèque de documents. L'ASP 1 correspond à l'ASP système.

Remarque :Les documents de distribution non classés sont répertoriés comme des objets de la bibliothèque de documents dans l'ASP système.

Fichier recevant la sortie (OUTFILE)

Indique le nom du fichier base de données vers lequel est dirigée la sortie spéciale. Si le fichier de sortie n'existe pas, cette commande crée un fichier base de données dans la bibliothèque indiquée. Si le fichier est créé à l'aide de cette fonction, le texte descriptif est le suivant : "SORTIE créée par RCLDLO" ; la valeur pour les utilisateurs sans droit spécifique sur le fichier est *EXCLUDE. Une valeur autre que *NONE peut être indiquée à ce paramètre uniquement si *ALL ou *DOCDTL est indiqué au paramètre DLO.

La sortie dirigée vers ce fichier comprend les noms de tout document physiquement endommagé - et par conséquent inutilisable -, des documents ou des dossiers qui ne se trouvaient pas dans le système et pour lesquels les descripteurs de documents ont été retirés. Ce fichier est destiné à fournir à l'utilisateur un enregistrement des éléments perdus - tels qu'un ASP utilisateur - lors du rétablissement d'une panne matériel.

Qualificateur 1 : Fichier recevant la sortie

*NONE

Aucune sortie n'est dirigée vers un fichier base de données.

nom

Indiquez le nom qualifié du fichier base de données devant recevoir la sortie. Ce fichier pourra être réutilisé lorsque d'autres commandes RCLDLO seront lancées. La sortie est ajoutée au fichier comme cela est indiqué au paramètre OUTMBR. Le fichier base de données, fourni par IBM, QSYS/QARCLDLO ne peut être indiqué.

Qualificateur 2 : Biblio

*LIBL

La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.

*CURLIB

Le système effectue la recherche dans la bibliothèque en cours. Si celle-ci n'est pas précisée, la bibliothèque QGPL est utilisée par défaut.

nom

Indiquez le nom de la bibliothèque dans laquelle la recherche doit être effectuée.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre de fichier base de données dans lequel est envoyée la sortie de la commande.

Elément 1 : Membre recevant la sortie

*FIRST

Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système en crée un du nom indiqué à l'invite Fichier recevant la sortie (paramètre OUTFILE). Si le membre existe, vous avez la possibilité d'ajouter de nouveaux enregistrements à la fin du membre existant ou de le mettre à blanc et de lui ajouter les nouveaux enregistrements.

nom

Indiquez le nom du membre de fichier destiné à recevoir la sortie. Si aucun membre de ce nom n'existe, le système le crée.

Elément 2 : Remplacement ou ajout enregs

*REPLACE

Le système met à blanc le membre existant et ajoute les nouveaux enregistrements.

*ADD

Le système ajoute les nouveaux enregistrements à la suite des enregistrements existants.

Exemples

Exemple 1 : récupération d'un dossier

RCLDLO   DLO(FLR1)

Cette commande permet de récupérer le dossier FLR1.

Exemple 2 : récupération d'un document dans un dossier

RCLDLO   DLO(A)  FLR(FLR2)

Cette commande permet de récupérer le dossier ou document A dans le dossier FLR2.

Exemple 3 : récupération d'un dossier et de tous les documents et dossiers qu'il contient

RCLDLO   DLO(*FLR)  FLR(FLR3)

Cette commande permet de récupérer le dossier FLR3 et tous les dossiers et documents qu'il contient directement ou indirectement.

Exemple 4 : récupération d'un document interne

RCLDLO   DLO(*SYSOBJNAM)  SYSOBJNAM(AMBT133080)
SYSOBJATR(*INTDOC)

Cette commande permet de récupérer le document interne spécifié par le nom d'objet système AMBT133080.

Exemple 5 : récupération d'un document de distribution

RCLDLO   DLO(*SYSOBJNAM)  SYSOBJNAM(AMBT133082)
SYSOBJATR(*DST)

Cette commande permet de récupérer le document de distribution spécifié par le nom d'objet système AMBT133082.

Exemple 6 : récupération de documents ou dossiers systèmes internes

RCLDLO   DLO(*INT)

Cette commande permet de récupérer des documents ou dossiers systèmes internes.

Exemple 7 : récupération de documents ou dossiers systèmes internes et de descripteurs de documents

RCLDLO   DLO(*DOCDTL)

Cette commande permet de récupérer les documents ou dossiers systèmes internes et les descripteurs de documents de tous les dossiers et documents.

Exemple 8 : récupération de documents ou dossiers systèmes et de tous les documents et dossiers

RCLDLO   DLO(*ALL)

Cette commande permet de récupérer les documents ou dossiers systèmes internes, ainsi que tous les documents et dossiers, et de synchroniser leurs descripteurs de documents.

Exemple 9 : récupération de documents ou dossiers systèmes et de tous les documents et dossiers d'un pool de mémoire secondaire

RCLDLO   DLO(*ALL)  ASP(2)

Cette commande permet de récupérer les documents ou dossiers systèmes internes et tous les documents et dossiers résidant dans l'ASP 2, et de synchroniser leurs descripteurs de document.

Messages d'erreur

Messages *ESCAPE

CPF8A44

Erreur dans les descripteurs du document.

CPF8AA4

&2 non récupéré.

CPF8A29

&2 récupéré partiellement.