chai - Change application instance attributes
Change specific attributes of application instance (AI) objects in the TSLM database.
Syntax
chai [application_instance_name -app application_name [...] | -disable | -enable |
-am method | -ad data | -admin | -noadm | -pc | -nopc | prio num |
-desc description] Parameters
- application_instance_name
- Specifies the application instance name for which attributes should be changed.
- -app application_name [...]
- Specifies the application of the application instance for which attributes should be changed. Multiple names must be separated with a blank character between each name.
- -disable
- Disables the application instance. Mount requests block for blocking mounts and fail for immediate mounts.
- -enable
- Enables the application instance. If there are suspended mounts for the application instance these can be rescheduled using the reschedule command.
- -am method
- Specifies the AuthenticationMethod the application instance uses to authenticate itself to the TSLM server. Possible values are "none", "password", and "pwenc".
- -ad data
- Specifies the AuthenticationData the application instance uses to authenticate itself to the TSLM server. In case an instance uses the "password" method this attribute should contain the password in clear text. If an instance uses the "pwenc" method this attribute should contain the encrypted password (which can be generated or obtained with the ermmpwgen utility).
- -admin
- Grants administrative privilege. Warning: Using admin access for an AI responsible to a non-ERMMSystem application could cause several critical impacts.
- -noadm
- Revokes administrative privilege.
- -pc
- Enables PrivilegeChangeable attribute. The application instance is able to change its PrivilegeLevel after successful execution of the command.
- -nopc
- Disables PrivilegeChangeable attribute. The application instance will not be able to change its PrivilegeLevel after successful execution of the command.
- -prio num
- Sets the DefaultPriority attribute. This attribute specifies the initial priority that is assigned to a task sent by this application instance.
- -desc description
- Change the description for the application instance.
Results
Beyond the general error code, the following command-specific error codes are returned:
- EMM1401E – in case the application instances (s) specified by name or match option could not be found
- EMM7124E – in case an invalid value has be specified
User notes
Names of application instances must be unique for every application. That means that there might be more application instances with the same name but with different application name attributes. To prevent attribute changes of more than one instance, the -app option should be specified.
Examples
chai TSM@arthur.mytivoli.globeco.com -am none -adm -prio 100