__iew_resetW() – Reset workmod

z/OS MVS Program Management: Advanced Facilities

__iew_resetW() – Reset workmod

z/OS MVS Program Management: Advanced Facilities
SA23-1392-00

Clears all data from the active workmod to allow a different program to be brought in. This is required between any two include requests if _IEW_ACCESS was specified on the most recent __iew_openW() or __iew_resetW() call.

Format

#include <__iew_api.h>
int __iew_resetW(_IEWAPIContext *__context,
                             _IEWIntent __intent, 
                             _IEWFlags __flags);

Parameters Descriptions

__context

API context is created and returned by calling __iew_openW() and is used throughout the open session.

__intent

processing intent can be one of the following:

_IEW_ACCESS
_IEW_BIND

Note: _IEW_ACCESS is more efficient but only allows the program to be inspected or copied.

__flags

API flags:

__protect - whether to allow the binder to reset a workmod that has been altered but not yet saved or loaded.

Note: Set the flag to 1 to turn the bit on or 0 to turn the bit off.

Returned Value

If successful, __iew_resetW() returns 0.

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