GENCAT

Cette commande est l'équivalent de la commande MRGMSGCLG (Fusionner catalogues de messages) et vous pouvez également l'exécuter en utilisant cet autre nom de commande :

• MRGMSGCLG

La commande GENCAT (Générer catalogue de messages) fusionne le texte de message d'un ou plusieurs fichiers source (paramètre SRCFILE) avec le texte de message du catalogue de messages indiqué (paramètre CLGFILE). Si ce catalogue n'existe pas encore, il est créé à l'aide des valeurs précisées aux paramètres CLGCCSID, DTAAUT et OBJAUT. S'il existe, les attributs CCSID, DTAAUT et OBJAUT du catalogue de messages sont utilisés.

Vous pouvez mentionner jusqu'à 300 fichiers source de texte de message. Ceux-ci sont traités dans l'ordre indiqué. Chaque fichier source modifie successivement le catalogue. Lorsqu'un numéro de message du fichier source existe déjà dans le catalogue, le nouveau texte de message défini dans le fichier source remplace l'ancien message. Si un numéro de message ne figure pas dans le catalogue de messages, les informations du message sont ajoutées au catalogue.

Paramètres

Nom du catalogue de messages (CLGFILE)

Indique le nom de chemin du catalogue de messages à modifier ou à créer. Tous les répertoires d'un nom de chemin de fichier STREAM doivent exister. Si aucun fichier n'existe dans ce chemin, un catalogue de messages portant le nom de fichier indiqué est créé. Si le nom de chemin appartient au système de fichiers QSYS, le fichier doit exister. Si un membre de fichier du système QSYS n'existe pas, il est créé. Les fichiers physiques source comportant des zones de données multiples ne sont pas pris en charge.

Nom chemin fichier source (SRCFILE)

Indique le nom de chemin du fichier source contenant le texte de message à fusionner dans le catalogue. Si le fichier provient du système de fichiers QSYS, il doit être un fichier physique source base de données.

Remarque :Si le fichier source n'est pas un fichier enregistrement, chaque ligne doit avoir été terminée par une nouvelle ligne ou par un caractère de saut de ligne lors de la création du fichier.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement le catalogue de messages.

Remarque :L'affectation de texte à des objets dépend de la prise en charge fournie par le système de fichiers ou le type d'objet utilisé pour le catalogue de messages.

Les valeurs possibles sont les suivantes :

*BLANK

Le nom de mode formé de 8 espaces est utilisé.

'descriptif'

Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

CCSID du catalogue de messages (CLGCCSID)

Indique l'ID codé de jeu de caractères (CCSID) dans lequel stocker le texte de message dans le catalogue. Si le catalogue est un fichier STREAM, la valeur de CCSID entrée est utilisée pour définir les attributs du fichier STREAM. La commande WRKLNK (Gérer les liens d'objet) permet d'afficher le CCSID d'un catalogue de messages. La commande DSPFD (Afficher une description de fichier) permet de déterminer le CCSID d'un catalogue de messages dans le système de fichiers QSYS.

Les valeurs possibles sont les suivantes :

*SRCCCSID

Valeur spéciale indiquant que le CCSID sera déterminé à partir de la valeur précisée pour le CCSID du fichier source (paramètre SRCCSID).

*JOB

Valeur spéciale indiquant que le CCSID du travail est utilisé pour les informations de catalogue. Si le CCSID du travail est 65535, le CCSID par défaut de ce dernier est utilisé.

ID-codé-jeu-caractères

Indiquez le CCSID à utiliser pour les informations de catalogue. Les valeurs 0, 65534 et 65535 ne sont pas admises.

CCSID du fichier source (SRCCCSID)

Indique l'ID codé de jeu de caractères (CCSID) du fichier source.

Les valeurs possibles sont les suivantes :

*SRCFILE

Valeur spéciale indiquant que le CCSID sera déterminé à partir du CCSID du premier fichier source (paramètre SRCFILE).

*JOB

Valeur spéciale indiquant que le CCSID du travail est utilisé comme CCSID pour le fichier source. Si le CCSID du travail est 65535, le CCSID par défaut de ce dernier est utilisé.

ID-codé-jeu-caractères

Indiquez le CCSID du fichier source. Les valeurs 0, 65534 et 65535 ne sont pas admises.

Droits publics sur données (DTAAUT)

Indique les droits publics accordés aux utilisateurs sur les données contenues dans l'objet créé.

Les valeurs possibles sont les suivantes :

*INDIR

Les droits sur l'objet dépendent de ceux associés au répertoire dans lequel il est créé. Si *INDIR est indiqué pour DTAAUT, il est requis également pour OBJAUT.

