Aller au contenu

CHGIMGCLGE

Modif poste catalogue d'images

En bref

La commande CHGIMGCLGE permet de modifier les attributs d'un poste de catalogue d'images de CD-ROM.

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

Syntaxe minimale

CHGIMGCLGE IMGCLG(…) IMGCLGIDX(…)

Paramètres

  • IMGCLG Catalogue d'images de CD-ROM obligatoire
  • IMGCLGIDX Index catalogue images CD-ROM obligatoire
  • VOL Volume de catalogue d'images
  • NEWCLGIDX Nouvel index de catalogue
  • WRTPTC Protégé contre l'écriture
  • IMGSIZ Taille d'image
  • ALCSTG Allouer taille mémoire
  • TEXT Texte 'descriptif'

Astuce : dans une session 5250, tapez CHGIMGCLGE 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 CHGIMGCLGE permet de modifier les attributs d'un poste de catalogue d'images de CD-ROM.

Restrictions :

  • Les droits suivants sont requis pour modifier un poste de catalogue d'images de CD-ROM :
    1. Droit *EXECUTE sur la bibliothèque QUSRSYS.
    2. Modifiez le droit (*CHANGE) dans le catalogue d'images de CD-ROM.
    3. Droit *X sur chaque répertoire dans le nom de chemin du catalogue d'images de CD-ROM.
    4. Droit *USE sur la description d'unité virtuelle.
  • Les paramètres ci-dessous ne sont pris en charge que pour les catalogues d'images de CD-ROM de type bande :
    1. IMGSIZ (taille d'image)
    2. ALCSTG (Allouer taille mémoire)

Paramètres

Mot-clé Description Valeurs possibles Remarques
IMGCLG Catalogue d'images de CD-ROM Nom Obligatoire, clé, positionnel 1
IMGCLGIDX Index catalogue images CD-ROM 1-256, *VOL Obligatoire, clé, positionnel 2
VOL Volume de catalogue d'images Valeur caractère Facultatif, clé, positionnel 3
NEWCLGIDX Nouvel index de catalogue 1-256, *SAME Facultatif
WRTPTC Protégé contre l'écriture *SAME, *YES, *NO Facultatif
IMGSIZ Taille d'image 48-1000000, *SAME Facultatif
ALCSTG Allouer taille mémoire *SAME, *MIN, *IMGSIZ Facultatif
TEXT Texte 'descriptif' Valeur caractère, *SAME Facultatif

Catalogue d'images de CD-ROM (IMGCLG)

Indique le catalogue d'images de CD-ROM qui contient l'image à modifier.

Ce paramètre est obligatoire.

nom
Indiquez le nom du catalogue d'images de CD-ROM.

Index catalogue images CD-ROM (IMGCLGIDX)

Indique le numéro d'index du poste de catalogue d'images de CD-ROM qui doit être modifié.

Ce paramètre est obligatoire.

*VOL
Modifiez le poste en indiquant un nom de volume.
1 à 256
Indiquez le numéro d'index du catalogue d'images de CD-ROM à utiliser.

Volume de catalogue d'images (VOL)

Indique le nom de volume du poste à modifier.

nom
Indiquez le nom de volume du poste à modifier. Pour les catalogues d'images de CD-ROM de type optique, le premier volume qui correspond au volume indiqué est modifié.

Nouvel index de catalogue (NEWCLGIDX)

Indique un nouveau numéro d'index à utiliser pour le poste de catalogue d'images de CD-ROM. Si un poste existe déjà à la position d'index indiquée, le nouveau poste est inséré et tous les postes au numéro d'index indiqué ou sous celui-ci sont incrémentés de 1.

*SAME
Le numéro d'index ne sera pas modifié.
1 à 256
Indiquez le numéro d'index du catalogue d'images de CD-ROM à utiliser.

Protégé contre l'écriture (WRTPTC)

Indique si ce poste de catalogue doit être protégé ou non contre l'écriture. Si vous protégez le poste de catalogue contre l'écriture, il ne pourra admettre aucune opération d'écriture. Ce paramètre n'est pas accepté pour les catalogues d'images de CD-ROM dépendants ou de référence.

*SAME
La valeur de protection contre l'écriture ne sera pas modifiée.
*YES
Indique que ce poste de catalogue doit être protégé contre l'écriture. Ceci empêche toute opération d'écriture sur le poste.
*NO
Indique que ce poste de catalogue ne doit pas être protégé contre l'écriture. Les opérations d'écriture sur le poste de catalogue sont autorisées.

Taille d'image (IMGSIZ)

Indique la taille maximale admise pour le fichier image de bande.

Si la taille d'image spécifiée est supérieure à la taille de fichier en cours, la nouvelle taille maximale est définie et la taille de fichier est augmentée.

Si la taille spécifiée est inférieure à la taille d'image maximale en cours et que les données stockées dans le fichier image sont inférieures à la valeur indiquée, la taille du fichier est réduite pour correspondre à la taille de fichier indiquée sinon l'exécution de la commande échouera.

Ce paramètre n'est admis que pour les catalogues d'images de CD-ROM de type bande.

Ce paramètre n'est pas accepté pour les catalogues d'images de CD-ROM dépendants ou de référence.

*SAME
La taille maximale pour le fichier image n'est pas modifiée.
48-1000000
Indiquez le nombre maximal de mégaoctets admis pour le fichier image de bande.

Allouer taille mémoire (ALCSTG)

Indique, pour les fichiers image de bande, si l'intégralité de la quantité de mémoire indiquée pour le paramètre IMGSIZ (Taille d'image) doit être allouée.

