Skip to main content

job show-bynode

Contributors
Suggest changes

Display a list of jobs by node

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The job show-bynode command displays information about jobs on a per-node basis. The command output depends on the parameters specified with the command. If no parameters are specified, the command displays information about all jobs in the cluster that are currently owned by a node.

To display detailed information about a specific job, run the command with the -id parameter. The detailed view includes all of the default information plus additional items.

You can specify additional parameters to display only information that matches the values you specify for those parameters. For example, to display information only about jobs running on a specific node, run the command with the -node parameter.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-node {<nodename>|local}] - Node

Use this parameter to display information only about the jobs that are associated with the node you specify.

[-id <integer>] - Job ID

Use this parameter to display information only about the jobs that match the ID or range of IDs you specify.

[-vserver <vserver name>] - Owning Vserver

Use this parameter with the name of a Vserver to display only jobs that are owned by that Vserver.

[-name <text>] - Name

Use this parameter to display information only about the jobs that match the job name you specify.

[-description <text>] - Description

Use this parameter to display information only about the jobs that match the description you specify.

[-affinity {Cluster|Node}] - Affinity

Use this parameter with an affinity value to display only jobs that match the affinity you specify.

[-username <text>] - User Name

Use this parameter with a username to display only jobs that are associated with that user.

Examples

The following example displays information about all jobs on a per-node basis:

node::> job show-bynode
                                      Owning
Node           Job ID Name            Vserver    Affinity
-------------- ------ --------------- ---------- --------
node0          1501   log-rotation    node-vserver
                                                 Cluster
               Descr:logrotation job
node1          1498   log-rotation    node-vserver
                                                 Cluster
               Descr:logrotation job
node2          1499   log-rotation    node-vserver
                                                 Cluster
               Descr:logrotation job
node3          1500   log-rotation    node-vserver
                                                 Cluster
               Descr:logrotation job