AGP_ASSOC - Associate a device with AGI and PGPLOT

Description:

This is a wrap-up routine to associate a device with the AGI database via the ADAM parameter system and open PGPLOT on it. A PGPLOT viewport corresponding to the current picture in the database is created. This routine calls AGI_ASSOC, AGI_BEGIN AGP_ACTIV and AGP_NVIEW. 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 AGP_DEASS.

Invocation:

CALL AGP_ASSOC( PARAM, ACMODE, PNAME, BORDER, PICID, 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.

BORDER = LOGICAL (Given)

Flag to indicate if a border is to be left around the viewport.

PICID = INTEGER (Returned)

Picture identifier for current picture on given device.

STATUS = INTEGER (Given and Returned)

The global status.