cm sysname(8dfs)

Reports or sets the CPU/OS type

Synopsis

cm sysname [-newsys sysname] [-help]

Options

-newsys sysname
Specifies the new setting of the CPU/Operating System (@sys) variable for the machine on which it is issued. If this option is omitted, the output shows the current setting of the variable.

-help
Prints the online help for this command. All other valid options specified with this option are ignored.

Description
The cm sysname command displays the current setting of the @sys variable or sets the variable on a client machine. If the -newsys option is omitted, the command reports the current setting of the @sys variable. If the -newsys option is included, the command sets the variable to the specified CPU/OS type. The value of the variable is displayed from or set in the kernel of the client machine on which the command is issued.

The Cache Manager's main use of the @sys variable is in path names used in symbolic links. As the Cache Manager interprets path names, it substitutes the value of the indicator for any occurrence of @sys. (Use the @sys variable sparingly; it can make the effect of changing directories confusing.)

Privilege Required
To view the current setting of @sys (without the -newsys option), no privileges are required. To change the setting of @sys (with the -newsys option), you must be logged in as root on the local machine.

Output
If the -newsys option is not specified, the output reports the system type in the following format:

Current sysname is 'system_type'.

Examples
The following command shows the output produced on a machine running OSF/1:

$ cm sys

Current sysname is 'pmax_osf1'.

The following commands set the system type on a machine running AIX 3.2 and use it in a symbolic link from the /usr/local directory on the local machine to a directory in the DFS filespace:

# cm sys -new rs_aix32
# ln -s /.../abc.com/fs/@sys/usr/local /usr/local
# ls -l /usr/local

lrwxrwxrwx 1 root 34 May 31 1993 /usr/local ->

/.../abc.com/fs/@sys/usr/local

# cd /usr/local
# pwd

/.../abc.com/fs/rs_aix32/usr/local