z/OS MVS Program Management: Advanced Facilities
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


__iew_api_name_to_str() – Convert API name into string

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

Data buffers returned by the binder and fast data APIs often contain pointers to names. Those are character data, but not stored as C null-delimited strings. Instead they have a separate length field in the buffer structure. This function returns a C string equivalent to the name returned by the API.

The function also provides special handling for binder-generated names, which are returned as binary numbers. The function will convert those to special displayable strings which will be recognized and automatically reconverted by the functions in this suite if they are passed back to the API later.

Format

#include <__iew_api.h>
void __iew_api_name_to_str(const char *__name,
                                                short __len, 
                                                char *__str);

Parameters Descriptions

__name
input: varying string characters.
__len
input: varying string size.
__str
output: string.
Note: You need to allocate storage for string. The length should be the greater of 10 and input len+1.

Returned Value

None.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014