__iew_includeName() – Include module by way of NAME

Adds an object to the wokmod identified either by a path name or by a DDname and member name.

Format

#include <__iew_api.h>
int __iew_includeName(_IEWAPIContext *__context,
                                        const char *__dd_or_path, 
                                        const char * __member,
                                        _IEWAPIFlags *__flags);                                       

Parameters Descriptions

__context
API context is created and returned by calling __iew_openW() and is used throughout the open session.
__dd_or_path
DD name or pathname.
__member
member name if using DD name.
__flags
API flags
  • __aliases - whether to include the program module aliases with the program module
  • Start of change__aliaskeep - if both __aliaskeep and __aliases are 1, an existing alias will only be kept if it is also specified by parameter DNAME of function __iew_addA2. Refer to __iew_addA2() – Add alias for more detail.End of change
  • __attrib - whether to include the program module attributes with the program module
  • __imports - whether or not the import statements are to be included from the input module
Note: Set the flag to 1 to turn the bit on or 0 to turn the bit off.

Returned Value

If successful, __iew_includeName() returns 0.

If unsuccessful, __iew_includeName() 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()