Opens a file and maps it into a usable virtual address space.
Syntax |
 |
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, in 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.
