EXTPGMINF

Extraire informations programme

Extract Program Information

En bref

La commande Extraire les informations de programme (EXTPGMINF) extrait les informations de liaison externe des objets programme EPM (extended program model) et stocke ces informations dans un fichier d'informations de bibliothèque. The Extract Program Information (EXTPGMINF) command extracts external linkage information from extended program model (EPM) program objects, and stores this information in a library information file.

Syntaxe minimale

EXTPGMINF PGM(…) FILE(…)

Paramètres

PGM Programme Program obligatoire
FILE Fichier devant recevoir les informations File to receive information obligatoire
OPTION Options d'extraction des enregistrements Extract record options
CRTFILE Créer le fichier Create the file
RECLIB Nom de bibliothèque à enregistrer Library name to record
CHECK Contrôle de cohérence Consistency Check

Astuce : dans une session 5250, tapez EXTPGMINF puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande Extraire les informations de programme (EXTPGMINF) extrait les informations de liaison externe des objets programme EPM (extended program model) et stocke ces informations dans un fichier d'informations de bibliothèque. Les informations de liaison externe, qui comprennent les variables externes et les points d'entrée, ne peuvent être extraites que d'objets programme EPM. Les compilateurs C/400*, FORTRAN/400* et Pascal produisent des objets programme EPM. The Extract Program Information (EXTPGMINF) command extracts external linkage information from extended program model (EPM) program objects, and stores this information in a library information file. External linkage information, which includes external variables and entry points, can only be extracted from EPM program objects. The C/400*, FORTRAN/400*, and Pascal compilers produce EPM program objects.

Un fichier d'informations de bibliothèque est un ensemble d'informations de liaison pour un groupe de programmes associés. Le nom du fichier d'informations de bibliothèque est utilisé dans le paramètre LIBFILE de la commande SETPGMINF. Par exemple, un fichier d'informations de bibliothèque est fourni pour l'ensemble des programmes qui constituent la bibliothèque d'exécution C/400. A library information file is a collection of the linkage information for a set of related programs. The library information file name is used on the LIBFILE parameter of the SETPGMINF command. For example, a library information file is provided for the set of programs that make up the C/400 run-time library.

La commande EXTPGMINF permet de créer un fichier destiné à stocker les noms de tous les points d'entrée concernés de votre application, au lieu d'indiquer le nom de chaque objet programme dans le paramètre SUBPGM de la commande SETPGMINF. The EXTPGMINF command lets you create a file to store the names of all the affected entry points in your application, instead of specifying each program object name on the SUBPGM parameter of the SETPGMINF command.

Messages d'erreur EXTPGMINF

Aucun

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
PGM	ProgrammeProgram	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1 : ProgrammeQualificatif 1: Program	Nom générique, nom, *ALL
	Qualificatif 2: BibliothèqueQualificatif 2: Library	Nom, LIBL, USRLIBL, *CURLIB
FILE	Fichier devant recevoir les informationsFile to receive information	Nom d'objet qualifié	Obligatoire, positionnel 2
	Qualificatif 1: Fichier devant recevoir les informationsQualificatif 1: File to receive information	Nom
	Qualificatif 2: BibliothèqueQualificatif 2: Library	Nom, LIBL, CURLIB
OPTION	Options d'extraction des enregistrementsExtract record options	REPLACE, DELETE, *UPDATE	Facultatif, positionnel 3
CRTFILE	Créer le fichierCreate the file	NO, YES	Facultatif
RECLIB	Nom de bibliothèque à enregistrerLibrary name to record	Nom, LIBL, FOUND	Facultatif
CHECK	Contrôle de cohérenceConsistency Check	ALL, ENTRY, DATA, NONE	Facultatif

Programme (PGM)Program (PGM)

Le paramètre PGM indique le nom du programme et de la bibliothèque qui contiennent les informations de liaison à extraire. Ce paramètre est obligatoire. The PGM parameter specifies the name of the program and library that contains the linkage information you want to extract. This is a required parameter.

program-name: Entrez le nom d'un programme qui contient les informations de liaison à extraire. Enter the name of a program that contains the linkage information you want to extract.
generic*: Entrez un nom générique pour les programmes qui contiennent les informations de liaison à extraire. Enter a generic name for the programs that contain the linkage information you want to extract.
*ALL: Les informations de liaison sont extraites de tous les programmes qui existent dans la bibliothèque. Linkage information is extracted from all the programs that exist in the library.

Les valeurs de bibliothèque possibles sont les suivantes : The possible library values are:

*LIBL: Le système recherche dans la liste de bibliothèques. Vous ne pouvez pas indiquer *LIBL si vous indiquez CRTFILE(*YES). The system searches the library list. You cannot specify *LIBL if you specify CRTFILE (*YES).
*USRLIBL: Le système recherche dans la partie utilisateur de la liste de bibliothèques. The system searches the user portion of the library list.
*CURLIB: Le nom de la bibliothèque en cours est utilisé. Si vous n'avez pas indiqué de bibliothèque en cours, QGPL est utilisée. The name of the current library is used. If you have not specified the current library, QGPL is used.

Fichier devant recevoir les informations (FILE)File to receive information (FILE)

