Sun WorkShop TeamWare 2.1 User's Guide

Viewing Workspace Command History

Configuring commands are logged in the text file Codemgr_wsdata/history. Commands that affect a single workspace are logged only in that workspace; interworkspace transactions are logged in both the source and destination workspaces.

Note -

Although command entries are logged in both the source and destination workspaces, the list of changed files is entered only in the destination directory.

You can view the contents of this file to track or reconstruct changes that have been made to a workspace over time. Log entries consist of the underlying command-line entries and do not correspond to GUI menu item names. If you have any questions about the meaning or syntax of a command, refer to its man page for details. Table 7-6 lists the GUI operations and the corresponding CLI command that is entered in the history log.

Table 7-6 Corresponding GUI and CLI Commands


GUI Menu Item	Corresponding CLI Command
Create Workspace	`workspace` `create`
Rename	`workspace` `move`
Parent	`workspace` `parent`
Bringover Create	`bringover`
Bringover Update	`bringover`
Putback	`putback`
Undo	`ws_undo`
Resolve	`resolve`

Note -

In active workspaces, the Codemgr_wsdata/history file can grow very quickly. You may want to periodically prune the file to reduce its size.

The following portion of a history file was generated during a Bringover Update transaction; entries are described in Table 7-7. This entry is taken from the history file in the child; the corresponding entry in the parent is identical except that file status messages are not included.

COMMAND bringover -w /home/sponge3/larryh/ws/man_pages -p

/home/sponge3/larryh/ws/manpages man trans/man

update: man/Makefile

update: man/man5/access_control.5

create: man/man5/notification.5

create: man/man1/codemgr.1

rename from: man/man1/def.dir.flg.1

to: man/man1/def.dir.flp.1

update: man/man1/def.dir.flp.1

create: man/man1/codemgrtool.1

rename from: man/man1/fileresolve.1

to: deleted_files/man/man1/fileresolve.1

update children's name history:

deleted_files/man/man1/fileresolve.1

rename from: man/man1/resolve_tty.1

to: deleted_files/man/man1/resolve_tty.1

update: deleted_files/man/man1/resolve_tty.1

create: trans/man/man1/codemgr_acquire.1

create: trans/man/man1/codemgr_prepare.1

CWD /tmp_mnt/home/sponge3/larryh/temp

RELEASE Beta 1.0

HOST croak

USER larryh

PARENT_WORKSPACE (/home/sponge3/larryh/ws/manpages) (sponge:/export/home/sponge3/larryh/ws/manpages)

CHILD_WORKSPACE (/home/sponge3/larryh/ws/man_pages) (sponge:/export/home/sponge3/larryh/ws/man_pages)

START (Mon Jul 13 13:31:16 1992 PDT) (Mon Jul 13 20:31:16 1992 GMT)

END (Mon Jul 13 13:32:08 1992 PDT) (Mon Jul 13 20:32:08 1992 GMT)

STATUS 0

Table 7-7 History File Entry Descriptions


Entry	Description
`COMMAND`	Underlying command line issued for the operation. File status messages as displayed in the Transaction Output window are included only in the destination workspace history file.
`CWD`	Name of the current working directory when the command was executed.
`RELEASE`	Release number of the TeamWare software
`HOST`	Name of the system from which the command was executed.
`USER`	Login name of the user who executed the command.
`PARENT_WORKSPACE`	The path name of the parent workspace specified in two formats: host-specific and `machine`:`pathname`.
`CHILD_WORKSPACE`	The path name of the child workspace specified in two formats: host-specific and `machine`:`pathname`.
`START`	Time the command started execution, both locally and as measured by Greenwich Mean Time (GMT).
`END`	Time the command completed execution, both locally and as measured by Greenwich Mean Time (GMT).
`STATUS`	Exit status of the command: 0 = Normal completion, any other value indicates an error condition, warning, or other status.