fssrv.script

Software Testing Automation Framework (STAF)的开发代码

windoc.txt
mytest.txt
svt-spa02dynos390.txt
:exmp.
:p.
:li.:hp2.Goal::ehp2. Recursively list all the entries in the /tmp/test1 directory
with a name of "hello" and an extension of "txt" and sort the matching entries
by name.
.br
:hp2.Syntax::ehp2.  :xph.LIST DIRECTORY /tmp/test1 RECURSE SORTBYNAME:exph.
.br
:hp2.Results::ehp2. If the request is submitted from the
command line, the result, in default format, could look like the following:
:xmp.
hello.txt
test1/docs/hello.txt
test1/backup/docs/hello.txt
test4/hello.txt
:exmp.
:p.
:li.:hp2.Goal::ehp2. Recursively list all the entries in the C&colon./temp
directory with a name of "test1", sorted by name with details about each
matching entry.
.br
:hp2.Syntax::ehp2.  :xph.LIST DIRECTORY C&colon./temp NAME test1 RECURSE SORTBYNAME LONG DETAILS:exph.
.br
:hp2.Results::ehp2. If the request is submitted from the
command line, the result, in default format, could look like the following:
:xmp.
Name                               Type U-Size L-Size Modified Date-Time
---------------------------------- ---- ------ ------ ------------------
icu\source\test\testdata\test1.ucm F    0      871    20031028-19:18:22
test1                              D    0      0      20030707-11:47:40
test1.bak                          F    0      83     20030919-11:10:22
test4\test1.txt                    F    0      34     20060331-13:03:04
:exmp.
:eul.
.*
.*---------------------------------------------------------------------
.*
:ih1.service commands
:ih2.LIST COPYREQUESTS
:i3.file system service
:h3.LIST COPYREQUESTS
:p.LIST COPYREQUESTS displays the File System copy requests currently in
progress.
:h4.Syntax
:xmp.
LIST   COPYREQUESTS &lbrk.LONG&rbrk. &lbrk.INBOUND&rbrk. &lbrk.OUTBOUND&rbrk.
       &lbrk.FILE &lbrk.&lbrk.BINARY&rbrk. &lbrk.TEXT&rbrk.&rbrk.&rbrk. &lbrk.DIRECTORY&lbrk.
