SAVS36LIBM

La commande SAVS36LIBM (Sauvegarder des membres de bibliothèque 36), crée une copie des membres d'un fichier source dans un fichier disquette ou bande qui peut être restauré sur un IBM 36, ou dans un fichier physique base de données de ce système qui peut être envoyé sur un IBM 36. Le fichier membre sauvegardé est formaté comme un fichier LIBRFILE créé, en mode enregistrement, sur un IBM 36 à l'aide de la procédure OCL FROMLIBR (ou l'emploi équivalent de l'utilitaire $MAINT SSP). Sur IBM 36, le fichier disquette, bande ou disque peut être restauré par la procédure OLC TOLIBR (ou l'emploi équivalent de l'utilitaire $MAINT SSP).

Si un fichier physique base de données inexistant est indiqué à la zone Fichier physique (paramètre PHYFILE), le système le crée.

Cette commande permet uniquement l'échange de données de procédure et source avec un IBM 36. Elle assure une interface de commande simplifiée pour un utilisateur i5/OS qui a effectué une migration à partir d'un IBM 36 mais qui ne dispose pas des moyens appropriés pour la sauvegarde de fichiers source i5/OS. Utilisez les commandes CL (SAVOBJ ou SAVCHGOBJ) pour créer une copie de sauvegarde d'un fichier source i5/OS ou des membres de fichier source individuels.

Restrictions :

1. Les droits suivants sont requis lors de l'exécution de cette commande sur un système utilisant la sécurité de ressources :
   • Droit *USE sur cette commande.
   • Droit *USE sur la bibliothèque indiquée au paramètre FROMLIB.
   • Droit *USE sur le fichier QS36SRC de la bibliothèque indiquée, dans le cas de la sauvegarde des membres de bibliothèque source.
   • Droit *USE sur le fichier QS36PRC de la bibliothèque indiquée, dans le cas de la sauvegarde des membres de bibliothèque de procédure.
   • Droit *USE sur la bibliothèque indiquée au paramètre PHYFILE, en cas de sauvegarde dans un fichier physique.
   • Droit *CHANGE sur la bibliothèque indiquée au paramètre PHYFILE, en cas de sauvegarde dans un fichier physique inexistant.
   • Droits *CHANGE et *OBJMGMT sur ce fichier, en cas de sauvegarde dans un fichier physique comportant MBROPT(*ADD).
   • Droit *ALL sur le fichier, en cas de sauvegarde dans un fichier physique avec le paramètre MBROPT(*REPLACE).
   • Droit *USE sur l'objet de description d'unité de disquette et sur le fichier unité QSYSDKT de la bibliothèque QSYS, en cas de sauvegarde sur disquette.
   • Droit *USE sur l'objet de description d'unité de bande et sur le fichier unité QSYSTAP de la bibliothèque QSYS, en cas de sauvegarde sur bande.
2. Toutes les disquettes utilisées pour la sauvegarde des membres doivent être initialisées à l'aide de la commande CL INZDKT ou de la fonction équivalente de l'environnement 36 (procédure LCO INIT ou utilitaire PPS $INIT). Pour une disquette double face, utilisez une taille de secteur de 256 ou de 1024. Pour une disquette simple face, utilisez une taille de secteur de 128 ou de 512. Dans le cas d'une bande, chaque volume de bande doit être initialisé avec des labels standard à l'aide de la commande CL INZTAP ou de la fonction équivalente de l'environnement 36 (procédure LCO TAPEINIT ou utilitaire PPS $TINIT). Utilisez une densité de 1600 bits/pouce lors de l'initialisation de la bande.

   Remarque :Si la bande ou la disquette n'a pas été initialisée comme indiqué précédemment, l'IBM 36 n'est pas en mesure de traiter le support.

   En cas d'utilisation d'une bande ou d'une disquette qui n'a pas été initialisée correctement, un message est envoyé à l'opérateur système pour qu'il annule la sauvegarde ou initialise le volume afin de poursuivre l'opération.

3. A l'exception des opérations de lecture, aucune fonction de niveau objet ne doit être utilisée pour les fichiers QS36SRC et QS36PRC lors de la sauvegarde de membres à l'aide de SAVS36LIBM. Si les fichiers nécessaires ne peuvent pas être alloués, aucun membre n'est sauvegardé.

   A l'exception des opérations de lecture, aucune fonction de niveau enregistrement ne doit être utilisée pour les membres en cours de sauvegarde. Une activité simultanée au niveau d'un membre (par exemple, l'ajout ou la suppression d'enregistrements) peut provoquer l'omission de celui-ci lors de la sauvegarde.

