SDISC Assembler Call - NetEx

SCONNECT Assembler CallThe SCONNECT call provides a means for a program to request a session with a program that has previouslyissued an SOFFER.Prior to issuing an SCONNECT call, the user must provide an NRB (described in “NETEX Request Block”)to be used by the user interface. All NRB fields which are not defaults or have not been assembled into theNRB data area(s) must be filled in by the program before calling NETEX. The areas used by theSCONNECT call include the following:NRBPNAME Name of process requesting the connection.NRBHNAME Name of destination host to be connected to.NRBBLKINRBBLKONRBBUFANRBLENNRBUBITNRBMODENRBMAXRTMaximum buffer size for input requests (may be changed during the NETEX negotiationprocess).Maximum buffer size for output requests (may be changed during the NETEX negotiationprocess).Starting address of (optional) data to be transmitted to the other program with theSCONNECT request.Length of (optional) data to be transmitted with the SCONNECT request. Note that thismust not exceed the maximum segment size of either host.Unused bit count for (optional) data to be transmitted with the SCONNECT request.Datamode for making data intelligible for users on both endsMaximum data transmission rate permitted in thousands of bits per second (may bechanged during the NETEX negotiation process).CallParametersSCONNECT[W] nrb [err-return]SCONNECTThis is the procedure name.SCONNTWIf this optional call is specified, the return will not be made to the caller until the request has completed.If not specified, return will be made immediately after preliminary error-checking of the request(by NETEX).nrbThis is the address of the updated NETEX request block that is to be used with this procedure.err-returnIf this optional parameter is specified, this field is the address to which control will be transferred ifthe request completes with a nonzero return code (indicating an error). Note that this does not applyto the immediate return with an in-progress status (negative value).MAN-REF-H307IP-04 H307 Assembler Interface Page 39