GNS_GWNI

Get next IDI workstation name

Description:

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.

Invocation

CALL GNS_GWNI( 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(SZNAM) (Returned)
Workstation name
DESCR = CHARACTER(SZDES) (Returned)
Text description of the workstation
LD = INTEGER (Returned)
Length of description
STATUS = INTEGER (Given and Returned)
The global status