RSTS36F

La commande RSTS36F restaure sur le système un fichier unique ou un groupe de fichiers provenant d'un fichier issu d'une sauvegarde générale. Un fichier unique peut être restauré d'un fichier physique base de données, ou d'un fichier disquette ou bande. Un groupe de fichiers peut être restauré à partir d'un fichier issu d'une sauvegarde générale sur disquette ou sur bande.

Cette commande lit la description du fichier dans le fichier physique base de données, disquette ou bande, crée un fichier base de données (physique ou logique) et y copie toutes les données du premier fichier. Le fichier physique base de données doit avoir été créé par la commande SAVS36F (Sauvegarder un fichier 36). Le fichier disquette ou bande peut avoir été créé sur IBM 36 par la procédure OCL SAVE (ou l'emploi équivalent de l'utilitaire $COPY SSP) ou par la commande SAVS36F (Sauvegarder un fichier 36). La commande RSTS36F (Restaurer un fichier 36) accepte des fichiers disquette ou bande créés sur IBM 34 ou IBM 32 avec l'utilitaire $COPY.

La commande RSTS36F accepte un fichier disquette créé sous forme de fichier comprimé.

Si le fichier en cours de restauration ne figure pas dans la bibliothèque indiquée au paramètre TOLIB, il est créé. Un membre de fichier physique est ajouté et porte un nom au format 'Maammjj', qui identifie la date de création initiale du fichier. Cette convention d'appellation est requise par l'environnement 36 pour la prise en charge des fichiers distingués par date.

Si un nom de fichier est indiqué au paramètre TOFILE, le nom doit respecter les conventions d'appellation de l'i5/OS. Pour plus de détails sur ces dernières, reportez-vous au chapitre 2 "Control Language Syntax", du manuel Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Si TOFILE(*SET) est indiqué, il se peut que les fichiers restaurés portent des noms contenant des caractères non admis dans un nom d'objet simple i5/OS. Dans ce cas, le nom du fichier est remplacé par un nom étendu i5/OS. Le fichier est ensuite restauré.

Si le nom contient un blanc, une apostrophe, des guillemets, un astérisque, un point d'interrogation ou un caractère de contrôle d'unité (hexadécimal 00 à 3F, ou FF), les caractères non admis sont remplacés par des caractères de soulignement. Le fichier est ensuite restauré et porte le nom étendu ou simple résultant (par exemple, A_? est remplacé par "A_"). Si un fichier portant ce nouveau nom existe déjà, il est traité comme n'importe quel autre nom (reportez-vous au paramètre MBROPT).

Si un nom de fichier est modifié car il comporte des caractères non admis, un message d'information (CPF 2C1F) est émis au niveau de récursivité supérieur au programme qui exécute cette commande. Si un nom simple est remplacé par un nom étendu, aucun message n'est émis.

Si le fichier est créé par la fonction de restauration et qu'il n'a pas été protégé précédemment, le nouveau fichier est détenu par l'utilisateur qui a émis la commande RSTS36F ; le fichier est créé avec les droits par défaut *ALL (comme si AUT(*ALL) était indiqué).

Si le fichier a été sauvegardé à partir de l'IBM 36 et que ses attributs ont été affectés d'une valeur d'extension zéro ou d'aucune valeur, il reçoit une valeur par défaut de 32 767 divisée par la longueur d'enregistrement. Si une valeur d'extension de zéro est obligatoire, utilisez la commande CHGPF (Modifier un fichier physique), une fois la restauration terminée, afin d'attribuer la valeur zéro à SIZE(*EXTEND). Si le fichier a été sauvegardé à l'aide de l'i5/OS, il est restauré et la valeur d'extension n'est pas modifiée.

Remarque :L'objet de cette fonction se limite au seul échange de fichiers avec un IBM 36.

Restrictions :

