📄 readme-cmvc-client-samples.html
字号:
<!DOCTYPE html PUBLIC "-//IETF//DTD HTML 2.0//EN"><!-- *********************************************************************** --><!-- File name: README-cmvc-client-samples.html --><!-- Description: Details on the package "cmvc-client-samples" package --><!-- from the IIOSB project "CMVC Utilities" --><!-- *********************************************************************** --><html><head><title> CMVC client samples </title></head><body><p> Date of last update: 08-Jan-2003 </p><h1> CMVC client samples - Overview</h1><p>This package provides a collection of samples for the CMVC client (command line).It is available from the IBM Internal Open Source Bazaar (IISOB).<ul><li> IIOSB Project: CMVC Utilities<li> Web page: <a href="http://w3.opensource.ibm.com/projects/cmvc-utilities/">http://w3.opensource.ibm.com/projects/cmvc-utilities/</a><li>Package: "cmvc-client-samples" (CMVC client samples)<li>Release: 1.4</ul><p>Users running these scripts require User and Host access to a CMVC family.<p>Most of the scripts require input parameters and some require the CMVC_FAMILYand/or CMVC_RELEASE environment variables. If the user running the script is acting on behalf of another user, then the CMVC_BECOME environment variable must be set.<p>Many of the scripts make use of the /tmp directory. If this directory doesnot exist on your system, then either create it or modify the scripts to usethe temporary directory which is appropriate for your system.<h1> <a name="top"> Table of contents </a></h1><ul><li> <a href="#ii"> Installation instructions </a><li> <a href="#support"> Support </a><li> <a href="#samples"> Client Samples </a><ul><li> <a href="#au"> allUsers </a><li> <a href="#cloned"> cloneDefect </a><li> <a href="#clonedff"> cloneDefFromFea </a><li> <a href="#cloneffd"> cloneFeaFromDef </a><li> <a href="#clonef"> cloneFeature </a><li> <a href="#cfci"> commonFileCheckin </a><li> <a href="#compa"> compAccess </a><li> <a href="#coreqv"> coreqView </a><li> <a href="#defRep"> defectReport </a><li> <a href="#defins"> defectsInState </a><li> <a href="#defstat"> defectStats</a><li> <a href="#defffch"> defFeaFileChgs</a><li> <a href="#dowith"> do_with.cmd (Rexx)</a><li> <a href="#xaffc"> extractAllFilesForComponent </a><li> <a href="#xcffr"> extractCommittedFilesForRelease </a><li> <a href="#xcuffr"> extractCurrentFilesForRelease </a><li> <a href="#xffcol"> extractFilesForCommittedLevel </a><li> <a href="#xffcofr"> extractFilesForComponentForRelease </a><li> <a href="#xfft"> extractFilesForTrack </a><li> <a href="#xffunl"> extractFilesForUncommittedLevel </a><li> <a href="#xlumf"> extractLevelUsingMapFile </a><li> <a href="#filelk"> fileLkAfterRelLk </a><li> <a href="#profile"> profile.client </a><li> <a href="#what"> what.exe for Windows </a></ul><li> <a href="#other"> Other Samples </a><li> <a href="#old"> Old Samples </a></ul><h1> <a name="ii"> Installation instructions </a></h1><p>The files in the package are extracted into a subdirectory "samples".Thus, if you extract the files in $CMVC_HOME, the files will be placedin the directory: $CMVC_HOME/samples<ol><li>For AIX, you will need the "gunzip" utility which can be downloaded from:<a href="http://aixpdslib.seas.ucla.edu/packages/gzip.html">http://aixpdslib.seas.ucla.edu/packages/gzip.html</a><ol><li> Login as root.<li> Download the compressed tar file (*.tar.Z) for the gzip utilities intoa download directory, such as /tmp or /downloads.<li> Change to that directory, such as: cd /tmp<li> Uncompress the file: <pre>uncompress gzip *.Z</pre><li> Change to the root directory:<pre>cd /</pre><li> Untar the file, which will be expanded in /usr/local/bin:<pre>tar -xvf /tmp/gzip*.tar</pre></ol><li>Download the package "cmvc-client-samples" into the directory whereyou want them to be expanded.<p>For example, you can login as "root" and change the directory to $CMVC_HOMEand download the package in this directory.<pre>cd $CMVC_HOME</pre><li>Uncompress the package:<p>AIX:<pre>gunzip cmvc-client-samples.tar.gztar -xvf cmvc-client-samples.tar</pre><p>Linux:<pre>tar -zxvf cmvc-client-samples.tar.gz</pre><li>Ensure that the file ownership and permissions are the appropriate onesfor your installation.<p>For example, to set the default 0755 file permissions and ownership (userid=bin, groupid=bin) do the following:<pre>cd sampleschmod 0755 *chown bin:bin *</pre> </ol><h1> <a name="support"> Support </a></h1><p>Starting with CMVC 4.0, the samples are no longer provided with the installationimages for the CMVC server or the CMVC client.Instead, the samples are made available now via the appropriate packagefrom the project "CMVC Utilities" from theIBM Internal Open Source Bazaar (IIOSB):<a href="http://w3.opensource.ibm.com/projects/cmvc-utilities/">http://w3.opensource.ibm.com/projects/cmvc-utilities/</a><p>To report a defect (bug) related to one of the provided samples, visit the above URL, and then submit a bug report by selecting the item:<b>Bug Tracking</b><p>The support of these samples is "as-is" and "best-efforts".That is, there are volunteers who will try to fix the reported problems andprovide fixes in a newer release of the appropriate package.<p>An advantage of using the IIOSB is that the delivery of the fixes for the samplesis done outside the scope of a formal release of the CMVC code or a CMVC fixpak.This means that there is a potential for a faster response than waiting fora formal CMVC fixpak.<h2>Contributing samples to this package</h2><p>The samples included in this package are provided in source code.Thus, the users of the package are welcome to make modifications to these samplesor create newer samples that are derived from those samples.<p>If you want to submit a revised sample or a newer sample for this package,you can post an append to the <b>Public Forums</b> from the web site of the <a href="http://w3.opensource.ibm.com/projects/cmvc-utilities/">CMVC Utilities project.</a><h2> How to prepare this package </h2><p><b>Note</b>This information is relevant only to the maintainers of this package.<p>The source code of the samples and of this README file are storedinside the CMVC family called "ausbo", under the release name of "samples-client".<p>To prepare this package, do:<ul><li>It is recommended to prepare the tar.gz file under AIX or Linux.Try to avoid preparing the package under Windows, because of the CR-LF problem,because these samples will be executed under AIX or Linux.<li>Change to the directory where you want to do the work, such as:<pre>mkdir $HOME/samples-clientcd $HOME/samples-client</pre><li>Extract the release "samples-client".The files will be extracted into the "samples" subdirectory:<pre>Release -extract samples-client -node direct -root $PWD -verbose</pre><li>Make any changes (add/delete/rename file) and update this readme file.<li>When ready, package and compress the files:<pre>cd $HOME/samples-clienttar -cvf cmvc-client-samples.tar ./samplesgzip cmvc-client-samples.tar</pre><p>Ensure that the file extension is tar.gz<li>Place the new release of this package in the "CMVC Utilities" project in IIOSB.Follow the instructions in the note titled "FAQ: How to create and release a new package in an IIOSB project (targeted for novice project administrators)",from the CMVC Development TeamRoom, category "Procedures".</ul><hr><h1> <a name="samples"> Client Samples </a></h1><h2> <a name="au"> allUsers </a></h2><p> The following text was copied from the header of the Korn shell script:</p><pre>#!/bin/ksh## SAMPLE NAME: allUsers## FUNCTIONS: This sample shell script lists the addresses of all users in# a specified family.## USAGE: allUsers familyName## ENVIRONMENT# VARIABLE(S): [CMVC_BECOME]</pre><h2> <a name="cloned"> cloneDefect </a></h2><p> The following text was copied from the header of the Korn shell script:</p><pre>#!/bin/ksh## SAMPLE NAME: cloneDefect## FUNCTIONS: This sample shell script creates a new defect based on values# contained in a specified defect.## USAGE: cloneDefect defectNumber## ENVIRONMENT# VARIABLE(S): CMVC_FAMILY [CMVC_BECOME]</pre><h2> <a name="clonedff"> cloneDefFromFea </a></h2><p> The following text was copied from the header of the Korn shell script:</p><pre>#!/bin/ksh## SAMPLE NAME: cloneDefFromFea## FUNCTIONS: This sample shell script creates a new defect based on# values contained in a previously created feature.## USAGE: cloneDefFromFea featureNumber## ENVIRONMENT# VARIABLE(S): CMVC_FAMILY [CMVC_BECOME]</pre><h2> <a name="cloneffd"> cloneFeaFromDef </a></h2><p> The following text was copied from the header of the Korn shell script:</p><pre>#!/bin/ksh## SAMPLE NAME: cloneFeaFromDef## FUNCTIONS: This sample shell script creates a new feature based on# values contained in a previously created defect.## USAGE: cloneFeaFromDef defectNumber## ENVIRONMENT# VARIABLE(S): CMVC_FAMILY [CMVC_BECOME]</pre><h2> <a name="clonef"> cloneFeature </a></h2><p> The following text was copied from the header of the Korn shell script:</p><pre>#!/bin/ksh## SAMPLE NAME: cloneFeature## FUNCTIONS: This sample shell script creates a new feature based on values# contained in a specified feature.## USAGE: cloneFeature featureNumber## ENVIRONMENT# VARIABLE(S): CMVC_FAMILY [CMVC_BECOME]</pre><h2> <a name="cfci"> commonFileCheckin </a></h2><p> The following text was copied from the header of the Korn shell script:</p><pre>#!/bin/ksh## SAMPLE NAME: commonFileCheckin## FUNCTIONS: This sample shell script checks in a common file to multiple# releases.## USAGE: commonFileCheckin filePathName releaseName defectNumber Remarks## ENVIRONMENT# VARIABLE(S): CMVC_FAMILY [CMVC_BECOME]</pre><h2> <a name="compa"> compAccess </a></h2><p> The following text was copied from the header of the Korn shell script:</p><pre>#!/bin/ksh## SAMPLE NAME: compAccess## FUNCTIONS: This sample shell script lists the explicit access# of users in a specified component.## USAGE: compAccess componentName## ENVIRONMENT# VARIABLE(S): CMVC_FAMILY [CMVC_BECOME]</pre><h2> <a name="coreqv"> coreqView </a></h2><p> The following text was copied from the header of the Korn shell script:</p><pre># SAMPLE NAME: coreqView## FUNCTIONS: This sample shell script lists the coreqs of the specified # defect/feature in the specified release. # The subject defect/feature is shown also # (if any coreqs exist.) # # USAGE: [-r release] defect/feature Name ## ENVIRONMENT# VARIABLE(S): CMVC_FAMILY [CMVC_RELEASE] [CMVC_BECOME]</pre><h2> <a name="defRep"> defectReport </a></h2><p> The following text was copied from the header of the Korn shell script:</p><pre># SAMPLE NAME: defectReport## FUNCTIONS: This sample shell script generates a global defect report# showing tracks, tests, approvals and fixes.## The report contains 132 columns of data and should be piped# to an output file for subsequent printing.## USAGE: defectReport## ENVIRONMENT# VARIABLE(S): CMVC_FAMILY [CMVC_BECOME]</pre><h2> <a name="defins"> defectsInState </a></h2><p> The following text was copied from the header of the Korn shell script:</p><pre># SAMPLE NAME: defectsInState## FUNCTIONS: This sample shell script lists the defect number# of all defects that are in a specified state.## USAGE: defectsInState state## ENVIRONMENT# VARIABLE(S): CMVC_FAMILY [CMVC_BECOME]</pre><h2> <a name="defstat"> defectStats</a></h2><p> The following text was copied from the header of the Korn shell script:</p><pre># SAMPLE NAME: defectStats⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -