CHGMSGD

La commande CHGMSGD (Modifier une description de message) permet de modifier une description de message figurant dans un fichier message et de stocker les modifications dans ce dernier en vue d'une utilisation ultérieure. La description ainsi modifiée est conservée jusqu'à sa suppression par la commande RMVMSGD (Enlever une description de message), jusqu'à la suppression du fichier message ou jusqu'à ce qu'une autre modification soit effectuée à l'aide de la commande CHGMSGD.

Remarque :Si le message et son texte de deuxième niveau comportent plus de 512 caractères, ce message sera trop long pour la zone d'invite. Dans ce cas, tapez la commande sur l'écran de saisie de commande ou dans un programme CL.

Dans le cas d'un message d'interrogation ou d'avertissement demandant une réponse, les paramètres de contrôle de validité suivants peuvent être utilisés pour valider la réponse reçue :

• Type de réponse paramètre (TYPE).
• Longueur maximale de réponse paramètre (LEN).
• Valeurs correctes de réponse paramètre (VALUES).
• Valeurs spéciales de réponse paramètre (SPCVAL).
• Plage de valeurs de réponse paramètre (RANGE).
• Relations réponses correctes paramètre (REL).
• Réponse par défaut paramètre (DFT).

Ces paramètres ne sont pas obligatoires pour admettre une réponse mais peuvent être utilisés pour définir des réponses correctes.

