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

None

Operands

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

  1. Remove a process-monitor task
    This 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"