Aller au contenu

WRKCMTDFN

Gérer définitions validation

En bref

La commande WRKCMTDFN permet de gérer les définitions de validation du système.

WRKCMTDFN se lit WRK (Gérer) + CMTDFN. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

WRKCMTDFN

Paramètres

Astuce : dans une session 5250, tapez WRKCMTDFN 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 : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande WRKCMTDFN permet de gérer les définitions de validation du système. Une définition de validation est utilisée pour stocker les informations relatives au contrôle de validation lors du démarrage de ce dernier à l'aide de la commande STRCMTCTL. Ces définitions de validation peuvent être associées ou non à un travail actif. Dans ce dernier cas, les définitions sont arrêtées mais une ou plusieurs de leurs unités d'oeuvre logiques n'ont pas encore abouti.

Le paramètre STATUS permet d'obtenir une sous-liste des définitions de validation en fonction de leur état. Par exemple, une valeur d'état *PENDING affiche la liste de toutes les définitions de validation comportant des modifications locales en attente. Une valeur d'état *RESYNC affiche la liste de toutes les définitions de validation impliquées dans la resynchronisation de leurs ressources. Les définitions de validation peuvent être impliquées dans la resynchronisation des ressources dans le but de rétablir un point de synchronisation au sein de l'unité d'oeuvre logique. Un point de synchronisation correspond à l'endroit où toutes les ressources d'une unité d'oeuvre logique sont cohérentes. L'état *UNDECIDED affiche la liste de toutes les définitions de validation impliquées dans une opération de validation et en attente d'une décision de validation ou d'invalidation. L'état *XOPEN affiche la liste de toutes les définitions de validation associées à une transaction globale X/Open.

Le paramètre de groupe d'ASP peut être utilisé pour obtenir une sous-liste des définitions de validation en fonction de l'ASP sur lequel elles résident.

Le paramètre LUWID peut permettre de rechercher la définition de validation sur le système gérant une définition de validation d'un autre système. Les travaux contenant ces définitions de validation communiquent via une conversation APPC. Pour connaître un LUWID, affichez la définition de validation d'un système, puis utilisez-la dans la commande WRKCMTDFN afin de trouver la définition de validation correspondante.

Le paramètre DUPJOBOPT (Option pour travaux dupliqués) définit l'action effectuée lorsque des travaux dupliqués sont trouvés par cette commande. Dans ce cas, soit ces travaux sont affichés dans une liste à partir de laquelle l'utilisateur effectue une sélection, soit un message apparaît pour chaque travail dupliqué trouvé.

Paramètres

Mot-clé Description Valeurs possibles Remarques
JOB Travail Valeurs uniques: *, *ALL
Autres valeurs: Nom de travail qualifié
Facultatif, positionnel 1
Qualificatif 1: Travail Nom
Qualificatif 2: Utilisat Nom
Qualificatif 3: Numéro 000000-999999
STATUS Etat *ALL, *PENDING, *RESYNC, *UNDECIDED, *XOPEN Facultatif, positionnel 2
ASPGRP Groupe ASP Nom, *ALLAVL, *SYSBAS Facultatif
LUWID ID unité d'oeuvre logique Valeur caractère, *ALL Facultatif
OUTPUT Sortie *, *PRINT Facultatif
DUPJOBOPT Option pour travaux dupliqués *SELECT, *MSG Facultatif

Travail (JOB)

