Synchronously loads overlay modules for 16-bit (OMF286) programs. Not valid for 32-bit programs.
CALL rq$s$overlay (name_ptr, except_ptr);
rq_s_overlay (name_ptr, except_ptr);
| Parameter | PL/M Data Type | C Data Type |
| name_ptr | POINTER | STRING far * |
| except_ptr | POINTER to WORD_16 | UINT_16 far * |
name_ptr
A pointer to a STRING containing the name of an overlay. Use only uppercase letters, both here and in the overlay definition file.
except_ptr
A pointer to a variable declared by the application where the call returns a condition code.
Root modules issue this system call when they want to load an overlay module. The root module must be loaded using one of the system calls that create an I/O job.
The condition code is returned to the calling task.
| E_OK | 0000H | No exceptional conditions occurred. |
| E_DEV_DETACHING | 0039H | The device containing the specified file is being detached. If the device is a remote device, a retry may succeed. |
| E_EOF | 0065H | The call encountered an unexpected EOF. |
| E_EXIST | 0006H | The specified device does not exist. |
| E_FLUSHING | 002CH | The device containing the target file is being detached. |
| E_IO_HARD | 0052H | A hard I/O error occurred. A retry is probably useless. |
| E_IO_OPRINT | 0053H | The device containing the target overlay is off-line. Operator intervention is required. |
| E_IO_SOFT | 0051H | A soft I/O error occurred. The I/O System tried to perform the operation and failed; a retry may succeed. |
| E_IO_UNCLASS | 0050H | An unknown I/O error occurred. |
| E_LIMIT | 0004H | Either the calling task's job, or its default user object, is already involved in 255 I/O operations. |
| E_NOMEM | 0068H | The memory pool of the new I/O job does not have a block of memory large enough for the AL to load the overlay module. |
| E_NOT_CONFIGURED | 0008H | This system call is not part of the present configuration. |
| E_OVERLAY | 006EH | The overlay name indicated by the name_ptr parameter does not match any overlay module name in the overlay definition file. |
| E_SUPPORT | 0023H | At least one of these is true:
·The specified connection is not in this job. ·The calling task is a 16-bit task attempting to load a 32-bit object which contains either a code or stack offset larger than 64 Kbytes. |