Attention: Toute valeur d'option d'alerte (ALROPT) correspondant à la fourchette (RANGE) CPx7B00/CPx7BFF (messages générés par la procédure d'alerte) peut provoquer des résultats imprévisibles.

Restrictions : Pour modifier une description de message d'un fichier message, vous devez disposer du droit *CHANGE sur ce fichier et du droit *READ sur la bibliothèque le contenant.

Paramètres

Identificateur de message (MSGID)

Précise l'identificateur du message que vous voulez modifier. La longueur de l'identificateur du message doit être de 7 caractères et être conforme au format suivant : pppnnnn

Les 3 premiers caractères (ppp) représentent un code composé d'un caractère alphabétique suivi de deux caractères alphanumériques (alphabétiques ou numériques). Les 4 derniers caractères (nnnn) doivent être des chiffres (0 à 9) ou des lettres (A à F).

Ce paramètre est obligatoire.

fichier message (MSGF)

Indique le fichier message où doit être stocké la description du message en cours de modification.

Remarque :Cette commande ignore toute substitution de fichier message qui pourrait être en cours pour le travail.

Ce paramètre est obligatoire.

Qualificatif 1 : fichier message

nom

Entrez le nom du fichier message où est stockée la description du message.

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.

*CURLIB

Le fichier message est recherché dans la bibliothèque en cours du travail. Si celle-ci ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.

nom

Entrez le nom de la bibliothèque contenant le fichier message.

Texte message de 1er niveau (MSG)

Indique le nouveau texte du message.

*SAME

Le texte du message n'est pas modifié.

'texte-message'

Indiquez le texte du message qui va être affiché, imprimé ou envoyé à un programme ou dans l'historique. Ce texte doit être précédé et suivi d'une apostrophe et peut comporter jusqu'à 132 caractères si la taille du clavier-écran le permet.

Remarque :Si vous modifiez le texte du message, le nouveau texte remplace la totalité du texte original.

Le texte de message peut comporter une ou plusieurs zones de variables auxquelles viendront se substituer des données avant envoi du message. Les règles ci-après doivent être respectées lors de l'utilisation de variables.

• Les variables doivent être entrées au format &n, où n représente un nombre de 1 ou 2 chiffres (1-99) qui identifie la zone de données faisant l'objet de la substitution.
• Les variables peuvent être précédées de tout caractère alphanumérique, y compris des blancs. Par exemple, toutes les variables qui suivent sont correctes.

  Commande&34&72 &2 &99aide
  

• Les variables ne doivent pas être suivies d'un caractère numérique 0-9. Par exemple, toutes les variables qui suivent sont incorrectes.

  Commande&345 &244 &999aide
  

• Les variables peuvent être placées entre apostrophes. Par exemple, le message '&1.&2' pourra représenter une valeur décimale en deux parties.
• Aucune contrainte positionnelle (ordre croissant ou décroissant) n'est imposée pour les variables de ce paramètre.

Remarque :Les zones de données font l'objet d'une description positionnelle dans le paramètre FMT et d'une spécification positionnelle dans le paramètre MSGDTA des commandes SNDPGMMSG (Envoyer un message programme) et SNDUSRMSG (Envoyer un message utilisateur). Pour tout détail concernant la substitution des zones de données dans le texte des messages, reportez-vous au manuel Rubriques CL de la catégorie Programmation de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/

Considérations DBCS :

Sans objet. Exemples : X'50F0', X'50F4', X'50F9'.

Remarques concernant l'ID codé de jeu de caractères (CCSID)

Le système considère que le texte indiqué au paramètre MSG a pour CCSID celui du travail appelant cette commande, sauf si le paramètre CCSID est précisé. Si le paramètre CCSID est codé, le système considère que le texte a pour CCSID celui indiqué. Pour plus de détails sur le gestionnaire de messages et la façon dont il utilise les CCSID, reportez-vous au manuel Rubriques Internationalisation de l'i5/OS dans l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Texte message de 2e niveau (SECLVL)

Indique les modifications apportées à l'aide-message. L'aide-message peut également être écrite dans l'historique du travail, si *SECLVL est indiqué au paramètreEcrire histo service (LOG) des commandes associées au travail.

*SAME

L'aide-message n'est pas modifiée.

*NONE

Aucune aide-message n'est prévue pour cette description. S'il en existe une dans la description initiale, elle est supprimée.

'texte-deuxième-niveau'

Entrez le texte qui constituera l'aide-message. Ce texte doit être placé entre apostrophes et peut comporter jusqu'à 3000 caractères. L'aide-message peut comporter une ou plusieurs variables de substitution, comme l'indique le paramètre Texte message de 1er niveau (MSG). Si vous modifiez le texte de l'aide-message, le nouveau texte remplace la totalité du texte original.

Vous disposez de trois caractères de commande d'édition permettant de mettre en forme l'aide-message pour le poste de travail. Chacun de ces caractères doit être suivi d'un espace.

• &N Place l'aide-message sur une nouvelle ligne (colonne 2). Si le texte occupe plusieurs lignes, les lignes suivantes sont décalées vers la colonne 4 jusqu'à la fin de l'aide ou jusqu'à ce qu'un autre caractère de commande d'édition soit trouvé.
• &P Place l'aide-message sur une nouvelle ligne, décalée vers la colonne 6. Si le texte occupe plusieurs lignes, les lignes suivantes commencent dans la colonne 4 jusqu'à la fin de l'aide ou jusqu'à ce qu'un autre caractère de commande d'édition soit trouvé.
• &B Place l'aide-message sur une nouvelle ligne, en commençant dans la colonne 4. Si le texte occupe plusieurs lignes, les lignes suivantes sont décalées vers la colonne 6 jusqu'à la fin de l'aide ou jusqu'à ce qu'un autre caractère de commande d'édition soit trouvé.

Considérations DBCS :

Sans objet. Exemples : X'50F0', X'50F4', X'50F9'.

Remarques concernant l'ID codé de jeu de caractères (CCSID)

Le système considère que le texte indiqué au paramètre SECLVL a pour CCSID celui du travail appelant cette commande, sauf si le paramètre CCSID est codé. Si le paramètre CCSID est codé, le système considère que le texte a pour CCSID celui indiqué. Pour plus de détails sur le gestionnaire de messages et la façon dont il utilise les CCSID, reportez-vous au manuel Rubriques Internationalisation de l'i5/OS dans l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Code gravité (SEV)

Indique le code de gravité du message que vous modifiez. Ce code correspond au niveau de gravité de la condition à l'origine du message.

*SAME

Le code gravité du message n'est pas modifié.

code-gravité

Indiquez une valeur comprise entre 00 et 99. Plus cette valeur est élevée, plus l'erreur signalée est grave.

00

Messages d'information. Ces messages fournissent simplement des informations et ne nécessitent pas de réponse. Ils peuvent par exemple signaler que l'exécution d'une fonction est en cours de traitement ou qu'elle a abouti.

10

Avertissement. Il existe une condition d'erreur potentielle. Le programme peut avoir pris une valeur par défaut, par exemple pour fournir des données manquantes. L'opération est supposée avoir abouti.

20

Erreur. Une erreur a été détectée, mais des procédures de reprise automatiques ont probablement été appliquées et le traitement s'est poursuivi. Les données erronées peuvent avoir été remplacées par des valeurs par défaut. Le résultat de l'opération peut être incorrect. La fonction n'a peut-être pas abouti ; par exemple, certains éléments d'une liste peuvent ne pas avoir été traités.

30

Erreur grave. L'erreur détectée est trop grave pour être corrigée par des procédures de reprise automatiques et aucune valeur par défaut n'est utilisable. Si l'erreur provient des données source, l'enregistrement de données entier a été sauté. Si l'erreur s'est produite au cours de l'exécution d'un programme, elle provoque une fin de programme anormale (code gravité 40). Le résultat de l'opération est incorrect.

40

Erreur grave : fin anormale de programme ou de fonction. L'opération s'est interrompue, parce que le programme n'a peut-être pas pu gérer des données incorrectes ou parce que l'utilisateur l'a annulée.

50

Fin anormale du travail ou du programme. Le travail n'a pas été démarré ou son démarrage a échoué, une fonction du niveau du travail n'a pas été exécutée normalement ou le travail a peut-être été annulé.

60

Etat système. Transmis uniquement à la file d'attente de messages de l'opérateur système. Ce type de message indique l'état d'une unité, d'un sous-système ou du système, ou un avertissement concernant l'un d'entre eux.

70

Intégrité de l'unité. Transmis uniquement à la file d'attente de messages de l'opérateur système. Ce type de message indique qu'une unité est défectueuse ou n'est plus opérationnelle pour une raison donnée.

80

Messages d'alerte système et messages utilisateur. Une condition d'erreur grave a été détectée. Elle n'est pas assez grave pour provoquer un arrêt du système, mais pourrait s'aggraver et nécessite donc des mesures de prévention.

90

Intégrité du système. Transmis uniquement à la file d'attente de messages de l'opérateur système. Ce type de message décrit une condition empêchant le fonctionnement d'un sous-système ou d'un système.

99

Action. Une action manuelle est requise. Vous devez par exemple entrer une réponse ou modifier le papier imprimante.

Formats des zones variables (FMT)

Indique jusqu'à 99 formats de zones de données de message à modifier. Dans ce paramètre, chaque zone est décrite par une liste d'attributs. Chacune de ces 99 zones peut être utilisée comme valeur de substitution dans le message et l'aide-message définis dans la description associée. Elles peuvent également être indiquées au paramètre Données à clicher (DMPLST) de cette commande. Si des zones de données ont été indiquées pour le paramètre Valeurs zone donnée de msg (MSGDTA) de la commande SNDPGMMSG (Envoyer un message programme) ou SNDUSRMSG (Envoyer un message utilisateur), elles doivent être concaténées et former une chaîne de 512 caractères au plus, et correspondre aux format et séquence précisés ci-dessous.

Remarque :Si l'un des formats précédemment définis est modifié, tous les formats doivent être à nouveau précisés dans ce paramètre. Par exemple, si sept formats ont été précédemment définis et si le troisième de ces formats doit passer de *CHAR 24 à *HEX 8, chacun des sept formats (type et longueur compris) doit être inclus dans le paramètre FMT.

Valeurs uniques

*SAME

Aucun format n'est modifié.

*NONE

Il n'existe pas de format dans la description de message, ou bien ils sont supprimés. Si *NONE est indiqué, il ne peut pas être fait référence à des zones de données au paramètre Texte message de 1er niveau (MSG), Texte message de 2e niveau (SECLVL) ou Données à clicher (DMPLST).

Remarque :Si un format a été initialement défini mais que *NONE est indiqué, toute référence à ce format dans la description de message et de l'aide-message ou dans la liste de clichés doit être supprimée.

type ¬longueur ¬positions-décimales|| Spécifie une liste d'attributs définissant chaque zone de données de message (jusqu'à 99 zones) dans la description de message. Ces attributs indiquent le type de données de la zone, sa longueur totale et éventuellement le nombre de chiffres décimaux figurant à droite du symbole décimal. Dans certains cas, il n'est pas nécessaire de préciser la longueur de la zone. Il faut également tenir compte de l'alignement de frontière (par exemple, les pointeurs sont toujours alignés sur des frontières de 16 octets). Les zones &1 à &99 peuvent être définies dans le texte du message et apparaître dans ce texte. Au-delà de ce nombre, les zones ne peuvent apparaître que dans la liste de clichés.

