SDISC Assembler Call - NetEx

SCLOSE Assembler CallThe SCLOSE call provides a means for a program to transmit data to another calling program, and indicatethat this is the last data to be sent.Before an SCLOSE can be issued, a connection must be established. The NRB used to issue the SCLOSEmust have been used by a previous request that serviced the desired connection, or it must be a copy of anotherNRB that has serviced the connection. Defaults for unspecified parameters are the existing parametersin the specified NRB.After a program has issued an SCLOSE, no other data may be written by that program. If the other programhad previously issued an SCLOSE, the data is written and then the connection is gracefully disconnected. Ifthe other program has not issued an SCLOSE, it is still free to write data to the program that did issue theSCLOSE.Also prior to issuing an SCLOSE 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 the SCLOSEcall include the following.NRBBUFA Starting address of data to be transmitted to the other program with the SCLOSE request.NRBLEN Length of data to be transmitted with the SCLOSE request.NRBUBIT Unused bit count for data to be transmitted with the SCLOSE request.NRBMODE Datamode for making data intelligible for users on both ends.CallParametersSCLOSE[W] nrb [err-return]SCLOSEThis is the procedure name.SCLOSEWIf 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 43