{
{
{      The purpose of this request is to accept a switch of ownership of a
{ connection end point from another job 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
{ makes an offer to switch a connection end point to a destination job.
{ The destination job uses this request to accept the switch offer and
{ complete the connection end point switch.
{
{      The request is terminated if either a switch offer is received or
{ the WAIT_TIME has expired (whichever comes first).
{
{      If a connection switch has been offered, the access method creates
{ the file specified by the CONNECTION_FILE parameter, assigns the
{ connection end point to that file, and assigns the initial file
{ attributes.  The default attributes are migrated from the
{ source jobs connection file.
{
{ RFP$ACCEPT_SWITCH_OFFER(APPLICATION_NAME, CONNECTION_FILE,
{   FILE_ATTRIBUTES, WAIT_TIME, SOURCE_JOB, STATUS)
{
{ APPLICATION_NAME: (input) This parameter specifies the name of a signed
{   on application.  A connection switch offer must be destined for this
{   application to satisfy the request.
{
{ CONNECTION_FILE: (input) This parameter specifies the name of the
{   file, which the access method should create and assign to the
{   local connection end point.  The application must use the file
{   name for all future references to the connection.  The file must
{   not be present before this request is issued.  The connection file
{   is created in the $local catalog.
{
{ FILE_ATTRIBUTES: (input) This parameter specifies the file attributes,
{   whose values are to be changed to the corresponding values specified
{   by this parameter. A value of NIL for this parameter indicates that
{   default values are to be used for all attributes. Further
{   information on the file attributes is provided in the BAM request
{   section.
{
{ WAIT_TIME: (input) This parameter specifies the number of milliseconds to
{   suspend the application if an offered connection is not immediately
{   available.  If the WAIT_TIME expires before an offered connection
{   is available the access method terminates the request with a status
{   of 'rfe$connection_not_available'.  A value of zero can be specified
{   to avoid waiting.
{
{ SOURCE_JOB: (output) This parameter returns the system job name of the
{   job that offered the connection to this job.
{
{ STATUS: (output) This parameter returns the results of the request.
{   A status of normal means that an offered  connection has been assigned
{   to the job.
{   CONDITIONS:  rfe$not_signed_on
{                rfe$exceeded_connect_limit
{                rfe$file_already_exists
{                rfe$invalid_attribute_key
{                rfe$no_switch_offered
{   IDENTIFIER:  'RF'
{