1. Cette commande est fournie avec le droit public *EXCLUDE.
2. Les droits suivants sont requis lors de l'exécution de cette commande sur un système utilisant la sécurité de ressources :
   • Les droits *USE, *SECADM et *ALLOBJ sur cette commande
   • Le droit *USE sur la bibliothèque indiquée au paramètre TOLIB
   • Le droit *CHANGE sur la bibliothèque indiquée au paramètre TOLIB en cas de restauration d'un fichier qui n'existe pas déjà sur le système
   • Les droits *CHANGE et *OBJMGMT sur le fichier existant (requis pour l'ajout d'un nouveau membre) en cas de restauration d'un fichier physique à date différenciée et d'un fichier portant le même nom mais créé à une date différente
   • Le droit *ALL sur le fichier en cas de restauration dans un fichier physique existant ayant la même date de création avec indication de la valeur MBROPT(*REPLACE)
   • Le droit *CHANGE sur le fichier physique sous-jacent (appelé fichier parent dans l'IBM 36) si le fichier sauvegardé est un fichier index secondaire IBM 36 (c'est-à-dire un fichier logique)
   • Le droit *USE sur l'objet description d'unité de disquette et sur le fichier d'unité QSYSDKT, dans la bibliothèque QSYS, en cas de restauration à partir d'une disquette
   • Le droit *USE sur l'objet description d'unité de bande et sur le fichier d'unité QSYSTAP, dans la bibliothèque QSYS, en cas de restauration à partir d'une bande
   • Le droit *USE sur le fichier et sur la bibliothèque qui le contient (paramètre PHYFILE) en cas de restauration à partir d'un fichier physique base de données
   • Si le fichier n'existe pas sur le système mais qu'un objet dépositaire de droits sur un fichier portant le même nom existe, le droit *ALL sur cet objet ou la propriété de cet objet est requis
3. La fonction de remplacement n'est pas prise en charge en cas de restauration d'un fichier index secondaire IBM 36 (fichier logique). Dans ce cas, aucun objet fichier portant le même nom ne peut exister dans la bibliothèque indiquée.
4. En cas de restauration d'un fichier logique, le fichier physique sous-jacent doit déjà exister dans la bibliothèque indiquée au paramètre TOLIB.
5. Les fichiers i5/OS identiques aux fichiers IBM 36 à date différenciée sont des fichiers physiques à plusieurs membres. Les fichiers index secondaires à date différenciée ne sont pas pris en charge. Les données d'un fichier physique sont stockées dans un membre nommé au format "Maammjj", "aammjj" désignant la date de création initiale du fichier (année/mois/jour).

   Etant donné que tous les membres d'un fichier physique partagent les mêmes attributs (longueur d'enregistrement, informations clés, etc.), les fichiers à date différenciée portant le même nom et restaurés dans la même bibliothèque doivent avoir les mêmes attributs de fichier. Dans le cas contraire, les fichiers ne sont pas restaurés.

6. N'utilisez pas les fonctions au niveau objet et enregistrement, y compris les opérations de lecture, pour un fichier en cours de restauration à l'aide de la commande RSTS36F. Lorsqu'une autre opération est exécutée simultanément sur le fichier (par exemple, un déplacement, une lecture ou un ajout de membre), l'opération de restauration s'interrompt si elle ne peut pas allouer le fichier.

Paramètres

Fichier de destination (TOFILE)

Nom donné à un fichier unique lors de sa restauration dans le système ou à un groupe de fichiers provenant d'un fichier issu d'une sauvegarde générale déjà restauré. S'il s'agit d'un fichier unique, ce paramètre permet qu'il soit rebaptisé au moment de la restauration.

Ce paramètre est obligatoire.

*SET

Indique qu'un groupe de fichiers provenant d'un fichier disquette ou d'un fichier bande issu d'une sauvegarde générale est restauré sur le système.

nom-fichier

Nom donné à un fichier unique lors de sa restauration dans le système.

Bibliothèque de destination (TOLIB)

Bibliothèque devant contenir le fichier à restaurer.

Ce paramètre est obligatoire.

Unité (DEV)

Indique le nom d'une unité de disquette, les noms d'une ou de plusieurs unités de bande, ou permet d'indiquer que le fichier à restaurer se trouve dans un fichier physique base de données. Vous pouvez spécifier jusqu'à quatre noms d'unité de bande. Si vous vous servez de plus d'une unité de bande (quatre au maximum), entrez leur nom par ordre d'utilisation. Chaque nom d'unité doit correspondre à une description déjà enregistrée dans le système.

*PHYFILE

Le fichier à restaurer se trouve dans un fichier physique base de données dont le nom est indiqué dans la zone Fichier physique (paramètre PHYFILE).

nom-unité

Indiquez le nom de l'unité de disquette ou des unités de bande (quatre au maximum) utilisées pour la restauration. Si vous vous servez de plus d'une unité de bande (quatre au maximum), entrez leur nom par ordre d'utilisation. Vous pouvez spécifier jusqu'à quatre noms d'unité de bande.

