Description
Associates or disassociates the software settings definition with the parameter settings definition, or the software collection definition with the parameter collection definition, and displays them in list form.
Synopsis
[Windows]
swcfmg_param_defassoc.exe { -attach -softid <Software ID> -sdefid <Parameter settings definition ID> | -attach -softid <Software ID> -cdefid <Parameter collection definition ID> | -detach -softid <Software ID> -sdefid <Parameter settings definition ID> | -detach -softid < Software ID > -cdefid <Parameter collection definition ID> | -list [-sdef] [-cdef] [-file <Output file path>] [-e <Input file character encoding>] } |
[Linux]
swcfmg_param_defassoc { -attach -softid <Software ID> -sdefid <Parameter settings definition ID> | -attach -softid <Software ID> -cdefid <Parameter collection definition ID> | -detach -softid <Software ID> -sdefid <Parameter settings definition ID> | -detach -softid < Software ID > -cdefid <Parameter collection definition ID> | -list [-sdef] [-cdef] [-file <Output file path>] [-e <Input file character encoding>] } |
Options
Associates the software that has the specified ID and the parameter settings definition that has the specified ID. Note that multiple parameter settings definitions can be associated with a single software product. A parameter definition method compatible with the OS type of the software must be specified.
Associates the software that has the specified ID and the parameter collection definition that has the specified ID. Note that a single parameter collection definition can be associated with multiple software products. A parameter definition method compatible with the OS type of the software must be specified.
Removes the association between the software that has the specified ID and the parameter settings definition that has the specified ID
Removes the association between the software that has the specified ID and the parameter collection definition that has the specified ID
Outputs a list of associations in CSV format
-sdef Outputs a list of only those associations between the software and parameter settings definitions
-cdef Outputs a list of only those associations between the software and parameter collection definitions
If the specified file does not exist, a new file will be created. If the file exists, the existing file will be overwritten.
If output to the file fails due to an error, no new file will be created. If an existing file was to be overwritten, it will be kept as is without being overwritten.
Output format for standard output
Outputs the list of associations in the following format:
Item No. | Item | Remarks |
|---|---|---|
1 | Software ID | Outputs the software ID. |
2 | Definition ID | Outputs the parameter settings ID or the parameter collection ID. |
3 | Software name | Outputs the software product name. |
4 | Version | Outputs the software version. |
5 | OS type | Outputs the software OS. |
6 | Definition name | Outputs the parameter settings definition name or the parameter collection definition name. |
Header format
Insert the header in the first line of the CSV file using the format shown below. The header is output even if there is no information to be output to the file.
#Software ID,Definition ID,Software name,Version,Vendor,Definition name |
Specify the character encoding for the file.
The character encodings below can be specified (single-byte uppercase characters must be used):
UTF-8
If this option is omitted, the character encoding of the execution environment of this command will be used.
Return value
Return value | Meaning |
|---|---|
0 | Completed normally. |
10 | A parameter error has occurred. |
20 | The specified I/O path is incorrect. |
30 | The specified character encoding is incorrect. |
70 | The specified ID does not exist. |
71 | The software and parameter definition are already associated. |
100 | Systemwalker Software Configuration Manager is not running. |
101 | A command that cannot be executed at the same time as this command is executing. |
102 | You do not have the privileges required to execute this command. |
110 | A write error has occurred. |
200 | Setup has not been performed. |
255 | A system error has occurred. |
Command location
Admin server
[Windows]
<Systemwalker Software Configuration Manager installation directory>\SWCFMGM\bin |
[Linux]
/opt/FJSVcfmgm/bin |
Privilege required/execution environment
[Windows]
Administrator privileges are required. If using Windows Server 2008 or later as your operating system, execute this command as an administrator.
This command can be executed on the admin server.
[Linux]
This command can only be executed by the system administrator (superuser).
This command can be executed on the admin server.
Notes
This command cannot be executed simultaneously with other commands. An exclusive control error will occur if a command is executed while another command is still executing.
Execute this command while Systemwalker Software Configuration Manager is running.
If multiple parameter collection definitions are associated with a single software product, you cannot specify a duplicate key for the parameter list.
When the software type is Solaris, that software cannot be associated with the parameter definitions.
Use this command to remove associations that no longer need to be managed by Systemwalker Software Configuration Manager.
If no predefined parameters have been registered, only the header information will be output.
#Software ID,Definition ID,Software name,Version,Vendor,Definition name |
Examples
Associate
[Windows]
swcfmg_param_defassoc.exe -attach -softid UDP00001 -sdefid SS00000001 |
[Linux]
swcfmg_param_defassoc -attach -softid UDP00001 -sdefid SS00000001 |
Disassociate
[Windows]
swcfmg_param_defassoc.exe -detach -softid UDP00001 -sdefid SS00000001 |
[Linux]
swcfmg_param_defassoc -detach -softid UDP00001 -sdefid SS00000001 |
List
[Windows]
swcfmg_param_defassoc.exe -list |
[Linux]
swcfmg_param_defassoc -list |
