Simpact Freeway 1100 Guía de instalación

Simpact, Inc.9210 Sky Park CourtSan Diego, CA 92123 Synchronous Link Control (SLC) Programmer’s Guide DC 900-1564A August 1998

10 DC 900-1564A Synchronous Link Control (SLC) Programmer’s Guide Table 6–1: Link Characteristics Identifier (LCI) on Low-level Networks... 87Tab

100 DC 900-1564ASynchronous Link Control (SLC) Programmer’s GuideConfigurationDLI protocol parameter 18options 38report 47Configuration reportheader for

IndexDC 900-1564A 101dlInit 18dlOpen 18dlRead 18dlWrite 18HHardware supported 15embedded ICP 16Freeway server 16HeaderICP header fields 61protocol head

102 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guideserver header 61Network connection, definition 14Network control 30Network-level suppo

IndexDC 900-1564A 103Revision history 14SSafe store acknowledgment 41AML descriptors 79header format 78Safe store support 23Sendblock 29message 28Sequ

104 DC 900-1564ASynchronous Link Control (SLC) Programmer’s GuideSLC network connection 14Trace access mode 33Trace category 53link trace data 53heade

Synchronous Link Control (SLC) Programmer’s GuideDC 900-1564ACustomer Report FormWe are constantly improving our products. If you have suggestions or

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

DC 900-1564A 11 Preface Purpose of Document This document describes the operation and programming interface required to useSimpact’s Synchronous Link

12 DC 900-1564A Synchronous Link Control (SLC) Programmer’s Guide Chapter 5 is the SLC protocol reference providing specific header formats for all SL

Preface DC 900-1564A 13 Other References • Systems and Communications Reference Volume 1, Airline Proprietary Standards,Version 1.1, published by th

14 DC 900-1564A Synchronous Link Control (SLC) Programmer’s Guide The term “SLC channel” refers to an ICP link configured on an SLC network connec-tio

DC 900-1564A 15Chapter 1 Introduction Simpact provides a variety of user-programmable, wide-area network (WAN) connec-tivity solutions for real-time

16 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide1.2.1 Freeway ServerThe Freeway server is a stand-alone box with pre-installed ICPs. I

1: IntroductionDC 900-1564A 171.2.2.1 Windows NT (Intel or Alpha)The two supported programming interfaces for an embedded ICP in a Windows NTclient co

18 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide1.2.2.3 Digital UNIXThe supported programming interface for an embedded ICP in a Digit

1: IntroductionDC 900-1564A 19• An example SLC test program and supporting DLI and TSI configuration files areprovided with the SLC product, as listed b

Simpact, Inc.9210 Sky Park CourtSan Diego, CA 92123(619) 565-1865Synchronous Link Control (SLC) Programmer’s Guide© 1998 Simpact, Inc. All rights res

20 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide

DC 900-1564A 21Chapter2SLC Protocol Theory of OperationSimpact’s SLC protocol software running on the ICP provides the application with sig-nificant co

22 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide2.2.1 Network-level SupportWhen the application configures an ICP link for SLC protocol

2: SLC Protocol Theory of OperationDC 900-1564A 23An application can restrict the ICP to block-level retransmissions by setting the maxi-mum number of

24 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide

DC 900-1564A 25Chapter3Typical Sequence of Operations3.1 InitializationSection 1.3 on page 18 summarizes the programming interfaces available for use

26 DC 900-1564ASynchronous Link Control (SLC) Programmer’s GuideFigure 3–1: Typical Commands and ResponsesAttach Link ResponseCommandResponseAttach a

3: Typical Sequence of OperationsDC 900-1564A 273.2 Attaching a LinkThe application must successfully attach an ICP link before it can configure, bind,

28 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guideured for SLC envelope service (default), then binding a link places it online for SLCb

3: Typical Sequence of OperationsDC 900-1564A 29• The application writes a DLI_PROT_SAFE_STORE_ACK command that confirmsreceipt. Some restrictions migh

