This command changes the process' current working directory (CWD).
Operation Notes |
 |
You can use the CHDIR command to change the process' CWD to dir_name. If dir_name is omitted, the logon group is assumed. The user always has a logon group.
The CHDIR command changes the CWD to an MPE-named directory. This means that dir_name must follow all MPE naming rules, unless it is prefixed with a dot (.) or a slash (/).
You can change the CWD to any HFS directory, MPE account, or MPE group where you have the appropriate permission.
The CWD is a process-local attribute. When CHDIR is executed from the CI, the CI's CWD is changed for the life of that CI process (or until another CHDIR command is issued). When CHDIR is executed programmatically from a child process of the CI (for example, HPEDIT), only that process' CWD is changed. In this case, the parent process' (for example, CI's) CWD is not affected.
The CHDIR and CHGROUP commands change their process' CWD; however, CHDIR does not post any accounting information, and CHGROUP affects the CWD of every process in the job/session structure. Connect and CPU time are still accounted to the user's logon account and logon group.
A new, read-only, predefined CI variable, HPCWD, contains the name of the current working directory in HFS syntax. At logon, HPCWD contains /account_name/logon_group_name. The HPCWD string value cannot exceed 255 characters. If the CWD is too long, or has been removed (for example, with the .2 shell rmdir command), then HPCWD will not be accessible.
The CHGROUP command causes the HPCWD variable to be set to /account/group_changed_to.
The table below summarizes the differences and similarities between the CHDIR and CHGROUP commands.
| Affects | CHGROUP | CHDIR |
|---|
| Accumulation of CPU and Connect time | yes | no |
| Set of accessible files | yes | no |
| CWD of process | yes | yes |
| HPCWD variable | yes | yes |
| Disk space accumulation | yes | yes |
Use |
|
You can issue the CHDIR command from a job, a session, a program, or in break mode. Pressing Break has no effect on this command. You must have traverse directory entries (TD) permission to each directory component in dir_name (refer to the ALTSEC command in this chapter for more information on directory permissions.) If the CHDIR command fails, the CWD does not change..
Examples |
|
The following example shows the command entry to change to the directory dir1 in the MYGRP group in the MYACCT account.
The following example shows the command entry to change to the MPE group level (AGROUP) in the MYACCT account.
The following example shows the command entry to change to a directory named My_dir. In this example, My_dir is a relative pathname, that is, relative to the current working directory (CWD).
The following example shows the command entry to change to a directory named john, in the group JONES, in the account MYACCT, by specifying the full pathname.
The following example shows that a change is made to a directory named final by specifying the relative pathname. The variable HPCWD displays the current working directory after the change is made.
CHDIR ./es/final
SHOWVAR HPCWD
HPCWD = /MYACCT/JONES/john/es/final
|
