CA-GSS Statements and Commands › Service Routines › $SRV_JOB_INFO

Previous Topic: $SRV_IMOD_LIST

Next 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

Use this syntax:

CALL $SRV_JOB_INFO {jobname|*}

Parameters

The $SRV_JOB_INFO service routine takes these parameters:

jobname

The 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, as listed below:

  1. 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. 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 may be interpreted as "job not found".