
.-;--------------.
V |
>>-PATH----+------------+-+------------------------------------><
+-dirid------+
'-lib.sublib-'
PATH defines the search path for REXX execs.
- 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.
- 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
'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.
- 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.