CRTIMGCLG

La commande CRTIMGCLG permet de créer un objet catalogue d'images de CD-ROM (*IMGCLG) dans la bibliothèque QUSRSYS et d'associer le catalogue à un répertoire cible.

Cette commande crée également un objet catalogue d'images de CD-ROM QIMGCLG de type fichier STREAM (*STMF) dans le répertoire indiqué par le paramètre DIR (Répertoire). Cet objet catalogue est utilisé lorsque IMPORT(*YES) est indiqué dans les commandes CRTIMGCLG (Créer un catalogue d'images de CD-ROM) ou CHGIMGCLG (Modifier un catalogue d'images de CD-ROM) pour restaurer le catalogue d'images de CD-ROM à partir du répertoire du catalogue d'images de CD-ROM.

Un catalogue d'images de CD-ROM peut être associé à une unité optique virtuelle ou à une unité de bande virtuelle. Il contient des informations sur les images ajoutées au catalogue d'images de CD-ROM à l'aide de la commande ADDIMGCLGE (Ajouter une entrée de catalogue d'images de CD-ROM). Le catalogue d'images de CD-ROM contient les informations suivantes :

Nom du répertoire

Répertoire dans lequel résideront les fichiers image.

Nom d'unité

Nom de l'unité virtuelle associée au catalogue d'images de CD-ROM.

Etat de catalogue

Etat en cours du catalogue d'images de CD-ROM et de son association avec une unité virtuelle.

Seuil de pool de mémoire secondaire (ASP) du catalogue

Le pourcentage du pool de mémoire secondaire qu'un volume virtuel est autorisé à utiliser lors de la création et de l'attribution d'espace supplémentaire.

Le catalogue d'images de CD-ROM contient les informations suivantes pour chaque poste :

Nom de fichier image

Nom du fichier image.

Identificateur ou nom de volume

Nom formaté du volume optique ou de bande que le fichier image représente.

Numéro d'index

Ordre de cette image dans le catalogue d'images de CD-ROM.

Etat du fichier image

Etat de l'image dans l'unité virtuelle.

Texte

Brève description de l'image.

Restrictions :

• Les droits suivants sont requis pour créer un catalogue d'images de CD-ROM :
  1. Droits *READ et *ADD sur la bibliothèque QUSRSYS.
  2. Droit *X sur chaque répertoire dans le nom de chemin du catalogue d'images de CD-ROM.
• Si le paramètre REFIMGCLG est spécifié, les droits suivants sont requis :
  1. Utilisez le droit (*USE) dans le catalogue d'images de CD-ROM de référence.
  2. Droit *EXECUTE sur la bibliothèque QUSRSYS.
• Si le paramètre ADDVRTVOL (Ajouter des volumes virtuels) est indiqué, les droits supplémentaires ci-dessous sont requis :
  1. Droit *EXECUTE sur la bibliothèque QUSRSYS.
  2. Modifiez le droit (*CHANGE) dans le catalogue d'images de CD-ROM.
• Si IMPORT(*YES) est indiqué, les droits de lecture (*R) et de gestion des objets (*OBJMGT) sont requis dans l'objet catalogue d'images de CD-ROM comme indiqué dans le paramètre DIR (Répertoire).
• Un répertoire ne peut être associé qu'à un seul catalogue d'images de CD-ROM.
• Si DIR(*REFIMGCLG) est spécifié, le catalogue défini par le paramètre REFIMGCLG ne doit pas être à l'état Prêt.
• Les systèmes de fichiers suivants sont pris en charge pour le répertoire de catalogue d'images de CD-ROM :
  1. "root" (/)
  2. QOpenSys
  3. Système UDFS monté
  4. QOPT, lorsque le volume est initialisé en tant que conteneur.
• Répertoire principal d'un système UDFS non pris en charge pour le répertoire du catalogue d'images de CD-ROM.

Paramètres

Catalogue d'images de CD-ROM (IMGCLG)

Indique le catalogue d'images de CD-ROM qui doit être créé.

Ce paramètre est obligatoire.

nom

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

Répertoire (DIR)

Indique le répertoire qui doit être associé à ce catalogue d'images de CD-ROM.

