Simpact Freeway 1150 Guía de usuario

Simpact, Inc.9210 Sky Park CourtSan Diego, CA 92123 FMP Programmer’s Guide DC 900-1339H June 1998

10 DC 900-1339H FMP Programmer’s Guide

100 DC 900-1339HFMP Programmer’s Guide7. If you have a VMS system, run the move.com command file from the[FREEWAY.CLIENT.TEST.FMP] directory. This mov

5: FMP Link Configuration Using dlicfgDC 900-1339H 101Figure 5–1: DLI and TSI Configuration ProcessApplicationDLITSITransportEnvironment2836dlicfgDLI Te

102 DC 900-1339HFMP Programmer’s Guide5.2 DLI Session ConfigurationThe DLI text configuration file used by the dlicfg program consists of the followingse

5: FMP Link Configuration Using dlicfgDC 900-1339H 103main // DLI “main” section: //{asyncIO = “no”; // Use blocking I/O //tsiCfgName = “fmpaltcfg.bin

104 DC 900-1339HFMP Programmer’s Guidea The msgBlkSize parameter allows the DLI to configure the ICP message buffer size (equivalent to the Set ICP Mes

DC 900-1339H 105AppendixALine Control ProceduresThis appendix defines line control procedures for the FMP package.A.1 DSR Up/Down ReportingIf the data

106 DC 900-1339HFMP Programmer’s GuideA.3 Modem Control LinesTable A–1 lists the EIA-232 modem control lines used by the FMP software.A.4 Clock Signal

A: Line Control ProceduresDC 900-1339H 107Table A–2 defines the EIA-232 clock signals used by the FMP software.A.5 Idle Line ConditionWhen no data is b

108 DC 900-1339HFMP Programmer’s Guide

DC 900-1339H 109AppendixBASCII Translation TablesThe FMP software contains ASCII/EBCDIC, ASCII/Baudot level-5, and ASCII/Baudotlevel-6 translation tab

DC 900-1339H 11 Preface Purpose of Document This document describes the operation and programming interface required to useSimpact’s Financial Market

110 DC 900-1339HFMP Programmer’s GuideTable B–1: ASCII to EBCDIC Translation Table 10123456789ABCDE020452F41705349557744524A4E46434B1545A4C57485950514

B: ASCII Translation TablesDC 900-1339H 111Table B–2: EBCDIC to ASCII Translation Table 10123456789ABCDE0000102039C09867F978D8E0B0C0D0E0F1101112139D85

112 DC 900-1339HFMP Programmer’s GuideTable B–3: ASCII to 6-bit Baudot Translation Table 20123456789ABCDE000000000000000000000000000000000100000000000

B: ASCII Translation TablesDC 900-1339H 113Table B–4: 6-bit Baudot to ASCII Translation Table 20123456789ABCDE020452F41705349557744524A4E46434B1545A4C

114 DC 900-1339HFMP Programmer’s GuideTable B–5: ASCII to 5-bit Baudot Translation Table 30123456789ABCDE000000000000000870000000200080000100000000000

B: ASCII Translation TablesDC 900-1339H 115Table B–6: 5-bit Baudot to ASCII Translation Table 30123456789ABCDE000450B41205349550D44524A4E46434B1545A4C

116 DC 900-1339HFMP Programmer’s Guide

DC 900-1339H 117AppendixCError CodesThere are several methods used by the DLI and FMP software to report errors(Table C–1 lists the FMP errors).1. The

118 DC 900-1339HFMP Programmer’s Guide6. Under certain communication line conditions that cause queued transmissionbuffers to be discarded (such as lo

C: Error CodesDC 900-1339H 1199 –109 DLI_ICP_ERR_XMIT_TIMEOUT The protocol software was unable to trans-mit the data. This error occurs when someor al

12 DC 900-1339H FMP Programmer’s Guide • a Freeway communications server or embedded ICP that runs the communica-tions software • a client computer t

120 DC 900-1339HFMP Programmer’s Guide45 –125 DLI_ICP_ERR_NO_CTRL_SESS No non-Control session is registered for thislink. The operation is not allowed

DC 900-1339H 121AppendixDFMP Loopback Test ProgramNoteIn this document, the term “Freeway” can mean either a Freewayserver or an embedded ICP. For the

122 DC 900-1339HFMP Programmer’s GuideTo run the test program, perform the following steps:1. Make sure the server TSI configuration parameter is corre

D: FMP Loopback Test ProgramDC 900-1339H 123For NT: nmake -f makefile.<op-sys> allwhere <op-sys> is the operating system:ant (for Alpha NT

124 DC 900-1339HFMP Programmer’s Guide5. Boot the Freeway server and load the FMP protocol software onto the ICP (referto the Freeway User’s Guide).6.

D: FMP Loopback Test ProgramDC 900-1339H 125• After you run dlicfg and tsicfg, run the move.com command file which movesthe DLI and TSI binary configura

126 DC 900-1339HFMP Programmer’s Guide

DC 900-1339H 127IndexAAccess modes 32, 34control 33manager 33shared manager 33user 33Acknowledgmentslocal ack 57, 58, 60, 105, 118AddressingInternet 2

128 DC 900-1339HFMP Programmer’s GuideDLI_PROT_CFG_LINK 49DLI_PROT_CLR_STATISTICS 47DLI_PROT_SEND_BIND 50DLI_PROT_SEND_UNBIND 51DLI_PROT_SET_BUF_SIZE

IndexDC 900-1339H 129receive transparent data 60send normal data 58send transparent data 59Data acknowledgement 57, 58, 60, 105, 118Data acknowledgmen

Preface DC 900-1339H 13 General Product Overviews • Freeway 1100 Technical Overview 25-000-0419 • Freeway 2000/4000/8800 Technical Overview 25-000-03

130 DC 900-1339HFMP Programmer’s GuideDLI_ICP_ERR_DSR_UP 105DLI_ICP_ERR_INBUF_OVERFLOW 46DLI_ICP_ERR_LINK_ACTIVE 49, 50, 51DLI_ICP_ERR_LINK_INACTIVE 5

IndexDC 900-1339H 131DLI_PROT_GET_LINK_CFG 54DLI_PROT_GET_SOFTWARE_VER 57DLI_PROT_GET_STATISTICS_REP 54DLI_PROT_GET_STATISTICS_REPORT 54DLI_PROT_GET_S

132 DC 900-1339HFMP Programmer’s Guideoverview 17support 16Programstest 121Protocol option 70Protocol summary of FMP 27QQueue limit option 91RRaw bloc

IndexDC 900-1339H 133see Configuration, TSItsicfg preprocessor program 98UUNIXconfiguration process 98loopback test 121Unstructured asynchronous frame 3

134 DC 900-1339HFMP Programmer’s Guide

FMP Programmer’s GuideDC 900-1339HCustomer Report FormWe are constantly improving our products. If you have suggestions or problems you wouldlike to r

Simpact, Inc.Customer Service9210 Sky Park CourtSan Diego, CA 92123

14 DC 900-1339H FMP Programmer’s Guide Application Program Interface (API) Programming Support •Freeway Data Link Interface Reference Guide DC 900-13

PrefaceDC 900-1339H 15Document ConventionsThis document follows the most significant byte first (MSB) and most significant wordfirst (MSW) conventions for

16 DC 900-1339HFMP Programmer’s GuideCustomer SupportIf you are having trouble with any Simpact product, call us at 1-800-275-3889 Mondaythrough Frida

DC 900-1339H 17Chapter1Introduction1.1 Product OverviewSimpact provides a variety of wide-area network (WAN) connectivity solutions forreal-time financ

18 DC 900-1339HFMP Programmer’s GuideTo maintain high data throughput, Freeway uses a multi-processor architecture to sup-port the LAN and WAN service

1: IntroductionDC 900-1339H 191.1.2 Embedded ICPThe embedded ICP connects your client computer directly to the WAN (for example,using Simpact’s ICP243

Simpact, Inc.9210 Sky Park CourtSan Diego, CA 92123(619) 565-1865FMP Programmer’s Guide© 1994 through 1998 Simpact, Inc. All rights reservedPrinted i

20 DC 900-1339HFMP Programmer’s GuideSummary of product features:• Provision of WAN connectivity either through a LAN-based Freeway server ordirectly

1: IntroductionDC 900-1339H 211.2 Freeway Client-Server EnvironmentThe Freeway server acts as a gateway that connects a client on a local-area network

22 DC 900-1339HFMP Programmer’s Guide1.2.1 Establishing Freeway Server Internet AddressesThe Freeway server must be addressable in order for a client

1: IntroductionDC 900-1339H 231.4.2 Opening a SessionAfter the DLI and TSI configurations are properly defined, your client application usesthe dlOpen f

24 DC 900-1339HFMP Programmer’s GuideEach serial link on the FMP ICP can be configured as a receiver of one of several definedmarket feeds. Each link op

1: IntroductionDC 900-1339H 25exchanged between the client application and Freeway; refer to the Freeway Data LinkInterface Reference Guide. 1.5.2 Har

26 DC 900-1339HFMP Programmer’s Guide

DC 900-1339H 27Chapter2FMP Protocol Summary2.1 Message FormatsAlthough the text message format of each primary market feed is unique, the protocolsuse

28 DC 900-1339HFMP Programmer’s Guide2.1.1 Bisynchronous Market FeedsMost of the U.S. primary feeds use the bisynchronous (BSC) method of transmission

2: FMP Protocol SummaryDC 900-1339H 29an end-of-text (ETX) character. Each text block is followed by a block check character(BCC) that is a redundancy

DC 900-1339H 3 Contents List of Figures 7List of Tables 9Preface 111 Introduction 17 1.1 Product Overview... 171.1.1 Freew

30 DC 900-1339HFMP Programmer’s Guideof frames when the line mode option is set to one of the asynchronous settings (seeChapter 4 for more information

2: FMP Protocol SummaryDC 900-1339H 31An example of an unstructured asynchronous feed is SIAC’s Ticker A feed.2.1.3 Isochronous Market FeedsThe isochr

32 DC 900-1339HFMP Programmer’s Guidegram and the Freeway server or embedded ICP is always in ASCII and is translated bythe FMP software as required.2

2: FMP Protocol SummaryDC 900-1339H 33The valid FMP access modes are defined in Table 2–2. Table 2–3 shows the requiredaccess modes for various FMP op

34 DC 900-1339HFMP Programmer’s GuideTable 2–3: FMP Access Modes for Various OperationsOperation Access Mode Required Reference SectionSet Translation

DC 900-1339H 35Chapter3FMP DLI FunctionsNoteIn this document, the term “Freeway” can mean either a Freewayserver or an embedded ICP. For the embedded

36 DC 900-1339HFMP Programmer’s Guide3.1 Summary of DLI ConceptsThe DLI presents a consistent, high-level, common interface across multiple clients,op

3: FMP DLI FunctionsDC 900-1339H 37• You can specify ICP link parameters in the DLI ASCII configuration file and thenrun the dlicfg preprocessor program

38 DC 900-1339HFMP Programmer’s GuideNoteFor most applications, the FMP protocol requires Raw read andwrite requests to specify protocol-specific infor

3: FMP DLI FunctionsDC 900-1339H 393.1.4 Buffer ManagementCurrently the interrelated Freeway, DLI, TSI and ICP buffers default to a size of 1024bytes.

4 DC 900-1339H FMP Programmer’s Guide 2.1.2 Asynchronous Market Feeds ... 292.1.2.1 Structured Asynchronous Frame ...

40 DC 900-1339HFMP Programmer’s Guide3.2 Example FMP Call SequencesTable 3–1 shows the sequence of DLI function calls to send and receive data usingbl

3: FMP DLI FunctionsDC 900-1339H 41NoteWhen using non-blocking I/O, a dlRead request must always bequeued to avoid loss of data or responses from the

42 DC 900-1339HFMP Programmer’s Guide3.3 Overview of DLI Functions for FMPThis section summarizes the DLI functions used in writing a client applicati

3: FMP DLI FunctionsDC 900-1339H 43Table 3–3: DLI Functions: Syntax and Parameters (Listed in Typical Call Order) DLI Function Parameter(s) Parameter

44 DC 900-1339HFMP Programmer’s Guide3.3.1 DLI Optional ArgumentsSection 3.4 and Section 3.5 describe the dlWrite and dlRead functions for an FMPappli

3: FMP DLI FunctionsDC 900-1339H 453.4 Overview of FMP Requests using dlWriteFor FMP the dlWrite function supports three dlWrite categories: commands,

46 DC 900-1339HFMP Programmer’s GuideDLI_ICP_ERR_INBUF_OVERFLOWInput buffer overflowDLI_ICP_ERR_OUTBUF_OVERFLOWOutput buffer overflow a If you use dlWr

3: FMP DLI FunctionsDC 900-1339H 473.4.1 Commands using Raw dlWriteSection 3.4.1.1 through Section 3.4.1.6 explain how to issue specific commands to th

48 DC 900-1339HFMP Programmer’s GuideAn unsuccessful Clear Statistics command can return the following error code in thedlRead pOptArgs.iICPStatus fie

3: FMP DLI FunctionsDC 900-1339H 49DLI_ICP_ERR_BAD_MODEThe function request is not available for the requestedaccess mode; see Table 2–2 on page 33.DL

Contents DC 900-1339H 5 3.5 Overview of FMP Responses using Raw dlRead ... 603.5.1 Received Data... 603.5.2 Err

50 DC 900-1339HFMP Programmer’s GuideInterface option (Section 4.22 on page 95) is valid only on the Freeway 1000, not theFreeway 2000 or 4000.An unsu

3: FMP DLI FunctionsDC 900-1339H 51link to transmit and receive data according to the current configuration settings. Aftera link starts, data transmis

52 DC 900-1339HFMP Programmer’s Guidefigure the link using the Link Configuration command). The link is restarted again byissuing a Start Link command.

3: FMP DLI FunctionsDC 900-1339H 533.4.2 Information Requests using Raw dlWriteSection 3.4.2.1 through Section 3.4.2.6 explain how to issue specific in

54 DC 900-1339HFMP Programmer’s Guide3.4.2.2 Request Configuration ReportUse the dlWrite function with the pOptArgs.usProtCommand field set toDLI_PROT_G

3: FMP DLI FunctionsDC 900-1339H 553.4.2.4 Request Status ReportUse the dlWrite function with the pOptArgs.usProtCommand field set toDLI_PROT_GET_STATU

56 DC 900-1339HFMP Programmer’s GuideLink status indicates whether the link is on, off, or starting. Starting indicates that a con-nection command was

3: FMP DLI FunctionsDC 900-1339H 573.4.2.6 Request Software Version IDUse the dlWrite function with the pOptArgs.usProtCommand field set toDLI_PROT_GET

58 DC 900-1339HFMP Programmer’s GuideIf the localAck DLI configuration parameter is set to “no” (see the Freeway Data LinkInterface Reference Guide), t

3: FMP DLI FunctionsDC 900-1339H 59To automatically send normal data with EOM, set writeType = “normal” in the DLIconfiguration file (Table 5–1 on page

6 DC 900-1339H FMP Programmer’s Guide 4.13.6 Message Blocking for the Bonneville Feed ... 894.14 Block Checking Option (20)...

60 DC 900-1339HFMP Programmer’s Guide3.5 Overview of FMP Responses using Raw dlReadTable 3–8 shows the valid FMP codes sent to your application in res

3: FMP DLI FunctionsDC 900-1339H 61Table 3–8: FMP Response Codes CategoryDLI Response Code in pOptArgs.usProtCommand Field Usage SectionReceived DataD

62 DC 900-1339HFMP Programmer’s Guidethe most widely used format for BSC type feeds (i.e., feeds from SIAC, OPRA, NAS-DAQ, etc.). When a data block en

3: FMP DLI FunctionsDC 900-1339H 63CautionThe 16-bit header fields are not byte-swapped by the FMP soft-ware. The client application must perform any n

64 DC 900-1339HFMP Programmer’s Guide

DC 900-1339H 65Chapter4FMP Link Configuration OptionsThis chapter describes the various link configuration options that can be defined usingthe DLI config

66 DC 900-1339HFMP Programmer’s GuideTable 4–1: FMP Default Options and Settings Option Number ValueDefault (✓) SettingData Rate 1 0 75 bits/second1 1

4: FMP Link Configuration OptionsDC 900-1339H 67Data Translation 10 0 Disable1 ✓ Table 1 (default is EBCDIC)2 Table 2 (default is Baudot level 6)3 Tabl

68 DC 900-1339HFMP Programmer’s Guide4.1 Data Rate Option (1) The data rate can be set by the client for installations where the FMP software must gen

4: FMP Link Configuration OptionsDC 900-1339H 69Therefore, if FMP is being used to transmit data, the data rate should be set to match,or be slower tha

DC 900-1339H 7 List of Figures Figure 1–1: Freeway Configuration ... 18Figure 1–2: Embedded ICP Configuration ...

70 DC 900-1339HFMP Programmer’s Guide4.2.2 Internal When the internal clock setting is used, the clock signal is generated at the rate specifiedin the

4: FMP Link Configuration OptionsDC 900-1339H 71To set this option using the DLI configuration file, use the protocol parameter; forexample, protocol = “

72 DC 900-1339HFMP Programmer’s Guide4.6.2 EBCDIC/CRC-16When this setting is used, the FMP control sequences are transmitted in 8-bit EBCDICformat, an

4: FMP Link Configuration OptionsDC 900-1339H 73characters. For example, a transmission block size of 512 bytes consists of 510 bytes ofdata plus two c

74 DC 900-1339HFMP Programmer’s GuideIf this option is set to disable, no data translation is performed. In this case, the clientapplication program i

4: FMP Link Configuration OptionsDC 900-1339H 75fit in one buffer. Data packing also helps move data from Freeway to the client moreefficiently over the

76 DC 900-1339HFMP Programmer’s GuideData Message Types: Only data buffers are packed. If a non-data buffer (such as a dataacknowledgment or report) i

4: FMP Link Configuration OptionsDC 900-1339H 77figures show how the three example data blocks shown in Figure 4–6 on page 82 wouldbe received for each

78 DC 900-1339HFMP Programmer’s GuideFigure 4–3: Data Packing Enabled (Message Blocking = Single Records)Figure 4–4: Data Packing Enabled (Message Blo

4: FMP Link Configuration OptionsDC 900-1339H 794.10 Buffer Timer Option (15)This option allows you to control the amount of time the FMP software hold

8 DC 900-1339H FMP Programmer’s Guide

80 DC 900-1339HFMP Programmer’s Guide4.11 Modem Control Option (16) This option determines two things: the operation of the request to send (RTS) outp

4: FMP Link Configuration OptionsDC 900-1339H 814.11.2 DSR and DCD SignalsLine activity ceases when the signal on the DSR pin is lost. With either the

82 DC 900-1339HFMP Programmer’s Guideseparate records also place a BCC for that record after each US character as well as afterthe ETB or ETX.To illus

4: FMP Link Configuration OptionsDC 900-1339H 83To set this option using the DLI configuration file, use the messageBlocking parameter;for example, messa

84 DC 900-1339HFMP Programmer’s GuideThe Raw Blocks option is always used on asynchronous lines (line mode options 2–6).The Raw Blocks option can be u

4: FMP Link Configuration OptionsDC 900-1339H 85Figure 4–9: Message Blocking Example (Data Records)Figure 4–10: User’s Non-transparent Outbound Message

86 DC 900-1339HFMP Programmer’s Guide4.13.3 Single RecordsNoteThe Single Records setting was added for compatibility with olderversions of FMP on embe

4: FMP Link Configuration OptionsDC 900-1339H 874.13.4 Data Records with HeaderOn inbound messages with Message Blocking set to Data Records with Heade

88 DC 900-1339HFMP Programmer’s Guide4.13.5 Raw Blocks with HeaderOn inbound messages with Message Blocking set to Raw Blocks with Header, FMP stripsa

4: FMP Link Configuration OptionsDC 900-1339H 89No header is required on outbound messages. See Figure 4–8 on page 84 for an exampleof transmitted data

DC 900-1339H 9 List of Tables Table 2–1: Messages Duplicated for all Non- Control Sessions on a Link ... 33Table 2–2: FMP Session Access Modes .

90 DC 900-1339HFMP Programmer’s Guide4.14 Block Checking Option (20)This option determines what characters are included in the block check character(B

4: FMP Link Configuration OptionsDC 900-1339H 914.15 Queue Limit Option (21)The queue limit option is used to prevent the ICP message buffer pool from

92 DC 900-1339HFMP Programmer’s Guide4.16 ETB Switch Option (24)The end of text block (ETB) switch option is normally set to disable, and all messageb

4: FMP Link Configuration OptionsDC 900-1339H 93To set this option using the DLI configuration file, use the lineMode parameter; forexample, lineMode = “

94 DC 900-1339HFMP Programmer’s GuideNoteThis option applies only to asynchronous lines.To set this option using the DLI configuration file, use the usr

4: FMP Link Configuration OptionsDC 900-1339H 954.21.2 Example for the Freeway 1000 PlatformThe Freeway PCLK frequency equals 3.6864 x 106 for the Free

96 DC 900-1339HFMP Programmer’s Guide

DC 900-1339H 97Chapter5FMP Link Configuration Using dlicfgNoteIn this document, the term “Freeway” can mean either a Freewayserver or an embedded ICP.

98 DC 900-1339HFMP Programmer’s GuideThe DLI and TSI configuration process is a part of the loopback testing proceduredescribed in Appendix D and the i

5: FMP Link Configuration Using dlicfgDC 900-1339H 99tsicfg TSI-text-configuration-filename [TSI-binary-configuration-filename]VMS example:tsicfg fmpal