gtpc2m9kC/C++ Language Support User's Guide

wgtac-Locate Terminal Entry

This function returns information from the WGTA table concerning a terminal LNIATA (or pseudo-LNIATA) value.

Format

#include     <tpfapi.h>
struct wg0ta *wgtac(int lniata, unsigned char cpuid, struct wg0ta *storage);

lniata
An integer representing the LNIATA (or SNA RID) for which information is desired. Only 24 bits of this integer are considered significant.

cpuid
An unsigned character representing the hexadecimal CPU identification of the CPU on which the calling ECB is running.

storage
A pointer to a free working storage area large enough to hold a completed wg0ta structure. This address is overwritten with a completed wg0ta, and is passed back as the return value if the search for the requested LNIATA is successful. The wg0ta structure is defined in tpfapi.h.

Normal Return

Pointer to struct wg0ta for the requested LNIATA.

Error Return

NULL pointer.

Programming Considerations

None.

Examples

The following example obtains a copy of the WGTA table information for the LNIATA referred to from the issuing ECB.

#include <tpfapi.h>
struct wg0ta *wgta;

  ·
  ·
  ·
wgta = (struct wg0ta *) getcc(D4, TYPE, L1); if(!(wgta = wgtac(ecbptr()->ebrout,ecbptr()->ce1cpd,wgta))) { /* Item not found if return was zero */ puts("LNIATA not referenced in WGTA table\n"); relcc(D4); } else /* Normal processing path */
  ·
  ·
  ·

Related Information