Appendix D - ADATA Support

The format of the ADATA records produced by the IBM High Level Assembler is described in the IBM High Level Assembler for MVS & VM & VSE Programmer's Guide (SC26-4941). This chapter describes the support provided by the Tachyon z/Assembler for the “Associated Data File” where there are differences from the support provided by the IBM assembler.

The associated data file is produced if the ADATA option is set. The associated data file name is controlled by the SYSADATA option. The ADATA option specifies the maximum record length and the format of the record length prefix that can be optionally added to each record.

For IBM’s Program Understanding Tool of the HLASM Toolkit Feature, no record length prefix should be generated and the SYSADATA(.xaa) option should be set.
For Cole Software’s z/XDC, the associated data file should be generated with no record prefixes or in GOFF format.

ADATA records can also be generated in a GOFF object file by setting the OBJECT(GOFF,ADATA) option.

ADATA Record Support

Record Type Description

X'0000' Job Identification

X'0001' ADATA Identification

X'0002' Compilation Unit Start / End

X'000A' Output File information

X'000B' Options File information

X'0010' Options

X'0020' External Symbol Dictionary

X'0030' Source Analysis

X'0032' Source Error

X'0034' DC / DS

X'0035' DC / DS Extension

X'0036' Machine Instruction

X'0040' Relocation Dictionary

X'0042' Symbol Record

X'0044' Symbol and Literal Cross Reference

X'0045' Register Cross Reference

X'0060' Macro and Copy Code Source Summary

X'0062' Macro and Copy Code Cross Reference

X'0070' User Data

X'0080' USING Map

X'0090' Assembly Statistics

Record Type	Description
X'0000'	Job Identification
X'0001'	ADATA Identification
X'0002'	Compilation Unit Start / End
X'000A'	Output File information
X'000B'	Options File information
X'0010'	Options
X'0020'	External Symbol Dictionary
X'0030'	Source Analysis
X'0032'	Source Error
X'0034'	DC / DS
X'0035'	DC / DS Extension
X'0036'	Machine Instruction
X'0040'	Relocation Dictionary
X'0042'	Symbol Record
X'0044'	Symbol and Literal Cross Reference
X'0045'	Register Cross Reference
X'0060'	Macro and Copy Code Source Summary
X'0062'	Macro and Copy Code Cross Reference
X'0070'	User Data
X'0080'	USING Map
X'0090'	Assembly Statistics

Job Identification Record - X'0000'

Field Name	Support
Date	If the PROCESS(BATCH) option is set, all assemblies will have the same date.
Time	If the PROCESS(BATCH) option is set, all assemblies will have the same time.
Product Number	Set to C'X390ASM'
Product Version	Set to C'V.R.MM', where V.R.MM is the version, release and modification level of the Tachyon z/Assembler.
Product Level	Set to the ADATALEVEL value. No field for ADATALEVEL(4).
PTF Level	Always blank.
System ID	Set to the value of &SYSTEM_ID.
Job Name	Set to the value of &SYSJOB.
Step Name	Set to the value of &SYSSTEP.
Procstep Name	Always blank.
Number of input files	Supported.
Offset of first input file section	Supported. No field for ADATALEVEL(4).
Input file number	Supported.
Input file name offset	Supported. No field for ADATALEVEL(4).
Input file name length	Supported.
Volume serial number offset	Supported. No field for ADATALEVEL(4).
Volume serial number length	Supported.
Member name offset	Supported. No field for ADATALEVEL(4).
Member name length	Supported.
Input file name	Supported.
Volume serial number	Supported for MVS only.
Member name	Supported for MVS only.

ADATA Identification Record - X'0001'

Field Name	Support
Time	Supported.
CCSID	Always set to X'0025'.

Compilation Unit Start/End Record - X'0002'

Field Name	Support
Indicator	Supported.
Record count	Supported.

Output File Information Record - X'000A'

