rmpmtask command
Use the rmpmtask command to delete a process-monitor task.
Synopsis
smcli [-c] [-prompt]
[-user user_name] [-pw password]
rmpmtask options
smcli rmpmtask [-h | -? | --help]
smcli rmpmtask [-v] {-f file_name | [-T] task_list}
Description
NoneOperands
This command uses a list of process-monitor tasks as an operand. The list can optionally be preceded by the -T | --tasks option.
Options
- -f | --file {file_name | -}
- Retrieves data either from the input file file_name or
from input piped from another command.
To retrieve input piped from another command, specify a hyphen (-) instead of a file name (for example, smcli cmd1 | smcli cmd2 -f -). To retrieve input from a file, specify the full path. If the path contains spaces, enclose it in quotation marks.
- The input data is the list of process-monitor tasks to be deleted, separated by a comma or line break.
- -h | -?
- Displays the syntax and a brief description of the command. Tip: If you specify additional options other than -h | -? | --help, the options are ignored.
- --help
- Displays detailed information about the command, including the
syntax, a description of the command, a description of the options
and operands, error codes, and examples. Tips:
- If you specify additional options other than -h | -? | --help, the options are ignored.
- You can also display detailed help in the form of man pages using the man command_name command.
- -T | --tasks {task_oid | task_id_string | task_title}[,{task_oid | task_id_string | task_title}...]
- Removes one or more process-monitor tasks, specified by title,
unique ID or ID string. The list can be a mixture of titles, IDs and
ID strings, separated by a comma. The list is delimited by the end-of-line
character when read from a file.
- task_oid
- The unique ID of the task, specified as a hexadecimal value prefixed
with 0x (for example, 0x37).Tip: You can use the lstask -o -r command to list all task IDs that are valid for the targeted system.
- task_id_string
- The unique ID string of the task, prefixed with a percent sign
(%) (for example, %ServerCfgTask). If the string
ID contains a comma, prefix the comma with a backslash (\).Tip: You can use the lstask -I command to list all task ID strings that are valid for the targeted system.
- task_title
- The title of the task. The task title must be fully qualified
with the parent task (for example, grandparent_task_title/parent_task_title/task_title).
If the task name contains a comma, prefix the comma with a backslash
(\). Enclose the task title in quotation marks if it contains a space
character. Tips:
- Task names might not be unique. This command acts on all tasks with the specified name. Use the -v | --verbose option to generate a message when this command targets multiple tasks with the same name. To target a task that has a name that is not unique, identify the task by specifying its unique, hexadecimal task ID, or use additional target options to refine the selection.
- Locale-specific task names might not exist for every noninteractive task. The name specified must match the locale being used by the command line interface.
- Use the lstask -r command to list all tasks that are valid for the targeted system.
- -v | --verbose
- Writes verbose messages to standard output.
If this option is not specified, this command suppresses noncritical messages.
Exit status
The following codes are returned by this command.- 0: The operation completed.
- 1: A usage error occurred.
- 2: The command or bundle was not found.
- 3: The command was not performed because either authentication failed or you are not authorized to perform the action.
- 10: The file was not found.
- 22: A specified task is not valid.
- 25: A number-formatting error occurred.
- 29: The specified locale is not valid or not supported.
Examples
- Remove a process-monitor taskThis example illustrates how to remove a process-monitor task named Notepad monitor from all systems to which it has been applied.
smcli rmpmtask -T "Notepad monitor"