SDISC Assembler Call - NetEx

SWRITE Assembler CallThe SWRITE call provides a means for a program to transmit data to another calling program. Before anSWRITE can be issued, a connection must be established. The NRB used to issue the SWRITE must havebeen used by a previous request that serviced the desired connection, or it must be a copy of another NRB thathas serviced the connection. Defaults for unspecified parameters are the existing parameters in the specifiedNRB.Also prior to issuing an SWRITE 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 SWRITEcall include the following:NRBBUFA Starting address of data to be transmitted to the other program with the SWRITE request.NRBLEN Length of data to be transmitted with the SWRITE request.NRBUBIT Unused bit count for data to be transmitted with the SWRITE request.NRBMODE Datamode for making data intelligible for users on both ends.CallParametersSWRITE[W] nrb [err-return]SWRITEThis is the procedure name.SWRITEWIf 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 in-progress status (negative value).Page 42 H307 Assembler Interface MAN-REF-H307IP-04