jcoattrfcheck

Function

This command checks the contents of definition files for extended event attributes.

The definition files for extended event attributes that are in a specified directory are checked for any definition errors. Analysis results of the checking are output to standard output. Error information, such as definition errors, is output to standard error.

The command outputs the analysis results in CSV format. Each line contains the following information for one event ID:

platform,event-ID,language-type,product-name,attribute-name,display-name,type

Note

The portion ,attribute-name,display-name,type is output as many times as there are event attributes to be displayed.

When definition files for extended event attributes (extended file) are checked, the output of some of the fields is fixed. These fields are shown in the following table.

Table 1‒28: Fixed values that are output when the extended files are checked

No.	Field	What is output
1	Platform	base
2	Event ID	DEFAULT
3	Language type	When extend_attr_ja.conf is checked: japanese When extend_attr_en.conf is checked: english When extend_attr_zh.conf is checked: chinese
4	Product name	/HITACHI/DEFAULT

JP1 event attributes displayed in the Event Details window contain this command's analysis results and the information common to the basic and extended attributes.

To Page Top

Format

jcoattrfcheck extended-event-attribute-definition-directory-name

To Page Top

Execution permission

In Windows: Administrator permissions (If the Windows UAC feature is enabled, the command must be executed from the administrator console.)

In UNIX: None

To Page Top

Storage directory

In Windows:

Console-path\bin\

In UNIX:

/opt/jp1cons/bin/

To Page Top

Arguments

extended-event-attribute-definition-directory-name

Specifies the name of the directory that contains the definition files for extended event attributes that are to be checked. Express the directory name as an absolute path or a path relative to the current directory.

Files to be checked must have the extension .conf and their file type will be extended-attributes-definition.

If you want to check definition files for extended event attributes (extended files), you must create an extend subdirectory in the directory specified in the argument of the jcoattrfcheck command and place the extended files in the extend directory. The files in the extend directory are checked as the extended files.

Note that, in checking the extended files, this command reads the standard files installed in JP1/IM - Manager and the extended file located in the directory specified in the argument of the jcoattrfcheck command, and checks whether the specified extended attributes are duplicated. The path of the standard files that are read when the extended file is checked is as follows:

In Windows

Console-path\conf\console\attribute\default.conf

In UNIX

/etc/opt/jp1cons/conf/console/attribute/default.conf

To Page Top