PLEXCTL (NCCF)
Syntax
>>-PLEXCTL--+-------------------------+------------------------>< +- TAKEOVER=-+-ALLOW----+-+ | '-DISALLOW-' | '- RANK=new_rank----------'
Purpose of Command
You can use the PLEXCTL command to change the rank of the NetView® program in the DSIPLXnn group in which it participates. If the NetView program is the group master, the command can also be used to control whether the master NetView program will allow another NetView program to assume the master role in the sysplex group.
Command processing will check that the requested change is not already in effect. For example, if PLEXCTL RANK=MASTER is specified and the NetView program is already a master NetView program, command processing stops and a BNH559E message with a reason code of 1 results.
Operand Descriptions
- TAKEOVER
- Specifies whether a master NetView program
will allow another NetView program
to take over as master, either because of an operator command or because
a system-defined master NetView program
became active. The TAKEOVER option is only valid when issued on a
master NetView program.
The following values are valid:
- ALLOW
- Specifies that another NetView program can take over. This is the normal setting when a NetView program assumes the master role.
- DISALLOW
- Specifies that another NetView program cannot take over.
- RANK
- Changes the current rank of this NetView program in the sysplex. The value can range from 0 (basic NetView) to 250 (master NetView). The change in rank results in the user state field being updated, which drives exits at the other NetView programs in the group. If the specified rank is 250, this NetView program takes over as master assuming that there is not another master in the group that is disallowing takeovers. The character string MASTER can be used as a synonym for 250, and the character string BASIC can be used as a synonym for 0. The character string MCAP can be used as a synonym for 1.