ADDMSGD

La commande ADDMSGD (Ajouter une description de message) permet d'ajouter une description de message à un fichier message et de l'y stocker. Cette description est conservée jusqu'à sa suppression par la commande RMVMSGD (Enlever une description de message) ou jusqu'à la suppression du fichier. La commande CHGMSGD (Modifier une description de message) permet de modifier l'un des attributs de la description de message, tel que le texte du message ou le code gravité.

Remarque :Vous trouverez une description de la procédure à utiliser pour imprimer un message ou un groupe de messages à la section intitulée Handling Messages de Ensemble de rubriques Opérations système de base de l'IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/.

Les variables de substitution peuvent être intégrées au texte des messages de premier et deuxième niveau. Elles peuvent être remplacées ultérieurement par des zones de données de message indiquées par les commandes RTVMSG (Extraire un message), SNDUSRMSG (Envoyer un message utilisateur) et SNDPGMMSG (Envoyer un message programme).

Remarque :Le type de message défini n'est pas spécifié par la commande ADDMSGD, mais par la commande qui émet le message.

Si le texte de deuxième niveau du message comporte plus de 512 caractères, ce texte dépassera la limite imposée par la fonction d'invite IBM i. Dans ce cas, tapez la commande sur l'écran de saisie de commande ou dans un programme CL.

Restrictions :

• Pour ajouter une description de message à un fichier message, vous devez disposer des droits d'utilisation (*USE) et d'ajout (*ADD) sur ce fichier.

Paramètres

Identificateur de message (MSGID)

Précise l'identificateur propre au message stocké dans le fichier message. A chaque message du fichier doit correspondre un identificateur unique.

Ce paramètre est obligatoire.

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 représentent un code composé d'un caractère alphabétique suivi de deux caractères alphanumériques (alphabétiques ou décimaux). Les 4 derniers caractères doivent être des chiffres (0 à 9) ou des lettres (A à F).

Ce même format doit être appliqué aux messages définis par l'utilisateur, mais par ailleurs, le préfixe de 3 caractères doit commencer par un U, ceci afin d'établir une distinction entre messages définis par l'utilisateur et messages fournis par IBM. Par exemple, UPY0027 identifiera un message dans un fichier message associé à une application de gestion de la paye.

Voici quelques exemples représentatifs de préfixes utilisés pour identifier les messages contenus dans différents fichiers message fournis par IBM. La liste inclut certains des préfixes en vigueur pour le système d'exploitation IBM i, ILE COBOL/400*, ILE RPG/400*, les utilitaires IDU et SDA, les messages clavier et les messages d'interface machine.

CPA  Messages IBM i exigeant une action de la part de l'opérateur
CPC  Messages d'achèvement du système IBM i
CPD  Messages de diagnostic du système IBM i
CPI  Messages d'information du système IBM i
CPX  Titres et textes du système IBM i
CPF  Arrêt anormal du système IBM i
CBE  Exécution COBOL
CBL  Compilateur COBOL
CBX  Titres et textes COBOL
CSC  Vérificateur de syntaxe COBOL
QRG  Compilateur de langage RPG
RPG  Exécution RPG
RPT  Signalement automatique RPG
RSC  Vérificateur de syntaxe RPG
RTX  Titres et textes pour signalement automatique RPG
RXT  Textes de diagnostic relationnel RPG
IDU  Utilitaires de base de données interactifs (IDU)
IDX  Titres et textes IDU
SDA  Aide à la conception d'images écran (SDA)
SDX  Titres et textes SDA
KBD  Clavier
MCH  Interface d'instructions machine IBM i

fichier message (MSGF)

Indique le fichier message où doit être stocké le message.

Ce paramètre est obligatoire.

Qualificatif 1 : fichier message

nom