Ce paramètre est obligatoire.

nom-chemin

Indiquez le nom de chemin d'accès du répertoire du catalogue d'images de CD-ROM. Si des liens symboliques existent dans le nom de chemin, ils seront résolus et le chemin absolu sera utilisé.

*REFIMGCLG

Indiquez le nom d'un autre catalogue d'images de CD-ROM en tant que référence pour le nouveau catalogue.

Remarque :Les conditions requises pour les catalogues créés à l'aide du paramètre *REFIMGCLG sont complexes en termes de limitations et d'utilisations prises en charge. Pour plus d'informations, voir Catégorie Storage solutions dans l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Type catalogue images CD-ROM (TYPE)

Indique le type de catalogue d'images de CD-ROM à créer.

*OPT

Il s'agit d'un catalogue d'images de CD-ROM de type optique. Seuls les postes de type optique sont admis pour ce type de catalogue.

*TAP

Il s'agit d'un catalogue d'images de CD-ROM de type bande. Seuls les postes de type bande sont admis pour ce type de catalogue.

Créer un répertoire (CRTDIR)

Indique si le répertoire (paramètre DIR) doit être créé ou non s'il n'existe pas.

*YES

Le répertoire sera créé s'il n'existe pas. Le répertoire créé sera doté des droits par défaut suivants :

                Droits sur         Droits sur les objets
Utilisateur    données     Exist  Mgt  Alter  Ref
*PUBLIC        *EXCLUDE
Propriétaire   *RWX          X     X     X     X

Pour tous les autres attributs, les valeurs par défaut fournies par la commande CRTDIR sont choisies.

*NO

Le répertoire ne sera pas créé.

Importer le catalogue d'images (IMPORT)

Indique si les informations de catalogue et d'entrée sont importées à partir du répertoire de catalogue d'images de CD-ROM.

*NO

Créez le catalogue d'images de CD-ROM sans informations provenant du répertoire du catalogue d'images de CD-ROM.

*YES

Créez le catalogue en important les données de l'objet catalogue d'images de CD-ROM QIMGCLG situé dans le répertoire indiqué dans le paramètre DIR (Répertoire).

Remarque :Les valeurs des paramètres IMGCLG (Catalogue d'images), DIR (Répertoire) et TEXT (Description de texte) indiquées dans la commande CRTIMGCLG (Créer un catalogue d'images) sont utilisées pour le catalogue d'image. Toutes les autres valeurs sont importées à partir de l'objet catalogue d'images QIMGCLG.

Seuil d'ASP du catalogue (CLGASPTHLD)

Indique le pourcentage du pool de mémoire secondaire qu'un volume virtuel est autorisé à utiliser lors de la création et de l'attribution d'espace supplémentaire. Cette valeur est appliquée lorsque de nouveaux volumes sont ajoutés, attribués ou lorsque les fichiers sont développés lors d'opérations d'écriture. Pour les catalogues d'images de CD-ROM installés dans le système de fichiers QOPT, la valeur de seuil d'ASP est ignorée et prend la valeur *MAX.

*CALC

Le seuil de mémoire maximal est calculé. L'espace d'ASP à utiliser par un volume virtuel de catalogue d'images de CD-ROM correspond à la valeur la plus importante entre 95 % ou 5 Go de l'espace restant dans l'ASP. L'opération de bande prend fin avec une erreur de support lorsque le seuil de mémoire maximal pour le volume virtuel est atteint. L'ajout d'un volume virtuel vérifie également cette limite lorsque ALCSTG(*IMGSIZ) est indiqué.

*MAX

La mémoire maximale disponible à l'emplacement du répertoire de catalogue d'images de CD-ROM sera utilisée par les volumes virtuels.

1-99

Indiquez le pourcentage de l'espace d'ASP du répertoire de catalogue d'images de CD-ROM que les volumes virtuels doivent utiliser.

Ajouter des volumes virtuels (ADDVRTVOL)

Indique le nombre de volumes virtuels à ajouter automatiquement au catalogue d'images de CD-ROM ou pour l'ajout de volumes en fonction des fichiers existant dans le répertoire de catalogue d'images de CD-ROM. Les attributs ci-dessous sont utilisés lors de la création de ces volumes virtuels :

