HIS MAP format

The following tables describe the format of the HIS MAP file. First a general format description is provided, which describes format information that is consistent across the various record types. Then the formats of the various record types which are included in the MAP file are provided. The map file consists of the following record types:

Information records which provide basic information about the system and the MAP file.
Boundary records which provide information about various virtual storage boundary areas (Private, LPA, CSA, SQA, etc.).
Address space records which describe the various address spaces on the system.
Module records which describe the various modules loaded on the system.
CSECT records which describe Control Sections found within a module.
Entry Point records with describe the Entry Points within a Nucleus CSECT.

HIS MAP format general description

Table 1. General map record header format
General map record header format
Field Name	Offset	Length	Format	Description
MapRecordType	0	1	Text	I=Information, A= AddressSpace, B=Boundary, M=Module, C=CSECT, E=EntryPoint
MapMemoryArea	1	1	Text	N=Nucleus, M= MLPA, P=PLPA, F=FLPA, X=Private area, C=Common area
MapType / MapASID	2	4	Printable Hex	ASID (for Private area) or Record Type (for other records)
MapName	6	8	Text	Short name (may be blank, may not be unique)
MapStartAddress	14	16	Printable Hex	Start address (Record types B, M, C and E only)
MapEndAddress	30	16	Printable Hex	End address (Record types B, M, and C only)

HIS MAP format by record type

Table 2. Type I - Information record
Type I - Information record
Field Name	Offset	Length	Format	Description
MapRecordType	0	1	Text	"I"=Information
MapMemoryArea	1	1	Text	Blank (x'40' in EBCDIC)
MapType	2	4	Text	"SYS", "SMFI", "OS", 'FMID", "DATE", "TIME", "MAP", "LPID", "MACH", "MODE"
MapName	6	8	Text	Value

	Information record names and values:
	Name	Value	Example	Description
	SYS	tttttttt	SYS1	System name
	SMFI	tttt	SYS1	SMFID
	OS	tttttttt	z/OS	Operating System name
	FMID	tttttttt	HBB7790	Field Maintenance ID (FMID)
	z/OS	vv.rr.mm	02.01.00	z/OS version.release.mod (from ECVTPVER, ECVTPREL, ECVTP= MOD)
	DATE	yyddd	13206	Date for this map, Julian format, yyddd
	TIME	hhmmsshh	20262609	Time for this map, hhmmsshh format hours, minutes, seconds, hundredths of a second
	MAP	xx.yy	02.01	Map version number
	MODE	64-BIT	64-BIT	Indicates 64-bit addresses
	LPID	nnnn	0001	LPAR ID number
	MACH	tttt	2817	Machine model (e.g. 2817)

Table 3. Type B = Boundary record
Type B = Boundary record
Field Name	Offset	Length	Format	Description
MapRecordType	0	1	Text	"B"=Boundary
MapMemoryArea	1	1	Text	Blank (x'40' in EBCDIC, x'20' in ASCII)
MapType	2	4	Text	"BDY "
MapName	6	8	Text	Memory area (PRIVATE, CSA, CSAALLOC, CSACONVT, MLPA, FLPA, PLPA, SQA, SQAALLOC, RWNUC, RON, ERON, ERWN, ESQA, EPLPA, EFLPA, EMLPA, ECSA, EPRV, DONUC)
MapStartAddress	14	16	Printable Hex	Start address for this memory area
MapEndAddress	30	16	Printable Hex	End address for this memory area

Table 4. Type A = Address Space record
Type A = Address Space record
Field Name	Offset	Length	Format	Description
MapRecordType	0	1	Text	"A"=Address Space
MapMemoryArea	1	1	Text	"X"=Private area
MapASID	2	4	Printable Hex	ASID for this address space
MapName	6	8	Text	JOB name for this address space

