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


__iew_create_list() – Create list

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

The binder’s lists consist of a fullword count of the number entries followed by the entries. Each list entry contains an 8-byte name, a fullword containing the length of the value string, and a 31-bit pointer to the value string. The __iew_create_list() function creates a list of keywords and values in “binder list format”. It is used to support file lists and exit lists for the __iew_openW() call. There are two types of lists:

  1. A list of DD names with keywords being any of the standard binder DD names as strings, and values being string replacement names to use for them.
  2. A list of exit routines with keywords being any of the strings “MESSAGE”, “INTFVAL”, or “SAVE”, and values being an array of three pointers, to:
    • exit routine entry point
    • application data passes to the exit
    • message exit severity (unused, but must be provided as zero, for the other two exits)

Format

#include <__iew_api.h>
_IEWList *__iew_create_list(int__size,
                                                char *__keys[], 
                                                void *__values[]);

Parameters Descriptions

__size
input: size of the list.
__keys
input: list of keywords.
__values
input: list of values.

Returned Value

If successful, __iew_create_list() returns API list.

If unsuccessful, __iew_create_list() returns null.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014