syscp - set system-specific information

SYNOPSIS

<syscp $what [$arg ...]>

DESCRIPTION
The syscp function sets various system- or OS-level parameters. The $what argument determines what is affected:

• chdir $dir or cd $dir Change the current working directory to $dir.

• umask $mode Change the process's umask to $mode, which must be a chmod-style bitmask. These bits are ANDed (masked off) with the mode bits given during file open commands. Added in version 4.00.997400000 20010809.

• setenv $varname $value [$overwrite]

  Sets each environment variable named by $varname to the corresponding $value. If the environment variable already exists, it will be overwritten, unless the $overwrite argument (if present) is false (i.e. the default is to overwrite). Added in version 3.01.991350000 20010531. Notes:

  • setenv changes the true current process environment, not the Vortex variable(s) of the same name that may have been initialized at start.

  • Vortex variables can be assigned on the command line for a script, so it is not necessary to set the environment to pass variables to a sub-process <EXEC> script.

  • In version 5 and later, the ENVSET option to <EXEC> can be used to set environment vars for just the sub-process being <EXEC>ed, without modifying (with potential side effects) the current process's environment.

DIAGNOSTICS
syscp returns an empty string on success, otherwise a string describing the error.

EXAMPLE

<syscp chdir "/some/other/dir">

CAVEATS
The syscp function was added in version 3.01.975700000 20001201.

SEE ALSO
sysinfo, sysutil