ADDEXITPGM

La commande Ajouter un programme d'exit (ADDEXITPGM) ajoute une entrée de programme d'exit pour un point d'exit donné. Chaque point d'exit peut avoir une seule entrée ou plusieurs entrées. Le numéro de programme d'exit indique l'ordre d'exécution des programmes d'exit. The Add Exit Program (ADDEXITPGM) command adds an exit program entry for a specific exit point. Each exit point can have a single entry or multiple entries. The exit program number indicates the sequence in which the exit programs are run.

Paramètres

Point d'exit (EXITPNT)Exit point (EXITPNT)

Indique le nom du point d'exit auquel le programme d'exit est ajouté. Si aucun point d'exit de ce nom n'existe et que CRTEXITPNT(*YES) est indiqué, un point d'exit est créé. Specifies the exit point name to which the exit program is added. If no exit point by this name exists, and CRTEXITPNT(*YES) is specified, an exit point is created.

Format du point d'exit (FORMAT)Exit point format (FORMAT)

Indique le nom du format de point d'exit du programme d'exit ajouté. Specifies the exit point format name of the exit program that is added.

Numéro de programme (PGMNBR)Program number (PGMNBR)

Indique l'ordre d'exécution des programmes d'exit lorsque plusieurs programmes de point d'exit sont définis pour un même point d'exit. Specifies the sequence in which the exit programs are run when multiple exit point programs for a specific exit point are defined.

Les valeurs possibles sont : The possible values are:

*LOW

Le plus petit numéro disponible pour ce point d'exit est attribué. The lowest available number for that specific exit point is assigned.

*HIGH

Le plus grand numéro disponible pour ce point d'exit est attribué. The highest available number for that specific exit point is assigned.

program-number

Indiquez le numéro de séquence du programme d'exit. Les valeurs valides vont de 1 à 2 147 483 647. L'ordre de traitement va du plus petit numéro au plus grand. Les numéros de programme d'exit n'ont pas besoin d'être consécutifs. Specify the exit program sequence number. Valid values range from 1 through 2,147,483,647. Processing sequence is from the lowest number to the highest number. Exit program numbers do not need to be consecutive.

Programme (PGM)

Indique le nom du programme d'exit à appeler. Le programme n'a pas besoin d'exister sur le système lors de l'exécution de cette commande. Specifies the name of exit program to be called. The program does not have to exist on the system when this command is run.

Le nom du programme d'exit peut être qualifié par l'une des valeurs de bibliothèque suivantes : The name of the exit program can be qualified by one of the following library values:

*CURLIB

La bibliothèque en cours de l'unité d'exécution est recherchée. Si aucune bibliothèque en cours n'est définie pour l'unité d'exécution, la bibliothèque QGPL est utilisée. The current library for the thread is searched. If no library is specified as the current library for the thread, the QGPL library is used.

nom-bibliothèque

Indiquez le nom de la bibliothèque dans laquelle se trouve le programme d'exit. Specify the name of the library where the exit program is located.

La valeur possible est : The possible value is:

program-name

Indiquez le nom du programme d'exit. Specify the name of the exit program.

Unités d'exécution protégées (THDSAFE)

Indiquez l'attribut de compatibilité multitâche de l'entrée de programme d'exit. Si vous ne connaissez pas le statut de compatibilité multitâche de l'entrée de programme d'exit, utilisez la valeur par défaut *UNKNOWN. Specify the threadsafe attribute for the exit program entry. If you do not know the threadsafety status of the exit program entry, use the default value of *UNKNOWN.

Les valeurs possibles sont : The possible values are:

*UNKNOWN

Le statut de compatibilité multitâche de cette entrée de programme d'exit n'est pas connu. The threadsafety status of this exit program entry is not known.

*NO

L'entrée de programme d'exit n'est pas compatible multitâche. The exit program entry is not threadsafe.

*YES

L'entrée de programme d'exit est compatible multitâche. The exit program entry is threadsafe.

