OMEGAMON Commands

Use this panel to issue session and maintenance commands that are not on the OMEGAMON® for Db2 PE product panels.


________________ ZCOMM    VTM     O2       V550.#P DA41 11/06/13 11:20:45   2 
>       Help PF1                                               Back PF3        
> M.F                                                                          
===============================================================================
>                        OMEGAMON COMMANDS                                     
                                                                               
> Enter OMEGAMON commands below

Navigation

For additional information about other topics, use the PF keys.

Commands

The fields in this panel vary according to the command issued. To issue a command that begins with a forward slash (/), type the command on the top line of the panel and press Enter. To issue a command that begins with a period (.) or any letter, type the command on any line of the general display area (any line below the prompt) and press Enter. The commands you can issue are described below in alphabetical order.

...bb

The blank command clears the panel from the command down to the end of the logical panel (b indicates a blank).

====

The separator line command draws a separator line across the panel.

The format is:


c====aa

This command repeats the characters aa across the panel. You can use any two characters as a separator line.

On the 3279 color terminal with extended color on, the optional label c specifies the color of the separator line with the first letter of the color name. It can be: (R)ed, (B)lue, (G)reen, (W)hite, (T)urquoise, (Y)ellow, or (P)ink.

For example, the following command creates a line of red pluses across the panel preceded by 4 equal signs.


R====++

The line looks like this:


====+++++++++++++++++++++++++++++++++++++++++++

/ATTN

Emulates the PA1 (program attention) key. /ATTN clears the panel, resets your password to zero, returns to default basic color settings, and turns off extended color.

/AUP

Enables (/AUP ON) or disables (/AUP OFF) automatic update mode. /AUP applies in VTAM® mode only. Automatic update mode is similar to running OMEGAMON for Db2 PE in dedicated mode, because the panel updates at regular intervals without pressing Enter. .AUP performs the same functions.

Note: Some network programs do not support automatic update mode (for example, a program that emulates a terminal for your OMEGAMON for Db2 PE VTAM mode session).

.AUP

Enables (.AUPON) or disables (.AUPOFF) automatic update mode. If you type .AUP (without ON or OFF), OMEGAMON for Db2 PE displays the current automatic update mode status. .AUP applies in VTAM mode only. Automatic update mode is similar to running OMEGAMON for Db2 PE in dedicated mode, because the panel updates at regular intervals without pressing Enter. /AUP performs the same functions.

Note: Some network programs do not support automatic update mode (for example, a program that emulates a terminal for your OMEGAMON for Db2 PE for VTAM mode session).

/BOTTOM

Scrolls to the bottom of the logical panel.

CN

Allocate/open (.CN OP) a secondary console, deallocate/close (.CN CL) a secondary console, swap master/secondary consoles (.CN SW), or set the address of the secondary console (.CNxxx).

In dedicated mode, you can set up a secondary OMEGAMON for Db2 PE console to be used for output only. The secondary console echos everything that is displayed on the primary console, but accepts no commands or input of any kind.

The secondary console must be the same terminal type as the primary console.

/D

Scrolls down the amount specified by its argument (/D cccc)

/D is an alias for /DOWN. See the description of the /DOWN command for information about the command arguments.

.D

Deletes nn lines (.Dbb nn) on the physical panel.

This command deletes lines beginning with the current line.

/DCL

Deletes all comment lines in the panel.

If you want to delete only those comment lines below a certain point in the panel, use the equivalent immediate command instead.

.DCL

Deletes all comment lines below its entry line.

If you want to delete all comment lines in the panel, use the equivalent INFO-line command instead. Unlike most other immediate commands, .DCL disappears after it executes.

.DDb

Deletes a block of data.

To delete a block of data from the physical panel, enter .DD on the first line of the block and .DD on the last line.

For example, the following command deletes 4 lines. The first blank line and the succeeding 3 lines are deleted and removed from the panel.


.DDb
 DISK   SYSB24   TSO021   SYSB21   MVSA21
 DSKB   MVSA21   PROD05   SYSA24
 .DDb 150      334      D8B

DDEV

Displays DASD device statistics for all or specified volumes.

Note: RMF must be active to use this command because the data displayed is from RMF.

You must use the DDEV minor commands to specify the criteria under which the device statistics are displayed.

PDSK

Displays statistics for devices whose names meet a specified pattern. Type PDSK on a separate line after DDEV. You can use PDSK to display statistics for the following:

All devices using PDSK and an asterisk (*).
```
Example:
DDEV
PDSK*
```
A specific device using PDSK and a volume name. (volser).
```
Example:
DDEV
PDSK OMON22
```
A group of devices using PDSK and part of a volume name followed by the asterisk wildcard character (*).
```
Example:
DDEV
PDSK OMON*
```

XDSK

Displays statistics for devices that exceed a specified threshold. To specify thresholds, enter one or more of the following XDSK minor commands, either before you type DDEV, or between DDEV and XDSK:

AVQnnn

Specifies the average IOS queue depth. Average length > nn.n.

RSPnnn

Specifies the average total response time> nnn milliseconds.

IOSnnn

Specifies the average device queue time > nnn milliseconds.

CONnnn

Specifies the average device connect time > nnn milliseconds.

DSCnnn

Specifies the average device disconnect time > nnn milliseconds.

DUTnnn

Specifies the average device utilization >nnn %.

PNDnnn

Specifies average device request pending time > nnn milliseconds.


Example:

The following command displays statistics for devices whose utilization is greater than 30%.


DDEV
DUT 30
XDSK

Sample Output: The following example shows the fields displayed by the DDEV command (with either PDSK or XDSK). If you enter DDEV without a minor command, only the first line of output is displayed.


  DDEV  Interval Start Time: 10:44:02     Elapsed:  3:30 MN   Length: 14        
pdsk  OMON*     <-– Volser Pattern                                              
+       Volser  I/O per second  Util% Avg.Q   Resp = IOSQ + Pend + Conn         
+      —–—–—–  —–—–—–—–—–—–—–  —–—–— —–—–— —–—–—–— —–—–—– –—–—–— —–—–—–         
+    14B OMON27              .1                1.0                              
+    151 OMON28              .2    .6         12.5            .3    6.2         
+    153 OMON29                               23.0            .2    2.0

Interval Start Time: The start time of the RMF interval during which these statistics are being collected.
Elapsed: The number of minutes and seconds elapsed since the beginning of this RMF interval.
Length: The length of this RMF interval in minutes and seconds.

The first column contains the device address in hexadecimal notation (for example, 14B).

Volser: Volume name.
I/O per second: I/O rate for this device.
Util %: Device utilization percentage.
Avg Q: Average I/O queue depth.
Resp: Average total device response time in milliseconds.
IOSQ: Average I/O queue time in milliseconds.
Pend: Average pending time in milliseconds.
Conn: Average connect time in milliseconds.
Disc: Average disconnect time in milliseconds.

/DEF

Sets definition mode (/DEF cccc).

ON: Defines a panel space, which includes commands that comment themselves out or otherwise change form after execution. /DEF ON inhibits automatic updating of a dedicated or VTAM mode session. After you set definition mode with /DEF ON, it remains in effect until you issue /DEF OFF, or save or replace the panel space.
HOLD: Same as ON argument, but definition mode remains in effect after you save a panel space. It is only canceled when you issue /DEF OFF. Use this option when you want to save two or more panels in a row without reactivating definition mode each time.
OFF: Restores normal panel updating (cancels the effect of /DEF ON or /DEF HOLD).

DELT

Deletes a panel space from main storage or the user's panel space library (RKO2PCSV). It does not delete from the IBM-supplied panel space library (RKO2PROC).