Identificateur de jeu (SET)

Nom identifiant les fichiers issus d'une sauvegarde générale sauvegardés sur disquette ou bande par la procédure SAVE, ou sur IBM 36, IBM 34 ou IBM 32 par l'utilitaire $COPY.

#SAVE

Les fichiers sont restaurés d'un fichier issu d'une sauvegarde générale dont l'identificateur est #SAVE.

ID-groupe-fichiers

Identificateur du fichier issu d'une sauvegarde générale. Il peut comporter jusqu'à 8 caractères dont le premier doit être une lettre (A-Z) ou un signe #, $ ou à. Le reste peut être une combinaison quelconque de caractères alphanumériques ou spéciaux, à l'exception de la virgule (,), de l'apostrophe (') et des espaces.

User specified DBCS data (IGCDTA)

Considérations DBCS : non applicable.

Remarque :Si un fichier portant le nom indiqué dans l'invite Fichier de destination (paramètre TOFILE) existe déjà, la capacité de jeu de caractères à deux octets (DBCS) du fichier existant n'est pas modifiée par l'opération de restauration. Remarque :If a file already exists by the name specified on the Fichier de destination prompt (TOFILE parameter), the double-byte character set (DBCS) capability of the existing file is not changed by the restore operation.

*NO

Les fichiers restaurés ne peuvent pas contenir de données DBCS. Si un fichier de même nom que le fichier restauré existe déjà dans la bibliothèque indiquée et accepte les données DBCS, un message d'information est envoyé et l'opération de restauration se poursuit. Le fichier obtenu accepte les données DBCS (les attributs IGC du fichier ne sont pas modifiés par l'opération de restauration). The files being restored may not contain DBCS data. If a file already exists in the specified library with the same name as the file being restored, and the file allows DBCS data, an informational message is sent, and the restore operation continues. The resulting file allows DBCS data (the file's IGC attributes are not changed by the restore operation).

*YES

Les fichiers restaurés peuvent contenir des données DBCS. Si un fichier de même nom que le fichier restauré existe déjà dans la bibliothèque indiquée et n'accepte pas les données DBCS, un message d'information est envoyé et l'opération de restauration se poursuit. Le fichier obtenu n'acceptera pas les données DBCS (les attributs IGC du fichier ne sont pas modifiés par l'opération de restauration). The files being restored may contain DBCS data. If a file already exists in the specified library with the same name as the file being restored, and the file does not allow DBCS data, an informational message is sent, and the restore operation continues. The resulting file will not allow DBCS data (the file's IGC attributes are not changed by the restore operation).

Label du fichier (FROMLABEL)

Lors de la restauration d'un fichier unique, on peut utiliser ce paramètre pour indiquer le label du fichier disquette ou bande qui contient le fichier à restaurer. Si aucune valeur n'est inscrite, le système utilise le nom indiqué à la zone Fichier de destination (paramètre TOFILE).

Si la restauration vise un groupe de fichiers provenant d'un fichier issu d'une sauvegarde générale, on peut utiliser ce paramètre pour indiquer le label du fichier disquette ou bande à partir duquel la restauration doit commencer. Si aucune valeur n'est inscrite, la restauration débute à partir du premier fichier.

Le label peut comporter huit caractères au maximum.

Date de création (CRTDATE)

Date de création du fichier disquette ou bande utilisé pour la restauration. La date indiquée prend le format julien (saajjj) pour utilisation sur bande ou le format international (aammjj), pour utilisation sur disquette.

Numéro de séquence (SEQNBR)

Indique le numéro de séquence utilisé pour la restauration lorsqu'une bande est utilisée.

*SEARCH

Un fichier de données avec un identificateur correspondant à la valeur du paramètre FROMLABEL est recherché sur le volume de l'unité. Lorsque cet identificateur est trouvé, l'objet est restauré. Si la dernière opération sur l'unité indiquait *LEAVE à l'invite Option fin de bande (paramètre ENDOPT) pour préciser que la bande est positionnée à l'endroit exact de la fin de la dernière opération, la recherche de fichier commence par le premier fichier de données rencontré après la position en cours de la bande. Si *LEAVE n'a pas été utilisé à l'invite Option fin de bande (paramètre ENDOPT) de la dernière opération ou si la bande a été rembobinée manuellement depuis l'opération, la recherche débute à partir du premier fichier de données du volume.

