RPLDOC

La commande RPLDOC permet de remplacer le contenu du document et le profil d'échange d'un document (IDP) existant dans la bibliothèque de documents. La nouvelle version du document est alors replacée dans la bibliothèque de documents. Pour que les données puissent être remplacées, le document doit avoir été sorti au préalable.

Restrictions :

• Avant d'utiliser cette commande, le document doit être sorti par l'utilisateur indiqué au paramètre USRID à l'aide de la commande RTVDOC (Extraire un document).
• L'utilisateur doit disposer du droit *CHANGE (modification) au minimum sur le document, bénéficier du droit spécial *ALLOBJ (tous les objets) ou agir pour le compte d'un utilisateur qui possède des droits sur le document.
• La commande GRTUSRPMN (Accorder une procuration à un utilisateur) permet d'accorder une procuration autorisant à travailler pour le compte d'un autre utilisateur.

Paramètres

Document (TODOC)

Indique le nom du document dans lequel sont placées les données ou l'utilisation du paramètre Identificateur du document (DOCID) pour désigner le nom système du document en bibliothèque dans lequel les données sont placées.

nom

Indiquez le nom attribué par un utilisateur au document à remplacer.

*DOCID

Le document à remplacer est identifié par le nom système du document en bibliothèque précisé dans le paramètre DOCID.

Dans le dossier (TOFLR)

Nom du dossier contenant le document à remplacer.

*NONE

Aucun dossier n'est indiqué lorsque le document est identifié dans le paramètre Identificateur du document (DOCID).

nom

Indiquez le nom du dossier contenant le document à remplacer. Ce nom peut se composer d'une série de noms de dossiers si le document à remplacer se trouve dans un dossier contenu dans un autre dossier. Vous pouvez entrer jusqu'à 63 caractères.

Fichier contenant document (DOCFILE)

Noms du fichier base de données et de la bibliothèque contenant les données du document. Il s'agit d'un fichier défini par l'utilisateur ou du fichier de sortie précisé dans les commandes RCVDST (Recevoir une distribution) ou RTVDOC (Extraire un document). Si un fichier de sortie est précisé, seules les données de l'enregistrement des données du document en sont extraites ; le préfixe est supprimé de cet enregistrement.

nom

Indiquez le nom du fichier base de données qui contient les données du document.

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 fichier base de données est recherché dans la bibliothèque en cours du travail. Le système utilise QGPL si aucune bibliothèque n'est définie pour le travail.

nom

Entrez le nom de la bibliothèque contenant le fichier base de données.

Membre contenant document (DOCMBR)

Membre du fichier base de données utilisé.

*FIRST

Le système utilise le premier membre créé dans le fichier base de données.

nom

Indiquez le nom du membre du fichier base de données à utiliser.

Partie de document (DOCPART)

Indique la partie de document à remplacer.

Remarque :Si vous indiquez *BOTH et que le remplacement d'un des éléments échoue, aucun des deux n'est remplacé, et le document demeure sorti.

*DOC

Remplace uniquement le contenu du document. Si aucun enregistrement du contenu du fichier n'existe dans le fichier indiqué, le document est remplacé, mais un message prévient l'utilisateur qu'aucun contenu du document n'a été remplacé.

*IDP

