B.7 cfmg_changesoftwareid

Name

[Windows Manager]
Installation_folder\RCXCFMG\bin\cfmg_changesoftwareid.bat - Batch conversion of software IDs

[Linux Manager]
/opt/FJSVcfmg/bin/cfmg_changesoftwareid - Batch conversion of software IDs

Format

cfmg_changesoftwareid [-f] [-prefix prefix_to_convert] [-utf8]

Description

Converts the software IDs of the registered software information into the IDs with the prefix configured during "Appendix A Settings for Software ID Prefixes".

Before executing the command, it is necessary to set an appropriate prefix according to the description in "Appendix A Settings for Software ID Prefixes".

The conversion results are output in XML format to the standard output.

Table B.1 Output Format
<?xml version='1.0' encoding='UTF-8'?> <ids> <id> <Type>[ID Type]</Type> <before>[Original ID]</before> <after>[Modified ID]</after> </id> ... <ids>

Element Name	Description
ids	Outputs an id element for each converted ID.
id	Displays the conversion result for a single ID.
type	Displays the type of the converted ID. The output result of this command outputs "SOFTWARE", which indicates that the software ID has been converted.
before	Outputs the ID before conversion.
after	Outputs the ID after conversion.

If none of the IDs have been converted, the following is output:

<?xml version='1.0' encoding='UTF-8'?>
<ids />

Options

-f

Converts software IDs without requesting confirmation.
When this option is omitted, the following message requesting confirmation of conversion is displayed.
To perform the process, enter "Y" or "y".

Are you sure to change all software IDs? (Y/N)

-prefix prefix_to_convert: Specify the prefix used in the software IDs to convert.
When the software IDs to be converted contain "SW" which is the default prefix, this option can be omitted.

-utf8: Output using UTF-8.
This option is only valid when using a Windows manager.
When this option is omitted on a Windows manager, Shift_JIS (Windows-31J) is used when outputting the result.
For Linux managers, UTF-8 is always used whether or not this option is specified.

Examples

Setting the "SA" Prefix and Converting Existing IDs with "SW"

vsys_config.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
...
<entry key="software-id-prefix">SA</entry>
...
</properties>

Execution Example

> cfmg_changesoftwareid.bat <RETURN>
Are you sure to change all software IDs? (Y/N) y
<?xml version='1.0' encoding='Windows-31J'?>
<ids>
<id>
<type> SOFTWARE</type>
<before>SW00000001</before>
<after>SA00000001</after>
</id>
...
<id>
<type> SOFTWARE</type>
<before>SW00000026</before>
<after>SA00000026</after>
</id>
...
<ids>

Point

When the prefix of the software ID to be converted is "SW", the -prefix option can be omitted.
Software IDs with the registered prefix "SW" are converted into software IDs with the prefix "SA" specified during "Appendix A Settings for Software ID Prefixes".

Setting the "SB" Prefix and Converting Existing IDs with "SA"

vsys_config.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd">
<properties>
...
<entry key="software-id-prefix">SB</entry>
...
</properties>

Execution Example

> cfmg_changesoftwareid.bat -prefix SA <RETURN>
Are you sure to change all software IDs? (Y/N) y
<?xml version='1.0' encoding='Windows-31J'?>
<ids>
<id>
<type> SOFTWARE</type>
<before>SA00000001</before>
<after>SB00000001</after>
</id>
...
<id>
<type> SOFTWARE</type>
<before>SA00000026</before>
<after>SB00000026</after>
</id>
...
<ids>

Point

As the prefix of the software ID to be converted is "SA", it is necessary to specify using the -prefix option.
Software IDs with the registered prefix "SA" are converted into software IDs with the prefix "SB" specified during "Appendix A Settings for Software ID Prefixes".
Software IDs with prefixes other than "SA" are not converted.