{
{   The purpose of this request is to preserve the EOI byte address of a file}
{ opened for segment access. The effect of this request is to extract the}
{ byte_offset portion of the input pointer variable and store as the}
{ EOI byte address of the file. This request may be issued repeatedly}
{ throughout the task's usage of the file. Typically this request would be}
{ used prior to amp$close or task termination to define EOI for a newly}
{ created file. The user must have appropriate access privilege to redefine}
{ the EOI byte address of a pre-existant file.}
{   At close or task termination, pages and mass storage allocation beyond the}
{ newly defined EOI are released from the file. The pages and mass storage are}
{ cleared if the clear_space file attribute was specified at file creation.}
{   If this request is not issued for a newly created file, the EOI byte}
{ address will be determined from the highest virtual memory page referenced}
{ Thus EOI is rounded up to the nearest page boundary and may be imprecise.}
{
{       BAP$SET_SEGMENT_EOI (FILE_IDENTIFIER, CALL_BLOCK,
{        FAP_CONTROL_INFORMATION, FAP_LAYER_NUMBER, STATUS)
{
{ FILE_IDENTIFIER: (input) This parameter specifies the file access
{       identifier established when the file was opened.
{
{
{ CALL_BLOCK: (input) This paramter specifies the call block
{        used by this request.
{
{ FAP_CONTROL_INFORMATION: (input) This paramter specifies control
{        information necessary for orderly transfer of control from
{        the fap the the access method and from one access method
{        layer to another.
{
{ FAP_LAYER_NUMBER: (input) This parameter specifies the index into the
{        fap_control_information for this layer.
{
{ STATUS: (output) This parameter specifies the request status. THis is
{        the application's status variable.
{
