CRTSAVF

La commande CRTSAVF (Créer un fichier sauvegarde) permet de créer un fichier sauvegarde.

Un fichier sauvegarde peut être utilisé avec les commandes de sauvegarde et de restauration pour stocker des données qui seraient sinon écrites sur bande ou sur un support optique. Il peut aussi servir de fichier base de données, pour lire et écrire des enregistrements contenant des informations de sauvegarde/restauration, ou être utilisé pour envoyer des objets à un autre utilisateur du réseau SNADS (Services de distribution SNA).

Restrictions :

• Un fichier sauvegarde en ligne doit être utilisé uniquement pour les données de sauvegarde/restauration. Avant la restauration des objets à partir du fichier sauvegarde, les données doivent être générées par une commande de sauvegarde. Lors de l'écriture d'enregistrements dans un fichier sauvegarde à l'aide d'un programme de langage évolué, les enregistrements doivent contenir des données générées grâce à la sauvegarde d'objets dans le fichier sauvegarde.
• Les enregistrements extraits à partir d'un fichier sauvegarde contiennent des informations de contrôle de séquence qui sont validées par le système lors de l'insertion d'enregistrements dans un fichier sauvegarde. Une tentative d'insertion des enregistrements hors séquence ou modifiés depuis une extraction à partir d'un fichier sauvegarde est rejetée.
• Un fichier sauvegarde peut contenir la sortie d'une seule opération de sauvegarde et d'une seule bibliothèque; tous les objets du fichier sauvegarde doivent avoir été sauvegardés à partir de la même bibliothèque. Si la commande SNDNETF est utilisée pour envoyer un fichier sauvegarde, la taille maximale de ce dernier est d'environ 2 milliards d'octets. Le nombre des objets sauvegardés dans un fichier sauvegarde est identique à celui des objets sauvegardés sur bande ou sur un support optique, aussi longtemps que la taille maximale du fichier n'est pas dépassée. Le nombre exact des objets sauvegardés dans un fichier sauvegarde dépend des types et du contenu des objets.
• Vous devez disposer du droit d'opération (*OBJOPR) sur l'objet pour la commande CRTSAVF afin de créer un objet fichier sauvegarde en double ou de restaurer un objet fichier sauvegarde.
• Vous devez disposer des droits d'ajout (*ADD) et de lecture (*READ) sur la bibliothèque dans laquelle le fichier sauvegarde doit être créé.

Paramètres

Fichier sauvegarde (FILE)

Indique le fichier sauvegarde à créer.

Si le fichier est utilisé dans un programme en langage évolué, son nom doit être conforme aux règles d'appellation de ce langage. Sinon, le fichier devra être rebaptisé dans ce programme.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier sauvegarde

nom

Indiquez le nom du fichier sauvegarde à créer.

Qualificateur 2 : Biblio

*CURLIB

Le fichier sauvegarde est recherché dans la bibliothèque en cours du travail. Si cette dernière n'est pas précisée, QGPL est prise par défaut.

nom

Indiquez la bibliothèque contenant le fichier sauvegarde.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*BLANK

Aucun texte n'est indiqué.

valeur-alphanumérique

Entrez, entre apostrophes, un texte de 50 caractères au maximum.

Nombre maxi enregistrements (MAXRCDS)

Indique le nombre maximal d'enregistrements que le fichier sauvegarde peut contenir. La taille de ce dernier est estimée à environ 8192 + (512 x le nombre d'enregistrements contenus dans le fichier sauvegarde) octets. Un espace d'un mégaoctet peut contenir approximativement 2000 enregistrements de 512 octets. Pour limiter le fichier sauvegarde à environ 20 mégaoctets, indiquez 40000 (20 mégaoctets x 2000 enregistrements/mégaoctet).

Remarque :La quantité maximale de données d'un fichier sauvegarde est environ 2 téraoctets. Un message est émis lorsque le fichier est plein.

*NOMAX

La valeur maximale de 4293525600 enregistrements est utilisée.

1-4293525600

Indiquez le nombre maximal d'enregistrements que peut contenir le fichier sauvegarde.

ID pool mémoire secondaire (ASP)

Indique le pool de mémoire secondaire (ASP) dans lequel le système alloue l'espace mémoire pour le fichier sauvegarde.

*LIBASP

L'espace mémoire du fichier sauvegarde est alloué depuis le même pool de mémoire secondaire que pour la bibliothèque du fichier sauvegarde.

