ENROLL ADMINISTRATOR

Notes:

¹ The default is the default file pool ID for your virtual machine. If there is no default file pool ID, the command fails.

Authorization

File Pool Administrator

Purpose

Use the ENROLL ADMINISTRATOR command to grant file pool administration authority for the specified file pool. You must have file pool administration authority to use this command.

File pool administration authority lets you use the commands described in this chapter which are identified as administrator commands. In addition, administration authority lets you to do anything to users' objects that the users themselves can do. For example, you can read from or write to any file in the file pool.

File pool administration authority using the ENROLL ADMINISTRATOR command is temporary, and lasts only until one of the following occurs:

File pool server processing is stopped or caused an error
A DELETE ADMINISTRATOR command is entered for the user ID
A REVOKE ADMIN operator command is entered at the server machine console (or its secondary user console)

For permanent file pool administration authority, use the ADMIN statement in the DMSPARMS file.

Operands

userid: indicates the user is to be enrolled.
nickname: identifies a nickname that represents a user ID or a list of user IDs. (Use the NAMES command to define nicknames.)
filepoolid
filepoolid:: identifies the file pool in which the administrator is to be enrolled. If not specified, the default file pool ID for your virtual machine will be used.

Options

NOType: suppresses the display of user IDs to be enrolled. NOType is the default.
TYPe: displays at the terminal the user IDs to be enrolled.
STACK FIFO
STACK LIFO: places the information in the console stack rather than displaying it at the terminal. FIFO is the default.
LIFO: specifies the information is stacked in a last in, first out order. This option is equivalent to STACK LIFO.
FIFO: specifies the information is stacked in a first in, first out order. This option is equivalent to STACK FIFO.

Usage Notes

A user does not have to be enrolled in the file pool (either explicitly by ENROLL USER or implicitly by ENROLL PUBLIC) to receive file pool administration authority. A user with file pool administration authority can connect to the file pool and exercise all privileges permitted by that authority.
If a user group is specified and the enrollment of any user causes an error, all enrollments are unsuccessful. Processing stops after the first error.
You can determine which user IDs are enrolled as administrators by entering the following command:
```
query enroll administrator for all vmsys
```
Substitute your own file pool ID for VMSYS.

A description of the QUERY ENROLL command is in z/VM: CMS Commands and Utilities Reference.
If the ENROLL ADMINISTRATOR command is issued from an exec or assembler program, and the file pool specified is active (that is, has some work on it which has not been committed or rolled back) on the current default work unit, the command will cause an error.
If you specify a nickname and the NODE tag in the NAMES file indicates the user is on another processor, you must also specify the LOCALID tag.

Messages and Return Codes

In addition to the messages listed below, this command displays other system messages. These system messages are listed in z/VM: CMS and REXX/VM Messages and Codes and z/VM: CMS Commands and Utilities Reference.

This command internally issues IDENTIFY, FINIS, NUCXDROP, and NUCXLOAD commands. Therefore, messages from those commands can also be displayed. (For more information about those commands, see z/VM: CMS Commands and Utilities Reference.)

Messages:

DMS065E option option specified twice [RC=24]
DMS066E option1 and option2 are conflicting options [RC=24]
DMS109S Virtual storage capacity exceeded [RC=109]
DMS149E Userid userid not valid [RC=32]
DMS637E Missing nodeid for the AT operand [RC=24]
DMS647E Userid not specified for nickname in userid NAMES file [RC=32]
DMS647E Localid not specified for userid at node in user's NAMES file [RC=32]
DMS653E Error executing command rc=nn [RC=40]
DMS1165W One or more userids were already enrolled as ADMINISTRATORs [RC=4]
DMS1201E STACK option cannot follow FIFO or LIFO [RC=24]