CHGROUP [ MPE/iX Commands Reference Manual Volume I ] MPE/iX 5.5 Documentation
MPE/iX Commands Reference Manual Volume I
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.
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
To switch the user from the current group to the user's home group,
enter:
CHGROUP
Related Information
Commands CHDIR, HELLO
Manuals None
MPE/iX 5.5 Documentation