SDISC Assembler Call - NetEx

SREAD FORTRAN CallThe SREAD request provides a means for a program to receive data from another host. NETEX assumes thatthe calling program that wrote the data specified code conversion which makes it readable for the receiver.Before an SREAD can be issued, a connection must be established.Call Operation ParametersCALL SREAD[W] (nrb, buffer, length, timeou)The following parameters were shown in the SREAD call format. The parameters must be specified in theorder presented. If parameters are omitted, the commas must still be used.CALLThis is the required standard high level call instruction.SREADThis is the verb for this call. Either SREAD or SREADW must be specified.SREADWThis parameter specifies that the calling program must wait for the call to complete before processingis resumed.nrbThis required parameter is the address of the NRB data area that is to be passed to NETEX.bufferlengthtimeouThis required parameter specifies the start of an array that is to receive the data sent by the correspondingapplication’s SWRITE or SCONFIRM request.This required parameter specifies the length of the buffer (in addressable units - words for Unisys)that is to hold the data sent by the corresponding SWRITE. When called, length should contain themaximum size of the buffer. On return, the actual length input will be in NRBLEN (NRB(3)). Programsthat wish to work with the Unused Bit Count on input should examine the NRBUBIT field(NRB(4)). The data type of length should be INTEGER.This optional parameter specifies the number of seconds that the READ request should remain outstanding.If the corresponding application does not send data during this interval, then the READ willend abnormally. If timeou is specified as zero, then the READ will remain outstanding indefinitely.The programmer should take alternate path retry into consideration when specifying the timeoutvalue. Refer to “Overview”.SREAD Entry ParametersThe following NRB fields are used by SREAD on entry.NRBBUFA Address for incoming Pdata (move mode).RBBUFLNLength of buffer to hold Pdata.NRBTIMENumber of seconds offer outstanding.NRBPROTA Address for incoming Odata.NRBPROTL Length of buffer to hold Odata.Page 54 FORTRAN Interface MAN-REF-H307IP-04