AGI_ASSOC

Associate an AGI device with an ADAM parameter

Description:

Associate an AGI device with a parameter in the ADAM environment and return an identifier to the current picture. If there are no pictures on the device then a base picture is created and made current. If the size of the display window has changed since a previous database operation the database is cleared and a message sent to the user. The access mode does not affect the database operation, but it is used by the graphics system to determine if the display should be cleared the first time the device is opened; READ and UPDATE access do not clear the display, but WRITE access does.

Invocation

CALL AGI_ASSOC( PARAM, ACMODE, PICID, STATUS )

Arguments

PARAM = CHARACTER ( ) (Given)
Name of the parameter used for accessing the device
ACMODE = CHARACTER ( ) (Given)
Access mode: READ, WRITE or UPDATE
PICID = INTEGER (Returned)
Identifier for current picture on the given device
STATUS = INTEGER (Given and Returned)
The global status