|
| ZCOM C I/F Library Routines |
|
| ZMAPR (3X) |
PARAMETERS |
|
|
| zap | ZCOM address to be mapped. |
| mzap | ZCOM address to be mapped onto. |
NOTES | On a successful return from zmapr, accessing the source ZLU is actually | |
| directed to the destination ZLU. If the source ZLU was a program ZLU, | |
| all messages that were queued on it will be flushed (i.e., returned to the | |
| free queue). If it was a terminal ZLU, the linkage to the terminal is lost. | |
| Usually, this is not desirable because the previously associated terminal | |
| is unusable. |
|
RETURN VALUE | Routine zmapr returns 0 if successful. Otherwise, a | |
| is returned. See /opt/acc/include/zcom/zcomsys.h for the list of ZCOM | |
| error codes and their meanings. | |
EXAMPLE | #include | <zcom/zcomsys.h> |
| #include | <zcom/zcomcall.h> |
| int32 | ierr; |
| zaddr_type | zaddr; |
| zaddr_type | maddr; |
if (ierr = zmapr (&zaddr, &maddr)) { /* error return code */
}
else {
/* good return code */
}
FILES
/opt/acc/include/zcom/zcomsys.h | ZCOM subsystem general include file, |
| containing data types, data |
| structures, constants, error codes, |
| masks, etc. Note that this must be the |
| first include file before any other |
| ZCOM include files. |
/opt/acc/include/zcom/zcomcall.h | ZCOM routine function prototypes |
| (requires ANSI C compilation). |
Chapter 4 | 265 |