RSTS36FLR

La commande RSTS36FLR (Restaurer un dossier 36) lit un fichier disquette, bande ou physique préparé par la procédure IBM 36 SAVEFLDR, puis en convertit les données afin que le système actuel puisse les utiliser. Les données comprimées ou décomprimées sont acceptées lors de la restauration des données à partir d'une disquette.

Deux types de dossiers IBM 36 sont acceptés en tant qu'entrée : les dossiers de documents et les dossiers IDDU.

• Les dossiers de documents IBM 36 sont convertis en dossiers AS/400 ; il en est de même pour les documents, qui sont convertis pour ce système.
• Les dossiers IDDU IBM 36 ne sont pas convertis en dossiers AS/400 ; une bibliothèque est créée et le dictionnaire de données est converti en objet dictionnaire de données (*DTADCT).

Remarques :

1. Lors de la restauration d'un dossier d'un IBM 36, l'utilisateur ayant émis la commande de restauration devient propriétaire du dossier et détenteur des droits qui le régissent.
2. Lors de la restauration à partir d'un IBM 36 d'un dossier contenant un nom non admis par l'AS/400, ce nom est automatiquement modifié en un nom créé par le système.

Restrictions :

1. Cette commande est fournie avec le droit public *EXCLUDE.
2. L'utilisateur doit disposer du droit *USE sur le dossier d'origine et sur le fichier unité ou la description d'unité ainsi que du droit *CHG sur le dossier de destination.
3. Si le dossier source est un dossier de documents, l'utilisateur doit être inscrit dans le répertoire de distribution du système et disposer soit des droits sur les données du dossier, soit du droit spécial *ALLOBJ. Si le document est remplacé, l'utilisateur doit disposer des droits *ALL sur celui-ci.

Paramètres

Dossier d'origine (FROMFLR)

Nom du dossier IBM 36 à restaurer.

Ce paramètre est obligatoire.

Unité (DEV)

Nom de l'unité utilisée par le processus de restauration. Ce nom doit correspondre à une description enregistrée dans le système.

Ce paramètre est obligatoire.

Ce paramètre admet des valeurs multiples.

Les valeurs possibles sont :

*PHYFILE

Le système utilise le fichier physique indiqué à la zone Fichier physique (paramètre PHYFILE).

nom-unité-disquette

Indiquez le nom de l'unité de disquettes utilisée pour la restauration.

nom-unité-bande

Indiquez le nom de l'unité ou des unités utilisées pour la restauration : une ou plusieurs unités de bande ou une seule unité de bande virtuelle. Si vous utilisez plus d'une unité de bande (au maximum quatre), indiquez leur nom par ordre d'utilisation.

Fichier physique (PHYFILE)

Nom (nom de la bibliothèque/nom du fichier) du fichier physique contenant le dossier à restaurer.

Pour la bibliothèque, les valeurs possibles sont :

*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 cherche le fichier physique dans la bibliothèque en cours du travail ou, à défaut, dans QGPL.

nom-bibliothèque

Indiquez le nom de la bibliothèque contenant le fichier physique.

Membre (MBR)

Nom du membre à restaurer.

Les valeurs possibles sont :

*FIRST

Le premier membre du fichier est restauré.

nom-membre

Indiquez le nom du membre à restaurer.

Date de création (CRTDATE)

Dans le cas de disquettes ou de bandes, date de création qui précise davantage le nom du dossier indiqué à la zone Dossier d'origine (paramètre FROMFLR).

Si ce paramètre est indiqué, le système ne tient pas compte de la valeur figurant à la zone Numéro de séquence (paramètre SEQNBR).

Identificateur de volume (VOL)

Identificateurs des volumes des bandes (bobines) ou des disquettes contenant les objets à restaurer. Celles-ci doivent être montées sur l'unité selon l'ordre suivi lors de la sauvegarde des dossiers.

Ce paramètre admet des valeurs multiples.

Les valeurs possibles sont :

*MOUNTED

Le système utilise la bande ou la disquette montée sur l'unité indiquée.

identificateur-volume

Indiquez les identificateurs de volumes, par ordre d'utilisation. Chaque identificateur comporte un maximum de 6 caractères.

Numéro de séquence (SEQNBR)

Dans le cas des bandes seulement, numéro de séquence du fichier à restaurer.

Les valeurs possibles sont :

*SEARCH

Le système parcourt la bande pour trouver le premier numéro de séquence correspondant au dossier indiqué.

numéro-séquence

Indiquez le numéro de séquence du fichier à restaurer. Les valeurs admises sont comprises entre 1 et 9999.

Option fin de bande (ENDOPT)

Dans le cas des bandes seulement, opération exécutée automatiquement une fois la restauration terminée. Ce paramètre ne s'applique qu'à la dernière bobine utilisée.