The format is:


DELTc aaaaaaaaa

c

One of the following arguments that specifies the location of the panel space. Enter it in column 6:

I: Deletes from main storage (in-storage) only.
D: Deletes from RKO2PCSV only.
B or b: Deletes from both main storage and RKO2PCSV (default).

aaaaaaaa

The panel space name you want to delete. Specify the name starting in column 8.

Note: OMEGAMON for Db2 PE does not substitute special characters for the DELT command. You must enter the real member name.

For example, the following command deletes panel space SAMPLE from main storage.


DELTI SAMPLE

/DOWN

Scrolls down the amount of lines specified by argument cccc.

/DOWN works only if the number of logical rows (LROWS) is defined to a number greater than the number of physical rows on this terminal. This definition can be changed with the LROWS startup parameter.

The format is:


/DOWN cccc

where cccc is one of the following:

nnn: Scrolls nnn lines (from 1 - 999).
BOT: Scrolls to the last logical row.
CSR: Scrolls according to the current location of the cursor. If the cursor is on the INFO-line, the scroll amount is a page.
MAX: Scrolls down the number of LROWS defined for your terminal.
PAGE: Scrolls down so that the current cursor position is at the bottom of the physical panel. This is the default.

For example, the following command scrolls the display 24 lines (one panel and one line on a 3278 model 2 terminal).


/DOWN 24

If you assign the /DOWN command to a PF key (the default is F20), you can type any of the optional arguments on the INFO-line before you press the PF key. OMEGAMON for Db2 PE interprets the entry as if you type the command plus the argument.

/D is an alias for /DOWN.

.DSA

Sets and displays authorization to list or zap non-shareable data-only spaces. The .DSA command provides a mechanism to limit the scope of the listing and zapping commands to data-only spaces that have been defined by the owner as shareable by other address spaces.

Command operands:

ON: Turns on data-only space authorization. Access is allowed to all data-only spaces.
OFF: Turns off data-only space authorization. Access is restricted to shareable spaces only.

Entering .DSA with no operand displays the current status of data-only space authorization.

.EXP

Displays the expiration date after which OMEGAMON for Db2 PE will not function.

Product updates contain new features, support for new IBM® releases, enhanced operations, and maintenance. It is in your best interest to reinstall the product each time it is updated to keep current with enhancements and updates. For more information, see Configuration and Customization.

.FGO

Provides fast access to panel space cccccccc.

The .FGO (Fast GO) command is used when creating panel spaces to fetch the next panel space of a series. Panel spaces can be chained together and executed very quickly, bypassing the panel display and the OMEGAMON for Db2 PE cyclical wait.

.FGO has a conditional panel fetch feature that fetches a panel space only if a condition is true.

Command operands:

cccccccc: Specifies the name of a panel space.
CPSER: Compares the CPU serial number.
MODE: Compares the 3-character OMEGAMON for Db2 PE mode ID as displayed on the INFO-line (for example, DED, VTS, VTM).
OPSYS: Compares the 3-character ID for the operating system level (NSE, SE2, SP3, XA1).
SMFID: Compares the 4-character SMF ID.
UNIT: Compares the terminal address of the primary OMEGAMON for Db2 PE console (only in dedicated mode).
USER: Compares the suffix of the user profile.
&VAR: Sets any comparison. The keyword and argument can be any variable name set with the .VAR command or any OMEGAMON for Db2 PE-defined variable.
=: Keyword equals argument. The equal sign can be entered without blanks on either side of it.
EQ: Keyword equals argument. Same as equal sign (=).
GE: Keyword is greater than or equal to argument.
GT: Keyword is greater than argument.
LE: Keyword is less than or equal to argument.
LT: Keyword is less than argument.
NE: Keyword is not equal to argument.
argument: The argument is a 1- to 8-character value to which OMEGAMON for Db2 PE compares the keyword.

Example:

To fetch panel space SAMPLE only if the terminal address 05E1, enter:


.FGO SAMPLE UNIT=05E1


.FGO SAMPLE UNIT EQ 05E1

To protect against the possibility of a looping condition caused by the .FGO command, OMEGAMON for Db2 PE limits the number of consecutive fetches allowed (64 by default). After the limit is reached, .FGO acts like .SGO (Screen Go) so that executing panel spaces will display on each cycle. Therefore, if there was a loop caused by .FGO panel spaces, correct the condition and re-enable .FGO with the FGOLOOP keyword of the .SET command.

Because FGOLOOP=ON causes .FGO not to bypass the OMEGAMON for Db2 PE cycle and the terminal display, you can turn it on to test your panel space fetch routines.

If multiple .FGO commands are displayed on one panel, the last one that is executable takes precedence.

See also the .SGO command.

GDFN

Defines an exception group for exception analysis.

You can use GDFN to define a group to which exceptions can be assigned, to add exceptions to an existing group, to delete exceptions from a specific group, and to delete an entire group.

Note: An exception can be associated with only one group at a time. You can delete an exception from one group and reassign it to another group.

The format is:


GDFN GROUP=cc, NAME='cc..cc', LIST=cc,aa, 
DELETE=EXCEPTION, DELETE=GROUP,POSITION=nn

GROUP=cc: The 2-character exception group ID. For an existing group, use this keyword to display only the entries for that group.
NAME='cc..cc': A 25-character user-defined description of the exception group. Enclose in single quotes (') if there are blanks, special characters, or single quotes (') in the name.
LIST=cc,aa: Identifies the exceptions to be added to or deleted from the specified exception group.
DELETE=EXCEPTION: Causes the deletion of the exceptions specified with LIST= from the group specified by GROUP=.
POSITION=nn: Specifies the order of the display.

/H

Describes the HELP facilities.

/H is an alias for /HELP

/HELP

Describes the HELP facilities.

The help panel space informs you how to find out more about the functions, features, and operation of OMEGAMON for Db2 PE.

Note: This command works with or without a forward slash (/).

/HOLD

Controls the execution of OMEGAMON for Db2 PE commands.

/HOLD ON suspends command execution until you enter /HOLD OFF. /HOLD OFF returns to normal OMEGAMON for Db2 PE command execution.

The /HOLD command is designed for users of VM/PASSTHRU. If you are not a user of VM/PASSTHRU, /HOLD functions the same as placing the cursor in column 1, row 1.

.I

Inserts nn blank lines (.Ibbnn) in the panel.

.ILC

Displays INFO-line commands or their help text.

The format is:


.ILC /cccccc

The variable /cccccc is an INFO-line command name. (The forward slash (/) is optional.) To display all of the INFO-line commands and their aliases, enter the .ILC command without a command name.

To display help text for a specific INFO-line command, enter .ILC followed by the command.

.LOG

Controls the report log:

.LOGON

Starts LOGGING. The same as .LOG ON.

.LOOFF

Stops LOGGING. The same as .LOG OFF.

.LOGOUT

Prints the current log and leaves it open. The command comments itself out to prevent the log from automatically resetting again on the next cycle.

.LOGPUSH

Saves the status of the log (ON or OFF), so that this status can be restored when you execute .LOGPOP. This capability can be used to manipulate the log's status in panel spaces invoked by .FGO or .SGO, then return it to its original state after these panel routines are complete. One of the following messages is displayed on the same line as the command:


>> Log inactive.  Status saved. <<


>> Log active.  Status saved. <<

.LOGPOP

Restores the log to the status in effect when you executed the last .LOGPUSH. One of the following messages is displayed on the same line as the command.


>> Log status restored to inactive. <<


>> Log status restored to active. <<

