SysviewPM Rel Notes Enu
SysviewPM Rel Notes Enu
Management
Release Notes
Version 13.0
This documentation, which includes embedded help systems and electronically distributed materials, (hereinafter referred to as
the “Documentation”) is for your informational purposes only and is subject to change or withdrawal by CA at any time.
This Documentation may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without
the prior written consent of CA. This Documentation is confidential and proprietary information of CA and may not be disclosed
by you or used for any purpose other than as may be permitted in (i) a separate agreement between you and CA governing
your use of the CA software to which the Documentation relates; or (ii) a separate confidentiality agreement between you and
CA.
Notwithstanding the foregoing, if you are a licensed user of the software product(s) addressed in the Documentation, you may
print or otherwise make available a reasonable number of copies of the Documentation for internal use by you and your
employees in connection with that software, provided that all CA copyright notices and legends are affixed to each reproduced
copy.
The right to print or otherwise make available copies of the Documentation is limited to the period during which the applicable
license for such software remains in full force and effect. Should the license terminate for any reason, it is your responsibility to
certify in writing to CA that all copies and partial copies of the Documentation have been returned to CA or destroyed.
TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION “AS IS” WITHOUT WARRANTY OF ANY
KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR
PURPOSE, OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE,
DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST
INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE
POSSIBILITY OF SUCH LOSS OR DAMAGE.
The use of any software product referenced in the Documentation is governed by the applicable license agreement and such
license agreement is not modified in any way by the terms of this notice.
The manufacturer of this Documentation is CA.
Provided with “Restricted Rights.” Use, duplication or disclosure by the United States Government is subject to the restrictions
set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-7014(b)(3), as applicable, or
their successors.
Copyright © 2011 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to
their respective companies.
CA Technologies Product References
This document references the following CA Technologies products:
■ CA DATACOM®/DB (CA DATACOM)
■ CA Mainframe Software Manager (CA MSM)
■ CA SYSVIEW® Performance Management (CA SYSVIEW)
■ CA SYSVIEW® Performance Management Option for CICS (CA SYSVIEW Option for
CICS)
■ CA SYSVIEW® Performance Management CA Datacom® Option (CA SYSVIEW CA
Datacom Option)
■ CA SYSVIEW® Performance Management Option for IMS (CA SYSVIEW Option for
IMS)
■ CA SYSVIEW® Performance Management Option for TCP/IP (CA SYSVIEW Option for
TCP/IP)
■ CA SYSVIEW® Performance Management Option for WebSphere MQ (CA SYSVIEW
Option for WebSphere MQ)
■ CA Vantage™ Storage Resource Manager (CA Vantage GMI)
Contact CA Technologies
Contact CA Support
For your convenience, CA Technologies provides one site where you can access the
information you need for your Home Office, Small Business, and Enterprise CA
Technologies products. At http://ca.com/support, you can access the following:
■ Online and telephone contact information for technical assistance and customer
services
■ Information about user communities and forums
■ Product and documentation downloads
■ CA Support policies and guidelines
■ Other helpful resources appropriate for your product
Provide Feedback
Contents 5
Security ................................................................................... 88
REXX Environment .......................................................................... 88
User Created Displays ....................................................................... 89
6 Release Notes
Chapter 1: New Features
This section contains the following topics:
Data Collection (see page 7)
zIIP Exploitation (see page 8)
Data Collection
The CA SYSVIEW data collection process collects and monitors metrics for all of
supported components such as: z/OS, CICS, IMS, WebSphere MQ, and TCP/IP.
The CA SYSVIEW Event Scheduler controls the data collection processes as follows:
■ The scheduler provides the ability to schedule events on an interval basis.
■ The scheduled event definitions can be customized to control the collection
interval, time of day and day of week.
■ The scheduler controls the data that is being collected and how often.
In addition to being able to set the data collection frequency, you can select the
individual metrics that are collected.
The CA SYSVIEW data collector components collect, monitor, and provide exception
processing for many resources and metrics.
In some sites, users do not collect data on all possible resources and metrics. In this
situation, the collection of unwanted or unneeded metrics is a waste of important
system resources and CPU cycles.
The disabling of unwanted or unneeded data collection metrics reduces CPU cycles and
the amount of storage used by the data collection data spaces. The reduction in data
space storage also reduces the amount of real storage used by the SYSVAAST data
anchor address space.
zIIP Exploitation
IBM offers an optional specialty processor type know as a z/architecture Integrated
Information Processor (zIIP processor). The zIIP processor offers the potential of
offloading specific types of work from a general processor or CP.
8 Release Notes
Chapter 2: Enhancements to Existing
Features
This section contains the following topics:
CA Mainframe Software Manager (see page 9)
Documentation (see page 9)
Administration (see page 10)
Options (see page 18)
Components (see page 84)
Note: For more information, see your product's installation instructions and the CA
Mainframe Software Manager Product Guide.
Documentation
This section contains topics related to documentation enhancements.
These best practices represent years of product experience, much of which is based on
customer experience reported through interviews with development, technical support,
and technical services. Therefore, many of these best practices are truly a collaborative
effort stemming from customer feedback.
Administration
The CA SYSVIEW administration features have been enhanced.
The following subtask was moved from the Main Services address space to the User
address space:
■ XSDS - XSystem data server task
The following subtask was moved from the Main Services address space to the User
address space:
■ XSDS - Cross-system data server task
10 Release Notes
Administration
The REXXDSN= GEN module parameter identifies the SYSVIEW REXX library.
The library is installed as a RECFM=F data set. RECFM=V data sets for the SYSEXEC DD
and the SYSVIEW REXX DD must be copied and converted to a RECFM=V data set.
The SYSVIEW REXX library contains text and compiled REXX executables. Compiled REXX
EXEC cannot simply be copied from a RECFM=F data set to a RECFM=V data set. They
must be converted.
CA SYSVIEW supplies the following two REXX utilities to copy and convert the SYSVIEW
REXX executables:
■ GSVUCFV1
Uses ISPF library management services to copy one or more REXX executables from
a RECFM=F data set to a RECFM=V data set. This EXEC can also call the GSVUCFV2
EXEC to convert any complied REXX executables copied.
■ GSVUCFV2
Uses ISPF library management services to convert a single complied REXX EXEC
from a RECFM=F data set to RECFM=V data set.
CA SYSVIEW supplies the following job in SAMPLIB to copy and convert the SYSVIEW
REXX executables:
■ REXXFTOV
This SAMPLIB JCL member invokes the GSVUCFV1 REXX EXEC to copy all REXX
executables from a RECFM=F data set to a RECFM=V data set and then to convert
any complied REXX executables that were copied by invoking GSVUCFV2.
Note: The REXXDSN= GEN module parameter must specify the data set name of the
converted RECFM=V data set.
SMF Records
CA SYSVIEW can optionally create SMF records. The record layouts, DSECT, are
distributed in the sysview.CNM4BMAC data set. The following table describes the SMF
type 255 subtype records and shows the macro library in which they are distributed:
12 Release Notes
Administration
Specifies whether to perform threshold processing for the specified data type.
datatype
■ IMSDATA-POOLS
■ IMSDATA-SYSTEM
■ IMSDATA-TRANSUM
You can insert fields from the information section at run time using specially named
variables.
The INFOFLDS command displays the list of available information section field names
and also indicates whether the extended data is available in the field.
14 Release Notes
Administration
Specifies whether threshold processing is performed for the specified data type.
datatype
■ MQSDATA-BUFPOOLS
■ MQSDATA-CHANNELS
■ MQSDATA-DQMGRS
■ MQSDATA-PAGESETS
■ MQSDATA-QUEUES
■ MQSDATA-SYSTEM
Specifies whether threshold processing is performed for the specified data type.
datatype
■ MVSDATA-CHANNELS
■ MVSDATA-CPUS
■ MVSDATA-DEVICES
■ MVSDATA-JOBS
■ MVSDATA-SYSTEM
■ MVSDATA-USS
16 Release Notes
Administration
Options
The enhancements to the CA SYSVIEW options are provided in this section.
18 Release Notes
Options
You can insert data and information section data into commands.
Primary commands can include substitution of a data field value from a specified row or
an information section field value.
row
A row number, which can be specified as:
nnn
The row number specified as a decimal string of one to nine digits from 1 to the
number of rows displayed.
*
The current row number (the number of the first data row displayed on the
screen).
*+|-nnn
The current row number adjusted by a one- to nine-digit number. The resulting
value is treated the same as for the nnn form.
field
The name of the field on the row defined by the row value whose data is used to
replace the variable reference. The &<row/field> value must be specified on a
formatted screen and the field name must be a valid field defined in the format.
The field must be authorized but it is not necessary to include it in the format.
The field data is left justified and trailing blanks are removed before the
substitution is performed.
infofield
The name of an information line field. The information field value is left justified
and trailing blanks are removed before the substitution is performed.
The field and information field names can be truncated. The search for a match first
tries for an exact match and then allows a generic match. Whatever matches first is
used - no check is made to see if the supplied argument is ambiguous.
The &<row/field> and &<infofield> strings can contain blanks anywhere between the <
(less than) and > (greater than) characters. The overall length including blanks must be
32 character or less. The blanks are then compressed out and any other length checks
refer to the compressed string.
It is compressed to:
ECHO &<*+2/jobname>
The following is not valid because the length (not including the &) is greater than 32:
The maximum length of an actual information field is 32. The maximum length that can
be entered using the &<xx> format is only 30, because the < and > characters add two
characters.
20 Release Notes
Options
The following new command substitution variables have been added to the base
product:
■ &&DataRowCurr
Current data row number.
The value is 0 if no data rows are displayed.
■ &&DataRowHigh
High data row number - the number of data rows displayed.
The value is UNDEFINED if the high data row number is unknown.
■ &&DataColCurr
Current column offset. Indicates the number of columns that the display is scrolled
to the right.
Commands Enhanced
22 Release Notes
Options
DB2LIST
DB2 subsystem list
New data field:
■ JobReq - Indicates if the job has been defined as a job that is required to be
active.
Possible values are:
– blank - The job is not required to be active.
– JOBREQ - The job is required to be active.
■ Description - Describes the address space based on the jobname. The
description is defined in the parmlib member JOBNAMES.
IDMSLIST
CA IDMS address space list
New data field:
■ JobReq - Indicates if the job has been defined as a job that is required to be
active.
Possible values are:
– blank - The job is not required to be active.
– JOBREQ - The job is required to be active.
■ Description - Describes the address space based on the jobname. The
description is defined in the parmlib member JOBNAMES.
GROUPS
Logical groups new syntax:
GROUPS ADDMember group type member < INCLUDE | EXCLUDE >
SCHEDULE
Scheduled events
New syntax:
SCHEDULE <ADDLINE|NOADDLINE>
24 Release Notes
Options
STATUS
Displays the product and environment information.
New data fields:
Facilities
■ Enhanced monitor
■ Floating point extension
■ Set program parameters
■ Distinct operands
■ Fast BCR serialization
■ High word
■ Interlocked access
■ Load and store on condition
■ Population count
■ IBM internal use (5.02)
■ CMPSC enhancement
■ IBM internal use (7.02)
■ IBM internal use (7.01)
■ Crypto AP-Queue adapter interruption
■ Reset reference bits multiple
■ CPU measurement counter
■ CPU measurement sampling
■ AISI
■ AEN
■ AIS
■ Access-exception-fetch, store-indication
■ Message security assist extension 3
■ Message security assist extension 4
Software Versions
■ zIIP enablement
26 Release Notes
Options
SYSDMON
System Data Collection Monitor.
New data fields:
■ Owner - Name of the data collection owner.
■ OwnStat - Status of the owning data collection task.
■ Schedule - Scheduled event status.
Possible values:
– ACTIVE - There is an active scheduler event for this data collection type.
– INACTIVE - There is no active scheduler event for this data collection type.
■ TCPUTime - The total CPU time used by the collection process.
TCpuTime = CPTime + EnclTime
■ Pct% - The percentage of the Main Services Address Space used by the
collection event.
■ CPTime - The total task CPU time.
■ EnclTime - The total enclave CPU time.
■ ePct% - The percent of the total CPU time used by the task that executed on an
enclave.
■ zIIPonCP - The total enclave CPU time that ran on a general processor that was
eligible to run on a zIIP processor.
■ zIIPTime - The total enclave CPU time running on a zIIP processor.
■ zPct% - The percent of the total CPU time used by the task that executed on a
zIIP processor.
■ Thresh - Specifies whether the threshold exception processing is currently
active for this data collection type.
Possible values are:
– ACTIVE - Thresholding is active
– INACTIVE - Thresholding is not active
– blank - Thresholding is not applicable to this type.
■ ThrsCnt - The number of times exception processing has occurred.
■ ThrsDate, ThrsTime - The date and time that exceptions were last processed.
VDEFINE
Define a user variable.
New syntax:
VDEFINE name,<value>,<attrs>
New attributes:
■ Redefine, NORedefine - Controls the action taken when the variable name is
already defined as a user variable.
REDEFINE deletes the variable and redefines with a new value and permanent
or temporary attribute.
NOREDEFINE causes the VDEFINE command to fail with a message stating that
the user variable is already defined.
This option has no effect when the supplied name matches an existing system
variable name. System variables cannot be redefined.
VLIST
List user and system variables
New data fields:
■ SeqNo - The variable definition sequence number. Variable definitions are kept
on a push-down stack. They were defined in descending sequence number
order and are searched in ascending sequence number order.
Duplicate names are possible and the first match is used.
28 Release Notes
Options
XVEXTRAC
External variable extract
New option to extract data collection metrics.
New options to the XVEXTRAC DATA command and REXX function.
■ Extended|NOExtended - Controls whether to return extended data in the
stem.n variables. The default is NOEXTENDED. The EXTENDED data format
depends on the type of data in the field.
■ ROWs row - Specifies the row number to start data extraction and specifies
how many rows to extract.
■ If this parameter is omitted, the start data row is 1 and all data rows are
extracted. This parameter can be specified in one of the following formats:
– *
– */numrows
– *+nnn
– *+nnn/numrows
– *-nnn
– *-nnn/numrows
– startrow
– startrow/numrows
– startrow-endrow
where
– * - The current row number.
– numrows - Number of rows as a one- to nine-digit decimal number.
– startrow - Start row number as a one- to nine-digit decimal number.
– endrow - End row number as a one- to nine-digit decimal number.
The profile Query command has been enhanced to include the following new keywords:
DATAROWCurr, ROWCUrr
Current data row number.
Value is 0 if no data rows are displayed.
DATAROWHigh, ROWHIgh
High data row number - the number of data rows displayed.
DATACOLCurr, COLCUrr
Current column offset. The number of columns that the display is scrolled to the
right.
30 Release Notes
Options
ASSET
Sets address space attributes.
New syntax:
ASSET <asid> DPRTY <value> <options>
DPRTY
Sets the dispatch priority.
Parameters:
asid
The ASID.
value
The new dispatch priority.
If the first character of the priority value is an X, the value is interpreted as a
hexadecimal value.
Examples:
ASSET JOBABCD DPRTY 255
CACHEDEV
Displays information about cache devices.
New line commands:
■ Cquery - Invokes the CQUERY command to query the PPRC status for the
selected device.
■ CQPaths - Invokes the CQUERY PATHS command to query the PPRC status the
selected device path.
■ FCQuery - Invokes the FCQUERY command to query the Copy Services for the
selected device (XRC, PPRC, Concurrent Copy, or FlashCopy).
CATALOG
Displays catalog information.
New data field:
■ Xtn% - The percentage of allocated extents for the catalog. This percentage
indicates the extent usage by either the data or index component, whichever is
higher.
This field is blank if the NOESCHR option is in effect.
This field displays n/a if the allocated extents value is not available or not valid
or the catalog status is CLOSED or DELETE.
This field also displays n/f to indicate not found.
32 Release Notes
Options
CPU
Displays CPU information.
New data fields:
■ State - State taken from the EXOPSW1.
Values can be:
– PROB - Problem state
– SUP - Supervisor state
This field is blank when the Mode is WAIT.
■ Ky - Key taken from the EXOPSW1. This field is blank when the Mode is WAIT.
■ AM - Addressing mode taken from the EXOPSW1.
Values can be:
– 24 - Specifies 24-bit addressing mode
– 31 - Specifies 31-bit addressing mode
– 64 - Specifies 64-bit addressing mode
This field is blank when the Mode is WAIT.
■ ASC - Address space control mode taken from the EXOPSW1.
Values can be:
– PRIM - Primary mode
– SEC - Secondary mode
– AR - Access register mode
– HOME - Home mode
– REAL - Real mode (DAT off)
This field is blank when the Mode is set to WAIT.
■ PASN - Primary address space number (ASID). This field is blank when the Mode
is WAIT.
■ PJobName - Primary job name. This field is blank when the Mode is WAIT.
■ SASN - Secondary address space number (ASID). This field is blank when the
Mode is WAIT or when the SASN is the same as the PASN.
■ SJobName - Secondary job name. This field is blank when the Mode is WAIT or
when the SASN is the same as the PASN.
■ HASN - Home address space number (ASID). This field is blank when the Mode
is WAIT or when the HASN is the same as the PASN.
■ HJobName - Home job name. This field is blank when the Mode is WAIT or
when the HASN is the same as the PASN.
34 Release Notes
Options
DSINFO
Displays data set information
New Syntax:
DSINFO dsname <volser><options>
GCOMMON
Displays common storage above 2G.
New data fields:
■ Jobname - Job name of the owner of the memory object.
■ Jobid - Job ID of the owner of the memory object.
■ ASID - ASID of the owner of the memory object.
■ Date - Date the memory object was created.
■ Time - Time the memory object was created.
■ EndDate - Date the owner of the memory object ended. Blank if the owner has
not ended.
■ EndTime - Time the owner of the memory object ended. Blank if the owner has
not ended.
■ HASID - Home ASID at memory object creation.
■ PASID - Primary ASID at memory object creation.
■ CASID - Caller ASID at memory object creation.
■ CReturn - Return address at memory object creation.
■ CRegion - CReturn address region.
■ CName - Module name at CReturn address.
■ COffs - Offset of CReturn address into CName module.
LGBROWSE
Log stream browser
Displays a progress message every 5 seconds while reading records from a log
stream.
New subcommands:
■ OPTIONS - Sets and displays available options:
– LIMit nnnnnnnn - Specifies the maximum number of records.
MOBJECTS
Memory objects summary
New data fields:
■ CCount - Count of common memory objects currently allocated with this ASID
as the owner.
■ CAlloc - Number of bytes allocated to common memory objects with this ASID
as the owner.
■ CHWMrk - High-water mark of common memory object allocated bytes with
this ASID as the owner.
36 Release Notes
Options
MTT
Master trace table
New subcommands:
■ OPTIONS - Sets and displays available options:
– All, Current - Controls whether all messages display or only messages
whose origin value matches the job ID of the current target ASID.
– Wtor, NOWtor - Controls whether to include outstanding WTOR messages
at the end of the messages that are displayed. When the CURRENT option
is in effect only WTORs for the current target address space display.
– Other, NOOther - Controls whether messages are displayed whose origin
value is not a job ID and not blank. The default is NOOther. This option is
used only when the CURRENT option is in effect.
– Blank, NOBlank - Controls whether messages are displayed whose origin
value is blank. This option is used only when the CURRENT option is in
effect.
– Master, NOMaster - Controls whether the BLANK option is assumed when
the current target address space is for *MASTER* (ASID 1). This option is
used only when the CURRENT option is in effect.
– Divider, NODIvider - Controls whether to display the divider line that
separates the MTT messages from the WTOR messages. This option is used
only when the WTOR option is in effect.
– Position, NOPosition - Controls whether special display positioning is done.
The POSITION option is only used when the WTOR option in effect.
NOPOSITION option positions the display so that the screen without the
last data row is at the bottom of the screen without regard to the number
of WTOR messages added to the last data item. The POSITION option does
the same when the number of WTOR messages is four or less. If the
DIVIDER option is not in effect, then the last MTT message is positioned at
the bottom of the screen.
MVSDATA
Sets MVS data collection options.
New syntax:
MVSDATA < parms > < options >
MONITOR datatype
CHKPOINT datatype
THRESH datatype nnnnnnnn
RELOAD type <member>
<SYSTEM system>
<GROUP group>
<options>
MSG | NOMSG
MVSDATA-CHANNELS
MVSDATA-CPUS
MVSDATA-DEVICES
MVSDATA-JOBS
MVSDATA-SYSTEM
MVSDATA-USS
38 Release Notes
Options
Functions removed:
■ MONITOR APPLIDS
■ MONITOR CHANNELS
■ MONITOR CPUS
■ MONITOR DEVICES
■ MONITOR JOBS
■ MONITOR JOBSTAT
■ MONITOR NODES
■ MONITOR SYSTEM
■ MONITOR UNIXDATA
■ MONITOR NOAPPLIDS
■ MONITOR NOCHANNELS
■ MONITOR NOCPUS
■ MONITOR NODEVICES
■ MONITOR NOJOBS
■ MONITOR NOJOBSTAT
■ MONITOR NONODES
■ MONITOR NOSYSTEM
■ MONITOR NOUNIXDATA
PARTINFO
Displays logical partition information defined in the physical hardware complex.
New information fields
■ ALL - Total of all types of CPUs.
Sum of CP, SP, and UNK.
■ CP - Number of CP CPUs.
■ SP - Number of specialty CPUs.
Sum of IFA, IIP, ICF, and IFL.
■ IFA - Number of IFA CPUs.
■ IIP - Number of IIP CPUs.
■ ICF - Number of ICF CPUs.
■ IFL - Number of IFL CPUs.
■ UNK - Number of unknown CPU types.
40 Release Notes
Options
42 Release Notes
Options
TASK
Displays the task structure.
New data fields:
■ PASN - Primary address space number (ASID). This field is blank when the PASN
is the same as the HASN (the ASID in info lines).
■ PJobName - Primary job name. This field is blank when the PASN is the same as
the HASN (the ASID in the info lines).
■ SASN - Secondary address space number (ASID). This field is blank when the
SASN is the same as the HASN (the ASID in info lines).
■ SJobName - Secondary job name. This field is blank when the SASN is the same
as the HASN (the ASID in the info lines).
Renamed data fields:
■ CPUTime - CPU-Time was renamed
■ RBOPSW1 - RBOPSW-1 was renamed
■ RBOPSW2 - RBOPSW-2 was renamed
■ CPUIntvl - CPU-Intv was renamed
■ CPUGraph - CPU-Graph was renamed
■ State - Sup was renamed
TASKMON
Task monitor
New data fields:
■ PASN - Primary address space number.
■ PJobName - Primary job name.
■ ASID - The ASID associated with the PSW.
■ PathName - The OpenMVS path name associated with the PSW.
VARS
z/OS monitor variable
New data field:
■ Disabled - If this value is DISABLED, data collection for variable has been
disabled.
VTOC
Volume Table of Contents
■ Grp - Group was renamed
■ Desc - Descr was renamed
■ Vol - Volser was renamed
■ Dsn - Dsname was renamed
■ Vol Tot - Volume Tot was renamed
■ Dsn Tot - Dsname Tot was renamed
WMENCLAV
WLM enclave
New data fields:
■ IFATime - The cumulative IFA time consumed by dispatchable units running in
the enclave on the local system.
■ IFAonCP - The cumulative IFA eligible time on CP.
■ SUPTime - The cumulative SUP time, in CPU seconds, used by the enclave.
■ SUPonCP - The cumulative SUP time consumed by dispatchable units running in
the enclave on the local system.
XLOG
Exception log
Displays a progress message every 5 seconds while reading records from a log
stream
New subcommands:
■ OPTIONS - Sets and displays available options:
– LIMit nnnnnnnn - Specifies the maximum number of records you want
read.
44 Release Notes
Options
XMVS
Issues command and view responses.
Enable command for cross system processing.
New syntax:
XMVS <options> command
Options:
■ XSData, NOXSData - Controls whether the XMVS command executes in cross
system data mode. The default is NOXSDATA.
■ CART, NOCART - Controls whether the CART (Command And Response Token)
specified on the command issued is required to match the CART associated
with any responses. The default is CART.
■ INTVL1 nnnnn - Specifies the number of seconds to wait for the first response.
Valid values are 0 through 60.
The interval can include a decimal point and up to two digits to the right of the
decimal point. If that value is 0 or has not been specified, then the default of
10.00 seconds is used.
The INTVL1 keyword can also be specified as INT1 or I1.
■ INTVL2 nnnnn - Specifies the number of seconds to wait for any possible
second through nth responses.
Valid values are 0 through 60.
The interval can include a decimal point and up to two digits to the right of the
decimal point. If that value is 0 or has not been specified, then the default of
0.25 seconds is used.
The INTVL2 keyword can also be specified as INT2 or I2.
■ COMMAND - This optional keyword specifies that the end of the options has
been reached and that the rest of the input is the command issued to z/OS.
You can specify the COMMAND keyword as CMD.
46 Release Notes
Options
JOBEIPCP
Provides the enclave zIIP time on CP (interval).
Resource: Jobname
JOBEIPT%
Provides enclave zIIP pct of total CPU time.
Resource: Jobname
JOBENCL%
Provides the enclave pct of interval CPU time.
Resource: Jobname
JOBENCT%
Provides the enclave pct of total CPU time.
Resource: Jobname
JOBENCTM
Provides enclave time (interval).
Resource: Jobname
JOBENCTT
Provides the enclave time (total).
Resource: Jobname
Commands Enhanced
LISTHELD
The Job held output queue.
New line commands:
■ JBrowse, Browse - Invokes ISPF BROWSE to display the output.
■ JEdit, EDit - Invokes ISPF EDIT to display the output. Changes are not saved.
■ JJcl, Jcl - Invokes ISPF EDIT to display the JCL and SYSIN data for the job.
Changes are not saved.
LISTJOBS
All job queues.
New line commands:
■ JBrowse, Browse - Invokes ISPF BROWSE to display the output.
■ JEdit, EDit - Invokes ISPF EDIT to display the output. Changes are not saved.
■ JJcl, Jcl - Invokes ISPF EDIT to display the JCL and SYSIN data for the job.
Changes are not saved.
LISTOUT
Job output queue.
New line commands:
■ JBrowse, Browse - Invokes ISPF BROWSE to display the output.
■ JEdit, EDit - Invokes ISPF EDIT to display the output. Changes are not saved.
■ JJcl, Jcl - Invokes ISPF EDIT to display the JCL and SYSIN data for the job.
Changes are not saved.
SYSLOG
System log queue. Support has been added for JES3.
A new MVS subtask starts within each CICS region to perform transaction post
processing functions. The CA SYSVIEW task GSVCTPPT performs the following functions
asynchronously to other CICS tasks at transaction completion:
■ Create detailed transaction record
■ Threshold processing
■ Statistics summaries
48 Release Notes
Options
This work was performed as part of the CICS global user exit XMNOUT.
By moving the work to a separate task, the global user exit XMNOUT completes more
quickly, returning control back to CICS. This increases CICS transaction throughput.
Transaction Monitoring
The CICS data collection process for transactions requires the CICS monitoring function
to be active.
A user can control the CICS monitoring function using the CEMT transaction.
Example: CEMT
If CICS monitoring is dynamically turned off while CA SYSVIEW is actively monitoring, the
CA SYSVIEW monitoring goes into a bypass mode for transaction monitoring.
The CA SYSVIEW for CICS Monitor Exit Interface (MEI) provides CICS programs or
transactions an API into the CA SYSVIEW for CICS data collection process.
Information passed to the MEI is recorded in the detailed transaction record of the
calling transaction.
The following two methods are available and both methods can be used within a single
transaction or program:
1. CICS command level program and a standard CICS COMMAREA
2. Assembler macro interface
Monitor Exit Interface Function Requests
■ Set Umbrella Name and Type
■ Record Non CICS Program Usage
■ Start the Timing of a File or Database Request
■ Stop the Timing of a File or Database Request
■ Set Field Data Values
■ Set Field Data - Correlation ID
■ Start the Timing of an Event
■ Stop the Timing of an Event
■ Get Field Data Values
■ Get Field Data - Correlation ID
■ Set User Data
■ Get User Data
For more information, see help topic CICS Monitor Exit Interface (MEI)
The CA SYSVIEW Option for CICS has been enhanced to include the following new
commands:
■ CFILEUSE - Provides information and status of CICS files in use.
■ CJVMPROG - Provides information and status for CICS JVM programs.
■ CJVMS - Provides information and status for CICS Java Virtual Machines (JVM).
■ CJVMSERV - Provides information and status for CICS JVM servers.
■ CSCHEDUL - Initiates CICS scheduled events.
■ CXDISTAT - Provides information about the CICS external data interface statistics.
50 Release Notes
Options
Commands Enhanced
■ SCHT% - The percentage of the CICS CPU time used by the scheduler process.
■ CpSCHT - The amount of CPU time the scheduler task consumed on a CP.
■ EnclSCHT - The amount of CPU time the scheduler task consumed in an
enclave.
■ eSCHT% - The percent of the total CPU time used by the scheduler task that
executed on an enclave.
■ CpuTPPT - The total CPU time the transaction postprocessor task consumed.
■ TPPT% - The percentage of the CICS CPU time the transaction postprocessor
task used.
■ CpTPPT - The amount of CPU time the transaction postprocessor task
consumed on a CP.
■ EnclTPPT - The amount of CPU time the transaction postprocessor task
consumed on an enclave.
■ eTPPT% - The percent of the total CPU time the transaction postprocessor task
used on an enclave.
■ CpuLOGT - The total CPU time the message logger task consumed.
■ LOGT% - The percentage of the CICS CPU time the message logger task used.
■ CpLOGT - The amount of CPU time the message logger task consumed on a CP.
■ EnclLOGT - The amount of CPU time the message logger task consumed on an
enclave.
■ eLOGT% - The percent of the total CPU time the message logger task used on
an enclave.
Renamed data fields:
■ CPUTime - CICSCPU was renamed to CPUTime.
■ ReqsGLUE - GLUEReqs was renamed to ReqsGLUE.
■ ElapGLUE - GLUETime was renamed to ElapGLUE.
■ CpuGLUE - GLUECpu was renamed to CpuGLUE.
■ GLUE% - GLUEPct% was renamed to GLUE%.
■ CpuSDCS - SDCSCpu was renamed to CpuSDCS.
■ SDCS% - SDCSPct% was renamed to SDCS%.
■ ReqsXDIS - XDISReqs was renamed to ReqsXDIS.
52 Release Notes
Options
■ REGion, Local - Displays only the current target address space. Cross system
data collection is set off for this execution.
The current profile setting of XSDATA is maintained.
■ SYStem, Global - Displays all CICS address spaces currently being monitored on
the current system.
■ XSYStem, XSData - Displays all CICS address spaces for all systems. Cross system
data collection is set on for this execution. The current profile setting of
XSDATA is maintained.
■ NOXSYStem, NOXSData - Turns off the cross system data collection for this
execution. The current profile setting of XSDATA is maintained.
■ GROUP - Specifies that an argument is to follow that specifies the group name
that contains the list of CICS regions to displayed. The list of available groups
with type CICSPLEX can be found on the GROUPS command.
A group name of * (asterisk) can be entered to indicate that no group
processing is required.
New data field:
■ Count - Exit program use count.
CFILES
CICS file control table entries
New data fields
■ DefGroup - The name of the definition group from where the entry was
installed.
New line commands:
■ Use - Invokes the CFILEUSE command selecting the filename to show the
transactions that are currently using the file.
CGBLEXIT
CICS global user exits
This command has been enabled for cross system data.
New syntax keywords:
CGBLEXIT < REGion | SYStem | XSYStem | NOXSYStem >
< Local | Global | XSData | NOXSData >
< GROUP name >
■ REGion, Local - Displays only the current target address space. Sets cross
system data collection off for this execution.
The current profile setting of XSDATA is maintained.
■ SYStem, Global - Displays all CICS address spaces currently being monitored on
the current system.
■ XSYStem, XSData - Displays all CICS address spaces for all systems. Sets cross
system data on for this execution. The current profile setting of XSDATA is
maintained.
■ NOXSYStem, NOXSData - Forces cross system data collection set off for this
execution. The current profile setting of XSDATA is maintained.
■ GROUP - Specifies that an argument is to follow that specifies the group name
that contains the list of CICS regions to displayed. The list of available groups
with type CICSPLEX can be found on the GROUPS command.
A group name of * (asterisk) can be entered to indicate that no group
processing is required.
New data field:
■ Jobname - The CICS jobname.
54 Release Notes
Options
GROUPS
CICS logical groups
New syntax:
CGROUPS ADDMember group type member < INCLUDE | EXCLUDE >
CICSLOGR
CICS data loggers
New data fields:
■ TCPByteS - The number of bytes sent using TCP/IP to a port specified in the
PortList.
PortList - The name of the logical group that contains a list of port numbers.
CICS integration information sent to this list of port numbers.
CICSSET
Alter CICS resources
New function/subcommands:
CICSSET CHKPOINT SCHEDULE
CICSSET EXPORT SCHEDULE dsn(member)
CICSSET SAVE SCHEDULE
CKTCB
CICS kernel tasks
New data fields:
■ ActTCBID - The active TCB ID used for trace.
■ DefTCBID - The default TCB ID used for trace.
CPROGRAM
CICS program statistics
New data fields:
■ DefGroup - The name of the definition group from where the entry was
installed.
CREVIEW
CICS hourly transaction activity
New data fields:
■ Date - The date associated with the hour of collection.
■ Ago - The number of hours previous to the current collection time period.
56 Release Notes
Options
CSYSDATA
CICS system interval analysis
Display a progress message every 5 seconds while reading records from a log
stream.
New data fields:
■ AtMxt -The number of times at max task during the interval.
New subcommands:
■ OPTIONS - Sets and displays available options:
– LIMit nnnnnnnn - Specifies the maximum number of records to read.
CSYSDMON
CICS system data monitor
New data fields:
■ Status - The status of the collection type.
■ Pct% - The percentage of the CICS CPU time used by the collection event.
■ CPTime - The total task CPU time.
■ EnclTime - The total enclave CPU time.
■ ePct% - The percent of the total CPU time used by the task that executed on an
enclave.
■ zIIPonCP - The total enclave CPU time that ran on a general processor that was
eligible to run on a zIIP processor.
■ zIIPTime - The total enclave CPU time running on a zIIP processor.
■ zPct% - The percent of the total CPU time used by the task that executed on a
zIIP processor.
■ zSwitch - The number of zIIP mode switches.
■ AElapsed - The average elapsed time for the collection process on a single
collection interval.
■ ACPUTime - The average CPU time used by the collection process on a single
collection interval.
CTASKENT
CICS kernel task table entries
New data field:
■ TCBID - Indicates the TCB ID used for trace.
CTASKS
CICS active tasks
New data fields:
■ TASENTRY - The address of the TASENTRY control block.
■ TCBID - The TCB ID used for trace that is associated with the task (TASENTRY).
New line command:
■ TRItune - Schedules an event with TRITune to monitor the selected transaction.
CTEMPSTG
CICS temporary storage summary
New data field:
■ TSMain Lim - The limit for temporary storage main.
CTRANLOG
CICS transaction log summary
Display a progress message every 5 seconds while reading records from a log
stream.
New command syntax:
CTRANLOG < STREAM logstream >
< TIME time | * >
< DATE date | * >
< LINES count >
< LIMIT count >
< PERIOD seconds >
< JOBName jobname >
< TRAN tran >
< UMBRELLA umbrella > <-- new
< UMBTYPE umbtype >
< CLIENT client >
< WEBSERVICE webservice > <-- new
< ABND abendcode > <-- new
< PROGRAM program > <-- new
< LIFETIME oper time > <-- new
< CPUTIME oper time > <-- new
< IOREQS oper count > <-- new
< XCT oper count > <-- new
58 Release Notes
Options
■ LIFETIME - Displays those transactions that match the select criteria for
transaction lifetime.
■ CPUTIME - Displays those transactions that match the select criteria for
transaction CPU time.
■ IOREQS - Displays those transactions that match the select criteria for
transaction I/O requests.
■ XCT - Displays those transactions that match the select criteria for transaction
exceptions.
New subcommands:
■ OPTIONS - Sets and displays available options:
– LIMit nnnnnnnn - Specifies the maximum number of records to read.
CTRAN
CICS transaction summary
New data field:
■ DefGroup - The name of the definition group from where the entry was
installed.
CTRANSUM
CICS transaction intervals
Displays a progress message every 5 seconds while reading records from a log
stream.
New subcommands:
■ OPTIONS - Sets and displays available options:
– LIMit nnnnnnnn - Specifies the maximum number of records to read.
The data collection threshold metrics have been enhanced to include the following new
transaction variable:
ECSEVCCT
Displays synchronous emission EVENTs captured.
DFHGroup: DFHCICS
MCT: 418
The CICSGRPS parmlib member is used to create a list of similar items and then group
them logically.
The configuration options member CICSOPTS has been enhanced to include the
following options:
PERFORMANCE-DATA-MCT
Specifies if CICS MCT EMP fields are included in the detailed transaction record.
Default: Yes
SCHEDULER-MEMBER
Specifies the default member name that contains a list of events to schedule.
SCHEDULER-STARTTYPE
Specifies the start type.
Valid values are:
■ WARM - Warm start
Definitions retrieved from the persistent data store.
■ COLD - Cold start
Definitions read from the parmlib member CICSSCHD.
Default: WARM
THRESHOLD-TASK-DYNAMIC-SMF
Specify to create and log dynamic transaction threshold SMF record.
Default: NO
TRANSACTION-LOG-IF-ABEND
Specifies whether a transaction record is to be ALWAYS logged when an abend
occurs while the transaction was executing.
Default: Yes
60 Release Notes
Options
TRANSACTION-LOG-IF-CICSEXC
Specifies whether a transaction record is to be ALWAYS logged when a CICS
exception event occurs while the transaction was executing.
Default: No
TRANSACTION-LOG-IF-THRESHOLD
Specifies whether a transaction record is to be ALWAYS logged when a SYSVIEW
threshold was triggered for the specific transaction.
Default: Yes
TRANSACTION-STATS-DEGRADATION
Specifies whether to collect transaction degradation analysis information. This
information is displayed online using the CWAITS command.
Default: Yes
TRANSACTION-STATS-HOURLY
Specifies whether hourly transaction summary information is collected. This
information is displayed online using the CREVIEW command.
Default: Yes
TRANSACTION-STATS-LIFETIME
Specifies whether transaction lifetime range information is collected. This
information is displayed online using the CLIFE command.
Default: Yes
TRANSACTION-SUMMARY-STATS
Specifies whether transaction summary information is collected for TSUMxxxx
metrics. This information can be displayed using the online command CSTATUS.
Default: Yes
Requires:
TRANSACTION=SUMMARY - YES
ZIIP-ENABLE
Controls scheduling workload for dispatching on a zIIP processor.
Default: Yes
DEFINE PROGRAM(GSVCMEI)
LANGUAGE(ASSEMBLER)
DATALOCATION(ANY)
EXECKEY(CICS)
CONCURRENCY(THREADSAFE)
GROUP(SYSVIEW)
CA DATACOM Option
The CA SYSVIEW CA DATACOM Option has been enhanced.
62 Release Notes
Options
Commands Added
The CA SYSVIEW CA DATACOM Option has been enhanced to include the following new
commands:
DCSQLMSC
Displays the Datacom MUF SQL miscellaneous statistics.
DCSQLPRC
Displays the MUF SQL procedure detail.
DCSQLSEQ
Displays the Datacom MUF SQL sequence number.
Commands Enhanced
DCTABLES
Datacom directory tables
New data fields
■ Field – Provides the field description.
■ EncrType – Indicates the type of encryption to use.
■ EncrMethod – Indicates the method of encryption to use.
DCXCF
Datacom MUF XCF
New data fields:
■ SysName - Specifies the system name this MUF can accept requests from.
■ JobName - Specifies the job name this MUF can accept requests from.
■ Status - Indicates the status as specified on XCF_FROM option.
Commands Enhanced
64 Release Notes
Options
The IMSLOGR has been enhanced to include the following new modify keywords:
TRNSUMMON
Turns on summary level tracing which summarizes the DC Monitor events.
F sysview,F imslogr,TRNSUMMON
TRNSUMMOFF
Turns off summary tracing.
F sysview,F imslogr,TRNSUMMOFF
TRNDETLON
Turns on detail level tracing which provides detailed DC Monitor event data
F sysview,F imslogr,TRNDETLON
TRNDETLOFF
Turns off detailed tracing.
F sysview,F imslogr,TRNDETLOFF
Commands Added
The Option for IMS has been enhanced to include the following new commands:
IMSCONN
Displays IMS connect connections.
IMSDEDB
Displays IMS DEDB DBRC DB-DBDS query.
IMSDESS
Displays dependent IMS region ESS.
IMSDLIDB
Displays DL/I DBRC DB-DBDS query.
IMSHALDB
Displays HALDB DBRC DB-DBDS query.
Commands Enhanced
CHKPOINT datatype
THRESH datatype nnnnnnnn
RELOAD type <member>
<SYSTEM system>
<GROUP group>
<options>
MSG | NOMSG
IMSLIST
Displays information about IMS control regions.
New information fields:
■ Data collection is - Displays the status of the IMS data collection task.
– ACTIVE - The IMSDATA data collection task is active.
– INACTIVE - The IMSDATA data collection task is inactive.
66 Release Notes
Options
IMSOVER
Displays an overview of the IMS control regions.
New information fields:
■ Data collection is - Displays the status of the IMS data collection task.
– ACTIVE - The IMSDATA data collection task is active.
– INACTIVE - The IMSDATA data collection task is inactive.
IMSREGNS
Displays information about the dependent IMS regions.
New data fields:
■ Ckpts - Specifies the checkpoint count.
■ CkpLTime - Specifies the elapsed time for the last successful checkpoint by the
region.
■ CkpLID - Specifies the checkpoint ID of the last successful Checkpoint by the
region.
■ CkpPTime - Specifies the elapsed time for any pending checkpoint by the
region.
■ CkpPID - Specifies the checkpoint ID of any pending checkpoint by the region.
■ OSAMR - OSAM read count.
■ OSAMW - OSAM Write count.
■ VSAMR - VSAM read count.
■ VSAMW - VSAM write count.
New line commands:
■ TRItune - Schedules an event with TRITune to monitor the selected transaction.
IMSRSLOG
Displays IMS region summary log.
Display a progress message every 5 seconds while reading records from a log
stream
New subcommands:
■ OPTIONS - Set and display available options
– LIMit nnnnnnnn - Specifies the maximum number of records to read.
IMSTLOG
Displays IMS transaction log.
Display a progress message every 5 seconds while reading records from a log
stream
New subcommands:
■ OPTIONS - Set and display available options
– LIMit nnnnnnnn - Specifies the maximum number of records to read.
IMSTRANS
Displays IMS transaction codes.
New data field
■ NonRecvr - The transaction is not recoverable.
IMSTTABL
Displays the IMS Table trace status.
New data fields
BuffAddr - The trace buffer start address.
LastEntr - The address of the last entry added to the buffer
IMSVARS
Displays available IMS monitor variables.
New data fields:
■ Disabled - If this value is DISABLED, data collection for variable has been
disabled.
68 Release Notes
Options
The logger options member IMSLOGR has been enhanced to include the following
options:
SKIP-BMP-DLI-SLOG-RECORDS
Specifies whether the IMSLOGR task skips DLI DC Monitor records written by the
BMP.
Default: YES
TRAN-HISTORY-LOG-MODE
Specifies when the IMSLOGR is to write the IMS transaction records.
Specify a threshold for the IMTRLIFE variable. If no threshold is set for IMTRLIFE,
then records are always written regardless of what is specified here.
■ ALWAYS - Transaction records are written for all transactions.
■ WARNING - Transactions records are written only if the IMTRLIFE threshold
returns a status of WARNING based on the current transactions lifetime.
■ PROBLEM - Transactions records are written only if the IMTRLIFE threshold
returns a status of PROBLEM based on the current transactions lifetime.
TCP/IP Option
The TCP/IP Option for CA SYSVIEW has been enhanced.
Commands Enhanced
CHKPOINT datatype
THRESH datatype nnnnnnnn
RELOAD type <member>
<SYSTEM system>
<GROUP group>
MONITOR datatype (deleted)
INTERVAL datatype nnnnnnnn (deleted)
<options>
MSG | NOMSG
TCPDATA-SYSTEM
TCPLIST
Displays information about TCP/IP images.
New information fields:
■ Data collection is - Displays the status of the TCP data collection task.
– ACTIVE - The TCPDATA data collection task is active.
– INACTIVE - The TCPDATA data collection task is inactive.
TCPVARS
Displays available TCP/IP monitor variables.
New data fields:
■ Disabled - If this value is DISABLED, then data collection for variable is disabled.
The Option for WebSphere MQ has been enhanced to include the following new
commands:
MQDEFINE
Displays the MQ define object.
MQPUBSUB
Displays the MQ publish/subscribe status information.
MQSUBSCR
Displays the MQ subscriptions.
70 Release Notes
Options
MQSBSTAT
Displays the MQ publish/subscribe subscription status.
MQTOPIC
Displays the MQ administrative topic objects status.
MQTUSER
Displays the MQ publish/subscribe topic users.
Commands Enhanced
■ NOXSYStem - Turns off cross system data collection for this execution. The
current profile setting of XSDATA is maintained.
■ GROUP - Specifies that an argument is to follow that specifies the group name
that displays the list of WebSphere MQ queue managers. The list of available
groups with type MQQMGR can be found on the GROUPS command. A group
name of * (asterisk) can be entered to indicate that no group processing is
required.
MQCHCCON
MQ client connection channels
New data fields:
■ ShareCnv - The maximum number of conversations that can be sharing each
channel instance.
Valid values are:
0
No sharing of conversations.
1
No sharing of conversations.
Client heartbeat is available regardless of being current call type. Client
asynchronous consume and read ahead are available. Channel quiesce is
more controllable.
>1
2-999999999 is the number of conversations per instance.
MQCHCRCV
MQ cluster receiver channels.
New data fields:
■ PropCtl - Specifies what happens to message properties when the message is
sent to a V6 queue manager.
Valid values are:
– ALL - All the properties of the message are included with the message
when it is sent. The properties, except for properties in the message
descriptor, are placed in one or more MQRFH2 headers in the message
data.
72 Release Notes
Options
MQCHRQSR
MQ requester channels
New data fields:
■ DefCDisp - Specifies the default channel disposition.
Valid values are:
– FIXSHARED - The intended disposition of the channel is as a FIXSHARED
channel.
– PRIVATE - The intended disposition of the channel is as a PRIVATE channel.
– SHARED - The intended disposition of the channel is as a SHARED channel.
Default: PRIVATE
MQCHSCON
MQ server channels connected
New data fields:
■ DefCDisp - Specifies the default channel disposition.
Valid values are:
– FIXSHARED - The intended disposition of the channel is as a FIXSHARED
channel.
– PRIVATE - The intended disposition of the channel is as a PRIVATE channel.
– SHARED - The intended disposition of the channel is as a SHARED channel.
Default: PRIVATE
■ MaxInst - The maximum number of simultaneous instances of an individual
SVRCONN channel that can be started.
Value: 0 through 999999999.
■ MaxInstC - The maximum number of simultaneous individual SVRCONN
channels that can be started from a single client.
Value: 0 through 999999999.
■ ShareCnv - The maximum number of conversations that can be sharing each
channel instance.
Valid values are:
0
No sharing of conversations. The channel instance runs in a mode before
Version 7.0, with regard to:
Administrator stop-quiesce
Heartbeat
Read ahead
74 Release Notes
Options
MQCHSRVR
MQ server channels
New data fields:
■ DefCDisp - Specifies the default channel disposition. Valid values are:
– FIXSHARED - The intended disposition of the channel is as a FIXSHARED
channel.
– PRIVATE - The intended disposition of the channel is as a PRIVATE channel.
– SHARED - The intended disposition of the channel is as a SHARED channel.
■ PropCtl - Specifies what happens to message properties when the message is
sent to a V6 queue manager. Valid values are:
– ALL - All the properties of the message are included with the message
when it is sent. The properties, except for properties in the message
descriptor, are placed in one or more MQRFH2 headers in the message
data.
– COMPAT - Messages containing a property with a prefix of mcd, jms, usr,
or mqext, have message properties delivered to the queue manager in an
MQRFH2 header. Otherwise, all properties of the message, except
properties in the message descriptor or extension, are discarded.
– NONE - All properties are removed before the message is delivered to the
remote queue manager, except for properties in the message descriptor or
extension.
MQCHSTAT
MQ channel status
New line commands:
■ RSEQ - Invokes the MQCMD RESET command:
MQCMD RESET CHANNEL(channel) SEQNUM(seqno)
MQCMD
MQ command utility
New syntax:
MQCMD < QMGR qmgr > < mqcmdparm >
■ QMGR - Specifies that an argument is to follow that is the name of the queue
manager to sent the WebSphere MQ command. The target queue manager is
not changed.
The current target queue manager is used when this keyword is not supplied.
■ mqcmdparm - Valid WebSphere MQ command and parameters.
76 Release Notes
Options
MQSDATA
Set WebSphere MQ data collection options
New syntax:
MQSDATA < parms > < options >
CHKPOINT datatype
THRESH datatype nnnnnnnn
RELOAD type <member>
<SYSTEM system>
<GROUP group>
<options>
MSG | NOMSG
MQSDATA-BUFPOOLS
MQSDATA-CHANNELS
MQSDATA-DQMGRS
MQSDATA-PAGESETS
MQSDATA-QUEUES
MQSDATA-SYSTEM
MQHANDLE
MQ handles
New data fields:
■ Jobname - The jobname of the connection.
MQLIST
MQ subsystem list
New syntax keywords:
MQLIST < ALL | MONitored >
<XSDATA | NOXSDATA >
< GROUP name >
■ REGion - Display only the current target address space. Turns off cross system
data collection for this execution. The current profile setting of XSDATA is
maintained.
■ SYStem - Display all queue managers currently being monitored on the current
system.
■ XSYStem - Display all queue managers for all systems. Turns on cross system
data collection for this execution. The current profile setting of XSDATA is
maintained.
78 Release Notes
Options
■ NOXSYStem - Turns off cross system data collection for this execution. The
current profile setting of XSDATA is maintained.
■ GROUP - Specifies that an argument is to follow that specifies the group name
that contains the list of WebSphere MQ queue managers. The list of available
groups with type MQQMGR can be found on the GROUPS command. A group
name of "*" can be entered to indicate that no group processing is required.
MQMGR
MQ queue manager
New data fields:
■ GroupUR - Indicates the group unit of recovery.
■ MarkInt - Indicates the time in milliseconds that messages are expected to
remained mark-browsed.
■ MaxPropL - Indicates the maximum number of bytes of property data that can
be associated with a message.
■ Parent - Specifies the name of the parent queue manager in a hierarchy of
queue managers that this queue manager is to connect to as its child.
■ PSMode - Specifies whether the publish/subscribe engine and queued interface
are running.
■ PSNPMsg - Specifies what the publish/subscribe interface is to do when it
cannot process a nonpersistent message and cannot write it to the dead-letter
queue.
■ PSNPRes - Specifies what the publish/subscribe interface is to do when a
response message cannot be delivered to the reply-to queue for responses to
nonpersistent input messages.
■ PSRtyCnt - Specifies the number of times a command is retried after the
publish/subscribe interface fails to process a command message under sync
point. The unit of work is backed out during the retry process. When the retry
count is reached, the command processes according to the report options
instead.
■ PSSyncPt - Specifies the processing of command messages by the
publish/subscribe interface under sync point.
■ ScyCase - Specifies whether security profiles are mixed case or uppercase.
■ TreeLife - Specifies the lifetime in seconds that the queue manager waits
before removing a nonadministrative topic node when it no longer has
subscriptions.
MQPAGE
MQ page sets
The command has been enabled for cross system data collection.
New syntax keywords:
■ REGion - Display only the current target address space. Turns off cross system
data collection for this execution. The current profile setting of XSDATA is
maintained.
■ SYStem - Display all queue managers currently being monitored on the current
system.
■ XSYStem - Display all queue managers for all systems. Turns on cross system
data collection for this execution. The current profile setting of XSDATA is
maintained.
■ NOXSYStem - Turns off cross system data collection for this execution. The
current profile setting of XSDATA is maintained.
■ GROUP - Specifies that an argument is to follow that specifies the group name
that contains the list of WebSphere MQ queue managers to displayed. The list
of available groups with type MQQMGR can be found on the GROUPS
command.
A group name of "*" can be entered to indicate that no group processing is
required.
Deleted data fields:
■ SecX - No longer supported after MQ v6.0.
MQQALIAS
MQ alias queues
New data fields:
■ DefPResp - For applications that specify the MQPMO option
MQPMO_RESPONSE_AS_Q_DEF this attribute controls put response.
■ DefReadA - Specifies the default read ahead processing for nonpersistent
messages being delivered to a client.
■ TargType - The type of the object represented by the TARGET parameter to
which this alias resolves.
■ PropCtl - When messages are retrieved from a queue during MQGET
operations, this parameter controls how message properties are handled.
MQQLOCAL
MQ local queues
New data fields:
■ DefPResp - For applications that specify the MQPMO option
MQPMO_RESPONSE_AS_Q_DEF this attribute controls put response.
■ DefReadA - Specifies the default read ahead processing for nonpersistent
messages being delivered to a client.
80 Release Notes
Options
■ REGion - Display only the current target address space. Turns off cross system
data collection for this execution. The current profile setting of XSDATA is
maintained.
■ SYStem - Display all queue managers currently being monitored on the current
system.
■ GROUP - Specifies that an argument is to follow that specifies the group name
that contains the list of WebSphere MQ queue managers. The list of available
groups with type MQQMGR can be found on the GROUPS command. A group
name of "*" can be entered to indicate that no group processing is required.
■ ALL - Displays queues from all queue managers whether they are monitored or
not.
■ MONitored - Displays queues only from monitored queue managers.
New data fields:
82 Release Notes
Options
■ MsgAge - The length of time in seconds that the oldest message has been on
the queue.
■ Resdate - The date performance events were last reset for the queue.
■ Restime - The time performance events were last reset for the queue.
New subcommands:
■ OPTIONS - Set and display available options.
– NOExtended, EXTEnded - Controls whether to perform extended field data
collection.
MQQREMOT
MQ remote queues
New data fields:
■ DefPResp - For applications that specify the MQPMO option
MQPMO_RESPONSE_AS_Q_DEF this attribute controls put response. Valid
values are:
– SYNC - A put call that specifies MQPMO option
MQPMO_RESPONSE_AS_Q_DEF is issued as if MQPMO_SYNC_RESPONSE
had been specified.
– ASYNC - A put call that specifies MQPMO option
MQPMO_RESPONSE_AS_Q_DEF is issued as if MQPMO_ASYNC_RESPONSE
had been specified.
MQQUSERS
MQ queue users
New data fields:
■ Jobname - The jobname of the connection.
MQRLOG
MQ request history log
Displays a progress message every 5 seconds while reading records from a log
stream.
New subcommands:
■ OPTIONS - Sets and displays available options.
– LIMit nnnnnnnn - Specifies the maximum number of records to read.
MQUSERS
MQ users
New data fields:
■ Jobname - The jobname of the connection.
MQVARS
MQ monitor variables
New data fields:
■ Disabled - If this value is DISABLED, data collection for variable has been
disabled.
The following threshold metrics variables were added to enhance data collection.
MQPUBSUB
Provides the MQ publish subscribe status.
Resource: none
Components
The enhancements to the CA SYSVIEW components are provided in this section.
84 Release Notes
Components
Commands Enhanced
The following objects have been added to the CA SYSVIEW CA Vantage GMI component
interface:
■ CFILEUSE - CICS files in use
■ CJVMPROG - CICS JVM programs
■ CJVMSERV - CICS JVMs
■ CJVMS - CICS JVM servers
■ CSCHEDUL - CICS scheduled events
■ DCSQLMSC - SQL Misc Statistics
■ DCSQLPRC - SQL Procedure Details
■ DCSQLSEQ - SQL Sequence Number
■ IMSCONN - IMS Connect connections
■ IMSDESS - IMS dependent region ESS
■ MQPUBSUB - MQ publish/subscribe status information
■ MQSBSTAT - MQ pub/sub subscription status
■ MQSUBSCR - MQ subscriptions
■ MQTOPIC - MQ administrative topic objects
■ MQTUSER - MQ pub/sub topic users
86 Release Notes
Components
MQQPERF
Displays MQ queue performance information.
New Zooms:
■ Alter Object
MQQUEUE
Displays MQ queues information.
New Zooms:
■ Alter Object
SCHEDULE
Displays information about scheduled events.
New actions:
■ Run - Schedules the event for immediate execution.
Note: The field changes to commands described in previous sections are reflected in
their GMI objects.
The object tree has been enhanced to include the following folders:
CA SYSVIEW\WebSphere MQ\Publish Subscribe
Contains the new publish and subscribe commands for WebSphere MQ.
CA SYSVIEW\CICS\Java Virtual Machines
Contains the new Java Virtual Machine commands for CICS.
CA SYSVIEW\Databases\CA Datacom\MUF SQL Information
Contains the new Datacom MUF SQL information.
Health Checker
CA SYSVIEW provides several health checks to assist in the monitoring and configuration
of the CA SYSVIEW product.
Security
CA SYSVIEW Security has been enhanced.
During installation, the conversion utility GSVXCNVS is run to convert the security data
set from a previous CA SYSVIEW release to the current release 13.0a.
If the security file is converted, command authorization for commands that are
introduced in 13.0a are marked as FAILED. Marking the commands as failed prevents
new commands being introduced into an existing system without the examination of
the security administrator.
New commands have been added to CA SYSVIEW in this release. Additional external
security rules could be required.
REXX Environment
The CA SYSVIEW REXX function has been enhanced:
■ DSINFO - Extracts various types of information about a data set, volume, or GDG
base name into REXX EXEC variables.
88 Release Notes
Components
The display can be simple rows of text data, or can be formatted using extended
attributes.
The user command definition has been extended to allow a HELP member to be
associated with the user command.
DEFINE commandname
MINlen nn
DESCription ' '
HELP member
CMDstring string
ENDDEFINE
LOGOFF
Logoff product
MQCLUSTERTopic
Cluster MQ Topic objects
MQLOCALTopic
Locally defined MQ Topic objects
NEWCHELP
LibCache Reload the HELP library
NEWCPARM
LibCache Reload Parmlib
PROBlem
Select problem lines
STARTSYSVIEW
Start SYSVIEW Main address space
STOPSYSVIEW
Stop SYSVIEW Main address space
STP
Server Time Protocol
SYSVDATA
SYSVIEW Data collect dashboard
SYSVZIIP
SYSVIEW zIIP usage dashboard
UNIQflds
Unique fields
WARNing
Select warning lines
90 Release Notes