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