DC 900-1564A 3 Contents List of Figures 7List of Tables 9Preface 111 Introduction 15 1.1 Protocol Overview... 151.2 Sup

30 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide• The application writes a DLI_PROT_CONTROL command. There is no acknowledg-ment; howe

3: Typical Sequence of OperationsDC 900-1564A 31DLI_PROT_GET_BUF_REPORTDLI_PROT_GET_LINK_CFGDLI_PROT_GET_SOFTWARE_VERDLI_PROT_GET_STATISTICS_REPORTDLI

32 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide

DC 900-1564A 33Chapter4Commands and ResponsesThis chapter describes the commands written to the ICP and the responses receivedfrom the ICP. After you

34 DC 900-1564ASynchronous Link Control (SLC) Programmer’s GuideTable 4–2: Command and Response Category Summary CategoryCode andDescription Reference

4: Commands and ResponsesDC 900-1564A 354.1 Access CategoryThe commands and responses in the Access category are used to establish access controlsessi

36 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide4.2 Link CategoryThe commands and responses in the Link category are used to enable, d

4: Commands and ResponsesDC 900-1564A 37The variable-length data area of the DLI_PROT_CFG_LINK command contains a specifica-tion list of one or more co

38 DC 900-1564ASynchronous Link Control (SLC) Programmer’s GuideTable 4–3: SLC Configuration Options Option Default Option Values CommentsSLC_SERVICE_

4: Commands and ResponsesDC 900-1564A 39a International Air Transport Association (IATA) — see the document reference on page 13 of the Preface.SLC_N1

4 DC 900-1564A Synchronous Link Control (SLC) Programmer’s Guide 2.2.6 Flow Control Support ... 23 3 Typical Sequence of Ope

40 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide4.2.4 Control DLI_PROT_CONTROL can be used only when SLC protocol service is configure

4: Commands and ResponsesDC 900-1564A 414.3 Data CategoryThe commands and responses in the Data category are used to transfer data on thespecified SLC

42 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide4.3.2 Normal DataDLI_PROT_SEND_NORM_DATA can be used only when SLC protocol service is

4: Commands and ResponsesDC 900-1564A 43Table 5–16 on page 75 lists symbolic names for the DLI_PROT_SEND_NORM_DATA AML val-ues that can appear in the

44 DC 900-1564ASynchronous Link Control (SLC) Programmer’s GuideWhen the application writes a DLI_PROT_SEND_PRIOR_DATA command, the ICP uses theiProtM

4: Commands and ResponsesDC 900-1564A 454.3.4 Transparent DataDLI_PROT_SEND_TRANS_DATA can be used only when SLC envelope service is configured.It can

46 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide4.4 Report CategoryThe Report category is used to request specific reports from the ICP

4: Commands and ResponsesDC 900-1564A 474.4.2 Get Link ConfigurationThe DLI_PROT_GET_LINK_CFG command requests the current configuration of a speci-fied

48 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guidethe “C” structure format shown in Figure 4–2, where “UINT32” is a 32-bit unsigned inte

