GE - Getting External Symbol Dictionary data

This service is a specialized variant of GD, used to retrieve only one class, B_ESD. This can be a confusing class, though, because ESD records are owned by elements in a second class and may point to elements in a third class. For example, an ESD may describe an adcon in class C_CODE that refers to an address in class B_TEXT. Using the 'GD' service you would only be able to indicate that you were interested in class B_ESD, and would have to retrieve all ESDs to locate the specific ones you were interested in. The 'GE' service allows the caller to screen ESDs returned, limiting the output to those owned by a specified class. The calling application can also ask for ESDs in a specific section.

Table 1. GE parameter list
Parameter	Usage	Format	Content
1	in	structure	'GE', X'0001'
2	in	binary word	mtoken
3 (optional)	in	vstring	class
4 (optional)	in	vstring	section
5	in/out	structure	buffer Must be formatted by IEWBUFF or as defined in Binder API buffer formats, and appropriate to the class requested.
6	in/out	binary word	cursor - in items The item size depends on the buffer type and buffer version used.
7	out	binary word	count - in items

Sample assembler code

         CALL  (15),(GEIL,MTOKEN,CLASS,,BUFF,CURS,CNT),VL

GEIL     DC    C'GE',X'0001'
MTOKEN   DS    F              As set at Start call    
CLASS    DC    H'6',C'C_CODE' Limit ESDs returned        
CURS     DC    F'0'           Start with first ESD
CNT      DS    F              Number of ESDs returned 
BUFF IEWBUFF FUNC=MAPBUF,TYPE=ESD,VERSION=6,SIZE=50
*              i.e. a buffer big enough to hold 50 ESDs,
*              assuming the names are not too long.