HPlogo System Debug Reference Manual > Chapter 6 System Debug Command Specifications M-X

MAP

MPE documents

Complete PDF
Table of Contents
Index

E0201 Edition 4 ♥
E0300 Edition 3
E0692 Edition 3

Opens a file and maps it into a usable virtual address space.

Syntax


   MAP filename [option]
The MAP command allows a file to be accessed (displayed or modified) in virtual space by other System Debug commands. This command is useful for analyzing dump files generated by subsystems that are not part of the dump created by the DUMP utility.

Parameters

filename

The file name of the file to map into usable address space.

option

Read or read/write access can be explicitly requested, a filecode can be specified, and a virtual offset set be specified. Multiple options can be specified for a single MAP command.

READACCESS

Open the file for read access only (default). Users with PM capability can still write to the file (file system feature).

WRITEACCESS

Open the file for read/write access. Standard file system security checking is performed while opening the file.

FILECODE value

Privileged files cannot be accessed without providing the numeric file code associated with the file. This keyword/value pair allows privileged users to map in these privileged files. Remember that file codes are thought of as negative decimal numbers.

OFFSET value

Map the file, starting at the specified virtual byte offset. The default offset is 0.

Examples


   $nmdebug > map DTCDUMP
   1  DTCDUMP.DUMPUSER.SUPPORT     1000.0  Bytes = 43dc
Open the file DTCDUMP and assign it to the virtual object in space $1000. It is mapped to file index number 1. Use this number to UNMAP the file. 

   $nmdebug > map DATA2 off c0004c00
   2  DATA2.DUMPUSER.SUPPORT     1000.1c004c00. Bytes = 2340
Map the file DATA2 at a specified virtual offset of $c0004c00.

Related commands: MAPLIST, UNMAP.

Related functions: MAPINDEX, MAPVA, MAPSIZE.

Limitations, Restrictions

A maximum of ten files can be mapped in at any one time.

It is not currently possible to map a file if it is already open and loaded for execution. Refer to the HPFOPEN intrinsic description in the MPE XL Intrinsic Reference Manual for additional details.



MACTRACE

MAPL[IST]