MSCN

Type

OMEGAMON Immediate command (Authorized)

Description

Scans storage for a string of data and displays the location. MSCN scans the address space in which OMEGAMON resides for a string of hex or character values. If the scan is successful, OMEGAMON displays the string.

MSCNc addr,string,slen,dlen

c

The format of the output.

B or ␢

hex and character (default)

C

character only

X

hex only

addr

The first address of storage that OMEGAMON scans.

You can specify, modify, or pre-define an address (addr) for commands that display or modify storage or data-only spaces. An address consists of an anchor, optional modifiers, and an optional pre-defined name.

An anchor is the base address of an address specification. It can be:

absolute

The hexadecimal address.

symbolic

Up to eight alphanumeric characters, including @, #, and $.

You can supply one or more modifiers to change the location that the anchor points to. A modifier can be:

offset

A plus sign (+) or minus sign (-), followed by a hexadecimal number.

This modifier specifies a location at a known offset (positive or negative) from the anchor address.

indirect

Use a question mark (?) as the symbol for 31-bit addressing. Use a percent sign (%) as the symbol for 24-bit addressing. Use an exclamation point (!) as the symbol for 64-bit addressing.

This modifier indicates that the location pointed to is itself an address.

string

The hex string OMEGAMON uses for the scan. If you enclose it in single quotes, OMEGAMON assumes it is a character string.

Note: OMEGAMON interprets two single quotes (’’) within a character string as a single quote (’).

slen

The number (up to eight hex digits) of bytes that OMEGAMON scans. The default is 256 (X'100') bytes.

dlen

The number (up to eight hex digits) of bytes that OMEGAMON displays if the scan is successful. The display starts at the beginning of the string. The default is 16 (X'10') bytes.

In the next screen display, MSCN scans the first 1000 bytes of the TIOT entry for the character string OMHELP and displays 14 hex bytes starting at that point. The display is in both hex and character formats.

 MSCN 10??+4?+C?,’OMHELP’,1000,14 

Typical output of the MSCN command is shown here.

MSCN 10??+4?+C?,’OMHELP’,1000,14                                 Addr=0061701C
+ 0000  D6C3C8C5 D3D74040 60BCA000 80001B00  *OMHELP  -.......*
+ 0010  14010100                             *....            * 

Related Information

Other Storage Scan commands: MCHN, XMCH, and XMSC