gtpc2m8e | C/C++ Language Support User's Guide |
This function moves data from one ECB virtual memory (EVM) address space to
another EVM address space. The tpf_movec_EVM function
permits an ECB-controlled program to read and modify storage that is not part
of its own address space.
Format
#include <sysapi.h>
void tpf_movec_EVM(const void *fromaddr, int fromecb, void *toaddr,
int toecb, long length);
- fromaddr
- Specifies the ECB virtual address (EVA) from which data will be
moved.
- fromecb
- Specifies the system virtual address (SVA) of the entry control block
(ECB) from which data is moved.
- toaddr
- Specifies the EVA to which data will be moved.
- toecb
- Specifies the SVA of the ECB to which data is moved.
- length
- Specifies the length of the data to be moved.
Normal Return
Void.
Error Return
Not applicable.
Programming Considerations
- This function requires that the application program allocation specify key
0 write authorization and authorization to issue a restricted macro.
- This function can be run on any I-stream.
- This function moves data from one EVM to another EVM. If you want
to move data between an EVM and the SVM, use the tpf_movec function
instead.
- System error dumps can occur when servicing a tpf_movec_EVM
request. See TPF Messages, Volume 1 and TPF Messages, Volume 2 for more information.
Examples
An example is not provided because ECB addresses for the TPF system vary
from customer site to customer site, making it difficult to provide a
meaningful example.
Related Information
tpf_movec-Move Data between EVM and SVM.
See TPF System Macros for information about the
$MOVEC macro.