rmjob command

If more than one job has the same name, all jobs with that name are deleted.

Description

None.

Operands

This command uses a list of jobs as an operand. The list can optionally be preceded by the -j | --jobs 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 jobs to be deleted. This list can be a mixture of job names and IDs, separated by a comma or end-of-line character.

-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.

-j | --jobs {job_oid | job_name}[,{job_oid | job_name}...]

Targets one or more jobs, specified by names or ID.

This list can be a mixture of job names and ID, separated by a comma.

job_oid

The unique job ID, specified as a hexadecimal value prefixed with 0x (for example, 0x54).

Tip: You can use the lsjob -o command to get a list of all job IDs.

job_name

The name of the job.

Tips:

• Job names might not be unique. This command acts on all jobs with the specified name. Use the -v | --verbose option to generate a message when this command targets multiple jobs with the same name. To target a job that has a name that is not unique, identify the job by specifying its unique, hexadecimal group ID, or use additional target options to refine the selection.
• The job name can be locale specific. The name specified must match the locale being used by the command line interface.
• If the job name contains a comma, prefix the comma with a backslash (\).
• You can use the lsjob command with no options to get a list of all job names.

-v | --verbose

Writes verbose messages to standard output.

If this option is not specified, this command suppresses noncritical messages.

Exit status

• 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.
• 25: A number-formatting error occurred.
• 26: An invalid job name or ID was specified.
• 29: The specified locale is not valid or not supported.
• 63: Job could not be deleted.

Examples

1. Remove a job

   This example illustrates how to remove a job named myJob.

   smcli rmjob myjob

2. Remove multiple jobs

   This example illustrates how to remove three jobs with job IDs 0x54 and 0x43 and name myJob.

   smcli rmjob -j 0x54, myjob1, 0x43