Ce paramètre n'est admis que pour les catalogues d'images de CD-ROM de type bande.

Ce paramètre n'est pas accepté pour les catalogues d'images de CD-ROM dépendants ou de référence.

*SAME
L'allocation de mémoire pour le fichier image ne sera pas modifiée.
*MIN
L'allocation de mémoire est modifiée de manière à correspondre à la mémoire requise destinée à contenir les données de fichier image existantes.
*IMGSIZ
L'allocation de mémoire correspond à l'intégralité de la quantité de mémoire pour ce fichier image. Il s'agit de la valeur qui était spécifiée au paramètre IMGSIZ (Taille d'image) de la commande ADDIMGCLGE.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement le poste de catalogue d'images de CD-ROM modifié.

*SAME
Le texte descriptif ne sera pas modifié.
valeur-alphanumérique
Saisissez jusqu'à 50 caractères de texte pour ce poste de catalogue d'images de CD-ROM.

Exemples

Exemple 1 : Modification du numéro d'index d'un catalogue d'images de CD-ROM

CHGIMGCLGE   IMGCLG(MYCLG)  IMGCLGIDX(5)  NEWCLGIDX(2)

Cette commande permet de remplacer par 2 le numéro d'index 5 associé au poste de catalogue d'images de CD-ROM sélectionné.

Exemple 2 : Modification du texte d'un poste de catalogue

CHGIMGCLGE   IMGCLG(MYCLG)  IMGCLGIDX(5)  TEXT('MyText')

Cette commande permet de remplacer par Mytext le texte associé au poste de catalogue d'images de CD-ROM 5.

Exemple 3 : Modification de la protection contre l'écriture d'un poste de catalogue

CHGIMGCLGE   IMGCLG(MYCLG)  IMGCLGIDX(5)  WRTPTC(*YES)

Cette commande protège contre l'écriture le fichier image associé au poste de catalogue d'images de CD-ROM 5.

Exemple 4 : Modification de la taille maximale pour un fichier image de bande

CHGIMGCLGE   IMGCLG(TAPECLG)  IMGCLGIDX(*VOL) VOL(VOL002)
             IMGSIZ(10000)  ALCSTG(*IMGSIZ)

Cette commande remplace la taille maximale admise du fichier image VOL002 par 10000 mégaoctets et alloue cette quantité de mémoire.

Messages d'erreur

Messages *ESCAPE

CPFBC0B
Poste &2 non modifié pour le catalogue d'images de CD-ROM &1.
CPFBC0C
Poste &2 non modifié pour le catalogue d'images de CD-ROM &1.
CPFBC45
Catalogue d'images de CD-ROM &1 non trouvé.
CPF9802
Non autorisé à l'objet &2 de &3.
CPF9820
Non autorisé à utiliser la bibliothèque &1.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.