PATH

Read syntax diagramSkip visual syntax diagram         .-;--------------.
         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

  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.