Remplace uniquement le profil d'échange du document (IDP). Lorsque cette valeur est indiquée, les enregistrements du profil d'échange de document (code d'enregistrement 500) doivent exister dans le fichier indiqué, sinon, la commande échoue.

*BOTH

Remplace le contenu du document et le profil d'échange du document (IDP). Lorsque cette valeur est indiquée, les enregistrements du profil d'échange de document (code d'enregistrement 500) doivent exister dans le fichier indiqué, sinon, la commande échoue.

Identificateur utilisateur (USRID)

ID utilisateur et adresse à associer à la demande.

Valeurs uniques

*CURRENT

Vous exécutez la demande pour votre compte.

Elément 1 : ID utilisateur

caractère

Indiquez l'ID d'un autre utilisateur ou le vôtre. Vous devez disposer d'une procuration de cet utilisateur ou du droit spécial *ALLOBJ (tous les objets).

Elément 2 : Adresse

caractère

Indiquez l'adresse d'un autre utilisateur ou la vôtre. Si vous indiquez l'ID d'un autre utilisateur, vous devez avoir une procuration de cet utilisateur ou un droit *ALLOBJ.

Identificateur du document (DOCID)

Indique le nom attribué au document par la bibliothèque. Il s'agit en fait du nom que le système a attribué au document lors de la création de ce dernier. Les documents classés hors du système local ont exclusivement ce type de nom. Les noms de documents attribués par la bibliothèque peuvent être déterminés à l'aide de la commande QRYDOCLIB (Interroger une bibliothèque de documents) ou à l'aide du message renvoyé par la commande FILDOC (Classer un document).

Les noms de documents attribués par la bibliothèque ont une longueur de 24 caractères, et doivent se conformer au format suivant :

AAAAMMJJHHMNSSCSNSNSNSNS

dans lequel :

       AAAA = année
         MM = mois
         JJ = jour
         HH = heures
         MN = minutes
         SS = secondes
         CS = centièmes de seconde
   NSNSNSNS = nom système

*NONE

Aucun nom système de document en bibliothèque n'est obligatoire lorsque le document est identifié dans le paramètre Document (DOC).

nom

Indiquez le nom système du document en bibliothèque à envoyer.

Type de document (DOCTYPE)

Type de document à utiliser. Cet identificateur permet au système de déterminer s'il lui est possible ou non de traiter le flot de données correctement.

*DFT

Le système crée l'identificateur de type de document approprié d'après l'origine des données.

*FFT

Le document est un texte en forme finale. Ce type de document sera affiché et imprimé, mais non révisé, par le destinataire.

*RFT

Le document est un texte révisable. Ce type de document peut être visualisé, imprimé et révisé par le destinataire.

2-65 535

Indiquez une valeur identifiant le type du document. Les valeurs comprises entre 2 et 32767 sont contrôlées par enregistrement dans l'Architecture d'échange de documents (DIA) d'IBM et sont réservées aux types de documents définis par IBM. Les valeurs comprises entre 32768 et 65535 ne sont pas enregistrées par IBM et peuvent être utilisées pour des types de documents non définis par IBM.

ID caractères du document (DOCCHRID)

Identificateur de caractères (jeu de caractères graphiques et page de codes) correspondant aux données de document à utiliser. Cet identificateur est fonction de l'écran ayant servi à la création de ces données de document.

Valeurs uniques

*SYSVAL

Le système détermine les valeurs de jeu de caractères graphiques et de page de codes pour les paramètres de commande à partir de la valeur système QCHRID.

*DEVD

Le système détermine le jeu de caractères graphiques et la page de codes applicables à partir de la description d'unité écran sur laquelle la commande a été entrée. Cette option ne peut être utilisée que pour un travail interactif. Si elle est indiquée pour un travail par lots, une erreur se produit.

Elément 1 : Jeu de caractères graphiques

1 à 32767

Indiquez le jeu de caractères graphiques à utiliser.

Elément 2 : Page de codes

1 à 32767

Indiquez la page de codes à utiliser.

ID caractères pour commande (CMDCHRID)

Identificateur de caractères (jeu de caractères graphiques et page de codes) correspondant aux données saisies comme valeurs des paramètres de la commande. Cet identificateur dépend de l'écran utilisé pour l'entrée de la commande.

La valeur indiquée dans le paramètre Identificateur utilisateur (USRID) est convertie en jeu de caractères et page de codes '930 500'.

Valeurs uniques

*SYSVAL

Le système détermine les valeurs de jeu de caractères graphiques et de page de codes pour les paramètres de commande à partir de la valeur système QCHRID.

*DEVD

Le système détermine le jeu de caractères graphiques et la page de codes applicables à partir de la description d'unité écran sur laquelle la commande a été entrée. Cette option ne peut être utilisée que pour un travail interactif. Si elle est indiquée pour un travail par lots, une erreur se produit.

Elément 1 : Jeu de caractères graphiques

1 à 32767

Indiquez le jeu de caractères graphiques à utiliser.

Elément 2 : Page de codes

1 à 32767

Indiquez la page de codes à utiliser.

Exemples

RPLDOC   TODOC(*DOCID)  DOCFILE(*LIBL/MYFILE)  DOCPART(*BOTH)
         DOCID('1987060710102053SYSTEM1')  DOCTYPE(*FFT)

Cette commande remplace les données et le profil d'échange du document par des données du fichier MYFILE. Les données sont placées dans le document dont l'identificateur est '1987060710102053SYSTEM1'. Le type de document devient texte en forme finale.

Messages d'erreur

Messages *ESCAPE

CPF900B

ID util et adresse &1 &2 introuvables dans répertoire système.

CPF900C

L'ouverture de session et la vérification d'inscription de l'util ont échoué.

CPF905C

Erreur lors de la recherche d'une table de conversion.

CPF906A

Document non remplacé dans la bibliothèque.

CPF9096

Impossible utiliser CMDCHRID(*DEVD) ou DOCCHRID(*DEVD) en traitement par lots.

CPF9847

Erreur lors de la fermeture du fichier &1 de bibliothèque &2.