1 INTRODUCTIONThis manual describes the use of the Assembler programming language at the NIH Computer Center. This manual is intended to give programmers the Assembler information they need in order to create new programs and to maintain programs running on the MVS South System. The information in this manual should be used in conjunction with the Computer Center User's Guide, Batch Processing and Utilities at NIH, and the manuals described in Section 3 of this publication.
The Assembler programming language receives full (Level 1) support. Questions on Assembler should be directed to the Technical Assistance and Support Center (TASC), either by phone at (301) 594-3278 or by submitting a Problem Tracking Report (PTR). There are several methods of submitting a PTR:
· World Wide Web
Users with NIHnet or Internet connections can submit a PTR through the World Wide Web. To access the PTR system, connect to:
http://datacenter.cit.nih.gov/
· Electronic Mail
PTRs can also be submitted to the Computer Center by sending electronic mail to the WYLBUR initials PTR or the Internet address PTR@CU.NIH.GOV. Mailed PTRs must have a valid SUBJECT header containing the submitter's name and telephone number, and be of the form
Subject: PTR FROM name TELEPHONE phone-number
For example:
Subject: PTR FROM Tom Jones TELEPHONE 6-1111
· ENTER PTR
Changes that affect the use of Assembler will be fully tested and pre-announced through the Interface newsletter. For a full description of Level 1 support, see the NIH Computer Center User's Guide.
The IBM Operating System Assembler is a symbolic programming language used to write programs for the MVS System. The language provides a convenient means for representing the machine instructions and related data necessary to program the MVS System. The NIH Computer Center uses the IBM High Level Assembler program product.
No Federal Information Processing Standard (FIPS) has been established for this language. Programs written in languages meeting FIPS standards can be transported more readily between federal installations and different vendors' mainframes. Federal policy encourages the use of languages with FIPS standards.
|
Note: the Binder now performs the link-editing functions previously performed by the Linkage Editor. |
The procedure names for Assembler Language are:
ASMHCOMP
ASMHOBJ
ASMHLKGO
ASMHLDGO
ASMHLKMM
ASMHLKSM
ASMHCALL
Each procedure name follows the pattern:
lllvffff
where |
"lll" |
is the language prefix (ASM for Assembler) |
"v" |
is the version (is the version (H)) | |
"ffff" |
is the function |
The meaning of each function is given below:
COMP |
compilation only |
OBJ |
compile and store object module |
LKGO |
use the Binder (formerly the Linkage Editor) and execute program |
LDGO |
use the Loader and execute program |
LKMM |
use the Binder to store a link-edited load module into an existing multi-member PDS |
LKSM |
use the Binder to store a link-edited load module into a new single-member PDS |
CALL |
execute a fully link-edited load module |
In the examples throughout this manual, the following conventions apply:
"aaaa" |
the account number |
"iii" |
the programmer's registered initials |
"dsname" |
name of data set |
"progname" |
name of program stored in partitioned data set (PDS) |
"fileser" |
volume serial number of disk where data set is located; required only if the data set is not cataloged |
"primary" |
primary quantity requested in the SPACE parameter |
"blocks" |
number of directory blocks |
"stepname" |
name of step which executes the procedure; should be unique within a job |
"ddname" |
user-supplied ddname; should be unique within job step |