Elément 1 : Type de données

Le premier élément indique le type de données que contient la zone de substitution et précise comment s'effectue le formatage de ces données dans le texte du message. La deuxième et la troisième valeurs dépendent du type de données. Pour chacune des zones définies pour ce paramètre, l'un des types de données suivants peut être indiqué :

*QTDCHAR

Chaîne de caractères figurant entre apostrophes ('lundi 1er juin').

*CHAR

Chaîne de caractères ne figurant pas entre apostrophes. Par exemple, chaîne de caractères alphanumériques formant un nom (ROBERT). Les blancs de fin sont tronqués.

*HEX

Suite d'octets représentant une valeur hexadécimale (X'C0F4').

*DEC

Nombre décimal condensé (X'058C') figurant dans le message sous la forme d'un nombre décimal signé comportant un symbole décimal (5.8) peut être indiqué. Pour ce type de données (*DEC), la valeur représentant la longueur (obligatoire) indique le nombre total de chiffres décimaux, tandis que la valeur représentant les positions décimales (facultative) se réfère au nombre de chiffres situés à droite du symbole décimal. Si le nombre de décimales n'est pas indiqué, zéro est pris par défaut.

*BIN

Nombre binaire, d'une longueur de 2, 4 ou 8 octets (B'0000000000111010'), apparaissant dans le message sous la forme d'un nombre décimal signé (58).

*UBIN

Valeur binaire d'une longueur de 2, 4 ou 8 octets (B'0000000000111010') au format décimal non signé (58) dans le message.

*CCHAR

Chaîne de caractères convertible. Si des données de ce type sont envoyées dans une file d'attente de messages dont le CCSID est différent de 65535 ou 65534, les données sont converties du CCSID indiqué par la fonction d'envoi à celui de la file d'attente de messages. Des conversions peuvent également être effectuées sur des données de ce type lorsque ces dernières sont obtenues à partir de la file d'attente de messages à l'aide d'une fonction de réception ou d'affichage. Pour plus d'informations sur les conversions de CCSID, reportez-vous à la section relative au gestionnaire des messages dans le manuel Rubriques Internationalisation de l'i5/OS dans l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

*UTC

Une zone de 8 octets contenant un horodatage au format TU (temps universel) est spécifié. Celui-ci indique la date suivie par un espace, puis l'heure. La date et l'heure du message de sortie sont ajustées à partir du temps universel en fonction du fuseau horaire spécifié pour le travail. La date est formée à partir des attributs de définition du travail concernant le format et le séparateur de date. L'heure est formatée à l'aide de l'attribut de définition du travail correspondant au séparateur d'heure. Lorsque la zone de 8 octets est transmise au format zéro hexadécimal (X'0000000000000000'), la valeur est au format *N.

*UTCD

Une zone de 8 octets contenant un horodatage au format TU (temps universel) est spécifié. La date du message de sortie est ajustée à partir du temps universel en fonction du fuseau horaire spécifié pour le travail. La date est formée à partir des attributs de définition du travail concernant le format et le séparateur de date. Lorsque la zone de 8 octets est transmise au format zéro hexadécimal (X'0000000000000000'), la valeur est au format *N.

*UTCT