1 à 16777215

Indiquez le numéro de séquence du fichier à utiliser pour l'opération de restauration.

Identificateur de volume (VOL)

Identificateurs de volume des bandes ou des disquettes utilisées pour restaurer le fichier.

*MOUNTED

Le volume présent sur l'unité est utilisé.

identificateur-volume

Indiquez les identificateurs de volume (maximum 50) des bandes ou des disquettes utilisées pour la restauration du fichier.

Option fin de bande (ENDOPT)

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

*REWIND

La bande est rembobinée, mais pas déchargée.

*LEAVE

La bande n'est pas rembobinée.

*UNLOAD

La bande est automatiquement rembobinée et déchargée à la fin de l'opération.

Fichier physique (PHYFILE)

Nom du fichier physique base de données utilisé comme fichier d'entrée pour la restauration. Si le fichier indiqué n'existe pas ou n'est pas un fichier physique, ou s'il ne contient aucun membre, un message est transmis. Si le fichier comprend plusieurs membres, c'est le premier qui est utilisé.

Les valeurs possibles pour la bibliothèque sont les suivantes :

*LIBL

Le fichier est recherché dans la liste des bibliothèques.

*CURLIB

Le fichier est recherché dans la bibliothèque en cours du travail. Si aucune bibliothèque n'est indiquée, QGPL est prise par défaut.

nom-bibliothèque

Indiquez la bibliothèque contenant le fichier.

Option membre base de données (MBROPT)

Indique si les données d'un membre de fichier physique sont remplacées.

*NOREPLACE

Les données d'un membre de fichier physique du même nom ne sont pas remplacées; l'utilisateur reçoit un message d'erreur.

*REPLACE

Les données d'un membre de fichier physique du même nom sont remplacées.

Fichier différencié par date (DATDIFF)

Indique si la fonction de restauration accepte des fichiers ayant le même nom mais des dates de création différentes.

*NO

Les fichiers de même nom mais différenciés par la date de création ne sont pas acceptés.

Si vous indiquez *NO et qu'un fichier du même nom existe dans la bibliothèque indiquée, voici ce qui se produit :

• Si le paramètre MBROPT indique de remplacer (*REPLACE) le membre, les données du membre sont remplacées par celles du fichier sauvegardé.
• Si le paramètre MBROPT indique de ne pas remplacer (*NOREPLACE) le membre, un message est transmis et le fichier n'est pas restauré.
• Si aucun fichier de la bibliothèque indiquée ne porte le nom inscrit au paramètre TOFILE, le fichier est restauré normalement.

*YES

Les fichiers ayant le même nom mais des dates de création différentes sont acceptés.

Si vous indiquez *YES et qu'un fichier du même nom existe dans la bibliothèque indiquée, voici ce qui se produit :

• Si aucun membre du nom de "Maammjj" (aammjj=date de création du fichier sauvegardé) n'existe, un nouveau membre est ajouté au fichier et les données du fichier sauvegardé y sont copiées.
• Si aucun membre du nom de "Maammjj" (aammjj= date de création du fichier sauvegardé) n'existe et que le paramètre MBROPT indique de remplacer (*REPLACE) le membre, les données du membre sont remplacées par celles du fichier sauvegardé.
• Si un membre du nom de "Maammjj" (aammjj=date de création du fichier sauvegardé) existe et que le paramètre MBROPT indique de ne pas remplacer (*NOREPLACE) le membre, un message est transmis et le fichier n'est pas restauré.

Si aucun membre du même nom n'existe dans la bibliothèque indiquée, le système crée un nouveau fichier, y ajoute un membre et copie les données du fichier sauvegardé dans ce membre.

Exemples

Exemple 1 : restauration à partir de la disquette

RSTS36F   TOFILE(ACCTRCV)  TOLIB(QS36F)  DEV(I1)
          CRTDATE('01/22/85')  VOL(SAVE1)

Cette commande restaure le fichier ACCTRCV dans la bibliothèque QS36F. En supposant que le nom d'un objet de description d'unité de disquette est I1, le fichier est restauré à partir de la disquette insérée dans l'unité. La disquette doit porter le nom de volume SAVE1. Le fichier disquette utilisé pour la restauration doit indiquer un label de fichier de ACCTRCV et une date de création au 22 janvier 1985 (en supposant que le format de date du travail est *MDY et que le séparateur de date est '/').

