{
{    The purpose of this request is to offer a switch of ownership of a CDNA
{  connection end point to another job executing on the local system.  Switching
{  ownership of a connection end point is a local system operation -- the peer
{  application at the remote connection end point receives no indication of this
{  action.
{
{    Switching ownership of a connection end point is a cooperative process
{  which requires the active participation of both the source job (current
{  owner) and the destination job (proposed owner).  The source job uses this
{  request to make an offer to switch a connection end point to a destination
{  job.  The destination job must accept this switch offer to complete the
{  connection end point switch.
{
{    The source job determines the duration of the offer to switch a connection
{  end point.  If the destination job does not accept the switch offer within a
{  reasonable amount of time, the source job may cancel the switch offer.
{
{    While the switch offer is in effect, requests which reference the specified
{  network file result in abnormal status -- except for a request to detach
{  (return) the file, which cancels the switch offer and terminates the
{  connection.  Once the destination job accepts the switch offer, the network
{  file may be detached (returned) without affecting the switched connection.
{  This is the only request which may be made for the network file after the
{  switch offer has been accepted.
{
{    If there are active instances of open of the specified network file when
{  this request is made, an abnormal status is returned.
{
{    Switching a connection end point does not affect the count of the number
{  of established connections for the application which established the
{  connection.  That is, jobs which receive ownership of a connection end point
{  are effectively considered part of the application which originally
{  established the connection.
{
{        NAP$OFFER_CONNECTION_SWITCH (FILE, DESTINATION, WAIT_TIME, STATUS)
{
{  FILE: (input) This parameter specifies the name of the network file which
{        identifies the connection end point for which a switch of ownership
{        is to be offered.
{
{  DESTINATION: (input) This parameter specifies the job to which the offer to
{        switch ownership of the specified connection end point is to be made.
{
{  WAIT_TIME: (input) This parameter specifies the number of milliseconds that
{        the request is to wait for the destination job to accept the switch
{        offer.  A value of 0 indicates that the calling task is to continue
{        execution while the switch offer is in effect.
{
{        Failure of the destination job to accept the switch offer within this
{        waiting period has no effect on the switch offer.  The source job must
{        explicitly cancel the switch offer if the destination job has not
{        accepted the offer within a reasonable amount of time.
{
{        The osp$await_activity_complete request may be also used to wait for
{        the switch offer to be accepted.
{
{  STATUS: (output) This parameter specifies the request status.
{        CONDITIONS:
{              ame$file_not_closed
{              ame$file_not_known
{              ame$improper_device_class
{              nae$switch_offer_accepted
{              nae$switch_offer_not_accepted
{              nae$switch_offer_pending
{              {other BAM conditions}
{