4. En cas de sauvegarde d'un fichier sur disquette, les disquettes utilisées ne peuvent pas contenir de fichier actif dont le nom est identique à la valeur indiquée au paramètre TOLABEL, car le système AS/400 ne permet pas la présence de labels de fichier de disquette en double.
5. Seuls les membres des fichiers source QS36SRC (pour les membres *SRC) et QS36PRC (pour les membres *PRC) de la bibliothèque indiquée peuvent être sauvegardés à l'aide de la commande SAVS36LIBM. Seules les données de membre sont sauvegardées à partir du membre de fichier source (c'est-à-dire, le numéro de séquence source et les zones de modification de date ne sont pas sauvegardés).
6. Le nom de membre ou le nom de membre générique (paramètre FROMMBR) indiqué doit respecter les conventions d'appellation i5/OS. Lors de la sauvegarde d'un membre portant un nom étendu, les guillemets ne sont pas restaurés dans le cadre du nom de membre du fichier de sortie. Par exemple, le membre "A+B" est sauvegardé en A+B.

Paramètres

Membre d'origine (FROMMBR)

Nom des membres à sauvegarder.

Ce paramètre est obligatoire.

*ALL

Tous les membres du type indiqué à la zone Membres source 36 (paramètre SRCMBRS) sont sauvegardés.

nom-membre

Indiquez le nom des membres à sauvegarder.

nom-membre-générique*

Indiquez le nom générique (chaîne d'un ou plusieurs caractères suivie d'un astérisque (*)) des membres à sauvegarder.

Bibliothèque d'origine (FROMLIB)

Bibliothèque contenant les membres à sauvegarder.

Ce paramètre est obligatoire.

Unité (DEV)

Nom des unités (maximum quatre) utilisées pour la sauvegarde.

Ce paramètre est obligatoire.

*PHYFILE

Le fichier de sortie 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 utilisées pour la sauvegarde. Si vous vous servez de plus d'une unité de bande, 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 source (membres source et procédure sur IBM 36) à sauvegarder.

*ALL

Les membres source et procédure 36 (à partir de QS36SRC et QS36PRC) dont le nom correspond au nom indiqué à la zone Membre d'origine (paramètre FROMMBR) sont sauvegardés.

*SRC

Seuls les membres source 36 (à partir du fichier QS36SRC) dont le nom correspond au nom indiqué à la zone Membre d'origine (paramètre FROMMBR) sont sauvegardés.

*PRC

Seuls les membres procédure OCL 36 (à partir du fichier QS36PRC) dont le nom correspond à celui qui est indiqué à la zone Membre d'origine (paramètre FROMMBR) sont sauvegardés.

Label du fichier (TOLABEL)

Valeur du label (maximum huit caractères) du fichier disquette ou bande de sortie. Vous devez entrer une valeur dans cette zone si *PHYFILE n'est pas indiqué à la zone Unité (paramètre DEV).

Numéro de séquence (SEQNBR)

Numéro de séquence du fichier, indiqué dans les seuls cas de sauvegarde sur bande.

*END

Les membres indiqués sont sauvegardés à partir du dernier numéro de séquence de la première bande (ce fichier se trouve à la suite des autres fichiers présents sur la bande). Si la première bande est saturée, un message d'erreur est envoyé et l'opération est interrompue. Si le numéro de séquence à attribuer au fichier spécifié est supérieur à 9999, un message d'erreur est généré et l'opération s'arrête.

numéro-séquence-fichier

Indiquez le numéro de séquence du fichier bande utilisé pour la sauvegarde des membres précisés. Les valeurs admises sont comprises entre 1 et 9999.

Si ce numéro de séquence existe déjà sur le volume de bande, le label de bande associé à ce numéro de séquence doit correspondre à la valeur indiquée au paramètre TOLABEL. Le fichier de données existant à ce numéro de séquence est écrasé et tous les fichiers suivants sur le volume ne sont plus accessibles après l'opération de sauvegarde.

Si un nouveau fichier est ajouté sur la bande, le numéro de séquence associé à celui-ci doit être supérieur d'une unité à celui du dernier fichier bande de ce volume. Aucun écart n'est admis entre les numéros de séquence d'une unité.

Identificateur de volume (VOL)

