gpr_set_acq_time_out(A) — Apollo Domain/OS SR10.4

GPR_$SET_ACQ_TIME_OUT             GPR Calls              GPR_$SET_ACQ_TIME_OUT


NAME
     gpr_$set_acq_time_out - establishes the length of time the display will
     be acquired.

FORMAT
     gpr_$set_acq_time_out (timeout, status)

DESCRIPTION
     This routine establishes the length of time the display will be acquired.

     If the program has not released the display when the time-out expires and
     another process (for example, the Display Manager) needs the display, an
     acquire time-out fault (smd_$acquire_timeout) is generated in the user
     process.  The acquire time-out fault is a warning fault that the program
     can intercept with a cleanup handler or static fault handler.  If the
     program does not release the display within a few seconds of the acquire
     timeout fault, a second fault occurs (with the status code fault_$quit)
     and the program loses control of the display.

     If this routine is not called, the default time-out value is one minute.

   Input Parameters
     timeout
          The maximum real time, in time_$clock_t format, for which the pro-
          gram can acquire the display.

   Output Parameters
     status
          Completion status, in status_$t format.
Museum