Entrez le nom du fichier message devant contenir le message. Les fichiers message fournis par IBM (QCPFMSG ou QRPGMSG, par exemple) sont exclus, excepté si l'utilisateur qui entre la commande est autorisé à mettre à jour ces fichiers. Lors de l'installation du système, seul le responsable de la sécurité du système dispose des droits nécessaires à cet effet.

Remarque :Cette commande ignore les substitutions de fichiers message prévues pour le travail et le message est stocké dans le fichier indiqué.

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)

Texte du message en cours de définition. Ce texte correspond au message affiché ou imprimé à l'origine ou envoyé vers un programme ou l'historique. Il peut comporter jusqu'à 132 caractères entre apostrophes, mais la taille de l'écran doit être prise en compte. Des apostrophes doivent se trouver au début et à la fin du message même si le message contient des espaces. Pour que les apostrophes soient prises en compte au sein du message, doublez-les.

Une ou plusieurs variables de substitution peuvent être imbriquées dans la chaîne de texte du message pour représenter des zones de substitution positionnelles. Ces zones permettent au programme de substituer les données variables dans le message avant que celui-ci ne soit envoyé. 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
  

• Si les variables composent à elles seules le message, ces variables doivent être placées entre apostrophes. Par exemple, le message '&1.&2' pourra représenter une valeur décimale en deux parties.
• Les variables utilisées pour ce paramètre ne nécessitent pas de description positionnelle (ordre croissant ou décroissant).

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/

Ce paramètre est obligatoire.

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 est dans le même CCSID que travail exécutant 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/.

Texte message de 2e niveau (SECLVL)

Indique l'aide-message que l'utilisateur d'une station d'affichage peut visualiser pour obtenir plus d'informations sur le message défini au paramètre Texte message de 1er niveau (MSG) Pour demander l'aide-message, l'utilisateur appuie sur la touche d'aide. Cette aide-message peut également apparaître dans l'historique du travail si *SECLVL est indiqué au paramètre Ecrire histo service (LOG) des commandes associées au travail.

*NONE

Aucune aide-message n'est prévue pour la description.

'texte-deuxième-niveau'

Indiquez l'aide-message à afficher lorsque l'utilisateur en fait la demande. Le texte de l'aide doit être placé entre apostrophes et peut comporter jusqu'à 3000 caractères. Une ou plusieurs variables de substitution peuvent être imbriquées dans la chaîne de l'aide-message, ainsi que décrit pour le paramètre MSG.

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

Remarque :Lors du formatage de l'aide-message pour le clavier-écran, les caractères de contrôle d'édition doivent être suivis d'un blanc.

• &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 à 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 est dans le même CCSID que le travail exécutant cette commande, sauf si le paramètre CCSID est codé. Si tel est le cas, 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 gravité du message que vous définissez. Ce code correspond au niveau de gravité de la condition à l'origine du message. (99 est le niveau de gravité les plus élevé.)

00

Le code gravité attribué au message est 00. Le message n'est envoyé qu'à titre d'information.

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 le format de 1 à 99 zones de données de message. Dans ce paramètre, chaque zone est décrite par une liste d'attributs. 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).

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. Ces zones peuvent aussi être indiquées aux paramètres Données à clicher (DMPLST) et Options d'alerte (ALROPT) de cette commande. Lorsque des zones de données sont spécifiées pour le paramètre MSGDTA de la commande SNDPGMMSG (Envoyer un message programme) ou de la commande SNDUSRMSG (Envoyer un message utilisateur), ces zones doivent être concaténées en une unique chaîne de caractères et doivent respecter le format et la séquence indiqués. L'ensemble de la chaîne de caractères entrée dans une zone de données de message concaténée ne doit pas comporter plus de 512 caractères.

Valeurs uniques

*NONE

Aucun format n'est prévu pour les zones de message. Si *NONE est indiqué ou si ce paramètre est omis, il ne pourra pas être fait référence aux zones de données de message dans les paramètres Texte message de 1er niveau (MSG), Texte message de 2e niveau (SECLVL), Données à clicher (DMPLST) et Options d'alerte (ALROPT)