Field Name	Support
Number of OBJECT output files	Supported.
Offset of first OBJECT file section	Supported. No field for ADATALEVEL(4).
Number of PUNCH output files	Supported.
Offset of first PUNCH file section	Supported. No field for ADATALEVEL(4).
Number of listing output files	Supported.
Offset of first listing file section	Supported. No field for ADATALEVEL(4).
Number of terminal output files	Supported.
Offset of first terminal file section	Supported. No field for ADATALEVEL(4).
Number of ADATA output files	Supported.
Offset of first ADATA file section	Supported. No field for ADATALEVEL(4).
Per file sections:
Offset of next same-type file section	Supported. No field for ADATALEVEL(4).
Sequence Number	Supported.
File name offset	Supported. No field for ADATALEVEL(4).
File name length	Supported.
Volume serial offset	Supported. No field for ADATALEVEL(4).
Volume serial number length	Suppored.
Member name offset	Supported. No field for ADATALEVEL(4).
Member name length	Supported.
File name	Supported.
Volume serial number	Supported for MVS only.
Member name	Supported for MVS only.

Options File Information Record - X'000B'

Field Name	Support
Number of option files	Set to the number of option files read by the assembler.
Offset to file information	Supported.
Per file sections:
Offset of next option file section	Supported. No field for ADATALEVEL(4).
Sequence Number	Supported.
File name offset	Supported. No field for ADATALEVEL(4).
File name length	Supported.
Volume serial offset	Supported. No field for ADATALEVEL(4).
Volume serial number length	Supported.
Member name offset	Supported. No field for ADATALEVEL(4).
Member name length	Supported.
File name	Supported.
Volume serial number	Supported for MVS only.
Member name	Supported for MVS only.

Options Record - X'0010'

