jpcasrec output
- Organization of this page
Format
jpcasrec output [-mx maximum-heap-size] [-ms initial-heap-size] -o output-file service-ID
Function
The jpcasrec output command outputs the definition regarding the recording method of the Store database in XML format. You can specify the obtained output file as an input file for the jpcasrec update command.
Hosts that can execute the command
PFM - Web Console
Execution permission
- In Windows:
-
User with Administrators permissions
- In UNIX:
-
User with root user permissions
To execute this command, a key file for authentication needs to be created in advance for a user account with administrator user permissions# for Performance Management. For details, see the jpcmkkey command.
- #
-
Execution permissions for Performance Management that are required for a Performance Management user or JP1 user.
Installation directory
- In Windows:
-
installation-folder\tools\
- In UNIX:
-
/opt/jp1pcwebcon/tools/
Arguments
-mx maximum-heap-size
Specifies the maximum heap size for java.exe (in megabytes). The default is 128 MB. The maximum size that can actually be acquired depends on the system. If the specified value does not satisfy the following conditions, an invalid command line format results:
-
Integer in the range 1 to 2,048
-
Value specified in -mx >= value specified in -ms
-ms initial-heap-size
Specifies the initial heap size for java.exe (in megabytes). The default is 32 MB. If the specified value does not satisfy the following conditions, an invalid command line format results:
-
Integer in the range 1 to 2,048
-
Value specified in -mx >= value specified in -ms
-o output-file
Specifies the name of an XML-format file to which the execution results are to be output. This can be an absolute file path name, relative file path name, or file name. If the specified file name is not the absolute file path name, the command assumes the current directory as the reference directory (if the specified directory does not exist, an error results).
service-ID
Specifies the service ID of the target agent. Wildcard characters cannot be used. Conditions for the specified value are as follows:
-
4 to 258 characters
-
The first character specifies the product ID of the agent (for details about product IDs, see the PFM - Agent or PFM - RM manuals).
-
The second character specifies A (Agent Collector or Remote Monitor Collector).
Notes
-
The command requires authentication for PFM - Manager during execution. If a key file for authentication has not been created prior to command execution, use the jpcmkkey command to create the key file for authentication. For the permitted range of service IDs and record IDs, see the PFM - Agent or PFM - RM manuals.
-
Definition information that cannot be updated is output as comments in the output file.
-
Normally, you do not need to set the -mx or -ms option. If the KAVJK0401-E message, which reports insufficient memory, is output during command execution, re-execute the command with the -mx option to increase the maximum heap size. At this time, make sure that you specify 64 or a greater value for the -mx option.
Return values
0 |
The command ended normally. |
1 |
The command line format is invalid. |
2 |
The user does not have execution permission for the command. |
3 |
Creation of the output file failed. |
5 |
The parameters cannot be analyzed because they do not match the DTD file. |
10 |
Updating of at least one Store database definition failed. |
11 |
Authentication processing for login to PFM - Manager failed. Alternatively, the user specified at authentication does not have execution permission. |
100 |
The environment is invalid. |
200 |
A memory error occurred. |
202 |
A file access error occurred. |
222 |
A communication processing error occurred. |
255 |
An unexpected error occurred. |
Usage example
This example outputs to a parameter file (asrec_output.xml) definition information for the Store database recording method for the PFM - Agent whose service ID is TA1host1:
jpcasrec output -o asrec_output.xml TA1host1
Output example
This example outputs the details of the command's processing to the standard output, standard error output, and trace log file. For details about the log specifications, see Chapter 4. Log Information Output by Performance Management.
An example of the standard output is shown below. It displays the execution results (OK or ERR) for the service ID specified in the argument.
Example of standard output
jpcasrec output connected to hostname at yyyy MM dd HH:MM:SS.mmm output result OK : TA1host1 jpcasrec output disconnected at yyyy MM dd HH:MM:SS.mmm
Output file
An example of a file output by this command is shown below.
Example of output file
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE pr-cli-parameters SYSTEM "asrec_params.dtd"> <pr-cli-parameters ver="0110"> <agent-store-db-record-definition> <service id="TA1host1"> <record id="PD_CIND"> <!-- Description : Content Index Detail --> <log>Yes</log> <collection-interval>600</collection-interval> <collection-offset>0</collection-offset> <!--Over 10 Sec Collection Time : No --> <realtime-report-data-collection-mode>Temporary Log</realtime-report-data-collection-mode> <logif></logif> <and> <or> <expression>RECORD_TIME<"01:23:45"</expression> <expression>INTERVAL<"2000"</expression> </or> <expression>INSTANCE<"INST"</expression> </and> </logif> </record> <record id="PD_CINF"> <!-- Description : Content Index Filter Detail --> <log>No</log> <collection-interval>60</collection-interval> <collection-offset>0</collection-offset> <!--Over 10 Sec Collection Time : Yes --> <realtime-report-data-collection-mode>Temporary Log</realtime-report-data-collection-mode> <logif> </logif> </record> <record id="PD_DEV"> <!-- Description : Devices Detail --> <log>Yes</log> <collection-interval>480</collection-interval> <collection-offset>60</collection-offset> <!--Over 10 Sec Collection Time : No --> <realtime-report-data-collection-mode>Temporary Log</realtime-report-data-collection-mode> <logif> </logif> </record> : : : </service> </agent-store-db-record-definition> </pr-cli-parameters>