ANZOBJCVN

La commande Analyser conversion de l'objet (ANZOBJCVN) collecte ou crée des rapports sur les informations des objets utilisateur sur le système. Elle permet de planifier la conversion des objets utilisateur dans une nouvelle édition du système d'exploitation i5/OS.

Les types d'objets de bibliothèques faisant l'objet d'une analyse et d'un rapport sont les suivants :

• Programmes OPM et ILE
• Programmes de service
• Modules
• Modules SQL

Les types d'objets de répertoires faisant l'objet d'une analyse et d'un rapport sont les suivants :

• Fichiers STREAM associés à des programmes Java optimisés pour être exécutés dans le système d'exploitation i5/OS. Seuls les fichiers STREAM présents dans les systèmes de fichiers "root" (/), QOpenSys ou définis par l'utilisateur sont analysés.
• Noms d'objets du système de fichiers intégré dans le système de fichiers "root" (/), ainsi que les systèmes de fichiers définis par l'utilisateur et créés avec l'option CASE(*MONO).

Cette commande détermine le nombre total de fichiers spoule présents sur chaque ASP à convertir et le temps prévu pour la conversion. La collecte peut être activée ou désactivée avec le paramètre Vérifier les fichiers spoule (SPLFILE).

Les informations analysées et objet d'un rapport sont :