Une zone de 8 octets contenant un horodatage au format TU (temps universel) est spécifié. L'heure du message de sortie est ajustée à partir du temps universel en fonction du fuseau horaire spécifié pour le travail et formaté à l'aide de l'attribut de définition de travail correspondant au séparateur d'heure. Lorsque la zone de 8 octets est transmise au format zéro hexadécimal (X'0000000000000000'), la valeur est au format *N.

*DTS

Une zone de 8 octets contenant un horodatage système est spécifiée. Celui-ci indique la date suivie par un espace, puis l'heure. La date est formatée dans le message de sortie à l'aide des attributs de définition de travail correspondant au format et au séparateur de date. L'heure est formatée à l'aide de l'attribut de définition du travail correspondant au séparateur d'heure.

*ITV

Zone de 8 octets représentant la durée du délai d'attente (en secondes). Cette dernière est au format décimal étendu sans zéro à gauche (15 0) représentant le nombre de secondes d'attente.

Les formats suivants ne sont admis que pour les descriptions de message fournies par IBM et ne doivent pas être utilisés pour d'autres messages.

*SPP

Pointeur d'espace de 16 octets indiquant le début des données d'un espace mémoire. *SPP ne peut pas être utilisé comme zone de substitution.

*SYP

Pointeur système de 16 octets indiquant le début d'un objet système. Si cette valeur concerne un texte de message, le nom élémentaire de l'objet désigné apparaît dans le message au format indiqué par *CHAR.

Elément 2 : Longueur

Après l'indication du type, un deuxième élément permet d'indiquer le nombre de caractères ou de chiffres des données du message. L'utilisation de ce deuxième élément dépend du type de données indiqué comme premier élément.

• Si aucune longueur n'est indiquée pour *QTDCHAR, *CHAR, *HEX ou *SPP, la valeur par défaut est *VARY. Si *VARY a été indiqué, la zone de données passée par la commande SNDPGMMSG doit être précédée d'une zone de 2 ou 4 octets précisant le nombre d'octets de données transmis. Si *SPP est indiqué, ce nombre figure dans les premiers octets adressés par le pointeur d'espace. Par conséquent, la zone de 2 ou de 4 octets doit précéder les données adressées par le pointeur d'espace et non pas précéder le pointeur d'espace qui fait partie des données du message.
• Si le type de données indiqué est *DEC, le nombre total de chiffres décimaux (y compris ceux figurant après le symbole décimal) doit être indiqué en tant que deuxième élément ; le nombre de chiffres de la fraction peut, à titre facultatif, être indiqué en tant que troisième élément.
• Si le type de données indiqué est *BIN ou *UBIN, la longueur de la zone de données du message ne peut être que de 2, 4 ou 8 octets. La longueur par défaut est de 2 octets.
• Si le type de données indiqué est *CCHAR, la longueur de la zone de données ne peut être que *VARY. Une zone de longueur variable est requise car les données entrées dans cette zone pouvant être converties en plusieurs CCSID, la longueur de cette dernière peut varier.

Elément 3 : Octets ou pos déc pour *VARY

Le troisième élément dépend du type de données indiqué comme premier élément et s'utilise de deux façons. (1) Si *QTDCHAR, *CHAR, *CCHAR, *HEX ou *SPP est indiqué, et si *VARY l'est également ou s'il est pris par défaut comme deuxième élément, le troisième élément est utilisé en association avec *VARY pour indiquer la longueur des données passées. Cette troisième valeur peut être 2 ou 4, c'est-à-dire le nombre d'octets utilisés pour indiquer la longueur (en binaire) de la valeur passée. (2) Si le type de données indiqué est *DEC, la troisième valeur précise le nombre de positions décimales. Si une valeur décimale de remplacement n'est pas indiquée, la valeur par défaut est 0.

Remarque :Si un objet a été endommagé ou supprimé, la variable n'est pas remplacée par le nom d'objet lorsque le message est affiché, mais apparaît à l'écran sous la forme de &n (où n est un nombre).

Type de réponse (TYPE)

Indique, pour les messages d'interrogation et d'avertissement uniquement, le type de réponse qui doit être utilisé.

Si le message est envoyé en tant que message d'interrogation (*INQ) ou d'avertissement (*NOTIFY) et si une réponse est attendue, vous disposez de sept paramètres pour définir diverses conditions touchant aux valeurs admises dans la réponse reçue. Il s'agit des sept paramètres de contrôle de validité suivants : TYPE, LEN, VALUES, SPCVAL, RANGE, REL et DFT. Ces paramètres ne sont pas indispensables pour qu'une réponse à un message soit admise, mais ils permettent de définir les réponses valides pouvant être apportées à ce message. A noter également que les paramètres VALUES, RANGE et REL sont mutuellement exclusifs et qu'un seul de ces paramètres peut être spécifié dans la commande.

Remarque :Si le type ou la longueur de la réponse est modifié et si les paramètres VALUES, RANGE ou REL ont été précédemment définis, les paramètres VALUES, RANGE, REL, SPCVAL et DFT existants doivent également être modifiés afin d'être compatibles avec le nouveau type et/ou la nouvelle longueur de la réponse. Si le type de réponse est modifié, le paramètre LEN doit également être modifié. Si le type de réponse a été passé à *NONE, le paramètre LEN et (si précédemment codés) les paramètres VALUES, SPCVAL, RANGE, REL et DFT doivent être codés à *NONE.

*SAME

Le type de réponse n'est pas modifié.

*NONE

