The name and description of the "next" IDI workstation from the list of defined workstation names is returned. If the context argument is set to zero the first name in the list will be returned. The context argument is incremented each time a new name is returned until there are no more names in the list when it will be set to zero.

FILTER is the name of a logical function that is called for each workstation name in the list and can be used to select or reject workstations on criteria such as the workstation class. It should return the value .TRUE. if the name is to be included in the list and .FALSE. if it should not. FILTER has one character argument; the IDI workstation type.

The GNS library contains a suitable function called GNS_FILTI which selects all workstations.

CALL GNS_GWNI( FILTER, ICNTX, NAME, DESCR, LD, STATUS )

FILTER = LOGICAL FUNCTION (Given)

ICNTX = INTEGER (Given and Returned)

NAME = CHARACTER$\ast$(SZNAM) (Returned)

DESCR = CHARACTER$\ast$(SZDES) (Returned)

LD = INTEGER (Returned)

STATUS = INTEGER (Given and Returned)