mkws

Makes a workspace associated with a dynamic view

APPLICABILITY

Attache (command)

SYNOPSIS

• Make and register a workspace and associate it with an existing dynamic view:

  mkws [ -sho·st hostname ] -tag tagname ws-stg-pname

• Make and register a workspace and a create a new associated dynamic view:

  mkws -hos·t hostname -hpa·th host-stg-pname -gpa·th global-stg-pname

  
  

  [ -sho·st hostname ] -tag tagname ws-stg-pname

DESCRIPTION

The mkws command creates and adds a workspace to the local workspace registry and either associates it with an existing dynamic view or creates a new associated dynamic view. ws-stg-pname specifies the location of the workspace storage directory. tagname specifies the workspace name which is also the associated view's tag. A username and password combination for the workspace helper host are required. You are prompted for this information if it has not already been requested, or previously stored using the Login info command on the Options menu. After the workspace is created, it becomes the current workspace.

Attache's Client Process Startup Directory

There is a separate startup directory associated with the Attache client process. This directory changes depending upon how Attache is started. For example, it is the "working directory" specified in Attache's program item properties if Attache is started from the icon. Once the Attache client process is started, this directory never changes. The pathname of a new workspace storage directory (if not specified absolutely) is relative to the Attache startup directory, not your workspace working directory. For this reason, we recommend that you always specify a full local pathname for your workspace storage directory.

PERMISSIONS AND LOCKS

Permissions Checking: No special permissions required. Locks: No locks apply.

OPTIONS AND ARGUMENTS

SPECIFYING THE ATTACHE HELPER'S LOCATION. Default: View host.

-sho·st hostname

Specifies the name of the ClearCase host on which the associated Attache helper process will run.

SPECIFYING THE WORKSPACE NAME. Default: None.

-tag tagname

Specifies the name of the workspace and dynamic view, in the form of a simple helper host file name. tagname specifies both the view-tag name and the workspace name, which are created if they do not exist.

SPECIFYING THE WORKSPACE STORAGE DIRECTORY. Default: None. You must specify a location for the workspace storage directory.

ws-stg-pname

Specifies the name of the workspace storage directory: full pathname, relative pathname, or simple directory name. This directory can already exist, but if it doesn't, it is created. As with any operating-system directory-creation command, the entire directory tree above the workspace storage directory name must already exist. A relative pathname or simple directory name begins from Attache's startup directory, not the working directory.

SPECIFYING THE NEW DYNAMIC VIEW'S LOCATION. Default: None. If the dynamic view does not already exist, you must also set the workspace's view registry information with the -host, -hpath, and -gpath options.

-hos·t hostname

-hpa·th host-stg-pname

-gpa·th global-stg-pname

These options must appear as a set. You must use these options when creating a new dynamic view. You must specify the location of the view-storage directory with these three options:

Values of other view creation options (-tcomment, -tmode, -ln, -region) are provided by default. To control these attributes of view creation, use mkview instead and then use mkws to connect to this dynamic view. The default behavior for text mode can also be specified with the Preferences command on the Options menu.

EXAMPLES

• Make a workspace and associate it with the existing dynamic view jo_doc. At an Attache prompt:

mkws -shost darkover -tag jo_doc c:\users\jo\doc

• Make a workspace and create a new dynamic view named lee_main to associate with it. This command must be entered on a single line. At an Attache prompt:

mkws -host oz -hpath c:\vws\mn.vws -gpath \\pluto\c.share\vws\mn.vws -tag lee_main c:\users\lee\main

SEE ALSO

attache_graphical_interface, attache_command_line_interface, lsview, lsws, mkview, rmws, setws