Aucun contrôle de validité n'est prévu. Si un type de réponse existait, il est supprimé. La valeur *NONE doit aussi être indiquée au paramètre LEN (Longueur maximale de réponse).

*CHAR

N'importe quelle chaîne de caractères peut être utilisée. Les apostrophes délimitant la chaîne sont considérées comme partie intégrante de celle-ci.

*DEC

Seuls des nombres décimaux peuvent être utilisés.

*ALPHA

Seuls des caractères alphabétiques peuvent être utilisés. Les blancs ne sont pas admis.

*NAME

Seul un nom simple peut être utilisé. Le premier caractère du nom doit être alphabétique et les suivants alphanumériques. Il n'est pas obligatoire qu'il s'agisse d'un nom d'objet.

Longueur maximale de réponse (LEN)

Indique, pour les messages d'interrogation ou d'avertissement uniquement, la longueur maximale de la réponse.

Valeurs uniques

*SAME

La longueur maximale n'est pas modifiée.

*NONE

Aucun contrôle de validité n'est prévu. Toute indication de longueur précédemment définie est supprimée. La valeur *NONE doit aussi être indiqué au paramètre TYPE (Type de réponse).

*TYPE

La longueur maximale dépend du type de réponse indiqué au paramètre Type de réponse (TYPE). La longueur maximale correspondant à chaque type de réponse est définie ci-dessous :

• Si le type de données est *CHAR ou *ALPHA, la réponse peut comporter jusqu'à 132 caractères. Cependant, si un autre contrôle de validité est prévu (VALUES, RANGE, REL, SPCVAL ou DFT), la longueur maximale est de 32 caractères.
• Si le type de données indiqué est *DEC, la réponse peut comporter jusqu'à 15 chiffres dont 9 décimales au maximum.
• Si le type de données indiqué est *NAME, la réponse peut comporter jusqu'à 10 caractères alphanumériques.

Elément 1 : Longueur

longueur

Entrez la longueur maximale de la réponse. Les valeurs définies pour ce paramètre ne doivent pas être supérieures aux longueurs maximales précisées ci-dessus.

Elément 2 : Nombre de positions décimales

nombre

Si le type de réponse est une valeur décimale, la mention du nombre de positions décimales est facultative. Si aucune valeur n'est indiquée, le nombre de positions décimales par défaut est zéro.

Valeurs correctes de réponse (VALUES)

Indique, pour les messages d'interrogation et d'avertissement uniquement, une liste de valeurs représentant chacune une réponse correcte. Cette liste ne doit pas comporter plus de 20 valeurs. Chaque valeur contenue dans la liste doit répondre aux critères indiqués pour les réponses aux messages dans les paramètres Type de réponse (TYPE)Longueur maximale de réponse (LEN) Ce paramètre est incompatible avec les paramètres RANGE (Plage de valeurs de réponse) et REL (Relations réponses correctes).

Valeurs uniques

*SAME

La liste des valeurs existantes n'est pas modifiée.

*NONE

Aucune liste de valeurs de réponse n'est indiquée. La réponse peut avoir n'importe quelle valeur compatible avec les autres paramètres de contrôle de validité. Toute valeur existante est supprimée.

Autres valeurs

valeur

Indiquez de 1 à 20 valeurs qui seront comparées à celles de la réponse envoyée au message défini dans la description de message. La longueur maximale de chacune de ces valeurs est de 32 caractères.

Valeurs spéciales de réponse (SPCVAL)

Indique, pour les messages d'interrogation ou d'avertissement uniquement, une liste de 20 groupes de valeurs spéciales, chaque groupe représentant une réponse correcte. Ces valeurs sont dites spéciales en ce qu'elles peuvent ne pas remplir toutes les conditions de validité précisées dans les autres paramètres. La réponse envoyée est comparée à la valeur d'origine de chaque groupe. La réponse envoyée est comparée à la valeur d'origine contenue dans chaque ensemble. S'il existe une correspondance et qu'une valeur de destination est indiquée pour ce groupe, cette dernière est envoyée en réponse. Dans le cas contraire, c'est la valeur d'origine qui est envoyée. Si la valeur de la réponse ne correspond à aucune de valeur d'origine, les autres paramètres destinés à la réponse subissent un contrôle de validité.

Valeurs uniques

*SAME

La liste des valeurs spéciales n'est pas modifiée.

*NONE

Aucune valeur spéciale n'est prévue pour les réponses à ce message. Si des valeurs spéciales ont été définies, elles sont supprimées de la description de message.

Elément 1 : Valeur d'origine

valeur-d'origine

Indiquez une valeur d'origine à comparer à une valeur de réponse de message.

Elément 2 : Valeur de remplacement

valeur-de-destination

Indiquez une valeur de destination qui sera mappée à la valeur d'origine avant l'envoi de la réponse.

Plage de valeurs de réponse (RANGE)

Indique, pour les messages d'interrogation et d'avertissement uniquement, les limites supérieure et inférieure des valeurs de la réponse envoyée au message. Ces valeurs doivent remplir les conditions indiquées dans les paramètres TYPE et LEN et correspondre toutes deux au même type de données. Si la longueur de ces deux valeurs est différente, la plus courte est complétée à droite par des blancs. Pour des réponses de type *CHAR ou *ALPHA, la réponse est soit complétée à droite par des blancs, soit tronquée à droite, avant le contrôle de validité. Ce paramètre est incompatible avec les paramètres VALUES (Valeurs correctes de réponse) et REL (Relations réponses correctes).

