cmx_trans_param (Deploy an abstract parameter)
- Organization of this page
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.
This command can be used in V9 compatibility mode only. The parameter that must be specified in the Easy Setup definition file is as follows:
-
Web server
Parameter name: manager.web.send_request_method
Parameter value: redirector
-
J2EE server
Parameter name: manager.j2ee.compat
Parameter value: V9
- 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 about abstract parameters, see Appendix I. Abstract parameters available with the Smart Composer Functionality (in V9 compatibility mode).
- -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.