Indique les noms des travaux (s'il y en a) dont les définitions de validation sont affichées. Si un nom de travail n'est pas qualifié, tous les travaux portant ce nom ont leurs définitions de validation affichées. Lorsque *ALL n'est pas précisé, seules les définitions de validation avec un verrouillage *JOB sont affichées, pourtant les définitions de validation avec verrouillage *TNSOBJ peuvent être attachées à des unités d'exécution dans les travaux indiqués. Pour afficher les définitions de validation avec verrouillage *TNSOBJ, *ALL doit être indiqué.

Un identificateur de travail est une valeur spéciale ou un nom qualifié comprenant au maximum trois éléments. Par exemple :

*
*ALL
nom-travail
nom-utilisateur/nom-travail
numéro-travail/nom-utilisateur/nom-travail

*
Les définitions de validation associées au travail dans lequel la commande WRKCMTDFN est émise sont affichées.
*ALL
Les définitions de validation sont affichées pour tous les travaux du système.
nom-travail
Indiquez le nom du travail associé aux définitions de validation à afficher.
nom-utilisateur
Indiquez le nom de l'utilisateur associé aux définitions de validation à afficher.
numéro-travail
Indiquez le numéro du travail associé aux définitions de validation à afficher.

Etat (STATUS)

Indique que seules les définitions de validation dont l'état correspond à la valeur spécifiée à ce paramètre sont répertoriées.

*ALL
Les définitions de validation dont l'état est *ALL sont affichées.
*PENDING
Seules les définitions de validation comportant des modifications locales en attente sont affichées. Une modification locale est en attente dans les cas suivants :
  • une ou plusieurs modifications au niveau de l'enregistrement sont en attente,
  • une ou plusieurs modifications au niveau de l'objet sont en attente,
  • une ressource API enregistrée n'autorise pas l'exécution normale des demandes de sauvegarde en mise à jour ou la mise au repos d'un ASP indépendant.
*RESYNC
Seules les définitions de validation impliquées dans la resynchronisation des ressources sont affichées. Une définition de validation peut être impliquée dans la resynchronisation des ressources afin de rétablir un point de synchronisation qui correspond à l'endroit où toutes les ressources sont cohérentes.
*UNDECIDED
Seules les définitions de validation dont l'unité d'oeuvre logique est à l'état indéfini sont affichées. Une définition de validation est à l'état indéfini lorsque la décision de validation ou d'invalidation lui est inconnue.
*XOPEN
Seules les définitions de validation associées à une transaction globale X/Open sont affichées.

Groupe ASP (groupe d'ASP)

Indique le groupe d'ASP des définitions de validation qui doivent être affichées.

*ALLAVL
Toutes les définitions de validation dans tous les ASP en ligne sont affichées.
*SYSBAS
Seules les définitions de validation de l'ASP système (ASP numéro 1) et des ASP de base (ASP numéros 2 à 32) sont affichées.
nom-groupe-ASP
Seules les définitions de validation figurant dans le groupe d'ASP indiqué sont affichées.

ID unité d'oeuvre logique (LUWID)

Indique l'identificateur d'unité d'oeuvre logique associé à la définition de validation à afficher.

Un identificateur d'unité d'oeuvre logique est une chaîne de caractères constituée des trois éléments suivants :

  • Nom d'unité logique qualifié d'un nom de réseau (LU)
  • Numéro d'instance
  • Numéro de séquence

Le nom de l'unité logique qualifié d'un nom de réseau est constitué d'un ID réseau comportant 8 caractères au maximum, d'un point séparateur, suivi d'un nom de LU de 8 caractères au maximum. Le numéro d'instance est entré comme une valeur de 12 caractères, chaque caractère représentant un seul chiffre hexadécimal. La valeur doit être entrée au format hexadécimal. Par exemple, X'123456789012'. Le numéro de séquence est une valeur décimale dont les valeurs sont comprises entre 1 et 65535. Par exemple :

APPN.RCHASLGU.X'12578A3BDCFF'.23657

*ALL
Les définitions de validation associées à toutes les unités d'oeuvre logiques sont affichées.
identificateur-unité-oeuvre-logique-générique*
Indiquez le nom générique d'un identificateur d'unité d'oeuvre logique. Un nom générique est une chaîne d'un ou plusieurs caractères suivie d'un astérisque (*) ; par exemple, ABC*. Si un nom générique est indiqué, toutes les définitions de validation dont l'identificateur d'unité d'oeuvre logique commence par ce nom générique sont affichées. Si un astérisque n'est pas inclus dans le nom générique (préfixe), le système considère qu'il s'agit de l'identificateur d'unité d'oeuvre logique complet.
identificateur-unité-oeuvre-logique
Indiquez un maximum de 39 caractères pour l'identificateur d'unité d'oeuvre logique associé à une définition de validation.

Sortie (OUTPUT)

Indique si le résultat de la commande est affiché sur le clavier-écran ayant émis cette dernière ou s'il est imprimé avec la sortie spoule du travail.

*
La sortie demandée par un travail interactif s'affiche à l'écran. La sortie demandée par un travail par lots est imprimée avec la sortie spoule du travail.
*PRINT
Le résultat est imprimé avec la sortie spoule du travail.

Option pour travaux dupliqués (DUPJOBOPT)

Indique l'action effectuée lorsque des travaux dupliqués sont détectés par cette commande.

*SELECT
L'écran de sélection est affiché lorsque des travaux dupliqués sont détectés au cours d'une session interactive. Dans le cas d'un travail par lots, un message est émis.
*MSG
Un message est émis lorsque des travaux dupliqués sont détectés.

Exemples

Exemple 1 : Affichage par travail

L'exemple suivant permet d'afficher la liste des définitions de validation associées au travail indiqué. Seules les définitions de validation associées au travail indiqué sont répertoriées.

WRKCMTDFN   JOB(012345/WULF/WULFS1)

Exemple 2 : Affichage par définitions de validation utilisées lors de la resynchronisation des ressources

L'exemple suivant permet d'afficher la liste de toutes les définitions de validation du système utilisées lors de la resynchronisation de leurs ressources.

WRKCMTDFN   JOB(*ALL)  STATUS(*RESYNC)

Exemple 3 : Affichage par définitions de validation à l'état "non décidé"

L'exemple suivant permet d'afficher la liste de toutes les définitions de validation dont l'état est "non décidé". Les définitions de validation se trouvent dans cet état lorsque l'état de leur unité d'oeuvre logique est "préparé" ou "dernier agent en instance".

WRKCMTDFN   JOB(*ALL)  STATUS(*UNDECIDED)

Exemple 4 : Affichage par définitions de validation associées à une transaction globale X/Open

L'exemple suivant permet d'afficher la liste de toutes les définitions de validation associées à une transaction globale X/Open.

WRKCMTDFN   JOB(*ALL)  STATUS(*XOPEN)

Exemple 5 : Affichage par LUWID

WRKCMTDFN   JOB(*ALL)  LUWID(APPN.RCHASL7E.X'11223344BDFF'.*)

Cette commande permet d'afficher la liste de toutes les définitions dont l'identificateur d'unité d'oeuvre logique (LUWID) commence par la valeur générique indiquée. Seuls les identificateurs d'unité d'oeuvre logique commençant par la valeur générique indiquée sont répertoriés.

Exemple 6 : Affichage par ASP système

WRKCMTDFN   JOB(*ALL)  ASPGRP(*SYSBAS)

Cette commande permet d'afficher la liste de toutes les définitions de validation qui se trouvent sur l'ASP système (ASP numéro 1).

Exemple 7 : Affichage par nom de description d'unité ASP

WRKCMTDFN   JOB(*ALL)  ASPGRP(IASP0035)

Cette commande permet d'afficher la liste de toutes les définitions de validation qui se trouvent sur l'ASP indépendant associé à la description d'unité ASP IASP0035.

Messages d'erreur

Messages *ESCAPE

CPF0941
Le travail &3/&2/&1 ne se trouve plus dans le système.
CPF1069
Fin des noms dupliqués.
CPF1070
Travail &3/&2/&1 non trouvé.
CPF1071
Vous n'êtes pas autorisé à utiliser le travail &3/&2/&1.
CPF83E5
Non autorisé aux travaux.
CPF9845
Erreur lors de l'ouverture du fichier &1.
CPF9846
Erreur lors du traitement du fichier &1 de &2.
CPF9847
Erreur lors de la fermeture du fichier &1 de bibliothèque &2.
CPF9850
Substitution non admise pour fichier imprimante &1.
CPF9851
Valeur de ligne fin de page trop faible pour fichier &1 dans &2.
CPF9871
Erreur lors du traitement.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.