SDISC Assembler Call - NetEx

SCONN FORTRAN CallThe SCONN (connect) call provides a means for a program to request a session with a program that has issuedan SOFFR. Before issuing the SCONN, an NRB must be provided for use by the user interface.Call Operation ParametersCALL SCONN[W] (nrb, buffer, length, datamd, pname, hname)The following parameters were shown in the SCONN 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.SCONNThis is the verb for the call. Either SCONN or SCONNW must be specified.SCONNWThis indicates that the calling program should 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.bufferThis optional parameter specifies the start of an array that holds the user data that is to be sent to thecorresponding application.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 OFFER 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.datamdThis optional parameter specifies the datamode that is to be used to send the connect data to the correspondingapplication. The data type of datamd should be INTEGER. Refer to NRBDMODE in“NETEX Request Block” on page 25 for a discussion of the datamode parameter.PnameThis optional parameter specifies the alphabetic name of the process SOFFR'd by the correspondingcalling program. The name offered is determined by the other calling program. This name may beprovided as a CHARACTER*8 variable or as a string in the CALL statement if padded with blanks toeight characters in length.HnameThis required parameter specifies the alphabetic name of the host computer to be accessed to determineif the correct SOFFR is available. The “names” of the host computers in the network are determinedby the NETEX installation systems programmer. This may be provided as a CHARACTER*8variable or provided as a string in the CALL statement if padded with blanks to eight characters inlength.MAN-REF-H307IP-04 FORTRAN Interface Page 51