Enhancements to Existing Features › Options › Base Product Enhancements › Enhancements to Commands

Enhancements to Commands

The following enhancements have been made to existing commands.

ASADMIN

Address space administration

Syntax:

ASADMIN <options>

New option parameters:

• Cnfm, NOCnfm, Confirm, NOConfirm - Controls whether a user confirmation is requested before executing the STOP, SHUT, CANCEL, or FORCE line commands.
• SUmm, NOSUmm, SUmmary, NOSUmmary - Controls the display of the task summary data row. The task summary row displays an asterisk (*) for both the Task and ID fields.
• SErv, NOSErv, SErver, NOSErver, PRImary, NOPRImary - Controls the display of the CA SYSVIEW server address spaces (also referred to as the primary address space).
• User, NOUser, SECondary, NOSECondary - Controls the display of the CA SYSVIEW user address spaces (also referred to as the secondary address spaces).
• Aux, NOAux, Auxiliary, NOAuxiliary - Controls the display of the CA SYSVIEW auxiliary address spaces.
• SSid NOSSid - Controls the display of CA SYSVIEW address space IDs.
  • SSID displays only address space IDs using the same SSID as the current session.
  • NOSSID displays all address space IDs with any SSID.
• Rels, NORels, Release, NORelease - Controls the display of CA SYSVIEW address spaces.
  • RELS displays only addresses that are the same release as the current session.
  • NORELS displays all address spaces with any release.
• IJob, NOIJob, INACTJob, NOINACTJob, JOBInact, NOJOBInact - Controls the display of inactive jobs.
• ITask, NOITask, INACTTask, NOINACTTask, TASKInact, NOTASKInact - Controls the display of inactive tasks.
• Model, NOModel - Controls the display of model tasks.
• XSdata, XSystem, NOXSdata, NOXSystem - Controls whether to force on or off the cross system data collection for this execution. The use of any of these keywords does not alter the XSDATA profile setting.

  Default: XSDATA

  Note: None of these keywords are supported on the ASADMIN command OPTIONS subcommand.

New data fields:

• RPELast - The request processing elapsed time for the last (most recent) wait-to-post interval.
• RPEThrsh - The elapsed time of a threshold for a request processing post-to-wait interval.
• RPEEx - The number of times the elapsed time request processing threshold was exceeded.
• RPCLast - The request processing CPU time for the last (most recent) wait-to-post interval.
• RPCThrsh - The CPU time threshold for a request processing post-to-wait interval. Exceeding this threshold causes a console message indicating that this threshold was exceeded.
• RPCEx - The number of times the CPU time request processing threshold was exceeded.

COMMANDS

List commands and subcommands

New data field:

• Rels - Displays the release number when the command was introduced.

FIELDS

Field definitions

New data field:

• Description - Describes the field.

FIND

Find string in display data

FIND string<,keyword1><,keyword2><,col1<,col2>><,options><,fieldname>

New "options" keyword:

• NOPOINT - Requests that the following actions are not performed when a FIND command completes successfully:
  • Do not scroll the data row to the left or right of the found string making the found string visible on the display.
  • Do not position the cursor at the found string.
  • Do not highlight the found string using either the FINDINPUT or FINDOUTPUT screen field attributes.

GROUPS

Logical groups

New logical group types:

• DBAREA - Contains the Database areas specified in the format:

  database.areaname
  

• IMSBALG - Contains the IMS balancing group.
• IMSESUB - Contains the IMS external subsystem specified in the format:

  jobname.subsys
  

• IMSLTERM - Contains the IMS logical terminals specified in the format:

  termtype.terminal
  

• IMSOTMA - Contains the IMS OTMA specified in the format:

  Tmember.Tpipe
  

• OUTCLASS - Contains the JES output classes.
• TYPEJOBN - Contains the job type and job name specified in the format:

  Type.Jobname
  

• WMREPORT - Contains the WLM report class.

IDMSLIST

CA IDMS address space list

Renamed data field:

• New name: XSSystem

  The field XSystem was renamed to XSSystem. The home system name is highlighted.

LISTMAPS

List storage maps loaded

New data field:

• MapCt - The number of map entries that are defined for the map.

PLOT

Plot historical data

The PLOT syntax has been enhanced to allow the display of one to four graphics plots or quadrants. Each plot quadrant can include one or two metrics.