:exmp.
:p.:xph.COPYREQUESTS:exph. specifies to list the :xph.COPY:exph. requests currently
in progress.
:p.:xph.LONG:exph. specifies to list more detailed information about the
copy requests, such as the copy mode and current state of the copy request.
:p.:xph.INBOUND:exph. specifies to list :xph.COPY:exph. requests that are copying
to the machine.
:p.:xph.OUTBOUND:exph. specifies to list :xph.COPY:exph. requests that are copying
from the machine.
:p.:xph.FILE:exph. specifies to list :xph.COPY FILE:exph. requests.
:p.:xph.BINARY:exph. specifies to list :xph.COPY FILE:exph. requests that are 
copying a file in binary format.
:p.:xph.TEXT:exph. specifies to list :xph.COPY FILE:exph. requests that are copying
a file in text format.
:p.:xph.DIRECTORY:exph. specifies to list :xph.COPY DIRECTORY:exph. requests.
:p.
If none of the optional options are specified (other than a :xph.LONG:exph.
option), all of the copy requests currently in progress will be shown.
:h4.Security
:p.&seclvl. 2.
:h4.Return Codes
:p.All return codes from LIST COPYREQUESTS are documented in :hdref refid=retcode..
:h4.Results
:p.On successful return, the result buffer will contain a list of the
copy requests currently in progress as follows:
:ul.
:li.If the :xph.LONG:exph. option is not specified, the result buffer will contain
a marshalled :xph.<List> of <Map&colon.STAF/Service/FS/CopyRequest>:exph.
representing the copy requests in progress.
The map is defined as follows:
:table cols='* * * 2*' id=fsCopyRequestTable.
:tcap.Definition of map class STAF/Service/FS/CopyRequest
:tnote text='Description'.This map class represents a copy request in progress.
:thd.
:c.Key Name
:c.Display Name
:c.Type
:c.Format / Value
:ethd.
:row.
:c.startTimestamp
:c.Start Date-Time
.br
(Date-Time)
:c.&stringObj.
:c.&timestampFormat.
:row.
:c.io
:c.In/Out
.br
(I/O)
:c.&stringObj.
:c.:xph.'In' | 'Out':exph.
:row.
:c.machine
:c.Machine
:c.&stringObj.
:c.
:row.
:c.name
:c.Name
:c.&stringObj.
:c.
:row.
:c.type
:c.Type
:c.&stringObj.
:c.:xph.'D' | 'F':exph.
:tnote text='Notes'. 
:ol compact.
:li.The "Start Date-Time" value will contain the date and time that the
copy request started.
:li.The "In/Out" value will contain :xph.'In':exph. if the :xph.COPY:exph.
request is copying a file/directory to this machine or :xph.'Out':exph.
if the :xph.COPY:exph. request is copying a file/directory from this machine.
:li.If "In/Out" contains :xph.'In':exph., the "Machine" value will contain
the endpoint of the machine the file/directory is being copied from and the
"Name" value will contain the name of the file/directory being copied to.
If "In/Out" contains :xph.'Out':exph., the "Machine" value will contain
the endpoint of the machine the file/directory is being copied to and the
"Name" value will contain the name of the file/directory being copied from.
:li.The "Type" value will contain :xph.'D':exph. to represent a
:xph.COPY DIRECTORY:exph. request or :xph.'F':exph. to represent a
:xph.COPY FILE:exph. request. 
:eol.
:etnote.
:etable.
:p.
:li.If the :xph.LONG:exph. option is specified, the result buffer will
contain a marshalled :xph.<List>:exph. of any of the following map classes
representing detailed information about the copy requests in progress:
:ul compact.
:li.:xph.<Map&colon.STAF/Service/FS/CopyFile>:exph. represents detailed
information about a file being copied (shown in table :tref refid=fsCopyFileTable.).
:li.:xph.<Map&colon.STAF/Service/FS/CopyDirectory>:exph. represents detailed
information about a directory being copied (shown in table
:tref refid=fsCopyDirectoryTable.).
:eul.
:p.
The maps used in representing detailed information about copy requests
are defined as follows: 
:table cols='* * * 2*' id=fsCopyFileTable.
:tcap.Definition of map class STAF/Service/FS/CopyFile
:tnote text='Description'.This map class represents detailed information
about a file being copied.
:thd.
:c.Key Name
:c.Display Name
:c.Type
:c.Format / Value
:ethd.
:row.
:c.startTimestamp
:c.Start Date-Time
.br
(Date-Time)
:c.&stringObj.
:c.&timestampFormat.
:row.
:c.io
:c.In/Out
.br
(I/O)
:c.&stringObj.
:c.:xph.'In' | 'Out':exph.
:row.
:c.machine
:c.Machine
:c.&stringObj.
:c.
:row.
:c.name
:c.File Name
:c.&stringObj.
:c.
:row.
:c.type
:c.Type
:c.&stringObj.
:c.:xph.'F':exph.
:row.
:c.mode
:c.Mode
:c.&stringObj.
:c.:xph.'Binary':exph. | :xph.'Text':exph.
:row.
:c.state
:c.Transfer State
:c.:xph.<Map&colon.STAF/Service/FS/FileCopyState>:exph.
:c.
:tnote text='Notes'. 
:ol compact.
:li.The "Mode" value will be set to :xph.'Binary':exph. indicating
that the file copy is being performed in binary mode or 
:xph.'Text':exph. indicating that the file copy is being performed
in text mode.
:li.See table :tref refid=fsFileCopyStateTable. for the definitions
of other fields.
:eol.
:etnote.
:etable.
:table cols='* * * 2*' id=fsFileCopyStateTable.
:tcap.Definition of map class STAF/Service/FS/FileCopyState
:tnote text='Description'.This map class represents detailed information
about the state of a file being copied.
:thd.
:c.Key Name
:c.Display Name
:c.Type
:c.Format / Value
:ethd.
:row.
:c.fileSize
:c.File Size
:c.&stringObj. | &noneObj.
:c.
:row.
:c.bytesCopied
:c.Bytes Copied
:c.&stringObj.
:c.
:tnote text='Notes'. 
:ol compact.
:li.The "File Size" value will contain the size of the file being
copied in bytes or &noneObj. if that information is not available
(like for inbound text file copies). 
:li.The "Bytes Copied" value will contain the number of bytes in the
file that have been copied.
:eol.
:etnote.
:etable.
:table cols='* * * 2*' id=fsCopyDirectoryTable.
:tcap.Definition of map class STAF/Service/FS/CopyDirectory
:tnote text='Description'.This map class represents detailed information
about a directory being copied.
:thd.
:c.Key Name
:c.Display Name
:c.Type
:c.Format / Value
:ethd.
:row.
:c.startTimestamp
:c.Start Date-Time
.br
(Date-Time)
:c.&stringObj.
:c.&timestampFormat.
:row.
:c.io
:c.In/Out
.br
(I/O)
:c.&stringObj.
:c.:xph.'In' | 'Out':exph.
:row.
:c.machine
:c.Machine
:c.&stringObj.
:c.
:row.
:c.name
:c.File Name
:c.&stringObj.
:c.
:row.
:c.type
:c.Type
:c.&stringObj.
:c.:xph.'D':exph.
:row.
:c.state
:c.Transfer State
:c.:xph.<Map&colon.STAF/Service/FS/DirectoryCopyState>:exph.
:c.
:tnote text='Notes'. 
:ol compact.
:li.For the "Transfer State", see table :tref refid=fsDirectoryCopyStateTable.
for the map class definition.
:li.See table :tref refid=fsCopyRequestTable. for the definitions
of other fields.
:eol.
:etnote.
:etable.
:table cols='* * * 2*' id=fsDirectoryCopyStateTable.
:tcap.Definition of map class STAF/Service/FS/DirectoryCopyState
:tnote text='Description'.This map class represents detailed information
about the state of the directory being copied.
:thd.
:c.Key Name
:c.Display Name
:c.Type
:c.Format / Value
:ethd.
:row.
:c.name
:c.Name
:c.&stringObj.
:c.
:row.
:c.mode
:c.Mode
:c.&stringObj.
:c.:xph.'Binary':exph. | :xph.'Text':exph.
:row.
:c.fileSize
:c.File Size
:c.&stringObj. | &noneObj.
:c.
:row.
:c.bytesCopied
:c.Bytes Copied
:c.&stringObj.
:c.
:tnote text='Notes'. 
:ol compact.
:li.The "Name" value will be set to the name of the file within
the directory that is currently being copied.
:li.The "Mode" value will be set to :xph.'Binary':exph. indicating
that the file copy is being performed in binary mode or
:xph.'Text':exph. indicating that the file copy is being performed
in text mode.
:li.The "File Size" value will contain the size of the file being
copied in bytes or &noneObj. if that information is not available
(like for inbound text file copies). 
:li.The "Bytes Copied" value will contain the number of bytes in the
file that have been copied.
:eol.
:etnote.
:etable.
:eul.

:h4.Examples
:p.
:ul.
:li.:hp2.Goal::ehp2. Show all the copy requests that are currently
in progress.
.br
:hp2.Syntax::ehp2.&nbsp; :xph.LIST COPYREQUESTS:exph.
.br
:hp2.Results::ehp2. If the request is submitted from the
command line, the result, in table format, could look like the following:
:xmp.
Start Date-Time   I/O Machine                Name                      Type
----------------- --- ---------------------- ------------------------- ----
20050725-18:31:32 Out tcp://client2.company. c:/temp/TestA             D
                      com
20050725-18:31:38 Out tcp://client1.company. c:/tests/Instructions.txt F
                      com@6500
20050725-18:31:38 In  client1.company.com    c:/temp/Instructions.txt  F
20050725-18:31:41 Out tcp://client3.company. c:/tests/TestB/TestB.zip  F
                      com
20050725-18:32:05 In  client2.company.com    c:/tests/TestC            D
:exmp.
:p.