Exemple 2 : restauration à partir d'une bande

RSTS36F   TOFILE(PAY.VIEW)  TOLIB(PAYLIB)  DEV(T1)  FROMLABEL('P*V')
          ENDOPT(*LEAVE)

Le fichier P*V est restauré à partir de l'unité T1 en tant que fichier nommé PAY.VIEW de la bibliothèque PAYLIB. En supposant que T1 est une unité de bande, le fichier est copié à partir d'une ou de plusieurs bandes stockées sur l'unité T1. Aucun contrôle n'est effectué sur le nom de volume de bande. Une fois l'opération de restauration terminée, la bande reste positionnée à la fin du fichier bande P*V.

Exemple 3 : restauration à partir d'un fichier physique

RSTS36F   TOFILE(ACCTPAY)  TOLIB(QS36F)  DEV(*PHYFILE)
          PHYFILE(NETLIB/SENDFILE)

Cette commande restaure le fichier ACCTPAY de la bibliothèque QS36F à partir du fichier physique SENDFILE de la bibliothèque NETLIB.

Exemple 4 : spécification de numéros de séquence

RSTS36F   TOFILE(*SET)  TOLIB(QS36F)  DEV(T1 T2)
          SET(PAYFILES)  FROMLABEL(FILE10)
          MBROPT(*REPLACE)  DATDIFF(*YES)
          SEQNBR(*SEARCH)  VOL(*MOUNTED)  ENDOPT(*REWIND)

Cette commande restaure à partir de la bande un sous-ensemble de fichiers du fichier de sauvegarde générale nommé PAYFILES dans la bibliothèque QS36F. L'opération de restauration commence avec un fichier bande ayant comme label le fichier 10. Si l'un des fichiers à restaurer existe déjà dans la bibliothèque QS36F avec une date de création identique à celle du fichier sauvegardé, le fichier est remplacé. Si un fichier existe déjà dans la bibliothèque QS36F avec une date de création différente, un nouveau numéro de date de création différente est ajouté au fichier. L'opération de restauration utilise les volumes de bande des unités de bande T1 et T2. Une fois l'opération de restauration terminée, le dernier volume de bande est rembobiné au début de la bande.

Messages d'erreur

Messages *ESCAPE

CPF2C4A

L'unité &1 ne permet pas l'exécution de cette commande.

CPF2C4B

L'unité &1 figure deux fois dans la liste des noms d'unités.

CPF2C4C

L'unité de disquettes &1 figure dans une définition d'unités multiples.

CPF2C4D

Les fichiers n'ont pas tous été restaurés.

CPF2C4E

La restauration a pris fin avant que tous les fichiers soient restaurés.

CPF2C45

Impossible de traiter fichier d'entrée &1 par RSTS36F.

CPF2C47

Fichier &1 ou membre &3 de &2 non remplacé car existe déjà.

CPF2C48

Fichier d'entrée &1 de &2 incompatible avec cette commande.

CPF2C49

Fichier de sortie &1 de &2 incorrect pour cette commande.

CPF2C5A

Fichier de clés secondaires &1 de bibliothèque &2 non remplacé.

CPF2C5E

Fichier d'entrée &1 de &2 incompatible avec cette commande.

CPF2C50

Description du fichier &1 non disponible.

CPF2C52

Erreur lors de la création du fichier &1 de bibliothèque &2.

CPF2C53

Membre &3 non ajouté au fichier &1 de bibliothèque &2 à cause d'une erreur.

CPF9810

Bibliothèque &1 non trouvée.

CPF9812

Fichier &1 non trouvé dans la bibliothèque &2.

CPF9814

Unité &1 non trouvée.

CPF9820

Non autorisé à utiliser la bibliothèque &1.

CPF9822

Non autorisé au fichier &1 de &2.

CPF9825

Accès non autorisé à l'unité &1.

CPF9826

Allocation du fichier &2 impossible.

CPF9830

Allocation de la bibliothèque &1 impossible.

CPF9831

Allocation de l'unité &1 impossible.

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9847

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

CPF9848

Ouverture du membre &3 du fichier &1 de &2 impossible.

CPF9849

Erreur lors du traitement du membre &3 de &1 dans &2.

Messages *STATUS

CPI2C11

Copie d'enreg en cours dans fichier &1 de &2, membre &3.