File: sending_messages.html

package info (click to toggle)
quickfix 1.15.1%2Bdfsg-4
  • links: PTS
  • area: main
  • in suites: bookworm, bullseye
  • size: 42,080 kB
  • sloc: cpp: 631,686; python: 129,549; ruby: 106,716; xml: 43,737; ansic: 7,668; java: 1,826; cs: 816; makefile: 544; sh: 462; sql: 313
file content (127 lines) | stat: -rw-r--r-- 3,961 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN">

<html>
<head>
  <link href="doxygen.css" rel="stylesheet" type="text/css">

  <title>Sending Messages</title>
</head>

<body>
  <div class='header'>
    <div class='headertitle'>
      Sending Messages
    </div>
  </div>

  <div class='contents'>
    <p>Messages can be sent to a counter party with the static
    <b>Session::sendToTarget</b> methods.</p>See this code in
    <a href="python/sending_messages_1.html">PYTHON</a>, <a href=
    "ruby/sending_messages_1.html">RUBY</a>
    <pre class='fragment'>
// send a message that already contains a <i>BeginString</i>, <i>SenderCompID</i>, and a <i>TargetCompID</i>
static bool sendToTarget( Message&amp;, const std::string&amp; qualifier = "" )
  throw(SessionNotFound&amp;);

// send a message based on the sessionID, convenient for use
// in <i>fromApp</i> since it provides a session ID for incoming
// messages
static bool sendToTarget( Message&amp;, const SessionID&amp; )
  throw(SessionNotFound&amp;);

// append a <i>SenderCompID</i> and <i>TargetCompID</i> before sending
static bool sendToTarget( Message&amp;, const SenderCompID&amp;, const TargetCompID&amp;, const std::string&amp; qualifier = "" )
  throw(SessionNotFound&amp;);

// pass SenderCompID and TargetCompID in as strings
static bool sendToTarget( Message&amp;, const std::string&amp;, const std::string&amp;, const std::string&amp; qualifier = "" )
  throw(SessionNotFound&amp;);
</pre>

    <br/><hr/>
    <h2>Type Safe Messages And Fields</h2>

    <p>Message constructors take in all required fields and adds
    the correct <b>MsgType</b> and <b>BeginString</b> for you. With
    the <b>set</b> method, the compiler will not let you add a
    field that is not a part of a message as defined by the
    spec.</p>
    <pre class='fragment'>
void sendOrderCancelRequest()
{
  FIX41::OrderCancelRequest message(
    FIX::OrigClOrdID("123"),
    FIX::ClOrdID("321"),
    FIX::Symbol("LNUX"),
    FIX::Side(FIX::Side_BUY));

  message.set(FIX::Text("Cancel My Order!"));

  FIX::Session::sendToTarget(message, SenderCompID("TW"), TargetCompID("TARGET"));
}
</pre>

    <br/><hr/>
    <h2>Type Safe Field Only</h2>

    <p>The <b>setField</b> method allows you to add any field to
    any message.</p>See this code in <a href=
    "python/sending_messages_3.html">PYTHON</a>, <a href=
    "ruby/sending_messages_3.html">RUBY</a>
    <pre class='fragment'>
void sendOrderCancelRequest()
{
  FIX::Message message;
  FIX::Header header&amp; = message.getHeader();

  header.setField(FIX::BeginString("FIX.4.2"));
  header.setField(FIX::SenderCompID(TW));
  header.setField(FIX::TargetCompID("TARGET"));
  header.setField(FIX::MsgType(FIX::MsgType_OrderCancelRequest));
  message.setField(FIX::OrigClOrdID("123"));
  message.setField(FIX::ClOrdID("321"));
  message.setField(FIX::Symbol("LNUX"));
  message.setField(FIX::Side(FIX::Side_BUY));
  message.setField(FIX::Text("Cancel My Order!"));

  FIX::Session::sendToTarget(message);
}
</pre>

    <br/><hr/>
    <h2>No Type Safety</h2>

    <p>You can also use <b>setField</b> to pass in
    primitives.</p>See this code in <a href=
    "python/sending_messages_2.html">PYTHON</a>, <a href=
    "ruby/sending_messages_2.html">RUBY</a>
    <pre class='fragment'>
void sendOrderCancelRequest()
{
  FIX::Message message;
  // BeginString
  message.getHeader().setField(8, "FIX.4.2");
  // SenderCompID
  message.getHeader().setField(49, "TW");
  // TargetCompID, with enumeration
  message.getHeader().setField(FIX::FIELD::TargetCompID, "TARGET");
  // MsgType
  message.getHeader().setField(35, 'F');
  // OrigClOrdID
  message.setField(41, "123");
  // ClOrdID
  message.setField(11, "321");
  // Symbol
  message.setField(55, "LNUX");
  // Side, with value enumeration
  message.setField(54, FIX::Side_BUY);
  // Text
  message.setField(58, "Cancel My Order!");

  FIX::Session::sendToTarget(message);
}
</pre>
  </div>
</body>
</html>