STRREXPRC

La commande Démarrer procédure REXX (STRREXPRC) appelle l'interpréteur en indiquant explicitement la bibliothèque, le fichier et le membre source à interpréter. The Start REXX Procedure (STRREXPRC) command calls the interpreter, explicitly specifying the library, file, and source member to interpret.

Paramètres

Membre source (SRCMBR)

Indique le nom du membre de fichier source qui contient la procédure REXX à démarrer. Specifies the name of the source file member that contains the REXX procedure to be started.

Ce paramètre est obligatoire. This is a required parameter.

Fichier source (SRCFILE)

Indique le fichier source qui contient la procédure REXX à démarrer. Specifies the source file that contains the REXX procedure to be started.

Qualificatif 1 : Fichier source Qualificatif 1: Fichier source

QREXSRC

Le fichier source fourni par IBM, QREXSRC, contient la procédure REXX. The IBM-supplied source file, QREXSRC, contains the REXX procedure.

nom

Indiquez le nom du fichier source qui contient la procédure REXX à exécuter. Specify the name of the source file that contains the REXX procedure to be run.

Qualificatif 2: Biblio

*LIBL

The library list is used to locate the source file.

Lorsque *LIBL est indiqué pour ce qualificatif, REXX recherche le premier fichier source de la liste de bibliothèques portant le nom de fichier source indiqué. Si un fichier source est trouvé, REXX recherche le membre source dans ce seul fichier source. REXX ne continue pas à rechercher d'autres fichiers sources du même nom dans la liste de bibliothèques. Il s'agit du comportement par défaut de la recherche de membre de fichier source REXX. When *LIBL is specified for this qualifier, REXX will find the first source file in the library list with the specified source file name. If a source file is found, REXX will look for the source member in only that source file. REXX will not continue looking for any other source files by the same name in the library list. This is the default REXX source file member search behavior.

Vous pouvez modifier la façon dont REXX recherche le membre de fichier source en ajoutant une variable d'environnement de niveau travail nommée QIBM_REX_FIND_SRCMBR. Utilisez pour cela la commande Ajouter variable d'environnement (ADDENVVAR) en indiquant ENVVAR(QIBM_REX_FIND_SRCMBR) et LEVEL(*JOB). You can change how REXX searches for the source file member by adding a job-level environment variable named QIBM_REX_FIND_SRCMBR. You would use the Add Environment Variable (ADDENVVAR) command and specify ENVVAR(QIBM_REX_FIND_SRCMBR) and LEVEL(*JOB).

• Si la valeur initiale (paramètre VALUE) indiquée dans la commande ADDENVVAR est *BYMBRNAME, REXX recherche le membre source en parcourant chaque fichier source portant le nom de fichier indiqué dans la liste de bibliothèques qui contient un membre source du nom indiqué pour le paramètre Membre source (SRCMBR). If the initial value (VALUE parameter) specified on the ADDENVVAR command is *BYMBRNAME, REXX will search for the source member by looking in each source file with the specified file name in the library list that contains a source member with the name specified for the Membre source (SRCMBR) parameter.
• Si la valeur initiale indiquée dans la commande ADDENVVAR est *BYFILENAME ou toute autre valeur, ou si la variable d'environnement n'existe pas, le comportement par défaut de recherche de membre de fichier source REXX est utilisé. If the initial value specified on the ADDENVVAR command is *BYFILENAME or any other value, or if the environment variable does not exist, the default REXX source file member search behavior is used.

*CURLIB

La bibliothèque en cours est utilisée pour localiser le fichier source. Si aucune bibliothèque en cours n'est définie pour le travail, QGPL est utilisée. The current library is used to locate the source file. If no library is specified as the current library for the job, QGPL is used.

nom

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

Paramètres (PARM)Parameters (PARM)

Indique les valeurs de paramètres de procédure transmises à la procédure REXX lors de son démarrage. Ces valeurs sont accessibles par l'instruction argument (ARG) dans la procédure REXX. Specifies procedure parameter values passed to the REXX procedure when it is started. These values are accessed through the argument (ARG) instruction within the REXX procedure.

*NONE

La procédure REXX n'a aucun paramètre de procédure. L'instruction ARG renvoie une chaîne vide. There are no procedure parameters for the REXX procedure. The ARG instruction returns a null string.

valeur-caractère

Indiquez la valeur de paramètre de procédure à transmettre à la procédure REXX. Un maximum de 3000 caractères est autorisé. Specify the procedure parameter value to pass to the REXX procedure. A maximum of 3000 characters is allowed.

Environnement de commande (CMDENV)Command environment (CMDENV)

Indique le programme d'environnement de commande initial qui traite les commandes incorporées dans la procédure REXX. L'interpréteur REXX appelle cet environnement chaque fois qu'une commande est rencontrée dans la procédure REXX. Specifies the initial command environment program to process commands embedded in the REXX procedure. The REXX interpreter will call this environment whenever a command is encountered within the REXX procedure.

Valeurs uniques

*COMMAND

L'environnement de commande du langage de commande (CL) d'IBM i est utilisé. The IBM i control language (CL) command environment is used.

*CPICOMM

L'environnement de commande CPI (Common Programming Interface) pour communications est utilisé. The Common Programming Interface (CPI) for Communications command environment is used.

*EXECSQL

L'environnement de commande SQL (Structured Query Language) est utilisé. EXECSQL est l'environnement de commande utilisé pour les commandes CL incorporées dans une procédure REXX. The Structured Query Language (SQL) Command environment is used. EXECSQL is the command environment used for CL commands that are imbedded within a REXX procedure.