type ¬longueur ¬positions-décimales||

Elément 1 : Type de données

La première valeur indique le type de données de chaque zone de substitution ainsi que le formatage des données dans le texte. La deuxième et la troisième valeurs dépendent du type de données. Pour chacune des zones définies dans ce paramètre, l'un des types de données suivants peut être indiqué :

*QTDCHAR

Chaîne de caractères entre apostrophes ('Lundi 1er').

*CHAR

Chaîne de caractères ne figurant pas entre apostrophes. Il s'agit d'une chaîne de caractères alphanumériques pouvant être utilisée, par exemple, pour indiquer un nom (BOB). Les blancs de fin sont tronqués.

*HEX

Suite d'octets au format hexadécimal (X'C0F4').

*DEC

Nombre décimal condensé au format décimal signé comportant un symbole décimal (dans le message). Les valeurs indiquant la longueur (obligatoires) et les décimales (facultatives) sont indiquées pour ce type (*DEC), afin de spécifier le nombre de chiffres décimaux et le nombre de chiffres figurant sur la droite du symbole décimal. Les zéros figurant sur la gauche du premier chiffre significatif sont supprimés et les blancs de début sont tronqués (supprimés). Si une position décimale autre que zéro est spécifiée, un symbole décimal s'affiche dans le résultat, même si les décimales figurant dans le résultat sont des zéros ; par exemple, 128,00 et 128,01, si FMT(*DEC 5 2) est indiqué. Si le nombre de décimales n'est pas indiqué, zéro est pris par défaut. Voici deux exemples :

• Si FMT(*DEC 2) est indiqué pour une zone de substitution, et que les données consistent en un nombre décimal condensé (X'058C'), ce nombre figure dans le message comme une valeur positive (58), sans indication de symbole décimal.
• Si FMT(*DEC 4 2) est précisé et que le nombre condensé indiqué est X'05810C' (3 octets), le nombre décimal qui apparaît dans le texte est 58,10.

*BIN

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

*UBIN

Valeur binaire d'une longueur de 2, 4 ou 8 octets (B'0000 0000 0011 1010') 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. Si cette valeur concerne le paramètre DMPLST, ces données sont clichées (à partir de la première position indiquée par le pointeur) sur la longueur précisée dans la description de zone. *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. Si cette valeur concerne Données à clicher (DMPLST), l'objet est cliché.

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.

1. 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 de message passée par la commande SNDUSRMSG ou SNDPGMMSG doit être précédée d'une zone binaire de 2 ou 4 octets précisant le nombre d'octets de données passés. Cependant, 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 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.
2. Dans le cas d'un type de données *DEC, le nombre total de chiffres (y compris ceux figurant après le symbole décimal) doit être indiqué comme seconde valeur ; le nombre de chiffres figurant après le symbole décimal peut être indiqué comme troisième valeur mais sa mention est facultative.
3. Si le type de données indiqué est *BIN ou *UBIN, la longueur de la zone de données ne peut être que de 2, 4 ou 8 octets. La longueur par défaut est de 2 octets.
4. Si le type de données indiqué est *CCHAR, la longueur de la zone de données de message 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 transmises. Le troisième élément peut être 2 ou 4, selon le nombre d'octets utilisés pour indiquer la longueur (en binaire) de la valeur transmise. (2) Si le type de données indiqué est *DEC, le troisième élément précise le nombre de positions décimales de la valeur décimale. Si ce nombre n'est pas indiqué, 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). Par ailleurs, si la longueur des données devant se substituer à la variable est inférieure à celle indiquée, la valeur de substitution devient une zone nulle.

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.

Type de réponse (TYPE)

Indique le type de réponse qui doit être utilisé pour un message d'interrogation ou d'avertissement.

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

*NONE