Valeurs uniques

*SAME

Les limites supérieure et inférieure ne sont pas modifiées.

*NONE

Aucune valeur de limite n'est prévue pour les réponses à ce message. Toutes les valeurs existantes sont supprimées de la description de message.

Elément 1 : Valeur inférieure

première-valeur

Indiquez la limite inférieure pour les réponses correctes à ce message.

Elément 2 : Valeur supérieure

dernière-valeur

Indiquez la limite supérieure pour les réponses correctes à ce message.

Relations réponses correctes (REL)

Indique, pour les messages d'interrogation et d'avertissement uniquement, la relation qui doit exister entre la valeur indiquée et la réponse pour que celle-ci soit correcte. La valeur indiquée doit remplir les conditions indiquées aux paramètres Type de réponse (TYPE) et Longueur maximale de réponse (LEN). Si la réponse est de type *CHAR ou *ALPHA, elle est complétée par des blancs ou tronquée à droite pour correspondre aux longueurs indiquées, avant de faire l'objet d'un contrôle de validité.

Valeurs uniques

*SAME

La relation existante n'est pas modifiée.

*NONE

Aucune condition de relation n'est prévue pour les réponses à ce message. Toute condition de relation existante est supprimée de la description.

Elément 1 : Opérateur relationnel

opérateur

Indiquez l'un des opérateurs relationnels suivants :

• *LT -- Inférieur à
• *LE -- Inférieur ou égal à
• *GT -- Supérieur à
• *GE -- Supérieur ou égal à
• *EQ -- Egal à
• *NL -- Non inférieur à
• *NG -- Non supérieur à
• *NE -- Différent de

Elément 2 : Valeur

valeur

Indiquez la valeur à laquelle doit être comparée la réponse. Si la validité de la réponse est établie lors du contrôle de la relation, la réponse est envoyée à l'expéditeur du message.

Remarque :Si les paramètres VALUES, RANGE ou REL ont été spécifiés pour le message existant, et s'ils sont passés vers un autre type de contrôle de validité de la réponse, le contrôle existant doit être supprimé en indiquant *NONE. Par exemple, si VALUES a été initialement spécifié et si l'utilisateur souhaite maintenant définir une plage (RANGE), il lui faudra indiquer VALUES(*NONE) et RANGE(valeur-inférieure valeur-supérieure) dans la commande CHGMSGD (Modifier une description de message).

Réponse par défaut (DFT)

Indique, pour les messages d'interrogation et d'avertissement uniquement, la réponse par défaut utilisée (qui doit figurer entre apostrophes si elle comporte des caractères spéciaux) lorsque le destinataire du message a précisé qu'il enverrait des réponses par défaut à tous les messages qu'il recevrait ou lorsqu'un message est supprimé de la file d'attente et qu'aucune réponse n'a été indiquée. La réponse par défaut peut aussi être utilisée pour répondre à des messages d'avertissement non interceptés. Elle doit remplir les conditions définies par les paramètres de contrôle de validité.

*SAME

La réponse par défaut n'est pas modifiée.

*NONE

Aucune réponse par défaut n'est indiquée. Toute réponse par défaut existante est supprimée.

'réponse-par-défaut'

Entrez la réponse par défaut que vous souhaitez utiliser (entre apostrophes si elle comporte des caractères spéciaux).

Pgm par défaut à appeler (DFTPGM)

Indique, le cas échéant, le nom du programme par défaut appelé lorsque ce message est envoyé en tant que message d'arrêt programme à un programme qui ne l'a pas intercepté. Si le message n'est pas envoyé en tant que message d'arrêt programme, ce paramètre est ignoré. Dans le cas contraire, les paramètres suivants sont transmis au programme par défaut :

• Nom de la file d'attente de messages programme (10 caractères). Il s'agit du nom de la file d'attente vers laquelle le message a été dirigé. Ce nom est identique à celui du programme qui n'a pas intercepté le message.
• Clé de référence du message (4 caractères). Il s'agit de la clé de référence du message d'arrêt programme placé dans la file d'attente de messages programme.

Valeurs uniques

*SAME

Le programme par défaut n'est pas modifié.

*NONE

Aucun programme par défaut n'est prévu pour ce message. Tout programme par défaut existant est supprimé de la description de message.

Qualificatif 1 : Pgm par défaut à appeler

nom

Entrez le nom du programme par défaut appelé lorsqu'un message d'arrêt programme est envoyé.

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.

*CURLIB

Le programme est recherché dans la bibliothèque en cours pour le travail. Si celle-ci ne figure pas dans la liste des bibliothèques, QGPL est prise par défaut.

nom

Indiquez le nom de la bibliothèque contenant le programme.

Données à clicher (DMPLST)

Indique les données qui sont clichées lorsqu'un message d'arrêt programme est envoyé à un programme qui ne peut pas l'intercepter. Le cliché peut porter sur les données du travail et/ou sur les zones de données de message. Si vous désirez que les zones de données de message soient clichées, vous devez indiquer le ou les numéros de zones correspondant.

Les objets système indiqués par les pointeurs système ou les données indiquées par un pointeur d'espace sont clichés. Dans ce dernier cas, les données sont clichées sur la longueur précisée dans la description de zone, à partir de la première position indiquée par le pointeur. Un cliché standard du travail peut aussi être demandé.

Remarque :

