CHGSAVF

Modifier un fichier sauvegarde

En bref

La commande CHGSAVF (Modifier un fichier sauvegarde) permet de modifier les attributs du fichier sauvegarde indiqué.

CHGSAVF se lit CHG (Modifier) + SAVF. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGSAVF FILE(…)

Paramètres

FILE Fichier sauvegarde obligatoire
MAXRCDS Nombre maxi enregistrements
TEXT Texte 'descriptif'
WAITFILE Temps d'attente maxi fichier
SHARE Partage chemin d'ouverture

Astuce : dans une session 5250, tapez CHGSAVF puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande CHGSAVF (Modifier un fichier sauvegarde) permet de modifier les attributs du fichier sauvegarde indiqué. Les modifications sont désormais une partie permanente du fichier et sont conservées jusqu'à la modification ou la suppression du fichier.

Restrictions :

Vous devez disposer de droits d'exécution (*OBJOPR) et de gestion (*OBJMGT) d'objets sur le fichier sauvegarde.
Vous devez disposer de droits d'accès en lecture (*READ) sur la bibliothèque contenant le fichier sauvegarde.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FILE	Fichier sauvegarde	Nom d'objet qualifié	Obligatoire, clé, positionnel 1
	Qualificatif 1: Fichier sauvegarde	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
MAXRCDS	Nombre maxi enregistrements	1-4293525600, SAME, NOMAX	Facultatif
TEXT	Texte 'descriptif'	Valeur caractère, SAME, BLANK	Facultatif
WAITFILE	Temps d'attente maxi fichier	Entier, SAME, IMMED, *CLS	Facultatif
SHARE	Partage chemin d'ouverture	SAME, NO, *YES	Facultatif

Fichier sauvegarde (FILE)

Indique le fichier sauvegarde dont les attributs doivent être modifiés.

Ce paramètre est obligatoire.

Qualificatif 1 : Fichier sauvegarde

nom: Indiquez le nom du fichier sauvegarde.

Qualificatif 2: Biblio

*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: Bibliothèque de l'unité d'exécution en cours utilisée pour localiser le fichier sauvegarde. S'il n'existe aucune entrée de bibliothèque en cours dans la liste des bibliothèques, la bibliothèque QGPL est utilisée.
nom: Indiquez le nom de la bibliothèque dans laquelle le fichier sauvegarde est situé.

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).

Si le nombre d'enregistrements en cours dans le fichier sauvegarde dépasse le maximum, un message d'erreur est envoyé et le fichier sauvegarde n'est pas modifié.

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.

*SAME: Le nombre maximal d'enregistrements défini dans le fichier sauvegarde n'est pas modifié.
*NOMAX: La valeur maximale de 4293525600 enregistrements est utilisée.
1-4293525600: Indiquez le nombre maximal d'enregistrements que le fichier sauvegarde peut contenir.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*SAME: Le texte, s'il existe, ne change pas.
*BLANK: Aucun texte n'est indiqué.
valeur-alphanumérique: Tapez un texte d'au plus 50 caractères, entre apostrophes.

Temps d'attente maxi fichier (WAITFILE)

Indique le nombre de secondes pendant lesquelles le programme attend l'allocation des ressources système lors de l'ouverture du fichier. Si les ressources ne peuvent être allouées dans le temps imparti, un message d'erreur est envoyé au programme.

*SAME: Le délai d'attente n'est pas modifié.

*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.

*SAME: La valeur spécifiée dans le fichier sauvegarde ne change pas.

*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.

Exemples

Exemple 1 : Ressources de fichier allouées immédiatement

CHGSAVF   FILE(ONLINE)  WAITFILE(*IMMED)

Cette commande permet de modifier le fichier sauvegarde ONLINE de sorte que, lorsqu'il est ouvert, les ressources de fichier soient disponibles immédiatement ou qu'un message d'erreur soit envoyé. Aucun autre fichier n'est modifié.

Exemple 2 : Modification du nombre maximal d'enregistrements

CHGSAVF   FILE(ONLINE)  MAXRCDS(20000)

Cette commande permet de modifier le fichier sauvegarde ONLINE de sorte qu'il comporte jusqu'à 20 000 enregistrements (environ 10 méga-octets).

Messages d'erreur

*ESCAPE Messages

CPF7304: Fichier &1 de &2 non modifié.