1-32

Indiquez l'identificateur du pool de mémoire secondaire.

Temps d'attente maxi fichier (WAITFILE)

Indique le délai d'attente (en secondes) par le programme pour l'allocation des ressources fichier lors de l'ouverture du fichier, ou pour l'allocation des ressources unité ou session lors de l'exécution d'une opération d'acquisition sur le fichier. Si les ressources fichier ne peuvent pas être allouées dans le délai spécifié, le système envoie un message d'erreur au programme.

*IMMED

Le programme n'attend pas. Une allocation immédiate des ressources est requise.

*CLS

Le délai d'attente par défaut du travail est utilisé pour l'allocation des ressources du fichier.

1 à 32767

Indiquez, en secondes, le délai d'attente possible pour l'allocation des ressources du fichier.

Partage chemin d'ouverture (SHARE)

Indique si le chemin d'ouverture (ODP) est partagé avec d'autres programmes dans la même phase d'activation. Dans l'affirmative, les programmes accédant au fichier partagent des fonctions telles que l'état du fichier et la mémoire tampon.

*NO

Le chemin d'ouverture (ODP) n'est pas partagé avec d'autres programmes au cours de cette phase d'activation. Un nouvel ODP est créé pour le fichier et utilisé chaque fois qu'un programme ouvre ce fichier.

*YES

Le même chemin d'ouverture est partagé par tous les programmes du travail pour lequel *YES a été également indiqué lors de l'ouverture du fichier.

Droits (AUT)

Indique les droits que vous accordez aux utilisateurs qui n'ont pas de droits spécifiques sur l'objet, qui ne figurent pas sur une liste d'autorisation ou dont le profil de groupe ou les profils du groupe supplémentaire ne disposent pas de droits spécifiques sur l'objet.

*EXCLUDE

L'utilisateur n'a pas accès à l'objet.

*ALL

L'utilisateur peut effectuer toutes les opérations, à l'exception de celles réservées au propriétaire ou soumises au droit de gestion de la liste d'autorisation (*AUTLMGT). L'utilisateur a un droit d'existence sur l'objet Il peut également effectuer des fonctions de base sur ce dernier, le modifier, définir son niveau de protection et en transférer la propriété.

*CHANGE

L'utilisateur peut effectuer toutes les opérations sur l'objet, à l'exception de celles réservées au propriétaire ou contrôlées par les droits d'existence de l'objet (*OBJEXIST) et de gestion de l'objet (*OBJMGT). L'utilisateur peut réaliser des fonctions de base sur l'objet et le modifier. Le droit *CHANGE fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que les droits sur toutes les données. Si l'objet est une liste d'autorisation, vous pouvez ajouter, modifier ou supprimer des utilisateurs dans cette liste.

*LIBCRTAUT

Le système détermine les droits sur l'objet à l'aide de la valeur spécifiée à l'invite Droits pour objets créés (paramètre CRTAUT) dans la commande CRTLIB pour la bibliothèque contenant l'objet à créer. Si la valeur précisée au paramètre CRTAUT est modifiée, la nouvelle valeur n'affecte pas les objets existants.

*USE

L'utilisateur peut effectuer des opérations de base sur l'objet, telles que l'exécution d'un programme ou la lecture d'un fichier. Il ne peut pas le modifier. Le droit d'utilisation (*USE) fournit le droit d'opération sur l'objet (*OBJOPR) ainsi que le droit d'exécution (*EXECUTE).

nom

Indiquez le nom d'une liste d'autorisation. Les droits sur l'objet définis dans cette liste sont accordés aux utilisateurs figurant sur celle-ci. La liste d'autorisation doit exister à la création de l'objet.

Exemples

CRTSAVF   FILE(ONLINE)  TEXT('Fichier sauvegarde en ligne')

Cette commande permet de créer un fichier sauvegarde en ligne appelé ONLINE dans la bibliothèque en cours. Le fichier sauvegarde se trouve dans l'ASP système sans aucun nombre maximal d'enregistrements. Le public n'a pas accès à ce fichier ; seul le propriétaire de l'objet et les utilisateurs dont le profile de groupe correspond au profil utilisateur du propriétaire de l'objet peuvent utiliser ce fichier sauvegarde.

Messages d'erreur

*ESCAPE Messages

CPF7302

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