Les valeurs possibles sont :

*REWIND

Une fois la restauration terminée, la bande se rembobine automatiquement, sans se décharger.

*LEAVE

La bande ne se rembobine pas. Une autre opération de restauration peut commencer à la position en cours.

*UNLOAD

La bande se rembobine et se décharge automatiquement une fois la restauration terminée.

Option document en double (DUPDOC)

Indique si les documents existants sont rebaptisés ou remplacés. Le système ne tient pas compte de ce paramètre lors de la restauration d'un dictionnaire de données.

Les valeurs possibles sont :

*RENAME

Si un dossier existant porte déjà le nom indiqué au paramètre TOFLR et qu'il contienne un document du même nom qu'un nouveau document, le système donne un autre nom à ce dernier. Tous les autres documents sont créés dans le dossier indiqué.

*REPLACE

Si un dossier existant porte déjà le nom indiqué au paramètre TOFLR et qu'il contienne un document du même nom qu'un nouveau document, le document existant est remplacé. Tous les autres documents sont créés dans le dossier indiqué.

Dossier de destination (TOFLR)

Nom du dossier restauré. Ce paramètre ne s'applique qu'aux dossiers de documents. Si vous l'indiquez pour d'autres types de dossiers, le système émet un message d'erreur.

Les valeurs possibles sont :

*FROMFLR

Une fois restauré, le dossier prend son ancien nom, indiqué à la zone Dossier d'origine (paramètre FROMFLR).

nom-dossier

Indiquez le nouveau nom que prendra le dossier restauré.

Vers dictionnaire de données (TODTADCT)

Nom de la bibliothèque dans laquelle un dictionnaire IDDU (dossier) est restauré. Ce paramètre ne s'applique qu'aux dictionnaires IDDU. Si vous l'indiquez pour d'autres types de dossiers, le système émet un message d'erreur.

Les valeurs possibles sont :

*FROMFLR

Une fois le dossier restauré, la bibliothèque prend l'ancien nom de dossier indiqué à la zone Dossier d'origine (paramètre FROMFLR).

nom-bibliothèque

Indiquez le nom de la bibliothèque qui recevra le dictionnaire IDDU restauré.

Type de langue du clavier (KBDTYPE)

Jeu de caractères et page de codes de l'IBM 36 utilisés pour la création des données dans le dossier.

Les valeurs possibles sont :

*SYSVAL

L'IBM 36 utilise le même type de clavier (jeu de caractères et page de codes) que le système AS/400.

*MULTI

L'IBM 36 est configuré comme un système multinational.

type-langue-clavier

Indiquez le type de langue du clavier de l'IBM 36 s'il n'est pas multinational, et s'il est configuré avec un type de langue de clavier différent de celui de l'AS/400.

Vous pouvez, par exemple, indiquer AGB (Autriche/Allemagne), BLB (Belgique) ou CAB (Canada). Pour obtenir la liste complète des types de langue de clavier, amenez le curseur à la zone Type de langue du clavier (paramètre KBDTYPE) et appuyez sur F4.

Exemples

Exemple 1 : restauration à partir d'une disquette

RSTS36FLR   FROMFLR(TXTDRA)  DEV(DKT01)
            CRTDATE('01/16/88')  VOL(SAVE1)

Cette commande permet de restaurer le dossier TXTDRA. DKT01 étant le nom de description d'une unité de disquettes, le dossier est restauré à partir de la disquette insérée dans cette unité. Un des noms de volume de la disquette doit être SAVE1 et le dossier doit avoir été créé le 16 janvier 1988.

Exemple 2 : restauration à partir d'une bande

RSTS36FLR   FROMFLR(TXTMEL)  DEV(TAP1)
            TOFLR(TXTNEW)  SEQNBR(7)  ENDOPT(*UNLOAD)

Cette commande permet de restaurer le dossier TXTMEL vers un dossier appelé TXTNEW. TAP1 étant le nom d'une unité de bandes, la restauration du dossier est effectuée à partir d'une ou plusieurs bandes présentes sur l'unité TAP1. Le numéro de séquence du dossier doit être égal à 7. A la fin du traitement, la bande est déchargée de l'unité.

Exemple 3 : restauration vers un dictionnaire de données

RSTS36FLR   FROMFLR(DONDCT)  DEV(*PHYFILE)  TODTADCT(NEWDCT)
            PHYFILE(MYLIB/MYFILE)  MBR(THISONE)

Cette commande permet de restaurer le dossier DONDCT vers un dictionnaire de données appelé NEWDCT. MYFILE étant un fichier physique présent dans la bibliothèque MYLIB et contenant le membre THISONE, le dossier est restauré à partir de ce dernier.

Messages d'erreur

Messages *ESCAPE

CPF8D09

Le dossier &1 n'a pas été restauré.