SDISC Assembler Call - NetEx

More documents

Recommendations

Info

used so that it may remain an “in progress” flag for the 16 bit machines. The error codes are listed and describedin 205.Common Error Recovery ProceduresThe following are commonly encountered errors with an explanation of how to recover from them:• Other program not there - Operators or users must coordinate the running of the two NETEX programs sothat one has not timed-out before the other has had a chance to establish a session.• Other program busy - Retry NETEX after a suitable delay.• NETEX requests out of sequence - Sessions must be completely established before write or read requestscan be issued. Sessions are established using the offer, connect, and confirm requests in that orderCode ConversionNETEX provides for common types of code conversion by using StorageTek hardware or NETEX softwarefacilities. The calling program uses the datamode (NRBDMODE) word of the NRB to specify either manualor automatic code conversion.If manual conversion is selected, the caller completely specifies which assembly/disassembly and code conversionfunctions will be used on both adapter output and adapter input. The caller must determine whichassembly/disassembly modes and code conversion tables are significant to the adapters.If automatic code conversion is selected, the caller simply specifies the source character set and the destinationcharacter set. NETEX then uses any code conversion hardware that is available, and carries out othercode conversion using software when necessary.Page 24 Intertask Communication MAN-REF-H307IP-04
NETEX Request BlockThe NETEX Request Block (NRB) is a block of parameters used to pass information between calling programsand NETEX. The NRB is the means by which programs and NETEX communicate with one another.The NRB is created by a calling program and may be updated by the program to pass information to NETEX,or NETEX may update the NRB to pass information to a program.Each time a program makes a request to NETEX, the program specifies an NRB to be associated with the request.NETEX passes status information about that request back to the program by way of the NRB. Therefore,only one NETEX request may use an NRB at one time. If concurrent read and write requests are used,or if a server program will be connected to more than one program at a time, several NRBs must be used.The use of the NRB fields vary slightly between the different levels of programmer interface. Specific differencesare described in the individual field descriptions that follow.Rules for NRB UseThe following principles are designed to make high level language use of NETEX somewhat transportablebetween machines.• Before initiating a connection, the user must clear the NRB, including the operating system dependentportion, to zeroes. When the connection is initiated, the user places whichever non-default values areneeded in the user part of the NRB, and invokes NETEX service. Once the connection is initiated, theuser must not change the OS dependent part of the NRB between calls to NETEX.• If the calling program is using the connection in a full duplex manner, the user will need to make a copyof the NRB to produce a “read NRB” and a “write NRB.” This copying operation is the copying of all 40fields of the NRB to another area, at a time when the NRB being copied is not active. If a second requestfor the same connection is issued from the copied NRB, the user interface must detect the condition andhandle that new part of the connection accordingly.• Many NRB values are specified in addressable units. An addressable unit is the amount of informationcontained in one memory location for that machine. For example, a CDC CYBER has an addressableunit of 60 bits, Unisys OS2200 is 36 bits, IBM and Digital are generally 8 bits, Tandem is 8 bits, and soon.NRB FieldsThe following figure shows the fields in the NRB. All NRB fields are one words long. The NRB containsforty fields.Many of the NRB fields are or could be updated by either the program or NETEX with every request. However,the fields NRBCLASS, NRBMAXRT, NRBBLKI, NRBBLKO, NRBRSV, NRBOFFER, andNRBHOST are associated with the session negotiation process. Information in these fields is updated byNETEX as their values change. These fields are initially specified during the OFFER and CONNECT requests.When the offering task receives the connect, the negotiated values are set in the offered NRB. Whenthe SCONFIRM is sent, the negotiated values are set in the NRB associated with the read of the SCONFIRMinformation. Subsequent attempts to change these fields will have no effect.MAN-REF-H307IP-04 NETEX Request Block Page 25
Page 1: H307IP NETEX ® User Interfacefor U
Page 4 and 5: PrefaceThis manual describes the H3
Page 6 and 7: Notice to the ReaderThe material co
Page 8 and 9: Glossaryasynchronous: A class of da
Page 10 and 11: Table of ContentsRevision Record ..
Page 12 and 13: FORTRAN NETEX Request Blocks.......
Page 14 and 15: FiguresFigure 1. Basic I/O Flow....
Page 16 and 17: Design Efficiency and FlexibilityTh
Page 18 and 19: NESiGate Offload NETEXThis NETEX pr
Page 20 and 21: Figure 3. NETEX and the ISO ModelSe
Page 22 and 23: Intertask CommunicationNETEX is a s
Page 24 and 25: General Concept of a SessionBefore
Page 26 and 27: Establishing a SessionThe following
Page 28 and 29: Data TransferUnlike the rules for e
Page 30 and 31: Figure 7. Concurrent SREAD and SWRI
Page 32 and 33: Figure 8. One-Way Data TransferThe
Page 34 and 35: Terminating a SessionNETEX sessions
Page 36 and 37: Programming NotesThe following sect
Page 41 and 42: NRBINDNRBIND indicates the type of
Page 43 and 44: xx84 to xxFF ReservedThe total requ
Page 45 and 46: The conversion options are selected
Page 47 and 48: On completion of the offer or confi
Page 49 and 50: NRBHNAME (NRBHOST)NRBHNAME specifie
Page 51 and 52: Assembler Procedure FormatAll of th
Page 53 and 54: SCONNECT Assembler CallThe SCONNECT
Page 55 and 56: SREAD Assembler CallThe SREAD call
Page 57 and 58: SCLOSE Assembler CallThe SCLOSE cal
Page 59 and 60: NETEX Procedure CodeThe code genera
Page 61 and 62: FORTRAN InterfaceNETEX includes a l
Page 63 and 64: SOFFR FORTRAN CallThe SOFFR (offer)
Page 65 and 66: SCONN FORTRAN CallThe SCONN (connec
Page 67 and 68: SCONF FORTRAN CallThe SCONF (confir
Page 69 and 70: SREAD ResultsThe following NRB fiel
Page 71 and 72: SCLOS FORTRAN CallThe SCLOS (close)
Page 73 and 74: SWAIT FORTRAN CallThe SWAIT call pr
Page 75 and 76: NRBPROTLLength of outgoing Odata.SD
Page 77 and 78: 120 FORMAT (I5)CC Send request to r
Page 79 and 80: NETEX Calling SequenceIn order to c
Page 81 and 82: Driver InterfaceIntroductionThe Dri
Page 85: DCONNECT Entry ParametersThe follow
Page 90 and 91:
Exec status is the operating system
Page 92 and 93:
InstallationPrerequisitesThe prereq
Page 94 and 95:
Seconds to allow incoming data to r
Page 96 and 97:
Step 4. Load the PAM Using the NCT
Page 98 and 99:
User ExitsH307IP provides user exit
Page 100 and 101:
Utility/Test ProgramsNTXCONSThis pr
Page 102 and 103:
The program will respond with the f
Page 104 and 105:
DESELECT hostname hostname...5. To
Page 106 and 107:
VERSION StatementThe VERSION statem
Page 108 and 109:
TRUNK StatementThe TRUNK statement
Page 110 and 111:
HOST StatementThe HOST statement pr
Page 112 and 113:
ADAPTER StatementThe ADAPTER statem
Page 114 and 115:
CODECONV - Hardware code conversion
Page 116 and 117:
LINK StatementThe LINK statement is
Page 118 and 119:
PORT StatementAt least one PORT sta
Page 120 and 121:
Network Configuration Example* Curr
Page 122 and 123:
Appendix A. NRBSTAT Error CodesWhen
Page 124 and 125:
H307IP User Interface Error CodesTh
Page 126 and 127:
1300 Driver Level - Read Time Out.
Page 128 and 129:
CONF010E TYPE missing in LOCALNET s
Page 130 and 131:
CONF074E Invalid trunk (0,1) define
Page 132 and 133:
Explanation: All hosts in the same
Page 134 and 135:
ESCON/SBCON InterfacesThe STK DX/E
Page 136 and 137:
FFiber Distributed Data Interface (
Page 138 and 139:
Ppath .............................
Page 140:
Comment SheetNetwork Executive Soft
show all

SDISC Assembler Call - NetEx

Create successful ePaper yourself

Delete template?

Save as template?