IBM Basic assembly language

BAL (Basic Assembly Language) is a low-level language used on IBM mainframes from the earliest 360 series, through systems 370, 390 and z/Series. The earliest version was provided with the System/360 in 1964; the latest version is known as the IBM High Level Assembler (HLASM). Programmers utilizing this family of assemblers refer to them as ALC, for Assembly Language Common, or simply "assembler".

General characteristics

The architecture of IBM mainframes has taken many forms over the years, including System/360, System/370 XA, ESA/390, and z/Architecture. Each of these architectures has retained compatibility with most of the features of its predecessor. "BAL" uses the native instruction set of these machines. It is thus as close to the hardware as a typical programmer is likely to get.

The instruction set consists of the low-level operations supported by the hardware, such as
* "Load" (L) - copy a value from memory to a register,
* "Store" (ST) - copy a value from a register to memory,
* "Compare" (C) - compare a register value with a value in memory,
* "Shift" (SLL,SRL) - move the bits of a register left or right and
* "Execute Channel Program" (EXCP) - perform an I/O operation such as reading data from a disk or tape (usually by the Operating System). The extreme simplicity of these operations means that a program written in Assembler will usually be much longer and harder to read than an equivalent program in, say, COBOL or Fortran. In the past, the speed of hand-coded Assembler programs was often felt to make up for this drawback, but with the advent of optimizing compilers, "C" for the mainframe, and other advances, Assembler has lost much of its appeal. IBM continues to upgrade the Assembler, however, and it is still used when the need for speed or very fine control is paramount.

A small example

The following fragment shows how the logic "If SEX = 'M', add 1 to MALES; else, add 1 to FEMALES" would be performed in Assembler.

CLI SEX,'M' Male? BNE IS_FEM If not, branch around L 7,MALES Load current value of MALES into register 7 LA 7,1(,7) add 1 (pre-XA max value 24 bits) ST 7,MALES and store back the result B GO_ON Finished with this portionIS_FEM EQU * A label L 7,FEMALES If not male, load current value in FEMALES LA 7,1(,7) add 1 (pre-XA max value 24 bits) ST 7,FEMALES and storeGO_ON EQU * - rest of program -
*MALES DC F'0' defines 31 bit memory location (initially=0)FEMALES DC F'0' "" ""

The following is the ubiquitous Hello world program, and would, executing under an IBM Operating systems such as OS VS/1 and MVS, display the words 'Hello World' on the operator's console:

HELLO CSECT The name of this program is 'HELLO'
* Register 15 points here on entry from Op/sys or caller. USING *,12 Tell assembler what register we are using for pgm. base STM 14,12,12(13) Save registers 14,15,and 0 thru 12 in callers Save area LR 12,15 Set up base register with programs entry point address LA 15,SAVE Now Point at our own save area ST 15,8(13) Set forward chain ST 13,4(15) Set back chain LR 13,15 Now switch to new save area
* -end of housekeeping (similar for most programs) - WTO 'Hello World' Write To Operator (Operating System macro)
* L 13,4(13) point at caller's-provided save area LM 14,12,12(13) Restore registers as on entry BR 14 Return to caller
* SAVE DS 18A Define 18 fullwords for calling END HELLO This is the end of the program

Note: "WTO" is an Assembler macro that generates an Operating System call Because of saving registers and later restoring and returning, this small program is usable as a batch program invoked directly by the operating system Job control language (JCL) like this // EXEC PGM=HELLOor, alternatively, it can be CALLed as a subroutine from such a program. CALL HELLO

Types of instructions

Three main types of instructions are found in the source code of a program written in Assembler.

Machine instructions (Mnemonic)

As with any language, the heart of Assembler programming is understanding the instructions that usually have, in this case, a "one-to-one" relationship with machine instructions. The full mnemonic instruction set is described in the "Principles of Operation" manual for each processor. The general syntax for the instruction operands is fairly straightforward
* The target for an instruction appears first, then the source on the right, (as with "a = 6" in C or Algol programming). After one or more blanks, any comment may follow on the same line. A line starting with an asterisk (*) is considered entirely comments.Examples: * This is a comment line L 3,ZIGGY load the fullword integer stored at location labeled 'ZIGGY' into general register 3 SLA 4,5 shift the value in general register 4 left by 5 bits MVC TARGET,SOURCE move characters from memory location 'SOURCE' to 'TARGET' AP COUNT,=P'1' add 1 to value in memory location 'COUNT' (packed decimal format) B NEXT unconditional branch to label 'NEXT' HERE EQU * This is a label CLC TARGET,=C'ADDRESS' Compare memory location 'TARGET' to string 'ADDRESS' BE THERE branch if equal to program label 'THERE'

Assembler instructions

The assembler itself needs instructions from the programmer too. For instance, CSECT means "start a section of code here"; DC means define a constant to be placed in the object code.

Macros and conditional assembly

The programmer can group instructions together into macros and add them to a library, which can then be invoked in other programs, usually with parameters, much like the preprocessor facilities in C and related languages. Macros can include conditional assembler instructions, such as AIF (an IF construct), used to generate different code according to the chosen parameters.

Operating system macros

Most programs will require services from the operating system, and the OS provides standard macros for requesting those services. These are analogous to Unix system calls. For instance, in MVS (later z/OS) for example, 'GETMAIN' dynamically allocates a block of memory, and 'GET' retrieves the next logical record from a file.

External links

* [http://publibz.boulder.ibm.com/bookmgr_OS390/libraryserver/zosv1r7/ z/OS library—look for "High Level Assembler" and "Principles of Operation" on the left]