


WORKSPACE(1)              User Commands              WORKSPACE(1)



NAME
     workspace - manipulate TeamWare workspaces

SYNOPSIS
     workspace command args ...

DESCRIPTION
     The  workspace  command  manipulates  TeamWare   workspaces.
     TeamWare was formerly known as CodeManager. A workspace is a
     directory that contains a subdirectory named  Codemgr_wsdata
     used by teamware to store information about that workspace.

USAGE
     Many of the following subcommands take an optional  list  of
     workspaces,  [  ws  ... ]. If any workspaces are named, then
     they are operated upon. If no workspaces are named, then the
     value  of the shell environment variable CODEMGR_WS is used.
     If CODEMGR_WS is not set and the current directory  is  con-
     tained within a workspace, the containing workspace is used.

     access [ -l | -q operation=user ] [ ws  ... ]
                         List     or     query      the      file
                         ws/Codemgr_wsdata/access_control.     If
                         the -l option is specified, the  command
                         lists  the  contents  of access_control.
                         If the -q option is specified, the  com-
                         mand queries access_control to determine
                         if user has permission to  do  operation
                         in  ws.  The command exits with the fol-
                         lowing values:

                              0 = user does not have access
                              1 = user has access
                              2 = error

                         The command also displays a textual mes-
                         sage  indicating whether or not user has
                         access.  To add, delete, or change  user
                         entries,  use  the teamware GUI Props ->
                         Workspace  command,  or  edit  the  file
                         ws/Codemgr_wsdata/access_control
                         directly (see access_control(4)).

     children [ -r ] [ ws  ... ]
                         List ws's children workspaces.  With the
                          - r  option, ws's descendant workspaces
                         are recursively listed, each new genera-
                         tion  indented two spaces.  If more than
                         one ws is specified, the name of each ws
                         precedes its list.

     create ws ...       Create the named workspaces.  If  ws  is



SunOS 5.5         Last change: 01 December 1992                 1






WORKSPACE(1)              User Commands              WORKSPACE(1)



                         the name of an existing SunOS directory,
                         the    command    simply    creates    a
                         Codemgr_wsdata  directory directly under
                         that directory.  If ws does  not  exist,
                         both it and its Codemgr_wsdata subdirec-
                         tory are created.

     delete [ -d ] [ -f ] ws ...
                         Delete the  named  workspaces.   When  a
                         workspace is deleted:

                          o   Its  name  is  removed   from   its
                            parent's Codemgr_wsdata/children file

                          o   Its  name  is  removed   from   its
                            children's Codemgr_wsdata/parent file

                         o   The contents of  the  workspace  are
                            deleted

                         Since it  is  a  destructive  operation,
                         workspace  delete  prompts for confirma-
                         tion   before   actually   deleting    a
                         workspace.   The  -f option forces dele-
                         tion by bypassing confirmation.

                         Used with the - d  option,  the  command
                         deletes  only  the  Codemgr_wsdata  sub-
                         directory.

     list [ -r ] [ ws | dir ... ]
                         List ws if it is a workspace.  List  any
                         workspaces  found  underneath dir.  With
                         the - r  option,  dir's  workspaces  are
                         recursively  listed.  If no ws or dir is
                         given,  then  the  value  of  the  shell
                         environment  variable  CODEMGR_WSPATH is
                         used.

     locks [ -r ] [ ws  ... ]
                         With no option specified, the locks that
                         are  active for ws are listed.  If -r is
                         specified, the locks are listed and  the
                         user  is  prompted  for  which  lock  to
                         remove.

     move from_ws to_ws  Move the workspace from_ws to  workspace
                         to_ws.   If the move is across file sys-
                         tems, teamware will copy  all  files  to
                         to_ws  before  it  removes from_ws.  The
                         command updates  the  parent  and  child
                         workspaces to reflect the new location.



SunOS 5.5         Last change: 01 December 1992                 2