1. PREFIX
2. ALCSTG
3. VOLNAM
4. VOLTYP
5. DENSITY
6. NEWOWNID
7. CODE

Ce paramètre est valide pour les catalogues d'images de CD-ROM de type bande ou disque optique. Pour les catalogues d'images de CD-ROM de type disque optique, les volumes sont ajoutés, totalement attribués et initialisés. Pour les catalogues d'images de CD-ROM de type bande, les volumes sont ajoutés et initialisés. Pour plus d'informations, reportez-vous à la commande ADDIMGCLGE (Ajouter une entrée de catalogue d'images de CD-ROM). Le paramètre *DIR permet de trouver des fichiers dans le répertoire de catalogue d'images de CD-ROM et de les ajouter au catalogue d'images de CD-ROM spécifié.

L'ajout de volumes à partir de fichiers image existants peut être contrôlé à l'aide du paramètre IMGTYPE. Les options possibles pour le paramètre IMGTYPE sont les suivantes :

1. *ALL
2. *ISO
3. *BIN

Toutes les options sont valides pour les catalogues d'images de CD-ROM de type optique. Le catalogue d'images de CD-ROM de type bande ne prend en charge que les options *ALL et *BIN. Pour plus d'informations, reportez-vous à API de remplissage de catalogue d'images de CD-ROM (QVOIFIMG).

*NONE

Aucun volume virtuel n'est ajouté.

*DIR

Indiquez que des volumes virtuels doivent être ajoutés à partir des fichiers image dans le répertoire de catalogue d'images de CD-ROM.

1 à 256

Indiquez le nombre de volumes virtuels à ajouter au catalogue d'images de CD-ROM.

Type de fichier image (IMGTYPE)

Indique le type de fichier image à ajouter au catalogue d'images de CD-ROM.

*ALL

Indique que tous les fichiers trouvés dans le répertoire de catalogue d'images de CD-ROM seront ajoutés au catalogue d'images de CD-ROM.

*ISO

Indique que les fichiers portant l'extension .iso seront ajoutés au catalogue d'images de CD-ROM spécifié. La valeur *ISO n'est admise que pour un catalogue d'images de CD-ROM de type optique. Si la valeur *ISO est spécifiée avec un catalogue d'images de CD-ROM de type bande, celui-ci ne sera pas modifié.

*BIN

Indique que les fichiers portant l'extension .bin seront ajoutés au catalogue d'images de CD-ROM spécifié.

Pour les catalogues d'images de CD-ROM de type bande, seuls les fichiers image de bande valides seront ajoutés au catalogue.

Pour les catalogues d'images de CD-ROM de type optique, les fichiers image de bande ne seront pas ajoutés au catalogue.

Catalogue images de référence (REFIMGCLG)

Indique le nom du catalogue d'images de CD-ROM en tant que référence pour le nouveau catalogue. Le nouveau catalogue d'images de CD-ROM dépendant contiendra les postes qui existaient dans le catalogue de référence au moment où il a été créé. Toute modification apportée au catalogue d'images de CD-ROM de référence ne sera pas répercutée dans le catalogue dépendant.

Ce paramètre n'est admis que lorsque DIR(*REFIMGCLG) est spécifié.

nom

Indiquez le nom du catalogue d'images de CD-ROM de référence.

Préfixe fichier et nom volume (PREFIX)

Indique les 3 caractères utilisés pour générer les noms de volume et les noms de fichier pour le paramètre ADDVRTVOL.

*GEN

Le préfixe à 3 caractères des noms de volume et des noms de fichier est généré par le système.

valeur-alphanumérique

Indiquez un préfixe comportant jusqu'à 3 caractères à utiliser pour générer les noms de volume et les noms de fichier image.

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)

Indique la taille des nouveaux fichiers 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 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.

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

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.

Texte 'descriptif' (TEXT)

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

*BLANK

Aucun texte descriptif.

valeur-alphanumérique

Saisissez jusqu'à 50 caractères de texte pour ce catalogue d'images de CD-ROM.

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.

*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 spécifiée pour le paramètre CRTAUT est modifiée, la nouvelle valeur n'affecte pas les objets existants.

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

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

