chfolder

Use to navigate folders in the plan. 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 where the folder is located and to which you want to navigate.

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. If you generally work from a specific folder, then you can use the chfolder command to set a new current folder. The chfolder command changes the working directory or current folder, which is set to root ("/") by default, 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 conman command from the conman command line. For example, to show job streams in the folder named /TEMPLATE/, then submit the following from the conman command line:
conman -cf /TEMPLATE/ ss @#@
You can obtain the same result by changing the current folder in conman first, then submitting the command:
%cf /TEMPLATE/
%ss @#@
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 conman. 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 conman 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 = /foldername
localopts
You can set the current folder in the localopts file as follows:
------------------------------------
# Current Folder
#
current folder = /mycurrentfolder

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.

Examples

To change the current folder to "TEST", run:
chfolder /TEST