Indique les identificateurs des volumes bande sur lesquels les données objets doivent être sauvegardées. Les volumes doivent être placés sur l'unité selon l'ordre dans lequel les identificateurs de volume sont indiqués pour ce paramètre.

*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 sauvegarde des membres.

Période de rétention (RETAIN)

Période de validité du fichier bande ou disquette nouvellement créé. Le fichier reste protégé contre l'écriture jusqu'au jour suivant la fin de cette période.

1

La période de validité est d'un jour.

période-validité

Indiquez le nombre de jours pendant lesquels le fichier disquette ou bande doit être gardé. Si vous indiquez 999, le fichier devient permanent.

Type échange fichier disquette (EXCHTYPE)

Type d'échange pour le fichier disquette nouvellement créé.

*E

La valeur par défaut, E, crée un fichier disquette d'échange-E, c'est-à-dire, un fichier sauvegarde de système, pouvant être restauré sur un IBM 36 par la procédure TOLIBR. Il peut aussi être restauré sur AS/400 à l'aide de la commande RSTS36LIBM (Restaurer des membres de bibliothèque 36).

*BASIC

Le fichier disquette de sortie a un format d'échange standard. Il peut donc être restauré ou copié sur IBM 34 ou IBM 32, ou sur tout autre système prenant en charge des disquettes de format d'échange standard.

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 sauvegarde 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 où sont copiées les données du membre du fichier source.

S'il n'existe aucun fichier de ce nom, le système le crée dans la bibliothèque en cours - si aucune autre n'a été indiquée - en tant que fichier physique décrit par le programme (non entré au clavier); sa longueur d'enregistrement aura la valeur indiquée à la zone Longueur enreg logique (paramètre RCDLEN). S'il existe déjà un fichier de ce nom, le système l'utilise, à condition qu'il s'agisse d'un fichier physique non entré au clavier dont la longueur d'enregistrement est comprise entre 40 et 120. Les enregistrements copiés sont placés dans le premier membre du fichier physique.

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

*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 nouveaux enregistrements remplacent ou sont ajoutés aux enregistrements existants.

*REPLACE

Le membre est effacé avant que le premier enregistrement n'y soit copié.

*ADD

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

Longueur d'enregistrement (RCDLEN)

Longueur d'enregistrement du fichier, en octets, utilisée lors de la copie des membres.

120

Longueur d'enregistrement maximale acceptée pour les membres bibliothèque source et procédure 36.

longueur-enregistrement

Indiquez une longueur d'enregistrement en octets.

Exemples

Exemple 1 : sauvegarde d'un membre de procédure unique

SAVS36LIBM   FROMMBR(XYZ1)  FROMLIB(JOHNSON)
             DEV(I1)  SRCMBRS(*PRC)  TOLABEL(XYZ1)

Cette commande sauvegarde le membre de procédure OCL unique XYZ1 (dans le fichier source QS36PRC) dans la bibliothèque JOHNSON. En supposant que I1 est une unité de disquette, le membre est sauvegardé sur le fichier disquette XYZ1. La longueur du fichier est de 120 et la période de détention d'une journée.

Exemple 2 : sauvegarde de tous les membres source et de procédure

SAVS36LIBM   FROMMBR(X*)  FROMLIB(ORDER)  DEV(*PHYFILE)
             PHYFILE(NETLIB/S36SRC) MBROPT(*ADD)

Cette commande sauvegarde tous les membres source et de procédure (membres de QS36SRC et QS36PRC) dont les noms commencent par la lettre 'X' dans la bibliothèque ORDER. Les membres sont sauvegardés dans le fichier physique base de données S36SRC dans la bibliothèque NETLIB. Les enregistrements copiés sont ajoutés après tous les enregistrements déjà présents dans le fichier.

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.

CPF2C43

&2 membres biblio &1 sauvegardés; &3 membres non sauvegardés.

CPF2C44

Aucun membre de la bibliothèque &1 n'a été sauvegardé.

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.

CPF2C5F

Numéro de séquence de fichier bande supérieur à 9 999 non admis.

CPF2C50

Description du fichier &1 non disponible.

CPF2C51

Information sur membre du fichier &1 de la bibliothèque &2 non disponible.

CPF2C52

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

CPF2C55

La valeur TOLABEL &1 contient des espaces intercalaires.

CPF2C58

Format de disquette inacceptable pour échange standard avec l'IBM 36.

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.

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

CPI2C13

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