RSTS36LIBM

La commande RSTS36LIBM (Restaurer des membres de bibliothèque 36) lit un fichier contenant des membres bibliothèque, crée des membres source base de données ou des membres de fichier dans ce système, et copie les données dans chaque membre restauré.

Le fichier d'entrée peut être un fichier disquette, un fichier bande ou un fichier physique base de données de ce système.

Le fichier peut avoir été créé sur IBM 36, IBM 34 ou IBM 32, soit par les procédures OCL FROMLIBR ou SAVELIBR (ou l'utilisation équivalente de $MAINT), soit par la commande SAVS36LIBM (Sauvegarder des membres de bibliothèque 36).

Des fichiers disquette créés sur IMB 34 à l'aide de la procédure BACKUP ou de l'utilitaire $BACK ne sont pas acceptés par cette commande. Des fichiers disquette SAVELIBR comprimés (utilisés par IBM pour distribuer des bibliothèques système pour IBM 36 après la version 5.0) ne sont pas acceptés par cette commande.

Dans l'IBM 36, le fichier d'entrée peut être un fichier disquette SAVELIBR ou un fichier bande, un fichier disquette LIBRFILE mode enregistrement, fichier bande ou physique, ou un fichier disquette LIBRFILE mode secteur, fichier bande ou physique. En d'autre termes, le fichier d'entrée peut être tout fichier disquette, bande ou physique créé à l'aide de l'utilitaire SSP $MAINT de l'IBM 36.

Si la bibliothèque indiquée à la zone Bibliothèque de destination (paramètre TOLIB) n'existe pas, le système la crée. Les fichiers source QS36SRC et QS36PRC sont également créés s'il n'existent pas dans la bibliothèque de destination. Si l'opération de restauration crée la bibliothèque, celle-ci est détenue par l'utilisateur qui exécute la commande RSTS36LIBM et elle est créée avec des droits par défaut *ALL (c'est-à-dire, comme si AUT(*ALL)était indiqué).

Si un fichier FROMLIBR en mode secteur ou un fichier SAVELIBR créé sur un IBM 36 est en cours de restauration, il se peut que les fichiers de données QS36LOD et QS36SBR soient également créés pour contenir des membres objet et sous-programme restaurés. Ces derniers ne sont pas convertis sur le système en cours.

Restrictions :

• Les droits suivants sont requis lors de l'exécution de cette commande sur un système utilisant la sécurité de ressources :
  1. Droits *SECADM et *ALLOBJ.
  2. Droit *USE sur cette commande et sur CRTLIB (si la bibliothèque doit être créée).
  3. Droit *USE sur la commande CRTSRCPF (si QS36SRC ou QS36PRC doit être créé).
  4. Droit *USE sur la commande CRTPF (si QS36LOD ou QS36SBR doit être créé).
  5. Droit *CHANGE sur la bibliothèque indiquée au paramètre TOLIB.
  6. Droits *CHANGE et *OBJMGMT sur le fichier QS36SRC de la bibliothèque indiquée, en cas de restauration de membres de bibliothèque source.
  7. Droits *CHANGE et *OBJMGMT sur le fichier QS36PRC de la bibliothèque indiquée, en cas de restauration de membres de bibliothèque de procédure.
  8. Droits *CHANGE et *OBJMGMT sur le fichier QS36LOD de la bibliothèque indiquée, en cas de restauration de membres de bibliothèque objet.
  9. Droits *CHANGE et *OBJMGMT sur le fichier QS36SBR de la bibliothèque indiquée, en cas de restauration de membres de bibliothèque sous-programme.
  10. Droit *USE sur l'objet de description d'unité de disquette, droit *USE sur le fichier unité QSYSDKT de la bibliothèque QSYS, en cas de restauration à partir d'une disquette.
  11. Droit *USE sur l'objet de description d'unité de bande et droit *USE sur le fichier unité QSYSTAP de la bibliothèque QSYS, en cas de restauration à partir d'une bande.
  12. 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
