HELPLIB.HLB  —  System Services, $ICC CONNECT
    Establishes a connection to a remote application over an open
    association.

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

    Format

      SYS$ICC_CONNECT  ios_icc ,[astadr] ,[astprm] ,assoc_handle

                       ,conn_handle ,remote_assoc ,[remote_node]

                       ,[user_context] ,[conn_buf] ,[conn_buf_len]

                       ,[return_buf] ,[return_buf_len] ,[retlen_addr]

                       ,[flags]

    C Prototype

      int sys$icc_connect  (struct _ios_icc *ios_icc, void

                           (*astadr)(__unknown_params), __int64

                           astprm, unsigned int assoc_handle,

                           unsigned int *conn_handle, void

                           *remote_assoc, void *remote_node, unsigned

                           int user_context, char *conn_buf, unsigned

                           int conn_buf_len, char *return_buf,

                           unsigned int return_buf_len, unsigned int

                           *retlen_addr, unsigned int flags);

1  –  Arguments

 ios_icc

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

                           +2                       0
    -------------------------------------------------
    |       Undefined       |   Completion status   |
    -------------------------------------------------
    |               ios_icc$l_remstat               |
    -------------------------------------------------
                           +6                      +4

    Completion status values:

    SS$_NORMAL, SS$_BUFFEROVF, SS$_EXQUOTA, SS$_INSFMEM,
    SS$_IVBUFLEN, SS$_LINKABORT, SS$_LINKDISCON, SS$_NOLOGNAM,
    SS$_NOSUCHOBJ, SS$_NOSUCHNODE, SS$_PATHLOST, SS$_REJECT,
    SS$_SSFAIL, SS$_UNREACHABLE, SS$_WRONGSTATE

    The second longword is undefined unless the completion code
    is SS$_REJECT. In this case, the application-defined rejection
    reason code is supplied by the server when $ICC_REJECT is called.

 astadr

    OpenVMS usage:ast_procedure
    type:         procedure_entry_mask
    access:       call without stack unwinding
    mechanism:    by 32-bit or 64-bit linkage reference (Alpha and
                  Integrity servers)
    The AST routine to be executed when the operation completes.

 astprm

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

 assoc_handle

    OpenVMS usage:association_id
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    The handle of the association on which the connection is to be
    opened. The constant ICC$C_DFLT_ASSOC_HANDLE, if used, indicates
    that the default association is to be used (and opened if
    necessary).

 conn_handle

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       write only
    mechanism:    by 32-bit or 64-bit reference (Alpha and Integrity
                  servers)
    The 32-bit or 64-bit address (on Alpha and Integrity server
    systems) of a longword into which $ICC_CONNECT writes the
    connection handle of the created connection on a successful call.

 remote_assoc

    OpenVMS usage:char_string
    type:         character-coded text string
    access:       read only
    mechanism:    by 32-bit or 64-bit descriptor (Alpha and Integrity
                  servers)
    An ASCII character string (31 characters maximum) specifying the
    name of the target application to connect to. Association names
    are case sensitive.

 remote_node

    OpenVMS usage:char_string
    type:         character-coded text string
    access:       read only
    mechanism:    by 32-bit or 64-bit descriptor (Alpha and Integrity
                  servers)
    The name of the node where the target association resides. A
    null or blank string can be used to indicate the local node.
    If omitted (by passing zero by value), the simple clusterwide
    association registry is to be used. Each node name is a one-to-
    six character SCS node name. A comma-delimited list of nodes may
    be specified, indicating that one is to be chosen at random.

 user_context

    OpenVMS usage:user_arg
    type:          quadword (Alpha and Integrity servers)
    access:       read only
    mechanism:    by value
    A user-specified value to be subsequently returned on any
    disconnect or data events on this connection.

 conn_buf

    OpenVMS usage:byte_stream
    type:         character-coded text string
    access:       read only
    mechanism:    by 32-bit or 64-bit reference (Alpha and Integrity
                  servers)
    A buffer of up to 1000 bytes of connection data to be sent to the
    target of the connection during the connection process.

 conn_buf_len

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

 return_buf

    OpenVMS usage:byte_stream
    type:         character-coded text string
    access:       read only
    mechanism:    by 32-bit or 64-bit reference (Alpha and Integrity
                  servers)
    A buffer of up to 1000 bytes in length to receive any incoming
    connection accept or reject data returned.

 return_buf_len

    OpenVMS usage:buffer_length
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    The length of the supplied return_buf.

 retlen_addr

    OpenVMS usage:longword_unsigned
    type:         longword (unsigned)
    access:       write only
    mechanism:    by 32-bit or 64-bit reference (Alpha and Integrity
                  servers)
    The 32-bit or 64-bit address (on Alpha and Integrity server
    systems) of a longword into which $ICC_CONNECT writes the actual
    length (in bytes) of any user accept or reject data returned in
    the buffer return_buf.

 flags

    OpenVMS usage:mask_longword
    type:         longword (unsigned)
    access:       read only
    mechanism:    by value
    ICC$M_SYNCH_MODE can be specified to indicate that the data
    transmission and reception routines $ICC_TRANSMIT, $ICC_RECEIVE,
    and $ICC_REPLY are allowed to return the status SS$_SYNCH in the
    case of synchronous completion, indicating that the AST will not
    be called.
Close Help