ADD2LIST.EXE

add2list.exe name-and-path-of-list-file 
complete-name-and-path-of-file-extracted 
complete-name-and-path-of-new-file
optional-seconds-to-wait 
optional-default-directory
optional-command-to-perform
optional-parameter-to-command ...

The first three (3) parameters are strictly for the purposes of maintaining the inuse file. The other parameters facilitate keeping a ‘reference’ copy of the contents of the configuration management tool up to date.

The seconds-to-wait parameter specifies the number of seconds to wait before performing the command, this may be particularly useful for avoiding deadlock situations. Specifying a seconds to wait of other than 0 in a windows environment, forces the del2list command to operate as an asynchronous process (in Unix use the & operator as normal to create an asynchronous process).

Whilst the last four (4) parameters are optional, if you wish to specify a later parameter, you must specify the earlier parameters (e.g., you cannot specify command-to-perform without specifying seconds-to-wait and default-directory, but they may be 0 and .).

The filenames may optionally contain special strings that are replaced by del2list before it writes the filename to the inuse file:

String Replaced by
:local: nothing
:cwd: current working directory
/ \ in windows platforms
\ / in non-windows platforms

add2list recognises the following options:

Option Meaning
-rstring;string String to remove from the first 3 parameters. This is useful for removing duplicate drive specifiers, or mount points from the filenames.
-v Verbose mode, prints the command line
-x Do not activate asynchronous mode. Asynchronous mode is only activated on Windows platforms.
-j~ combine parameters delimited by a ~, replace all spaces with separator characters (eg: for Windows:\\ or for Unix:/)..
-afilename.asn Assignment file to use for redirection of .frm, .aps, .svc and .rpt files.

Example

add2list h:\inuse  h:\A001.XML g:\src\uform\A001.XML 2 . command.com /c type h:\A001.XML

or

add2list h:\inuse  %cvsroot%\A001.XML :cwd:A001.XML 2 . command.com /c type h:\A001.XML

For more information about the INUSE file please see:

INUSE file format Format of the file for ‘checked out’ files.
USYS$UD6_PARAMS Actual driver parameters from assignment file.
SQL Workbench For use with running operating system commands and updating parameters during an IDF session

$Revision: 1.7.4.3 $ $Date: 2003/09/16 17:52:05 $[zum Seitenanfang]