chfolder

Use to navigate folders in the database. This command changes the working directory or current directory, which is set to root ("/") by default, so that you can use relative folder paths when submitting commands.

Authorization

To change folder, you must have display access to the folder.

Syntax

{chfolder | cf} foldername

Arguments

foldername: Is the name and path of the folder that becomes the current folder.

Comments

When submitting commands involving folders, you can specify either a relative or absolute path to the folder. If no folder is specified, then the command is performed using the current folder which is set to root ("/") by default. If you generally work from a specific folder, then you can use the chfolder command to navigate to folders and sub-folders. The chfolder command changes the working directory or current folder, so that you can use relative folder paths when submitting commands.

There are additional ways you can modify the current folder. The following methods for setting the current folder are also ordered by precedence, for example, the value specified in the customer properties file overrides the current folder setting in the localopts file.

CustomParameters

You can pass chfolder | cf as a parameter together with a composer command from the composer command line.

For example, to list job streams in the folder named /TEMPLATE/, then submit the following from the composer command line:

composer -cf /TEMPLATE/ "li js @#@"

You can obtain the same result by changing the current folder in composer first, then submitting the command:

-cf /TEMPLATE/

-li js @#@

UNISON_CURRENT_FOLDER

Set the value of the current folder using the UNISON_CURRENT_FOLDER environment variable.

Custom properties file

You can use the CURRENT FOLDER parameter to set the value of the current folder in the custom properties file that can be passed to composer. The parameters in the custom properties file override the values specified in the useropts and localopts files. For example, set the parameter as follows:

CURRENT FOLDER = /˂foldername>

See Running the composer program for information about the custom properties file.

useropts

You can set the current folder in the useropts file. The useropts file contains values for localopts parameters that you can personalize for individual users. Set the current folder as follows:

current folder = /˂˂varname>foldername˂/varname>>

localopts

You can set the current folder in the localopts file by adding

 current folder =
/˂˂varname>foldername˂/varname>>

. For example:

------------------------------------
# Current Folder
#
current folder = /bluefolder

The maximum length for the full folder path (that is, the path name including the parent folder and all nested sub-folders) is 800 characters, while each folder name supports a maximum of 256 characters. When you create a nested folder, the parent folder must be existing. See Folder definition for details about folder specifications.

Examples

To change the working directory or the current folder from the root folder to the folder path "TEST/APPS/APP1", run:

chfolder /TEST/APPS/APP1/

TEST/APPS/APP1 is now the current folder path and commands can be submitted on objects in this folder using relative paths.