NEWUSER User Exit

Reference Guide › User Exit Reference › NEWUSER User Exit

NEWUSER User Exit

Use the NEWUSER user exit to make sure that you or the specified manager is allowed to be the manager of a new user ID. It also validates the account number that you assign to the new user ID.

NEWUSER userid userid2 account newmgrid command

Definitions

userid: Specifies the user ID that manages the directory entry of the new user ID (the user ID issuing the command), or the user ID issuing the VMXGNR utility.
userid2: Specifies the user ID of the virtual machine being created.
account: Specifies the account number associated with the new user ID.
newmgrid: Specifies the new directory manager user ID if the exit was called by the ASSIGN or ADDENTRY command, or the current directory manager if the exit was called by the CHANGE command. Otherwise, the value of newmgrid is an asterisk.
command: Specifies the name of the command that called the exit. In the case of a macro, it is the optimized macro name.

Description

CA VM:Director requires the NEWUSER user exit for the VMXGNR database generation utility. VMXGNR calls the NEWUSER user exit when processing the input file (usually the USER DIRECT) to assign user ID to a CA VM:Director directory manager.

The following CA VM:Director commands (macros) call the NEWUSER user exit: ADDENTRY, ASSIGN, CHANGE, MAINT MANAGE, MANAGE, and MULTIPLE. These commands call the NEWUSER user exit to validate the user ID being created, but ignore the manager user ID that is stacked by the NEWUSER user exit.

If you specify the MANAGER option on the ADDENTRY command line, the user ID specified after the MANAGER option will be used, assuming it is a valid CA VM:Director manager user ID and the return code from NEWUSER user exit is zero.

Return Codes

The following table describes the return codes:

Return Code	Meaning
0	New user ID accepted. For calls from VMXGNR, this also means the Directory manager assigned to userid2 is stacked.
4	Name specified by userid2 is invalid
8	Account number is invalid

Macros

The following macros call the NEWUSER user exit:

Called by	Optimized Macro Name	Under These Circumstances
VMXADDNT	ADDENTRY	Creates a user ID using the ADDENTRY command
VMXASN00	ASSIGN	Assigns a user ID to a new directory manager
VMXCHG00	CHANGE	A directory manager or administrator changes a user ID
VMXGNR	VMXGNR	Generates the directory database using the VMXGNR utility
VMXMAI20	MAI00020	Creates a user ID using the MAINT MANAGE command
VMXMAN20	MAN00020	Creates a user ID using the MANAGE command
VMXMUL00	MULTIPLE	Creates a user ID using the MULTIPLE command