Syntax:

PLOT   <args1> <args2> .. <args8> <options>
args = quad
       source
       METRIC metric
       RSCE1  rsce1
       RSCE2  rsce2
       SCALE  scale

• quad - Specifies the plot quadrant for the arguments to follow.
• source - Displays the source of the data. The following keyword and value pairs are used to specify the data source. The keywords are all synonyms of each other. Each keyword allows for an associated parameter of a previously defined maximum length.
• MVS - Obtains data from the MVS data collector. The MVS keyword is not required. No parameter is allowed.
• CICS jobname - Obtains data from the CICS data collector. The data must be requested for a specific CICS region. Specify the desired CICS jobname as the associated value for the keyword CICS.

  The current target jobname is used when you use an asterisk * as the jobname.

  Maximum parameter length: 8

• QMGR qmgr - Obtains data from the WebSphere MQ data collector. The data must be requested for a specific MQ Qmgr. The desired MQ Qmgr must be specified as the associated value for the keyword "QMGR".

  Maximum parameter length: 4

• IMSid SSID - Obtains data from the IMS data collector. The data must be requested for a specific IMS subsystem. The desired subsystem must be specified as the associated value for the keyword IMSID.

  Maximum parameter length: 4

• TCPid jobname - Obtains data from the TCP/IP data collector. The data must be requested for a specific TCP/IP stack. The desired stack jobname must be specified as the associated value for the keyword TCPID.

  Maximum parameter length: 8

• METric metric - Specifies the data collection metric variable display name. For a list of available metrics, see the following commands in the online help:
  • VARS - MVS
  • CVARS - CICS
  • IMSVARS - IMS
  • MQVARS - WebSphere MQ
  • TCPVARS - TCP/IP
• RSCE, rsce, RSCE1, R1 - The data collection resource qualifier for the selected metric name.
• RSCE2, rsce, R2 - The data collection resource qualifier for the selected metric name. Only the CICS data collector uses the resource qualifier 2.
• SCALE, scale - Sets the maximum vertical scale value. By default, the maximum vertical scale value is set to the maximum value displayed within the plot. Valid values are:
  • Maximum - Sets the vertical scale to the maximum plot value.
  • Average - Sets the vertical scale to the average plot value.
  • nnnnnnn - Sets the vertical scale to specify a numerical value.
• COLUMNS, cols, COLS - Specifies the number of columns to use in the plot area.
  • Minimum - 10
  • Maximum - 60

  You can only specify columns when you specify a single lot quadrant.

• ROWS, rows - Specifies the number of rows to use in the lot area.
  • Minimum: 1
  • Maximum: 100
• SMALL - Specifies to display the plot with the following attributes:
  • ROWS: 10
  • COLUMNS: 20
• REPORT, NOREPORT - Specifies whether the following report areas are displayed after the plots:
  • Current values
  • Plot legend
  • Plot member source
  • Metric variable descriptions

PRINT

Print display lines

Syntax:

PRINT  <operation><,line-num><,mem-name><,options>

New options keywords:

• MSg - Requests to display the PRINT command result message.
• NOMSg - Requests that the PRINT command result message is not displayed. Error messages are not suppressed.

ROWDISP

Row display

New OPTIONS subcommand keywords:

• Hex, NOHex - Controls whether the data field values that contain nondisplayable characters are displayed in hexadecimal format.

New data fields:

• Description - Displays the field description.

SCREEN

Screen field attributes

The default color attribute for the "dummy input field" field type has been changed to YELLOW in the default profile.

Name   Type   Intens Color   Hilite  Description
DUmmy  INPUT  LOW    YELLOW  NONE    Dummy data input fields

SCHEDULE

Scheduled events

New Time Series Facility Data Collection Event Functions:

• MVS-TSF-CHANNELS - Channels
• MVS-TSF-CPU - CPU processors
• MVS-TSF-DEVICES - DASD and tape devices
• MVS-TSF-JOBS - Address spaces/jobs
• MVS-TSF-SYSTEM - System level metrics
• MVS-TSF-USS - UNIX System Services

• MQS-TSF-BUFPOOLS - Buffer pools
• MQS-TSF-CHANNELS - Channels
• MQS-TSF-PAGESETS - Page sets
• MQS-TSF-QMGRS - Queue manager status
• MQS-TSF-QUEUES - Queues

