The name and description of the "next" GKS 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 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 integer argument; the GKS workstation type.

The GNS library contains a suitable function called GNS_FILTG which rejects any workstations that are not supported by the copy of GKS being run (if GKS is open; if it is not all workstation types are selected).

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

FILTER = LOGICAL FUNCTION (Given)

ICNTX = INTEGER (Given and Returned)

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

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

LD = INTEGER (Returned)

STATUS = INTEGER (Given and Returned)