__iew_addA2() – Add alias

Adds a new alias to the list of aliases for a program, or changes the AMODE of an entry point. Can be used when binding or copying a program.

Format

#include <__iew_api.h>
int __iew_addA2(_IEWAPIContext *__context,
const char *__aname, const char *__ename,
_IEWAnameType __anametype,
const char *__amode,const char *__dname);

Parameters Descriptions

__context: API context is created and returned by calling __iew_openW() and is used throughout the open session.
__aname: the name of the alias to be added
__ename: existing external symbol in the program to be associated with the alias
__anametype: alias type can be one of the following:
_IEW_ALIAS
_IEW_SYM_LINK
_IEW_PATH
__amode: amode and the values that can be specified for amode are ‘24’, ‘31’, ‘64’, ‘ANY’, and ‘MIN’
__ddname: a varying character string (the alias name), up to 32767 bytes long, located in the directory of the included module. If the name specified for DNAME is not found in the directory, the binder will issue an error message.

Returned Value

If successful, __iew_addA2() returns 0.

If unsuccessful, __iew_addA2() returns nonzero.

Note: The returned value is the same as the code returned by a subsequent __iew_get_return_code().

Utilities Functions

__iew_get_reason_code()
__iew_get_return_code()