WORKSPACE(1)              User Commands              WORKSPACE(1)



                         Note: Do not use the SunOS mv command to
                         rename    or   move   workspaces.    The
                         workspace move command updates files  in
                         the  workspace's parent and children, as
                         well  as  logging  the  event   in   the
                         Codemgr_wsdata/history file.

                         If you inadvertently use the mv  command
                         to  move/rename a workspace and discover
                         that it has become  "disconnected"  from
                         its parent and children, you can use the
                         workspace move command to reconnect it.

                         For example, if you used the mv  command
                         to rename workspace A to file B:

                         1. Use the  workspace  move  command  to
                         rename  B to C.  The command updates the
                         workspace's new name (C) in  the  parent
                         and child workspaces.

                         2. Lastly, use the workspace  move  com-
                         mand  to  change C back to B. Everything
                         should be reconnected.

     name                Name  the  workspace  that  the  current
                         directory resides in.

     parent [ -f ][ -p newparent ] [ -r ] [ -u ] [ ws ... ]
                         List ws's parent workspace, reparent  ws
                         or  unparent ws.  With no options speci-
                         fied, the ws's parent is  listed.   With
                         the  -r option, ws's ancestor workspaces
                         are recursively listed, each new genera-
                         tion  indented two spaces. The recursive
                         list begins with  the  parent  workspace
                         and  proceeds  through the previous gen-
                         erations.  If more than one ws is speci-
                         fied,  the  name of each ws precedes its
                         list.  If the - p  option  is  set,  the
                         workspace    will   be   reparented   to
                         newparent; ws's name is removed from its
                         current  parent's  children list, and is
                         added to newparent's children list.   If
                         the old parent no longer exists, use the
                         -f option to  force  the  reparent.   To
                         change  the  workspace  so  that  it  no
                         longer has a parent, use the -u option.

     updatenames [ -z ] [ ws ... ]
                         Update ws's name table by searching  the
                         workspace  for  SCCS files.  With the -z



SunOS 5.5         Last change: 01 December 1992                 3






WORKSPACE(1)              User Commands              WORKSPACE(1)



                         option, also  update  files'  name  his-
                         tories, if they are out of date.  ws can
                         also be the name of an  environment.   A
                         workspace's name table contains an entry
                         for every SCCS file in  that  workspace.
                         Each  entry  consists  of  a  workspace-
                         relative file name and four  hexadecimal
                         numbers  computed  from the file's first
                         SCCS delta.  The bringover  and  putback
                         commands  rely on the name tables in the
                         parent and child  workspaces  to  detect
                         and  propagate  renames.   Even  if  one
                         workspace's name table has been outdated
                         by a rename in that workspace, bringover
                         and putback can  detect  the  rename  by
                         inspecting both workspaces' name tables.
                         The bringover and putback commands iden-
                         tify  renamed  files and update the name
                         table  accordingly.   The   larger   the
                         workspace, the more time required to run
                         this command.

                         In some cases when SCCS files have  been
                         copied  within  a workspace, updatenames
                         interactively prompts the user  for  the
                         current names of some SCCS files.

ENVIRONMENT
     CODEMGR_PATH_ONLY        TeamWare commands first search  for
                              other TeamWare binaries relative to
                              where their own binary  is  located
                              in   the  file  system,  they  then
                              search in the directories specified
                              in  the  PATH environment variable.
                              Setting   this   variable    causes
                              TeamWare  commands  to  search  for
                              other  TeamWare  binaries  only  in
                              PATH.

     CODEMGR_WS               Contains  the  name  of  a   user's
                              default  workspace.   The workspace
                              specified   by   CODEMGR_WS    will
                              automatically  be used if -w option
                              is not specified to a command.

     CODEMGR_WSPATH           Specifies  a  list   of   workspace
                              directories   to  be  automatically
                              loaded into the workspace pane upon
                              tool startup.

                              The CODEMGR_WSPATH variable can  be
                              to  set  to one or more directories



SunOS 5.5         Last change: 01 December 1992                 4






WORKSPACE(1)              User Commands              WORKSPACE(1)



                              that contain workspace directories.
                              For  example,  to set this variable
                              to the directories  /export/home/ws
                              and  ~/projects/ws, use the follow-
                              ing command:

                              example%   setenv    CODEMGR_WSPATH
                              "/export/home/ws ~/projects/ws"

USAGE
SEE ALSO
     TeamWareUser'sGuide
     bringover(1),  def.dir.flp(1),   filemerge(1),   putback(1),
     resolve(1),   teamware(1),   ws_undo(1),  access_control(4),
     args(4), children(4),  conflicts(4),  history(4),  locks(4),
     nametable(4), notification(4), parent(4)







































SunOS 5.5         Last change: 01 December 1992                 5



