SDISC Assembler Call - NetEx

SOFFER Assembler CallThe SOFFER call provides a means for a program desiring to accept a connection from a caller on the networkto post the availability of the service.Prior to issuing an SOFFER call, the user must provide an NRB (described in “NETEX Request Block”) to beused by the user interface. All NRB fields which are not defaults or have not been assembled into the NRBdata area(s) must be filled in by the program before calling NETEX. The areas used by the SOFFER call includethe following:NRBPNAME Name of process to offer.NRBBLKINRBBLKONRBTIMENRBBUFANRBBUFLNRBMAXRTMaximum buffer size for input requests (may be changed during the NETEX negotiationprocess).Maximum buffer size for output requests (may be changed during the NETEX negotiationprocess).Number of seconds before the request times-out.Starting address to receive data coining back with the other programs CONNECT request.Length of buffer to receive data coming back with the other programs CONNECT request.Maximum data transmission rate permitted in thousands of bits per second (may bechanged during the NETEX negotiation process).CallParametersSOFFER[w] nrb [err-return]SOFFERThis is the procedure name.SOFFERWIf 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 38 H307 Assembler Interface MAN-REF-H307IP-04