{
{   The purpose of this request is to preserve the EOI byte address of a file}
{ opened for segment access. This request should be used after writing a new}
{ file or after appending information to an old file. Also this request may}
{ be used to record EOI after shortening an old file. The user must have}
{ pfc$append permission to the file to increase the EOI byte address and}
{ pfc$shorten permission to decrease EOI.}
{   If after appending data to a file this request is omitted, then the
{ NOS/VE system will preserve a default value for the EOI byte address.}
{ However, the default value of EOI will be the address of the page beyond
{ the highest page referenced by the program.  Thus if this request is not}
{ used to preserve the actual EOI, a subsequent reader of the file may obtain}
{ data which is not logically a part of the file.  Because there is no concept}
{ of position wihin a CYBIL heap, EOI is managed by the NOS/VE system.  This}
{ request cannot be used to preserve EOI for a file accessed as a CYBIL heap.}
{   If this request is used to shorten an old file, pages beyond the new
{ EOI byte address are discarded.  If the EOI byte address is within a
{ page, that page is retained; data within the last page and beyond
{ the EOI byte address will remain as before the shorten operation.}
{   This request unconditionally sets the current position of the file to}
{ the EOI byte address.  Specifically, the current_byte_address and the}
{ global_file_address are each set to EOI.}
{   This request may be issued repeatedly throughout the task's use of}
{ the file.}
{
{       AMP$SET_SEGMENT_EOI (FILE_IDENTIFIER, SEGMENT_POINTER,STATUS)
{
{ FILE_IDENTIFIER: (input) This parameter specifies the file access
{       identifier established when the file was opened.
{
{
{ SEGMENT_POINTER: (input) This parameter specifies the address within the
{       segment of the new EOI of the file.
{
{ STATUS: (output) This request specifies the request status.
{       CONDITION:  ame$ring_validation_error,
{                   ame$improper_file_id,
{                   ame$improper_segment_number,
{                   ame$improper_segment_pointer,
{                   ame$set_eoi_needs_append,
{                   ame$set_eoi_needs_shorten,
{                   ame$set_on_adaptable_heap.
{       IDENTIFIER: amc$access_method_id.
{
