Previous Topic: $SRV_IMOD_LISTNext Topic: $SRV_MVS_DATA


$SRV_JOB_INFO

The $SRV_JOB_INFO routine searches active system routines to find one or more jobs that meet the specified name criteria. Information on the matched jobs is returned on the stack.

Syntax

CALL $SRV_JOB_INFO {jobname|*}

Parameters

jobname

Name of a job (JOB), started task (STC), or time-sharing user (TSU).

*

All jobs, started tasks, and time-sharing users are selected.

Returned Data

Data is returned on the stack, one address space per record. The first character in each record is the delimiter character. This character is used to separate the returned fields:

  1. The ASID number, returned as a decimal number.
  2. ASCB address, returned as a decimal number.
  3. Jobname.
  4. JOB, STC, or TSU.
  5. Task ID, for started task only.
  6. The Current STEP name.

Return String

This routine returns the number of lines of data that it added to the stack. A returned value of 0 can be interpreted as "job not found".