CHGROUP



CHGROUP

     Switches you from the current group to another group within
     the logon account to which you are allowed access.

SYNTAX

     CHGROUP [[GROUP=]groupname][/grouppass]


PARAMETERS

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.

OPERATION

     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.


EXAMPLE(S)

     The following command switches you from the current group to
     a group called GORODA.

     CHGROUP GORODA

     The following command switches you to the GORODA group if the
     correct password is MUSASHI.

     CHGROUP GORODA/MUSASHI

     To switch to your home group, enter:

     CHGROUP