Field Name	Support
Option byte 1, bit 0 ALIGN	1 if the ALIGN option is set.
Option byte 1, bit 1 ASA	1 if the PRINTCTL(ASA) option is set.
Option byte 1, bit 2 BATCH	1 if the PROCESS(BATCH) option is set.
Option byte 1, bit 3 COMPAT	1 if the NOCOMPAT option is not set.
Option byte 1, bit 4 COMPAT(CASE)	Always 0.
Option byte 1, bit 5 COMPAT(SYSLIST)	Always 0.
Option byte 1, bit 6 DBCS	1 if the PROCESS(DBCS) option is set.
Option byte 1, bit 7 DECK	1 if the OBJECT(DECK) option is set.
Option byte 2, bit 0 DXREF	1 if the DXREF option is set.
Option byte 2, bit 1 ESD	1 if the ESD option is set.
Option byte 2, bit 2 FOLD	1 if the FOLD option is set.
Option byte 2, bit 3 LIBMAC	1 if the ACONTROL(LIBMAC) option is set.
Option byte 2, bit 4 LIST	1 if the NOLIST option is not set.
Option byte 2, bit 5 ADATA	1 if the ADATA option is set.
Option byte 2, bit 6 MXREF	1 if the NOMXREF option is not set.
Option byte 2, bit 7 OBJECT	1 if the OBJECT(OMF) or OBJECT(XOBJ) option is set.
Option byte 3, bit 0 PCONTROL	1 if the NOPCONTROL option is not set.
Option byte 3, bit 1 PCONTROL(ON)	1 if the PCONTROL(ON) option is set.
Option byte 3, bit 2 PCONTROL(DATA)	1 if the PCONTROL(DATA) option is set.
Option byte 3, bit 3 PCONTROL(GEN)	1 if the PCONTROL(GEN) option is set.
Option byte 3, bit 4 PCONTROL(UHEAD)	1 if the PCONTROL(UHEAD) option is set.
Option byte 3, bit 5 PCONTROL(MSOURCE)	1 if the PCONTROL(MSOURCE) option is set.
Option byte 3, bit 6 PCONTROL(MCALL)	1 if the PCONTROL(MCALL) option is set.
Option byte 3, bit 7 COMPAT(MACROCASE)	1 if the COMPAT(MACROCASE) option is set.
Option byte 4, bit 0 RENT	1 if the FLAG(RENT) option is set.
Option byte 4, bit 1 RLD	1 if the RLD option is set.
Option byte 4, bit 2 TERM	1 if the NOTERM option is not set.
Option byte 4, bit 3 TEST	1 if the NOTEST option is not set.
Option byte 4, bit 4 XREF	1 if the NOXREF option is not set.
Option byte 4, bit 5 XREF(FULL)	1 if the XREF(FULL) option is set.
Option byte 4, bit 7 XREF(SHORT)	1 if the XREF(SHORT) or XREF(UNREFS) option is set.
Option byte 5, bit 0 EXIT	Always 0.
Option byte 5, bit 1 INEXIT	Always 0.
Option byte 5, bit 2 LIBEXIT	Always 0.
Option byte 5, bit 3 OBJEXIT	Always 0.
Option byte 5, bit 4 PRTEXIT	Always 0.
Option byte 5, bit 5 ADEXIT	Always 0.
Option byte 5, bit 6 TRMEXIT	Always 0.
Option byte 6, bit 0 USING(WARN)	1 if any of the FLAG(USINGDUP) FLAG(USINGZERO), FLAG(USINGMULT) or USINGLIMIT options are set.
Option byte 6, bit 1 USING(LIMIT)	1 if the USINGLIMIT option is set.
Option byte 6, bit 2 USING(MAP)	1 if the USINGMAP option is set.
Option byte 6, bit 3 FLAG(ALIGN)	1 if the FLAG(ALIGN) option is set.
Option byte 6, bit 4 FLAG(CONT)	1 if the FLAG(CONT) option is set.
Option byte 6, bit 5 FLAG(RECORD)	1 if the FLAG(RECORD) option is set.
Option byte 6, bit 6 GOFF	1 if the OBJECT(GOFF) option is set.
Option byte 6, bit 7 GOFF(ADATA)	1 if the OBJECT(GOFF,ADATA) option is set.
Option byte 7, bit 0 PESTOP	1 if the PROCESS(PESTOP) option is set.
Option byte 7, bit 1 RA2	1 if the FLAG(NORA2) option is set.
Option byte 7, bit 2 FLAG(SUBSTR)	1 if the FLAG(SUBSTR) option is set.
Option byte 7, bit 3 TRANSLATE	1 if the TRANSLATE option is set.
Option byte 7, bits 4-5 LIST	00 if NOLIST is set, 01 if LIST(121) is set, 10 if LIST(133) is set, or 11 if LIST(MAX) is set.
Option byte 7, bits 6-7 MXREF	00 if NOMXREF is set, 01 if MXREF(FULL) is set, 10 if MXREF(SOURCE) is set, or 11 if MXREF(XREF) is set.
Option byte 8, bit 0 PROFILE	1 if the PROFILE option is set.
Option byte 8, bit 1 PCONTROL(OFF)	1 if the PCONTROL(OFF) option is set.
Option byte 8, bit 2 PCONTROL(NODATA)	1 if the PCONTROL(NODATA) option is set.
Option byte 8, bit 3 PCONTROL(NOGEN)	1 if the PCONTROL(NOGEN) option is set.
Option byte 8, bit 4 PCONTROL(NOUHEAD)	1 if the PCONTROL(NOUHEAD) option is set.
Option byte 8, bit 5 PCONTROL(NOMSOURCE)	1 if the PCONTROL(NOMSOURCE) option is set.
Option byte 8, bit 6 PCONTROL(NOMCALL)	1 if the PCONTROL(NOMCALL) option is set.
Option byte 8, bit 7 XREF(UNREFS)	1 if the XREF(UNREFS) option is set.
USING(WARN(nn)) value	The sum of 1 if FLAG(USINGDUP) is set, 2 if FLAG(USINGZERO) is set, 4 if FLAG(USINGMULT) is set, and 8 if USINGLIMIT is set.
FLAG(nnn) value	Set to the FLAG(nnn) value.
Option byte 9, bit 0 RXREF	1 if the RXREF(GR) option is set.
Option byte 9, bit 1 FLAG(IMPLEN)	1 if the FLAG(IMPLEN) option is set.
Option byte 9, bit 2 FLAG(PAGE0)	1 if the FLAG(PAGE0) or FLAG(REFPAGE0) option is set.
Option byte 9, bit 3 INFO	1 if the INFO option is set.
Option byte 9, bit 4 COMPAT(LITTYPE)	1 if the COMPAT(LITTYPE) option is set.
Option byte 9, bit 5 FLAG(PUSH)	1 if the FLAG(PUSH) option is set.
Option byte 9, bit 6 FLAG(USING0)	1 if the FLAG(USING0) option is set.
Option byte 9, bit 7 THREAD	1 if the PROCESS(THREAD) option is set.
TRANSLATE(xx) value	Set to the TRANSLATE(xx) value.
PROFILE(xxxxxxxx) value	Set to the PROFILE(xxxxxxxx) value.
USING(LIMIT(nnnn)) value	Set to the USINGLIMIT(nnnn) value.
LANGUAGE(xx) value	Set to the LANGUAGE(xx) value.
OPTABLE(xxx) value	Set to the OPTABLE(xxx) value.
LINECOUNT(nnnn) value	Set to the LINECOUNT(nnnn) value.
INEXIT program length	Always 0.
LIBEXIT program length	Always 0.
OBJEXIT program length	Always 0.
PRTEXIT program length	Always 0.
ADEXIT program length	Always 0.
TRMEXIT program length	Always 0.
INEXIT string length	Always 0.
LIBEXIT string length	Always 0.
OBJEXIT string length	Always 0.
PRTEXIT string length	Always 0.
ADEXIT string length	Always 0.
TRMEXIT string length	Always 0.
SYSPARM length	Set to the length of the SYSPARM option value.
PARM length	Set to the length of the last specified PARM option value.
CODEPAGE	If the CODEPAGE option is set, the value is the EBCDIC code page number in hexadecimal. If the CODEPAGE option is disabled, the value is blank.
INEXIT program	Not supported.
LIBEXIT program	Not supported.
OBJEXIT program	Not supported.
PRTEXIT program	Not supported.
ADEXIT program	Not supported.
TRMEXIT program	Not supported.
INEXIT string	Not supported.
LIBEXIT string	Not supported.
OBJEXIT string	Not supported.
PRTEXIT string	Not supported.
ADEXIT string	Not supported.
TRMEXIT string	Not supported.
SYSPARM string	Set to the SYSPARM option value.
PARM string	Set to the last specified PARM option value.

