MPE/iX Commands Reference Manual (32650-90877)

114 Chapter4
Command List II
Commands CALC thru COPY
Syntax
CHGROUP[ [
groupname ][/ grouppass ]]
NOTE This command follows the optional MPE/iX command line syntax. Refer to
"Optional Format for MPE/iX Commands" at the beginning of this chapter.
Parameters
groupname The name of the group to which the user is switched. If the parameter is
omitted, the user is switched to the home group.
grouppass The password of the group you are switching to, if it is assigned a
password. In a session, if the target group has a password and you fail to
supply one on the command line, MPE/iX will prompt you to enter one. You
have three tries to enter the correct password before the command fails.
In a batch job, if the target group has a password and you fail to supply
one, MPE/iX issues an error message "INCORRECT PASSWORD (CIERR
1441)" and the job fails.
In either case, when you switch to your home group, you may omit the
password.
Operation Notes
This command changes the user's current group to
groupname . The entire command
interpreter environment is preserved (temporary files, file equations, cataloged UDCs, and
variables). The user must know the password, if any, for
groupname . In a session, if a
password is associated with
groupname , and the user fails to supply a grouppass , the
system prompts the user to enter one. In a job, if a password is associated with
groupname ,
and the user fails to supply a
grouppass , the error message INCORRECT PASSWORD (CIERR
1441) is issued and the job fails.
The CHGROUP and CHDIR commands both 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 times are still accounted to the user's logon
account and logon group.
Use
This command is available in a session or a job, but not in BREAK or from a program.
Pressing
Break has no effect on this command.
Examples
To switch the user from the current group to the group called GORODA, enter:
CHGROUP GORODA
To switch the user from the current group to the group called GORODA, with the assigned
password MUSASHI, enter:
CHGROUP GORODA/MUSASHI