STROBJCVN

La commande Démarrer conversion d'objet (STROBJCVN) convertit des objets utilisateur ou vérifie les objets qui nécessitent une conversion. Les objets sont convertis du format utilisé dans la version, l'édition et le niveau de modification précédents du système d'exploitation au format requis par la version, l'édition et le niveau de modification actuels du système d'exploitation.

Les types d'objet ci-dessous dans les bibliothèques sont convertis ou vérifiés par cette commande :

• Programmes OPM et ILE
• Programmes de service
• Modules

Les données SQL sont converties ou vérifiées par cette commande. Les objets des programmes, programmes de service et modules SQL (*SQLPKG) peuvent contenir des instructions SQL et des données pour les procédures stockées externes. Notez que la conversion des données SQL contenues dans un objet de programme est géré séparément de la conversion du programme.

Les types d'objet ci-dessous dans les répertoires sont convertis ou vérifiés par cette commande :

• Fichiers STREAM avec des programmes Java qui ont été créés pour exécuter iSeries. Seuls les fichiers STREAM situés à la "racine" (/), QOpenSys et les systèmes de fichiers utilisateur (UDFS) sont inclus.

Les objets utilisateur qui ne sont pas convertis à l'aide de cette commande le sont automatiquement lorsqu'ils sont utilisés pour la première fois.

Remarque :L'utilisation d'objets qui ne sont pas encore convertis peut diminuer les performances lors de l'opération de conversion.

Remarque :Le plus souvent, les objets analysés par ANZOBJCVN (Analyser la conversion des objets) peuvent être convertis par la commande STROBJCVN ou lors du premier accès. Cependant, la commande STROBJCVN ne convertit pas les répertoires concernés par les nouveaux caractères Unicode et les règles de casse dans l'édition cible car cette conversion est effectuée automatiquement par le système d'exploitation lorsque cela est nécessaire. Les fichiers spoule ne sont pas convertis par la commande STROBJCVN. La conversion est effectuée automatiquement par le système d'exploitation lorsque cela est nécessaire.

Restrictions :

• Les pools de mémoire principaux ou secondaires (ASP 33-255) référencés par cette commande doivent être variés et posséder le statut 'Disponible' avant que cette commande soit exécutée.
• Les systèmes de fichiers utilisateur référencés par cette commande doivent être montés avant d'exécuter cette commande.
• Les objets qui se trouvent dans un système de fichiers utilisateur en 'lecture seule' ne sont pas convertis.
• Vous devez disposer du droit spécial (*ALLOBJ) pour exécuter cette commande.
• L'exécution de cette commande peut être très longue. Aussi est-il suggéré d'exécuter cette commande dans le cadre d'un travail par lots.

Paramètres

Option (OPTION)

Spécifie si la conversion est effectuée ou si des objets sont vérifiés pour déterminer si la conversion est nécessaire.

*CONVERT

Les objets spécifiés dans les paramètres Bibliothèque (LIB) et Objet (OBJ) sont convertis au format requis par la version, l'édition et le niveau de modification actuels du système d'exploitation.

*CHECK

Les objets spécifiés dans les paramètres LIB et OBJ sont vérifiés pour déterminer s'ils doivent être convertis. Les messages sont envoyés à l'historique de travail, qui inclut le nombre d'objets déjà convertis et le nombre d'objets qu'il reste à convertir.

Bibliothèque (LIB)

Spécifie la bibliothèque utilisateur pour laquelle les objets doivent être vérifiés ou convertis au format requis par la version, l'édition et le niveau de modification actuels du système d'exploitation.

*ALLUSR

Toutes les bibliothèques utilisateur sont sélectionnées. Toutes les bibliothèques avec un nom qui ne commence pas par la lettre Q sont sélectionnées à l'exception des bibliothèques suivantes :

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

Bien que les bibliothèques Qxxx énumérées ci-après sont fournies par IBM, elles contiennent principalement des données utilisateur modifiées fréquemment. Par conséquent, elles sont considérées comme des bibliothèques utilisateur et sont également sélectionné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 sélectionnée. Vous pouvez spécifier LIB(*NONE) si vous ne souhaitez convertir ou vérifier que les objets qui se trouvent dans des répertoires.

nom

Spécifie le nom de la bibliothèque utilisateur dont les objets doivent être vérifiés ou convertis.

Type d'objet (OBJTYPE)

Spécifie les types d'objet de la bibliothèque qui doivent être convertis.

Si *CHECK est spécifié pour le paramètre OPTION, la spécification de ce paramètre est ignorée.

Si *NONE est spécifié pour le paramètre LIB (Bibliothèque), la spécification de ce paramètre est ignorée.

*ALL

Tous les objets de programme (*PGM), de programme de service (*SRVPGM), de module (*MODULE) et de fichier de base de données (*FILE) dans la bibliothèque spécifiée sont convertis. De plus, les informations SQL stockées dans tous les objets *PGM, *SRVPGM et *SQLPKG qui contiennent des instructions SQL ainsi que des objets *PGM et *SRVPGM utilisés pour mettre en oeuvre des procédures stockées sont convertis.

*FILE

Seuls les objets du membre de fichier de base de données contenus dans la bibliothèque spécifiée sont convertis.

*ALLPGM

Tous les objets de programme (*PGM) et de programme de service (*SRVPGM) dans la bibliothèque spécifiée sont convertis.

*SQL

Les informations SQL stockées dans tous les objets *PGM, *SRVPGM et *SQLPKG qui contiennent des instructions SQL, ainsi que les objets *PGM et *SRVPGM utilisés pour mettre en oeuvre des procédures stockées externes sont convertis.

Unité ASP (ASPDEV)

