NAME

cm sysname − Reports or sets the CPU/OS type

SYNOPSIS

cm sysname [-newsys sysname] [-help]

OPTIONS

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.  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 pathnames used in symbolic links. As the Cache Manager interprets pathnames, 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