• Aucune opération au niveau des objets ou des enregistrements ne doit être en cours sur les fichiers QS36SRC, QS36PRC, QS36SBR et QS36LOD lors d'une restauration de membres à l'aide de RSTS36LIBM. Si les fichiers nécessaires ne peuvent pas être alloués de manière exclusive, aucun membre n'est restauré.
• Le nom de membre ou le nom de membre générique indiqué (paramètre TOMBR) doit respecter les conventions d'appellation de l'i5/OS.

  Si un nom de membre générique ou *ALL est indiqué, il se peut qu'un membre dont le nom comporte des caractères non admis dans un nom d'objet simple i5/OS soit sélectionné pour restauration. Dans ce cas, le nom de membre est restauré à l'aide de la syntaxe de nom étendu i5/OS (par exemple, A§B est remplacé par ''A§B'').

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'), ces derniers sont remplacés par des caractères de soulignement, puis le membre est restauré et porte le nom simple ou étendu résultant (par exemple, A*/? est remplacé par A_/_ et A? par A_).

Un message d'information est émis chaque fois que des caractères incorrects sont remplacés afin de former un nom admis. Un autre message d'information est émis si le nouveau nom occasionne le remplacement d'un membre. Aucun message n'est émis lorsqu'un nom étendu est attribué à un membre au cours de sa restauration si aucun remplacement de caractère incorrect n'est effectué.

Paramètres

Membre de destination (TOMBR)

Nom des membres à restaurer.

Ce paramètre est obligatoire.

*ALL

Tous les membres correspondant aux types indiqués sont restaurés.

nom-membre

Les membres portant le nom indiqué sont restaurés.

nom-membre-générique*

Tous les membres dont le nom comporte le générique indiqué sont restaurés.

Bibliothèque de destination (TOLIB)

Bibliothèque devant contenir les membres à restaurer du fichier d'entrée.

Ce paramètre est obligatoire.

Unité (DEV)

Nom des unités (maximum quatre) à utiliser pour la restauration.

Ce paramètre est obligatoire.

*PHYFILE

Le fichier d'entrée est le fichier physique base de données indiqué à la zone Fichier physique (paramètre PHYFILE).

nom-unité

Indiquez le nom de l'unité de disquette ou des unités de bande à utiliser 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.

Membres source 36 (SRCMBRS)

Types de membres (membres source et procédure sur IBM 36) à restaurer.

*ALL

Restaurez tous les membres source et procédure du fichier d'entrée dont le nom correspond à celui qui est indiqué à la zone Membre de destination (paramètre TOMBR).

*SRC

Restaurez seulement les membres source 36 (dans le fichier QS36SRC) dont le nom correspond à celui qui est indiqué à la zone Membre de destination (paramètre TOMBR).

*PRC

Restaurez seulement les membres procédure OCL IBM 36 (dans le fichier QS36PRC) dont le nom correspond à celui qui est indiqué à la zone Membre de destination (paramètre TOMBR).

*NONE

Ne restaurez aucun membre bibliothèque procédure ou source 36.

Option membre base de données (MBROPT)

Pour les fichiers base de données existant sur le système, indique les membres de fichiers qui sont restaurés.

*NEW

