(LOGO.JPG) Python for OpenVMS

(go to: table of contents, index, list of vms_sys, prev: WAITFR, next: WFLAND)


WAKE - Wake Process from Hibernation


Activates a process that has placed itself in a state of hibernation with the Hibernate (SYS$HIBER) service.

Format:

    targpid = vms_sys.wake ([pidadr] [,prcnam])
Returns:
targpid
Process identification of process which has been waked. The targed PID (targpid) is always returned - it is as if you have specified a '0' value for the 'pidadr' argument. If an error happens, then vms_sys.wake() raises a Python exception.
Arguments:
pidadr
Process identification of process to be activated.
prcnam
Process name of process to be activated.
Examples:
>>> import vms_sys

>>> print vms_sys.wake ()
96                      <-- PID of current process

>>> wake_pid = 532
>>> print vms_sys.wake (wake_pid)
532                     <-- PID of target process
>>> print vms_sys.wake (wake_pid,None)
532
>>> vms_sys.wake (None,'TARG_PRC')
532
>>> vms_sys.wake (0,'TARG_PRC')
532

>>> nonexist_pid = 999
>>> vms_sys.wake (nonexist_pid)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
vms_sys.error: (2280, '%SYSTEM-W-NONEXPR, nonexistent process')

>>> vms_sys.wake (None,'NONEXPRC')
Traceback (innermost last):
  File "<stdin>", line 1, in ?
vms_sys.error: (2280, '%SYSTEM-W-NONEXPR, nonexistent process')

>>> vms_sys.wake (1,2)
Traceback (innermost last):
  File "<stdin>", line 1, in ?
TypeError: argument 2: expected read-only buffer, int found

>>> vms_sys.wake ('X')
Traceback (innermost last):
  File "<stdin>", line 1, in ?
TypeError: argument 1: pidadr - must be integer or None
>>>

(go to: table of contents, index, list of vms_sys, prev: WAITFR, next: WFLAND)

28-SEP-1998 ZE.