SDISC Assembler Call - NetEx

SOFFR FORTRAN CallThe SOFFR (offer) subroutine provides a means for a program desiring to accept a connection from a calleron the network to post the availability of the service. Before issuing an SOFFR call, the user must provide anNRB (described in "NETEX Request Block") to be used by the user interface. Also, NETEX must be activein the system.Call Operation ParametersCALL SOFFR[W] (nrb, buffer, length, timeou, pname)The following parameters were shown in the SOFFR call format. The parameters must be specified in the orderpresented. If parameters are omitted, the commas must still be used.SOFFRThis is the verb for the call. Either SOFER or SOFFRW must be specified.SOFFRWThis specifies that the calling program must wait for the call to complete before processing is resumed.nrbThis required parameter is the address of the NRB data area that is to be passed to NETEX.bufferlengthtimeoupnameThis optional parameter specifies the start of an array that is to receive data sent by the correspondingSCONNECT request.This optional parameter specifies is the length of the buffer (in addressable units - words for Unisys)that will hold the data sent by the corresponding SCONNECT. When called, length should containthe maximum size of the buffer. On return the NRBLEN (NRB(3)) field will contain the number ofaddressable units of information actually sent to the offering application. The data type of lengthshould be INTEGER.This optional parameter indicates the number of seconds that the OFFER request should remain outstanding.If no application connects during this interval, then the OFFER will end abnormally. Iftimeou is specified as zero, the OFFER will remain outstanding indefinitely.This optional parameter is the alphabetic name of the process to be offered to the corresponding callingprogram. The name offered is arbitrary, but must be known to the connecting program. Thisname may be provided as a CHARACTER*8 variable or as a string in the CALL statement if paddedwith blanks to eight characters in length.SOFFR Entry ParametersThe following NRB fields are used by SOFFR on entry.NRBBUFA Address for incoming PdataNRBBUFLLength of buffer to hold Pdata.NRBTIMENumber of seconds offer outstanding.NRBBLKO Maximum transmission size acceptable.NRBBLKIMaximum reception size acceptable.MAN-REF-H307IP-04 FORTRAN Interface Page 49