Command reference
This section lists all the commands displayed through OMEGAMON for CICS (3270). They are listed in alphabetical order. For more detailed information like keywords, see the command help online.
Command usage
Enter the commands that start with a slash (/) on the INFO-line, which is the line indicated by underscores at the top of the screen.
Enter all other commands starting in column two on any blank line of the screen.
OMEGAMON for CICS (3270) commands
These are the OMEGAMON for CICS (3270) commands.
Command | Format | Description | Example | Comments |
---|---|---|---|---|
ACTN | ACTN | Displays any lines that require an operator action. The minor command of CONS and CONU. |
||
AIDK | AIDK <keyword=ccccKILL> | Stops the CICS Automatic Initiate® Descriptor. Use an asterisk (*) to specify a generic transaction or terminal ID. | AIDK TRAN=AB*KILL | This example kills Automatic Initiate Descriptors beginning with AB. |
AIDS | AIDS <keyword=ccccc> | Displays Automatic Initiate Descriptors (AID) information. | ||
AMAP | AMAP <a> | Displays the private area virtual storage utilization.
The minor command of PEEK. |
AMAPA | Displays the virtual storage utilization above the 16M line |
AMAPB | Displays the virtual storage utilization below the 16M line. | |||
ATF | ATF <aaaaa> | Controls the Application Trace Facility data collector. | ATF <START> | This example starts the Application Trace Facility collector. The ONDV
must be active in order to record trace data. The ATF command generates the ONDV START
command if ONDV is not already active. The level of detail trace information collected for third party products depends on whether task and file monitoring are enabled for the third party product, either dynamicall using the COLL command, or specifying AUTO_START=YES in the global data module. |
ATFF | ATFF keyword <keyword=cccc...> | Manages the Application Trace Facility Filters. | ATFF <Add> |
In this example, the blank displays the possible keywords. The <Add> keyword without further operand displays all the necessary keywords to add a filter. |
ATFF TRanid=tttt | This example specifies a specific or generic transaction ID. Use
wildcard characters to specify a generic Transaction ID. A transaction id that runs under
the umbrella can not be specified. You must specify the CICS transaction id of the umbrella. The generic transaction, terminal, or user IDs can be specified using an asterisk wildcard character (*) as a trailing character or a question mark (?) for single character substitution. For example, TRAN=D??V |
|||
/ATTN | /ATTN | Emulates the program attention (PA1) key | In OMEGAMON AI for CICS, the PA1 key resets the color and clears the screen. | |
/AUP | /AUPccc | Controls the automatic update mode. | When the automatic update mode is on, the screen updates at a regular interval without having to press ENTER. This command applies to VTAM® mode only. | |
.AUP | .AUP<aaa>ON|OFF | Displays or resets the status of the automatic update mode in VTAM. | When the automatic update mode is on, the screen updates at a regular interval without having to press ENTER. This command applies to VTAM mode only. | |
AVQ | AVQnnn | Sets the average IOS queue depth threshold for the XDSK minor command
of CDEV. The minor command of CDEV. |
AVQ105 | This example sets the queue depth threshold to 10.5 |
BLST | BLST <ccc<aaa>> | Displays and controls the wait reason data collection bucket sets. | When you display all the wait reason bucket sets, each line starts with a colon (:), which allows you to type over the characters in the ON/OFF column with ON or OFF. ON activates the appearance of the wait reason on the bottleneck analysis displays, while OFF suppresses the wait reason display. Neither ON or OFF affect the wait reason data collection. | |
/BOTTOM | /BOTTOM | Scrolls to the bottom of the logical screen. | ||
CDEV | CDEV | Displays the long term CICS device utilization. | ||
CICM | CICM ccccc | Runs the commands to the common interface. | CICM STOP OBVTAM | This example stops the OBVTAM subtask of the common interface. If you need to enter a common interface command longer than 73 characters, enter the command in a member of the common interface control file. then enter an EXEC command to the common interface to process the member. |
CICS | CICS <ccccccc> | Displays the active CICS regions and switches monitoring to another region. | CICS ignores swapped out regions, those in transition, and the current target region. When another valid region is selected, CICS stops the current session and initiates a new session automatically. | |
CINT | CINT? or CINT n1,n2,n3 | Displays or sets response time data collector time intervals. | The default intervals are taken from the GLOBAL_OPTIONS module. You can change the time interval values only when the response time data collector is inactive. To collect response time data, you must define transaction, program, or terminal groups. Use the GRPS command to define or change groups. | |
CMT | -CMT cccc <,n> | Displays or sets the main terminal function values. | -CMT AMX,3 | This example specifies 3 as the maximum number of active tasks. |
.CN | .CNxxx or .CN cc | Opens, closes, swaps, or sets address of the secondary console. | .CN OP or .CN649 | These example's, open the secondary console. Note that you must
precede .CN cc with a .CNxxx entry or set the address to 649. This command works in dedicated mode only. |
CNT | nCNT<cc> | Displays counts of response times recorded for ID groups. The minor command of CSLT and CRSP. |
||
COLL | COLL | Displays or changes the status of the file and database collectors. | ||
CON | CONnnn | Sets the average device connect time threshold for the XDSK minor
command of CDEV. The minor command of the CDEV command. |
||
CONS | CONSnn <CONS=<conid|conname>> |
Displays the console image for the specified console. | CONS nn displays three types of information on the command line: the type of console (CONSOLE or main CONSOLE), the console’s device number, and the console’s ID number (as in ID=3) | |
CONU | CONU<nn> | Displays the console image for the console at device address nnn. | CONU nnn displays two types of information on the command line: the type of console (CONSOLE or main CONSOLE) and the console’s number (as in ID=3). | |
COPY | COPY<nn> | Specifies the number of copies to print. The minor command of the OUTP command. |
COPY is active under SYSOUT control. If you set the HOLD minor command to YES, JES ignores this command. | |
CORE | CORE | Displays a menu of CICS control blocks and their respective commands. | ||
CRSP | CRSP | Selects time interval response time monitoring. | Time interval monitoring uses a combination of major and minor
commands. CRSP selects time interval monitoring, and the TIME minor command displays
response time data for transaction, program, and terminal groups. The CNT minor displays
counts for these groups. To collect response time data, you must define transaction, program, or terminal groups. You can use the GRPS command to define or change ID groups. |
|
CSA | CSA<aaaa> | Displays the CICS Common System Area (CSA). | CSA displays information about the CICS Common System Area. | |
CSAR | CSAR | Displays CSA and ECSA real memory allocated by key. | CSAR lists each key, the standard key user, the CSA and ECSA real memory allocated to the key, and the total memory allocated. | |
CSLT | nCSLT | Selects response time monitoring by time slots. | Time slot monitoring uses a combination of major and minor commands.
CSLT selects time slot monitoring, and the TIME minor command displays response time data
for transaction, program, and terminal groups. The CNT minor displays counts for these
groups. To collect response time data, you must define transaction, program, and terminal groups. You can use the GRPS command to define or change ID groups. |
|
CSWP | CSWP <cccccccc> | Displays or sets the swap status/DONTSWAP count of CICS. | The current DONTSWAP count reflects the number of OKSWAP SYSEVENTS that must be issued before the address space is again considered for swapping by the system resources manager (SRM). | |
CSYS | CSYS<GRAPH> | Displays general information about the CICS address space. | ||
CVSW | CVSW | Displays files experiencing string waits and LSR buffer waits. | ||
.D | .D nn | Deletes n lines. | ||
DADR | DADR | Displays the address of the device. The minor command of the device major commands, for example, DEV. |
||
DALC | DALC | Displays number of current allocations to the devices. The minor command of the device major commands. |
||
DATA | XDATA | Displays data space and hyperspace activity for an address space.
The minor command of the PEEK command. |
||
DB2® | DB2<cccc> | Displays information about the CICS/DB2 interface. | DB2 displays information about the CICS/DB2 interface as defined in the Resource Control Table. | |
DCAT | DCAT | Displays whether a device is static, installation-static, or dynamic.
The minor command of the device majors, for example, the DEV command. |
||
/DCL | /DCL | Deletes all comment lines (> in column 1) on the screen. | A comment line is any line with a greater-than symbol (>) in column 1. | |
.DCL | .DCL | Deletes its own line and all comment lines below it. | A comment line is any line with a greater-than symbol (>) in column 1. | |
.DD | .DD | Deletes a block of data from the screen. | To delete a block of lines from the physical screen, enter .DD on the first line of the block and .DD on the last line. | |
DDN | DDN<nnn> | Displays information about all allocated ddnames and data sets. The minor command of the PEEK command. |
If a ddname is associated with a multi volume data set, only the first allocated volume is displayed. | |
DDNM | DDNM<cccccccc> | Displays or overrides standard OMEGAMON AI for CICS ddname. The minor command of the OUTP command. |
Your environment determines allowable ddnames. If the value you enter is not allowed, OMEGAMON AI for CICS displays it again where you entered it and does not transfer it to the pending column. | |
/DEF | /DEFccc | Sets the definition mode. | /DEF is the INFO-LINE command, see the .DEF command. | |
.DEF | .DEF<aaa> | Displays or re sets the definition mode. | Definition mode inhibits automatic updating of a dedicated or VTAM mode session so you can define a screen space that includes commands that comment themselves out or otherwise change form after execution. | |
DELT | DELT<a>cccccccc | Deletes the specified screen space. | DELT SAMPLE | This example deletes the screen names SAMPLE. |
DEST | DEST<cccccccc> | Specifies destination cccccccc to receive report or XLFLOG. The minor command of the OUTP command. |
The DEST minor is under SYSOUT control. The default is *NONE*, which sends the output to the local printer. If the destination is a user ID, and there is more than one device destination, use the DSTU minor command. | |
DEV | DEV cccccccc|xxxx | Selects a disk with a specified volser number or unit address. | DEV 5200 | This example selects the disk at address 5200. For an online device,
DEV returns a message in this format:DEV xxx Volser=cccccc Online
Alloc |
DEVL | DEVL cccccccc xxxx | Selects listed devices by unit address or volser number. | You can mix addresses and volsers on one line. If you list an invalid address or volser, or if you specify the same disk twice, OMEGAMON AI for CICS eliminates the invalid or duplicate value from the list. | |
DEVP | DEVP/n | Selects devices by a pattern that has been set with .SPT. | ||
DEX | DEX <aaaaa <keyword=nn> > | Controls the bottleneck analysis data collector. | The data collector must be turned on in order to use bottleneck analysis. The threshold specifies the percentage of wait reason occurrences over which bottleneck analysis displays wait reasons. When the long-term interval elapses, the long-term buckets are set to the current value of the short-term buckets and the short-term buckets are set to zero. | |
DING | DING | Forces the terminal bell to ring. | The bell must be activated with the BELL=ON option of the OPTN command. | |
DIO | DIO<.a> | Displays start I/O on drive (RMF required). The minor command of the device majors, for example, CDEV. |
DIO .S | This example displays I/O rate per second. This applies to RMF only. Use the DIO command to display I/O rates or increments by adding modifiers in columns 6-7 (note the blank in column 5). |
DIO .M | This example displays I/O rate per minute. | |||
DIO .H | This example displays I/O rate per hour. | |||
DIOQ | DIOQ | Displays the depth of I/O queue for the devices. The minor command of the device majors, for example, CDEV. |
Use a device major to select the devices for DIOQ. | |
DISK | DISK<AL> | Selects disk drives (DASDs). | ||
DLI | DLI <aaaaaaa> | Displays CICS/DLI interface information. | ||
DLST | DLST | Displays all DASD devices (online or offline). | ||
.DM | C.DMxxx | Dumps 4 hex bytes at offset xxx from Unit Control Block (UCB). The minor command of the device majors, for example, CDEV. |
The .DM command is considered a generalized minor command because it can be used with several major commands. | |
DOPN | DOPN | Displays the number of open DCBs on the device(s). The minor command of the device majors, for example, CDEV. |
||
/DOWN | /DOWN <cccc> or /D <cccc> | Scrolls down the screen a specified number of lines. | The /D is the alias for /DOWN. | |
DPIN | DPIN | Displays whether a device is pinned. The minor command of the device majors, for example, DISK. |
||
DPLT | DPLTnn | Displays device activity every nn milliseconds for 50 samples. The minor command of the device majors, for example, DEV. |
This command requires RMF. | |
DRES | DRES | Displays reserve count from this CPU. The minor command of the device majors, for example, DEV or DISK. |
||
.DSA | .DSA<aa> | DSA Sets authorization to list and/or zap non-sharable data spaces. | ||
DSC | DSCnnn | Sets the average device disconnect time threshold for the XDSK minor
command of CDEV. The minor command of CDEV. |
||
.DSE | .DSE | Displays the status of the stack screen. | DSE displays the following status:
|
|
DSKB | DSKB | Displays busy devices. | ||
DSKC | DSKC | Displays devices with suspended channel programs. | ||
DSKE | DSKE | Displays permanently resident DASD devices. | ||
DSKG | DSKG | Selects mass storage virtual volumes. | ||
DSKM | DSKM | Displays DASD devices waiting on. | ||
DSKN | DSKN | Displays all disks with volsers that begin with the characters cc. | ||
DSKP | DSKP | Displays DASD volumes mounted as PUBLIC. | ||
DSKQ | DSKQ | Displays DASD devices with I/O queue length of nn or more. | ||
DSKR | DSKR | Displays disks currently reserved from this CPU. | ||
DSKS | DSKS | Displays disks with the STORAGE mount attribute. | ||
DSKU | DSKU | Displays disks with UCB names starting with xx. | ||
DSKV | DSKV | Displays disks mounted as private. | ||
DSTA | DSTA | Displays the device mount status. The minor command of the disk majors, for example, DEV and DISK. |
The status can be PRIVATE, PUBLIC, or STORAGE. | |
DSTU | DSTU<cccccccc | Displays or sets destination user ID for log output. The minor command of the OUTP command. |
DSTU is active under SYSOUT control. | |
DTYP | DTYP | Displays the device type. The minor command of the device majors, for example, DEV. |
||
DUMP | nDUMP <DUMP> | Displays the status of the CICS dump component. | ||
DUSR | DUSR | Displays current user of device. The minor command of the device majors, for example, DEV. |
||
DUT | DUTnnn | Sets the average device utilization threshold for the XDSK minor
command of CDEV. The minor command of CDEV. |
DUT60 | Sets device utilization threshold to 60%. |
DVMP | DVMP | Displays the unit control block (UCB) for the device in hex format.
The minor command of the device majors, for example, DEV or TAPE. |
The DVMP command dumps the UCB, the UCB prefix, and all appropriate extensions for the device. It also shows the device status. | |
DVOL | DVOL | Displays volser of selected the disk or tape device. The minor command of device majors, for example, DISK or TAPE. |
||
EIB | EIB <<keyword=cccccccc>,cccc> | Displays information about the CICS EXEC Interface Block. | EIB <SUMarry> | This example displays summary EIB information. |
ENQ | nENQ <QEA=xxxxxxxx> | <RESOURCE=cccccccc> <DUMP> | Displays tasks waiting on enqueues and the owners of these resources. | ||
EXIT | EXIT <EPBS> | Displays all global user exits. When the EPBS parameter is specified, it displays the CICS Exit Program Blocks. | ||
.EXM | .EXM <n> or .EXM <c1 c2> | Lists and runs all minor commands for the preceding major command. | .EXM A F | This example runs the minors for the preceding major that have names starting with A through F. |
.EXP | .EXP | Displays the expiration date of the product. | OMEGAMON AI for CICS does not have an expiration date. | |
EXSY | EXSY<nn> | Invokes exception analysis. | ||
.FGO | .FGO cccccccc .FGO cccccccc &bbbbbbbb aa value
.FGO dddddd=YES
|
Moves to the specified screen space with no display. | This command is also useful for the Automatic Screen Facility (ASF) and the Timed Screen Facility (TSF). If logging is in effect, the screens are logged. The .FGO command is turned off after 64 cycles (screen spaces) to protect against a looping condition. | |
.FGO SAMPLE | This example goes to screen space named SAMPLE. | |||
.FGO ZZONDVSH &ZCONDVLV=SUMMARY | This example goes to screen space ZZONDVSH if &ZCONDVLV is equal to SUMMARY. | |||
FILE | FILE <keyword=cccc,keyword=cccc...> | Search for and display data sets allocated to the CICS region. | ||
FOLD | FOLD<ccc> | Prints lowercase alphabetic characters in uppercase. The minor of the OUTP command. |
FOLD is active under ddname or SYSOUT control. | |
FORM | FORM<ccc> | Displays or sets the name of the form on which to print log output.
The minor of the OUTP command. |
Your installation determines values for FORM. | |
GDEV | nGDEVcccccc | Lists online DASD and tape devices with the generic name cccccc. | Use GLST to list the generic names in the system. | |
GDFN | GDFN<keyword=value keyword=value ...> | Displays/sets an exception group for exception analysis. | Enter GDFN on each new line if the keywords and values that you specify cannot fit on only one line. | |
GLOB | GLOB or GLOB <cccc> | Displays the Global Data Area settings. (IBM® Software Support uses this command for problem diagnosis.) | GLOB | This example displays the sub options. |
GLOB GLOB | This example displays Global Data Area contents (including the PTF level). | |||
GLST | GLST<cccc> | Lists esoteric and generic device names. | GLST CTC DASD | This example displays direct access and channel to channel device esoteric and generic names. |
GRPS | GRPS <operand <keyword=arg,keyword=arg,...>> | Add, update, delete, and display Groups and their element(s). | ||
/HELP | /HELP or /H | Invokes the HELP screen space. | The /H is the alias for /HELP. Use /HELP or /H to call up the HELP screen space, which tells you more about the functions, features, and operation of OMEGAMON for CICS (3270). To get help for an individual command, enter a question mark (?) in column 1 preceding the command. If there is extended help for the command, a plus sign (+) appears at the end of the one-line help. To see the extended help, enter a slash (/) or semicolon (;) in column 1 preceding the command. | |
/HOLD | /HOLDaaa | Controls screen space updating. | 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. | |
HOLD | HOLD<ccc> | Displays or sets whether output is to be placed in the hold queue.
HOLD is active under SYSOUT control. If you set HOLD to YES, JES ignores the setting for
COPY command. The HOLD and COPY commands are minor commands of OUTP. |
||
.I | .I <nn> | Inserts a blank line or lines. The .I command does not interrupt command output. If you invoke .I between a command and the end of its output, OMEGAMON for CICS (3270) inserts the blank lines immediately following the output. | The .I is to be followed by two blanks before 'nn'. | |
IACL | IACL<n> | Sets the long-term clearing interval for the impact analysis display. | IACL | This example clears long-term intervals and gives current value. |
IACL1 | This example sets the long-term interval equals short-term interval. | |||
IACL2 | This example sets the long-term interval equals current short-term interval plus previous short-term interval. | |||
IACS | IACS<nn> | Sets the length of the short-term clearing interval. | IACS | This example clears the short term interval and gives the current value. |
IANC | IANC<n> | Sets the maximum number of CICS regions or region groups to monitor. | You must set the maximum before initiating the impact analysis session. Otherwise, you must stop the collector with the IANL END command first. | |
IANL | aIANL aIANL <jobname|GROUP=a|LIST|LIST= ALL|DELETE|END> aIANL <jobname<,LIST|DELETE>> aIANL <GROUP=a,LIST> |
Shows the MVS workload impact on your CICS workload. | ||
IANQ | IANQ<ON|OFF|nn> | Sets the enqueue sampling interval for impact analysis. The default if OFF. If ON is specified, the default enqueue sampling interval is 10 cycles. | IANQ5 | This example sets the enqueue sampling interval to 5 cycles. You cannot adjust enqueue collection while the collector is running. You must do so before you start the collector. Or, you must stop the collector (use IANL END command), adjust enqueue collection, and then restart the collector (use IANL command). You can display the current enqueue sampling interval during active collection. |
IAST | IAST<nn> | Sets the impact analysis sampling interval in tenths of a second. | Since impact analysis is based on a statistical sampling technique, smaller sampling intervals provide more accurate data, but do so at the expense of CPU time. Larger intervals reduce the accuracy of the data. Use the default, .9 seconds, before adjusting the sampling interval for your system. | |
IATH | IATH<nn|0> | Sets the impact analysis severity threshold by percentage. | IATH5 | This example sets the threshold to 5 percent. By default, only those impact sources that account for five percent or more of the total non-idle time of the CICS region or group are shown on the display. The IATH command does not comment itself out after it runs. |
IATO | IATO<nn> | Displays or sets the impact analysis timeout interval. | IATO1 | This example sets the impact analysis timeout interval to one minute. The IATO command can be issued whether or not the impact analysis collector is active. |
ICEK | ICEK<keyword=cccc KILL> | Stops the CICS Interval Control Element (ICE). | ICEK TRAN=AB* KILL | This example kills ICEs for transaction IDs beginning with AB. Use the asterisk wildcard character (*) to specify a generic transaction or terminal ID. |
ICES | ICES <keyword=cccc> | Displays CICS interval control element (ICE) information. | ||
ICHP | ICHPn | Displays installed channel path n for a device. The minor command of device majors, DISK or TAPE. |
||
ID1 | ID1<cccccccc> | Requests separator pages and headers to identify OMEGAMON for CICS (3270) sessions. The minor command of the OUTP command. |
ID1 is active under ddname or SYSOUT control. | |
ID2 | ID2<ccc...ccc> | Defines up to 16 characters on the left of separator page. The minor command of the OUTP command. |
ID2 is active under SYSOUT or ddname control. | |
ID3 | ID3<ccc...ccc> | Defines up to 16 characters in the center of separator page. The minor command of the OUTP command. |
ID3 is active under ddname or SYSOUT control. | |
ID4 | ID4<ccc...ccc> | Defines up to 16 characters on the right of separator page. The minor command of the OUTP command. |
ID4 is active under ddname or SYSOUT control. | |
.ILC | ILC </cccccccc> | Displays all INFO-line commands if no operand was specified. If the name of an INFO-line command is specified, then the help for the command is displayed. | ||
INTR | INTR <aaaaa <keyword=nn> > | Displays and controls the status of interval recording. | ||
IOPT | IOPT<keyword=value keyword=value ...> | Sets global OMEGAMON for CICS (3270) installation options. | The IOPT command settings do not take effect until your next session. | |
IOS | IOSnnn | Sets IOS queue time threshold for the XDSK command of CDEV. The minor of the CDEV command. |
||
IPRF | IPRF SAVE|DELETE | Saves/deletes the installation default profile. | The installation profile identification is internally generated. The two character product code followed by the constant, INSTAL, identifies the installation profile. For example, OCINSTAL serves as the installation profile identifier for the OMEGAMON®OMEGAMON for CICS (3270) component. | |
IPRO | IPRO <PDEXnn|IANL cccccccc|GROUP=aaaaaaaaaaaa> | Displays the resource impact or workload impact profile. If you do not specify a jobname or groupname, IPRO defaults to the last job or group specified with the IANL command. | IPRO PDEX10 | This example displays the resource impact profile for transaction group 10. |
IPRO IANL GROUP=CICSGROUP1 | This example displays the workload impact profile for the CICSGROUP1 region group. | |||
JOBS | JOBS | Displays job information. The minor command of the PEEK command. |
Displays the Start time and date Jobclass Msgclass and Programmer name. | |
KILL | KILL <keyword=cccc...> | Displays a summary of all current CICS tasks, or details for a specific task, or ends a specific task after user confirmation. | ||
LEXC | LEXC<cccc=n> | Displays or sets order of exceptions for exception analysis sampling. | LEXC AMXP=1 CMXP=2 | When you enter one or more operands, the LEXC command does not display exception settings. Any sequence of exceptions defined by the LEXC command can be saved in a user profile. |
LINE | LINEnn | Displays nn lines of the console. The minor command of CONS and CONU. |
||
LNCT | LNCT<nn> | Sets the number of lines per page for REPORT file and XLFLOG output.
The minor command of the OUTP command. |
The LNCT command takes effect immediately. The the pending and current line number settings are always equal. | |
/LOG | /LOGccc | Controls the REPORT log. | /LOGON | Turns on the REPORT log. The word LOG appears on the INFO-line when the log is turned on. /L alias for /LOG ON. |
/LOGOFF | Turns the REPORT log off. /F is the alias for /LOG OFF. | |||
/LOGOUT | Prints the current log and leaves it open. /O is the alias for /LOG OUT. | |||
.LOG | .LOG<aaaa> | Turns on/off the REPORT log | The .LOG command is especially useful for ASF or TSF screens. | |
LSCR | LSCRccc ccc... | Loads screen spaces from RKOCPCSV to the in-storage screen facility. | The LSCR command loads screen spaces from the RKOCPCSV data set to the in-storage screen facility. You can specify as many screen names as will fit on the input line. Screens loaded at initiation remain in memory throughout the session. Repeat lines as necessary for more screens. | |
LSR | LSR <cccc | POOL=nnn<,ddddd>> | Displays the Local Shared Resource (LSR) pools. | ||
MAXR | MAXR <CPU=n> | Displays or sets the value of the global CPU time monitoring limit. | If n > 0, transactions (except those whose programs start with DFH) with CPU time greater than n, trip the MAXR exception. | |
MCHN | MCHNc addr,string,olen,chain,dlen | Scans common area control block chains. | The MCHN command displays the control block chain that contains the string if the scan is successful. | |
MDEF | MDEFcc addr,name | Displays or sets names for addresses. | ||
.MIN | a.MIN<n> or a.MIN<c1 c2> | Lists all minor commands for the preceding major command. | H.MIN B D | This example displays help for the minors of the preceding major that begin with the letters B through D. |
.MJ | a.MJ<cc> | Lists all major and immediate commands. | ||
.MJC | .MJC<cc> | Lists all major commands. | ||
.MJI | a.MJI<cc> | Lists all immediate commands. | ||
MLST | -MLSTc addr,dlen | Displays bytes of memory from commonly-addressable storage. | To display fetch-protected areas, you must supply the action character in the label field. | |
.MMA | .MMAcccc | Lists all major commands for a minor command. | ||
MSCN | MSCNc addr,string,slen,dlen | Displays the location in storage of a specific string. | ||
MZAP | -MZAP addr+offset,xxxxxxxx,yyyyyyyy | Sets the contents of commonly addressable storage. | ||
.NXE | .NXE<aaa> | Controls message display for exceptions not currently being tested. | The .NXE command controls whether the product displays exception messages for exceptions that have occurred during a previous cycle, but that are not currently being tested. To set the frequency for testing an exception, use the ExNcyc keyword of the XACB command. | |
OCHP | OCHPn | Displays online channel path n for the device. The minor command of device majors, for example, DISK or TAPE. |
An asterisk wildcard character (*) displays next to the channel number when the device is installed but not online. | |
OCMD | -OCMDnn <CONS=<conid|conname>> ccccc | Issues MVS and JES commands. | ||
OMEG | This is not an OMEGAMON AI for CICS command; this is the CICS transaction that controls OMEGAMON AI for CICS in the CICS address space. | OMEG INIT | The INIT parameter of the OMEG transaction causes OMEGAMON AI for CICS to initialize in the CICS address space. | |
OMEG SHUT | The SHUT parameter of the OMEG transaction causes OMEGAMON AI for CICS to end data collection in the CICS address space. | |||
OMEG REMOVE | Causes OMEGAMON AI for CICS to shut down and remove all traces of itself, except for one maintenance free load module. A subsequent OMEG INIT transaction at a CICS terminal causes all load modules to be refreshed. | |||
ONDV | ONDV <cccc> | Displays historical task related data. | ||
OPT | OPT <PURGE|NOPURGE|OPER> | Displays or sets CICS shutdown option. | ||
OPTN | OPTN<keyword=value keyword=value ...> | Sets the global options. | OPTN ASF=ON LOG=ON SCREENCASE=UPPER | Turns the ASF and log function features on, and sets screen output to uppercase. |
OSPC | OSPC cccccccc | Lists attributes of the owner of a data space. | ||
OUTP | OUTP XLFLOG|REPORT | Displays specified heading for minor commands for XLFLOG or REPORT. | ||
PDEX | PDEX<nn> <id> <mm> | Displays bottleneck analysis wait reasons by percentage. | The PDEX command provides bottleneck analysis information by displaying CICS task wait reasons by percentage of total system activity. | |
PDSK | PDSK nnnnnn | Displays CICS DASD
devices whose volser matches the supplied pattern. Use an asterisk (*) as a wildcard to match any character. an asterisk at the end of a string causes any following characters to match. The PDSK command is the minor of the CDEV command. |
PDSK VS* | This example selects any devices strating with VS, for example, VSRESA,VSAM1, and VS. |
PDSK *VOL01 | This example selects devices like AVOL01, BVOL01. | |||
PDSK* | This example selects all DASD devices. | |||
PEEK | PEEK cccccccc | Collects data on the address space cccccccc. | ||
.PFK | a.PFK <nn=cccc</*comment>> | Displays or sets PF key definitions for the session. | .PFK15=STOP | This example assigns the STOP command to PF15. |
.PFK18=_ | This example deletes the definition for PF18. | |||
PND | PNDnnn | Sets the device pending time threshold for the XDSK minor command of
CDEV. The PND command is the minor of the CDEV command. |
||
PPRF | PPRF aaaaaaaaa <cc> | Saves, deletes, comments or lists the user's session profile. | When you do not supply a user profile identifier, PPRF applies to the current profile, using the value of the USER= start parameter. | |
/PRINT or /P | Prints the current logical screen. | When this command runs, a >LOGGED< message is displayed on the INFO-line to confirm that printing has occurred. The .PLM limit does not affect this command. | ||
.PRM | .PRM | Displays the current values of the start up command parameters. | IOMODE=cc | This example displays the current I/O mode; this is not the mode that appears on the INFO-line. It is the two character code entered as the mode in the start up parameters. In VTAM mode it is displayed as IOMODE=IC. |
USER=cc | The OCUSERcc module suffix. | |||
ROWS=nn | The number of rows on the physical terminal. | |||
LROWS=nnn | The number of rows per screen that are available for scrolling or printing. | |||
COLS=nnn | The number of columns on the physical terminal. | |||
UNIT=ccc | The terminal address of a dedicated session. This does not appear in the TSO mode. | |||
.PRT | .PRT<H> | Prints the specified portion of the screen to the report file. | ||
PSW | PSW | Displays the CICS PSW and TCB general purpose registers. | The PSW command displays the PSW and TCB general purpose registers for the CICS major TCBs (quasi-reentrant, resource owning and concurrent). | |
/PWD | /PWD cccccccc | Specifies a password for a session. | Some commands might require that you enter a password before you attempt to run them. Use the /PWD command to enter your password. You are prompted for a password after you enter the /PWD command. For security reasons, the password does not appear on the screen. The password remains in effect until you reset it by pressing the PA1 key or entering the /ATTN or /PWD command. | |
.R | .R <nnn> | Repeats the preceding major or minor command sequence n times. | This command is helpful for use with the major commands that select more items than can fit on a line. | |
RATE | RATE <RESET> | <keyword=cccc...> | Transaction rates for the transactions exceeding the thresholds. | The optional operands can be entered with the rate command or their values modified by over typing the command line output. | |
.RC | .RC | Repeats the preceding major or minor command sequences to display all items. | The .RC command repeats the preceding sequence of major and minor commands from a major command that selects multiple items up to .RC; it repeats the sequence until all items selected by the major are displayed. | |
RENM | RENMa bbbbbbbb cccccccc | Renames a screen space. The rename request is ignored if the RKOCPCSV DD statement consists of concatenated data sets. | RENMI SAMPLE SAMPLE2 | This example renames screen space SAMPLE to SAMPLE2 in the in-storage screen facility. |
/REP | /REP cccccccc <a> | Replaces the existing screen space or PFK definition. | The /REP command only replaces existing named screen spaces. | |
/RESHOW | /RESHOW | Displays a new copy of the current screen space. | After you have altered the screen by deleting or adding commands, you might want to obtain a new copy of the screen. If you assign a function key to the /RESHOW command, you do not need to retype the current screen space name to refresh the screen. | |
RESP | nRESP <ID=cccccccc> | <G|TR|TE|P | <N=nn> | Displays response times over the last 10 minutes for monitored IDs. | ||
RLIM | RLIM <ON|OFF> | Displays the status of resource limiting. You must first define
thresholds for the CICS resources and transactions.
If resource limiting is active, OMEGAMON for CICS (3270) purges any CICS transaction reaching its resource limit. If resource limiting is not active, no CICS transactions are purged regardless of how many resources they use. |
GLOB RLIM | Displays the type of resource limiting set up. |
.RMF | .RMF | This command displays whether or not RMF is active. When OMEGAMON for CICS (3270) is authorized, it also displays the RMF version code and version number, the current interval length, and the cycle time. | ||
RMFS | RMFS nnn | Sets the RMF level when it has selected the default. | For example, RMFS 351 monitors a system that is running RMF level 3.5.1. RMFS cannot change the RMF level setting when the product has dynamically determined the correct level. Use the .RMF command to display the level of RMF that your system is running. | |
RSP | nRSP<TX|PG|TR> | Displays moving time slot response time data. | ||
RSP | RSPnnn | Sets device pending time threshold for the XDSK command. The minor command of the CDEV command. |
||
RTA | RTA <ccccc> | <keyword=n> | Controls the response time collector status and RSP display scale or window. | ||
.RTN | n.RTN<NR><cccccccc> | Returns to the calling screen space during ASF or TSF processing | Required at the bottom of the last screen in an ASF or TSF sequence. It returns to the calling or specified screen and re-enables exception analysis for further automatic calls. | |
/SAVE | /SAVE cccccccc <a> or /S cccccccc <a> | Saves the specified screen space. | The /SAVE command works only if you have an RKOCPCSV allocated and cccccccc does not already exist. If cccccccc already exists, use the /REP command. To save the cursor in any position on the screen, move the cursor to the desired position and press enter. The cursor appears in that position whenever OMEGAMON invokes the screen. The default cursor position is on the INFO-line. | |
.SCC | .SCC | Displays or sets options for screen color or highlighting. To define a set of options for a user profile, set the ProfileDefinitionMode keyword to ON. Changes made in this mode do not affect your current session unless you change the setting for the DISPLAY keyword from Basic, High, or Low to Color, or from Color to Basic; then the related keyword settings are automatically converted to those specified in your user profile. |
.SCC Display=COLOR >>Done<< | The .SCC command sets screen intensity or color options for either the current session or for a user profile. The .SCC command accepts keyword input on the command line and displays a message after the command is run. |
SCHN | -SCHNc jobname,spacename,addr,string,off1, off2,plen |
Scans data space control block. | The SSCN command scans data space storage until it finds a match to the string, the chain loops, or until the address of the next control block is zero. When necessary, an SRB is scheduled into the address space of the TCB owning the data space to be scanned. | |
SCRN | SCRN<a><c1 c2> | Lists screen member names. | SCRN C D | This example lists all screens stored in both disk data sets and main storage that have names starting with C or D. |
SDSK | aSDSK xx | Selects device by string address. The minor command of the CDEV command. |
FSDSK12 | This example selects all CICS DASD devices on the 12x string. |
.SET | .SET keyword=value keyword=value | Displays or sets global values and switches. | .SET PEEKSIZE=4096 DGENLIMIT=200 | This example sets the PEEK buffer size to 4096 bytes and the DGENLIMIT to 200. |
.SGO | nSGO cccccccc <bbbbbbbb aa value> | Gets the specified screen space on the next update. | .SGO SAMPLE | Gets screen SAMPLE. |
.SGO ZZONDVSH &ZCONDVLV=SUMMARY | Gets screen .SGO SAMPLE only if &ZCONDVLV is equal to SUMMARY. | |||
SIT | SIT<cccccc> | Displays system initialization table (SIT) information. | The SIT command displays information from the CICS System Initialization Table. The values displayed reflect any SIT overrides entered during initialization. | |
SLST | -SLSTa jobname,spacename,addr,plen | Lists dataspace storage. | The SLST command lists memory from data spaces. When necessary, an SRB is scheduled into the address space of the TCB owning the data space to be listed. | |
SOUT | SOUT<c> | Displays or sets the SYSOUT class. The minor command of the OUTP command. |
The SOUT command removes control from ddname. | |
.SPT | .SPT</n cccccccc> | Sets pattern number n to the value cccccccc for generic selection. | You can use the .SPT command to a set up to 10 patterns for use with
the DEVP command and the address space major commands. To start a pattern, follow DEVP (or any address space major) with a slash (/) and the pattern number. To start the default pattern, follow DEVP or the address space major with a /. |
|
SSCN | -SSCNa jobname,spacename,addr,string,len1,len2 | Scans data space storage for a specified string of data. | The SSCN command scans data space storage until it finds a match to the string or the length of storage specified is exhausted. When necessary, an SRB is scheduled into the address space of the TCB owning the data space to be scanned. | |
STEP | STEP | Displays information about the region and program for this step.
The minor command of PEEK. |
For each region, STEP displays the region size, storage in use, limit, current program, and so forth. | |
/STK | /STK <ccccc> | Performs screen stacking functions. | Recalled stacked entries remain on the stack until explicitly deleted or cleared. | |
/STOP | /STOP | Stops the current user session. | ||
STOP | STOP | Stops the current user session. | ||
STOR | STOR <cccc...> | CICS storage data and storage usage by tasks and CICS subpools. | ||
SUBP | aSUBP<nn> | Displays information about storage allocated in sub pools. The minor command of the PEEK command. |
||
SZAP | -SZAP jobname,spacename,addr,vercode,repcode | Zaps data space storage. | The SZAP commands zaps memory in data spaces. When necessary, an SRB is scheduled into the address space of the TCB owning the data space to be zapped. | |
TABL | TABL <tablename> <keyword=cccc,keyword=cccc...> | Search and display CICS Tables and their entries. | ||
TAPE | TAPE | Selects all online tape drives. | ||
TASK | nTASK <operand | keyword=cccc....> | Displays summary information about all tasks currently executing in CICS, or detail information about a selected task. | ||
TCBS | aTCBS | Displays the task control block (TCB) structure. The minor command of the PEEK command. |
||
TCTV | TCTV <DUMP> | Displays Terminal Control Table prefix information. | ||
TERP | TERP | Displays permanent read or write errors accumulated for a tape drive.
The minor command of all tape majors. |
||
TERT | TERT | Displays temporary read or write errors accumulated for a tape drive.
The minor command of all tape majors. |
||
TIME | nTIME<cc> | Displays response time data for ID groups. The minor command of the CSLT and CRSP commands. |
||
TLBL | TLBL | Displays the tape label type. The minor command of all tape major commands. |
The tape label types are SL, NL, or NON-STD. BLP tapes appear as NL. | |
TLST | TLST | Selects all tape drives (online and offline). | Displays unit addresses of selected drives. Offline drives are preceded by a hyphen (-). | |
TMPS | TMPS <DUMP> | Displays Temporary Storage information. | The TMPS command displays details about the temporary storage component of CICS, including information about both auxiliary and main temporary storage. | |
/TOP | /TOP | Scrolls to top of the logical screen. | This is the same as /UP MAX or /UP TOP. | |
TPaa | TPaa <cc> | Displays selected tape drives. | Displays unit addresses of selected drives. | |
TRAC | TRAC | Displays trace control information. | ||
TRND | TRND <DUMP> | Displays Transient Data information. | ||
TSEQ | TSEQ | Displays open file sequence number on a tape drive. The minor command of tape majors. |
Displays unit addresses of selected drives. | |
.TSF | .TSF<ccc> | Displays or sets the Timed Screen Facility (TSF). | .TSFOFF | This example turns TSF off. |
/TSF | /TSFccc | Turns on/off the Timed Screen Facility (TSF). | TSF lets you define a screen space or series of screen spaces to be invoked at certain times of the day or at specified intervals. The definitions are set with the .TSF command. The screens can be named screen spaces or PF key screens kept in memory. You must save your user profile to make these changes permanent. A screen space can contain commands to turn on different analyses, as well as the log. You can use TSF to automate many of your daily tasks. | |
TSQ | nTSQ <ID=cccccccc> <SEL=aaaa> | Displays temporary storage queues. | ||
TSQD | nTSQD <ID=cccccccc> <SEL=aaaa> | Performs temporary storage queue deletions. | ||
TSMD | nTSMD ALL <MODEL=cccccccc> <DUMP> | Displays Temporary Storage Model. | ||
TSWD | nTSWD <<QUEUE=cccccccccccccccc>
<OWNER|WAITER> <count>>
|
Displays Temporary Storage Queue Waits. | ||
/UP | /UP <cccc> or /U <cccc> | Scrolls up cccc lines. | /U is the alias for /UP. The initial PF setting for the /U command is PF19. If you enter any of the optional arguments on the INFO-line before you press the PF key, it interprets the entry as if you had entered the command plus the arguments. | |
.VAR | .VAR or .VAR aaa &bbbbbbbb | Displays or sets variable symbols. | .VAR | This example lists all defined variables. |
.VAR DEL &ZSVAR | This example deletes the ZSVAR variable. | |||
VSAM | nVSAM <cccccccc> | Provides summary and detail display of open VSAM files. | ||
.VTM | .VTM | Displays multi-session status information. | ||
.WAT | .WATnn | Specifies a delay before running the commands that follow. | .WAT02 .FGO MYSCREEN | This example causes the product to wait two seconds before fetching the MYSCREEN screen space. |
WEB | WEB | Displays the status of the web interface. | The Interface Status field displays one of the following
values:
The Garbage Interval field displays the frequency in minutes in which the garbage collection transaction CWBG is run to delete the marked tasks and their data. The Timeout Interval field displays the interval at which Web 3270 sessions are eligible for garbage collection. |
|
WSIZ | WSIZ<nnn> | Displays or resets the data collection work area’s size (shown
in K). The minor command of the PEEK command. |
When the work area size is changed, the work area is released, disabling all subsequent minor commands on the screen for that interval. On the subsequent interval, a new work area is obtained at the specified size. | |
XACB | XACB <<ALL|GROUP=cc|LIST=aaaa>
<VERBOSE|TERSE><FORCE>>
|
Displays or sets exception thresholds and attributes dynamically. | XACB LIST=TPDR TNRS VERBOSE FORCE | Runs and displays the TPDR and TNRS exceptions in multiline format. |
XDSK | aXDSK | Selects device by exception. The minor command of the CDEV command. |
Exception thresholds are set with other minor commands of CDEV. (Do a .MIN command to list them.) For example, if the total device response time threshold has been set to 100 milliseconds with the RSPnnn minor command, then XDSK selects any DASD device whose total response time is greater than 100 ms. | |
XGRP | XGRPcc | Invokes exception analysis for the cc exception group. | ||
XGSW | XGSW <GROUP=cc <STATE=ON|OFF|TEST|NDSP|NULL>> | Displays or sets exception group switches. | The ON, OFF, NDSP, and TEST commands override the individual exception settings for group switches. | |
/XLF | /XLF<ON|OFF|OUT> | Turns on or off the Exception Logging Facility (XLF). | /XLF OFF | This example turns off the XLF. See the following command description. |
.XLF | .XLF<ON|OFF|OUT> | Turns on or off the Exception Logging Facility (XLF). | Use the .XLF command to log exception messages automatically. This command functions only in dedicated mode or in VTAM mode with Automatic Updating in effect. .XLF writes exceptions to the XLFLOG. To view or change the defaults for this file, use the OUTP major command. | |
XMCH | -XMCHc targ,addr,string,olen,chain,dlen | Scans control block chains for a string of hex values or characters in a CICS address space. | The XMCH command displays the control block chain that contains the string if the scan is successful. | |
XMLS | -XMLSc targ,addr,dlen | Displays storage of specified CICS address space. | ||
XMSC | -XMSCa targ,addr,string,slen,dlen | Scans a CICS address space for a string of hex values or characters. | Displays the string if scan is successful. | |
XMZP | -XMZP targ,addr,xxxxxxxx,yyyyyyyy | Modifies a CICS address space’s private storage area. | The XMZP command schedules an SRB into the target address and modifies the contents of the indicated storage, so the XMZP command must be used with caution. | |
XRF | XRF | Displays the status of the CICS Extended Recovery Facility (XRF). | ||
XSUM | XSUM <GROUP=cc> <LIST=I> <RESET> | Displays exceptions in the specified order. Each exception is followed by its current state, threshold value (if any), and group ID. | XSUM GROUP=OS LIST=I | This example displays the exceptions in the OS exception group in invocation order. Each exception is followed by its current state, threshold value (if any), and group ID. |
XTRP | XTRP <GROUP=cc> <LIST=I> <RESET> | Displays each tripped exception followed by its current state, threshold values, and group ID. | XTRP GROUP=OS LIST=I | This example displays exceptions that have tripped in the OS exception group in invocation order. Each exception is followed by its current state, threshold value, and group ID. |
XTXT | XTXT<ccc...> | Specifies the message to display when no exceptions have tripped. | XTXT ‘no problems’ | This example displays the message 'no problems' when no exceptions have tripped. |
XVSC | XVSC<nn> | Sets VSAM split and extent exception analysis cycle. | The setting of the XVSC command affects the frequency in which messages are displayed for VCAS, VCIS and VMEX. | |
.ZAP | .ZAP | Displays maintenance applied. | The .ZAP command displays maintenance information as well as product and environment data. This output is used primarily in consultation with IBM Software Support. | |
/ZERO | /ZERO ccc | Displays or sets the way zeros display. | You might find that the screen is easier to read when zeros are displayed as blanks (as with /ZERO OFF). | |
/ZOOM | /ZOOM<cccc> | Zooms to the screen determined by the command at the cursor location. | The cursor must not be in either row 0 or the first or last position of a row. |