IBM SC34-5764-01 - Manual (Page 383)

PATH
PATH
;
dirid
lib.sublib
PATH defines the search path for REXX execs.
Operands
dirid
specifies one or more fully qualified REXX File System directories that are searched when you are
attempting to locate an exec to be executed.
A full RFS directory ID starts with a pool ID and is in the form: POOL1:\dirid1\...\diridn
When more than one directory ID is specified, a blank is used to separate them.
lib.sublib
specifies one or more VSE Librarian sublibraries.
Return Codes
0 Normal return
625 Error retrieving path information
626 Invalid RFS directory name
628 Error setting RESULT value
629 Invalid VSE Librarian sublibrary
630 Error storing path information
631 No path currently defined
632 Resulting PATH contains no RFS directories or library names
Examples
'PATH POOL1:\USERS\USER2 POOL2:\USERS\USER2\PROJECT1'
This example shows that the directories in this list are searched in the order specified (from left to right).
'PATH REXX1.EXECS REXX2.EXECS'
This example shows you that the search is started with the first VSE Librarian sublibrary.
Notes
1. The dirids and libraries can be intermixed in a single PATH statement.
2. A very long PATH directory list can be created by concatenating strings together into a variable, and
then specifying this variable on the PATH command.
3. PATH command definitions are not carried across CICS restarts. To permanently change a PATH
definition, insert a PATH command into your PROFILE exec in the base directory for your user ID.
4. The PATH command is not cumulative, that is, the last PATH command replaces the previous PATH
definition.
5. If dirid or the library is not specified, the users current working path is retrieved and placed in the
REXX special variable RESULT.
6. If you receive a non-zero return code, the contents of the RESULT special variable are unpredictable.
Commands
Chapter 25. REXX/CICS Commands 361