HP 3000 Manuals

CHDIR [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.5 Documentation


MPE/iX Commands Reference Manual Volume I

CHDIR 

Changes the process' current working directory (CWD). (Native Mode)

Syntax 

CHDIR [[DIR=]dir_name] [;SHOW | NOSHOW]

Parameters 

dir_name              The name of the directory you want to change to,
                      which is assumed to be an MPE name unless you
                      specify otherwise.  To change to an HFS-named
                      directory, begin dir_name with a dot (.)  or a
                      slash (/).  The dir_name may not end in a slash,
                      and using wildcards is not allowed.

                      This parameter is optional.  If you omit
                      dir_name, CHDIR switches you to your logon
                      directory, which is your logon group in the form
                      /LOGON_ACCOUNT/LOGON_GROUP in all uppercase
                      letters.

SHOW                  Displays the absolute pathname of the new directory
                      on $STDLIST. SHOW is the default.

NOSHOW                Does not display the absolute pathname.

Operation 

The CHDIR command changes the process' current working directory to
dir_name or to the logon group, if you omit dir_name.  You can change the
CWD to any HFS directory if you precede dir_name with a dot (.)  or a
slash (/) or to an MPE account or group to which you have the appropriate
permission.

Issuing the CHDIR command does not give users access to files in a
directory (or group and account) that they would not otherwise have.
That is, it has no affect on file access permissions.

The CWD is a process-local attribute, which means that CHDIR changes the
CI's CWD 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 (e.g., HPEDIT), only that process' CWD is changed; the CWD of
the parent process (in this example, the CI) remains the same.

CHDIR does not post any accounting information:  Connect and CPU time are
still accounted to the user's logon account and group.

HPCWD is a read-only, CI string variable that contains the name of the
current working directory in HFS syntax.  At logon, HPCWD contains
/account_name/logon_group_name.  The CHGROUP command causes the HPCWD
variable to be set to /account/group_changed_to.

The table on the next page summarizes the differences and similarities
between the CHDIR and CHGROUP commands.

------------------------------------------------------------------------------------------
|                                                                                        |
|           Affects                      CHGROUP                       CHDIR             |
|                                                                                        |
------------------------------------------------------------------------------------------
|                                                                                        |
| Accumulation of CPU and                  yes                           no              |
| Connect times                                                                          |
|                                                                                        |
| Set of accessible files                  yes                           no              |
|                                                                                        |
| CWD of process                           yes                          yes              |
|                                                                                        |
| HPCWD variable                           yes                          yes              |
|                                                                                        |

| Disk space accumulation                  yes                           no              |
|                                                                                        |
------------------------------------------------------------------------------------------

Use 

The CHDIR command may be invoked from a job, a session, a program, or in
Break.  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.)  The CWD is not changed if the
CHDIR command fails.

Examples 

The following example shows the command entry to change to the directory
dir1 in the MYGRP group in the MYACCT account.

     CHDIR /MYACCT/MYGRP/dir1 

The following example shows the command entry to change to the MPE group
level (AGROUP) in the MYACCT account.

     CHDIR /MYACCT/AGROUP 

The following example shows the command entry to change to a directory
named My_dir.  In this example, My_dir is a relative pathname and it is
subdirectory in the current working directory (CWD).

     CHDIR ./My_dir 

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.

     CHDIR /MYACCT/JONES/john 

In the following example, 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

Related Information 

Commands      CHGROUP, FINDDIR (UDC), LISTFILE, LISTDIR (UDC), NEWDIR,
              PURGEDIR

Manuals       Performing System Management Tasks (32650-90004)



MPE/iX 5.5 Documentation