AGS_ASSOC

Associate a device with AGI and SGS

Description:

This is a wrap-up routine to associate a device with the AGI database via the ADAM parameter system and open SGS on it. An SGS zone corresponding to the current picture in the database is created. This routine calls AGI_ASSOC , AGI_BEGIN, AGS_ACTIV and AGS_NZONE. Also if the name string is not blank then AGI_RCL is called to recall the last picture of that name. This routine should be matched by a closing call to AGS_DEASS.

Invocation

CALL AGS_ASSOC( PARAM, ACMODE, PNAME, PICID, NEWZON, STATUS )

Arguments

PARAM = CHARACTER ( ) (Given)
The name of the ADAM parameter for accessing device names
ACMODE = CHARACTER ( ) (Given)
Access mode for pictures. READ, WRITE or UPDATE.
PNAME = CHARACTER ( ) (Given)
Recall last picture of this name if not blank.
PICID = INTEGER (Returned)
Picture identifier for current picture on given device.
NEWZON = INTEGER (Returned)
The new SGS zone that matches the current picture.
STATUS = INTEGER (Given and Returned)
The global status.