/sys$common/syshlp/helplib.hlb System Services, $ICC DISCONNECT  *Conan The Librarian (sorry for the slow response - running on an old VAX)

    Terminates the specified connection.

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

    Format

      SYS$ICC_DISCONNECT  conn_handle ,iosb ,[astadr] ,[astprm]

                          ,[disc_buf] ,[disc_buf_len]

    C Prototype:

      int sys$icc_disconnect  (unsigned int conn_handle,

                              struct _iosb, *iosb, void

                              (*astadr)(__unknown_params),

                              __int64 astprm, char * disc_buf,

                              unsigned int disc_buf_len);

    Arguments

 conn_handle

    OpenVMS usage:connection_id
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    The ID of the connection to be disconnected.

 iosb

    OpenVMS usage:io_status_block
    type:         quadword (unsigned)
    access:       write only
    mechanism:    by 32-bit or 64-bit reference (Alpha)
    mechanism:    by 32-bit reference (VAX)
    I/O status block:

                           +2                       0
    -------------------------------------------------
    |       Undefined       |   Completion status   |
    -------------------------------------------------
    |        Unused         |        Unused         |
    -------------------------------------------------
                           +6                      +4

    Completion status values:

    SS$_NORMAL, SS$_EXQUOTA, SS$_LINKDISCON, $ICC_REJECT

 astadr

    OpenVMS usage:ast_procedure
    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 AST routine to be executed when the operation completes.

 astprm

    OpenVMS usage:user_arg
    type:         quadword (unsigned) (Alpha), longword (unsigned)
                  (VAX)
    access:       read only
    mechanism:    by 64-bit value (Alpha)
    mechanism:    by 32-bit value (VAX)
    The parameter to be passed to the AST routine.

 disc_buf

    OpenVMS usage:byte_stream
    type:         character-coded text string
    access:       read only
    mechanism:    by 32-bit or 64-bit reference (Alpha)
    mechanism:    by 32-bit reference (VAX)
    A buffer of up to 1000 bytes of disconnect data to be sent to the
    partner in the connection when notifying it that disconnection is
    being initiated. Delivery of this data is not guaranteed.

 disc_buf_len

    OpenVMS usage:buffer_length
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    The number of bytes in disc_buf to be sent.