Synopsis
fprssvr {/p [/w] | /e} /s:SourceName /d:DestName
[/rc:nn /ri:nnnn]Description
The fprssvr command compresses or expands local files on a server (including directories on the NFS server).
Parameters
/p
Compresses files.
/w
Compresses files in the format for Windows platform, which can be expanded on Windows. If omitted, the files are compressed in the format for UNIX platform, which cannot be expanded on Windows.
/e
Expands files.
/s:SourceName
Specifies a path name of the compression source file/expansion source file using a local path. The local path must be specified with an absolute path from the root directory, and it should look similar to "/usr/database/database.db". A path on the FTP server cannot be used to specify this parameter. You can use a wildcard for the file name of the compression source file.
Since wildcard characters such as an asterisk (*) have special meaning to shell, you need to enclose SourceName with either single or double quotation marks as necessary.
SourceName must be no longer than 255 characters. If SourceName contains a space character, enclose it in double quotation marks.
/d:DestName
Specifies a path name of the compression destination file/expansion destination file using a local path. A path on the FTP server cannot be used to specify this parameter. You can use a wildcard for the file name of the expansion destination file.
Since wildcard characters such as an asterisk (*) have special meaning to shell, you need to enclose DestName with either single or double quotation marks as necessary.
DestName must be no longer than 255 characters. If DestName contains a space character, enclose it in double quotation marks.
If the file name that already exists is specified, it will be overwritten. Note that the same file path name as the one (SourceName) specified with /s should not be specified.
/rc:nn
Specifies the retry count in case an error occurs in file compression/expansion. Specify an integer value between 0 and 99 for nn. Setting any other value results in an error. If omitted, no retry is performed.
If a wildcard is used to specify the compression source files or the expansion destination files, retry is performed only for the failed file.
/ri:nnnn
Specifies the retry interval in case an error occurs. Specify an integer value between 0 and 9999 (in seconds) for nnnn. Setting any other value results in an error. The default value is 0.
Return Values
Return value | Meaning |
|---|---|
0 | Completed |
Value other than 0 | Abended |
Command Location
Solaris | /opt/FJSVsnjss/bin |
HP-UX | /opt/FHPsnjss/bin |
AIX | /opt/FAIXsnjss/bin |
Linux | /opt/FJSVsnjss/bin |
Example
In this example, the local file "/database/database.prs" on the server is expanded to the local file "/database/copy/*.*". If expansion fails, retry is performed up to three times at an interval of 60 seconds.
fprssvr /e /s:/database/database.prs /d:/database/copy/*.* /rc:3 /ri:60
Execution Results/Output Format
After the command has been through processing, the information at command completion is output to the standard output.
The contents to be output are shown below:
[Process start time] MM-DD-YYYY HH:MM:SS [File compression/Expansion] Name of compression/expansion source files Name of compression/expansion destination files (*) [Retry count] Number of retries performed (*) [Error] Error message (*) [Process end time] MM-DD-YYYY HH:MM:SS
If a wildcard is used, the information of each is output by file basis.
In [Error], "None" is output if the command completed successfully. A message is output if the command is canceled or failed. For details on the messages, see the Systemwalker Operation Manager Message Guide.
If an error occurs before performing compression/expansion process, a message is output in the following format:
[Process start time] MM-DD-YYYY HH:MM:SS [Command error] Error message [Process end time] MM-DD-YYYY HH:MM:SS
For details on the messages, see the Systemwalker Operation Manager Message Guide.
Cautions
Only a normal file can be compressed by using this command. A link file such as symbolic link (file) cannot be compressed.
If you compress files using this command with the /w parameter (in the format for Windows platform) and expand them on Windows, they will be extracted as follow:
If write permission for the files is not assigned on the compression source, the files are marked with the Read Only attribute on Windows.
If write permission for the files is set for any of owner, group, or other on the compression source, the files are marked with the Read/Write attribute on Windows.
If you expand the compressed files in the format for UNIX platform or Windows platform on UNIX by using this command, the feature of files after extraction is as follow:
Format of compressed file | Feature of file extracted on UNIX (command executed as a superuser) | Feature of file extracted on UNIX (command executed as a general user) |
|---|---|---|
Format for UNIX platform |
|
|
Format for Windows platform |
| |
When the files are readable by everyone, it indicates the permission for the file displayed as "-r--r--r--" by using the ls -l command.
When the files are readable/writable by everyone, it indicates the permission for the file displayed as "-rw-rw-rw-" by using the ls -l command.
You need the read permissions for the files you want to compress. However, the superuser can do it without the read permission.
If this command is canceled, it is carried out at the point when one file has been completely compressed or expanded. Therefore, the command takes a longer time to quit if cancellation is performed while a large file is being compressed/expanded.
When using a wildcard for the file name specified with the /s parameter, the following considerations are needed:
The number of files to be processed at a time should be 500 or less, including the files to be processed simultaneously by other Server Task Link commands.
A temporary file is created in the following location on the server when executing this command.
/tmp(, /var/tmp for Solaris)
Note that the compression/expansion fails if there is not enough disk space in the /tmp. The amount of space necessary for the temporary file is determined by adding the files sizes (before compressing or after expanding) together.
The size per file should be 2GB or less.