CLD
CLD changes your current RLS list directory.
Operands
- dirid
- specifies a partial or full REXX List System directory that becomes
the new current working directory for you.
If dirid is not specified, the current working directory is retrieved and placed into the REXX variable RESULT, instead of changing the current working directory.
A full directory ID starts with a slash and is in the form: \dirid1\...\diridn
When you specify a full directory ID, it completely replaces the previous directory setting.
A partial directory ID does not begin with a slash. In this case, the partial directory ID is appended to the end of the existing directory ID. If the partial directory ID begins with two periods, this indicates that one directory level is removed (from the right), before the new partial directory ID is appended to the end. In this case, a backslash is required before the directory ID.
For example: If the current directory is \USERS\USER1\ABC and you enter CLD ..\XYZ the new current directory will be \USERS\USER1\XYZ.
The default directory ID for you is \USERS\genid\, where genid is your CICS signon user ID. If you are not signed onto CICS, genid defaults to the value in DFLTUSER.
Return codes
- 0
- Normal return
- 923
- Error in storing current RLS directory information
- 924
- RLS directory does not exist or access not authorized
- 925
- Error in retrieving directory information
- 926
- Invalid directory
- 927
- Cannot go back past root directory
- 928
- Error setting result value
Example
'CLD \USERS\USER2\XYZ'
This example changes your current working list directory to \USERS\USER2\XYZ regardless of the previous directory setting.
'CLD XYZ'
Notes
- The current directory (specified by the CLD command) is always searched first, attempting to locate an RLS list with the appropriate list name.
- A fully qualified RLS file name bypasses the search of your directories.
