CONFIG USERROOT Command   

Sets the system default for the user page location for VM userids. VM users can override the default you set by using the SET USERROOT command to define their user page location.

To display the current system default for the user page location, enter the QUERY USERROOT command with the SYSTEM parameter.

Syntax

To define the default user page as a minidisk:

CONFIG USERROOT MDISK * vaddr

To define the default user page as an SFS directory:

CONFIG USERROOT SFS sfsdir

To define the default user page as a BFS directory:

CONFIG USERROOT BFS bfsdir

Parameters/Options

MDISK * vaddr

Defines the default user page location as a minidisk. Specify a valid virtual address of vaddr.

For each VM userid, the user page location is a minidisk owned by the userid, userid vaddr. For example, if you specify mdisk * 0192, the default user page location for the VM userid ANDREW is ANDREW 0192.

SFS sfsdir

Defines the default user page location as an SFS directory. Specify a fully qualified directory name for sfsdir.

For each VM userid, the user page location is an SFS directory owned by the userid. sfsdir must contain an asterisk (*) to identify the element of the directory name where VM:Webgateway is to substitute in the VM userid to form the directory name. For example, if you specify sfs vmsysu:webroots.*, the default user page location for the VM userid ANDREW is VMSYSU:WEBROOTS.ANDREW.

BFS bfsdir

Defines the default user page location as a BFS directory. Specify a fully qualified directory name for bfsdir. You must use the exact case of the BFS directory name when specifying bfsdir.

For each VM userid, the user page location is a BFS directory owned by the userid. bfsdir must contain an asterisk (*) to identify the element of the directory name where VM:Webgateway is to substitute in the VM userid to form the directory name. For example, if you specify bfs /../VMBFS:VMSYSU:WEB/Roots/*, the default user page location for the VM userid ANDREW is /../VMBFS:VMSYSU:WEB/Roots/ANDREW.

---

Note: The userid in the directory name is in uppercase. If you or a user needs to identify this BFS directory using the exact case, specify the userid portion of the directory name in uppercase.

---

Examples

• To configure VM:Webgateway so it uses a VM userid's 0191 minidisk as the default user page location, enter the following command from a VM userid with SYSADMIN authorization:

  vmwebsrv config userroot mdisk * 0191

  If user DANIEL does not use the SET USERROOT command to define the user page location, VM:Webgateway uses the minidisk DANIEL 0191.

• To configure VM:Webgateway so it uses a VM userid's root SFS directory in the VMSYSU file pool as the default user page location, enter the following command from a VM userid with SYSADMIN authorization:

  vmwebsrv config userroot sfs vmsysu:*.

  If user DANIEL does not use the SET USERROOT command to define the user page location, VM:Webgateway uses the SFS directory VMSYSU:DANIEL.

• To configure VM:Webgateway so all default user page locations are SFS directories located in the USERPAGE file space of the VMSYSU file pool, enter the following command from the VM:Webgateway service virtual machine:

  config userroot sfs vmsysu:userpage.*

  If user DANIEL does not use the SET USERROOT command to define the user page location, VM:Webgateway uses the SFS directory VMSYSU:USERPAGE.DANIEL.

• To configure VM:Webgateway so the default user page location is the SFS directory USERROOT in a VM userid's own file space in the VMSYSU filepool, enter the following command from a VM userid with SYSADMIN authorization:

  vmwebsrv config userroot sfs vmsysu:*.userroot

  If user DANIEL does not use the SET USERROOT command to define the user page location, VM:Webgateway uses the SFS directory VMSYSU:DANIEL.USERROOT.

• To configure VM:Webgateway so it uses a VM userid's root BFS directory in the VMSYSU file pool as the default user page location, enter the following command from a VM userid with SYSADMIN authorization:

  vmwebsrv config userroot bfs /../VMBFS:VMSYSU:*/

  If user DANIEL does not use the SET USERROOT command to define the user page location, VM:Webgateway uses the BFS directory /../VMBFS:VMSYSU:DANIEL/.

• You want to configure VM:Webgateway so all default user page locations are BFS directories in the USERPAGE file space of the VMSYSU file pool. You want the BFS directory name to be userid/UserRoot where userid is the userid of a VM user. Enter the following command from the VM:Webgateway service virtual machine:

  config userroot bfs /../VMBFS:VMSYSU:USERPAGE/*/UserRoot

  If user DANIEL does not use the SET USERROOT command to define the user page location, VM:Webgateway uses the BFS directory /../VMBFS:VMSYSU:USERPAGE/DANIEL/UserRoot.