PATH
.-;--------------. V | >>-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
- The dirids and libraries can be intermixed in a single PATH statement.
- 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.
- 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.
- The PATH command is not cumulative, that is, the last PATH command replaces the previous PATH definition.
- If dirid or the library is not specified, the users current working path is retrieved and placed in the REXX special variable RESULT.
- If you receive a non-zero return code, the contents of the RESULT special variable are unpredictable.
