Cld; Operands; Return Codes; Examples - IBM SC34-5764-01 Manual

CLD

CLD
dirid
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

Examples

'CLD \USERS\USER2\XYZ'
This example changes your current working list directory to \USERS\USER2\XYZ regardless of the
previous directory setting.
If your current directory is \USERS\USER2 and you enter:
'CLD XYZ'
then your current directory is changed to \USERS\USER2\XYZ.

Notes

1. The current directory (specified by the CLD command) is always searched first, attempting to locate an
RLS list with the appropriate list name.
2. A fully qualified RLS file name bypasses the search of your directories.
Commands
Chapter 25. REXX/CICS Commands
325