RTVIMGCLG

Extraire catalogue d'images

En bref

La commande RTVIMGCLG est utilisée dans une procédure CL pour extraire le nom du catalogue d'images de CD-ROM chargé dans une unité virtuelle ou pour extraire le nom de l'unité virtuelle dans laquelle un catalogue d'images est chargé.

RTVIMGCLG se lit RTV (Extraire (récupérer)) + IMGCLG. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

RTVIMGCLG

Paramètres

IMGCLG Catalogue d'images de CD-ROM
DEV Unité virtuelle
DEVLOD Var CL pour DEVLOD (10)
IMGCLGLOD Var CL pour IMGCLGLOD (10)

Astuce : dans une session 5250, tapez RTVIMGCLG 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 : Compiled CL program or interpreted REXX (*BPGM *IPGM *BREXX *IREXX)
Compatible multitâche : Non

Restrictions :

Les droits suivants sont requis pour extraire le nom de l'unité virtuelle dans laquelle est chargé le catalogue d'images de CD-ROM :
1. Droit *EXECUTE sur la bibliothèque QUSRSYS.
2. Droit *USE (Utiliser) sur le catalogue d'images de CD-ROM.
Droit *USE (Utiliser) sur l'unité requis pour extraire le nom du catalogue d'images de CD-ROM sur une unité virtuelle.
Cette commande n'est admise que dans une procédure CL compilée.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
IMGCLG	Catalogue d'images de CD-ROM	Nom	Facultatif
DEV	Unité virtuelle	Nom	Facultatif
DEVLOD	Var CL pour DEVLOD (10)	Valeur caractère	Facultatif
IMGCLGLOD	Var CL pour IMGCLGLOD (10)	Valeur caractère	Facultatif

Catalogue d'images de CD-ROM (IMGCLG)

Indique le catalogue d'images de CD-ROM dont vous souhaitez extraire le nom de l'unité virtuelle.

Remarque :Une valeur doit être indiquée pour ce paramètre ou pour le paramètre Unité virtuelle (DEV).

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

Unité virtuelle (DEV)

Indiquez l'unité virtuelle dont vous souhaitez extraire le nom de catalogue d'images de CD-ROM associé.

Remarque :Une valeur doit être indiquée pour ce paramètre ou pour le paramètre Unité virtuelle (IMGCLG).

nom: Indiquez le nom de l'unité virtuelle.

Var CL pour DEVLOD (10) (DEVLOD)

Indique le nom de la variable CL qui reçoit le nom de l'unité virtuelle pour laquelle le catalogue d'images de CD-ROM indiqué est chargé. Vous devez indiquer une variable CL déclarée sous la forme TYPE(*CHAR), et d'une longueur minimale de 10 caractères. La valeur *NONE sera renvoyée si le nom fourni dans le paramètre Catalogue d'images de CD-ROM (IMGCLG) n'est pas associé à une unité virtuelle.

Var CL pour IMGCLGLOD (10) (IMGCLGLOD)

Indique le nom de la variable CL qui reçoit le nom du catalogue d'images de CD-ROM actuellement chargé pour l'unité virtuelle spécifiée. Vous devez indiquer une variable CL déclarée sous la forme TYPE(*CHAR), et d'une longueur minimale de 10 caractères. La valeur *NONE sera renvoyée si le nom fourni dans le paramètre Unité virtuelle (DEV) n'est pas associé à un catalogue d'images de CD-ROM.

Exemples

Exemple 1 : Extraction du nom de l'unité virtuelle chargée

DCL   VAR(&MYLODDEV)  TYPE(*CHAR)  LEN(10)
RTVIMGCLG   IMGCLG(MYCLG)  DEVLOD(&MYLODDEV)

Cette commande extrait le nom de l'unité virtuelle chargée associée au catalogue d'images de CD-ROM MYCLG.

Exemple 2 : Extraction du catalogue d'images de CD-ROM chargé dans une unité virtuelle

DCL   VAR(&MYCLGLOD)  TYPE(*CHAR)  LEN(10)
RTVIMGCLG   DEV(OPTVRT01)  IMGCLGLOD(&MYCLGLOD)

Cette commande extrait le nom du catalogue d'images de CD-ROM associé à l'unité virtuelle OPTVRT01.

Messages d'erreur

Messages *ESCAPE

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.
CPF9825: Accès non autorisé à l'unité &1.