VMS Help System Services, $ICC OPEN ASSOC  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Declares an application association with ICC.

    On Alpha systems, this service accepts 64-bit addresses.

    Format

      SYS$ICC_OPEN_ASSOC  assoc_handle ,[assoc_name] ,[logical_name]

                          ,[logical_table] ,[conn_event_rtn]

                          ,[disc_event_rtn] ,[recv_rtn]

                          ,[maxflowbufcnt] ,[prot]

    C Prototype:

      int sys$icc_open_assoc  (unsigned int *assoc_handle, void

                              *assoc_name, void *logical_name,

                              void *logical_table, void

                              (*conn_event_rtn)(__unknown_params),

                              void

                              (*disc_event_rtn)(__unknown_params),

                              void (*recv_rtn)(__unknown_params),

                              unsigned int maxflowbufcnt, unsigned

                              int prot);

1 - Arguments

 assoc_handle

    OpenVMS usage:association_id
    type:         longword (unsigned)
    access:       write only
    mechanism:    by 32-bit or 64-bit reference (Alpha)
    mechanism:    by 32-bit reference (VAX)
    The 32-bit or 64-bit address (on Alpha systems) or the 32-bit
    address (on VAX systems) of a longword into which $ICC_OPEN_ASSOC
    writes the handle assigned to the opened association.

 assoc_name

    OpenVMS usage:char_string
    type:         character-coded text string
    access:       read only
    mechanism:    by 32-bit or 64-bit descriptor (Alpha)
    mechanism:    by 32-bit descriptor (VAX)
    An ASCII character string of up to 31 characters in length
    specifying the name of the application opening the association.
    Null (0 length), and empty or blank association names are not
    allowed. If this argument is omitted (that is, a zero is passed
    in by value), it signifies that the user wants to open the
    default association. This argument is case sensitive.

 logical_name

    OpenVMS usage:logical name
    type:         character-coded text string
    access:       read only
    mechanism:    by 32-bit or 64-bit descriptor (Alpha)
    mechanism:    by 32-bit descriptor (VAX)
    A logical name in a clusterwide logical name table used to
    maintain the simple association registry. The logical name
    represents the name of the service provided by the application.
    Logical names are case sensitive.

 logical_table

    OpenVMS usage:logical name table
    type:         character-coded text string
    access:       read only
    mechanism:    by 32-bit or 64-bit descriptor (Alpha)
    mechanism:    by 32-bit descriptor (VAX)
    The table containing the logical name logical_name. Logical
    name tables are converted to uppercase. Unless your application
    requires an application-specific logical name table,
    this argument should be either the default ICC Registry
    search list (ICC$REGISTRY), or the default registry table
    (ICC$REGISTRY_TABLE).

 conn_event_rtn

    OpenVMS usage:user_routine
    type:         procedure_entry_mask
    access:       call without stack unwinding
    mechanism:    by 32-bit or 64-bit linkage reference (Alpha)
    mechanism:    by 32-bit reference (VAX)
    The address of the AST routine to be called for incoming connect
    events. This routine will be called in the mode of the caller.
    (No mechanism is provided for the routine to be called at a
    different mode).

    You must have a conn_event_rtn to operate as a server.

 disc_event_rtn

    OpenVMS usage:user_routine
    type:         procedure_entry_mask
    access:       call without stack unwinding
    mechanism:    by 32-bit or 64-bit linkage reference (Alpha)
    mechanism:    by 32-bit reference (VAX)
    The address of the AST routine to be called for incoming
    disconnect events. This routine will be called in the mode of the
    caller. (No mechanism is provided for the routine to be called at
    a different mode). The arguments, conn_event_rtn, and disc_event_
    rtn, may reference the same routine.

 recv_rtn

    OpenVMS usage:user_routine
    type:         procedure_entry_mask
    access:       call without stack unwinding
    mechanism:    by 32-bit or 64-bit linkage reference (Alpha)
    mechanism:    by 32-bit reference (VAX)
    The address of the AST routine to be called for incoming new data
    events.

    If the user provides this routine, it indicates that the
    user will supply a buffer of the size required (specified in
    an argument to the recv_rtn at each call) each time one is
    requested. If the user supplies this routine, receive calls
    should only be issued after receive events arrive and sufficient
    buffer space has been allocated to handle the incoming data.

    This routine will be called in the mode of the caller. (No
    mechanism is provided for the routine to be called at a different
    mode).

 maxflowbufcnt

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    The maximum number of pending inbound messages (per connection)
    that ICC will allow the user before initiating flow control. A
    message is pending if it is being held within ICC but no receive
    call(s) are outstanding from the user.

    Default = 5 (Pass 0 to get the default)

 prot

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    This argument is ignored for non-server applications.

    The default protection scheme for this association is as follows:

    0 - access for everyone (default)
    1 - stops WORLD access
    2 - stops both WORLD and GROUP access

    Advanced access control is provided by ICC Security objects.
    Refer to the OpenVMS System Manager's Manual for information on
    ICC system management and security.