Dummy_routines
Several dummy subroutines and a main program (SSP_T.MAR) are provided for BNL787 programmers to use to get started. The program SSP_T.SSP can be built using the command file 787SSP:|DOITALL.COM. This cross assembles and links all the subroutines and the main program using the command DLINK (see above). The resulting file is downloaded into the SSP.
A host program writes one of seven acceptable commands into the BNL787 fixed location $COMMAND, and then tells the SSP to GO. (This could alternatively be done by using SNOOPY or SSPAR). Each of the seven commands will call one of seven subroutines.
On receipt of the GO command, the SSP_T program loads the word "GOIN" into its mode word ($MODE). It then checks that the command in the location $COMMAND is acceptable. If so, it calls the corresponding subroutine and writes the
appropriate mode word into $MODE (overwriting "GOIN" ). The subroutines (except INITIALIZE) are dummies, and merely return the word "SUCC" to denote success, which the main program writes into $RET_CODE before exiting.
The subroutine INITIALIZE performs a T-Pin scan before returning, filling the BNL787 locations starting at $CRATE with the manufacturer's ID of modules in the crate.
If an unrecognised command is given, the word "BADM" is is written in $MODE, and the word "KRAP" is returned in $RET_CODE. The words "SUCC" and "KRAP" are to be found in USER_RES.MAR.
This procedure is described in detail in 787SSP:|787_FIXED_LOCATIONS.MAR.
Other example programs in 787EXAMPLES: are the set of programs TEST*_K*.SSP. A User's Guide to these programs is found in 787DOC:|TEST_K_PART1.MEM,|TEST_K_PART2.MEM
Converted from .HLP to .HTML by HLPTOHTML.