• IMS-TSF-BUFPOOLS - Buffer pools
• IMS-TSF-POOLS - Pools
• IMS-TSF-SYSTEM - System level metrics
• IMS-TSF-TRANS - Transactions

• IMSDATA-BALGRPS - Balance groups
• IMSDATA-DATABASE - Databases
• IMSDATA-ESUBSYS - External subsystems
• IMSDATA-LOCKS - IRLM locks
• IMSDATA-LTERMS - Logical terms
• IMSDATA-OSAM - OSAM buffer pools
• IMSDATA-OTMA - Open Transaction Manager Access
• IMSDATA-VSAM - VSAM buffer pools

SELECT

Set the field selection criteria

The SELECT command can be used to select data rows of filter data based on the contents of a defined logical group. A list of items can be defined in a logical group and then used in the SELECT command.

Syntax:

SELECT field oper value

New oper keywords:

• IN - The value parameter specifies the field value in a logical group name and logical group type.
• NI - The value parameter specifies the field value not in a logical group name and logical group.

The value parameter has the following syntax when you specify either the IN (in group) or NI (not in group) operators:

groupname</grouptype>

The GROUPS command displays information about the defined logical groups and types. The FIELDS command displays the default logical group type that is defined for a field.

• Type - JOBNAME
• Group - CICSBANK
• Members - CICSAREC, CICSAPAY, CICSCHCK, CICSSAVE

Issue the following SELECT command from a display that contains job names. The data rows that contain any of the defined job names in the logical group are displayed:

SELECT JOBNAME IN CICSBANK

or

SELECT JOBNAME IN CICSBANK/JOBNAME

STATUS

Product status

New data field:

• SMTP
  • Host Name
  • Port Number
  • IP Version
• Facilities
  • Decimal floating-point zoned conversion
  • Execution hint
  • Load and trap
  • Miscellaneous instruction extensions
  • Processor assist
  • Constrained transactional execution
  • Local TLB clearing
  • Interlocked access
  • Transactional execution
  • Enhanced DAT 2

SYSDMON

System data collection monitor

Renamed data field:

• The field XSystem was renamed to XSSystem.

  Indicates the system name of the origin of the data. The home system name is highlighted.

USERS

Product users

Syntax:

USERS   <options>

New option parameters:

• XSdata, XSystem, NOXSdata, NOXSystem - Controls whether cross system data collection is forced on or off for this execution.

  Default: XSDATA

  Note: None of these keywords are supported on the USERS command OPTIONS subcommand.

• SSid NOSSid - Controls the display of CA SYSVIEW sessions.
  • SSID displays only CA SYSVIEW sessions using the same SSID as the current session.
  • NOSSID displays all sessions with any SSID.
• Rels, NORels, Release, NORelease - Controls the display of CA SYSVIEW releases.
  • RELS displays only sessions that are the same release as the current session.
  • NORELS displays all sessions at any release.

Renamed data fields:

• New name: JStat

  Status was renamed to JStat.

• New name: TStat

  Task was renamed to TStat.

VLIST

List user and system variables.

New data fields:

• DModule - The name of the module that defined the variable.
• DOffset - The offset within the defining module to the call to define the variable.
• DRoutine - The name of the routine with the module that defined the variable.

Renamed data fields:

• New name: XAddr

  Exit was renamed to XAddr.

• New name: XModule

  Module was renamed to XModule.

• New name: XOffs
• Offset was renamed to XOffs.
• New name: XParm

  Parm was renamed to XParm.

XSCMDS

XSystem capable commands

New information section field:

• DataLenLim - Indicates the limit for all cross-system data this system supports. The XSYSTEM PARMLIBXsdsGetCmdDataLenLimit parameter value sets this limit. This value is the limit for all of the received data from all cross-system data servers. The data for any system that exceeds this value is discarded.

Changed information section fields:

• DataLenMax - Indicates the maximum cross-system data length this system supports. The XsdsGetCmdDataMaxLenXSYSTEM PARMLIB parameter value sets this limit. Requesting cross-system data sends this value to the remote system cross-system data server where it is compared to the remote system value. The smaller of the two is used to limit the amount of data that can be returned.

Renamed data field:

• New name: DatLenMax

  The field MaxData was renamed to DatLenMax.