readme-do_with.txt

CMVC是IBM和许多跨国公司的缺陷管理工具。这里给出了很多在Linux下用KSH编写的使用CMVC命令的例子。这些例子来自于IBM内部的CMVC培训。

Subject: Instructions on how to use do_with to massively use CMVC commands
Date last updated: 01-Nov-2002

Question:
=========

Is there a way in which I could use the CMVC File command to create
in CMVC a large amount of files?

The use of a wild card did not work (File -create * ).  


Answer:
=======

The following are some alternatives that could work:

a) Use the CMVC GUI

An option is to use the CMVC GUI: Actions - Files - Create and then select 
the Browse button for the Path(s) and the list of files will be shown to you. 
You can then select a range for them and submit the file creation. 
I do not know what is the limit on the number of simultaneous files that 
you can enter at one time. I tried 50 and it worked fine.


b) Use a REXX script: do_with.cmd

I am glad to tell you that I was able to reuse a REXX script that 
I prepared many years ago and I was able today to perform a massive 
CMVC File -create of a directory tree. I performed the test in a Windows 2000 system 
with IBM Object Rexx and with the line commands of CMVC 4.0.
The advantage is that you can specify as many files as you want.


The prerequisite is that you need to have IBM Object REXX installed. 
You can visit ISSI to install it:
	http://w3-1.ibm.com/download/standardsoftware/na.html

This is the procedure:

1) You need to install REXX. For example, from ISSI:
IBM Object REXX for Windows Development Edition, Version 2.1

2) Place the REXX file "do_with.cmd" in a tools directory in your PATH.

3) Change to the directory where you have files to be handled, such as:

cd c:\temp

Note: 
In this case, the subdirectory c:\temp\coding has files and subdirectories with files.

4) Create a file that has all the files that you want to create in CMVC.

The "input_file_with_names" is the file with the list of filenames or
directories, in the format of 1 name per row, with the full path name for
each file (1 column).

You can obtain such list by using the following command in Windows:

   dir /b /s  >  input_file_with_fileNames

5) You may want to edit the file with the list to remove itself.

That is, it is possible that the file "input_file_with_fileNames" is listed itself.
Thus, it may need to be removed.

6) An example of the first few lines of this file is:

C:\temp\coding\batch
C:\temp\coding\C
C:\temp\coding\java
C:\temp\coding\ksh
C:\temp\coding\Perl
C:\temp\coding\rexx
C:\temp\coding\batch\batchLkd1.bat
C:\temp\coding\batch\batchParser1.bat
C:\temp\coding\C\hola.c

7) You need to remove for each file the part "C:\temp" in order to have the list
   of files as you want them to be in CMVC. 
   If you do not have the proper Editor to help you with this task, this could be
   very cumbersome. 
   However, if you have the proper Editor this step can be relatively easier:  
  
   For example, you can use SlickEdit and specify to do Edit - Select - Control Block
   or simply Ctrl-B and expand the highlighted area to cover ONLY C:\temp and then
   drag it down to the bottom of the file. You should see that the highlight is 
   only on the first 7 columns and the rest of the columns should not be in the "block"
   to be deleted. Then proceed with the deletion and if this properly done, then
   you should have something like this:
   
coding\batch
coding\C
coding\java
coding\ksh
coding\Perl
coding\rexx
coding\batch\batchLkd1.bat
coding\batch\batchParser1.bat
coding\C\hola.c


8) Ensure that you have a connection to the CMVC family. You may try the command:

Report -testServer

9) Ensure that you have the defect, track, release, component ready for the massive
   file creation in CMVC.
   
10) It is highly recommended that you manually create 1 file in CMVC (and remove this
file from the list or simply ignore the error message that this file was already
created, when you run the do_with.cmd script). 

You need to prepare the command in such a way that the "-create name" is the LAST
used with the File command.

For example:

C:\temp> File -release track-only-b -component ProjectB -defect 1014 -verbose 
    -relative c:\temp -create coding\C\hola.c 

11) To reduce the command, specify the proper environment variables, such as:

set CMVC_RELEASE=track-only-b
set CMVC_COMPONENT=ProjectB

... then try again

C:\temp> File -defect 1014 -verbose -relative c:\temp -create coding\C\hola.c

12) Now you can proceed to perform the massive File creation.

You need to ensure that the command specified in step 11 is properly specified,
and the "-create" must be the last text in the command line. The reason is that
the "do_with.cmd" will read the file names and then invoke the command and will
append the file name after the -create flag.

C:\temp>rexx do_with.cmd input_file_with_names File -defect 1014 -verbose -relative c:\temp -create

Note: You may get error messages about trying to create a directory in CMVC.
This is OK, just ignore it.

13) Use the CMVC GUI or the following command to verify that the files were properly
created:

Report -view FileView -where "releaseName in ('%CMVC_RELEASE%')"


Please let me know if you have questions about this topic.

Thanks!

Angel Rivera

+++ end +++