Qualificatif 1 : Environnement de commande Qualificatif 1: Command environment

nom

Indiquez le nom du programme qui traite les commandes incorporées dans la procédure REXX. Specify the name of the program to process commands embedded in the REXX procedure.

Qualificatif 2: Biblio

*LIBL

La liste de bibliothèques est utilisée pour localiser le programme. The library list is used to locate the program.

*CURLIB

La bibliothèque en cours du travail est utilisée pour localiser le programme. Si aucune bibliothèque en cours n'est définie pour le travail, QGPL est utilisée. The current library for the job is used to locate the program. If no library is specified as the current library for the job, QGPL is used.

nom

Indiquez le nom de la bibliothèque où se trouve le programme. Specify the name of the library where the program is located.

Programme d'exit (EXITPGM)Exit program (EXITPGM)

Indique les programmes d'exit à utiliser lors de l'appel de l'interpréteur. Un maximum de 8 paires programme et code d'exit peut être indiqué. Specifies exit programs to be used when the interpreter is called. A maximum of 8 program and exit code pairs can be specified.

Remarque : Si plusieurs codes d'exit système sont indiqués, c'est le dernier indiqué qui est pris en compte. Remarque :If multiple system exit codes are specified, the last one specified is the one taken.

Valeurs uniques

*NONE

Aucun programme d'exit n'est utilisé pour cet appel. There are no exit programs for this call.

Autres valeurs (jusqu'à 8 répétitions)

Élément 1: Programme

Qualificatif 1: Programme

nom

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

Qualificatif 2: Biblio

*LIBL

La liste de bibliothèques est utilisée pour localiser le programme indiqué. The library list is used to locate the specified program.

*CURLIB

La bibliothèque en cours du travail est utilisée pour localiser le programme indiqué. Si aucune bibliothèque en cours n'est définie pour le travail, QGPL est utilisée. The current library for the job is used to locate the specified program. If no library is specified as the current library for the job, QGPL is used.

nom

Indiquez le nom de la bibliothèque où se trouve le programme indiqué. Specify the name of the library where the specified program is located.

Élément 2: Exit code

number

Specify one of the following exit code values.

Exit-code

Description

2

Le programme associé est appelé chaque fois qu'une fonction ou un sous-programme externe a été appelé par le programme REXX. Le programme d'exit doit alors localiser et appeler la routine demandée. The associated program is called whenever an external function or subroutine has been called by the REXX program. The exit program is then responsible for locating and calling the requested routine.

3

Le programme associé est appelé chaque fois que l'interpréteur s'apprête à appeler une commande. Le programme d'exit doit localiser et appeler la commande à partir de la chaîne de commande et du nom de l'environnement en cours. The associated program is called whenever the interpreter is going to call a command. The exit program is responsible for locating and calling the command given the command string and the current environment name.

4

Le programme associé est appelé chaque fois qu'une instruction ou une fonction REXX tente une opération sur la file d'attente de données externe REXX. The associated program is called whenever a REXX instruction or function attempts an operation on the REXX external data queue.

5

Le programme associé est appelé lorsque des opérations d'entrée ou de sortie de session sont tentées. The associated program is called when session input or output operations are attempted.

7

Le programme associé est appelé après l'exécution de chaque clause de la procédure REXX afin de déterminer si celle-ci doit être arrêtée. The associated program is called after running each clause of the REXX procedure to determine whether it should be stopped.

8

Le programme associé est appelé après l'exécution de chaque clause du programme REXX afin de vérifier si la trace doit être activée ou désactivée. The associated program is called after running each clause of the REXX program to check if tracing should be turned on or off.

9

Le programme associé est appelé avant l'interprétation de la première instruction d'une procédure REXX (y compris les procédures REXX appelées comme fonctions et sous-programmes externes). The associated program is called before interpretation of the first instruction of a REXX procedure (including REXX procedures called as external functions and subroutines).

10

Le programme associé est appelé après l'interprétation de la dernière instruction d'une procédure REXX (y compris les procédures REXX appelées comme fonctions et sous-programmes externes). The associated program is called after interpretation of the last instruction of a REXX procedure (including REXX procedures called as external functions and subroutines).

Exemples

STRREXPRC   SRCMBR(ABC)

Cette commande appelle l'interpréteur REXX en lui demandant d'exécuter le membre source nommé ABC dans le premier fichier source QREXSRC de la liste de bibliothèques (*LIBL). This command calls the REXX interpreter instructing it to run the source member named ABC in the first QREXSRC source file in the library list (*LIBL).

Messages d'erreur

Messages *ESCAPE *ESCAPE Messages

CPF7CFB

Une erreur s'est produite lors du traitement des programmes d'exit REXX. Error occurred while processing REXX exit programs.

CPF7CFD

Une erreur s'est produite lors de l'exécution de la procédure REXX &1. Error occurred running REXX procedure &1.

CPF7CFF

La procédure REXX &1 est terminée ; code retour &4. REXX procedure &1 ended; return code &4.

CPF7CF2

La procédure REXX &1 est introuvable. REXX procedure &1 not found.

CPF7CF3

Vous n'avez pas le droit d'accéder au fichier source &2. Not authorized to source file &2.

CPF7CF4

Impossible d'allouer la procédure REXX &1. Cannot allocate REXX procedure &1.

CPF7CF6

Impossible d'allouer le fichier source REXX &2. Cannot allocate REXX source file &2.

CPF7CF7

La file d'attente de données externe REXX est endommagée. REXX external data queue is damaged.