SDISC Assembler Call - NetEx

SDISC Assembler CallThe SDISC (disconnect) call provides the means for any connected program to terminate a session. The requestis immediate and any data currently in transport may not be delivered. If data delivery is required, it isthe disconnector’s responsibility to wait for confirmation of previous SREAD or SWRITE commands by thecorresponding program before issuing the SDISC call.Before an SDISC can be issued, the user must provide an NRB that has been previously used to service thedesired connection, or a copy of an NRB used to service the connection.Also prior to issuing an SDISC call, the user must provide an NRB (described in “NETEX Request Block”) tobe 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 the SDISC callinclude the following.NRBBUFANRBLENNRBUBITNRBMODEStarting address of (optional) data to be transmitted to the other program with the SDISC request.Length of (optional) data to be transmitted with the SDISC request. Note that this must notexceed the maximum segment size of either host.Unused bit count for (optional) data tq be transmitted with the SDISC request.Datamode for making data intelligible for users on both ends.CallParametersSDISC[W] nrb [err-return]SDISCThis is the procedure name.SDISCWIf this optional parameter is specified, 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).Page 44 H307 Assembler Interface MAN-REF-H307IP-04