RTVOBJD

La commande RTVOBJD (Extraire description d'objet) permet de renvoyer la description d'un objet à un programme CL ou à une procédure REXX.

Pour les paramètres qui sont renvoyés dans les variables CL par cette commande, le titre descriptif/texte d'invite des paramètres répertorie la longueur minimale de la variable CL. Pour les variables de type alphanumérique, un seul nombre s'affiche. Dans le cas de variables décimales, deux nombres s'affichent. Le premier indique la longueur minimale de la variable et le second le nombre minimal des positions décimales.

Restrictions :

1. Vous devez disposer du droit d'exécution (*EXECUTE) sur la bibliothèque.
2. Vous devez disposer d'un droit autre que *EXCLUDE pour l'objet. Si l'objet est un fichier, vous devez disposer du droit d'opération (*OBJOPR) sur l'objet.
3. Vous devez disposer du droit spécial *ALLOBJ ou *AUDIT pour extraire une valeur autre que *NOTAVL pour le paramètre OBJAUD.

Paramètres

Objet (OBJ)

Indique l'objet pour lequel vous voulez extraire des informations.

Ce paramètre est obligatoire.

Qualificatif 1 : Objet

nom

Indiquez le nom de l'objet pour lequel la description doit être extraite.

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. Si l'invite Unité ASP (paramètre ASPDEV) est indiquée lorsque cette valeur est utilisée, ASPDEV(*) est la seule valeur admise.

*CURLIB

La recherche porte sur la bibliothèque en cours de l'unité d'exécution. Si aucune bibliothèque n'est définie comme bibliothèque en cours pour l'unité d'exécution, la recherche porte sur la bibliothèque QGPL. Si le paramètre Unité ASP (ASPDEV) est indiqué lorsque cette valeur est utilisée, la valeur ASPDEV(*) est la seule valeur admise.

nom

Indiquez le nom de la bibliothèque dans laquelle doit s'effectuer la recherche.

Type d'objet (OBJTYPE)

Indique le type de l'objet pour lequel vous voulez extraire des informations.

Ce paramètre est obligatoire.

type-objet

Indiquez l'objet pour lequel des informations doivent être extraites.

Unité ASP (ASPDEV)

Indique le nom de l'unité ASP dans laquelle de la mémoire est allouée pour la bibliothèque contenant l'objet. Si la bibliothèque réside dans un ASP qui ne fait pas partie de l'espace de nom de la bibliothèque de l'unité d'exécution, ce paramètre doit faire en sorte que la recherche s'effectue dans la bibliothèque appropriée. Si ce paramètre est utilisé lorsque le qualificatif de bibliothèque indiqué pour le paramètre Objet (OBJ) est *CURLIB ou *LIBL, ASPDEV(*) est la seule valeur admise. Ce paramètre peut être indiqué sous la forme d'une valeur particulière ou d'une liste d'un ou deux éléments.

Valeurs uniques

*

La recherche de la bibliothèque s'effectue dans tous les ASP présents dans l'espace de nom de bibliothèque de l'unité d'exécution. Il s'agit de l'ASP système (ASP 1), de tous les ASP utilisateur de base définis(ASP 2 à 32) et, si l'unité d'exécution dispose d'un groupe d'ASP, des ASP principaux et secondaires du groupe d'ASP de l'unité d'exécution.

*ALLAVL

La recherche va porter sur tous les ASP disponibles. Il s'agit de l'ASP système (ASP 1), de tous les ASP utilisateur de base définis (ASP 2 à 32) et de tous les ASP principaux et secondaires disponibles (ASP 33 à 255 à l'état 'Disponible'). L'ASP principal recherche les groupes d'ASP par ordre alphabétique. L'ASP système et tous les ASP utilisateur de base définis sont recherchés après les groupes d'ASP. Les ASP et les bibliothèques sur lesquels l'utilisateur ne dispose pas de droits sont ignorés et aucun message d'erreur de droits n'est envoyé.

*CURASPGRP

Si l'unité d'exécution dispose d'un groupe ASP, la recherche portera sur les ASP primaire et secondaire du groupe ASP de l'unité pour trouver la bibliothèque. La recherche ne s'effectue ni dans l'ASP système (ASP 1) ni dans les ASP utilisateur de base définis (ASP 2-32). Si aucun groupe d'ASP n'est associé à l'unité d'exécution, une erreur est signalée.

*SYSBAS

La bibliothèque est recherchée dans l'ASP système (ASP 1) et dans tous les ASP utilisateur de base définis (ASP 2-32). Les ASP principaux et secondaires ne sont pas concernés par cette recherche, même si l'unité d'exécution possède un groupe d'ASP.

Elément 1 : Unité

nom

Indiquez le nom de l'unité ASP primaire ou secondaire sur laquelle les recherches doivent porter. L'ASP principal ou secondaire doit être activé (via la mise en fonction de l'unité ASP) et être à l'état 'Disponible'. La recherche ne s'effectue ni dans l'ASP système (ASP 1) ni dans les ASP utilisateur de base définis (ASP 2-32).

Remarque :Pour indiquer un nom d'unité ASP spécifique lorsque le type de recherche spécifié pour l'élément 2 est *ASP, vous devez disposer du droit *EXECUTE sur cette unité ASP spécifique.

Pour indiquer un nom d'unité ASP spécifique lorsque le type de recherche spécifié pour l'élément 2 est *ASPGRP, vous devez disposer du droit *EXECUTE sur chaque unité ASP du groupe d'ASP.

Elément 2 : Type de recherche

Permet d'indiquer si la recherche doit porter sur l'unité ASP uniquement ou l'ensemble du groupe d'ASP indiqué dans l'élément 1.

*ASP

La recherche portera seulement sur l'unité de pool de mémoire secondaire (ASP) unique baptisée dans l'élément 1.

*ASPGRP

La recherche portera sur l'ensemble du groupe de l'unité de pool de mémoire secondaire (ASP) baptisée dans l'élément 1.

Variable pour RTNLIB (10) (RTNLIB)

Indique une variable de 10 caractères permettant de renvoyer le nom de la bibliothèque qui contient l'objet. Si *LIBL ou *CURLIB a été indiqué pour la bibliothèque (qualificatif 2) du paramètre Objet (OBJ), la valeur renvoyée est le nom de la bibliothèque dans laquelle l'objet a été trouvé. Si un nom de bibliothèque a été indiqué, il est renvoyé par ce paramètre.

Variable pour OBJATR (10) (OBJATR)

Indique une variable de 10 caractères permettant de renvoyer un attribut étendu de l'objet tel qu'un programme ou un type de fichier. Par exemple, la valeur renvoyée pourra être CLP ou PF, sans astérisque (*) précédant cette valeur.

Variable pour USRDFNATR (10) (USRDFNATR)

Indique une variable de 10 caractères permettant de renvoyer l'attribut défini par l'utilisateur pour l'objet. Si l'objet extrait ne possède pas d'attribut défini par l'utilisateur, des blancs sont renvoyés. Cet attribut peut être modifié à l'aide de l'API QLICOBJD (Modifier description d'objet).

Variable pour TEXT (50) (TEXT)

Indique une variable CL de 50 caractères permettant de renvoyer le texte descriptif de l'objet.

Variable pour OWNER (10) (OWNER)

Indique une variable de 10 caractères permettant de renvoyer le nom du propriétaire de l'objet.

Variable pour PGP (10) (PGP)

Indique une variable de 10 caractères permettant de renvoyer le nom de l'utilisateur qui est le groupe principal de l'objet. S'il n'y a pas de groupe principal pour cet objet, cette zone contient la valeur *NONE.

Variable pour ASP (2 0) (ASP)

Indique une variable décimale (2 0) utilisée pour renvoyer le numéro du pool de mémoire secondaire (ASP) de l'objet. Cette variable renvoie des numéros d'ASP jusqu'à 32. Si le numéro de l'ASP est supérieur à 32, -1 est renvoyé à cette variable. Le paramètre OBJASPDEV doit être utilisé pour renvoyer le nom de l'unité ASP lorsque le numéro d'ASP est supérieur à 32. Les valeurs suivantes peuvent être renvoyées :

1

L'objet se trouve dans le pool de mémoire secondaire du système.

2-32

L'objet se trouve dans le pool de mémoire secondaire utilisateur de base.

-1

L'objet se trouve dans un pool de mémoire principal ou secondaire ayant un numéro d'ASP supérieur à 32. Le nom de l'unité ASP principal ou secondaire peut être extrait à l'aide du paramètre OBJASPDEV.

Variable pour LIBASP (5 0) (LIBASP)

Indique une variable décimale (5 0) permettant de renvoyer le numéro de l'ASP qui possède la mémoire allouée à la bibliothèque contenant l'objet. Cette variable renvoie des numéros d'ASP jusqu'à 32. Si le numéro de l'ASP est supérieur à 32, -1 est renvoyé à cette variable. Le paramètre LIBASPDEV doit être utilisé pour renvoyer le nom de l'unité ASP lorsque le numéro d'ASP est supérieur à 32. Les valeurs suivantes peuvent être renvoyées :

1

La bibliothèque se trouve dans le pool de mémoire secondaire système.

2-32

La bibliothèque se trouve dans le pool de mémoire secondaire utilisateur de base.

-1

La bibliothèque se trouve dans un pool de mémoire secondaire principal ou secondaire ayant un numéro d'ASP supérieur à 32. Le nom de l'unité ASP principal ou secondaire peut être extrait à l'aide du paramètre LIBASPDEV.

Variable pour OBJASPDEV (10) (OBJASPDEV)

Indique une variable de 10 caractères utilisée pour récupérer le nom de l'unité ASP qui possède la mémoire allouée à l'objet. Les valeurs spéciales suivantes peuvent être renvoyées :

*N

Le nom de l'unité ASP ne peut pas être identifié.

*SYSBAS

L'objet se trouve dans l'ASP système (ASP 1) ou utilisateur de base (ASP 2-32).

Variable pour OBJASPGRP (10) (OBJASPGRP)

Indique une variable de 10 caractères permettant de renvoyer le nom du groupe d'ASP qui possède la mémoire allouée à l'objet. Le nom de groupe d'ASP est le nom de l'ASP principal au sein du groupe d'ASP. La valeur renvoyée peut être identique à celle renvoyée pour le paramètre OBJASPDEV. Les valeurs spéciales suivantes peuvent être renvoyées :

*N

Le nom de l'unité ASP principale ne peut pas être déterminé.

*SYSBAS

L'objet se trouve dans l'ASP système (ASP 1) ou utilisateur de base (ASP 2-32).

Variable pour LIBASPDEV (10) (LIBASPDEV)

Indique une variable de 10 caractères permettant de renvoyer le nom de l'unité ASP qui possède la mémoire allouée à la bibliothèque contenant l'objet. Les valeurs spéciales suivantes peuvent être renvoyées :

*N

Le nom de l'unité ASP ne peut pas être identifié.

*SYSBAS

La bibliothèque se trouve dans l'ASP système (ASP 1) ou l'ASP utilisateur de base (ASP 2-32).

Variable pour LIBASPGRP (10) (LIBASPGRP)

Indique une variable de 10 caractères permettant de renvoyer le nom du groupe d'ASP principal qui possède la mémoire allouée à la bibliothèque contenant l'objet. Le nom de groupe d'ASP est le nom de l'ASP principal au sein du groupe d'ASP. La valeur renvoyée peut être identique à celle renvoyée pour le paramètre LIBASPDEV. Les valeurs spéciales suivantes peuvent être renvoyées :

*N

Le nom de l'unité ASP principale ne peut pas être déterminé.

*SYSBAS

L'objet se trouve dans l'ASP système (ASP 1) ou utilisateur de base (ASP 2-32).

Variable pour OVFASP (1) (OVFASP)

Variable de 1 caractère permettant de renvoyer l'indicateur Objet en dépassement de l'ASP.

'1'

L'objet dépasse l'ASP dans lequel il réside.

'0'

L'objet ne dépasse pas l'ASP. Si un objet d'un ASP système (ASP 1) ou d'un ASP principal ou secondaire (ASP 33-255) ne peut pas dépasser son ASP, la valeur '0' est donc toujours renvoyée pour les objets de l'ASP système (ASP 1) ou de l'ASP principal ou secondaire (ASP 33-255).

Variable pour CRTDATE (13) (CRTDATE)

Indique une variable de 13 caractères permettant de renvoyer la date et l'heure de création de l'objet. La valeur est renvoyée sous la forme SAAMMJJHHMMSS, où S = siècle ('0' désigne les années 19xx et '1' désigne les années 20xx), AA = année, MM = mois, JJ = jour, HH = heure, MM = minutes et SS = secondes.

Variable pour CHGDATE (13) (CHGDATE)

Indique une variable de 13 caractères permettant de renvoyer la date et l'heure de la dernière modification de l'objet. Cette valeur est renvoyée dans le même format que le paramètre CRTDATE ou, si l'objet n'a pas été modifié, des blancs sont renvoyés.

Variable pour SAVDATE (13) (SAVDATE)

Indique une variable de 13 caractères permettant de renvoyer la date et l'heure de la dernière sauvegarde de l'objet. Cette valeur est renvoyée dans le même format que le paramètre CRTDATE ou, si l'objet n'a pas été sauvegardé, des blancs sont renvoyés.

Variable pour SAVACTDATE (13) (SAVACTDATE)

Variable de 13 caractères permettant de renvoyer la date et l'heure de la dernière sauvegarde de l'objet lors d'une opération de sauvegarde à l'aide du paramètre SAVACT dont la valeur est autre que *NO. Cette date et cette heure indiquent le moment précis auquel l'objet lui-même a été sauvegardé ; le paramètre SAVDAT indique le début de la sauvegarde. La variable est renvoyée dans le même format que le paramètre CRTDATE, ou bien des blancs sont renvoyés si l'objet n'a pas été sauvegardé ou si SAVACT(*NO) a été indiqué pour la dernière opération de sauvegarde de l'objet.

Variable pour RSTDATE (13) (RSTDATE)

Indique une variable de 13 caractères permettant de renvoyer la date et l'heure de la dernière restauration de l'objet. Cette valeur est renvoyée dans le même format que le paramètre CRTDATE ou, si l'objet n'a pas été restauré, des blancs sont renvoyés.

Variable pour CRTUSER (10) (CRTUSER)

Indique une variable de 10 caractères permettant de renvoyer le nom de l'utilisateur qui a créé l'objet.

Variable pour CRTSYSTEM (8) (CRTSYSTEM)

Indique une variable CL de 8 caractères destinée à renvoyer le nom du système sur lequel l'objet a été créé.

Variable pour OBJDMN (2) (OBJDMN)

Indique une variable de 2 caractères permettant de renvoyer la valeur de domaine de l'objet. Les valeurs suivantes peuvent être renvoyées :

*U

L'objet est un objet de domaine utilisateur.

*S

L'objet est un objet de domaine système.

Variable pour USEUPD (1) (USEUPD)

Indique une variable de 1 caractère indiquant si les informations relatives à l'utilisation de l'objet sont mises à jour pour ce type d'objet. Les valeurs suivantes peuvent être renvoyées :

Y

Les informations relatives à l'utilisation de l'objet sont mises à jour pour ce type d'objet.

N

Les informations relatives à l'utilisation de l'objet ne sont pas mises à jour pour ce type d'objet. Si 'N' est renvoyé, la date de dernière utilisation de l'objet est à blanc et le nombre de jours d'utilisation de l'objet est 0.

Variable pour USEDATE (7) (USEDATE)

Indique une variable de 7 caractères permettant de renvoyer la date de la dernière utilisation de l'objet. Cette date est renvoyée sous la forme SAAMMJJ. Si l'objet ne possède pas de date de dernière utilisation, des blancs sont renvoyés.

Variable pour USECOUNT (5 0) (USECOUNT)

Indique une variable décimale (5 0) destinée à recevoir le nombre de jours pendant lequel l'objet a été utilisé. Si l'objet n'a pas de date de dernière utilisation, la valeur renvoyée est zéro (0).

Variable pour RESETDATE (7) (RESETDATE)

Indique une variable de 7 caractères destinée à recevoir la date de dernière remise à zéro (0) du compteur de jours d'utilisation. Cette date est renvoyée sous la forme SAAMMJJ. Si le compteur de jours d'utilisation n'a pas été remis à zéro, des blancs sont renvoyés.

Variable pour STG (10) (STG)

Indique une variable de 10 caractères permettant de renvoyer l'état de l'espace mémoire des données de l'objet. Les valeurs suivantes peuvent être renvoyées :

*FREE

Les données de l'objet ont été libérées et l'objet est suspendu.

*KEEP

Les données de l'objet n'ont pas été libérées et l'objet n'a pas été suspendu.

Variable pour CPR (1) (CPR)

Variable de 1 caractère permettant de renvoyer l'état de compression de l'objet. Les valeurs suivantes peuvent être renvoyées :

Y

L'objet est comprimé.

X

La compression de l'objet n'est pas possible.

N

L'objet est décomprimé en permanence.

T

L'objet est provisoirement décomprimé.

F

La compression de l'objet est possible mais celui-ci est sauvegardé avec libération de mémoire.

Variable pour SIZE (15 0) (SIZE)

Indique une variable décimale (15 0) destinée à recevoir la taille de l'objet en octets. Cette valeur inclut la valeur renvoyée par le paramètre SPCSIZE.

Variable pour SPCSIZE (15 0) (SPCSIZE)

Variable décimale (15 0) destinée à recevoir la taille de l'espace associé principal de l'objet en octets. Si aucun espace n'est associé à l'objet, la valeur 0 est renvoyée.

Variable pour SPCALIGN (1) (SPCALIGN)

Variable de 1 caractère utilisée pour indiquer si l'espace associé à l'objet a été aligné de façon optimale. L'alignement optimal permet d'améliorer les performances des applications qui utilisent l'objet. Les valeurs suivantes peuvent être renvoyées :

'0'

L'espace associé à l'objet n'a pas été aligné de façon optimale.

'1'

L'espace associé à l'objet a été aligné de façon optimale.

'2'

Aucun espace n'est associé à l'objet.

Variable pour SAVSIZE (15 0) (SAVSIZE)

Indique une variable décimale (15 0) destinée à recevoir la taille de l'objet en octets lors de la dernière opération de sauvegarde. Si l'objet n'a pas été sauvegardé, la valeur renvoyée est zéro (0).

Variable pour SAVCMD (10) (SAVCMD)

Indique une variable de 10 caractères servant à renvoyer la commande qui permet de sauvegarder l'objet. Si l'objet n'a pas été sauvegardé, des blancs sont renvoyés.

Variable pour SAVSEQNBR (4 0) (SAVSEQNBR)

Indique une variable décimale (4 0) destinée à renvoyer le numéro de séquence de bande affecté lors de la sauvegarde de l'objet. Cette variable renvoie des numéros de séquence allant jusqu'à 9999. Si l'objet n'a pas été sauvegardé ou qu'il n'a pas été sauvegardé sur bande, la valeur renvoyée est zéro (0). Si un numéro de séquence est supérieur à 9999, -5 est renvoyé. Le paramètre SAVLRGSEQ doit être utilisé pour renvoyer un numéro de séquence pouvant être supérieur à 9999.

Variable pour SAVLRGSEQ (10 0) (SAVLRGSEQ)

Indique une variable décimale (10 0) destinée à renvoyer le numéro de séquence de bande (similaire au paramètre SAVSEQNBR). Cette variable peut contenir un numéro de séquence de bande plus élevé que le paramètre SAVSEQNBR.

Variable pour SAVVOL (71) (SAVVOL)

Indique une variable de 71 caractères destinée à renvoyer les identificateurs de bande, de disquette ou de volumes optiques utilisés pour sauvegarder l'objet. La variable renvoie au maximum 10 ID volume, qui commencent aux positions 1, 8, 15, 22, 29, 36, 43, 50, 57 et 64. Chaque poste d'ID volume est séparé par un seul caractère. Si l'objet a été sauvegardé au format parallèle, le caractère de séparation contient, avant le premier volume, le chiffre "2" dans le deuxième fichier de support, le chiffre "3" dans le troisième fichier de support, et ainsi de suite jusqu'au chiffre "0" avant le neuvième fichier de support. Sinon, les caractères de séparation sont à blanc. Si plus de 10 volumes sont utilisés et si l'objet a été sauvegardé au format série, le chiffre 1 est renvoyé à la 71ème position de la variable. Si l'objet a été sauvegardé au format parallèle, le chiffre 2 est renvoyé à la 71ème position de la variable. Sinon, le 71ème caractère est à blanc. Si l'objet a été sauvegardé pour la dernière fois dans un fichier sauvegarde ou s'il n'a jamais été sauvegardé, des blancs sont renvoyés.

Variable pour SAVDEV (10) (SAVDEV)

Indique une variable de 10 caractères destinée à recevoir le type d'unité utilisée pour la dernière sauvegarde de l'objet. En fonction de l'unité utilisée pour la dernière opération de sauvegarde, l'une des valeurs de variable suivantes est renvoyée :

• *SAVF pour un fichier sauvegarde.
• *DKT pour une disquette.
• *TAP pour une bande.
• *OPT pour un volume optique.
• Des blancs sont renvoyés si l'objet n'a pas été sauvegardé.

Variable pour SAVF (10) (SAVF)

Indique une variable de 10 caractères destinée à recevoir le nom du fichier sauvegarde dans lequel l'objet a été sauvegardé. Si l'objet n'a pas été sauvegardé dans un fichier sauvegarde, des blancs sont renvoyés.

Variable pour SAVFLIB (10) (SAVFLIB)

Indique une variable de 10 caractères destinée à recevoir le nom de la bibliothèque contenant le fichier sauvegarde dans lequel l'objet a été sauvegardé. Si l'objet n'est pas sauvegardé dans un fichier sauvegarde, des blancs sont renvoyés.

Variable pour SAVLABEL (17) (SAVLABEL)

Indique une variable de 17 caractères destinée à recevoir le label de fichier utilisé lors de la sauvegarde de l'objet. Si l'objet n'est pas sauvegardé sur bande, sur disquette ou sur un volume optique, des blancs sont renvoyés. La valeur renvoyée correspond à la valeur indiquée au paramètre LABEL dans la commande de sauvegarde de l'objet.

Variable pour SRCF (10) (SRCF)

Indique une variable de 10 caractères permettant de renvoyer le nom du fichier source qui a été utilisé pour créer l'objet. Si aucun fichier source n'a été utilisé pour créer l'objet, des blancs sont renvoyés. Pour les objets *PGM et *SRVPGM ILE, le fichier et le membre source sont à blanc. Les informations relatives au fichier source sont enregistrées dans l'objet *MODULE.

Variable pour SRCFLIB (10) (SRCFLIB)

Indique une variable de 10 caractères destinée à recevoir le nom de la bibliothèque contenant le fichier source qui a été utilisé pour créer l'objet. Si aucun fichier source n'est utilisé pour créer l'objet, des blancs sont renvoyés.

Variable pour SRCMBR (10) (SRCMBR)

Indique une variable de 10 caractères destinée à recevoir le nom du membre de fichier source (paramètre SRCF). Si aucun fichier source n'est utilisé pour créer l'objet, des blancs sont renvoyés.

Variable pour SRCDATE (13) (SRCDATE)

Indique une variable de 13 caractères destinée à recevoir la date et l'heure de dernière mise à jour du membre de fichier source. Cette valeur est renvoyée dans le même format que le paramètre CRTDATE ou, si le membre n'a pas été mis à jour, des blancs sont renvoyés.

Variable pour SYSLVL (9) (SYSLVL)

Indique une variable de 9 caractères destinée à recevoir le niveau de système d'exploitation en cours lors de la création de l'objet. La variable renvoyée comporte le niveau de version (3 caractères) à partir de la position 1, le niveau d'édition (3 caractères) à partir de la position 4 et le niveau de modification (3 caractères) à partir de la position 7. Le niveau de version commence toujours par la lettre 'V', le niveau d'édition par la lettre 'R' et le niveau de modification par la lettre 'M'.

Variable pour COMPILER (16) (COMPILER)

Indique une variable de 16 caractères destinée à recevoir l'identificateur de logiciel sous licence ainsi que le niveau de version, d'édition et de modification du compilateur. La variable renvoyée comporte l'identificateur de logiciel (7 caractères) à partir de la position 1, le niveau de version (3 caractères) à partir de la position 8, le niveau d'édition (3 caractères) à partir de la position 11 et le niveau de modification (3 caractères) à partir de la position 14. Le niveau de version commence toujours par la lettre 'V', le niveau d'édition par la lettre 'R' et le niveau de modification par la lettre 'M'. Si aucun compilateur n'a été utilisé, des blancs sont renvoyés.

Variable pour OBJLVL (8) (OBJLVL)

Indique une variable de 8 caractères destinée à recevoir le niveau de contrôle de l'objet créé.

Variable pour ALWAPICHG (1) (ALWAPICHG)

Indique une variable de 1 caractère permettant de renvoyer l'indicateur Modification par programme admise. Les valeurs suivantes peuvent être renvoyées :

'1'

L'objet peut être modifié à l'aide de l'API de modification de description d'objet (QLICOBJD).

'0'

L'objet ne peut pas être modifié via l'API.

Variable pour APICHG (1) (APICHG)

Indique une variable de 1 caractère permettant de renvoyer l'indicateur Modifié par programme. Les valeurs suivantes peuvent être renvoyées :

'1'

L'objet a été modifié à l'aide de l'API de modification de description d'objet (QLICOBJD).

'0'

L'objet n'a pas été modifié par l'API.

Variable pour USRCHG (1) (USRCHG)

Indique une variable de 1 caractère utilisée pour indiquer que l'objet a été modifié par l'utilisateur. Les valeurs suivantes peuvent être renvoyées :

'1'

L'objet a été modifié par l'utilisateur.

'0'

L'objet n'a pas été modifié par l'utilisateur.

Variable pour LICPGM (16) (LICPGM)

Indique une variable de 16 caractères destinée à recevoir le nom ainsi que le niveau de version, d'édition et de modification du logiciel sous licence dont l'objet extrait fait partie. La variable renvoyée comporte le nom (7 caractères) à partir de la position 1, le niveau de version (3 caractères) à partir de la position 8, le niveau d'édition (3 caractères) à partir de la position 11 et le niveau de modification (3 caractères) à partir de la position 14. Le niveau de version commence toujours par la lettre 'V', le niveau d'édition par la lettre 'R' et le niveau de modification par la lettre 'M'. Si l'objet extrait ne fait pas partie d'un logiciel sous licence, des blancs sont renvoyés.

Variable pour PTF (10) (PTF)

Indique une variable de 10 caractères destinée à recevoir le numéro de la PTF qui a donné lieu à la création de l'objet extrait. Pour les objets créés par l'utilisateur, des blancs sont renvoyés.

Variable pour APAR (10) (APAR)

Indique une variable de 10 caractères destinée à recevoir l'ID d'APAR. La variable renvoyée contient l'ID de l'APAR qui a entraîné la modification de l'objet. Si l'objet n'a pas été modifié suite à un APAR, des blancs sont renvoyés.

Cette zone n'est pas mise à jour lorsque des PTF (modifications provisoires du logiciel) fournies par IBM sont appliquées. Elle est modifiée dans les situations suivantes :

• La valeur par défaut d'une commande est modifiée à l'aide de la commande CHGCMDDFT (Modifier les valeurs par défaut d'une commande). La zone a pour définition CHGDFT.
• La valeur de cette zone peut être modifiée par l'API QLICOBJD (Modifier description d'objet).

Variable pour BLDID (16) (BLDID)

Indique une variable de 16 caractères permettant de renvoyer la valeur d'identificateur de compilation de l'objet. La zone renvoyée sera vide si aucun ID de compilation n'a été défini pour l'objet.

Cette zone est mise à jour dans les cas suivants :

• Cet identificateur est défini par des outils de contrôle du code source source.
• La valeur de cette zone peut être modifiée par l'API QLICOBJD (Modifier description d'objet).

Variable pour OBJAUD (10) (OBJAUD)

Indique une variable de 10 caractères permettant de renvoyer la valeur d'audit de l'objet. La valeur *NOTAVL est renvoyée si vous ne disposez pas du droit spécial *ALLOBJ ou *AUDIT. Les valeurs pouvant être renvoyées sont *NONE, *USRPRF, *CHANGE, *ALL et *NOTAVL. Pour plus d'informations, reportez-vous au paramètre Valeur d'audit d'objet (OBJAUD) de la commande CHGOBJAUD (Modifier l'audit d'objet).

Variable pour OBJSIG (1) (OBJSIG)

Variable de 1 caractère utilisée pour indiquer si l'objet possède une signature numérique. Les valeurs suivantes peuvent être renvoyées :

'1'

L'objet possède une signature numérique.

'0'

L'objet ne possède pas une signature numérique.

Variable pour SYSSIG (1) (SYSSIG)

Indique une variable de 1 caractère utilisée pour indiquer si l'objet est signé par une source sécurisée par le système. Les valeurs suivantes peuvent être renvoyées :

'1'

L'objet est signé par une source sécurisée par le système. Si l'objet possède plusieurs signatures, au moins une signature provient d'une source sécurisée par le système.

'0'

Aucune signature d'objet ne provient d'une source sécurisée par le système.

Variable pour MLTSIG (1) (MLTSIG)

Variable de 1 caractère utilisée pour indiquer si l'objet possède plus d'une signature numérique. Les valeurs suivantes peuvent être renvoyées :

'1'

L'objet possède plus d'une signature numérique. Si la valeur '1' est indiquée au paramètre SYSSIG, au moins une signature provient d'une source sécurisée par le système.

'0'

L'objet ne possède qu'une seule ou aucune signature numérique. Reportez-vous au paramètre OBJSIG pour savoir si l'objet possède une signature numérique.

Variable pour AUTCOLVAL (10) (AUTCOLVAL)

Indique une variable de 10 caractères permettant de renvoyer la valeur de collecte des droits de l'objet. La valeur *NONE est renvoyée si le type d'objet n'est pas pris en charge par la collecte des droits. Les valeurs spéciales suivantes peuvent être renvoyées :

*NONE

Aucune information sur les droits n'est collectée pour cet objet lorsque la collecte des droits pour les objets est active sur la partition.

*OBJINF

Les informations sur les droits sont collectées pour cet objet lorsque la collecte des droits pour les objets est active sur la partition. Les informations de vérification des droits sont collectées pour chaque instance unique des informations de niveau objet associées à la vérification des droits.

Variable pour JRNSTS (1) (JRNSTS)

Indique une variable de 1 caractère permettant de renvoyer l'état de journalisation en cours de l'objet. Les valeurs suivantes peuvent être renvoyées :

'1'

L'objet est en cours de journalisation.

'0'

L'objet n'est pas en cours de journalisation.

Remarque :D'autres zones du journal peuvent comporter des données, même si l'objet n'est pas en cours de journalisation.

Variable pour JRN (10) (JRN)

Indique une variable de 10 caractères permettant de renvoyer le nom du journal en cours ou du dernier journal utilisé. Si l'objet n'a jamais été journalisé, des blancs sont renvoyés.

Variable pour JRNLIB (10) (JRNLIB)

Indique une variable de 10 caractères permettant de renvoyer le nom de la bibliothèque qui contient le journal. Si l'objet n'a jamais été journalisé, des blancs sont renvoyés.

Variable pour JRNIMG (1) (JRNIMG)

Indique une variable de 1 caractère permettant de renvoyer les informations relatives aux images de journal. Les valeurs suivantes peuvent être renvoyées en fonction des images générées pour les modifications apportées à l'objet :

' '

Un blanc si la journalisation n'a jamais été lancée pour l'objet.

'0'

Seules des images après sont consignées dans le journal pour les modifications apportées à l'objet.

'1'

Des images avant ET après sont consignées dans le journal pour les modifications apportées à l'objet.

Variable pour JRNOMTE (1) (JRNOMTE)

Indique une variable de 1 caractère permettant de renvoyer les informations relatives aux postes de journal à omettre. Les valeurs suivantes peuvent être renvoyées :

' '

Un blanc si la journalisation n'a jamais été lancée pour l'objet.

'1'

Les opérations d'ouverture et de fermeture sur les objets indiqués ne génèrent aucun poste de journal de type ouverture ou fermeture.

'0'

Aucun poste de journal n'est omis.

Variable pour RMTJRNFTR (1) (RMTJRNFTR)

Variable de 1 caractère permettant de renvoyer la valeur de filtre de journal éloigné. La valeur renvoyée peut être l'une des suivantes :

' '

Un blanc si la journalisation n'a jamais été lancée pour l'objet.

'0'

Les postes de journal consignés pour l'objet ne seront pas admissibles pour un filtrage par objet du journal éloigné.

'1'

Les postes de journal consignés pour l'objet seront admissibles pour un filtrage par objet du journal éloigné.

Lors d'un filtrage par objet du journal éloigné, les postes du journal pour l'objet ne sont pas envoyés au système cible.

Pour plus de détails concernant le filtrage d'un journal éloigné, reportez-vous à la commande CHGRMTJRN (Modifier un journal éloigné) ou à l'API QjoChangeJournalState (Modification d'état de journal).

Variable pour JRNSTRDATE (13) (JRNSTRDATE)

Indique une variable de 13 caractères permettant de renvoyer la date et l'heure du dernier démarrage de la journalisation. Cette valeur est renvoyée dans le même format que le paramètre CRTDATE ou, si l'objet n'a jamais été journalisé, des blancs sont renvoyés.

Variable pour STRJRNRCV (10) (STRJRNRCV)

Variable de 10 caractères permettant de renvoyer le nom du récepteur de journal le plus ancien requis pour utiliser la commande APYJRNCHG ou RMVJRNCHG. Cette zone est à blanc si l'objet n'a jamais été journalisé.

Pour un objet fichier, le récepteur de journal contiendra le poste correspondant à l'opération démarrage de la sauvegarde. Toutefois, s'il existe des membres dans le fichier qui contiennent des transactions partielles, il se peut que ces membres nécessitent un récepteur de journal plus ancien. Utilisez la commande DSPFD pour déterminer l'état de transaction partielle des membres du fichier.

Variable pour JRNRCVLIB (10) (JRNRCVLIB)

Variable de 10 caractères permettant de renvoyer le nom de la bibliothèque contenant le récepteur de journal de début. Cette zone est à blanc si l'objet n'a jamais été journalisé.

Variable pour RCVLIBASP (10) (RCVLIBASP)

Variable de 10 caractères permettant de renvoyer le nom de l'unité ASP qui possède la mémoire allouée à la bibliothèque le récepteur de journal de début. Cette zone est à blanc si l'objet n'a jamais été journalisé. Les valeurs spéciales suivantes peuvent être renvoyées :

*N

Le nom de l'unité ASP ne peut pas être identifié.

*SYSBAS

La bibliothèque se trouve dans l'ASP système (ASP 1) ou l'ASP utilisateur de base (ASP 2-32).

Variable pour RCVLIBGRP (10) (RCVLIBGRP)

Variable de 10 caractères permettant de renvoyer le nom du groupe d'ASP qui possède la mémoire allouée à la bibliothèque contenant le récepteur de journal de début. Le nom de groupe d'ASP est le nom de l'ASP principal au sein du groupe d'ASP. La valeur renvoyée peut être identique à celle renvoyée pour le paramètre RCVLIBASP. Cette zone est à blanc si l'objet n'a jamais été journalisé. Les valeurs spéciales suivantes peuvent être renvoyées :

*N

Le nom de l'unité ASP ne peut pas être identifié.

*SYSBAS

La bibliothèque se trouve dans l'ASP système (ASP 1) ou l'ASP utilisateur de base (ASP 2-32).

Exemples

Catherine Durand entre la commande suivante pour créer une bibliothèque :

CRTLIB   LIB(PGMLIB)  TYPE(*PROD)
         TEXT('Bibliothèque des programmes de test')

Catherine ou une autre personne disposant des droits appropriés peut ensuite extraire les attributs de la bibliothèque dans un programme CL, comme indiqué ci-dessous :

DCL   &CRTDATE   *CHAR  13
DCL   &OWN       *CHAR  10
DCL   &RTNLIB    *CHAR  10
DCL   &OBJASPDEV *CHAR  10
 :
RTVOBJD   OBJ(*LIBL/PGMLIB) OBJTYPE(*LIB) TEXT(&TEXT)  +
          CRTDATE(&CRTDATE) OWNER(&OWN)                +
          RTNLIB(&RTNLIB) OBJASPDEV(&OBJASPDEV)

Les valeurs renvoyées dans les variables du programme CL sont présentées ci-après :

&TEXT      =  Bibliothèque des programmes de test
&CRTDATE   =  0900211130000
&OWN       =  CDURAND
&RTNLIB    =  QSYS
&OBJASPDEV =  *SYSBAS

La valeur renvoyée dans la variable &CRTDATE indique que PGMLIB a été créée le onzième jour du mois de février 1990 à 13 heures. La valeur renvoyée dans la variable &OWN indique que la bibliothèque a été créée par le profil utilisateur CDURAND. La valeur renvoyée dans la variable &RTNLIB indique que PGMLIB figure dans la bibliothèque QSYS. La valeur renvoyée dans la variable &OBJASPDEV indique une allocation de mémoire pour PGMLIB à partir de *SYSBAS qui inclut le pool de mémoire secondaire système (ASP 1) et tous les ASP utilisateur de base définis (ASP 2-32).

Messages d'erreur

Messages *ESCAPE

CPFB8ED

La description d'unité &1 est incorrecte pour l'opération.

CPF2115

Objet &1 de &2 type *&3 endommagé.

CPF2150

Erreur dans la fonction d'informations sur objet.

CPF2151

Erreur de l'opération sur &2 de &1 type *&3.

CPF2173

Valeur pour ASPDEV incorrecte avec valeur spéciale pour bibliothèque.

CPF218C

&1 n'est pas un ASP principal ou secondaire.

CPF218D

&1 n'est pas un ASP principal alors que *ASPGRP est indiqué.

CPF2451

File d'attente de messages &1 allouée à un autre travail.

CPF3202

Fichier &1 de &2 en cours d'utilisation.

CPF3203

Allocation de l'objet impossible pour le fichier &1 de &2.

CPF36F7

La file d'attente de messages QSYSOPR est allouée à un autre travail. Message queue QSYSOPR is allocated to another job.

CPF980B

Objet &1 de bibliothèque &2 indisponible.

CPF9801

Objet &2 non trouvé dans la bibliothèque &3.

CPF9802

Non autorisé à l'objet &2 de &3.

CPF9803

Impossible d'allouer l'objet &2 de la bibliothèque &3.

CPF9807

Une ou plusieurs bibliothèques de la liste ont été supprimées.

CPF9808

Allocation impossible pour une ou plusieurs bibliothèques de la liste.

CPF9810

Bibliothèque &1 non trouvée.

CPF9811

Programme &1 non trouvé dans la bibliothèque &2.

CPF9812

Fichier &1 non trouvé dans la bibliothèque &2.

CPF9814

Unité &1 non trouvée.

CPF9820

Non autorisé à utiliser la bibliothèque &1.

CPF9821

Non autorisé au programme &1 de &2.

CPF9822

Non autorisé au fichier &1 de &2.

CPF9825

Accès non autorisé à l'unité &1.

CPF9830

Allocation de la bibliothèque &1 impossible.

CPF9831

Allocation de l'unité &1 impossible.

CPF9833

*CURASPGRP ou *ASPGRPPRI indiqué et unité d'exécution en cours sans groupe d'ASP.