1. Si l'une quelconque de ces valeurs est indiquée pour DMPLST, *JOB est automatiquement pris en compte. Par exemple, si vous indiquez DMPLST (1 2 *JOBDMP), vous obtiendrez le même résultat que si vous aviez indiqué DMPLST(*JOB 1 2 *JOBDMP).
2. La valeur système QSRVDMP peut venir se substituer aux valeurs indiquées pour le paramètre DMPLST. Pour plus d'informations, reportez-vous au chapitre portant sur les valeurs système dans le manuel Ensemble de rubriques Gestion des travaux de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.
3. Le programme recevant le message non intercepté doit soit porter un nom commençant par la lettre 'Q', soit être paramétré avec une valeur au moins égale à 50 pour la gravité des messages.
4. L'utilisateur du travail pour lequel le cliché est spécifié doit être autorisé à exécuter la commande de cliché demandée dans ce paramètre.

Valeurs uniques

*SAME

La liste de clichés n'est pas modifiée.

*NONE

Aucune liste de clichés n'est prévue pour ce message. Toute liste de clichés existante est supprimée de la description de message.

Autres valeurs

*JOB

Cette valeur équivaut à indiquer * au paramètre Travail (JOB) et *PRINT au paramètre Sortie (OUTPUT) de la commande DSPJOB (Afficher travail).

*JOBDMP

Les données du travail sont clichées conformément à la commande DMPJOB (Clicher un travail). Vous pouvez utiliser la valeur *JOBDMP seule ou la faire suivre de la valeur *JOB, *JOBINT ou d'une liste de numéros de zones de données de messages.

*JOBINT