*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 permettant de déterminer les droits sur l'objet. Les droits sur l'objet précisés dans la liste sont accordés aux utilisateurs qui figurent sur cette liste. La liste d'autorisation doit exister à la création de l'objet.

Exemples

Exemple 1 : Création d'un catalogue d'images de CD-ROM de type disque optique

CRTIMGCLG   IMGCLG(MYCLG)  DIR('/MyDir')

Cette commande crée le catalogue d'images de CD-ROM de type disque optique MYCLG dans la bibliothèque et y associe le répertoire /Mydir.

Exemple 2 : Création d'un catalogue d'images de CD-ROM à l'aide d'un catalogue d'images de CD-ROM de référence

CRTIMGCLG   IMGCLG(MYCLG)  DIR(*REFIMGCLG) REFIMGCLG(MYCLG2)

Cette commande crée le catalogue d'images de CD-ROM de type disque optique MYCLG à partir du catalogue MYCLG2 dans la bibliothèque QUSRSYS et y associe le répertoire indiqué dans le catalogue MYCLG2.

Exemple 3 : Création d'un catalogue d'images de CD-ROM de type bande

CRTIMGCLG   IMGCLG(TAPECLG)  DIR('/TapeDir') TYPE(*TAP)

Cette commande crée le catalogue d'images de CD-ROM de type bande TAPECLG dans la bibliothèque QUSRSYS et y associe le répertoire /TapeDir.

Exemple 4 : Création d'un catalogue d'images de CD-ROM de type bande avec des volumes supplémentaires

CRTIMGCLG   IMGCLG(TAPECLG)  DIR('/TapeDir') TYPE(*TAP)
            ADDVRTVOL(12)  IMGSIZ(1500)

Cette commande crée le catalogue d'images de CD-ROM de type bande TAPECLG dans la bibliothèque QUSRSYS et y associe le répertoire /TapeDir. Il ajoute 12 volumes de bande avec des valeurs de volume par défaut et une taille maximale de 1500 Mo. Les valeurs de volume par défaut sont les suivantes :

• PREFIX(*GEN)
• ALCSTG(*MIN)
• VOLTYP(*SL)
• DENSITY(*VRT256K)
• NEWOWNID(*BLANK)
• CODE(*EBCDIC)

Exemple 5 : Création d'un catalogue d'images de CD-ROM importé à partir du répertoire du catalogue d'images de CD-ROM

CRTIMGCLG   IMGCLG(MYCLG)  DIR('/MyDir') IMPORT(*YES)

Cette commande crée le catalogue d'images de CD-ROM MYCLG dans la bibliothèque QUSRSYS et y associe le répertoire /MyDir. Elle met à jour le catalogue et les informations de poste à partir du répertoire du catalogue.

Exemple 6: Création d'un catalogue d'images optiques avec des volumes supplémentaires

CRTIMGCLG   IMGCLG(MYCLG)  DIR('/MyDir') TYPE(*OPT)
            ADDVRTVOL(4) PREFIX(ABC) MEDTYPE(*RAM) IMGSIZ(*DVD4700)

Cette commande crée le catalogue d'images de CD-ROM de type disque optique MYCLG dans la bibliothèque et y associe le répertoire /MyDir. Elle ajoute 4 volumes optiques avec un préfixe ABC, un type de support *RAM et une taille *DVD4700.

Exemple 7: Création d'un catalogue d'images de CD-ROM de type optique et ajout de fichiers image

CRTIMGCLG   IMGCLG(MYCLG)  DIR('/MyDir') TYPE(*OPT)
            ADDVRTVOL(*DIR) IMGTYPE(*ALL)

Cette commande crée le catalogue d'images de CD-ROM de type disque optique MYCLG dans la bibliothèque et y associe le répertoire /MyDir. Tous les fichiers image autres que des fichiers image de bande trouvés dans le répertoire associé sont ajoutés au catalogue.

Messages d'erreur

Messages *ESCAPE

CPFBC02

Catalogue d'images de CD-ROM &1 non créé dans la bibliothèque &2.

CPFBC12

Catalogue d'images de CD-ROM &1 créé. &2 volumes sur &3 non ajoutés.

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.