If you enter .LOG without an argument, OMEGAMON XE for Db2 PE displays the current status of the log.

/LOG is the equivalent INFO-line command; however, it does not accept the PUSH and POP arguments.

/LOGOUT

Sends the current OMEGAMON for Db2 PE REPORT log to the printer.

/O is an alias for /LOG with the OUT argument.

OMEGAMON for Db2 PE dynamically allocates REPORT to a SYSOUT equals A file with FREE equals CLOSE. This means that every time you enter the /LOGOUT command, the REPORT log is automatically spun off.

.LOG performs the same functions as /LOG, and additionally accepts the PUSH and POP arguments.

LSCR

Loads panel space members from the panel space library to main storage.

You can make panel spaces more available and more easily fetched by loading them into main storage with LSCR. For example, if a disk is not available, you can continue to invoke the panel spaces that you loaded into main storage with LSCR.

The format is:


LSCR  cccccccc  cccccccc  . . .  cccccccc

The variables cccccccc are panel space names. Specify panel space member names starting in column 8. You can load as many members as can fit on the input line.

For example, in the next command,OMEGAMON for Db2 PE attempts to load panel spaces ZZ1, ZZ2, and ZZ3 from the O2PROC data set to main storage.


LSCR  ZZ1 ZZ2 ZZ3

If OMEGAMON for Db2 PE cannot find panel space ZZ1, it displays the following messages:


+      OB1507 Member not found - ZZ1
+      OB1508 2 members loaded

MCHN

Scans common storage.

This command requires special authorization because its use causes additional system overhead to collect the necessary data. Before OMEGAMON for Db2 PE displays this data, you must enter a valid password using the /PWD command.

MCHN scans the elements of a table for a string of hex or character values. If the scan is successful, OMEGAMON for Db2 PE displays the table element that contains the string.

MCHN searches the address space in which OMEGAMON for Db2 PE resides. Use this command primarily to examine the MVS™ common area. Use XMCH to search other address spaces.

The format is:


MCHNc addr,string,olen,chain,dlen

c

The format of the output:

B or b: hex and character (default)
C: character only
X: hex only

addr

The address of the first table element that OMEGAMON XE for Db2 PE scans.

string

The hex string that OMEGAMON for Db2 PE uses for the scan. If you enclose it in single quotes ('), OMEGAMON for Db2 PE assumes it is a character string.

Note: OMEGAMON for Db2 PE interprets two single quotes (' '), within a character string as a single quote (').

olen

The offset (in hex bytes) to the string in the table element; the comparison starts at this point. You can precede olen by a plus sign (+) or a minus sign (-).

chain

The offset (in hex bytes) to the chain pointer (the location in the table element that contains the address of the next table element). You can precede chain by a plus sign (+) or minus sign (-).

dlen

The number of bytes (1 to 8 hex digits) that OMEGAMON XE for Db2 PE displays if the scan is successful. The display starts at the beginning of the string. The default is 16 (X ` 10 `) bytes.

Ensure that addr is the starting point of a table element. The address at addr + chain points to the next table element. The scan ends when the value at addr + chain is one of the following:

0
-1
addr (the table is a ring)

You can specify, modify, or pre-define an address (addr) for a storage display or modification command. 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

A hexadecimal number:

370: 1 to 6 digits
XA/ESA: 1 to 8 digits

symbolic

1- to 8-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:

370: 1 to 6 digits
XA/ESA: 1 to 8 digits

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

indirect

One of the following symbols:

%: for 24-bit (370) addressing
?: for 31-bit (XA/ESA) addressing

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

You can use these modifiers to create powerful and versatile address expressions. For example, the following address expression locates the TIOT of the currently executing MVS task:


10%%+4%+C%

10%

Treats the data at location X`10' as a 24-bit address. This is the address of the MVS CVT.

%

This second % treats the data at the start of the CVT as a 24-bit address. The first word of the CVT contains the address of a doubleword (8 bytes). The doubleword contains:

the address of the next TCB to dispatch (bytes 0 to 3)
the address of the currently dispatched TCB (bytes 4 to 7)

+4%

Adds X'04' to the address of the doubleword, and then treats the data at the displacement as a 24-bit address. This is the address of the currently dispatched TCB.

+c%

Adds X'0C' to the address of the TCB, and then treats the data at the displacement as a 24-bit address. This is the address of the TIOT.

You can specify or reference an address by a name consisting of 1- to 8-alphanumeric characters, including @, #, and $. The following command specifies address names.

The example below shows a typical MCHN command. In this example, MCHN scans a table that starts at location AAB6C8 and looks for the string D6C30199 that begins at the eighth byte of the table element; the address of the next table element is in the fourth word. By default, this command displays 16 bytes of the table element in hex and character notation.


MCHN AAB6C8,D6C30199,8,4

The following output is displayed if the scan is successful:


Addr=007DA000
MCHN AAB6C8,D6C30199,8,4
+ 0000  E2E2C3E3 00000000 D6C30199 00000000  *SSCT    OC r    
*

MLST

Displays bytes of memory from commonly addressable storage.

MLST displays the contents of commonly addressable storage such as the

common storage area (CSA)
system queue area (SQA)
nucleus

The format is:


MLSTc addr,dlen

c

The format of the output:

B or b: hex and character (default)
C: character only
X: hex only

addr

The first address of storage that OMEGAMON for Db2 PE displays. For more information about how to specify an address, see the MCHN command.

dlen

The number (1 to 8 hex digits) of bytes that OMEGAMON XE for Db2 PE displays. The default is 16 (X'10') bytes.

The following examples show uses of the MLST command.

MLST lists 32 (X'20') bytes starting at address 1EB0 in character format:


MLSTC 1EB0,20

Typical output is:


MLSTC 1EB0,20                                  Addr= 00001EB0
+000   *.........h.... .....167........*

MLST lists 16 (X'10') bytes starting at address FF32D6 in both hex and character formats:


MLST  FF32C1+15,10

Typical output is:


MLST  FF32C1+15,10                               Addr= 00FF32D6
+000  20280010 A18800F9 82F000FF 20400000   *....*h.9b0... ..*

.MOD

Shows OMEGAMON for Db2 PE module names and addresses.

The optional suffix A (.MODA) lists the module names in alphabetical order.

This command provides debugging information, including module names and start addresses. If OMEGAMON for Db2 PE encounters a program check, this information is useful to IBM Customer Support.

MSCN

Displays the location in storage of a specific string.

MSCN scans the common area and the address space in which OMEGAMON for Db2 PE resides for a string of hex or character values. If the scan is successful, OMEGAMON for Db2 PE displays the string. To scan the Db2 private area, use the XMSC command.

The format is:


MSCNc addr,string,slen dlen

c

The format of the output:

B or b: Hex and character (default)
C: Character only
X: Hex only

addr

The first address of storage that OMEGAMON for Db2 PE scans.

For more information about how to specify an address, see the MCHN command.

string

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

Note: OMEGAMON for Db2 PE interprets two single quotes (' ') within a character string as a single quote (').

slen

The number (1 to 8 hex digits) of bytes that OMEGAMON XE for Db2 PE scans. The default is 256 (X'100') bytes.

dlen

The number (1 to 8 hex digits) of bytes that OMEGAMON XE for Db2 PE displays if the scan is successful. The display starts at the beginning of string. The default is 16 (X'10') bytes.

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


MSCN 10%%+4%+C%,'O2HELP',1000,14

Typical output is:


MSCN 10%%+4%+C%,'O2HELP',1000,14          Addr=0061701C
+ 0000  D6C3C8C5 D3D74040 60BCA000 80001B00  *O2HELP  
-.......*
+ 0010  14010100                             *....            *

MZAP

Modifies the contents of the common area or the OMEGAMON for Db2 PE private area.

This command requires special authorization because it can perform potentially dangerous functions. Before OMEGAMON XE for Db2 PE executes this command, you must enter a valid password using the /PWD command.

Note: MZAP is powerful. Use it with care.

MZAP modifies the contents of commonly addressable storage such as the

common storage area (CSA)
system queue area (SQA)
nucleus

Note the following:

Some commonly addressable storage requires no authorization or special key to modify; however, some areas are store-protected. To modify these areas you must supply the action character in the label field of the MZAP command. You can also use MZAP to zap storage in the OMEGAMON for Db2 PE address space for debugging purposes. You can zap as many bytes as fit on a line at one time, but the verify and replace code lengths must be the same.
If you use MZAP to modify storage in the Pageable Link Pack Area (PLPA), MZAP automatically does a long-term page-fix to ensure that the storage remains modified. If the pagefix is necessary, OMEGAMON for Db2 PE displays the message:
```
PAGE(S) FIXED
```
With 370, MZAP cannot zap the PLPA of a processor that has PLPA protection.

The format is:


aMZAP  addr,ver,rep

a

If required, an 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.

addr

The address of the string OMEGAMON for Db2 PE might modify.

For more information about how to specify an address, see the MCHN command.

ver

The verify string; OMEGAMON for Db2 PE modifies storage only if it finds this string at addr.

rep

The replacement string. If OMEGAMON for Db2 PE finds ver at addr, rep replaces ver.

The strings ver and rep must be the same length.

In the first example, MZAP changes a fullword at location 6764 from X'0A' to X'64'.


MZAP  6744+20,0000000A,00000064

In the next example, MZAP changes an X'FF to X'00 at location EA65C0.


MZAP  EA65C0,FF,00

/O

Prints the existing OMEGAMON for Db2 PE REPORT log without closing the log.

The /O command is an alias for /LOG with the OUT argument. See the description of the /LOG command for complete information about the /O command.

OSPC

Lists the attributes of the owner of a data-only space.

The format is:


OSPC spacename

where spacename is the name of the data-only space you want to list. If you do not enter a name, OSPC lists all data spaces and hiperspaces. You can also enter 1 to 7 characters, and OSPC displays any space names that begin with the specified character string.

OSPC displays the following information about the specified space: type of space, ASID of the owning TCB, jobname of the owning TCB, address of the owning TCB.

/P

Prints the current logical panel.

The /P command is an alias for /PRINT. See the description of the /PRINT command for complete information about this command.

.PCS

Displays OMEGAMON for Db2 PE program check statistics.

These statistics are used for debugging information. If OMEGAMON for Db2 PE takes a program check, this information is useful to IBM Customer Support.

.PFK

Displays/resets PF key definitions.

The format is:


c.PFK nn=aaaaaaaa/*bbb...bbb

(blank): Without operands, .PFK displays all current PF key settings. PF keys without assignments are not shown in the panel.
c: Label E for redefining several PF keys at once.
nn: PF key number.
aaaaaaaa: Screen space name (1 to 8 characters) or INFO-line command (/cccccc).
/*bbb...: Comment of up to 32 characters (bbb...), following the forward slash (/) and asterisk (/*).

You can define up to 99 physical and logical PF keys.

The PF keys that you define with .PFK are in effect only for that OMEGAMON for Db2 PE session. At startup, OMEGAMON for Db2 PE executes the panel space @ZPFKDEF, which contains default PF key assignments. To make these assignments permanent, change them in the @ZPFKDEF panel space.

For example, the following command sets PF15 to issue the /STOP INFO-line command for this session.


.PFK 15=/STOP         /* Stops OMEGAMON for Db2 PE

Type comment text following a forward slash (/) and asterisk (/*): Use the same format to assign panel space names to PF keys. For example, the following command sets PF26 to call the panel space DISKS for this session.


.PFK 26=DISKS         /* DASD information

To delete a definition, enter a single underscore (_) for the definition. For example, the following command deletes the definition for PF18.


.PFK 18=_

You can redefine several PF keys at once without having to type the .PFK command for each one. To do so, use the following procedure.

Type E.PFK. OMEGAMON for Db2 PE provides an extended display of all current PF key assignments, and inserts .PFK before each key number, as shown below.


                                                                                
  + PFK07=/UP                 /* SCROLL UP                                      
   + PFK08=/DOWN               /* SCROLL DOWN                                   
    .                                                                           
    .                                                                           
   + PFK11=/ZOOM               /* ZOOMING FEATURE

For each new assignment, blank out the plus sign (+) in front of each .PFK and type the new assignment following the equal sign.
Press Enter.

The assignments remain in effect for the duration of the session.

If you want to call panel spaces with PF keys, allocate an O2PROC library. To call a panel space assigned to a PF key, press the associated PF key or type its number on the INFO-line.

/PRINT

Prints the current logical panel.

When the panel prints, a >LOGGED< message is displayed on the INFO-line.

/P is an alias for /PRINT.

.PRM

Displays current values of the OMEGAMON XE for Db2 PE startup command parameters.

This command displays applicable OMEGAMON for Db2 PE startup parameters in the following order.

IOMODE=cc: The current OMEGAMON for Db2 PE I/O mode. This is the 2-character code entered as the mode in the startup parameters.
SYS=cccc: The current OMEGAMON for Db2 PE system ID. This is the same system ID that is displayed on the INFO-line.
USER=cc: The user profile identifier. This is the same identifier that is displayed on the INFO-line.
ROWS=nn: The number of rows on the physical terminal.
LROWS=nnn: The number of logical rows for the output area.
COLS=nnn: The number of columns on the physical terminal.
UNIT=ccc: The terminal address of a dedicated OMEGAMON for Db2 PE session.

.PRT

Prints the specified portion of the panel to the report file.

The format is:


.PRTc

Without an argument, .PRT prints a panel image from the INFO-line to the line that contains the .PRT command. After the partial panel prints, .PRT changes to a comment.

The optional argument H (.PRTH) prevents the .PRT command from commenting itself out so that it logs these lines continually.

/PWD

Specifies an OMEGAMON for Db2 PE password or reauthorizes a session.

The format is:


/PWD userid

You can use the /PWD command in three ways. They are:

To authorize your session for internal security. Enter the /PWD command on the INFO-line. The system prompts you for a password.
```
/PWD____________               < You enter >
________________ Enter Password  < Result >
```

The password is not displayed in the panel as you type it. It remains in effect until you reset it.

To reset the security level to 0 after your authorized session. Type /PWD on the INFO-line as in the example, but instead of entering a password, just press Enter. Authorization is cleared.
The /PWD command can be entered with your user ID to do the following:
- Log onto an existing OMEGAMON for Db2 PE session and reauthorize external security to your level for the session.
- In dedicated mode, gain access to external security.

When you use the /PWD command with your user ID to log onto an existing session, you cannot update your password.

See Configuration and Customization for details about the security features.

RENM

Renames a panel in RKO2PCSV or main storage.

RENM renames panel spaces only in main storage (in-storage) and RKO2PCSV. It does not rename IBM-supplied panel spaces in the library pointed to by the ddname O2PROC.

The new format is:


RENMc aaaaaaaa bbbbbbbb

c

Specifies the location of the renamed panel space.

B or b: Rename in both main storage and RKO2PCSV. This is the default.
D: Rename in RKO2PCSV only.
I: Rename in main storage (in-storage) only.

aaaaaaaa

The old name of the panel space.

bbbbbbbb

The new name of the panel space.

Note: OMEGAMON for Db2 PE does not substitute special characters for the RENM command. You must enter the actual member name.

/REP

Replaces the existing saved panel space of the same name.

Use /REP in place of /SAVE if you want to replace an existing saved panel space in the user-defined panel space library pointed to by ddname RKO2PCSV.

The format is:


/REP cccccccc,a

cccccccc

Specifies the panel space name (1 to 8 characters).

a

One of three arguments that might follow the panel space name. The argument is separated from the panel space name with a comma (,).

B: Replaces in both main storage and RKO2PCSV.
D: Replaces in RKO2PCSV only.
I: Replaces in main storage (in-storage) only.

The default is wherever OMEGAMON for Db2 PE finds the panel space.

OMEGAMON for Db2 PE substitutes a D for a dot (.) in panel names.

The size of the panel space is the number of lines to the last non-blank line in the panel space.

The following example replaces the current panel space SAMPLE with the currently-entered panel space in both main storage and RKO2PCSV.


/REP SAMPLE,B

The default cursor position is the first position of the INFO-line. However, if you want to save the cursor in any position in the panel, type /REP on the INFO-line but do not press Enter. Move the cursor to the position you want and then press Enter to execute /REP. The cursor displays in that position whenever OMEGAMON for Db2 PE invokes the panel.

If you want to look at or edit a panel using a text editor, be aware of the following:

CURS=(n,m) is displayed at the top-left corner of the INFO-line to indicate the cursor position in the saved panel.
The variable n specifies the cursor row position, and m specifies the column position.
You can add or change the cursor position in a saved panel using a text editor by adding or changing CURS=(n,m)
Note: /R is not an alias for /REP. It is an alias for /RETURN. /REP does not have an alias.

/RESHOW

Displays a new copy of the current panel.

.RTN

Terminates an ASF or TSF sequence and returns to the calling panel space.

The .RTN command is required at the bottom of the last panel space in an automatic panel facility (ASF) or timed panel facility (TSF) sequence. It returns to the calling panel space and re-enables exception analysis for further automatic calls. You can turn on ASF from the Exception Logging panel or the panel that sets analysis options for individual exceptions.

The format is:


n.RTNcc aaaaaaaa

n

The optional label n specifies the number of cycles to delay the return to the calling panel space. The value of n can be the numbers 1 to 9 or the letters A to Z (representing 10 to 35). Each time the panel updates, n decrements by 1. When n=0, the current panel executes and OMEGAMON for Db2 PE fetches the next panel space.

For example, the following command returns to the calling panel space after 7 cycles.


6.RTN

cc

The variable cc is the NR (no reset) argument. It prevents the .RTN command from automatically resetting the automatic update interval and the log status.

aaaaaaaa

This optional argument specifies a panel space for ASF or TSF to return to other than the calling panel space.

The .RTN command automatically resets the automatic update interval and the log status to that in effect when the ASF or TSF sequence began, unless NR is specified (see cc above).

/S

Saves the specified new panel.

The format is:


/S cccccccc,a

/S is an alias for /SAVE. See the description of the /SAVE command for complete information.

/SAVE

Saves the specified new panel.

The /SAVE command works only if you have an RKO2PCSV data set and cccccccc does not already exist. If cccccccc already exists, use /REP.

The format is:


/SAVE cccccccc,a

cccccccc

Specifies the panel name (1 to 8 characters).

a

One of three arguments that might follow the panel space name. The argument is separated from the panel space with a comma (,).

B: Saves the panel space to both RKO2PCSV and main storage (in-storage panel facility).
D or b: Saves the panel space to RKO2PCSV only (default).
I: Saves the panel space to main storage only.

OMEGAMON for Db2 PE substitutes a D for a dot (.) in panel space names.

This next example saves the current panel SAMPLE in both main storage and RKO2PCSV.


/SAVE SAMPLE,B

The default cursor position is the first position of the INFO-line. However, if you want to save the cursor in any position in the panel, type /SAVE on the INFO-line but do not press Enter. Move the cursor to the position you want and then press Enter to execute /SAVE. The cursor displays in that position whenever OMEGAMON for Db2 PE invokes the panel.

If you want to look at or edit a panel space using a text editor, be aware of the following

CURS=(n,m) is displayed at the top left corner of the INFO-line to indicate the cursor position in the saved panel.
The variable n specifies the cursor row position, and m specifies the column position.
You can add or change the cursor position in a saved panel using a text editor by adding or changing CURS=(n,m).

/S is an alias for /SAVE.

SCHN

Scans data-only space control blocks for a string of data and displays the location.

Use SCHN to search chained control blocks located in a data-only space for the occurrence of a specific string of data. SCHN scans data-only space storage until either a match to the string is found, the chain loops, or the address of the next control block is zero.

The format is:


aSCHNc jobname,spacename,addr,string,off1,off2,plen

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 b: hex and character (default)
C: character only
X: hex only

jobname

The jobname or ASID in decimal of the owner of the data-only space.

spacename

The name of the data-only space.

addr

The starting address of the scan.

string

The comparison string for the scan, which can be either a hexadecimal string or a character string surrounded by single quotes (').

off1

The offset from the beginning of the control block to the location of the comparison string. This value might be preceded by a plus (+) or a minus (-) sign.

off2

The offset from the beginning of the control block to the fullword address of the next control block. This value might be preceded by a plus (+) or a minus (-) sign.

plen

The length of print display. The default is 1 line or 16 bytes.

SCRN

Lists panel member names.

The format is:


SCRNc aa bb

c

Enter one of the following arguments in column 6 to specify the source of the member list.

B or b: Lists all panels in both disk data sets (RKO2PCSV) and main storage (default).
C: Lists all panels in disk data sets only.
X: Lists all panels in main storage (in-storage) only.

aa bb

Lists all panels beginning with characters aa to bb (start aa in column 8).

a*

Lists all panels beginning with character(s) a (start a in column 8).

The following example lists all panels stored in both disk data sets and main storage that have names starting with C or D.


SCRNB C D

The next example lists all panels in main storage from PA to PA999999.


SCRNI PA*


SCRNI PA  PA

.SGO

Goes to panel cccccccc on next update.

The format is:


n.SGO cccccccc  keyword{=| aa }argument

With the .SGO command panels can branch to other panels.

For example, the following command fetches panel SAMPLE on the next cycle.


SGO SAMPLE

With the optional value n you can delay the fetch of panel cccccccc for n cycles. The value of n can be between 1 and 35. Use the numbers 1 to 9 or the letters A to Z (to represent 10 to 35 cycles). Each time the panel updates, n decrements by one. When n equals 0, panel cccccccc is fetched on the next cycle.

The next example delays fetch of panel SAMPLE for 11 cycles, and fetches it on the next cycle after n equals 0.


B.SGO SAMPLE

Conditional Parameters

The .SGO command also has a conditional panel fetch feature that fetches a panel only if a condition is true. The condition is expressed as follows:


.SGO cccccccc  keyword{=| aa }argument

The keyword can be one of the following:

CPSER=: Compares the CPU serial number.
MODE=: Compares the 3-character OMEGAMON for Db2 PE mode ID (displayed on the INFO-line). For example, DED, VTS, VTT, VTM.
OPSYS=: Compares the 3-character ID for the operating system level (XA1).
SMFID=: Compares the 4-character SMF ID.
UNIT=: Compares the terminal address of the primary OMEGAMON XE for Db2 PE console (only in dedicated mode).
USER=: Compares the 2-character suffix of the user profile.

The relational operator is either an equal sign (=) or a 2-character operator aa separated by blanks. The operator aa can be:

EQ: Keyword equals argument. Same as equal sign (=).
GE: Keyword is greater than or equal to argument.
GT: Keyword is greater than argument.
LE: Keyword is less than or equal to argument.
LT: Keyword is less than argument.
NE: Keyword is not equal to argument.

The argument is a 1- to 8-character value to which OMEGAMON for Db2 PE compares the keyword.

For example, to fetch panel SAMPLE only if you are running in an XA environment, enter:


.SGO SAMPLE OPSYS=XA1


.SGO SAMPLE OPSYS EQ XA1

Note: A blank is not a valid keyword, relation, or argument. Additionally, if you use a variable as the keyword or argument, the variable cannot begin with a blank.

When you use the 2-character operator aa instead of the equal sign =, there must be at least one blank separating the keyword, operator, and argument. The equal sign requires no separation.

If multiple .SGO commands are displayed on one panel, the last one that is executable takes precedence.

See the .FGO command for other methods to fetch panels.

SLST

Displays bytes of memory from data-only space storage.

The format is:


aSLSTc jobname,spacename,addr,plen

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

Specifies the format of the output:

B or b: dump format (default)
C: character only
X: hex only

jobname

The jobname or ASID in decimal of the owner of the data-only space.

spacename

The name of the data-only space.

addr

The starting address of the data.

plen

The number (1 to 8 hex digits) of bytes to print. The default is 16 (X'10') bytes or 1 line.

SLST lists memory from data-only spaces. When necessary, an SRB will be scheduled into the address space of the TCB owning the data-only space to be listed.

Here is an example of using SLST.


<SLST MYJOB,MYSPACE,1000,20
+Storage at 00001000 in dataspace MYSPACE, job MYJOB ASID=12
+ 0000  E3C5E2E3 40C4C1E3 C140E2D7 C1C3C540  *TEST DATA SPACE *
+ 0010  F0F1F2F3 F4F5F6F7 F8F9C1C2 C3C4C5C6  *0123456789ABCDEF*

SSCN

Scans data-only space storage for the occurrence of a specific string of data.

Command format:


aSSCNc jobname,spacename,addr,string,len1,len2

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

Specifies the format of the output:

B or b: dump format (default)
C: character only
X: hex only

jobname

The jobname or ASID in decimal of the owner of the data-only space.

spacename

The name of the data-only space.

addr

The starting address of the scan.

string

The comparison string for the scan. Either a hexadecimal string or a character string surrounded by single quotes (').

len1

The length to scan in hex. Default is 256 (x'100') bytes.

len2

The length of print display. Default is 1 line or 16 (x'10') bytes.

SSCN scans data-only space storage until a match to the string is found or the length of storage specified is exhausted. When necessary, an SRB is scheduled into the address space of the TCB owning the data-only space to be scanned.

Following is a sample SSCN display.


<SLST MYJOB,MYSPACE,1000,20
+Storage at 00001000 in dataspace MYSPACE, job MYJOB ASID=12
+ 0000  E3C5E2E3 40C4C1E3 C140E2D7 C1C3C540  *TEST DATA SPACE *
+ 0010  F0F1F2F3 F4F5F6F7 F8F9C1C2 C3C4C5C6  *0123456789ABCDEF*

/STOP

Stops OMEGAMON for Db2 PE.

STOP performs the same function.

STOP

Stops OMEGAMON for Db2 PE.

/STOP performs the same function.

SZAP

Modifies the contents of data-only space storage.

Note: There is a potential integrity exposure with the use of SZAP on hiperspaces. SZAP uses HSPSERV to read in a page of data from the target hiperspace, check the data, alter the data, and finally use HSPSERV to write the page back to the hiperspace. If someone else is writing to the same page of the hiperspace during this process, the newly entered data could get lost. There is no available enqueue mechanism to guard against this exposure.

The format is:


-SZAP  jobname,spacename,addr,vercode,repcode

-: Action character required for execution.
jobname: Jobname or ASID in decimal of the owner of the data-only space.
spacename: The name of the data-only space.
addr: The starting address of the data.
vercode: The current code to be verified in hexadecimal.
repcode: The replacement code in hexadecimal.

The lengths of vercode and repcode must match.

When necessary, an SRB is scheduled into the address space of the TCB owning the data-only space to be zapped. Here is an example of using SZAP.


>SZAP MYJOB,MYSPACE,1000,00000005,00000008
>      >> OB7110: Memory Zap Successful <<

/TOP

Scrolls to the top of the logical panel.

.TSF

The times panel facility (TSF) schedules certain panel spaces not on an exception basis, but rather at specified times of day or at specified intervals. For example, you might want to issue a Db2 trace command automatically at 2:00 p.m. every weekday, and then turn it off again at 2:15. You can also invoke a panel space and have its commands executed and logged at regular intervals, such as every hour.

To use TSF, follow this procedure.

Create any panel spaces you want TSF to invoke. You can use the .SGO or .FGO command to chain panels together, and .RTN to end the cycle. Special considerations for creating panel spaces in TSF are discussed later in this topic.
Turn on TSF with the TSF keyword of the OPTN command.

The .TSF00 command lists all entries in the TSF table. The TSF table is delivered with 99 blank entries. For example:


.TSF00
+        1  Time=0000  SS=*NONE*  DAY=DAILY
+        2  Time=0000  SS=*NONE*  DAY=DAILY
+        3  Time=0000  SS=*NONE*  DAY=DAILY
+        4  Time=0000  SS=*NONE*  DAY=DAILY

Enter .TSFnnto display entry nn in the TSF table. To define an entry, type .TSF followed by the number of the entry. For example, type .TSF01 to produce:


.TSF01  Time=0000  SS=*NONE*  DAY=DAILY

You can type the new entry over the current entry, press Enter, and the value is reset.

If you want to change an entry that is not displayed on the physical panel, you can specify an argument to skip nn entries. Type .TSF00 20 to display entries 21 through 99 in the TSF table, skipping the first 20.

Following are the keywords and valid entries.

Time: Specifies the time of day (from 0000 to 2400) to invoke the panel. TIME=+nn invokes the panel every nn minutes.
Note: The panel space does not execute while the TIME=+nn entry remains on your current panel.
SL or SS: Specifies the panel space to invoke if TSF is in effect. SS specifies the panel space to invoke, but does not turn on the log. SL automatically turns on the REPORT log when the panel is fetched, and panel space logging starts. You must specify either SS or SL for TSF to function.
DAY: Valid entries for day of week are MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY, WEEKDAY, WEEKEND, and DAILY. The days of the month are also valid entries (numerals 1 through 31). The default value is DAILY. You can abbreviate the input as long as it is unique and the day of the week is recognized.
You can specify day combinations by enclosing the names of the days within parentheses, and by separating each day with either a comma or a blank.

Here is an example of five TSF entries.


.TSF01   1   TIME=1800 SL=WENDSHFT  DAY=DAILY
.TSF02   2   TIME=0600 SS=WEEKSTRT  DAY=MONDAY
.TSF03   3   TIME=1200 SL=NOONTIME  DAY=(TH,F)
.TSF04   4   TIME=0800 SS=MONTHEND  DAY=30
.TSF05   5   TIME=+30  SL=STATUS    DAY=DAILY

TSF01: Executes and logs panel space WENDSHFT at 6:00 p.m. daily.
TSF02: Executes panel space WEEKSTRT at 6:00 a.m. every MONDAY.
TSF03: Executes and logs panel space NOONTIME at 12:00 p.m. every Thursday and Friday.
TSF04: Executes panel space MONTHEND on the 30th of each month at 8:00 a.m.
TSF05: Executes and logs panel space STATUS every 30 minutes every day.

/U

Scrolls up the amount of lines specified by argument cccc.

/U is an alias for /UP. See the description of the /UP command for complete information.

/UP

Scrolls up the amount of lines specified by argument cccc.

The /UP command works only if you set the number of logical rows (LROWS) to a number greater than the number of physical rows on this terminal when you initialize OMEGAMON for Db2 PE.

The format is:


/UP cccc

nnn: Scrolls nnn lines (from 1 to 999).
CSR: Scrolls according to the current location of the cursor. If the cursor is on the INFO-line, the scroll amount is a page.
MAX: Scrolls to the top of the panel.
PAGE: Scrolls so that the current cursor position is at the top of the panel (default).
TOP: Scrolls to the top of the panel.

The following example scrolls up 20 lines.


/UP 20

If you have assigned the /UP command to a PF key (the default is PF19), you can type any of the optional arguments on the INFO-line before you press the PF key, and OMEGAMON for Db2 PE interprets the entry as if you had typed the command plus the arguments.

/U is an alias for /UP.

.VTM

Displays terminal ID and session information for all users logged onto OMEGAMON for Db2 PE in VTAM mode.

A user running in a multi-session environment moderated by O2VTAM can use this command to display information about other O2VTAM users. Operations personnel can use this command to monitor and manage access to the VTAM environment.

The .VTM command displays the following information: user ID, terminal ID, mode, session start date and time, date and time of last update. (User ID is displayed only if external security is being used to control logon access.)

.WAT

Waits nn seconds (.WATnn) before executing all commands below.

The .WAT command provides a delay mechanism for the execution of commands that require information from a currently executing command. This command is useful when you want a delay between operator commands.

XGRP

Invokes exception analysis for exception group cc.

The format is:


XGRPcc

The XGRP command only invokes exceptions of a certain group. In this sense, it is merely a subset of the EXSY command.

The variable cc indicates the exception group type. These types are:

CI: CICS exceptions
IM: IMS exceptions
SY: system exceptions
TH: thread exceptions

XGSW

Set exception group switch settings.In addition to the control available over each individual exception, you can override certain options for an entire exception group.

The format is:


XGSW GROUP=cc STATE=cccc

GROUP

Any two unique alphanumeric characters to specify the group. Use this keyword to display only entries for a particular group.

STATE

Controls whether the exception is in any of these five states:

ON: Invokes this exception during the current session.
OFF: Does NOT invoke this group of exceptions during the current session.
TEST: Forces a sample warning message, even if the exception condition is not presently occurring, for purposes of training or demonstration. (When a message has been displayed because of TEST mode, a T is displayed in column 2 of the message lines.)
NULL: Specifies the individual exception is to maintain control rather than the group switch. This is the default.

XMCH

Scans Db2 storage.

XMCH scans the elements of a table for a string of hex or character values. If the scan is successful, OMEGAMON for Db2 PE displays the table element that contains the string.

Use XMCH to search Db2 address spaces. Use MCHN to search the address space in which OMEGAMON for Db2 PE resides.

The format is:


aXMCHc targ,addr,string,olen,chain,dlen

a

An 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:

C: character only
X: hex only

targ

The target Db2 address space. It can be:

nnnn: decimal ASID number
cccccccc: jobname

If you do not specify a Db2 address space, an error message is displayed.

addr

The address of the first table element OMEGAMON for Db2 PE scans. For more information about how to specify an address, see the MCHN command.

string

The hex string that OMEGAMON for Db2 PE uses for the scan. If you enclose it in single quotes ('), OMEGAMON for Db2 PE assumes it is a character string.

Note: OMEGAMON for Db2 PE interprets two single quotes (' ') within a character string as a single quote (').

olen

The offset (in hex bytes) to the string in the table element; the comparison starts at this point. You can precede olen by a plus sign (+) or minus sign (-).

chain

The offset (in hex bytes) to the chain pointer (the location in the table element that contains the address of the next table element). You can precede chain by a plus sign (+) or minus sign (-).

dlen

The number of bytes (1 to 8 hex digits) that OMEGAMON XE for Db2 PE displays if the scan is successful. The display starts at the beginning of the table element. The default is 16 (X'10') bytes.

Ensure that addr is the starting point of a table element. The address at + chain points to the next table element. The scan ends when the value at addr + chain is one of the following:

0
-1
addr (the table is a ring)

The example below shows a typical XMCH command. In this example, XMCH scans a table in the target Db2 address space that starts at location AAB6C8 and looks for the string D6C30199 that begins at the eighth byte of the table element. The address of the next table element is in the fourth word. By default, this command displays 16 bytes of the table element in hex and character format.


-XMCH USER14,AAB6C8,D6C30199,8,4

The following output is displayed if the scan is successful:


>XMCH USER14,AAB6C8,D6C30199,8,4
>Storage at 007DA000 in USER14 ASID=21:
> 0000  E2E2C3E3 00000000 D6C30199 00000000  *SSCT    OC r    *

XMLS

Displays Db2 storage.

XMLS displays bytes of storage from a Db2 address space.

The format is:


aXMLSc targ,addr,len

a

An 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 b: hex and character (default)
C: character only
X: hex only

targ

The target Db2 address space. It can be:

nnnn: decimal ASID number
cccccccc: jobname

If you do not specify a Db2 address space, an error message is displayed.

addr

The first address of storage that OMEGAMON for Db2 PE displays. For more information about how to specify an address, see the MCHN command.

len

The number (1 to 8 hex digits) of bytes that OMEGAMON XE for Db2 PE displays. The default is 16 (X'10') bytes.

The following examples show uses of the XMLS command.

In the first example, XMLS displays 32 (X'20') bytes from address space 21, starting at address 1EB0, in character format.


-XMLSC  21,1EB0,20

Typical output is:


>XMLSC  21,1EB0,20
 >storage at 00001EB0 ASID=21:
 >0000 *ABCDEFGH IJKLMNOP QRSTUVWX Z0123456                     *

In the second example, XMLS displays 16 (X'10') bytes from the target Db2 address space specified by the jobname USER14, starting at 1EB0 in both hex and character formats.


-XMLS  USER14,1EB0,10

Typical output is:


>XMLS  USER14,1EB0,10
 >storage at 00001EB0 in USER14 ASID=21:
 >0000  C1C2C3C4 C5C6C7C8 C9D1D2D3 D4D5D6D7    *ABCDEFGHIJKLMNOP*

In the third example, XMLS displays 16 (X'10') bytes from address space 21, starting at FF32D6 in hex and character format. The less than symbol (<) prevents OMEGAMON for Db2 PE from commenting out the command.


<XMLSB  21,FF32C1+15,10

Typical output is:


<XMLSB  21,FF32C1+15,10
 +storage at 00FF32D6 in DB2 ASID=21:
 +0000  4AA800F7 D3700000 00000000 000000F8      *y..7L..........8*

XMSC

Scans Db2 storage.

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

The format is:

aXMSCc targ,addr,string,slen,dlen

a

An 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 b: hex and character (default)
C: character only
X: hex only

targ

The target Db2 address space. It can be:

nnnn: decimal ASID number
cccccccc: jobname

If you do not specify a Db2 address space, an error message is displayed.

addr

The start address of the scan.

string

The hex string that OMEGAMON for Db2 PE uses for the scan. If you enclose it in single quotes ('), OMEGAMON for Db2 PE assumes it is a character string.

Note: OMEGAMON for Db2 PE interprets two single quotes (' ') within a character string as a single quote (').

slen

The number (1 to 8 hex digits) of bytes that OMEGAMON XE for Db2 PE scans. The default is 256 (X'100') bytes.

dlen

The number of bytes (1 to 8 hex digits) that OMEGAMON XE for Db2 PE displays if the scan is successful. The display starts at the beginning of the table element. The default is 16 (X'10') bytes.

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


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

The following output is displayed 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                             *....*

XMZP

Modifies another user's private storage area.

This command requires special authorization because it can perform potentially dangerous functions. Before OMEGAMON for Db2 PE executes this command, you must enter a valid password using the /PWD command.

Note: XMZP is powerful. Use it with care.

XMZP modifies the contents of the indicated private storage area.

The format is:

aXMZP targ,addr,ver,rep

a

An 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.

targ

The target Db2 address space. It can be:

nnnn: decimal ASID number
cccccccc: jobname

If you do not specify a Db2 address space, an error message is displayed.

addr

The address of the string OMEGAMON for Db2 PE might modify. For more information about how to specify an address, see the MCHN command.

ver

The verify string; OMEGAMON for Db2 PE modifies storage only if OMEGAMON for Db2 PE finds this string at addr. If OMEGAMON for Db2 PE does not find the string, it displays what is actually at addr.

rep

The replacement string. If OMEGAMON for Db2 PE finds ver at addr, rep replaces ver.

Note: The strings ver and rep must be the same length.

In this example, XMZP changes a byte at location A0160 in the master scheduler address space.


-XMZP  *MASTER*,A0160,0A,64

In the next example, XMZP changes a halfword at C4834 in the PRODJOB address space from X'1854' to X'0700'.


-XMZP  PRODJOB,C4834,1854,0700

.ZAP

Displays the maintenance level of the OMEGAMON for Db2 PE realtime modules.

/ZOOM

Invokes the navigational zoom feature using the cursor as a pointer.

The zooming feature is designed to simplify the investigation of system conditions by supplying a detailed level of information at the touch of the zoom key. /ZOOM substitutes whatever value the cursor is on for a variable contained in a predefined panel space. The variable substitution allows the zooming panel space to have multiple uses.

To illustrate the use of the zooming feature, the following discusses three types of applications. First, you should be aware of the following points:

By default, OMEGAMON for Db2 PE is delivered with the /ZOOM INFO-line command assigned to PF key F11 so you can use the zooming panel spaces with a single key. For this discussion, F11 is referred to as the zoom key.
Zooming panel spaces must be set up before using /ZOOM. These panel spaces can contain one or more of the following variables.

&ZOOM: Data found at the cursor location.
&ZOOMA: Command argument field (columns 6 and 7).
&ZOOMC: Command or exception name field (columns 2 to 5).
&ZOOML: Command label field (column 1).
&ZOOMS: Originating panel space.

OMEGAMON for Db2 PE provides sample zooming panel spaces that you can use to become familiar with both the setup of a zooming panel space and the types of commands for which /ZOOM is most appropriate. To see the names of those panel spaces, use the SCRN command and look for panel spaces beginning with @Z.

Following are three illustrations of using the zooming feature:

This first example uses a panel space that is supplied on your OMEGAMON for Db2 PE tape. The example is easier to understand if you actually execute the commands on your system while you follow the discussion.

Type the command THDA. THDA produces a list of active threads.


________________  ZALLT    VTAM  O2        V500./C $DB2 mm/dd/yy     12:06:26   
 THDA                                                                           
+ Elapsed      Planname    CPU   Status        GetPg   Update  Commit  CORRID   
  -----------  --------   -----  ------------  ------  ------  ------  -------  
+ 00:53:59.05  PLAN0090   12.2%  In-DB2          6231     381     123  CICSPROD 
+ 00:12:37.16  PLAN0100   11.1%  In-SQL-Call     1943       0     189  TSOUSER1 
+ 00:09:29.27  PLAN0001    2.0%  In-DB2          1111      21      14  IMSA

To examine one of the threads more closely, place your cursor under the planname you want to query, PLAN0001 in this case, and press F11. OMEGAMON for Db2 PE looks for a panel space starting with @ZSM and ending with the command name that precedes the cursor. OMEGAMON for Db2 PE finds the panel space @ZSMTHDA:


________________  ZALLT    VTAM  O2        V500./C $DB2 mm/dd/yy     12:06:26   
 THDA                                                                           
+ Elapsed      Planname    CPU   Status        GetPg   Update  Commit  CORRID   
  -----------  --------   -----  ------------  ------  ------  ------  -------  
+ 00:53:59.05  PLAN0090   12.2%  In-DB2          6231     381     123  CICSPROD 
+ 00:12:37.16  PLAN0100   11.1%  In-SQL-Call     1943       0     189  TSOUSER1 
+ 00:09:29.27  PLAN0001    2.0%  In-DB2          1111      21      14  IMSA     
                                                                                
 PLAN  &ZOOM                                                                    
 ACT

/ZOOM replaces the variable &ZOOM with the planname over the cursor. The result might look like this:


________________  ZALLT    VTAM  O2        V500./C $DB2 mm/dd/yy     12:06:26   
 THDA                                                                           
+ Elapsed      Planname    CPU   Status        GetPg   Update  Commit  CORRID   
  -----------  --------   -----  ------------  ------  ------  ------  -------  
+ 00:53:59.05  PLAN0090   12.2%  In-DB2          6231     381     123  CICSPROD 
+ 00:12:37.16  PLAN0100   11.1%  In-SQL-Call     1943       0     189  TSOUSER1 
+ 00:09:29.27  PLAN0001    2.0%  In-DB2          1111      21      14  IMSA     
                                                                                
 PLAN                                                                           
 PLAN                                                                           
+ Thread: Planid=PLANABCD Connid=IMSA     Corrid=0014PSBNAME1 Authid=IMSUSER1   
+ Attach: IMS Region number = 11          IMS Tran = TRANDB2A                   
 ACT                                                                            
+                            Thread Status                                      
+ DB2 Status          =  In-SQL-Call      MVS Status              =   Wait-Misc 
+ Elapsed Time        = 00:00:00.0        CPU Utilization         =        11.0 
+ In-DB2 Time Total   = 00:03:01.1        In-DB2 CPU Time Total   =        1.30 
+ In-DB2 Time Current = 00:02:02.2        In-DB2 CPU Time Current =        1.23 
+                                                                               
+                  Thread Buffer Manager Activity                               
+                                                                               
+ Getpage Requests =            99        Getpages/Read I/O =              7.07 
+ Synchronous Reads =           14        Page Updates =                      3 
+ Sequential Prefetch Reqs =    48        Buffer Pool Expansions =            0

You can now place your cursor on a different planname and press F11 again to receive the same detail on another thread. A zooming panel space can display more detailed analyses of any thread.

Suppose that the THDA command in example 1 was originally executed as part of a different panel space (not a zooming panel space) that you had been using. We will call that panel space THREADS. If the @ZSMTHDA panel space ended with the command, .SGO &ZOOMS, the &ZOOMS variable would pick up the value of the originating panel space (THREADS) and OMEGAMON for Db2 PE would return to THREADS after the @ZSMTHDA panel space executed.
Suppose that you have issued the exception analysis command, LEXSY, and an exception condition is displayed (LEXSY) that you want to investigate further. Assuming that you have a predefined panel space named @ZSMcccc where cccc is the name of the exception, place your cursor under the exception name on the LEXSY panel and press F11. OMEGAMON for Db2 PE will execute the commands on your @ZSMcccc panel space to give you a detailed analysis of the condition.