GN - Getting Names of sections or classes

This is often the first Get service requested, because it provides the names of sections or classes within the program object, thus providing information required for the GD or GE service calls. If this service is called with no buffer it returns, in the count field, the number of classes or sections in the program object.

Table 1. GN parameter list
Parameter	Usage	Format	Content
1	in	structure	'GN', X'0001'
2	in	binary word	mtoken
3	in	character	ntype: C for class or S for section May be upper or lower case.
4 (optional)	in/out	vstring	buffer Must be an NAME buffer formatted by IEWBUFF or as defined in Binder API buffer formats.
5	in/out	binary word	cursor - in items The item size depends on the buffer type and buffer version used.
6	out	binary word	count - in items

Sample assembler code

         CALL  (15),(GNIL,MTOKEN,TYPE,BUFF,CURS,CNT),VL

GNIL     DC    C'GN',X'0001'
MTOKEN   DS    F              As set at Start call    
TYPE     DC    C'C'           To return class names/info 
CURS     DC    F'0'           Start with first class
CNT      DS    F              Number of classes returned 
BUFF IEWBUFF FUNC=MAPBUF,TYPE=NAME,VERSION=6,SIZE=50
*              i.e. a buffer big enough to hold 50 classes.
*              (Class names are never too long.)