jobs

Command to initiate the Jobs mode and to use its subcommands.

Synopsis

delete -x|--id jobID
list [-l --detail] [-x|--id jobID] [-o|--owner job_ownername] [-s|--status job_status]  [-t|--type job_type] [-f|--filter search_string] [-r|--runid runID] [-S|--sort jobid|jobname|job_ownername|createDate|endDate|startDate|endDate|duration] [-A|--ascend] [-m|--matchAll] [-C|--limit integer] [-L|--nologdetails]
rerun_on_failed -x |--id jobID
run -x|--id jobID [-s|--simulate]
stop -x|--id jobID

Description

The Jobs mode is one of a set of modes provided by the Enterprise Manager Ops Center. Use Jobs subcommands to view current and historical jobs and to manage current jobs.

Type the jobs command at the command line prompt to enter Jobs mode. Type the end command to stop the mode and to return to the command line prompt.

Subcommands

list [-l|--detail] [-x|--id jobID] [-o|--owner job_ownername] [-s|--status job_status] [-t|--type job_type] [-f|--filter search_string] [-r|--runid runID] [-S|--sort jobid|jobname|job_ownername|createDate|endDate|startDate|endDate|duration] [-A|--ascend] [-m|--matchAll] [-C|--limit integer] [-L|--nologdetails]

Displays a list of all current jobs and completed jobs. Use this command to obtain the identifier of a specific job to use with other Jobs subcommands. Add the -l option to the command to display detailed information about the jobs. Add the -x option to the command to display information about a specific job. Use the other options to limit the display to those items that match the criteria and use the -A option to change the order of the results.

delete -x|--id jobID

Removes a job. The job must be completed or stopped before it can be deleted. Deleted jobs remain in the display of historical jobs.

rerun_on_failed -x|--id jobID

Runs the specified job again on failed targets. A job that has a status of PARTIALLYSUCCESSFUL has failed on at least one target.

run -x|--id jobID [-s|--simulate]

Runs the specified job. The --simulate option performs the actions of the job but does not execute it.

stop -x|--id jobID

Stops a job and cancels it. The job must be re-created to be run again.

Options

-A|--ascend

The default order of a list is in descending order. This option changes the output of the command to ascending order.

-C|--limit

Constrains the list of jobs to the specified number of jobs.

-f|--filter

Constrains the output of a subcommand to match the regular expression.

-l|--detail

Specifies that the output of the list subcommand includes additional information: creation date, end date, and each task in the job.

-L|--nologdetails

Constrains the details of a job to exclude the log of a job.

-m|--matchAll

The default search reports the all jobs that match any of the search criteria. This option limits the output of the command to jobs that match all of the criteria.

-o|--owner

Specifies that the output of the command lists jobs that match the owner of the job.

-r|--runid

Specifies that the output of the list command includes information for a specific execution of a specific job. The default operation displays information for the most recent run of the job.

-s

• With the list command, the output of the command lists jobs that match the status of the job. The option can also be invoked as --status.

• With the run command, the actions of the job are performed but not executed. THe option can also be invoked as --simulate.

-S|--sort

The default order of a list is in descending order of the job identifier. This option changes the output of the command to sort the jobs according to the specified attribute.

-t|--type

The output of the command lists jobs that match the specified type.

-x|--id

Specifies that the subcommand acts on a specific job.

Operands

createDate, endDate, startDate

Constrains the output to jobs that match the specified dates.

duration

Constrains the output to jobs that match the length of time.

jobID

The identifier of a specific job. To obtain a job identifier, use the list subcommand.

job_ownername

Constrains the output to jobs of the specified owner.

job_status

Constrains the output to jobs with the specified status.

job_type

Constrains the output to jobs with the specified type.

runID

The identifier of a specific execution of a job. The run ID is included in the details of a job.

search_string

Regular expression used to constrain the output.

Examples

Example 1   Display a detailed list of jobs

EnterpriseController/jobs > list -l -x amritsar.1
Job Id: EnterpriseCo.1   Created By: root   Type: DeleteAssetJob   Status: PARTIALLYSUCCESSFUL   Creation Date: Mon Jun 22 13:07:59 MDT 2010   End Date: Mon Jun 22 13:08:17 MDT 2010   Run Id: 1     Task Id: 1     Task Name: DeleteSvcTagsTask       Target: __satellite/com.sun.hss.domain:name="urn:st:fc619676",type=ServiceTag         Status: SUCCESS         Cause Code:         Message: Deleted service tag. (86011)           DEBUG :  Service Tag deletion started on             __satellite/com.sun.hss.domain:name="urn:st:fc61n
(output omitted)

See Also

oc(5), certificates(1), collisions(1), controllers(1), credentials(1), deploy(1), deploy-setup(1), discover(1), fwimage(1), fwprofile(1), gear(1), groups(1), incidents(1), monitoring(1), networks(1), notifications(1), osimage(1), osprofile(1), reports(1), serverpools(1), stats(1), update(1), user(1), virtualization(1).