• Nom d'objet
• Type d'objet
• Niveau du système (l'édition du système d'exploitation utilisé pendant la création de l'objet utilisateur).
• Données de création (indiquent si un objet possède toutes les données nécessaires à sa conversion dans la nouvelle édition du système d'exploitation).
• Signature numérique (indique si un objet possède une signature numérique. La conversion d'un objet de programme efface les signatures numériques liées à l'objet).
• Profilage (indique si un objet a des données de profilage. Si un objet a des données de profilage et que celles qui sont encapsulées ont été supprimées, le programme perd ses données de profilage pendant la conversion de l'objet de programme).
• Etat (indique l'état en cours d'un objet utilisateur. L'état en cours des objets définis sur *SYSTEM ou *INHERIT est modifié en *USER pendant la conversion de l'objet de programme).
• Temps de conversion estimé (indique le temps de conversion estimé pour l'objet. Les estimations sont calculées en secondes. Si l'objet ne peut pas être converti, le temps estimé est alors 0).

  Remarque :Les références au temps de conversion dans le rapport récapitulatif et l'état détaillé de l'objet ne tiennent pas compte du temps de conversion du mappage des casses, car le système d'exploitation l'exécute automatiquement.

• Le nom de l'objet contient au moins un caractère affecté par les nouveaux caractères Unicode et les règles de casse dans l'édition cible. Cet objet pourrait être renommé dans l'édition cible pendant la conversion automatique des répertoires pour les nouveaux caractères Unicode et les règles de casse.

Remarque :Dans la plupart des cas, les objets analysés par ANZOBJCVN peuvent être convertis via la commande STROBJCVN (Démarrer la conversion de l'objet) ou à la première action du système après une mise à niveau du logiciel. Cependant, STROBJCVN ne convertit pas les répertoires de façon à prendre en charge les nouveaux caractères Unicode et les règles de casse, puisque le système d'exploitation effectue automatiquement cette conversion. STROBJCVN ne convertit pas les membres de la base de données spoule : cette conversion est faite automatiquement en fonction de l'existence de la zone de données QSPL/QSPLDFRCVN. Par défaut, tous les fichiers spoule stockés dans le pool de mémoire secondaire (ASP) et tous les ASP utilisateur classiques sont convertis pendant l'IPL ou pendant la mise en fonction d'un ASP indépendant pour les fichiers stockés dans un ASP principal ou secondaire si la zone de données QSPL/QSPLDFRCVN n'existe pas après ASP.

Restrictions :

• Vous devez disposer des droits spéciaux *ALLOBJ pour exécuter cette commande.
• L'exécution de cette commande, particulièrement l'étape *COLLECT, peut être très longue. C'est la raison pour laquelle nous vous suggérons d'exécuter cette commande dans un travail par lots.
• Avant d'exécuter cette commande, tous les ASP principaux ou secondaires indépendants (ASP 33 à 255) utilisés par la commande doivent être mis en fonction et posséder le statut 'Disponible'.
• Avant d'exécuter cette commande, les systèmes de fichiers définis par l'utilisateur et utilisés par la commande doivent être montés.
• Cette commande ne peut être exécutée que de deux manières :
  • En ayant un seul travail actif, ANZOBJCVN gérant simultanément les bibliothèques et les répertoires.
  • En ayant deux travaux actifs exécutant ANZOBJCVN simultanément : un travail exécutant ANZOBJCVN uniquement pour les bibliothèque, l'autre l'exécutant uniquement pour les répertoires.
• Si la bibliothèque QUSRSYS est supprimée après que les informations ont été collectées avec ANZOBJCVN, les informations sont perdues.

Paramètres

Option (OPTION)

Indique si vous souhaitez collecter des informations ou générer des rapports à l'aide des informations collectées.

Ce paramètre est obligatoire.

*COLLECT

Les informations sur les objets des bibliothèques et des répertoires indiqués sont collectées pour analyse. Si SPLFILE est défini sur *YES, les informations sur les membres de la base de données spoule sont collectées lors de la collecte des bibliothèques.

*REPORT

Les informations collectées sur les objets sont analysées et des rapports générés pour les objets des bibliothèques et des répertoires indiqués ainsi que pour les fichiers spoule.

Type de rapport (RPTTYPE)

Indique le type des rapports d'objets à générer. Les rapports sont écrits dans le fichier imprimante QPIZARPT.

Si *COLLECT est indiqué pour le paramètre Option (OPTION), la valeur indiquée pour le paramètre est ignorée.

Valeurs particulières

*ALL

Le rapport récapitulatif et l'état détaillé de l'objet sont créés pour tous les objets des bibliothèques et répertoires indiqués dans la collecte précédente. Si SPLFILE était défini sur *YES lors de la dernière collecte, les informations sur les membres de la base de données spoule seront présentes dans le rapport Récapitulatif de la bibliothèque.

Autres valeurs (jusqu'à 4 répétitions)

*LIBSUM

Un rapport récapitulatif est généré pour chaque bibliothèque indiquée dans la dernière collecte. Si SPLFILE(*YES) a été indiqué, les informations sur les membres de la base de données sont présentes dans ce rapport.

*LIBDTL

Un état détaillé est généré pour chaque bibliothèque indiquée dans la dernière collecte.

*OBJSUM

Un état récapitulatif est généré pour les objets du système de fichier intégré indiqués dans la dernière collecte.

*OBJDTL

Un rapport détaillé est généré pour les objets du système de fichier intégré spécifiés dans la dernière collecte.

Bibliothèques à analyser (LIB)Libraries to analyze (LIB)

Indique les bibliothèques à analyser.

Si *REPORT est spécifié pour le paramètre Option (OPTION), ce paramètre spécifié est ignoré.

*ALLUSR

Toutes les bibliothèques utilisateur sont analysées. Toutes les bibliothèques dont le nom ne commence pas par la lettre Q sont analysées, à l'exception des éléments suivants :

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur fréquemment mises à jour. C'est pourquoi elles sont considérées comme des bibliothèques utilisateur et sont par conséquent analysées :

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

1. 'xxxxx' représente le numéro de l'ASP principal.
2. L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.

*NONE

Aucune bibliothèque utilisateur n'est analysée. Vous pouvez définir LIB(*NONE) si vous ne voulez analyser que les objets qui se trouvent dans les répertoires.

nom-générique

Indique le nom générique des bibliothèques à analyser. Un nom générique est une chaîne comportant un ou plusieurs caractères suivis d'un astérisque (*). Si un nom générique est spécifié, toutes les bibliothèques ayant le même préfixe que le nom générique sont analysées.

nom

Indique le nom de la bibliothèque utilisateur dont les objets sont à analyser.

Unité ASP (ASPDEV)

Indique l'unité ASP contenant la mémoire attribuée à la bibliothèque et aux fichiers spoule à analyser. Si la bibliothèque est située dans un ASP qui ne fait pas partie du nom d'espace de bibliothèque de l'unité d'exécution, ce paramètre doit être indiqué pour être sûr que la bibliothèque analysée est correcte.

Remarque :Ce paramètre ne s'applique pas aux objets spécifiés dans le paramètre OBJ puisque le nom de l'ASP indépendant fait partie du nom de chemin de l'objet.

Si *REPORT est spécifié pour le paramètre Option (OPTION), ce paramètre spécifié est ignoré.

*

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.

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

Vérifier les fichiers spoule (SPLFILE)

Indique si le nombre total de fichiers spoule de chaque pool de mémoire secondaire (ASP) doit être analysé et le temps prévu pour effectuer cette conversion.

Il n'est par ailleurs pas possible de définir LIB(*NONE) si SPLFILE(*YES) est indiqué.

*YES

Les fichiers spoule de chaque pool de mémoire secondaire (ASP) sont analysés.

*NO

Les fichiers spoule de chaque pool de mémoire secondaire (ASP) ne sont pas analysés.

Remarque :L'unité ASP sélectionnée (ASPDEV) affecte la collecte des fichiers spoule.

Objet (OBJ)

Indique le nom de chemin de l'objet ou un masque correspond aux objets à analyser.

Si *REPORT est spécifié pour le paramètre Option (OPTION), ce paramètre spécifié est ignoré.

Le nom du chemin d'accès à l'objet peut être un nom simple ou un nom associé au nom du répertoire dans lequel se trouve l'objet. Il est possible d'indiquer un masque dans la dernière partie du nom de chemin. Un astérisque (*) peut remplacer plusieurs caractères tandis qu'un point d'interrogation (?) peut remplacer un caractère unique. Si le nom de chemin est défini complètement ou comprend un masque, il doit être entouré par des apostrophes.

Pour obtenir de plus amples informations relatives à la spécification des noms de chemin, reportez-vous à "Object naming rules" dans la rubrique Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Remarque :Si le dernier composant du nom de chemin est un lien symbolique, l'objet du lien symbolique est analysé mais l'objet pointé par le lien symbolique ne l'est pas.

*NONE

Aucun objet n'est analysé.

nom-chemin

Indique le nom de chemin de l'objet à analyser.

Branche du répertoire (SUBTREE)

Indique si les objets de la branche doivent être analysés quand l'objet indiqué par le paramètre Objet (OBJ) est un répertoire.

Si *REPORT est spécifié pour le paramètre Option (OPTION), ce paramètre spécifié est ignoré.

*ALL

Le cas échéant, les objets indiqués par OBJ sont analysés. Si l'objet est un répertoire, son contenu ainsi que celui de ses sous-répertoires sont analysés.

Remarque :Le critère de concordance avec le paramètre OBJ ne s'applique qu'aux objets de premier niveau. Si l'objet de premier niveau est un répertoire, le critère de concordance ne s'applique pas à son contenu ni au contenu de ses sous-répertoires.

*NONE

Le cas échéant, les objets indiqués par OBJ sont analysés. Si l'objet est un répertoire, il est analysé le cas échéant mais son contenu ne l'est pas.

Une fois que la commande a commencé à traiter une branche d'un répertoire spécifique, les objets localisés et traités peuvent être affectés par les opérations qui mettent à jour l'organisation des objets dans l'arborescence de répertoire spécifiée. Cela inclut, sans caractère limitatif, les éléments suivants :

• Ajout, suppression ou nouvelle dénomination des liens d'objet
• Montage ou démontage des systèmes de fichiers
• Mise à jour du répertoire racine effectif pour le processus qui appelle la commande
• Mise à jour du contenu d'un lien symbolique

Pour traiter la branche du répertoire, le code du système peut augmenter le nombre maximal de descripteurs de fichier, dans la portée du processus, qui peuvent être ouverts lors du traitement. Cette opération est effectuée afin que la commande ne soit pas susceptible d'échouer en raison d'un manque de descripteurs. Cette valeur maximale de portée de processus n'est pas réinitialisée à la fin de la commande.

Edition cible (TGTRLS)

Indique l'édition vers laquelle les données et les programmes seront migrés. Ces informations permettent de déterminer l'analyse à effectuer. Celle-ci dépend de l'édition sur laquelle la commande est exécutée.

Si *REPORT est spécifié pour le paramètre Option (OPTION), ce paramètre spécifié est ignoré.

VxRyMz

Indique l'édition vers laquelle les données et les programmes seront migrés.

Exemples

Exemple 1 : Collecte des informations sur une bibliothèque

ANZOBJCVN   OPTION(*COLLECT)

Cette commande collecte les informations de conversion d'objet pour tous les objets de l'ensemble des bibliothèques utilisateur de l'ASP, tous les ASP utilisateur et tous les ASP indépendants qui ont été mis en fonction et sont à l'état 'Disponible'. Si la bibliothèque est située dans un ASP qui ne fait pas partie du nom d'espace de bibliothèque de l'unité d'exécution, vous devez indiquer le paramètre ASPDEV pour être sûr que la bibliothèque souhaitée soit analysée. Aucune information n'est collectée pour les répertoires.

Exemple 2 : Génération de rapports concernant les informations sur une bibliothèque

ANZOBJCVN   OPTION(*REPORT) RPTTYPE(*LIBSUM *LIBDTL)

Cette commande permet de générer des rapports sur les informations de la bibliothèque qui ont été collectées auparavant : un rapport récapitulatif et un état détaillé sur la bibliothèque.

Exemple 3 : Collecte d'informations sur un objet dans des répertoires

ANZOBJCVN   OPTION(*COLLECT)  LIB(*NONE)
            OBJ('/MYDIR/MYDOCS')  SUBTREE(*ALL)

Cette commande permet de collecter les informations sur la conversion d'un objet pour le répertoire /MYDIR/MYDOCS. Son contenu ainsi que celui de ses sous-répertoires seront analysés. Aucune information n'est collectée pour les objets des bibliothèques.

Exemple 4 : Génération d'un état détaillé sur un objet

ANZOBJCVN   OPTION(*REPORT)  RPTTYPE(*OBJDTL)

Cette commande permet de générer des rapports concernant les informations sur les objets collectées auparavant dans les répertoires. Un état détaillé sur l'objet est généré.

Exemple 5 : Collecte d'informations sur une bibliothèque et d'informations sur un répertoire

ANZOBJCVN OPTION(*COLLECT) LIB(MYLIB) SPLFILE(*NO)
          OBJ('/MYDIR') SUBTREE(*ALL)

Cette commande collecte les informations de conversion d'objet de la bibliothèque MYLIB et du répertoire /MYDIR ; son contenu et celui de ses sous-répertoires est analysé. Aucune information sur les membres de la base de données spoule n'est collectée.

Messages d'erreur

*ESCAPE Messages

CPF218C

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

CPF222E

Le droit spécial &1 est requis.

CPF9810

Bibliothèque &1 non trouvée.

CPF9833

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

CPFB0DC

ANZOBJCVN OPTION (*REPORT) a échoué.

CPFB0DE

Tous les objets admissibles n'ont pas été analysés.

CPFB0DF

ANZOBJCVN a trouvé des objets verrouillés dans QUSRSYS.