The AGI name corresponding to the specified IDI workstation is returned.

If the name is longer than the supplied character variable the name is truncated.

CALL GNS_IANI( NAME, AGINAM, STATUS )

NAME = CHARACTER$\ast$($\ast$) (Given)

AGINAM = CHARACTER$\ast$(GNS__SZAGI) (Returned)

STATUS = INTEGER (Given and Returned)

The AGI name is constructed from ’AGI_$<$wktype$>$_$<$seqno$>$’ using the GKS workstation type and a sequence number. The GKS workstation type is obtained from the AGITYPE attribute. A sequence number of zero is used unless there is an explicit sequence number in the IDINAMES file.

This routine is used by AGI and will not normally be called by an applications program.