4: Commands and ResponsesDC 900-1564A 49typedef struct slc_port_counts_struct{UINT32 change_cts;UINT32 change_dcd;UINT32 change_dsr;UINT32 change_dtr;

Contents DC 900-1564A 5 4.4.4 Get Statistics Report ... 474.4.5 Get Status Report... 514.5 Trac

50 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guidetypedef struct slc_lsi_counts_struct{UINT32 ack;UINT32 nak_parity_bcc;UINT32

4: Commands and ResponsesDC 900-1564A 514.4.5 Get Status ReportThe DLI_PROT_GET_STATUS_REPORT command requests operational status for a specifiedSLC ne

52 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guidetypedef struct slc_msg_status_struct{UINT16 aml; /* See Table 5–16 and Table 5–18 *

4: Commands and ResponsesDC 900-1564A 534.5 Trace Category4.5.1 Link Trace DataThe DLI_PROT_LINK_TRACE_DATA response contains one or more trace report

54 DC 900-1564ASynchronous Link Control (SLC) Programmer’s GuideFigure 4–13 shows how to run the slc_trac trace program from the command-lineprompt on

4: Commands and ResponsesDC 900-1564A 55 TIME-STAMP EVENT STATUS 1240.705 TRACE ON 1240.805 DTR_1 ON 1241.005 DCD_1 ON 1241.005 DSR_1 ON

56 DC 900-1564ASynchronous Link Control (SLC) Programmer’s GuideTIME-STAMP EVENT STATUS 1289.710 TRACE ON 1289.810 DTR_1 ON 1290.010 DCD_1 ON

DC 900-1564A 57Chapter5Header FormatsThe application and the SLC protocol software on the ICP communicate by sendingcommands and responses. This chapt

58 DC 900-1564ASynchronous Link Control (SLC) Programmer’s GuideTable 5–1: Command and Response Category Summary Category Code and Header Format Refer

5: Header FormatsDC 900-1564A 59typedef struct _DLI_OPT_ARGS{unsigned short usFWPacketType; /* Server’s packet type */unsigned short usFWCommand; /*

6 DC 900-1564A Synchronous Link Control (SLC) Programmer’s Guide 6.4.3.3 High-level Designators (HEX and HEN) ... 906.4.3.4 Message Chara

60 DC 900-1564ASynchronous Link Control (SLC) Programmer’s GuideNoteThe usICPCount field in the ICP header is unique to non-DLI calls.It is not used in

5: Header FormatsDC 900-1564A 61a For non-DLI calls, ICP Header fields must be network byte-order, and Protocol Header fields must be client byte orde

62 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide5.1 Attach (All Access Modes)Table 5–3 shows the DLI_ICP_CMD_ATTACH header format. See

5: Header FormatsDC 900-1564A 635.2 Bind (Master or Control Access Mode Only)Table 5–4 shows the DLI_ICP_CMD_BIND header format. See Section 4.2.1 on

64 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide5.3 Configure Link (Master or Control Access Mode Only)Table 5–5 shows the DLI_PROT_CFG

5: Header FormatsDC 900-1564A 655.4 Control (Master or Control Access Mode Only)Table 5–6 shows the DLI_PROT_CONTROL header format. See Section 4.2.4

66 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guidea For the SLC_OPR_SEND* write codes and the SLC_FLOW* read codes, the iProtModifier fi

5: Header FormatsDC 900-1564A 675.5 Detach (Master, Reader, Control or Trace Access Mode)Table 5–8 shows the DLI_ICP_CMD_DETACH header format. See Sec

68 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide5.6 Get Buffer Report (Master, Reader, or Control Access Mode)Table 5–9 is the DLI_PRO

5: Header FormatsDC 900-1564A 695.7 Get Link Configuration (Master, Reader, or Control Access Mode)Table 5–10 is the DLI_PROT_GET_LINK_CFG header forma

DC 900-1564A 7 List of Figures Figure 1–1: Freeway Configuration ... 16Figure 1–2: Embedded ICP Configuration ...

70 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide5.8 Get Software Version (Master, Reader, or Control Mode)Table 5–11 shows the DLI_PRO

5: Header FormatsDC 900-1564A 715.9 Get Statistics Report (Master, Reader, or Control Mode)Table 5–11 shows the DLI_PROT_GET_STATISTICS_REPORT header

72 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide5.10 Get Status Report (Master, Reader, or Control Mode)Table 5–13 is the DLI_PROT_GET

5: Header FormatsDC 900-1564A 735.11 Link Trace Data (Trace Access Mode Only)Table 5–14 shows the read-only DLI_PROT_LINK_TRACE_DATA header format. Se

74 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide5.12 Normal Data (Master Access Mode Only)Table 5–15 shows the DLI_PROT_SEND_NORM_DATA

5: Header FormatsDC 900-1564A 75Table 5–16:DLI_PROT_SEND_NORM_DATA AML ValuesAML Symbolic Name Acknowledge Message Label DescriptionSLC_AML_A_ND Norma

76 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide5.13 Priority Data (Master Access Mode Only)Table 5–17 shows the DLI_PROT_SEND_PRIOR_D

5: Header FormatsDC 900-1564A 77Table 5–18:DLI_PROT_SEND_PRIOR_DATA AML ValuesAML Symbolic Name Acknowledge Message Label DescriptionSLC_AML_A_PD Prio

78 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide5.14 Safe Store Acknowledgment (Master Access Mode Only)Table 5–19 shows the DLI_PROT_

5: Header FormatsDC 900-1564A 79Table 5–20:DLI_PROT_SAFE_STORE_ACK AML DescriptorsBit Field Mask Name Bit Field ValuesAMD_MASK_PROTECTION AMD_FULL_PRO

8 DC 900-1564A Synchronous Link Control (SLC) Programmer’s Guide

80 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide5.15 Transparent Data (Master Access Mode Only)Table 5–21 shows the DLI_PROT_SEND_TRAN

5: Header FormatsDC 900-1564A 815.16 Unbind (Master or Control Access Mode Only)Table 5–22 shows the DLI_ICP_CMD_UNBIND header format. See Section 4.2

82 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide

DC 900-1564A 83Chapter6Programming ConsiderationsThis chapter describes recommended strategies for programming applications to accessSLC network conne

84 DC 900-1564ASynchronous Link Control (SLC) Programmer’s GuideSince the SLC protocol software supports multiple access modes simultaneously, thedesi

6: Programming ConsiderationsDC 900-1564A 85refer to the International Air Transport Association (IATA) document referenced onpage 13 of the Preface.6

86 DC 900-1564ASynchronous Link Control (SLC) Programmer’s GuideDLI_PROT_SEND_PRIOR_DATA command allows iProtModifier field values ofSLC_AML_A_PD thro

6: Programming ConsiderationsDC 900-1564A 876.4.2.2 Link Characteristics Identifier (LCI)The link characteristics identifier field is required in each SL

88 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide6.4.3 SSSSLLLLCCCC____HHHHIIIIGGGGHHHH____LLLLEEEEVVVVEEEELLLL____NNNNEEEETTTTWWWWOOOO

6: Programming ConsiderationsDC 900-1564A 89DLI_PROT_SAFE_STORE_ACK command causes the SLC protocol service to determinewhether to transmit a Link Con

DC 900-1564A 9 List of Tables Table 4–1: Access Modes... 33Table 4–2: Command and Response Category Summary ...

90 DC 900-1564ASynchronous Link Control (SLC) Programmer’s GuideDLI_PROT_SEND_PRIOR_DATA command or response. Table 6–3 shows the internal for-mat o

6: Programming ConsiderationsDC 900-1564A 916.4.3.4 Message Characteristics Identifier (MCI)The message characteristics identifier field is required in e

92 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide6.4.3.5 Additional Characteristics Indicator (ACI) The additional characteristics indi

6: Programming ConsiderationsDC 900-1564A 936.5 Error Conditions6.5.1 iICPStatus Field CodesThe iICPStatus field serves two purposes. When the client

94 DC 900-1564ASynchronous Link Control (SLC) Programmer’s GuideSLC_ERR_AML_DUPLICATE Transmission of a previous message for the same Acknowledge Mess

6: Programming ConsiderationsDC 900-1564A 95SLC_ERR_LCI_HLD_MISSINGorSLC_ERR_LCI_HLD_PRESENT In the required Link Characteristics Identifier field, the

96 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide6.5.2 Receive Error StatisticsNote that in order to minimize non-productive reports of

DC 900-1564A 97AppendixAInclude FilesTable A–1 summarizes the include files normally required by application programs forinclusion of the definitions of

98 DC 900-1564ASynchronous Link Control (SLC) Programmer’s Guide

DC 900-1564A 99IndexAAccess category 35attach 35header format 62detach 35header format 67summary 34, 58Access modes 33application simplification 83sess