jobs - Display status of jobs in current session

Synopsis

jobs [ -ln ] [ job ... ]

Description

You can use jobs to display information about active jobs started by qsh. For each job, qsh displays:

  • Job number in brackets ([ ]).
  • Status (Running, Done, Terminated, and so on).
  • Return value of the job in parenthesis () when the return value is greater than zero and the job status is Done.
  • Command line for the job.

Options

-l
Display status for each process in the specified job.
-n
Display status only for those jobs whose status has changed but has not been reported yet.

Operands

Each job specifies an active job. The job can be specified as a:

  • Number to refer to a process id.
  • %number to refer to a job number.
  • %string to refer to a job whose name begins with string.

    If job is not specified, qsh displays status for all active jobs.

Exit status

  • 0 when successful.
  • >0 when unsuccessful.

Examples

  1. Display status for job number 1: jobs %1
  2. Display status for process id 16107: jobs 16107
  3. Display status for a job running the ls utility: jobs %ls
  4. Display status for all active jobs: jobs