{
{    The purpose of this request is to acquire ownership of a CDNA connection
{  end point which has been assigned to a server application.  The NAM assigns
{  a connection end point to a server application in response to a request by a
{  client application to establish a connection to the server.  In general, the
{  client may be any application which executes on some CDNA system.
{
{    Acquiring a connection end point is a local system operation which only
{  establishes ownership of the connection end point.  The client application
{  receives no indication of this action.
{
{    In order to acquire a connection end point, the requesting job must first
{  attach itself to a server application.  This identifies the job to the NAM as
{  a server application job.  Any server application job attached to a server
{  application may acquire a connection end point assigned to the server.
{
{    The NAM maintains a list of CDNA connection end points which have been
{  assigned to a server application.  Acquiring a connection end point
{  associates a network file with the connection end point at the head of the
{  list and removes the connection end point from the list.
{
{    If no connection end point has been assigned to the server application
{  when this request is made, the request waits a specified interval of time for
{  a connection end point to be assigned (and completes as soon as an assignment
{  occurs).  If no connection end point is assigned within this interval, an
{  abnormal status is returned.  The osp$await_activity_complete request may
{  also be used to wait for a connection end point to be assigned to a server
{  application.
{
{    The connection whose end point is acquired may or may not be established.
{  If the NAM has been directed to accept connection requests on behalf of the
{  server application (refer to the accept_connection attribute maintained by
{  the MANAGE_NETWORK_APPLICATIONS utility), then the acquired connection will
{  be an established connection.  Otherwise, the nap$accept_connection request
{  must be used to complete establishment of the acquired connection.
{
{        NAP$ACQUIRE_CONNECTION (SERVER, FILE, ATTRIBUTES, WAIT_TIME, STATUS)
{
{  SERVER: (input) This parameter specifies the name of the server application
{        on whose behalf a connection end point is to be acquired.  The
{        requesting job must have previously attached itself to the specified
{        server application.
{
{        The specified name must be the name of a defined server application --
{        refer to the MANAGE_NETWORK_APPLICATIONS utility.  The caller must
{        be authorized to perform the functions of the specified server
{        application.  The criteria used to validate this privilege is
{        determined by the server_ring, server_system_privilege and
{        server_capability attributes of the specified server application.
{
{  FILE: (input) This parameter specifies the name of the network file which is
{        to be created to identify the acquired connection end point.
{
{        The network file is created in the $LOCAL catalog.
{
{  ATTRIBUTES: (input) This parameter specifies the connection attribute values
{        which are to be used for the acquired connection.  A value of NIL for
{        this parameter indicates that default values are to be used for all
{        attributes.
{
{  WAIT_TIME: (input) This parameter specifies the number of milliseconds that
{        the request is to wait for a connection end point to be assigned to the
{        specified server application.  A value of 0 may be specified to avoid
{        waiting.
{
{  STATUS: (output) This parameter specifies the request status.
{        CONDITIONS:
{              ame$file_known
{              nae$application_inactive
{              nae$invalid_connect_data_change
{              nae$invalid_eoi_message_size
{              nae$max_connections_acquired
{              nae$max_data_length_exceeded
{              nae$network_inactive
{              nae$no_connection_available
{              nae$server_not_attached
{              nae$unknown_application
{              nae$unknown_attribute
{              {other BAM conditions}
{
