HP OpenVMS Systems Documentation

HP OpenVMS DCL Dictionary

Defines the POSIX root for the system.

Format

SET ROOT device-name:directory-spec

Parameters

device-name:directory-spec

Defines the root pathname.

Description

In POSIX pathname processing mode, RMS and the C Run-Time Library treat the leading slash (/) of a pathname as referring to the defined root. By default, the root is SYS$SYSDEVICE:[PSX$ROOT]. The root definition does not persist across a reboot. The SET ROOT commands requires SYSNAM privilege and has the following qualifier:

Qualifier

/LOG (default)

/NOLOG

Controls whether the SET ROOT command displays a success indication after the root definition is set.

Example

$  SHOW ROOT
DISK$ALPHASYS:[000000]
$  SET ROOT DISK$ALPHASYS:[PSX$ROOT]
%SET-I_SXROOSET, system POSIX root set to DISK$ALPHASYS:[PSX$ROOT]
$ SHOW ROOT
DISK$ALPHASYS:[PSX$ROOT]
$
      

This command displays the current root, sets the root to DISK$ALPHASYS:[PSX$ROOT], and verifies that it has been changed.