Les structures de données internes liées à l'exécution du travail sont clichées dans l'historique des erreurs machine conformément aux valeurs indiquées dans la commande DMPJOBINT (Clicher l'interne du travail). Vous pouvez utiliser la valeur *JOBINT uniquement ou la faire suivre de la valeur *JOBDMP ou *JOB, ou d'une liste de numéros de zones de données de message.

numéro-zone-données-message

Indiquez les numéros des zones de données de message permettant d'identifier les données clichées lorsqu'un message d'arrêt programme est envoyé mais non intercepté. Il est possible d'indiquer jusqu'à 99 numéros de zones de données. En outre, les valeurs *JOB, *JOBDMP et *JOBINT peuvent figurer dans la liste.

Options d'alerte (ALROPT)

Indique l'option d'alerte associée aux messages envoyés à l'historique QHST et à la file d'attente de messages de l'opérateur système.

Valeurs uniques

*SAME

L'option d'alerte n'est pas modifiée.

Elément 1 : Type d'alerte

*NO

Aucune alerte n'est envoyée.

*IMMED

Une alerte est immédiatement émise et le message envoyé aussitôt à QHST.

*UNATTEND

Une alerte n'est envoyée immédiatement que si *UNATTEND est indiqué au paramètre Etat alerte (ALRSTS) de la commande CHGNETA.

*DEFER

L'alerte est envoyée après analyse de l'incident intervenu localement. Vous ne devez utiliser la valeur *DEFER que pour les messages pouvant être analysés. Une alerte est envoyée à la fin de l'analyse relative à l'incident mentionné dans le message. Les alertes ayant la valeur *DEFER ou *IMMED sont traitées de la même façon si :

• *UNATTEND est indiqué au paramètre Etat alerte (ALRSTS) de la commande CHGNETA (Modifier les attributs du réseau).
• il n'existe pas d'ID historique d'erreurs pour l'incident pouvant faire l'objet d'une analyse ;
• *NO est indiqué au paramètre Consigner incident (LOGPRB). Aucune analyse relative à l'erreur signalée dans le message ne peut être effectuée.

Elément 2 : Variable pour nom de ressource

*NONE

Aucun numéro de format de zone de données n'est associé à l'identificateur d'alerte.

1-99

Entrez le numéro de format de la zone de données qui doit être associé à l'identificateur d'alerte.

Consigner incident (LOGPRB)

Indique, pour les messages fournis par IBM, si un poste peut être consigné ou non dans l'historique des incidents. S'il existe un ID historique d'erreurs pour ce message et que *YES a été indiqué pour ce paramètre, l'utilisateur peut demander l'analyse de l'incident en appuyant sur F14 à partir de l'écran présentant la file d'attente de message (en exécutant la commande DSPMSG *SYSOPR).

*SAME

La valeur n'est pas modifiée.

*NO

Aucun poste n'est consigné dans l'historique des incidents.

*YES

S'il existe un ID historique d'erreurs pour ce message, un poste est consigné dans l'historique des incidents.

ID codé de jeu de caractères (CCSID)

Indique l'ID codé de jeu de caractères (CCSID) du texte entré pour les paramètres MSG et SECLVL.

Si les paramètres MSG et SECLVL ne sont pas codés, la valeur indiquée au paramètre CCSID est utilisée pour modifier le CCSID associé à la description de message. Dans ce cas, aucune conversion de texte n'est effectuée. Utilisez le paramètre CCSID de cette manière pour corriger une description de message dont le CCSID est incorrect.

Si les paramètres MSG ou SECLVL sont codés conjointement au paramètre CCSID, le système considère que le texte fourni aux paramètres MSG et SECLVL est dans le CCSID indiqué. Si un seul des deux paramètres MSG et SECLVL est codé, tout texte associé au paramètre non codé est converti dans le CCSID indiqué, de sorte que tout le texte soit dans le même CCSID.

Si le fichier message est différent de 65535 ou 65534, le texte est converti du CCSID indiqué à celui du fichier message. Sinon, le CCSID indiqué est sauvegardé avec la description MSG pour le cas où une conversion serait nécessaire lors de l'exécution d'une fonction de type extraction ou affichage.

Si le CCSID indiqué ne correspond pas au codage de caractères associé à la description de message, vous pouvez obtenir des résultats imprévus.

Pour utiliser le CCSID associé à la description de message, vous devez disposer d'un CCSID de fichier message égal à 65534. Pour plus de détails sur la modification du CCSID associé au fichier message, reportez-vous à la commande CHGMSGF (Modifier un fichier message).

Le CCSID s'applique uniquement aux textes des messages de premier et de deuxième niveaux contenus dans la description de message.

*JOB

Le CCSID de la description de message est remplacé par celui du travail exécutant cette commande. Si les paramètres MSG et SECLVL sont indiqués, le texte qu'ils fournissent est considéré comme étant dans le CCSID indiqué. Si les paramètres MSG et SECLVL ne sont pas codés, le CCSID de la description de message est inchangé.

*SAME

Le CCSID de la description de message est inchangé. Si le paramètre MSG ou SECLVL est indiqué, le système considère que le texte a le même CCSID que le texte qu'il remplace.

*HEX

Le CCSID de la description de message est remplacé par la valeur spéciale 65535, ce qui signifie que la description de message ne sera pas convertie lorsqu'elle sera utilisée.

ID-codé-jeu-caractères

Indiquez le CCSID dans lequel est censé figurer le texte. Les valeurs admises sont comprises entre 1 et 65535. La liste des valeurs de CCSID admises est fournie dans le manuel Internationalisation de l'iSeries Information Center, à l'adresse http://www.ibm.com/eserver/iseries/infocenter. Seuls sont admis les CCSID dans lesquels un travail peut être converti.

Si les paramètres MSG et SECLVL sont indiqués, le texte qu'ils fournissent est considéré comme étant dans le CCSID indiqué. Pour plus de détails sur le gestionnaire de messages et la façon dont il utilise les CCSID, reportez-vous au manuel Rubriques Internationalisation de l'i5/OS dans l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Exemples

Exemple 1 : Modification du message de premier niveau et de la gravité

CHGMSGD   MSGID(UIN0115)  MSGF(INV)  MSG('Tapez votre nom')
          SEV(55)

Cette commande modifie le message de premier niveau et la gravité du message UIN0115 stocké dans le fichier message INV. Le reste de la description du message reste telle qu'elle était décrite à l'origine dans la commande ADDMSGD.

Exemple 2 : Modification d'une série de réponses admises

Supposons que l'utilisateur ait créé le message UPY0047 comme suit :

ADDMSGD   MSGID(UPY0047)  MSGF(PAYLIB/TIMECARD)
          MSG('Tapez le numéro de service :')
          TYPE(*DEC)  LEN(4)  VALUES(0816 0727 0319 8774)

Pour modifier une fourchette de réponses admises (paramètre RANGE), vous pouvez utiliser la commande suivante plutôt que des valeurs de réponse spécifiques (telles qu'indiquées à l'aide du paramètre VALUE) :

CHGMSGD   MSGID(UPY0047)  MSGF(PAYLIB/TIMECARD)  VALUES(*NONE)
          RANGE(0300 8900)

Les valeurs VALUES définies à l'origine sont retirées et les paramètres RANGE sont ajoutés à la description du message. Le type et la longueur des valeurs de réponse ne changent pas.

Remarque : toute modification apportée à une description de message existante doit être compatible avec cette dernière. Par exemple, la modification ci-dessous serait refusée parce que les valeurs de RANGE sont incompatibles avec la longueur de réponse définie dans la commande ADDMSGD d'origine.

Exemple 3 : Modification du paramètre de longueur

ADDMSGD   MSGID(XYZ0202)  MSGF(XYZMSGF)
          MSG('Tapez le code d'acheminement :')
          TYPE(*CHAR)  LEN(2)  VALUES(AA BB CC DD EE)

CHGMSGD   MSGID(XYZ0202)  MSGF(XYZMSGF)  VALUES(*NONE)
          RANGE(AAA ZZZ)

Pour que la modification apportée à la série de valeurs de réponse soit admise, l'utilisateur doit également modifier la longueur (paramètre LEN). La commande devrait être codée comme suit :

CHGMSGD   MSGID(XYZ0202)  MSGF(XYZMSGF)  LEN(3)
          VALUES(*NONE)  RANGE(AAA ZZZ)

Messages d'erreur

Messages *ESCAPE

CPF2401

Accès non autorisé à la bibliothèque &1.

CPF2407

fichier message &1 non trouvé dans &2.

CPF2411

Accès non autorisé au fichier message &1 dans &2.

CPF2419

Identificateur &1 non trouvé dans fichier message &2 de &3.

CPF2461

La taille du fichier message &1 ne peut pas être augmentée.

CPF2483

fichier message en cours d'utilisation.

CPF2499

L'identificateur de message &1 n'est pas valide.

CPF2510

Dommage logique sur fichier message &1 de &2.

CPF2542

Description du message &1 non modifiée.

CPF9830

Allocation de la bibliothèque &1 impossible.

CPF9838

Limite mémoire du profil utilisateur dépassée.