Simpact Freeway 1200 Guide de l'utilisateur

Simpact, Inc.9210 Sky Park CourtSan Diego, CA 92123 BSCTRAN Programmer’s Guide DC 900-1406E March 1999

10 DC 900-1406E BSCTRAN Programmer’s Guide • A Freeway communications server or an embedded ICP that runs the BSC com-munications software • VAX/VMS

100 DC 900-1406EBSCTRAN Programmer’s Guide

DC 900-1406E 101Chapter6CautionsThe following is a list of cautions that users of the BSC File Transfer program shouldheed.• The default size is 1024

102 DC 900-1406EBSCTRAN Programmer’s Guide• When transmitting 3780 executable-image files between VMS or UNIX sites, usethe commands SEND /TRANS /BINAR

DC 900-1406E 103Chapter7Example BSCTRAN UsageNoteIn this document, the term “Freeway” can mean either a Freewayserver or an embedded ICP. For the embe

104 DC 900-1406EBSCTRAN Programmer’s Guide7.1 DLI Configuration File ExampleFigure 7–1 is an example of a DLI configuration file that defines several sess

7: Example BSCTRAN UsageDC 900-1406E 105//------------------------------------------------------------------//// Define 16 port names for Freeway 0, I

106 DC 900-1406EBSCTRAN Programmer’s GuideFWY0B0L3{ Protocol = "RAW"; // RAW session type // Transport = &qu

7: Example BSCTRAN UsageDC 900-1406E 1077.2 TSI Configuration File Example (Freeway Server Only)Figure 7–2 is an example of a TSI configuration file that

108 DC 900-1406EBSCTRAN Programmer’s Guide//----------------------------------------------------------------------------//// bsc0: TCP socket interfac

7: Example BSCTRAN UsageDC 900-1406E 1097.3 Command Procedure ExampleThe VMS DCL command procedure shown in Figure 7–3 demonstrates most of thecomman

Preface DC 900-1406E 11 Simpact References The following documents provide useful supporting information, depending on thecustomer’s particular hardw

110 DC 900-1406EBSCTRAN Programmer’s Guide$ ! Set up to catch fatal errors if BSCTRAN has to abort.$ ON ERROR THEN GOTO END$ ! Set to echo the BSCT

7: Example BSCTRAN UsageDC 900-1406E 111SET 2 /STOP ! Disable to reconfigure link to sendSET 3 /STOP ! transparent data!SET 2 /PAR10=0/PAR19=0 ! Turn

112 DC 900-1406EBSCTRAN Programmer’s Guide

DC 900-1406E 113IndexAAbortBSCTRAN 35, 40, 41, 45, 95, 97, 98Audience 9BBinary data 41, 45, 46CCaution (BSCTRAN)binary data 42, 45ICP message buffer 3

114 DC 900-1406EBSCTRAN Programmer’s GuideDDCL command procedureexample 109DLI configuration fileexample 104Documentsreference 11Download ICP 28EErrorco

IndexDC 900-1406E 115BSCWRIT 87ProductprogramsBSCTRAN 15support 14QQueueVMS system batch 34VMS system printer 34RRecordattributes 48concatenation 42,

116 DC 900-1406EBSCTRAN Programmer’s Guide

BSCTRAN Programmer’s GuideDC 900-1406ECustomer Report FormWe are constantly improving our products. If you have suggestions or problems you wouldlike

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

12 DC 900-1406E BSCTRAN Programmer’s Guide Embedded ICP Installation and Programming Support • ICP2432 User’s Guide for Digital UNIX DC 900-1513 • IC

PrefaceDC 900-1406E 13Document ConventionsThe term “Freeway” refers to any of the Freeway server models (for example, Freeway1100/1150/1200/1300, Free

14 DC 900-1406EBSCTRAN Programmer’s GuideCustomer SupportIf you are having trouble with any Simpact product, call us at 1-800-275-3889 Mondaythrough F

DC 900-1406E 15Chapter1BSCTRAN File Transfer Program OverviewNoteIn this document, the term “Freeway” can mean either a Freewayserver or an embedded I

16 DC 900-1406EBSCTRAN Programmer’s Guide1.1 Freeway Server versus Embedded ICP VersionThe Freeway server version of BSCTRAN uses the Freeway data lin

1: BSCTRAN File Transfer Program OverviewDC 900-1406E 17The five modules are as follows:1. User-interactive or Batch Program (BSCTRAN)2. File Transfer

18 DC 900-1406EBSCTRAN Programmer’s Guide

DC 900-1406E 19Chapter2BSCTRAN Commands and OptionsNoteIn this document, the term “Freeway” can mean either a Freewayserver or an embedded ICP. For th

Simpact, Inc.9210 Sky Park CourtSan Diego, CA 92123(619) 565-1865BSCTRAN Programmer’s Guide© 1994 through 1999 Simpact, Inc. All rights reservedPrint

20 DC 900-1406EBSCTRAN Programmer’s GuideRECEIVEReceive a file from a remote BSC station.EXITTerminate processing.Comments are allowed on the BSCTRAN c

2: BSCTRAN Commands and OptionsDC 900-1406E 212.1.1 Server Field in BSCTRAN CommandsMany of the BSCTRAN commands include a server parameter. Note that

22 DC 900-1406EBSCTRAN Programmer’s GuideFor a detailed view of a sample Freeway server dlitrancfg file, refer to Section 7.1 onpage 104. Note how in o

2: BSCTRAN Commands and OptionsDC 900-1406E 23NoteBSCTRAN is designed to have sessions active on only one ICP at atime. When you use any command to ac

24 DC 900-1406EBSCTRAN Programmer’s Guide2.1.3 Important Considerations for Freeway ServerNote the following important considerations before using BSC

2: BSCTRAN Commands and OptionsDC 900-1406E 252.1.4 BSCTRAN Logging2.1.4.1 VMS Logical Names and LoggingBSCTRAN supports the use of VMS logical names

26 DC 900-1406EBSCTRAN Programmer’s Guide2.2 HELP CommandThe HELP command displays the format for all legal BSCTRAN commands. It takes noargument. Fig

2: BSCTRAN Commands and OptionsDC 900-1406E 27NoteThe server parameter is not the server name, but is a pointer tothe server name. It is important tha

28 DC 900-1406EBSCTRAN Programmer’s Guide2.3 SHOW CommandThe SHOW command has the following format:SHOW link# server[_ICP#] [/DEFAULT] [/STATS] [/CLEA

2: BSCTRAN Commands and OptionsDC 900-1406E 29See the BSC Programmer’s Guide for a complete description of ICP link configurationparameters.The SHOW co

DC 900-1406E 3 Contents Contents 3List of Figures 5List of Tables 7Preface 91 BSCTRAN File Transfer Program Overview 15 1.1 Freeway Server versus Emb

30 DC 900-1406EBSCTRAN Programmer’s GuideBSC> SHOW 2 spot_1 /STATS /CLEAR ! Statistics before clearingCURRENT STATISTICS FOR LINK #2:Recv data mess

2: BSCTRAN Commands and OptionsDC 900-1406E 312.4 SET CommandThe SET command has the following format:SET link# server[_ICP#] [/PARn[=d]] [/PARn[=d]..

32 DC 900-1406EBSCTRAN Programmer’s GuideCautionBe aware of the implications of using the SET /LOCKSTART com-mand. After a link is enabled with /LOCKS

2: BSCTRAN Commands and OptionsDC 900-1406E 332.5 DEFAULT CommandThe DEFAULT command has the following format:DEFAULT [/FILE=filename] [/F

34 DC 900-1406EBSCTRAN Programmer’s Guide/[NO]PRINT If this VMS option is enabled, each received file will be auto-matically queued to the system print

2: BSCTRAN Commands and OptionsDC 900-1406E 35/[NO]DLOG If this option is enabled, all errors, warnings, and transmissionstatistics will be logged to

36 DC 900-1406EBSCTRAN Programmer’s GuideThe abort is performed at the BSCFTI level so that users writ-ing their own applications can control this opt

2: BSCTRAN Commands and OptionsDC 900-1406E 37To send transparent 2780 records, BSCTRAN prefixes eachrecord with the count. Records are accumulated int

38 DC 900-1406EBSCTRAN Programmer’s GuideCautions:1. The default ICP message buffer size for BSCTRAN is 1024 bytes. When theBSCTRAN program is run, it

2: BSCTRAN Commands and OptionsDC 900-1406E 392.6 DIAL CommandThe DIAL command has the following format:DIAL link# server[_ICP#] [/STRING=s] [/CONFIG=

4 DC 900-1406E BSCTRAN Programmer’s Guide 3 File Transfer Interface (BSCFTI) 51 3.1 BSCDFAULT Procedure ... 523.2 BSCDIAL Pro

40 DC 900-1406EBSCTRAN Programmer’s Guide/DTIME=h:m:s This option is the timeout specification (default time is 1minute). This is the maximum time that

2: BSCTRAN Commands and OptionsDC 900-1406E 412.7 SEND CommandThe SEND command has the following format:SEND filename link# server[_ICP#] [/DTIME=h:m:

42 DC 900-1406EBSCTRAN Programmer’s GuideCautionIf the user needs to ensure that binary data records (sent withoutthe /TRANS option) are not concatena

2: BSCTRAN Commands and OptionsDC 900-1406E 433. Refer to the BSC Programmer’s Guide for information regarding the relationshipbetween transparent dat

44 DC 900-1406EBSCTRAN Programmer’s Guide2.8 RECEIVE CommandThe RECEIVE command has the following format:RECEIVE filename link# server[_ICP#] [/DTIME=

2: BSCTRAN Commands and OptionsDC 900-1406E 45The BSC File Transfer program displays the state changes of the file transfer with thefollowing statement

46 DC 900-1406EBSCTRAN Programmer’s Guide/FIXED This option specifies that the file is opened with fixed-lengthrecord format, where the length is determi

2: BSCTRAN Commands and OptionsDC 900-1406E 47/ESCAPE If this option is specified, the BSC File Transfer program looksfor a two-character forms-control

48 DC 900-1406EBSCTRAN Programmer’s Guidea /FIXED takes precedence over /BINARY for record format.b VFC record format = variable with fixed-length cont

2: BSCTRAN Commands and OptionsDC 900-1406E 492.9 EXIT CommandThe EXIT command has the following format:EXITThe EXIT command causes the BSC File Trans

DC 900-1406E 5 List of Figures Figure 2–1: Example BSCTRAN Commands and Resulting Data Paths... 23Figure 2–2: Example of the HELP Command ...

50 DC 900-1406EBSCTRAN Programmer’s Guide

DC 900-1406E 51Chapter3File Transfer Interface (BSCFTI)NoteIn this document, the term “Freeway” can mean either a Freewayserver or an embedded ICP. Fo

52 DC 900-1406EBSCTRAN Programmer’s Guide3.1 BSCDFAULT ProcedureCalling SequenceBSCDFAULT (fname, fixed, binary, fortran, escape, recl, bufsize, pri

3: File Transfer Interface (BSCFTI)DC 900-1406E 53record separator characters, but by recl length only. A non-zero valueis treated as true.fortran Thi

54 DC 900-1406EBSCTRAN Programmer’s GuideOPER1 through OPER12). Log messages will be output to the opera-tor console. A zero value will disable operat

3: File Transfer Interface (BSCFTI)DC 900-1406E 553.2 BSCDIAL Procedure Calling SequenceReturnCode = BSCDIAL (lnum, server, dial, config, dtime, re

56 DC 900-1406EBSCTRAN Programmer’s Guideserver This is a pointer to a descriptor. It is a character string containing theserver name. An ICP board nu

3: File Transfer Interface (BSCFTI)DC 900-1406E 573.3 BSCLOG ProcedureCalling SequenceBSCLOG (lnum, display, message)Procedures CalledNoneFunctions1.

58 DC 900-1406EBSCTRAN Programmer’s Guide3.4 BSCRECV ProcedureCalling SequenceReturnCode = BSCRECV (fname, lnum, server, dtime, fixed, recl, binary

3: File Transfer Interface (BSCFTI)DC 900-1406E 59lnum This is a pointer to an integer. It is a longword containing the linknumber.server This is a po

6 DC 900-1406E BSCTRAN Programmer’s Guide

60 DC 900-1406EBSCTRAN Programmer’s GuideReturn Codes See Table 5–2 on page 95 for full descriptions of the error return codes.Success RCOKFailure RCI

3: File Transfer Interface (BSCFTI)DC 900-1406E 613.5 BSCSAFE ProcedureCalling SequenceReturnCode = BSCSAFE (lnum, code)Procedures CalledBSCRESET and

62 DC 900-1406EBSCTRAN Programmer’s Guide3.6 BSCSEND ProcedureCalling SequenceReturnCode = BSCSEND (fname, lnum, server, dtime, trans, binary, card

3: File Transfer Interface (BSCFTI)DC 900-1406E 637. Closes the file.8. Logs the transmission statistics.Argumentsfname This is a pointer to a descript

64 DC 900-1406EBSCTRAN Programmer’s Guidenoteof This is a pointer to an integer. It is a longword containing the noteofindicator. If the flag is true,

3: File Transfer Interface (BSCFTI)DC 900-1406E 653.7 BSCSET ProcedureCalling SequenceReturnCode = BSCSET (lnum, server, lconf, start)Procedures Calle

66 DC 900-1406EBSCTRAN Programmer’s Guidethat follows. For link configuration, the data block consists of a vari-able number of two-word configuration p

3: File Transfer Interface (BSCFTI)DC 900-1406E 673.8 BSCSHOW ProcedureCalling SequenceReturnCode = BSCSHOW (lnum, server, lconfig, clear_stats)Proced

68 DC 900-1406EBSCTRAN Programmer’s Guidelconfig This is a pointer to a data structure to receive link configuration/sta-tus. The data structure is defin

3: File Transfer Interface (BSCFTI)DC 900-1406E 69Return Codes See Table 5–2 on page 95 for full descriptions of the error return codes.Success RCOKFa

DC 900-1406E 7 List of Tables Table 2–1: SHOW Command Output ... 28Table 2–2: RECEIVE File Open Options...

70 DC 900-1406EBSCTRAN Programmer’s Guide3.9 Example ProgramsThe following BASIC example program calls BSCSEND:10 %TITLE ‘SEND’20 external long FUNCTI

3: File Transfer Interface (BSCFTI)DC 900-1406E 71The following FORTRAN example program calls BSCRECV (the SYS$ASCTIM callapplies to VMS only.):progra

72 DC 900-1406EBSCTRAN Programmer’s Guide!------------------------------------------------------------------! START OF CODE!-------------------------

DC 900-1406E 73Chapter4Record Transfer Interface (BSCRTI)NoteIn this document, the term “Freeway” can mean either a Freewayserver or an embedded ICP.

74 DC 900-1406EBSCTRAN Programmer’s Guide4.1 BSCASL ProcedureThis procedure must be executed before records can be read from or written to the ICP.It

4: Record Transfer Interface (BSCRTI)DC 900-1406E 75name with an underscore character; otherwise, the ICP board num-ber is assumed to be 0. The maximu

76 DC 900-1406EBSCTRAN Programmer’s Guide4.2 BSCDAS ProcedureThis procedure should be executed before calling BSCASL to change the link number,ICP num

4: Record Transfer Interface (BSCRTI)DC 900-1406E 774.3 BSCMODEM ProcedureThis procedure can be called only after the ICP has been assigned (see the B

78 DC 900-1406EBSCTRAN Programmer’s Guidedtime This is a pointer to a descriptor. It is a character string containing thetimeout value in the followin

4: Record Transfer Interface (BSCRTI)DC 900-1406E 794.4 BSCREAD ProcedureThis procedure can be called only after the server, ICP, and link number have

8 DC 900-1406E BSCTRAN Programmer’s Guide

80 DC 900-1406EBSCTRAN Programmer’s GuideArgumentsrdblock This is a pointer to a data structure of type TRANBUF. It receives thedata block from the IC

4: Record Transfer Interface (BSCRTI)DC 900-1406E 81are not deblocked using record separator characters, but by the lengthof the ICP read block or rec

82 DC 900-1406EBSCTRAN Programmer’s GuideCautionThe RCUNR return code from BSCREAD is treated as a non-fatalerror. User applications that call this pr

4: Record Transfer Interface (BSCRTI)DC 900-1406E 83 /* Write the record in rd_recbuf to the receive file. */ } while (!lastrec); /* las

84 DC 900-1406EBSCTRAN Programmer’s Guide4.5 BSCRESET ProcedureThis procedure is called when any error occurs that prevents the file transfer operation

4: Record Transfer Interface (BSCRTI)DC 900-1406E 854.6 BSCTRACE ProcedureThis procedure can be called only after the ICP has been assigned (see the B

86 DC 900-1406EBSCTRAN Programmer’s Guidedtime This is a pointer to a descriptor. It is a character string containing thetimeout value in the followin

4: Record Transfer Interface (BSCRTI)DC 900-1406E 874.7 BSCWRIT ProcedureThis procedure can be called only after the ICP has been assigned (see the BS

88 DC 900-1406EBSCTRAN Programmer’s GuideArgumentsrdblock This is a pointer to a data structure of type TRANBUF. It receives thedata acknowledgment bl

4: Record Transfer Interface (BSCRTI)DC 900-1406E 89dtime This is a pointer to a descriptor. It is a character string containing thetimeout value in t

DC 900-1406E 9 Preface Purpose of Document This document describes the operation and programming interface required to useSimpact’s BSCTRAN product r

90 DC 900-1406EBSCTRAN Programmer’s Guide/* Use common rdblock for BSCWRIT and BSCREAD */TRANBUF rdblock; /* rdblock for

4: Record Transfer Interface (BSCRTI)DC 900-1406E 914.8 ICP Read BlockThe ICP Read Block is a data structure used by the BSC File Transfer program to

92 DC 900-1406EBSCTRAN Programmer’s Guide

DC 900-1406E 93Chapter5Error HandlingThe BSC File Transfer program handles the following three categories of errors:• Errors returned by the various l

94 DC 900-1406EBSCTRAN Programmer’s GuideTable 5–1: Warnings Output by BSC File Transfer ProgramWarning Message Specified AreaLink is stopped Link numb

5: Error HandlingDC 900-1406E 95 Table 5–2: Error Return Codes Used by BSC File Transfer Program (defined in the BSCTRAN.INC include file)MnemonicValue

96 DC 900-1406EBSCTRAN Programmer’s Guidea Refer to the SET /START command in Section 2.4 on page 31.b If this error occurs during SEND or RECEIVE and

5: Error HandlingDC 900-1406E 975.2 BSC ICP ErrorsTable 5–3 describes the possible errors returned from the ICP and how each is handledin SEND and REC

98 DC 900-1406EBSCTRAN Programmer’s Guidea Depending on current setting of DEFAULT /ABORT option.b Depending on current setting of DEFAULT /DELETE opt

5: Error HandlingDC 900-1406E 995.3 Unexpected Responses from the ICPUnexpected responses from the ICP can be in the form of data, status, or control