Checking a Job's Status

Use this procedure to check whether a job has completed normally or has encountered a problem or delay. You check the status through the Job Scheduler forms: Active Jobs (UNJS.1), Completed Jobs (UNJS.2), and Waiting Jobs (UNJS.3).

To check a job's status

  1. Access the Job Scheduler.
    • After submitting a job from a parameter form, click the Job Sched button on the parameter form. (If you want to check previously submitted jobs, you can access the Job Scheduler forms by inquiring on any job definition and then clicking the Job Sched button. That is, you do not need to resubmit a job in order to access the Job Scheduler forms.)

      The Active Jobs form appears.

    - or -

    • On UNIX and Windows, from the command line, type

      lapm gen unjs

      The Active Jobs form appears.

  2. If your job does not appear on the Active Jobs form, click the Completed button. The Completed Jobs form appears, with a list of your completed jobs. If a job has a status of Normal Completion, you can view the print files for the job.
    Status Meaning
    Canceled A job that was deleted from the Active Jobs form, or a job that was deleted from the Waiting Jobs form with a status of Hold, Waiting, Waiting On Time, Waiting Recovery, Invalid Params, or Queue Inactive.
    Normal Completion A job that executed normally.
    Recovery Deleted A job that was deleted from the Waiting Jobs form with a status of Needs Recovery.
    Recurring Job Skipped A recurring job that was too late to run.
  3. If your job does not appear on the Active Jobs or Completed Jobs form, click the Waiting button. The Waiting Jobs form appears, with a list of jobs that have not been able to finish processing.
    Status Meaning
    Hold A recurring job whose run was bypassed by the job processing cycle, or a job that was put on hold by a user.
    Invalid Params An invalid value was typed for a batch parameter. Before you can resubmit this job, you must either manually delete the job from the Waiting Jobs form, then redefine the job using valid values; or redefine the job using valid values, and then change the job status to Waiting.
    Needs Recovery The job failed during execution. You must fix the problem causing the program to stop before you can recover the job.
    Queue Inactive The assigned job queue has a queue status of Inactive and cannot run jobs.
    Waiting The assigned job queue is temporarily full.
    Waiting On Time The job's assigned start time has not yet arrived.
    Waiting Recovery The job calls the same program as a previously submitted job that needs recovery.
    Waiting Step

    The step calls a non-concurrent program that is already running and must wait until that program has executed. Non-concurrent programs preserve report integrity by preventing two identical programs in the same data area from executing at the same time. For instructions on defining concurrent and non-concurrent programs, see Doc for Developers: Application Development Workbench (UNIX and Windows) or Application Development Workbench Standards (IBM i).

    Note: If two steps call the same program, but under different data areas or data IDs, the system does not recognize them as being identical and executes them at the same time as if they were different programs.