GO - run a load module.

Syntax:

go [options*:]program arg1 arg2 ...

Hstar=filename (.h)      Name=element (//////)
Time=number              TRace=number
+Trace

Examples:

go
go -ad fila x=27
go:hh -ca file1
go h=mult n=link1 :mult -r file

Options

Hstar=filename: gives the name of the file containing the program you want to run.
Name=element: gives the name of the element within the Hstar that you want to run. You don't need this with a single element Hstar. For multi-element Hstars, the default is to run an element named "//////".
Time=seconds: specifies the maximum amount of time the program may run.
+Trace: loads the trace package with the program.
TRace=address: loads the trace package at the given address. "address" is interpreted in octal if it begins with a leading zero; otherwise it is interpreted in decimal.

Description:

GO initiates execution of a load module. The module may be contained in a temporary or permanent file.

GO's command line is interpreted in two parts, with the parts separated by a ":". The part before the ":" specifies the options for GO itself; the part after the ":" specifies a command line for the program that GO executes. You may omit the ":" if you aren't specifying any options for GO itself. If there is no ":", GO passes the command line to the user program as typed.

GO determines which file to run by looking at its command line. If the first argument is "go", GO looks for a temporary or permanent file called ".h" (the same as the B command uses). Otherwise GO looks for a file whose name is the same as the first argument. You can override this by using the Hstar= option to load a particular file. You may need this if the program is not in its normal location and is sensitive to the first token on its command line.

You can use the GO command to load and run any routine from a multi-routine load module. Use the Name= option to specify the name of the routine you want to run. GO searches for that routine from the load module and puts it into execution.

Using the +Trace or Trace= option loads the trace package. Execution starts by passing control to the trace package and telling it the entry point of the user program. With +Trace, the trace package is loaded at the first eight word boundary after the end of the largest overlay. With Trace=, the trace package is loaded at the first eight word boundary at or after the maximum of the specified address and the end of the largest overlay.

Fortran programmers should use the FTN or F77 commands instead of GO. GO does not provide the full Fortran I/O setup that Fortran programs usually need.