cmx_trans_param (Deploy an abstract parameter)

Format

cmx_trans_param -i input-file -p specification-of-the-abstract-parameter -o output-file

Function

This command deploys the specified abstract parameter for the specified Easy Setup definition file or the configuration change definition file (for changing logical server parameters) and generates a physical tier configuration appropriate for the Web system.

Reference note
When building a Web system initially, you use the Easy Setup definition file and when changing the configuration of a built Web system (changing the logical server parameters), you use the configuration change definition file.
Note that the configuration change definition file includes the file for changing logical server parameters and the file for adding service units or hosts. The cmx_trans_param command is used for building a Web system initially and for changing the settings of the entire Web system; and therefore, you cannot specify the configuration change definition file for adding service units or hosts.

Arguments

-i input-file
Specifies the Easy Setup definition file or the configuration change definition file (for changing logical server parameters).
-p specification-of-the-abstract-parameter
In specification-of-the-abstract-parameter, this option specifies abstract parameters and the value in the format "abstract-parameter = value".
Specify the maximum number of concurrently processed requests in abstract parameters. The parameter name of the maximum number of concurrently processed requests is UnitMaxParallelCount, so in specification-of-the-abstract-parameter, you specify "UnitMaxParallelCount = Value".
For details on abstract parameters, see Appendix I Abstract parameters available with the Smart Composer functionality.
-o output-file
Specifies the output file used after abstract parameters are deployed.

Input examples

cmx_trans_param -i MyWebSystemDef.xml -p UnitMaxParallelCount=10 -o outMyWebSystemDef.xml

Return values

0:
The command is terminated normally.
1:
The command is terminated with a warning.
64:
The command is terminated abnormally.

Notes

If the physical tier specified in input-file is not combined-tier, an error occurs.