Aucun type de réponse n'est indiqué et aucun contrôle de validité de la réponse n'est effectué. La valeur LEN(*NONE) doit également être indiquée pour le paramètre Longueur maximale de réponse (LEN).

*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é. Il ne doit pas nécessairement s'agir d'un nom d'objet, mais ce nom doit commencer par un caractère alphabétique suivi de caractères alphanumériques. Si tous les caractères sont alphabétiques (A-Z), la réponse en convertie en majuscules.

Longueur maximale de réponse (LEN)

Indique la longueur maximale d'une réponse à un message d'interrogation ou d'avertissement. Les valeurs indiquées sont prises en compte uniquement si au moins un autre paramètre de contrôle de validité est spécifié. Si aucun paramètre de contrôle de validité n'est spécifié, le type de réponse peut comporter jusqu'à 132 caractères.

Valeurs uniques

*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 indiqué est *CHAR ou *ALPHA, la réponse peut comporter jusqu'à 32 caractères (132 si aucun contrôle de validité n'est effectué).
• 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.

*NONE

Aucune longueur de réponse n'est définie. Si le message est envoyé en tant que message d'interrogation ou d'avertissement, aucun contrôle de validité de la réponse n'est effectué. La valeur *NONE doit aussi être indiqué au paramètre TYPE (Type de réponse).

Elément 1 : Longueur

longueur

Entrez la longueur maximale que pourra avoir la réponse.

Elément 2 : Nombre de positions décimales

positions-décimales

Entrez la longueur maximale que pourra avoir la réponse. La longueur indiquée ne peut pas excéder les limites définies pour la valeur *TYPE. Si *DEC est indiqué au paramètre Type de réponse (TYPE), vous pouvez éventuellement préciser le nombre de positions décimales admises.

Valeurs correctes de réponse (VALUES)

Affiche une liste de valeurs représentant chacune une réponse valide à un message d'interrogation ou d'avertissement. 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) et 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). Pour être valide, une réponse doit correspondre à l'une des valeurs de la liste.

Pour que la valeur de réponse corresponde à la valeur de comparaison, les deux valeurs doivent se présenter dans la même casse. Par exemple, si le programme exige une réponse contenant uniquement des caractères en majuscules, l'une des méthodes suivantes permettra d'obtenir une réponse en majuscules :

• Demander une réponse en caractères majuscules.
• Entrer les valeurs de comparaison en minuscules pour le paramètre VALUES et spécifier un paramètre SPCVAL pour la conversions des caractères en majuscules.
• Utiliser la valeur clavier TYPE(*NAME) pour convertir les caractères en majuscules. Pour cette méthode, la réponse ne doit être composée que de caractères alphabétiques (de A à Z).

Valeurs uniques

*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é.

Autres valeurs

valeur-de-comparaison

Indiquez une liste de 20 valeurs au maximum qui seront comparées à celles de la réponse envoyée pour le message défini dans la description de message. Pour constituer une valeur de réponse valide à ce message, la valeur de réponse doit correspondre à l'une des valeurs de la liste. La longueur maximale de chacune de ces valeurs est de 32 caractères.

Valeurs spéciales de réponse (SPCVAL)

Affiche une liste de groupes de valeurs spéciales (20 au maximum), chaque groupe pouvant constituer une réponse à un messages d'interrogation ou d'avertissement. Les valeurs de la réponse envoyée sont comparées à la valeur d'origine de chaque groupe. S'il existe une correspondance et si une valeur de destination a été indiquée pour le groupe, cette valeur de destination est envoyée en réponse. Dans le cas contraire, c'est la valeur d'origine qui est envoyée.

La valeur de destination 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 ne correspond à aucune valeur d'origine, les autres paramètres liés à la réponse sont soumis à un contrôle de validité.

Valeurs uniques

*NONE

Aucune valeur spéciale n'est prévue pour les réponses à ce message.

valeur-d'origine ¬valeur de destination|

