Skip to main content

$ZJOB (ObjectScript)

Contains job status information.

Synopsis

$ZJOB
$ZJ

Description

$ZJOB contains a number in which each bit represents one particular aspect of the job’s status. $ZJOB returns an integer that consists of the total of the set status bits. For example, if $ZJOB = 5, this means that the 1 bit and the 4 bit are set.

To test individual $ZJOB bit settings, you can use the integer divide (\) and modulo (#) operators. For example, $ZJOB\x#2, where x is the bit number. The following table shows the layout of the bits (by bit positional value), their settings and meanings:

Bit Set to Meaning
1 1 Job started from the Terminal prompt.
0 Job started from a routine.
2 1 Job started by the JOB command.
0 Job started by signing on either at the Terminal prompt or from a routine.
4 1 <INTERRUPT> enabled. A CTRL-C can interrupt a running program. Refer to BREAK flag for details.
0 <INTERRUPT> disabled except for terminal lines for which <INTERRUPT> has been explicitly enabled by OPEN or USE commands.
8 1 <INTERRUPT> received and pending.
0 <INTERRUPT> not received. The value 8 is cleared by the OPEN and USE commands and by an error trap caused by a CTRL-C.
1024 1 Journaling is disabled regardless of other conditions.
0 Journaling is enabled for this job if other conditions indicate journaling.

This special variable cannot be modified using the SET command. Attempting to do so results in a <SYNTAX> error.

Examples

The following example returns $ZJOB as an integer:

  WRITE $ZJOB

The following example returns each $ZJOB bit value:

  WRITE "   bit 1=",$ZJOB\1#2,!
  WRITE "   bit 2=",$ZJOB\2#2,!
  WRITE "   bit 4=",$ZJOB\4#2,!
  WRITE "   bit 8=",$ZJOB\8#2,!
  WRITE "bit 1024=",$ZJOB\1024#2

Bit 1 can also be returned using $ZJOB#2.

See Also

  • JOB command

  • $JOB special variable

FeedbackOpens in a new tab