External Symbol Dictionary Record - X'0020'

Field Name	Support
Section type	Supported.
Flags	Supported.
ESDID	Supported.
Section address	Supported.
Section length	Supported.
Owner ID	Supported.
External name offset	Supported. No field for ADATALEVEL(4).
External name length	Supported.
Alias name offset	Supported. No field for ADATALEVEL(4).
Alias name length	Supported.
External name	Supported.
Alias name	Supported. If the OBJECT(ELF) option is set, this field will be in ASCII.

Source Analysis Record - X'0030'

Field Name	Support
Statement Number	Supported.
ESDID	Supported.
Input record number	Supported.
Parent record number	Supported.
Input file number	Supported.
Parent file number	Supported.
Location counter	Supported.
Input record origin	Supported.
Parent record origin	Supported.
Print flags	Supported.
Source type	Supported.
Assembler operation code	Supported.
Flags	Supported.
Address 1	Supported.
Address 2	Supported.
Offset of name entry	Supported.
Length of name entry	Supported, this field is zero if there is a sequence symbol in the name field.
Offset of operation entry	Supported.
Length of operation entry	Supported.
Offset of operand entry	Supported.
Length of operand entry	Supported.
Offset of remarks entry	Supported.
Length of remarks entry	Supported.
Offset of continuation indicator field	Supported.
Offset of input macro or copy member name	Supported. No field for ADATALEVEL(4).
Length of input macro or copy member name	Supported.
Offset of parent macro or copy member name	Supported. No field for ADATALEVEL(4).
Length of parent macro or copy member name	Supported.
Offset of source record	Supported. No field for ADATALEVEL(4).
Length of source record	Supported.
Input member name	Supported.
Parent member name	Supported.
Source record	Supported.

Source Error Record - X'0032'

Field Name	Support
Statement Number	Supported.
Error identifier	Set to the Tachyon z/Assembler message identifier
Error severity	Supported.
Error message offset	Supported. No field for ADATALEVEL(4).
Error message length	Supported.
Error message	Supported.

DC / DS Record - X'0034'

Field Name	Support
ESDID	Supported.
Number of operands	Supported.
Type flags	Supported.
Statement Number	Supported.
Location counter	Supported.
Duplication factor	Supported.
Bit offset	Supported.
Type attribute	Supported.
Number of values	Supported.
Type extension	Supported.
Byte length	Supported.
Bit length	Supported.
Value	Supported.

DC / DS Extension Record - X'0035'

Field Name	Support
ESDID	Supported.
Location counter	Supported.
Statement Number	Supported.
Length of object text	Supported.
Object text	Supported.

Machine Instruction Record - X'0036'

Field Name	Support
ESDID	Supported.
Location counter	Supported.
Length of instruction	Supported.
Value of instruction	Supported.

Relocation Dictionary Record - X'0040'

