jpccfgbackup
- Organization of this page
Format
jpccfgbackup backup-destination-directory
Function
The jpccfgbackup command creates a backup file for the Performance Management program definition information on the local host.
To execute this command on UNIX, the environment must allow the use of the Korn shell (ksh). For details about the applicable package, see the Release Notes for PFM - Manager and PFM - Base.
Hosts that can execute the command
-
PFM - Manager
-
PFM - Agent
-
PFM - RM
Execution permission
- In Windows:
-
-
User with Administrators permissions
-
User with Backup Operators permissions
-
- In UNIX:
-
User with root user permissions
Installation directory
- In Windows:
-
installation-folder\tools\
- In UNIX:
-
/opt/jp1pc/tools/
Arguments
backup-destination-directory
Specifies the name of the directory that will contain backup files for the definition information. For backup-destination-directory, specify a string of 1 to 35 bytes, consisting of single-byte alphanumeric characters and symbols. You cannot specify a relative path. Always specify an absolute path. Note that you cannot use the following symbols in the path specification:
; , * ? ' " < > | & ^ `
If the directory name that you want to specify contains spaces, enclose the entire name in double quotation marks ("). If you specify any of the following symbols, enclose it in double quotation marks (") in order to prevent it from being analyzed by the shell or the command prompt:
( )
Make sure that you specify a directory that is not the installation directory for Performance Management.
Also make sure that you specify an empty directory that contains no files or directories.
Return values
0 |
The command terminated normally. |
1 |
An argument specification is invalid. |
2 |
The user does not have execution permission for the command. |
100 |
The Performance Management environment is invalid. |
105 |
Current directory is not the directory that contains the jpccfgbackup command. |
210 |
A disk space shortage occurred. |
230 |
Execution of an internal command failed. |
235 |
An attempt to back up one or more files failed. |
255 |
An unexpected error occurred. |
Usage example
This example backs up definition information to the /tmp/pfmbackup directory.
jpccfgbackup /tmp/pfmbackup
Notes
-
Before you execute the jpccfgbackup command in UNIX, change the current directory to the directory that contains that command.
-
Do not execute two or more instances of the jpccfgbackup command concurrently.
-
Before you back up definition information, make sure that there is sufficient free disk space. To determine a sufficient amount of free disk space, make a guess from the disk space requirements for installing the product.
-
If an error occurs during backup processing, only files that were successfully backed up remain in the backup destination directory.
-
If the command fails to copy a file, the command does not terminate, and attempts to copy the next file. If a file copy error occurs more than once, the information about the last error will be reported as the return value.