jbc

jbc {-option {...-option}} file {file ...}

Notes:

• Optimization levels by default are set to level 2. Once an application has been debugged and is ready for release then Optimization level 4 should be invoked.
• Some of the options only refer to Unix platforms.
• Any options not listed here are automatically passed to the C compilation system. All options must be preceded by a hyphen character

Simple Examples

jbc invoices.b

The simplest form of the command compiles the jBC source program invoices.b, held in the current directory then writes the resultant
executable code into the default file a.out in the same directory.

jbc -JO4 myjbc.b cfunctions.c anobject.o -o myapp

This command compiles the jBC code in the file myjbc.b, the C code in cfunctions.c, and links the resultant object code with the existing object code anobject.o to produce the UNIX executable myapp. The optional parameter -JO4 informs the compiler that full optimization is to be carried out on the jBC and C code.

COMPILATION AND EXECUTION ENVIRONMENT VARIABLES

The jBC compiler and executables produced using jbc recognize a number of UNIX environment variables. Environment variables are normally maintained using your current command shell but may also be manipulated from jBC and C programs. They are used to inform any commands you execute of specific options or configuration requirements. The compiler uses environment variables to specify runtime emulations, compilation options and directory paths for locating source code when debugging.

To minimize the effort of using and configuring the compilation system, the jbc command assumes sensible defaults for all configurable options. Most programmers will only be concerned with the compilation option for emulation.

JBCEMULATE

When importing code from existing environments, this variable tells the compiler what system it originally ran on. Note that programs and subroutines imported from different systems may be freely mixed. The R83 default will suit almost all code. Values: ROS, R83, PRI, ULT, ADS, FUJ, UNV, UND, SEQ

PATH

The path variable contains a list of all directories that contain executable programs. The jBASE release path should be included in the path list so as jBASE commands can be seen and executed. The path for you should also be added to the path list. For example :

export PATH=$HOME/bin:$PATH (Unix )
set path=%home%\bin;%PATH% (Windows)

LIB NT/Win95
LIBPATH AIX
SHLIB_PATH HPUX
LD_LIBRARY_PATH UNIX

This environment variable should be set to contain paths to located shared and archived libraries, for linking with subroutines and main programs.

COMPILER ERROR MESSAGES

The jbc error messages are not available for users to change. Foreign language versions of the compiler are however available. The format of a jbc error (or warning) message is as follows:

[ErrorCount ( RefNum)]: "FileName", LineNum (Offset) Near .. "ErrorMessage" Line Of Source Code Containing The Error ^
Where:

JBASE PREPROCESSOR - JPP

The jpp is a sophisticated macro pre processor which provides complex conditional compilation facilities, supporting compiler directives compatible with C and BASIC compilers.

EQUATE symbol TO substitute #define symbol or -JCDsymbol
EQUATE Day TO REM(DATE(),7) #ifdef symbol
EQUATE MonDay TO 1
IF Day = MonDay THEN CRT "Monday" #endif


JBASE CROSS COMPILER - JBCCOM CONVERTS BASIC TO C

C preprocessor - cpp C Macro Preprocessor
C Compiler - ccom
Assembler optimiser - coptim
Assembler - as
Linker - ld

Unix

NT/Win95

Note: A .el or .exp file built by the CATALOG command is different in structure to a .el or a .exp file built direct from jBuildSLib.

CFUNCTION EXAMPLE

EncodeKey.b

DEFC INT Crypt(VAR)
LOOP
   CRT "Enter key ":
   INPUT KEY
WHILE KEY NE " DO
*
* Encrypt key
*
   IF Crypt(KEY) THEN
   CRT "Encryption successful ":KEY
   END ELSE
   CRT "Encryption failed ":KEY
   END

REPEAT

EncodeKeyC.c

#include jsystem.h
#include crypt.h

INT32 Crypt( UserString )
VAR *UserString;
{
char *Source;
char *Result;

/*
** Check for unassigned variable
*/

if ( UserString == NULL )
return(0);

/*
** Ensure null terminated string
*/

CONV_SFB(UserString);

/*
** Point to Source string
*/

Source = (char *) UserString->VAR_STRING_ADDR;

#ifdef DEBUGX
fprintf(stderr,"String before encryption %s\n",Source);
#endif

/*
** Encrypt Source using "az" as salt
*/

Result = crypt(Source, "az");

#ifdef DEBUGX
fprintf(stderr,"String after encryption %s\n",Result);
#endif

/*
** Copy result back to UserString
*/

STORE_VBS(UserString,(STRING *) Result+2);

return(1);
}

Compiling