Indique le nom et la bibliothèque du fichier d'informations de bibliothèque. Si le fichier n'existe pas, indiquez CRTFILE(*YES) pour le créer. Dans le cas contraire, un message est émis. Specifies the name and library of the library information file. If the file does not exist, specify CRTFILE(*YES) to create it. If you do not, a message is issued.

file-name: Entrez le nom du fichier dans lequel les informations de liaison seront stockées. Enter the name of the file where the linkage information will be stored.

Les valeurs de bibliothèque possibles sont les suivantes : The possible library values are:

*LIBL: Le système recherche dans la liste de bibliothèques. The system searches the library list.
*CURLIB: Le nom de la bibliothèque en cours est utilisé. Si vous n'avez pas indiqué de bibliothèque en cours, QGPL est utilisée. The name of the current library is used. If you have not specified a current library, QGPL is used.
nom-bibliothèque: Entrez le nom de la bibliothèque dans laquelle se trouve le fichier d'informations de liaison. Enter the name of the library where the linkage information file is located.

Options d'extraction des enregistrements (OPTION)Extract record options (OPTION)

Indique l'option de remplacement, de suppression ou de mise à jour des données dans le fichier d'informations de bibliothèque. Specifies the option of replacing, deleting, or updating data in the library information file.

*REPLACE: Efface toutes les données du fichier d'informations de bibliothèque et les remplace par les informations extraites du programme indiqué dans le paramètre PGM. Clears all data in the library information file, and replaces it with the information extracted from the program specified on the PGM parameter.
*DELETE: Supprime les données du fichier d'informations de bibliothèque pour le programme indiqué dans le paramètre PGM. La suppression de données de ce fichier d'informations de bibliothèque produit un fichier compressé. Les données qui ne concernent pas le programme indiqué dans le paramètre PGM restent dans le fichier d'informations de bibliothèque. Aucune nouvelle information n'est ajoutée au fichier d'informations de bibliothèque. Deletes the data in the library information file for the program specified on the PGM parameter. The deletion of data from this library information file results in a compressed file. Data that does not relate to the program specified on the PGM parameter remains in the library information file. No new information is added to the library information file.
*UPDATE: Supprime les informations existantes des programmes indiqués et les remplace par de nouvelles informations. La suppression de données de ce fichier d'informations de bibliothèque produit un fichier compressé. Si le fichier d'informations de bibliothèque indiqué est vide, cette option équivaut à *REPLACE. Deletes the existing information for the specified programs, and replaces it with new information. The deletion of data from this library information file results in a compressed file. If the specified library information file is empty, this option is equivalent to *REPLACE.

Créer le fichier (CRTFILE)Create the file (CRTFILE)

Crée un fichier d'informations de bibliothèque pour stocker les informations extraites. Creates a library information file to store the extracted information.

*NO: Ne crée pas de fichier d'informations de bibliothèque. Does not create a library information file.
*YES: Crée un fichier d'informations de bibliothèque pour stocker les informations extraites. Sélectionnez *YES lorsque le fichier d'informations de bibliothèque indiqué n'existe pas. Si le fichier existe, un message est affiché. Creates a library information file to store the extracted information. Select *YES when the specified library information file does not exist. If the file exists, a message is displayed.

Nom de bibliothèque à enregistrer (RECLIB)Library name to record (RECLIB)

Indique le nom de la bibliothèque dans laquelle les programmes sont stockés. À l'exécution et lorsque vous entrez la commande SETPGMINF, le système recherche les programmes dans la bibliothèque que vous indiquez ici. Specifies the name of the library where the programs are stored. At run-time and when you enter the SETPGMINF command, the system searches for programs in the library you specify here.

*LIBL: Le système recherche dans la liste de bibliothèques. The system searches the library list.
*FOUND: Pendant le traitement de la commande EXTPGMINF, le système enregistre le nom de la bibliothèque dans laquelle les programmes indiqués sont trouvés. Le système recherche la bibliothèque qui contenait les programmes au moment du traitement de la commande EXTPGMINF. During the processing of the EXTPGMINF command, the system records the name of the library where the specified programs are found. The system searches for the library that contained the programs at the time the EXTPGMINF command was processed.
nom-bibliothèque: Entrez le nom de la bibliothèque. Enter the name of the library.

Contrôle de cohérence (CHECK)Consistency Check (CHECK)

Indique que la cohérence des données et des points d'entrée de votre fichier d'informations de bibliothèque est contrôlée. Si *NONE est indiqué, aucun message d'avertissement n'est émis ; sinon, un message d'avertissement PSE est émis. Specifies that the data and entry points in your library information file are checked for consistency. If *NONE is specified, then no warning message will be given; otherwise a PSE warning message will be issued.

*ALL: Contrôle la cohérence des données et des points d'entrée. Checks consistency of both data and entry points.
*ENTRY: Contrôle la cohérence des points d'entrée. Checks consistency of entry points.
*DATA: Contrôle la cohérence des données. Checks consistency of data.
*NONE: Aucun contrôle de cohérence n'est effectué. No consistency checking is performed.

Exemples

None

Messages d'erreur

Aucun