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

The following example shows RLS directories and lists.
Example:
\ Root Directory
TEST1.DATA File
USERS\ Subdirectory
USER1\ Subdirectory
TEST2.DATA File
DOCS\ Subdirectory
TEST3.DOCUMENT File
USER2\ Subdirectory
LETTER.DOCUMENT File
PROJECT1\ Subdirectory
PROD1.INFO File
DATA\ Subdirectory
PROD1.DATA File
\ Root Directory
TEST1.DATA File
CHARTS\ Subdirectory
CHART1.DATA File
CHART2.DATA File
This example shows a list directory structure. The root directory contains a file (TEST1.DATA) and two
subdirectories (USERS and PROJECT1). Inside the USERS subdirectory are two subdirectories (USER1
and USER2) that correspond to user IDs (USER1 and USER2). User USER1 has a list (TEST2.DATA) and
a subdirectory (DOCS) inside its directory. Inside the DOCS subdirectory there is another list
(TEST3.DOCUMENT). User USER2 has a file (LETTER.DOCUMENT) inside its directory. The root
directory contains a file (TEST1.DATA) and a subdirectory (CHARTS). Inside subdirectory CHARTS are
two files (CHART1.DATA and CHART2.DATA).
Current Directory and Path
The current list directory is the current working directory, and is first in the search order when working with
REXX List System (RLS). The current list directory can be set using the CLD command, see section “CLD”
on page 325. The syntax is CLD followed by the fully or partially qualified directory name. To change from a
subdirectory back to the parent directory, type CLD ... To change to another subdirectory, CLD can be
followed by the subdirectory name.
In the following example, the first command sets the current directory to \USERS\USER1 and the second
command sets the current directory to \USERS\USER1\DOCS. The third command changes the current
directory back to \USERS\USER1.
Example:
CLD \USERS\USER1
CLD DOCS
CLD ..
Note: If CLD is never specified the default directory is \SYSTEM\nnnnnnnn\. where nnnnnnnn is an
internal REXX task number.
Security
The RLS commands are authorized REXX/CICS commands. This means they may only be executed by
an authorized user or from within an exec loaded from an authorized library.
List System
274 CICS TS for VSE/ESA: REXX Guide