GNS_GWNG - Get next GKS workstation name

Description:

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).

Invocation:

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

Arguments:

FILTER = LOGICAL FUNCTION (Given)

The name of the filter routine (which must be declared as external in the calling routine)

ICNTX = INTEGER (Given and Returned)

Search context. An input value of zero starts at the beginning of the list; returned as zero when there are no more names in the list.

NAME = CHARACTER*(GNS__SZNAM) (Returned)

Workstation name

DESCR = CHARACTER*(GNS__SZDES) (Returned)

Text description of the workstation

LD = INTEGER (Returned)

Length of description

STATUS = INTEGER (Given and Returned)

The global status