SDISC Assembler Call - NetEx

SDISC FORTRAN CallThe SDISC (disconnect) call provides the means for any connected application to terminate a session. Therequest is immediate and any data currently in transport may not be delivered. If data delivery is required, itis the disconnector’s responsibility to wait for confirmation of previous SREAD or SWRIT calls before issuingthe SDISC. Before an SDISC can be issued, the user must provide a NRB with an NRBNREF relating tothis session.Call Operation ParametersCALL SDISC (nrb, buffer, length, datamd)The following parameters were shown in the SDISC call format. The parameters must be specified in the orderpresented. If parameters are omitted, the commas must still be used.CALLThis is a standard high level call instruction.SDISCThis is the verb for this call. Either SDISC or SDISCW must be specified.SDISCWThis 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 to be passed to NETEX.bufferThis optional parameter specifies the start of an array that holds the user data that is to be sent to thecorresponding application. Note that in the single case of SDISC, delivery of data is not reliable, althoughthe actual disconnection will always occur.lengthThis optional parameter specifies the length of the data (in addressable units - words for Unisys) thatis to be sent to the corresponding application, to be presented with the completion of the correspondingapplication’s SREAD request. If no data needs to be sent to the other application, the length maybe set to zero. The data type of length should be INTEGER.datamd (optional)This parameter specifies the datamode that is to be used to send the disconnect data to the correspondingapplication. The data type of datamd should be INTEGER. Refer to NRBDMODE in“NETEX Request Block” for a discussion of the datamode parameter.Upon completion of the SDISC, the connection will no longer exist. New commands against that connectionwill be rejected. An SOFFR or SCONN must be issued to establish a new connection.SDISC Entry ParametersThe following NRB fields are used by SDISC on entry.NRBBUFA Address of outgoing Pdata.NRBLENLength of outgoing Pdata.NRLBUBITN Pdata unused bit count.NRBDMODE Datamode of Pdata.NRBPROTA Address of outgoing Odata.Page 60 FORTRAN Interface MAN-REF-H307IP-04