Field Name	Support
POS. ID	Supported.
REL. ID	Supported.
Address	Supported.
Flags	Supported.

Symbol Record - X'0042'

Field Name	Support
ESDID	Supported.
Statement number	Supported.
Symbol type	Supported, undefined (type 0) and duplicate (type 9) symbols are never produced and separate V-type constant (type 5) symbols are not produced if a symbol by the same name also exists.
Type attribute	Supported.
Duplication factor	Supported.
Length attribute	Supported.
Integer attribute	Supported.
Scale attribute	Supported.
Location counter	Supported.
Symbol flags	Supported.
Symbol name length	Supported.
Symbol name	Supported.

Symbol Cross Reference Record - X'0044'

Field Name	Support
Symbol length	Supported.
Statement definition	Supported.
Number of references	Supported.
Relocatability type	Supported.
Symbol name	Supported.
Reference flag	Supported.
Statement number	Supported.

Register Cross Reference Record - X'0045'

Field Name	Support
Register number	Supported.
Register type	Supported.
Total number of references	Supported.
Number of references in this record	Supported.
Offset to references	Supported.
Statement number	Supported.
Reference flag	Supported.

Library Record - X'0060'

Field Name	Support
Number of macros / copy code members	Supported.
Data set name length	Supported.
Data set volume length	Supported.
Concatination number	Supported.
DDNAME length	Supported.
Data set name	Supported.
Data set volume	Supported for MVS only.
DDNAME	Supported.
Macro name length	Supported.
Macro name	Supported.

Library Member and Macro Cross Reference Record - X'0062'

Field Name	Support
Concatination number	Supported.
Statement definition	Supported.
Concatination type	Supported.
Statement definition flag	Supported.
Member or macro name	Supported.
Parent macro name	Supported.
Number of references	Supported.
Number of references in this record	Supported.
Reference statement number	Supported.
Reference flag	Supported.

User Supplied Information Record - X'0070'

Field Name	Support
User field 1	Supported.
User field 2	Supported.
User field 3	Supported.
User field 4	Supported.
User data length	Supported.
User data	Supported.

USING Map Record - X'0080'

Field Name	Support
Record type	Supported.
USING flag	Supported.
Location ESDID	Supported.
Statement number	Supported.
Location counter	Supported.
USING value	Supported.
Last statement	Supported.
USING ESDID	Supported.
Register	Supported.
Displacement	Supported.
USING range	Supported.
Label length	Supported.
Label	Supported.

Statistics Record - X'0090'

Field Name	Support
Buffer pool allocation	Always 0.
Required in storage	Always 0.
Primary input records	Supported.
Library records read	Supported.
Work file reads	Supported.
Print records written	Supported.
Object records written	Supported.
Work file writes	Supported.
ADATA records written	Supported.
ADATA calls	Always 0.
ADATA added records	Always 0.
ADATA deleted records	Always 0.
ADATA diagnostic messages	Always 0.
Library calls	Always 0.
Library added records	Always 0.
Library deleted records	Always 0.
Library diagnostic messages	Always 0.
Listing calls	Always 0.
Listing added records	Always 0.
Listing deleted records	Always 0.
Listing diagnostic messages	Always 0.
Object calls	Always 0.
Object added records	Always 0.
Object deleted records	Always 0.
Object diagnostic messages	Always 0.
Source calls	Always 0.
Source added records	Always 0.
Source deleted records	Always 0.
Source diagnostic messages	Always 0.
Punch calls	Always 0.
Punch added records	Always 0.
Punch deleted records	Always 0.
Punch diagnostic messages	Always 0.
Term calls	Always 0.
Term added records	Always 0.
Term deleted records	Always 0.
Term diagnostic messages	Always 0.
Assembly start time	Supported.
Assembly stop time	Supported.
Processor time	Always 0.
Option file records read	Supported.
Number of external functions loaded	Supported.
Offset of first external function section	Supported. No field for ADATALEVEL(4).
Number of messages suppressed	Supported. No field for ADATALEVEL(4).
Offset to first suppressed message section	Supported. No field for ADATALEVEL(4).
SETAF function calls	Supported.
SETCF function calls	Supported.
External function messages	Supported.
External function message severity	Supported.
External function name length	Supported.
External function name	Supported.
Suppressed message number	Supported. No field for ADATALEVEL(4).
Number of times messages was suppressed	Supported. No field for ADATALEVEL(4).