ADDIMGCLGE

La commande ADDIMGCLGE permet de créer une image virtuelle dans le répertoire de catalogue d'images de CD-ROM (défini au paramètre DIR (Répertoire) de la commande CRTIMGCLG). Si l'image est ajoutée, elle est chargée et le catalogue d'images de CD-ROM (*IMGCLG) de la bibliothèque QUSRSYS est mis à jour. Des images peuvent être ajoutées à partir des sources suivantes :

1. Un support CD ou DVD (en indiquant une unité optique contenant l'image CD ou DVD à ajouter). Cette source n'est admise que pour les catalogues d'images de CD-ROM de type optique.
2. Un fichier image figurant dans un répertoire. Le fichier image peut exister dans n'importe quel répertoire accessible via la commande CPY.
3. Un nouveau fichier image (en indiquant le paramètre FROMFILE(*NEW))

S'il existe un poste de catalogue d'images de CD-ROM avec le même index que celui indiqué au paramètre Index catalogue images CD-ROM (IMGCLGIDX) l'une des situations suivantes va se produire :

1. Si REPLACE(*NO) est indiqué, un message d'erreur est envoyé et le poste du catalogue d'images de CD-ROM n'est pas remplacé.
2. Si REPLACE(*YES) est indiqué, le poste du catalogue d'images de CD-ROM est remplacé.
3. Si REPLACE(*INSERT) est indiqué, le poste du catalogue d'images de CD-ROM est inséré. Si un poste de catalogue existe déjà à l'index indiqué, les postes restants sont incrémentés de un en un jusqu'au prochain index disponible.

Si l'image n'existe pas dans le répertoire cible, elle est copiée et le catalogue d'images de CD-ROM est mis à jour avec les informations relatives à celle-ci.

Restrictions :

• Les droits suivants sont requis pour ajouter un 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. Si vous ajoutez un fichier image à partir d'un support physique, le droit *USE (Utiliser) sur l'unité physique est requis.
  5. Si vous ajoutez un fichier image à partir d'une image située dans un autre répertoire, les droits requis sont les mêmes que ceux requis par la commande CPY.
  6. Si vous ajoutez un fichier image à partir d'une image existante située dans le répertoire de catalogue d'images de CD-ROM, les droits *R (Lire) et *OJBMGT (Gestion des objets) sont requis.
• L'ajout à partir d'un support CD ou DVD physique n'est pris en charge que pour les catalogues d'images de CD-ROM de type optique.
• Cette commande n'accepte pas les catalogues d'images de CD-ROM dépendants.
• Les paramètres ci-dessous ne sont admis que pour les catalogues d'images de CD-ROM de type bande :
  1. ALCSTG
  2. VOLNAM
  3. VOLTYP
  4. DENSITY
  5. NEWOWNID
  6. CODE

  Si l'un des paramètres ci-dessus est indiqué pour un catalogue d'images de CD-ROM de type optique, il n'est pas pris en compte.

Paramètres

Catalogue d'images de CD-ROM (IMGCLG)

Indique le catalogue d'images de CD-ROM dans lequel le poste doit être ajouté.

Ce paramètre est obligatoire.

nom

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

Du lecteur de disque opt, ou (FROMDEV)

Indique le nom de l'unité CD/DVD à partir de laquelle l'image optique doit être copiée. Pour les catalogues d'images de CD-ROM de type optique, une valeur doit être indiquée pour le paramètre FROMDEV ou FROMFILE afin d'identifier le fichier image optique à copier dans le répertoire de catalogue d'images de CD-ROM. Pour les catalogues d'images de CD-ROM de type bande, le paramètre FROMDEV n'est pas admis.

nom

Indiquez le nom de l'unité optique à partir de laquelle le fichier image optique doit être copié.

*VOL

Indiquez le nom du volume optique à partir de laquelle le fichier image optique doit être copié.

Identificateur de volume (VOL)

Indique le nom de l'identificateur de volume optique à ajouter au catalogue d'images de CD-ROM. Ce paramètre n'est requis que lorsque FROMDEV(*VOL) est indiqué par ailleurs. Le volume spécifié ne peut pas être un volume de type bande. Une licence séparée pourra être nécessaire pour cette fonction.

identificateur-volume

Indiquez l'identificateur du volume optique à ajouter.

Du fichier image (FROMFILE)

Indique le fichier image qui doit être copié. Pour les catalogues d'images de CD-ROM de type optique, une valeur doit être indiquée pour le paramètre FROMDEV ou FROMFILE afin d'identifier le fichier image optique à copier dans le répertoire de catalogue d'images de CD-ROM. Pour les catalogues d'images de CD-ROM de type bande, une valeur doit être indiquée pour le paramètre FROMFILE afin d'identifier le fichier image de bande à copier dans le répertoire de catalogue d'images de CD-ROM.

*NEW

Un nouveau poste de catalogue doit être ajouté et un fichier image vide doit être créé.

nom

Indiquez le nom du fichier image optique ou de bande qui doit être ajouté au catalogue d'images de CD-ROM.

Vers fichier image (TOFILE)

Indique le nom donné au fichier qui va être copié dans le répertoire cible.

*GEN

Le nom du fichier va être généré à partir de l'image source.

*FROMFILE

Le nom du fichier va être le même que celui de l'image source. Si l'image source provient d'un support optique, le nom donné au fichier est l'ID du volume. Si l'image source provient d'un autre répertoire, le nom donné au fichier est le même que celui provenant du répertoire source.

nom

Indiquez jusqu'à 255 caractères pour le nom du fichier image optique ou de bande à ajouter dans le catalogue d'images de CD-ROM.

Index catalogue images CD-ROM (IMGCLGIDX)

Indique l'index de catalogue d'images de CD-ROM qui doit être affecté à l'image ajoutée.

*AVAIL

Le numéro d'index de catalogue d'images de CD-ROM affecté à l'image est le premier numéro d'index disponible.

1 à 256

Indiquez le numéro d'index du catalogue d'images de CD-ROM à utiliser.

Remplacer poste catalogue (REPLACE)

Indique l'action qui doit être effectuée si un poste de catalogue avec le même numéro d'index que celui indiqué au paramètre IMGCLGIDX existe déjà dans le catalogue d'images de CD-ROM.

*NO

Le poste de catalogue existant n'est pas remplacé et un message d'erreur est généré.

*YES

Le poste de catalogue d'images de CD-ROM existant est remplacé.

*INSERT

Le poste de catalogue indiqué est ajouté (ou inséré s'il existe déjà un numéro d'index). Si le poste de catalogue d'images de CD-ROM est inséré, les postes restants sont incrémentés de un en un jusqu'au prochain numéro d'index disponible.

Type de support (MEDTYPE)

Indique le type de support à créer.

*RAM

Un support à accès aléatoire (type mémoire vive) sera créé. Le format pris en charge pour les supports *RAM est UDF (Universal Disk Format), sous-ensemble de la norme ISO-13346.

*ERASE

Un support effaçable (type réinscriptible) sera créé. Les formats pris en charge pour les supports *ERASE sont HPOFS (High Performance Optical File System) et UDF (Universal Disk Format), sous-ensemble de la norme ISO-13346.

*WORM

Un support inscriptible une seule fois (type non réinscriptible) sera créé. Le format pris en charge pour les supports *WORM est HPOFS (High Performance Optical File System.

Taille d'image (IMGSIZ)

Définit la taille du fichier image à créer.

Pour les catalogues d'images de CD-ROM de type optique, ce paramètre indique la taille du fichier image optique à créer et le volume de mémoire à allouer à partir de l'emplacement de répertoire de catalogue d'images de CD-ROM spécifié.

Pour les catalogues d'images de CD-ROM de type bande, ce paramètre indique la taille maximale admise pour ce fichier image de bande. Si ALCSTG(*MIN) est spécifié, seul le volume de mémoire requis pour initialiser le fichier image sera alloué. Si ALCSTG(*IMGSIZ) est précisé, le volume de mémoire alloué correspondra à la valeur indiquée au paramètre IMGSIZ.

*IMGCLGTYPE

La taille du fichier image à créer est déterminée par le type de catalogue d'images de CD-ROM.

Pour les catalogues d'images de CD-ROM de type optique, la taille du fichier image créé sera de 650 Mo. Les images optiques créées avec cette taille peuvent être écrites sur tout support standard de 650 Mo.

Pour les catalogues d'images de CD-ROM de type bande, la taille maximale du fichier image créé est de 1 gigaoctet.

*CD650

La taille du fichier image optique est de 650 mégaoctets. Les images optiques créées avec cette taille peuvent être écrites sur tout support optique standard de 650 mégaoctets.

*DVD2600

La taille du fichier image optique est de 2,6 gigaoctets. Les images optiques créées avec cette taille peuvent être écrites sur tout support de 2,6 gigaoctets.

*DVD4700

La taille du fichier image optique est de 4,7 gigaoctets. Les images optiques créées avec cette taille peuvent être écrites sur tout support de 4,7 gigaoctets.

nombre

Indiquez le nombre de mégaoctets du nouveau fichier image. La plage de valeurs admises est comprise entre 48 et 1000000 mégaoctets.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement le catalogue d'images de CD-ROM en cours de chargement.

*GEN

Pour les catalogues d'images de CD-ROM de type optique, la zone de texte reçoit la description du support (le cas échéant), autrement elle reçoit l'ID volume du support. Pour les catalogues d'images de CD-ROM de type bande, le texte est généré par le système à l'aide de la date et de l'heure courantes.

*BLANK

Aucun texte descriptif.

valeur-alphanumérique

Saisissez jusqu'à 50 caractères de texte pour ce fichier image.

Allouer taille mémoire (ALCSTG)

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

*MIN

Allouez uniquement la mémoire requise pour initialiser le fichier image de bande lors de la création.

*IMGSIZ

Allouez l'intégralité de la mémoire indiquée pour le paramètre Taille d'image (IMGSIZ).

Nom de volume de bande (VOLNAM)

Indique le nom de ce volume de bande virtuel.

*GEN

Le nom de volume sera généré par le système.

valeur-alphanumérique

Indiquez jusqu'à 6 caractères pour le nom qui permet d'identifier ce volume de bande virtuel. Le nom de volume doit être composé uniquement de caractères alphanumériques (A à Z, $, #, à, et 0 à 9) et ne doit pas contenir de préfixe ni de caractères blancs. Si le volume de bande virtuel est créé avec un label standard, le nom de volume sera également utilisé en tant qu'identificateur de volume dans le label de volume de bande. Chaque nom de volume du catalogue doit être unique.

Type de volume (VOLTYP)

Indique le type de ce volume de bande virtuel.

*SL

Il s'agit d'un volume de bande à label standard.

*NL

Il s'agit d'un volume de bande sans label standard.

Densité bande (DENSITY)

Indique la densité de ce volume de bande virtuel.

*VRT256K

Le format du volume est *VRT256K. Il permet d'écrire des données sur un volume virtuel en utilisant une taille maximale de bloc de 256 ko. Les volumes écrits à l'aide de ce format ne peuvent être dupliqués que sur des unités de bande prenant en charge une taille maximale de bloc supérieure ou égale à 256 ko.

*VRT240K

Le format du volume est *VRT240K. Il permet d'écrire des données sur un volume virtuel en utilisant la taille maximale de bloc de 240 ko. Les volumes écrits à l'aide de ce format ne peuvent être dupliqués que sur des unités de bande prenant en charge une taille maximale de bloc supérieure ou égale à 240 ko.

*VRT64K

Le format du volume est *VRT64K. Il permet d'écrire des données sur un volume virtuel en utilisant une taille maximale de bloc de 64 ko. Les volumes écrits à l'aide de ce format ne peuvent être dupliqués que sur des unités de bande prenant en charge une taille maximale de bloc supérieure ou égale à 64 ko.

*VRT32K

Le format du volume est *VRT32K. Il permet d'écrire des données sur un volume virtuel en utilisant une taille maximale de bloc de 32 ko. Les volumes écrits à l'aide de ce format peuvent être dupliqués sur toutes les unités de bande prises en charge.

Nouvel ID propriétaire (NEWOWNID)

Indique l'identificateur du propriétaire de bande pour ce volume de bande virtuel. Ce paramètre ne s'applique qu'aux volumes de type *SL.

*BLANK

Aucun identificateur ne sera spécifié.

nom

Indiquez 14 caractères au maximum pour identifier le propriétaire du volume de bande virtuel. Si vous indiquez moins de 14 caractères, la zone est alignée à gauche et des blancs de fin sont ajoutés à droite.

Code (CODE)

Indique le code alphanumérique utilisé pour l'écriture du label de volume. Toutes les données suivant le label (hormis les données de type sauvegarde) doivent être écrites dans le même code. Seules les bandes de sauvegarde peuvent comporter des données codées différentes. Ce paramètre ne s'applique qu'aux volumes de type *SL.

*EBCDIC

Le label de volume est un label standard IBM écrit en EBCDIC ; les données supplémentaires doivent également être écrites en EBCDIC.

*ASCII

Le label de volume est un label standard ANSI écrit en ASCII ; les données supplémentaires doivent également être écrites en ASCII.

Exemples

Exemple 1 : Ajout d'un poste de catalogue d'images de CD-ROM à partir d'un support CD/DVD

ADDIMGCLGE   IMGCLG(MYCLG)  FROMDEV(OPT01)

Cette commande ajoute l'image optique de l'unité OPT01 dans le répertoire de catalogue d'images de CD-ROM et met à jour MYCLG. Le répertoire de catalogue d'images de CD-ROM est celui qui est indiqué au paramètre DIR (Répertoire) de la commande CRTIMGCLG.

Exemple 2 : Ajout d'un poste de catalogue d'images de CD-ROM à partir d'un répertoire

ADDIMGCLGE   IMGCLG(MYCLG)  FROMFILE('/MyDir/MyFile.img')

Cette commande ajoute le fichier image /MyDir/Myfile.img dans le répertoire de catalogue d'images de CD-ROM /MyNewDir et met à jour MYCLG. Le répertoire de catalogue d'images de CD-ROM est celui qui est indiqué au paramètre DIR (Répertoire) de la commande CRTIMGCLG.

Exemple 3 : Insertion d'un poste de catalogue d'images de CD-ROM

ADDIMGCLGE   IMGCLG(MYCLG)  FROMDEV(OPT01)  REPLACE(*INSERT)

Cette commande ajoute l'image optique de l'unité OPT01 dans le répertoire de catalogue d'images de CD-ROM, et, si un poste de catalogue existe au numéro d'index indiqué, insère le poste correspondant dans le catalogue et incrémente les postes restants jusqu'à l'index disponible suivant. Le répertoire de catalogue d'images de CD-ROM est celui qui est indiqué au paramètre DIR (Répertoire) de la commande CRTIMGCLG.

Exemple 4 : Ajout d'un nouveau poste de catalogue d'images de CD-ROM de type disque optique

ADDIMGCLGE   IMGCLG(MYCLG)  FROMFILE(*NEW)  TOFILE(MYFILE)
             IMGSIZ(*CD650) MEDTYPE(*RAM)

Cette commande ajoute le nouveau fichier image optique MYFILE dans le répertoire de catalogue d'images de CD-ROM avec une taille de 650 mégaoctets. Le type de support pour le nouveau volume est *RAM. Le répertoire de catalogue d'images de CD-ROM est celui qui est indiqué au paramètre DIR (Répertoire) de la commande CRTIMGCLG.

Exemple 5 : Ajout d'un nouveau poste de catalogue d'images de CD-ROM de type bande

ADDIMGCLGE   IMGCLG(TAPECLG)  FROMFILE(*NEW)  TOFILE(TAP001)
             IMGSIZ(*IMGCLGTYPE) ALCSTG(*MIN) VOLNAM(MYVOL)
             VOLTYP(*SL) DENSITY(*VRT256K) NEWOWNID(MYNAME)
             CODE(*EBCDIC)

Cette commande ajoute le nouveau fichier image TAP001 avec le nom de volume MYVOL dans le répertoire cible et avec la taille maximale admise de 1000 mégaoctets. Seule la mémoire requise pour créer et initialiser le volume virtuel sera allouée au moment de la création. Le répertoire cible est celui qui est spécifié au paramètre DIR (Répertoire) de la commande CRTIMGCLG.

Exemple 6 : Ajout d'un nouveau poste de catalogue d'images de CD-ROM de type bande avec une attribution

ADDIMGCLGE   IMGCLG(TAPECLG)  FROMFILE(*NEW)  TOFILE(TAP002)
             IMGSIZ(5000) ALCSTG(*IMGSIZ)

Cette commande ajoute le nouveau fichier image TAP002 dans le répertoire cible avec une taille maximale de 5000 mégaoctets. La totalité de ces 5000 mégaoctets sera allouée à ce fichier image au moment de sa création. Le répertoire cible est celui qui est spécifié au paramètre DIR (Répertoire) de la commande CRTIMGCLG.

Exemple 7 : Ajout d'un poste de catalogue d'images de CD-ROM à partir du répertoire de catalogue d'images de CD-ROM

ADDIMGCLGE   IMGCLG(MYCLG)  FROMFILE('/MyClgDir/MyFile.img')
             TOFILE(*FROMFILE)

Cette commande met à jour le catalogue d'images de CD-ROM MYCLG avec des informations concernant le fichier image MyFile.img.

Messages d'erreur

Messages *ESCAPE

CPFBC28

Poste non ajouté dans 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.