Previous Topic: Customize $USERBCI

Next Topic: Return Codes

BCI Command Exit

When a record is read from the system input file, it is first scanned to determine whether it is a BCI control command. If not, it is recognized as a user command to pass to the product region. However, before it is passed, it is reformatted to remove leading blanks. If a command exit is active, it is called passing the command as a parameter. The command exit can then choose to modify the command, to reject it, or to insert additional commands into the input stream.

On entering the exit, Register 1 contains the address of a 76-byte area as follows:

Bytes 1 through 4

Contain a binary fullword indicating the length of the following data which can be a maximum of 72 bytes.

Bytes 5 through 76

Contain the user command and data with leading blanks removed and any unused characters to the right filled with blanks.

Before returning, the exit sets Register 15 with a return code to indicate what action BCI is to take with the returned data.