Table 5. Type M = Module record
Type M = Module record
Field Name	Offset	Length	Format	Description
MapRecordType	0	1	Text	"M"=Module
MapMemoryArea	1	1	Text	"N"=Nucleus, "M"=MLPA, "P"=PLPA, "F"=FLPA, "X"=Private area, "C"=Common area including Dynamic LPA
MapType / MapASID	2	4	Printable Hex	ASID (if loaded from an address space to Private area or Common area) or Record Type (NUC, MLPA, FLPA, PLPA, COMM (other Common area modules, Dynamic LPA))
MapName	6	8	Text	Module name
MapStartAddress	14	16	Printable Hex	Module Start address
MapEndAddress	30	16	Printable Hex	Module End address
Note: Module record may end here
Module record - self-describing section
Field Name	Offset	Length	Format	Description
MapModSDSlength	46	2	Printable Hex	"12" - Length of the module record self-describing section
MapModLocOffset	48	4	Printable Hex	Offset of module location section (0000 if no section)
MapModLocLength	52	4	Printable Hex	Length of module location section (0000 if no section)
MapModTimeOffset	56	4	Printable Hex	Offset of module load time section (0000 if no section)
MapModTimeLength	60	4	Printable Hex	Length of module load time section (0000 if no section)
Module record - module location section
Field Name	Offset	Length	Format	Description
MapModLocType	MapModLocOffset	1	Text	Type of module location section, "D"=Dataset, "P"=Pathname, "C"=Concatenation
MapModByType	MapModLocOffset	MapModLocLength	Text	Format based on MapModLocType (see below)
Module record - module location section (Type=D)
Field Name	Offset	Length	Format	Description
MapModLocType	MapModLocOffset	1	Text	"D"=Dataset
MapModLocVOLSER	1	6	Text	Volume Serial for this Dataset
MapModLocDSNLen	7	2	Printable Hex	Length of the MapModLocDSN value
MapModLocDSN	9	MapModLocDSNLen	Text	Dataset Name
Module record - module location section (Type=P)
Field Name	Offset	Length	Format	Description
MapModLocType	MapModLocOffset	1	Text	"P"=Pathname
MapModLocPathLen	1	4	Printable Hex	Length of the LocPathname field
MapModLocPathname	5	MapModLocPathLen	Text	Pathname
Module record - module location section (Type=C)
Field Name	Offset	Length	Format	Description
MapModLocType	MapModLocOffset	1	Text	"C"=Concatenation
MapModLocConcat	1	8	Text	Concatenation Name, "LPALST"
Module record - module load time section
Field Name	Offset	Length	Format	Description
MapModTimeTOD	MapModTimeOffset	16	Printable Hex	Time in TOD format

Table 6. Type C= CSECT record
Type C= CSECT record
Field Name	Offset	Length	Format	Description
MapRecordType	0	1	Text	"C"=CSECT
MapMemoryArea	1	1	Text	"N"=Nucleus, "M"=MLPA, "P"=PLPA, "F"=FLPA, "X"=Private area, "C"=Common area
MapType / MapASID	2	4	Printable Hex	ASID (if loaded from private area) or Record Type (NUC, MLPA, FLPA, PLPA, COMM)
MapName	6	8	Text	CSECT name up to 8 bytes (may be blank, may not be unique)
MapStartAddress	14	16	Printable Hex	CSECT Start address
MapEndAddress	30	16	Printable Hex	CSECT End address
Note: CSECT record may end here
CSECT record - self-describing section
Field Name	Offset	Length	Format	Description
MapCsectSDSlength	46	2	Printable Hex	"0A" - Length of the CSECT record self-describing section
MapCsectLongNmOffset	48	4	Printable Hex	Offset of CSECT Long Name section
MapCsectLongNmLength	52	4	Printable Hex	Length of CSECT Long Name section (0 indicates no section)
CSECT record - CSECT Long Name section
Field Name	Offset	Length	Format	Description
MapCsectLongName	MapCsectLongNmOffset	MapCsectLongNmLength	Text	CSECT Long Name (if longer than 8 bytes)

Table 7. Type E = Entry Point
Type E= Entry Point
Field Name	Offset	Length	Format	Description
MapRecordType	0	1	Text	E=Entry Point
MapMemoryArea	1	1	Text	N=Nucleus
MapType	2	4	Printable Hex	"NUC"=Nucleus
MapName	6	8	Text	Entry Point name
MapStartAddress	14	16	Printable Hex	Entry Point address