RCLDBXREF

La commande RCLDBXREF permet de récupérer les données du catalogue de références croisées de la base de données pour une bibliothèque spécifique. Cette commande fournit un sous-ensemble de la fonction associée à la commande RCLSTG permettant de récupérer les données du catalogue de références croisées de la base de données pour le système en indiquant SELECT(*DBXREF). Ces deux commandes diffèrent par le fait que la commande RCLDBXREF ne nécessite pas que le système soit à l'état restreint et qu'elle prend en charge la récupération non pas de toutes les bibliothèques d'un système mais d'une bibliothèque spécifique.

En outre, cette commande fournit une interface utilisateur permettant de déterminer les catalogues comportant des incohérences et les bibliothèques concernées.

Si un groupe d'ASP a été défini pour l'unité d'exécution en cours, cette commande s'applique aux ASP indépendants de ce groupe d'ASP et également aux ASP utilisateur de base et système (ASP 1 à 32).

Vous ne devez utiliser cette commande que lorsque des incidents se produisent au niveau des catalogues de références croisées de base de données. En outre, RCLSTG SELECT(*DBXREF) n'est pas une option répondant à des besoins métier critiques.

Dans la mesure où il n'est pas nécessaire que le système soit à l'état restreint pour l'exécution de cette commande, il se peut que celle-ci ne soit pas toujours en mesure de récupérer les informations de référence croisée. Dans certains cas, vous devrez peut-être exécuter la commande RCLSTG SELECT(*DBXREF).

Dans ce cas, vous ne devez pas permettre aux applications d'utiliser ou de modifier les objets d'une bibliothèque en cours de récupération. Sinon, il se peut que des résultats inattendus soient générés.

Si la commande RCLDBXREF ne permet pas de remédier à cet incident, il se peut que la bibliothèque en cours de récupération comporte d'autres incohérences que celles qui existaient avant l'utilisation de cette commande. Dans ce cas, vous devrez exécuter la commande RCLSTG SELECT(*DBXREF).

Restrictions :

• Pour utiliser cette commande, vous devez disposer du droit spécial *ALLOBJ.

Paramètres

Option (OPTION)

Indique l'action qui sera effectuée par cette commande. La commande peut soit rechercher des incidents, soit tenter de les résoudre.

*CHECK

La commande recherche des incohérences de catalogue de références croisées. Chaque catalogue est vérifié et un message de diagnostic (CPD32A7) est envoyé dans l'historique du travail pour chaque bibliothèque comportant des données incohérentes dans ce catalogue. Une fois tous les catalogues de références croisées vérifiés, un message d'arrêt programme (CPF32AC) est émis si des incidents ont été détectés. Si aucune incohérence n'a été détectée, un message d'achèvement (CPC32AC) est envoyé pour indiquer que les données de référence croisée semblent correctes.

*FIX

La commande tente de résoudre les données de référence croisée pour la biblio. indiquée au paramètre Bibliothèque (LIB).

Remarque :Dans certains cas, le système peut déterminer qu'une récupération complète des catalogues de références croisées de base de données est nécessaire avec la commande RCLSTG SELECT(*DBXREF). Un message d'arrêt programme CPF32AB est alors envoyé et les données de réf. croisée de la biblio. ne sont pas résolues.

Quand l'option *FIX est indiquée, l'utilisateur ne doit pas interrompre le processus de récupération ni tenter d'utiliser ou modifier les objets d'une bibliothèque en cours de récupération. Sinon, l'opération de récupération peut échouer. Le cas échéant, il se peut que cette bibliothèque comporte plus d'incohérences qu'avant l'appel de cette commande. Vous pouvez procéder à une opération de récupération en relançant la commande. Si l'incident persiste, vous devez exécuter la commande DBXREF (RCLSTG SELECT(*DBXREF)).

Bibliothèque (LIB)

Indique la bibliothèque à récupérer.

Remarque :Ce paramètre n'est admis que lorsque l'option *FIX est spécifiée au paramètre OPTION ( Option).

*ERR

La récupération sera tentée pour toutes les bibliothèques dont les catalogues de références croisées comportent des erreurs. La commande va tenter de récupérer toutes les données de référence croisée pour les bibliothèques ayant été identifiées comme comportant des données incohérentes à l'issue de la précédente exécution de la commande RCLDBXREF avec OPTION(*CHECK).

nom

Indiquez le nom de la bibliothèque dont les données de référence croisée seront résolues. Toutes les données de référence croisée pour la bibliothèque indiquée seront récupérées, même si celle-ci n'est pas identifiée comme comportant des catalogues avec des données incohérentes. La bibliothèque n'a pas besoin d'exister pour être indiquée dans cette commande.

Exemples

Exemple 1 : Recherche d'incidents au niveau des références croisées

RCLDBXREF   OPTION(*CHECK)

Cette commande recherche d'éventuelles erreurs dans les catalogues de références croisées.

Exemple 2 : Récupération des catalogues de références croisées

RCLDBXREF   OPTION(*FIX)  LIB(*ERR)

Cette commande permet de récupérer les informations de référence croisée pour toutes les bibliothèques identifiées comme comportant des erreurs.

Exemple 3 : Récupération des données de catalogue de références croisées pour une bibliothèque

RCLDBXREF   OPTION(*FIX)  LIB(ABCD)

Cette commande permet de récupérer les informations de référence croisée pour la bibliothèque ABCD.

Messages d'erreur

*ESCAPE Messages

CPF32AB

Informations de référence croisée de base de données non récupérées.

CPF32AC

Incident(s) de référence croisée de base de données.

CPF32A4

Erreur interne dans le programme de références croisées du système.