*RWX

L'utilisateur dispose des droits *RWX sur l'objet. Cela permet d'exécuter toutes les opérations, à l'exception de celles qui sont réservées au propriétaire ou contrôlées par les droits d'existence sur l'objet, de gestion de l'objet, de modification des attributs de l'objet et de référence sur l'objet. L'utilisateur peut donc modifier l'objet et exécuter les fonctions de base, les droits *RWX comprenant les droits opérationnels et tous les droits sur les données.

*RX

Les droits *RX permettent à l'utilisateur d'exécuter les opérations de base sur l'objet, telles que l'exécution d'un programme ou l'affichage du contenu d'un fichier. En revanche, il ne peut pas modifier l'objet. Les droits *RX incluent les droits opérationnels sur l'objet et les droits de lecture et d'exécution.

*RW

Les droits *RW permettent à l'utilisateur de visualiser et de modifier le contenu de l'objet. Ils incluent les droits opérationnels et les droits de lecture, d'ajout, de mise à jour et de suppression de données.

*WX

Les droits *WX permettent à l'utilisateur de modifier le contenu de l'objet, d'exécuter un programme ou de rechercher une bibliothèque ou un répertoire. Ils incluent les droits opérationnels, les droits d'ajout, de mise à jour et de suppression de données, ainsi que les droits d'exécution.

*R

Les droits *R permettent à l'utilisateur de visualiser le contenu de l'objet. Ils incluent les droits opérationnels et les droits de lecture.

*W

Les droits *W permettent à l'utilisateur de modifier le contenu de l'objet. Ils incluent les droits opérationnels et les droits d'ajout, de mise à jour et de suppression de données.

*X

Les droits *X permettent à l'utilisateur d'exécuter un programme ou de rechercher une bibliothèque ou un répertoire. Ils incluent les droits opérationnels et les droits d'exécution.

*EXCLUDE

La valeur spéciale EXCLUDE empêche l'utilisateur d'accéder à l'objet. Si vous l'utilisez, vous devez indiquer *NONE pour OBJAUT.

*NONE

Les utilisateurs ne disposent d'aucun droit sur les données de l'objet. Vous ne pouvez pas utiliser cette valeur si *NONE est indiqué pour OBJAUT.

nom-liste-autorisation

Indiquez le nom de la liste d'autorisation utilisée.

Droits publics sur l'objet (OBJAUT)

Indique les droits sur l'objet accordés aux utilisateurs.

Les valeurs possibles sont les suivantes :

*INDIR

Les droits sur l'objet dépendent de ceux associés au répertoire dans lequel il est créé. Si *INDIR est indiqué pour DTAAUT, il est requis également pour OBJAUT.

*NONE

Aucun des autres droits sur l'objet (existence, gestion, modification des attributs et référence) n'est accordé aux utilisateurs. Vous devez indiquer cette valeur si *EXCLUDE ou un nom de liste d'autorisation est spécifié pour le paramètre DTAAUT.

*ALL

Tous les autres droits sur l'objet (existence, gestion, modification des attributs et référence) sont accordés aux utilisateurs.

Vous pouvez également indiquer quatre valeurs au maximum parmi les suivantes :

*OBJEXIST

Accorde aux utilisateurs les droits d'existence sur l'objet.

*OBJMGT

Accorde aux utilisateurs les droits de gestion de l'objet.

*OBJALTER

Accorde aux utilisateurs les droits de modification des attributs de l'objet.

*OBJREF

Accorde aux utilisateurs les droits de référence sur l'objet.

Exemples

Exemples pour MRGMSGCLG

MRGMSGCLG   CLGFILE('/USDIR/USMSG.CAT')  CLGCCSID(*SRCCSID)
            SRCFILE('/QSYS.LIB/MYLIB.LIB/MSGSRC.FILE/USMSG.MBR')
            DTAAUT(*R)  TEXT('Catalogue messages pour Etats-Unis')

Cette commande permet de fusionner le texte de message du membre USMSG du fichier physique source MSGSRC (bibliothèque MYLIB, système de fichiers QSYS) avec le catalogue de messages USMSG.CAT du répertoire USDIR. Si le catalogue de messages n'existe pas, il est créé avec le CCSID du fichier source et le droit de lecture de données (*R). Le paramètre TEXT indique qu'il s'agit d'un catalogue de messages pour les Etats-Unis.

Messages d'erreur

Messages *ESCAPE

CPF3BE3

Le catalogue de messages &1 n'a pas été créé ni mis à jour. Message catalog &1 not created or updated.