Filter
Top Products
Chapter 3 137
Command Definitions C-E
CHGROUP
CHGROUP
Switches you from the current group to another group within the logon account to which
you are allowed access. (Native Mode)
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.