{}
{   The purpose of this module is to implement an internal program interface
{ that allows retrieval of a pointer to a structure which is owned by a file
{ access procedure (FAP).
{   This request allows the fap to retrieve a pointer to a structure which is
{ peculiar to the instance of the file being accessed, i.e. peculiar to a
{ file identifier.
{   This request will return abnormal status if the structure pointer for the
{ fap is NIL.
{}
{       BAP$GET_STRUCTURE_POINTER (FILE_IDENTIFIER, VALIDATION_PROC,
{         STRUCTURE_POINTER, STATUS)
{}
{ FILE_IDENTIFIER: (input) This parameter specifies the file access identifier
{       established when the file was opened.
{}
{ VALIDATION_PROC: (input) This parameter specifies the address of the fap.
{       This parameter is used to identify the fap that owns the structure
{       whose address is being retrieved.
{}
{ STRUCTURE_POINTER: (output) This parameter specifies the address of a
{       structure the fap previously stored using the amp$store_fap_pointer
{       request.
{}
{ STATUS: (output) This parameter specifies the request status.
{       CONDITION: ame$ring_validation_error,
{                  ame$improper_file_id,
{                  ame$nil_structure_pointer.
{       IDENTIFIER:amc$access_method_id.
{}