Entrez une liste de groupes de valeurs spéciales (20 au maximum) qui vont constituer les réponses possibles au message. Chaque groupe doit avoir une valeur d'origine avec laquelle la réponse est comparée, et vous pouvez indiquer une valeur de destination, celle-ci étant envoyée en tant que réponse si la valeur d'origine associée correspond à la réponse.

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 les limites de longueur supérieure et inférieure que doivent respecter une valeur pour constituer une réponse valide à un message d'interrogation ou d'avertissement. Ces valeurs doivent remplir les conditions indiquées aux paramètres Type de réponse (TYPE) et Longueur maximale de réponse (LEN), et elles doivent par ailleurs être du même type. Si les valeurs n'ont pas la même longueur, la plus courte est complétée à droite par des blancs. Si la réponse est de type *CHAR ou *ALPHA, celle-ci est soit complétée à droite par des blancs, soit tronquée à droite à la longueur spécifiée avant que la plage de valeurs ne fasse l'objet d'un 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

*NONE

Aucune valeur de limite n'est prévue pour les réponses à ce 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 la relation qui doit exister entre la valeur indiquée et la réponse pour que celle-ci constitue une réponse valide à un message d'interrogation ou d'avertissement. 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, celle-ci est soit complétée à droite par des blancs, soit tronquée à droite à la longueur spécifiée avant que le système n'effectue le test relationnel sur la valeur de réponse envoyée.

Ce paramètre est incompatible avec les paramètres VALUES (Valeurs correctes de réponse) et RANGE (Plage de valeurs de réponse).

Valeurs uniques

*NONE

Aucune valeur de relation n'est prévue pour les réponses à ce message.

Elément 1 : Opérateur relationnel

valeur-opérateur

Indiquez l'un des opérateurs de relation suivants et la valeur à laquelle devra être comparée la réponse. Si le test relationnel établit la validité de la réponse, celle-ci est envoyée à l'expéditeur du message. Vous pouvez utiliser les 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 à utiliser pour la comparaison avec une valeur de réponse à un message.

Réponse par défaut (DFT)

Dans le cas d'un message envoyé en tant que message d'interrogation ou d'avertissement, indique la réponse par défaut à utiliser (réponse placée entre apostrophes si elle comporte des caractères spéciaux) lorsque le destinataire du message a spécifié que tous les messages entrants devaient faire l'objet de réponses par défaut 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 également être utilisée pour répondre à des messages d'avertissement non interceptés. Cette réponse doit remplir les conditions indiquées pour les paramètres Type de réponse (TYPE) et Longueur maximale de réponse (LEN).

*NONE

Aucune réponse par défaut n'est prévue pour ce message.

'réponse-par-défaut'

Entrez la réponse par défaut à envoyer pour les messages d'interrogation ou d'avertissement (si cette réponse comporte des caractères spéciaux, placez-la entre apostrophes).

Pgm par défaut à appeler (DFTPGM)

Indique le nom qualifié de tout programme par défaut appelé pour exécuter une action par défaut lors de l'envoi de ce message (en tant que message d'arrêt programme) à un programme ou une procédure qui ne l'intercepte pas. Ce paramètre n'est pas pris en compte si le message n'est pas envoyé en tant que message d'arrêt programme. Si le message est envoyé en tant que message d'arrêt programme, les paramètres suivants sont transmis au programme par défaut indiqué :

• Nom du programme ou de la procédure auquel le message est envoyé (277 caractères). Nom du programme, du module et de la procédure ainsi que le type du programme de la file d'attente de messages de liste d'appel dans laquelle le message est envoyé. Il s'agit du même nom que celui du programme ou de la procédure qui n'a pas intercepté le message d'arrêt programme.

  Les caractères 1 à 10 représentent le nom du programme auquel le message est envoyé.

  Les caractères 11 à 20 représentent le nom du module auquel le message est envoyé. Si ce message n'est pas dirigé vers une procédure ILE (Integrated Language Environment), la valeur *N est renvoyée dans cette zone et complétée par des blancs.

  Les caractères 21 à 276 représentent le nom de la procédure à laquelle le message est envoyé. Si ce dernier n'est pas envoyé à une procédure ILE, la valeur *N est renvoyée dans cette zone, elle-même complétée par des blancs.

  La valeur du caractère 277 est fixée à 1 si le message est envoyé à une procédure ILE. Sinon, cette valeur est 0.

