Title: README

Date: 20180205

Qzmq provides Q bindings for CZMQ, the high-level C binding for ØMQ (ZeroMQ).

Version 3.0.2 of qzmq corresponding to the same version of CZMQ. Qzmq offers a subset of CZMQ APIs. See the CZMQ Coverage below.

Qzmq is written and maintained by Jay Han (jay.han@gmail.com)

Qzmq is hosted at github and it uses the issue tracker for all issues and comments.

• News
• Features of qzmq
• CZMQ Coverage
• Copyright and License
• Files of qzmq
• Building qzmq
• Running qzmq
• Issues

• distributed systems connecting with systems
  • written in other languages,
  • written with many software patterns, using CZMQ and ØMQ/ZeroMQ developed by the ØMQ community.

ZeroMQ takes care of data mobility/distribution/topology (e.g. pub/sub, req/rep, etc.) over various networks and transports (threads/processes/hosts). Note that threads are not supported by qzmq.

Because q has first-class functions qzmq can move code as well as data.

Qzmq covers a subset of CZMQ APIs.

Mostly implemented as of 20160709:

• zsock - working with ZeroMQ sockets (high-level)
• zframe - working with single message frames
• zmsg - working with multipart messages
• zstr - sending and receiving strings

Deprecated:

• [zactor - simple actor framework][zactor]
• [zclock - millisecond clocks and delays][zclock]
• [zctx - working with ZeroMQ contexts][zctx]
• [zfile - provides methods to work with files in a portable fashion][zfile]
• [zthread - working with system threads][zthread]

May implement the following in the future:

• zloop
• zmonitor
• zpoller

Some czmq APIs seem redundant viz-a-viz q: zuuid or UUID support, zlist or generic container, etc.

// Copyright (c) 2012-2016 Jaeheum Han <jay.han@gmail.com>
// This file is part of qzmq.
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.

// Alternatively you may use Apache 2.0 license instead of MPL

• README.md
• kx/* -- k.h and c.o from kx.com for building qzmq. (see kx.com terms and conditions)
• qzmq.c -- C bindings to be linked with CZMQ (with ØMQ) and Q (k.h and c.o).
• qzmq.q -- q code used to load the bindings.
• qzmq.so -- dynamic library to be loaded into q by qzmq.q.

Prerequisites: kdb+ 3.0 or later, ØMQ 4, CZMQ 3. Consult your local sysadmin for installation prerequisites.

Current version 3.0.2 of qzmq has been built with 64-bit kdb+ on CentOS 7. Instructions for builidng qzmq assumes kdb+ is in $HOME/q/ directory.

git clone git://github.com/jaeheum/qzmq
cd qzmq
gcc -DKXVER=3 \
    -shared -fPIC qzmq.c -o $HOME/q/l64/qzmq.so \
    -Wall -Wextra \
    -Wl,-rpath -Wl,/usr/lib64 \
    -I./kx/kdb+3.0 \
    -L./kx/kdb+3.0/l64 \
    `pkg-config --cflags --libs czmq`
cp qzmq.q assert.q $HOME/q/

\l qzmq.q

ZeroMQ Guide has examples in many languages. Translation of these examples to q is under way (pulled from here). See Issue #5.

See the issue tracker.