SDISC Assembler Call - NetEx

SREAD Assembler CallThe SREAD call provides a means for a program to receive data from another host or an indication fromNETEX of an abnormal condition with the connection.Before an SREAD can be issued, a connection must be established. The NRB specified must have been usedfor a previous NETEX request for the particular connection, or a copy of another NRB that has been used toservice the desired connection. Defaults for unspecified parameters are the parameters existing in the specifiedNRB.Also prior to issuing an SREAD call, the user must provide an NRB (described in “NETEX Request Block”)to be used by the user interface. All NRB fields must be filled in by the program before calling NETEX, unlesspreviously used values are to be used again. The areas used by the SREAD call include the following.NRBBUFA Starting address of data area to be used for receiving data from the other program.NRBBUFL Length of user buffer to be used to receive data from the other program.NRBTIME Number of seconds before this request times-out.CallParametersSREAD[W] nrb [err-return]SREADThis is the procedure name.SREADWIf 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 41