Switches you from the current group to another group within
the logon account to which you are allowed access.
groupname The name of the group to which you will be
switched. If you omit this parameter, you will
be 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.
This command changes your current group to the one specified
by groupname. The entire CI environment is preserved
including temporary files, file equations, cataloged UDCs,
variables, etc. You must know the password, if any, for
groupname. In a session, if a password is associated with
groupname and you fail to enter it, you will be prompted for
one. In a job, if you omit the password associated with
groupname, you will get an error and the job fails.
This command is available in a session or job, but not in BREAK
or from a program. Pressing [BREAK] has no effect on this command.
The following command switches you from the current group to
a group called GORODA.
The following command switches you to the GORODA group if the
correct password is MUSASHI.
To switch to your home group, enter: