XMSC

Type

OMEGAMON Immediate command (Authorized)

Description

Scans storage in the z/OS address space for a string of data and displays the location.

XMSC scans z/OS address space for a string of hex or character values. If the scan is successful, OMEGAMON displays the string.

aXMSCc targ,addr,string,slen,dlen

a

A required action character in column 1.

-

Changes to a comment character (>) after the command executes.

<

Does not change to a comment character after the command executes. Use this action character to repeat the command.

c

The format of the output.

B or ␢

hex and character (default)

C

character only

X

hex only

targ

The target z/OS address space. It can be:

nnnn

decimal ASID number

cccccccc

jobname

addr

The start address of the scan.

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 string. The default is 16 (X'10') bytes.

In the next screen display, XMSC scans 1000 bytes in the target z/OS address space specified by the jobname USER14, starting at location 515988 for the character string WORKAREA. If the scan is successful, OMEGAMON displays 14 hex bytes in hex and character format starting at WORKAREA.

-XMSC  USER14,515988,’WORKAREA’,1000,14 

The following output appears if the scan is successful.

>XMSC  USER14,515988,’WORKAREA’,1000,14
>storage at 00515988 in USER14 ASID=21:
> 1B8  E6D6D9D2 C1D9C5C1 00000000 000C0000  *WORKAREA........*
> 1C8  000C002C                             *....* 

Related Information

Other Storage Scan commands: MCHN, MSCN, and XMCH