Directory
Directory / Change Attributes
Modify the class attributes of a directory.
This web service runs the fschdiat
command.
Parameters
Parameter |
Req / Opt |
Num |
Description |
CLI Option |
mode |
Optional | 1 | This option specifies if the job will be run synchronously or asynchronously. The valid values are sync and async. The default value is sync. | None |
jobtype |
Optional | 1 | This parameter is used for async mode only and enables the user to run it as a fast or slow job. Valid values are fast and slow. The default value is fast. | None |
|
Optional |
1 |
The output format requested. Valid values are xml, json and text. The default is text. |
|
|
Required |
N |
Directory or directories to modify. |
|
|
Optional |
1 |
This option indicates how storage policies operate. Valid values are exclude and policy. The exclude option excludes files from storage when a store policy occurs. The policy option stores files by storage policy. |
|
|
Optional |
1 |
This option indicates how relocation policies operate. Valid values are exclude and policy. The exclude option excludes files from storage when a store policy occurs. The policy option stores files by storage policy. |
|
|
Optional |
1 |
This option indicates how truncation policies operate. Valid values are exclude and policy. The exclude option excludes files from storage when a store policy occurs. The policy option stores files by storage policy. |
|
|
Optional |
1 |
This option indicates if the database entries are to be cleaned when the file is removed from the file system. The yes option indicates that the database entries will be cleaned and the file will NOT be recoverable. The no option indicates that the database entries will NOT be cleaned and the file will be recoverable. |
|
|
Optional |
1 |
This specifies the class that will be associated with the directory. |
|
|
Optional |
1 |
This indicates the stub size (in kilobytes) and is used to determine the number of bytes to leave on disk when files are truncated. It will be the minimum number of bytes left on disk (the value is rounded up to a multiple of the file system block size). If policy is specified as the value, then the policy class definitions will be used to determine the stub size. |
|
|
Optional |
1 |
The directory from which to start the recursive operation. |
|
Example
https://<<SERVER>>/sws/v2/directory/fschdiat ?policy=smp4 &directory=/stornext/snfx1/smp2data/foodir0 &format=xml |
Output
<?xml version="1.0" encoding="UTF-8"?> <fschdiat xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="fschdiat.xsd"> <header> <commandName>fschdiat</commandName> <commandLine>/usr/adic/TSM/bin/fschdiat -c smp4 -F xml /stornext/snfx1/smp2data/foodir0</commandLine> <commandDescription>Modify the class attributes of a directory</commandDescription> <localDateISO>2015-12-03T11:49:12</localDateISO> <localDate>2015-12-03</localDate> <localTime>11:49:12</localTime> <localDayOfWeek>4</localDayOfWeek> <gmtDateISO>2015-12-03T18:49:12Z</gmtDateISO> <gmtDate>2015-12-03</gmtDate> <gmtTime>18:49:12</gmtTime> <gmtDayOfWeek>4</gmtDayOfWeek> </header> <statuses> <status> <statusCode>FS0109</statusCode> <statusNumber>109</statusNumber> <dayOfMonth>3</dayOfMonth> <requestId>180911</requestId> <commandName>/usr/adic/TSM/bin/fschdiat</commandName> <commandStatus>interim</commandStatus> <statusText>Command successful for /stornext/snfx1/smp2data/foodir0.</statusText> </status> <status> <statusCode>FS0390</statusCode> <statusNumber>390</statusNumber> <dayOfMonth>3</dayOfMonth> <requestId>180911</requestId> <commandName>/usr/adic/TSM/bin/fschdiat</commandName> <commandStatus>completed</commandStatus> <statusText>1 out of 1 directory attribute changes were successful.</statusText> </status> <status> <statusCode>FS0000</statusCode> <statusNumber>0</statusNumber> <dayOfMonth>3</dayOfMonth> <requestId>180911</requestId> <commandName>/usr/adic/TSM/bin/fschdiat</commandName> <commandStatus>completed</commandStatus> <statusText>Command Successful.</statusText> </status> </statuses> <footer> <returnCode>0</returnCode> <localDateISOEnd>2015-12-03T11:49:12</localDateISOEnd> <localDateEnd>2015-12-03</localDateEnd> <localTimeEnd>11:49:12</localTimeEnd> <localDayOfWeekEnd>4</localDayOfWeekEnd> <gmtDateISOEnd>2015-12-03T18:49:12Z</gmtDateISOEnd> <gmtDateEnd>2015-12-03</gmtDateEnd> <gmtTimeEnd>18:49:12</gmtTimeEnd> <gmtDayOfWeekEnd>4</gmtDayOfWeekEnd> <elapsedTimeInSeconds>0.0003</elapsedTimeInSeconds> </footer> </fschdiat> |
Directory / Retrieve Files
Retrieve or recover files from media and place on disk.
This web service runs the fsretrieve
command.
Parameters
Parameter |
Req / Opt |
Num |
Description |
CLI Option |
mode |
Optional | 1 | This option specifies if the job will be run synchronously or asynchronously. The valid values are sync and async. The default value is sync. | None |
jobtype |
Optional | 1 | This parameter is used for async mode only and enables the user to run it as a fast or slow job. Valid values are fast and slow. The default value is fast. | None |
|
Optional |
1 |
The output format requested. Valid values are xml, json and text. The default is text. |
|
|
Required |
1 |
The directory from which to start the recursive retrieves. |
|
|
Optional |
1 |
Updates the access time for the requested files. Default value is false. |
|
|
Optional |
1 |
Specifies top priority and will cause all files for the retrieve request to be placed at the top of the retrieve queue. Default value is false. |
|
Example
|
Output
|