Action travail exéc multiples (MLTTHDACN)

Indiquez l'action à effectuer pour cette entrée de programme d'exit dans un travail multitâche. Si vous ne connaissez pas l'action à effectuer dans un travail multitâche, utilisez la valeur par défaut *SYSVAL. Specify the multithreaded job action for this exit program entry. If you do not know the action to take in a multithreaded job, use the default value of *SYSVAL.

Les valeurs possibles sont : The possible values are:

*SYSVAL

L'action de travail multitâche indiquée dans la valeur système QMLTTHDACN est utilisée. The multithreaded job action specified in the QMLTTHDACN system value is used.

*RUN

Exécute l'entrée de programme d'exit. Run the exit program entry.

*MSG

Exécute l'entrée de programme d'exit et envoie un message d'information. Run the exit program entry and send an informational message.

*NORUN

N'exécute pas l'entrée de programme d'exit. Do not run the exit program entry.

Texte 'descriptif' (TEXT)

Indique le texte qui décrit brièvement le programme d'exit. Specifies the text that briefly describes the exit program.

Les valeurs possibles sont : The possible values are:

*BLANK

Aucun texte n'est indiqué. No text is specified.

*MSGID

La description est extraite du message indiqué par les paramètres MSGID et MSGF. Elle est récupérée lorsque les informations sur le programme d'exit sont affichées à l'aide de la commande WRKREGINF (Gérer les informations d'enregistrement) ou récupérées à l'aide de l'API QusRetrieveExitInformation. The description is taken from the message specified by the MSGID and MSGF parameters. The description is retrieved when exit program information is displayed using the WRKREGINF (Work with Registration Information) command or retrieved using the QusRetrieveExitInformation API.

'description'

Indiquez 50 caractères de texte au maximum, placés entre apostrophes. Specify no more than 50 characters of text, enclosed in apostrophes.

Identificateur de message (MSGID)

Indique l'identificateur du message qui contient le texte décrivant le programme d'exit. Le message est extrait du fichier de messages indiqué par le paramètre MSGF. Ce paramètre ne peut être indiqué que si TEXT(*MSGID) est indiqué. Specifies the message identifier that contains the text that describes the exit program. The message is retrieved from the message file specified by the MSGF parameter. This parameter can only be specified if TEXT(*MSGID) is specified.

Les valeurs possibles sont : The possible values are:

message-identifier

Indiquez l'identificateur de message à sept caractères du message qui décrit le programme d'exit. Specify the seven-character message identifier of the message that describes the exit program.

Fichier de messages (MSGF)fichier message (MSGF)

Indique le fichier de messages et la bibliothèque qui contiennent le message indiqué par le paramètre MSGID. Ce paramètre ne peut être indiqué que si TEXT(*MSGID) est indiqué. Le nom du fichier de messages est qualifié par l'une des valeurs de bibliothèque suivantes : Specifies the message file and library that contains the message specified by the MSGID parameter. This parameter can only be specified if TEXT(*MSGID) is specified. The name of the message file is qualified by one of the following library values:

*LIBL

Toutes les bibliothèques de la liste de bibliothèques de l'unité d'exécution en cours sont recherchées jusqu'à ce que la première occurrence soit trouvée. All libraries in the library list for the current thread are searched until the first match is found.

nom-bibliothèque

Indiquez le nom de la bibliothèque dans laquelle se trouve le fichier de messages. Specify the name of the library where the message file is located.

Les valeurs possibles sont : The possible values are:

message-file

Indiquez le nom du fichier de messages. Specify the name of the message file.

Remplacer l'entrée existante (REPLACE)Replace existing entry (REPLACE)

Indiquez si les attributs et les données d'une entrée de programme d'exit sont remplacés. De nouvelles valeurs pour les données du programme et pour le texte ou l'identificateur de message peuvent être indiquées. Le nom du programme et la bibliothèque ne peuvent pas être modifiés. Specify whether the attributes and data for an exit program entry are replaced. New values for the program data and the text or message identifier can be specified. The program name and library cannot be changed.

Les valeurs possibles sont : The possible values are:

*NO

Ne remplace pas les attributs et les données d'un programme d'exit. Do not replace the attributes and data for an exit program.

*YES

Remplace les attributs et les données d'une entrée de programme d'exit. Replace the attributes and data for and exit program entry.

Créer un point d'exit (CRTEXITPNT)Create exit point (CRTEXITPNT)

Indiquez si le point d'exit est créé automatiquement s'il n'existe pas déjà. Specify whether the exit point is automatically created if it does not already exist.

Les valeurs possibles sont : The possible values are:

*NO

Ne crée pas le point d'exit. Si le point d'exit indiqué n'existe pas, le programme d'exit n'est pas ajouté et un message d'erreur est renvoyé. Do not create the exit point. If the specified exit point does not exist the exit program is not added and an error message is returned.

*YES

Crée le point d'exit indiqué. Create the specified exit point.

Données du programme d'exit (PGMDTA)Exit program data (PGMDTA)

Indique les données transmises au programme d'exit. Ces données doivent correspondre aux données d'entrée définies par le fournisseur du point d'exit. Specifies the data that is passed to the exit program. This data should correspond to the input data defined by the exit point provider.

Les valeurs possibles sont : The possible values are:

*NONE

Aucune donnée n'est transmise au programme d'exit. No data is passed to the exit program.

Les valeurs possibles du CCSID des données du programme sont : The possible CCSID for program data values are:

*JOB

Le CCSID (identificateur de jeu de caractères codés) du travail en cours est utilisé. The CCSID (coded character set identifier) of the current job is used.

CCSID-for-data

Indiquez le CCSID associé aux données transmises au programme d'exit. Specify the CCSID associated with the data passed to the exit program.

Les valeurs possibles de la longueur des données du programme sont : The possible Length of program data values are:

*CALC

La longueur est déterminée par le nombre d'octets indiqué pour le troisième élément de ce paramètre. The length is determined by the number of bytes specified for the third element of this parameter.

length-of-data

Indiquez le nombre d'octets de données transmis au programme d'exit. Specify the number of bytes of data passed to the exit program.

La valeur possible des données du programme est : The possible Program data value is:

program-data

Indiquez les données du programme, en caractères ou en hexadécimal, à transmettre au programme d'exit. Si vous indiquez plus de données de programme que la longueur indiquée, les données transmises au programme d'exit sont tronquées. Si vous en indiquez moins, les données transmises au programme d'exit sont complétées à droite par des blancs. Vous pouvez indiquer jusqu'à 2048 octets de données de programme. Specify the character or hexadecimal program data to be passed to the exit program. If you specify more program data than the length specified, the program data passed to the exit program is truncated. If you specify less program data than the length specified, the program data passed to the exit program is padded on the right with blanks. You can specify up to 2048 bytes of program data.

Exemples

ADDEXITPGM   EXITPNT(USER_EXIT_ONE)  FORMAT(EXIT1)  PGMNBR(1)
             PGM(LIB2/MYPGM)  TEXT(*MSGID)  MSGID(TXT2345)
             MSGF(LIB1/MYMSGF)

Cette commande ajoute le programme d'exit MYPGM de la bibliothèque LIB2 au point d'exit USER_EXIT_ONE. Il s'agit du premier programme d'exit exécuté pour ce point d'exit. La description textuelle du programme d'exit est extraite du message TXT2345 du fichier de messages MYMSGF de la bibliothèque LIB1. Aucune donnée de programme n'est transmise au programme d'exit. This command adds exit program MYPGM in library LIB2 to exit point USER_EXIT_ONE. This is first exit program run for the exit point. The text description for the exit program is retrieved from message TXT2345 in message file MYMSGF in library LIB1. No program data is passed to the exit program.

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF0001

Erreur trouvée dans la commande &1.