CLD

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