Seuls les nouveaux membres (ceux qui n'existent pas encore dans le fichier visé) sont restaurés.

*OLD

Seuls les anciens membres (ceux qui existent déjà dans le fichier visé) sont restaurés. Le membre existant est remplacé par la copie du membre restauré à partir du fichier.

*ALL

Tous les membres sont restaurés. Les membres qui n'existent pas encore sont créés, ceux qui existent déjà sont remplacés.

User specified DBCS data (IGCDTA)

Indique si les membres source et procédure à restaurer peuvent contenir des données codées sur deux octets (DBCS). Cet attribut est utilisé s'il faut créer les fichiers source QS36SRC et QS36PRC pour y restaurer les membres bibliothèque.

Remarque :Si le fichier source QS36SRC ou QS36PRC existe déjà dans la bibliothèque indiquée à la zone Bibliothèque de destination (paramètre TOLIB) et que l'attribut DBCS du fichier ne correspond pas à ce paramètre, un message d'erreur est envoyé et aucun membre n'est restauré.

*NO

Les membres source ou procédure à restaurer ne peuvent pas contenir de données codées sur deux octets.

*YES

Les membres source ou procédure à restaurer peuvent contenir des données codées sur deux octets.

Label du fichier (FROMLABEL)

Valeur du label (maximum huit caractères) du fichier disquette ou bande contenant les membres à restaurer. Entrez une valeur dans cette zone si *PHYFILE n'est pas indiqué à la zone Unité (paramètre DEV).

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, aucun membre bibliothèque n'est restauré. 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.

Membres objet 36 (OBJMBRS)

Types de membres (objet et sous-programme 36) à restaurer. Etant donné que les objets IBM 36 et i5/OS ne sont pas compatibles, les membres éventuellement restaurés ne sont pas utilisables immédiatement après la restauration. Des commandes fournies par IBM ou des opérations écrites par l'utilisateur sont alors nécessaires pour convertir les objets membres en objets i5/OS utilisables.

*NONE

Aucun membre bibliothèque objet ou sous-programme 36 n'est restauré.

*SBR

Seuls les membres sous-programme 36 (dans le fichier QS36SBR) dont le nom correspond à celui qui est indiqué à la zone Membre de destination (paramètre TOMBR) sont restaurés.

*LOD

Seuls les membres objet 36 (dans le fichier QS36LOD) dont le nom correspond à celui qui est indiqué à la zone Membre de destination (paramètre TOMBR) sont restaurés.

*ALL

Tous les membres objet et sous-programme du fichier d'entrée dont le nom correspond à celui qui est indiqué à la zone Membre de destination (paramètre TOMBR) sont restaurés.

Exemples

Exemple 1 : restauration de tous les membres

RSTS36LIBM   TOMBR(XYZ1)  TOLIB(JOHNSON)  DEV(I1)
             SRCMBRS(*PRC)  MBROPT(*ALL)  FROMLABEL('XYZ1')

Cette commande restaure le membre de procédure OCL unique XYZ1 comme un membre de fichier source QS36PRC dans la bibliothèque JOHNSON. En supposant que I1 se réfère à une unité de disquette, le fichier disquette en entrée doit porter le label XYZ1.

Exemple 2 : restauration de membres à partir d'un fichier

RSTS36LIBM   TOMBR(X*)  TOLIB(ORDER)  DEV(*PHYFILE)
             PHYFILE(NETLIB/S36SRC)

Cette commande restaure tous les membres de source et de procédure dont les noms commencent par la lettre 'X' et qui n'existent pas déjà en tant que membres de QS36SRC et QS36PRC dans la bibliothèque ORDER. Les membres sont restaurés à partir du fichier S36SRC dans la bibliothèque NETLIB.

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.

CPF2C41

&2 membres restaurés, &3 membres non restaurés, &4 membres exclus.

CPF2C42

Aucun membre n'a été restauré dans biblio. &1; &4 membres exclus.

CPF2C46

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

CPF2C48

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

CPF2C49

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

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.

CPF2C57

L'attribut DBCS ne correspond pas à celui du fichier existant &1 dans &2. DBCS attribute not same as existing file &1 in &2.

CPF2C70

Enregistrement de contrôle incorrect dans fichier d'entrée &1.

CPF2C71

Le mot clé NAME de l'ordre COPY a été omis ou est incorrect.

CPF2C72

Le mot clé LIBRARY de l'ordre COPY a été omis ou est incorrect.

CPF9807

Une ou plusieurs bibliothèques de la liste ont été supprimées.

CPF9808

Allocation impossible pour une ou plusieurs bibliothèques de la liste.

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.

CPF9824

Accès non autorisé à la commande &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.

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9847

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

CPF9849

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

Messages *STATUS

CPI2C12

Copie en cours du fichier &1 de &2, label &3, dans fichier de travail.