soamunreg
The command to unregister an application and delete the application profile, preventing more sessions from being started for this application.
Synopsis
soamunreg
application_name [-f] [-s] [-u user_name]
[-x password]
soamunreg
-h
soamunreg
-V
Description
Use soamunreg to unregister an application.
Unregistering an application does the following tasks:
- Terminates existing sessions and tasks (running and suspended)
- Disables the application
- Releases all application
- Removes the application profile from the system
After unregistering the application, remove the application files in $EGO_CONFDIR/../../soam/profiles directory on Linux®, %EGO_CONFDIR%\..\..\soam\profiles directory on Windows.
You can optionally save historic data associated with the application
- -h
- Prints command usage to stdout and exits.
- -V
- Prints product version to stdout and exits.
Options
- application_name
- Specifies the name of the application. The application name is the same as it appears in the application profile. Enclose the application name in double quotation marks (" ") if it contains spaces. Precede the application name with two dashes (--) if it starts with a dash.
You can view the application name using soamview app.
- -f
- Forces the action, bypassing prompts to unregister an enabled application with running workload and to save the historical data. This option assumes you want to unregister the application immediately.
- -s
- Saves the application historical data.
- -u user _name
- Specifies the name of the user to connect to IBM® Spectrum Symphony for this command. If you are already logged on to IBM Spectrum Symphony using soamlogon, for this command only the user name specified here overrides the user name entered in soamlogon.
- -x password
- Specifies the user password to connect to IBM Spectrum Symphony for this command. If you are already logged on to IBM Spectrum Symphony using soamlogon, for this command only the password specified here overrides the password entered in soamlogon.
Unregister an application
Unregister an application, sampleApp:
soamunreg sampleApp