Spécifie l'unité de pool de mémoire secondaire (ASP) sur laquelle le stockage est autorisé pour la bibliothèque à vérifier ou à convertir. Si la bibliothèque se trouve dans un ASP qui ne fait pas partie de l'espace de noms de la bibliothèque de l'unité d'exécution, ce paramètre doit être spécifié pour vous assurer que la bibliothèque appropriée est vérifiée ou convertie.

Remarque :Ce paramètre ne s'applique pas pour les objets spécifiés dans le paramètre OBJ car le nom de l'ASP indépendant fait partie du chemin d'accès à l'objet.

*

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

Objet (OBJ)

Spécifie le chemin d'accès de l'objet ou d'un canevas pour faire correspondre le nom des objets à vérifier ou à convertir.

Le chemin d'accès des objets peut être un nom simple ou un nom qualifié avec le nom du répertoire dans lequel l'objet se trouve. Une canevas peut être spécifié dans la dernière partie du chemin d'accès. Un astérisque (*) correspond à un nombre quelconque de caractères et un point d'interrogation (?) correspond à un seul caractère. Si le chemin d'accès est qualifié ou s'il contient un canevas, il doit être placé entre guillemets simples.

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 chemin d'accès est un lien symbolique, l'objet du lien symbolique est vérifié ou converti, mais l'objet désigné par le lien symbolique n'est pas vérifié ou converti.

*NONE

Aucun objet n'est sélectionné. Vous pouvez spécifier OBJ(*NONE) si vous ne souhaitez convertir ou vérifier que des objets qui se trouvent dans des bibliothèques.

nom-chemin

Spécifiez le chemin d'accès de l'objet à vérifier ou à convertir.

Branche du répertoire (SUBTREE)

Spécifie si les objets dans la sous-arborescence doivent être vérifiés ou convertis si l'objet spécifié par le paramètre Objet (OBJ) est un répertoire.

*ALL

Les objets spécifiés par le paramètre OBJ sont vérifiés ou convertis, si cela est approprié. Si l'objet est un sous-répertoire, son contenu ainsi que le contenu de tous ses sous-répertoires sont vérifiés ou convertis.

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.

*NONE

Les objets spécifiés par le paramètre OBJ sont vérifiés ou convertis, si cela est approprié. Si l'objet est un répertoire, il est vérifié ou converti si cela est approprié.

Exemples

Exemple 1 : démarrage de la conversion de tous les objets dans une bibliothèque

STROBJCVN   OPTION(*CONVERT)  LIB(LIB1)  OBJ(*NONE)

Cette commande permet de convertir l'intégralité des programmes OPM et ILE, des programmes de service, des modules et des fichiers base de données physiques et logiques d'origine contenus dans la bibliothèque utilisateur LIB1 au format requis par l'édition actuelle du système d'exploitation.

De plus, les informations SQL stockées dans tous les objets *PGM, *SRVPGM et *SQLPKG qui contiennent des instructions SQL, ainsi que des objets *PGM et *SRVPGM utilisés pour mettre en oeuvre des procédures stockées externes, sont converties au format requis par l'édition actuelle du système d'exploitation.

Aucun objet des répertoires n'est converti.

Exemple 2 : démarrage de la conversion d'objets SQL

STROBJCVN   OPTION(*CONVERT)  LIB(LIB2)  OBJTYPE(*SQL)

Cette commande permet de convertir les informations SQL stockées dans tous les objets *PGM, *SRVPGM et *SQLPKG de la bibliothèque LIB2 contenant des instructions SQL ainsi que les objets *PGM et *SRVPGM de la bibliothèque LIB2 utilisés pour mettre en oeuvre des procédures stockées externes au format requis par l'édition actuelle du système d'exploitation.

Exemple 3 : démarrage de la conversion de tous les programmes

STROBJCVN   OPTION(*CONVERT)  LIB(*ALLUSR)  OBJTYPE(*ALLPGM)
            ASPDEV(*ALLAVL)  OBJ('/')  SUBTREE(*ALL)

Cette commande convertit tous les objets de programme OPM et ILE (*PGM) et de programme de service (*SRVPGM) dans toutes les bibliothèques utilisateur sur tous les pools de stockage auxiliaires disponibles, y compris l'ASP du système, tous les ASP utilisateur de base définis et tous les ASP indépendant principaux et secondaires.

De plus, tous les programmes Java situés dans le système de fichiers à la "racine" (/) (le répertoire '/', son contenu et le contenu de tous ses sous-répertoires) sont convertis.

En fonction du nombre de bibliothèques utilisateur et du nombre de répertoires sur le système, l'exécution de cette commande peut être très longue.

Exemple 4 : vérification du nombre d'objets de la bibliothèque à convertir

STROBJCVN   OPTION(*CHECK)  LIB(LIB1)  OBJ(*NONE)

Cette commande vérifie tous les programmes OPM et ILE, programmes de service et modules de la bibliothèque LIB1. Un message de réussite est envoyé. Il inclut le nombre total d'objets qui ont été vérifiés, le nombre d'objets qui ont déjà été convertis et le nombre d'objets qui doivent encore être convertis au format requis par l'édition actuelle du système d'exploitation.

Exemple 5 : démarrage de la conversion d'un répertoire spécifique

STROBJCVN   OPTION(*CONVERT)  LIB(*NONE)  OBJ('/MYDIR')  SUBTREE(*ALL)

Cette commande convertit tous les programmes Java dans le répertoire /MYDIR, son contenu, ainsi que le contenu de tous ses sous-répertoires sont analysés.

Messages d'erreur

Messages *ESCAPE

CPF218C

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

CPF9833

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

CPFB0E1

Les objets n'ont pas tous été vérifiés.

CPFB0E2

Les objets n'ont pas tous été convertis.