• 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

*NONE

Aucun programme par défaut n'est prévu pour ce 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 aucune entrée de bibliothèque en cours ne figure dans la liste des bibliothèques, la bibliothèque QGPL est utilisée 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 lorsque le message est dirigé en tant que message d'arrêt programme vers 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 souhaitez que les données de certaines zones du message soient clichées, ce paramètre vous permet d'indiquer un ou plusieurs numéros pour spécifier le positionnement de ces zones.

Les objets système indiqués par les pointeurs système font l'objet d'un cliché complet. 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é. Si les messages d'arrêt programme ne sont pas interceptés par le programme vers lequel ils sont dirigés, les clichés sont pris au titre des actions par défaut du système.

Valeurs uniques

*NONE

Aucune liste de clichés n'est prévue pour ce message. Aucun cliché n'est donc pris.

Autres valeurs

*JOB

Cette valeur équivaut à indiquer * pour le paramètre Travail (JOB) et *PRINT pour le paramètre Sortie (OUTPUT) de la commande DSPJOB (Afficher travail). Pour plus de détails, reportez-vous à la description de la commande DSPJOB.

*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 au processus machine dans le cadre duquel s'exécute le travail sont clichées dans l'historique des erreurs machine, ainsi que spécifié pour la commande DMPJOBINT. 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 à clicher lorsqu'un message d'arrêt programme est envoyé mais non intercepté. Vous pouvez indiquer jusqu'à 99 numéros de zones de données. Par ailleurs, la liste peut contenir les valeurs *JOB, *JOBINT et *JOBDMP.

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 tout détail, reportez-vous au manuel IBM i Information Center, à l'adresse http://www.ibm.com/systems/i/infocenter/, ensemble de rubriques Gestion des systèmes, section Paramètres des valeurs système.
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.

Niveau de message(LVL)

Indique l'identificateur de niveau de la description de message en cours de définition. Cet identificateur se compose de la date de création du message et d'un numéro de deux chiffres qui lui est propre.

Elément 1 : Date de création

*CURRENT

La date du jour constitue la première partie de l'identification de niveau de description de message.

date-création

Indiquez la date à laquelle la description du message est définie. La date doit figurer au format défini par les valeurs système QDATFMT et (si des séparateurs sont utilisés) QDATSEP.

Elément 2 : Numéro de niveau

1

Le numéro 1 constitue la seconde partie de l'identificateur de niveau de description de message.

1-99

Indiquez un nombre (de 1 à 99) permettant de différencier l'identificateur de la description de message.

Options d'alerte (ALROPT)

Indique l'option d'alerte associée aux messages dirigés vers l'historique du système (QHST) ou vers la file d'attente de messages de l'opérateur système (QSYSOPR). Il s'agit de messages qui sont adressés au système hôte pour lui indiquer qu'une erreur s'est produite.

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 ou QSYSOPR.

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

*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 indiqué pour les paramètres MSG et SECLVL. Si le fichier message dans lequel est ajoutée cette description de message a un CCSID autre que 65534 ou 65535, le CCSID du texte fourni est remplacé par le CCSID du fichier message. Sinon, le texte n'est pas converti, mais le CCSID est sauvegardé au cas où une conversion s'avérerait nécessaire pour une fonction d'extraction ou d'affichage. 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/.

*JOB

Le système considère que cette description de message a pour CCSID celui du travail exécutant cette commande.

*HEX

Le texte de cette description de message n'est pas converti et est marquée à 65535.

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 acceptés les CCSID possibles pour le travail concerné.

