cscfscls (Referencing a common folder)
- Organization of this page
Format
cscfscls [-h]
-user login-user-ID
-pass login-password
{-csc HCSC-server-name|-cluster cluster-name}
{-folder common-folder-definition-name|-all}
[-t start-date-and-time|-d number-of-days]
[-recursive]
Function
References the files in common folders.
By setting up default values for mandatory options, such as the login user ID, in the HCSC-Manager command definition file, you can omit the specification of these values in this command.
If there are user-created files and directories in the common folder, you can recursively reference the directories and files in those directories.
For details on how to use this command, see 5.4.21 Referencing the information of the common folder in the Service Platform Setup and Operation Guide.
Arguments
-h
Displays the usage of commands. When you specify this option, all other options are ignored even if specified.
-user login-user-ID ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 16 characters))
Specifies the user ID that is used to log in to HCSC-Manager. The characters are case sensitive.
-pass login-password ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 16 characters))
Specifies the password that is used to log in to HCSC-Manager. The characters are case sensitive.
-csc HCSC-server-name ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 8 characters))
Specifies the HCSC server name. The characters are case sensitive.
-cluster cluster-name ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 8 characters))
Specifies the cluster name. The characters are case sensitive.
-folder common-folder-definition-name ~ <one-byte alphanumeric characters and underscores (_)> ((1 to 64 characters))
Specifies the common folder definition name. The characters are case sensitive.
-all
References the files in all common folders.
-t start-date-and-time
References the files in the common folders older than the specified date and time. If the -recursive option is specified and there are no files in the subfolders in the common folders, the command references the subfolders older than the specified date and time. Note that you can specify the date and time in the following format. You must specify an existing date and time in 14 digits.
-
Start date and time: Specify the date and time in the YYYYMMDDhhmmss format.
YYYY: Year (1970
YYYY)
MM: Month (01
MM
12)
DD: Date (01
DD
31)
hh: Hours (00
hh
23)
mm: Minutes (00
mm
59)
ss: Seconds (00
ss
59)
-d number-of-days ~ <Integer> ((0 to 365))
References the files older than the specified number of days, in the common folder. If the -recursive option is specified and there are no files in the subfolders in the common folder, the command references the subfolders older than the specified number of days. Specify the number of days in days. If you specify 0, all the files in the common folder will be referenced.
-recursive
Recursively references files in the subfolders. The files in the subfolders are displayed for FileName by using the relative paths from the common folder root. For a subfolder that contains no files, the folder name suffixed with / is displayed for FileName.
Output format
-
When the command does not recursively reference the files in the subfolders
HCSCServerName CommonFolderName FileSize LastModifiedTime FileName HCSC-server-name common-folder-definition-name file-size last-update-time-of-file file-name ... HCSC-server-name common-folder-definition-name file-size last-update-time-of-file file-name
-
When the command recursively references the files in the subfolders
HCSCServerName CommonFolderName FileSize LastModifiedTime FileName HCSC-server-name common-folder-definition-name file-size last-update-time-of-file-or-folder file-name-or-folder-name ... HCSC-server-name common-folder-definition-name file-size last-update-time-of-file-or-folder file-name-or-folder-name
Description
|
Display item |
Description |
|---|---|
|
HCSCServerName |
Indicates the HCSC server name. |
|
CommonFolderName |
Indicates the common folder definition name. |
|
FileSize |
Indicates the file size in bytes. When a folder is displayed, 0 (bytes) is displayed. |
|
LastModifiedTime |
Indicates the last update time of a file or folder in the YYYY/MM/DD hh:mm:ss format. |
|
FileName |
Indicates file name or folder name. If the file name exceeds 200 bytes, the first 200 bytes are displayed. |
An example of output is as follows:
-
When the command does not recursively reference the files in the subfolders
HCSCServerName CommonFolderName FileSize LastModifiedTime FileName HCSC FOLDER1 1024 2010/04/26 14:26:39 ftpcommon.txt2010_04_26_14_26_39_111 HCSC FOLDER2 1050 2010/04/26 14:26:40 ftp.txt2010_04_26_14_26_39_222 HCSC FOLDER3 1020 2010/04/26 14:26:50 ftp.txt2010_04_26_14_26_39_333
-
When the command recursively references the files in the subfolders
HCSCServerName CommonFolderName FileSize LastModifiedTime FileName HCSC FOLDER1 156 2015/04/22 10:01:20 ftpcommon.txt HCSC FOLDER1 297 2015/04/22 10:01:20 sub1/ftp.txt HCSC FOLDER1 1089 2015/04/22 10:01:20 sub1/sub2/ftp.txt HCSC FOLDER1 0 2015/04/22 10:01:20 sub3/ HCSC FOLDER1 0 2015/04/22 10:01:21 sub4/sub5/
Return values
|
Return value |
Meaning |
|---|---|
|
0 |
The command terminated normally. |
|
1 |
The command terminated abnormally. |
|
2 |
A communication timeout occurred. |
|
3 |
An exclusion error occurred. |
|
9 |
An error occurred when checking the execution permission. |