Previous Topic: Update a CI PropertyNext Topic: Integrating with CA Service Desk

Customization and Maintenance › Update Relationship Significance

Update Relationship Significance

As an administrator, you use the WSSamRelationshipCmd.bat utility to update the significance value of a relationship. The utility updates the significance value by the property name.

Follow these steps:

  1. Open a command prompt, and navigate to SOI_HOME\tomcat\bin.
  2. Run the following command: 
    WSSamRelationshipCmd.bat -hsamanagerhost:port -uadminuser -ppassword -aUpdate -sServiceID -lLeftNodeID ‑iRightNodeID -npropertyName -vpropertyValue

    Note: Note the lack of spaces between the parameters and values.

    -hsamanagerhost:port

    Defines the host name and Tomcat port number of the SA Manager from which you want to update relationship significance. The default Tomcat port is 7090.

    -uadminuser

    Defines the user name of the CA SOI administrator user ("samuser" user by default).

    -ppassword

    Defines the password of the CA SOI administrator user. Run WSSamEncryptCmd.bat from the same directory to generate an encrypted version of the password for use in this parameter.

    -aUpdate

    Defines to update the significance of a relationship. Currently this operation is the only option.

    -sServiceID

    Defines the instanceID of the service in which the relationship to update exists. Find the instanceID property for any service in the Service Modeler.

    -lLeftNodeID

    Defines the instanceID of the source node of the relationship.

    -iRightNodeID

    Defines the instanceID of the target node of the relationship.

    -npropertyName

    Defines the property name to update. Currently, the only valid value is sam_significance, which updates the significance value for a relationship.

    -vpropertyValue

    Defines the new value for the specified property. Enter a numeric in the range of 1 through 10 to specify a valid significance value.

    The command runs. A return code of 1 indicates that the command failed. The update progress displays in the command prompt. After the update completes, a success message displays with a return code of 0.

Example: Update a server and application relationship significance

The following example command updates the significance of the relationship between the SA_Server:server1 CI and the SA_Application:payroll application:

WSSamRelationshipCmd.bat -hSAServer:7090 -usamuser -psamuserpw -aUpdate ‑sSA_Service:Payroll -lSA_Server:server1 -rSA_Application:payroll -nsam_significance -v8