Exemples

Exemple 1 : Définition de message

ADDMSGD   MSGID(UIN0115)  MSGF(INV)
          MSG('Tapez le nom du service de l'utilisateur')
          SECLVL('Services admis :  &B X12 &B X13 &B X14')
          TYPE(*CHAR)  LEN(3)  DFT('ZZZ')

Cette commande définit un message et le stocke dans un fichier appelé INV sous l'identificateur UIN0115. Le message fournit un texte de message de second niveau en utilisant le caractère de formatage &B pour afficher les trois noms de service admis (X12, X13 et X14), chacun sur une ligne. La réponse nécessite un contrôle de validité pour qu'une réponse correcte ne puisse être qu'un identificateur de 3 caractères. La réponse par défaut ZZZ est également fournie.

Exemple 2 : Définition d'une description de message

ADDMSGD   MSGID(UPY0047)  MSGF(PAYLIB/TIMECARD)
          MSG('Pour semaine &1, &2 feuilles de temps. Les autres ?')
          FMT((*CHAR 8) (*CHAR 3))  TYPE(*ALPHA)  LEN(1)
          VALUES(N  Y)  SPCVAL((YES Y)(NO N))  DFT(N)

Cette commande définit une description de message qui est stockée dans le fichier message TIMECARD de la bibliothèque PAYLIB. Le programme qui traite les feuilles de temps peut envoyer un message (sous forme de message de type interrogation) indiquant le nombre de feuilles de temps (dans &2) ont été traitées pour la semaine (indiqué dans &1). Pour envoyer ce message à un utilisateur via une file d'attente de messages, le programme doit utiliser la commande SNDPGMMSG ou SNDUSRMSG. Dans cet exemple, la commande indique :

• L'identificateur de ce message (UPY0047)
• Le fichier (TIMECARD) qui contient ce message
• La date de la feuille de temps, sur 8 caractères (par exemple 09/15/88) ; il doit s'agir de la première valeur contenue dans le paramètre MSGDTA
• Le nombre de feuille de temps sur 3 chiffres maximum (par exemple 125)

Si la réponse envoyée est YES, Y est accepté (paramètre SPCVAL). Si la réponse envoyée est NO, N est accepté. Si la réponse n'est ni YES ni NO, sa validité est vérifiée par les paramètres TYPE, LEN et VALUES. Si l'utilisateur le désire, aucune réponse n'est envoyée et le système prend la réponse par défaut (N).

Exemple 3 : Définition d'un message d'arrêt programme

ADDMSGD   MSGID(UPY1234)  MSGF(PAYLIB/TIMECARD)
          MSG('Impôts de l'employé &1 > à son salaire brut.')
          SEV(75)  FMT((*CHAR  6) (*DEC  9  2) (*CHAR  8))
          DFTPGM(PAYLIB/BADTAX)  DMPLST(1  2  3 *JOB)

Cette commande définit un message d'arrêt système. L'expéditeur du message transmet trois valeurs de données, la première (numéro de série de l'employé) servant de texte de remplacement dans le message. Si ce message est envoyé en tant que message d'arrêt programme et que le programme auquel il est envoyé n'intercepte pas le message UPY1234, le système adopte l'action par défaut. Ceci revient, notamment, à clicher les trois valeurs de données qui ont été transmises, ainsi que la structure du travail. Une fois le cliché effectué, le programme BADTAX est appelé.

Pour de plus amples renseignements sur l'interception de messages, reportez-vous à la commande MONMSG (Intercepter message).

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.

CPF2412

ID msg &1 existe déjà dans fichier message &2 de &3.

CPF2430

Description de message non ajoutée au fichier message.

CPF2461

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

CPF2483

fichier message en cours d'utilisation.

CPF2510

Dommage logique sur fichier message &1 de &2.

CPF9830

Allocation de la bibliothèque &1 impossible.

CPF9838

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