ca sysview® performance management - docops.ca.com · ca sysview® performance management - 14.1...

10-Oct-2016Date:

CA SYSVIEW® Performance Management - 14.1Release Notes

CA SYSVIEW® Performance Management - 14.1

10-Oct-2016 3/82

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 is proprietary information of CA and may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without the prior written consent of CA.

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 © 2016 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.

Release Notes 4

Table of Contents

New Features .............................................................................................. 9CA SYSVIEW Videos .................................................................................................................................. 9

Getting Started Videos .......................................................................................................................... 9

Using CA SYSVIEW to Manage CICS Videos .................................................................................... 10

Using CA SYSVIEW to Manage IMS Videos ...................................................................................... 10

CICS Exec Interface Trace ........................................................................................................................ 11

Line Command Assist Menu ..................................................................................................................... 11

Sort Header Line Fields Using Cursor Point-and-Click ............................................................................. 11

Support for New IBM Hardware and Software .......................................................................................... 12

Enhancements to Existing Features .......................................................... 13Installation Enhancements ........................................................................................................................ 13

System Configuration Options Member Location ................................................................................ 13

System Configuration Options ............................................................................................................ 14

Product Maintenance .......................................................................................................................... 15

Installation Conversion Utilities ........................................................................................................... 15

Base Product Enhancements .................................................................................................................... 15

Parmlib Member Removed ................................................................................................................. 16

TCP Data Collection Charges ............................................................................................................. 16

Menu Enhancements .......................................................................................................................... 16

Base Product Commands ................................................................................................................... 16

New Command .......................................................................................................................... 17

Enhancements to Existing Commands ...................................................................................... 17

Profile Set Keyword .................................................................................................................... 19

Field Status Enhancement ......................................................................................................... 19

Base Product Configuration ................................................................................................................ 20

LINECMDS Parmlib Member ..................................................................................................... 20

LGLOOKUP Parmlib Member .................................................................................................... 20

JES Enhancements ................................................................................................................................... 21

Streamlined JES Reassembly Process ............................................................................................... 21

Modules Removed ..................................................................................................................... 22

Parmlib Member Removed ........................................................................................................ 22

JES Commands .................................................................................................................................. 22

New Commands ......................................................................................................................... 22

Renamed Commands ................................................................................................................ 22

Release Notes 5

Enhanced Commands ................................................................................................................ 22

z/OS Enhancements ................................................................................................................................. 24

Support for IBM Software .................................................................................................................... 24

Related Information: ............................................................................................................................ 24

z/OS Commands ................................................................................................................................. 24

New z/OS Commands ................................................................................................................ 24

Enhanced z/OS Commands ....................................................................................................... 25

z/OS Configuration .............................................................................................................................. 31

MVS Data Collection Metric Added ............................................................................................ 32

MVS Data Collection Metrics Removed ..................................................................................... 32

SCHDMVS Parmlib Member Enhancement ............................................................................... 32

CA DATACOM Enhancements ................................................................................................................. 32

Support Dropped ................................................................................................................................. 32

CA DATACOM Command ................................................................................................................... 33

CICS Enhancements ................................................................................................................................. 38


CICS Data Collection Abnormal Termination and Restart .................................................................. 39

CICS Exception Transactions ............................................................................................................. 39

CICS Transaction Options, Cancel, Threshold, and State Definitions ................................................ 40

CICS Commands ................................................................................................................................ 41

Functionality Changes ................................................................................................................ 41

New CICS Commands ............................................................................................................... 41

Enhanced CICS Commands ...................................................................................................... 42

CICS Configuration ............................................................................................................................. 49

New Parmlib Members ............................................................................................................... 49

CICSOPTS Parmlib Member ..................................................................................................... 53

CICSLOGR Parmlib Member ..................................................................................................... 55

Transaction Data Collection Threshold Metrics ......................................................................... 55

Configuration Options Renamed ................................................................................................ 56

Configuration Options Removed ................................................................................................ 57

IMS Enhancements ................................................................................................................................... 59


DC Monitor Record Processing ........................................................................................................... 59

IMS Commands ................................................................................................................................... 60

New Command .......................................................................................................................... 60

Enhanced and Changed Commands ......................................................................................... 60

IMS Configuration ................................................................................................................................ 67

SYSVIEW Parmlib Member ....................................................................................................... 68

SCHDIMS Parmlib Member ....................................................................................................... 68

IMSLOGR Parmlib Member ....................................................................................................... 68

New IMS Transaction Data Collection Metric ............................................................................. 69

WebSphere MQ Enhancements ................................................................................................................ 69

Release Notes 6

WebSphere MQ Commands ............................................................................................................... 69

Command Enhancements .......................................................................................................... 69

WebSphere MQ Configuration ............................................................................................................ 71

Enhanced Parmlib Members ...................................................................................................... 71

CA Roscoe Enhancements ....................................................................................................................... 72

CA Roscoe Commands ....................................................................................................................... 72

Event Capture Enhancements .................................................................................................................. 73

Options Removed ............................................................................................................................... 73

Event Capture Commands .................................................................................................................. 73

TCP/IP Enhancements .............................................................................................................................. 75

TCP/IP Commands ............................................................................................................................. 75

Command Enhancements .......................................................................................................... 75

TCP/IP Configuration .......................................................................................................................... 76

SCHDTCP Parmlib Member Enhancement ............................................................................... 76

TCP Data Collection Charges .................................................................................................... 76

Audit Events Enhancements ..................................................................................................................... 76

Audit Events Commands ..................................................................................................................... 76

Graphical User Interface (GUI) Enhancements ......................................................................................... 78

Objects Enhanced (GMI) ..................................................................................................................... 78

REXX Enhancements ................................................................................................................................ 79

SYSVIEW REXX Functions ................................................................................................................. 79

Security Enhancements ............................................................................................................................ 79

Required Access to New SAF Resource ............................................................................................ 79

Data Collection Enhancements ................................................................................................................. 80

Default Data Collection Changes for New Installations ....................................................................... 80

Configuration Options: Parmlib Member SCHDMVS ................................................................. 80

Configuration Options: Parmlib Member SCHDMQS ................................................................. 81

Configuration Options: Parmlib Member SCHDTCP .................................................................. 81

Configuration Options: Parmlib Member SCHDIMS .................................................................. 81

Removed from Product ............................................................................................................................. 81


10-Oct-2016 7/82

Release NotesThis section details new features and enhancements made to existing features:

New Features (see page 9)CA SYSVIEW Videos (see page 9)CICS Exec Interface Trace (see page 11)Line Command Assist Menu (see page 11)Sort Header Line Fields Using Cursor Point-and-Click (see page 11)Support for New IBM Hardware and Software (see page 12)

Enhancements to Existing Features (see page 13)Installation Enhancements (see page 13)Base Product Enhancements (see page 15)JES Enhancements (see page 21)z/OS Enhancements (see page 24)CA DATACOM Enhancements (see page 32)CICS Enhancements (see page 38)IMS Enhancements (see page 59)WebSphere MQ Enhancements (see page 69)CA Roscoe Enhancements (see page 72)Event Capture Enhancements (see page 73)TCP/IP Enhancements (see page 75)Audit Events Enhancements (see page 76)Graphical User Interface (GUI) Enhancements (see page 78)REXX Enhancements (see page 79)Security Enhancements (see page 79)Data Collection Enhancements (see page 80)Removed from Product (see page 81)

Note: To learn about the new items and changes for the following prior releases, select a hyperlink below:

Changes for CA SYSVIEW Release 14.0 (https://wiki.ca.com/display/CSPM14/CA+SYSVIEW+Performance+Management) (CA SYSVIEW 14.0 wiki)

Changes for CA SYSVIEW Release 13.9 (https://docops.ca.com/display/CSPM10/Changes+for+CA+SYSVIEW+Release+13.9)

Changes for CA SYSVIEW Release 13.7 (https://docops.ca.com/display/CSPM10/Changes+for+CA+SYSVIEW+Release+13.7)

Related information:

https://wiki.ca.com/display/CSPM14/CA+SYSVIEW+Performance+Management

https://wiki.ca.com/display/CSPM14/CA+SYSVIEW+Performance+Management

https://docops.ca.com/display/CSPM10/Changes+for+CA+SYSVIEW+Release+13.9





10-Oct-2016 8/82

Required Software (https://docops.ca.com/display/CSPM10/Required+Software)

Supported Software (https://docops.ca.com/display/CSPM10/Supported+Software)

https://docops.ca.com/display/CSPM10/Required+Software

https://docops.ca.com/display/CSPM10/Supported+Software


10-Oct-2016 9/82

New FeaturesThis section contains information about new features added to the product.

CA SYSVIEW Videos (see page 9)CICS Exec Interface Trace (see page 11)Line Command Assist Menu (see page 11)Sort Header Line Fields Using Cursor Point-and-Click (see page 11)Support for New IBM Hardware and Software (see page 12)

CA SYSVIEW VideosThis section contains links to the following categories of videos:

Getting Started Videos (see page 9)Using CA SYSVIEW to Manage CICS Videos (see page 10)Using CA SYSVIEW to Manage IMS Videos (see page 10)

Note: Use the CA Communities link if your organization prohibits you from accessing our Youtube education channel.

Getting Started VideosCA Communities Link Youtube Link Video Description

Anatomy of a CA SYSVIEW Display (https://communities.ca.com/videos/3533)

Anatomy of CA SYSVIEW Display (http://www.youtube.com/watch?v=Qa1S1kO1AQ0)

For a new CA SYSVIEW user, this video explains the different areas of a CA SYSVIEW display that are consistent across the product to help you become more comfortable using it.

Finding Help (https://communities.ca.com/videos/3526)

Finding Help (https://www.youtube.com/watch?v=DgCauDUBh6s)

This video shows new users how to find help for CA SYSVIEW so that they can become more self-sufficient in their use of the product.

Navigating in CA SYSVIEW (http://communities.ca.com/videos/3712)

Navigating in CA SYSVIEW (https://www.youtube.com/watch?v=4JLftyBrRlk)

This video explains how the CA SYSVIEW menus are organized so that you can become more comfortable navigating the product.

Scrolling in a CA SYSVIEW Display (https://communities.ca.com/videos/3709)

Scrolling in a CA SYSVIEW Display (https://www.youtube.com/watch?v=MFq01RGh9FI)

For a new user, this video explains how to scroll in CA SYSVIEW to help you become more comfortable in your use of the product.

Selecting and Filtering Data on a CA SYSVIEW Display (https://communities.ca.com/videos/3707)

Selecting and Filtering Data on a CA SYSVIEW Display (https://www.youtube.com/watch?v=u38Ow-QNLbU)

This video shows how to use SELECT to filter data on a CA SYSVIEW display so that new users can become more effective in their use of the product.

https://communities.ca.com/videos/3533




http://www.youtube.com/watch?v=Qa1S1kO1AQ0







https://www.youtube.com/watch?v=DgCauDUBh6s



http://communities.ca.com/videos/3712



https://www.youtube.com/watch?v=4JLftyBrRlk







https://www.youtube.com/watch?v=MFq01RGh9FI









https://www.youtube.com/watch?v=u38Ow-QNLbU






10-Oct-2016 10/82

CA Communities Link Youtube Link Video Description

Sorting Data in a CA SYSVIEW Display (http://communities.ca.com/videos/3711)

Sorting Data in a CA SYSVIEW Display (https://www.youtube.com/watch?v=ULv7cvvNHVc)

This video shows how to sort data on a CA SYSVIEW display so that new or occasional users can become effective in their use of the product.

Using the Line Command Assist Feature(https://communities.ca.com/videos/3708)

Using the Line Command Assist Feature (https://www.youtube.com/watch?v=wL9TqdJU2jg)

Introduced in CA SYSVIEW r14.1, this video shows how to use the Line Command Assist command.

Using CA SYSVIEW to Manage CICS VideosCA Communities Link Youtube Link Video Description

Finding CICS Transactions that have Performed Poorly (https://communities.ca.com/videos/3703)

Finding CICS Transactions that have Performed Poorly (https://www.youtube.com/watch?v=lva_Xu1Bnn4)

This video shows how to use the CREVIEW command to find CICS transactions that have performed poorly or that were terminated abnormally.

Finding CICS Transactions that Abended (http://communities.ca.com/videos/3528)

Finding CICS Transactions that have Abended (https://www.youtube.com/watch?v=nps-KCmqCc0)

This video shows how to use the CTRANLOG command to find CICS transactions that have recently terminated or abended abnormally.

Using the CICS Exec Interface Trace Command (https://communities.ca.com/videos/3705)

Using the CICS Exec Interface Trace Command (https://www.youtube.com/watch?v=gk5mIgjZI10)

This video shows how to get more information about a CICS transaction or a set of CICS transactions that make up a larger application or business service.

Viewing CICS Transactions (http://communities.ca.com/videos/3706) (https://www.youtube.com/watch?v=DyYu20h8BmY)

Viewing CICS Transactions (https://www.youtube.com/watch?v=DyYu20h8BmY)

This video shows how to find which CICS transactions have run within a selected time period.

Using CA SYSVIEW to Manage IMS VideosCA Communities Link Youtube Link Video Description

Finding IMS Transactions that have Abended (https://communities.ca.com/videos/3534)

Finding the IMS Transactions that have Abended (https://www.youtube.com/watch?v=H938Asuivhg)

View this video to learn how to find which IMS transactions have recently terminated or abended abnormally .

Finding IMS Transactions that have Performed Poorly (http://communities.ca.com/videos/3535)

Finding IMS Transactions that have Performed Poorly (https://www.youtube.com/watch?v=r2re_eHHLGE)

This video shows how to use the IMSTLOG command to find IMS transactions that have performed poorly or that were terminated abnormally.





https://www.youtube.com/watch?v=ULv7cvvNHVc








https://www.youtube.com/watch?v=wL9TqdJU2jg








https://www.youtube.com/watch?v=lva_Xu1Bnn4








https://www.youtube.com/watch?v=nps-KCmqCc0







https://www.youtube.com/watch?v=gk5mIgjZI10







https://www.youtube.com/watch?v=DyYu20h8BmY









https://www.youtube.com/watch?v=H938Asuivhg








https://www.youtube.com/watch?v=r2re_eHHLGE






10-Oct-2016 11/82

CICS Exec Interface TraceWith CICS Exec Interface Trace (CEITRACE), users can request information that is more granular for future transactions that run. Users request this information by transaction name or group, region name or group, userid, or terminal. CA SYSVIEW finds all matching transactions, and other correlating transactions, across all CICS regions and all systems in the enterprise.

The user can then access a consolidated list of results. The trace results include the EXEC CICS calls an application makes, such as HANDLE ABEND, LINK, and so on. The EXEC CICS calls can display in chronological order. Or, they can display in summary mode to aid in pinpointing potential problem areas or hotspots.

CEITRACE helps users understand the processing that occurs for an application or business service. It can aid in discovering application flow and understanding problems or pain points in context of an application.

Line Command Assist MenuThe line command assist menu has been added to this release. It displays a list of defined line commands for the current command from which it was invoked and provides:

The command and data row information displays the row of data from the command that invoked the line command assist to provide assistance in context.

The available action and navigation line commands for the current display.

A set of special line commands, which are available for all command displays that contain a line command input field.

For more information see, Line Command Assist (https://docops.ca.com/display/CSPM10 and /Line+Command+Assist) How to View Available Line Commands (https://docops.ca.com/display

or use this link to watch a brief video: /CSPM10/How+to+View+Available+Line+Commands) Using the Line .Command Assist Display (https://docops.ca.com/display/CSPM10/Videos)

Sort Header Line Fields Using Cursor Point-and-Click

The header line identifies the fields (columns) in the command display. You can now use your cursor to sort those fields on the header line.

For commands that have a header line above the columns of data, place the cursor on a field name and press the Enter key. The display sorts by that field. Press Enter the second time on the same field name to switch the sort direction.

Default sort order:

Numeric fields are sorted descending initially when you cursor select their headers.

https://docops.ca.com/display/CSPM10/Line+Command+Assist



https://docops.ca.com/display/CSPM10/How+to+View+Available+Line+Commands



https://docops.ca.com/display/CSPM10/Videos

https://docops.ca.com/display/CSPM10/Videos


10-Oct-2016 12/82

Character, Hex, Date, and Time fields are sorted ascending initially when you cursor select their headers.

Note: When the field displays both Numeric and Character data, the sort is determined by the field type.

Support for New IBM Hardware and SoftwareCA SYSVIEW now supports the following IBM hardware and software versions:

IBM z13 hardwareTo improve the performance of z13 machines, sometimes z/OS does not free the real storage (frame) associated with the page it was backing when the page is freemained. CA SYSVIEW monitoring of real storage has been updated to support the changes that are detailed in IBM APAR OA46291.

z/OS 2.2

CICS Transaction Server v5.3

IMS v14.1

IBM MQ 9.0.0; To enable this functionality, apply CA SYSVIEW 14.1 PTF RO90297.Note

For a complete list of all supported software, see Supported Software (https://docops.ca.com/display./CSPM10/Supported+Software)





10-Oct-2016 13/82

Enhancements to Existing FeaturesThis section explains the enhancements that were made to existing product features:

Installation Enhancements (see page 13)Base Product Enhancements (see page 15)JES Enhancements (see page 21)z/OS Enhancements (see page 24)CA DATACOM Enhancements (see page 32)CICS Enhancements (see page 38)IMS Enhancements (see page 59)WebSphere MQ Enhancements (see page 69)CA Roscoe Enhancements (see page 72)Event Capture Enhancements (see page 73)TCP/IP Enhancements (see page 75)Audit Events Enhancements (see page 76)Graphical User Interface (GUI) Enhancements (see page 78)REXX Enhancements (see page 79)Security Enhancements (see page 79)Data Collection Enhancements (see page 80)Removed from Product (see page 81)

Installation EnhancementsSystem Configuration Options Member Location (see page 13)System Configuration Options (see page 14)Product Maintenance (see page 15)Installation Conversion Utilities (see page 15)

The installation process has been enhanced.

System Configuration Options Member LocationBefore CA SYSVIEW® Performance Management 14.1, the system configuration options member was required to be in a data set that was defined to the logical SYS1.PARMLIB concatenation. The SYSVIEW system configuration options member "GSVXGSVX" can now be located in any data set. You are no longer required to be in the logical SYS1.PARMLIB concatenation.

The system configuration options member is read only by CA SYSVIEW® Performance Management server address spaces and utility jobs. The member is not read by individual user sessions.

The server address spaces include:


10-Oct-2016 14/82

SYSVIEW Main Services Address Space - SYSVIEW

SYSVIEW User Interface Address Space - SYSVUSER

SYSVIEW Auxiliary Services Address Space - SYSVAUX

The data set specified on the new DDname GSVXSCFG references the system configuration options member. The DDname GSVXSCFG must be added to all server address space procedures and utility jobs.

Example:

//GSVXSCFG DD DISP=SHR,DSN=sysview.CNM4SCFG

As part of migrating to the use of the GSVXSCFG DDname in the server address spaces, it became necessary to add additional security measures. These measures prevent unauthorized users from overriding configuration options. For more information, refer to Security Enhancements (see page 79.)

Notes:

Secure the data set containing the system configuration options member. Give only those users with SYSVIEW administrative authority update access to the data set or member.

Start a SYSVIEW server address space at least once per IPL before initiating any user session. The server address space reads the system configuration options and initializes the system for all user sessions. If a server address space is not started first, one of the following error messages displays if a user attempts to logon through an interface such as: TSO, ISPF, or batch.

GSVX205E Nucleus load failed, 28 system configuration not found. Start SYSVIEW.

GSVX205E Nucleus load failed, 29 subsystem is not initialized. Start SYSVIEW.

System Configuration OptionsSample system configuration option members are found in the SYSVIEW samplib data set sysview.CNM4BSAM for current and previous releases of CA SYSVIEW® Performance Management. The sample members contain all options and full descriptions for each option.Members:

GSVXGSVX for Release 14.1

GSVXR140 for Version 14.0

GSVXR139 for Release 13.9


10-Oct-2016 15/82



Product MaintenanceThe product installation now generates additional sample JCL members in the SAMPJCL data set to facilitate application of maintenance:

NM41HOLD - FTP download SMP/E ERROR HOLDDATA

NM47RECH - SMP/E Receive HOLDDATA

NM47RECP - SMP/E Receive SYSMODS

NM48APYP - SMP/E Apply PTFS

NM49ACCP - SMP/E Accept PTFS

Download all available PTFs from CA Support Online.

Installation Conversion UtilitiesThree new CICS conversion utilities have been added to the installation process:

CICS Transaction Cancellation Definition Conversion Utility (https://docops.ca.com/pages/viewpage.action?pageId=252020485)

CICS State Exception and Threshold Exception Conversion Utility (https://docops.ca.com/pages/viewpage.action?pageId=252020486)

CICS Transaction Options Definition Conversion Utility (https://docops.ca.com/pages/viewpage.action?pageId=252020487)

In previous versions of CA SYSVIEW, definitions were maintained separately for each monitored CICS region. Starting with this release, a single set of definitions is used for all CICS regions on a system. These utilities convert existing definitions into the new format.

Base Product EnhancementsThe following enhancements to the base product have been made:

Parmlib Member Removed (see page 16)TCP Data Collection Charges (see page 16)Menu Enhancements (see page 16)

https://docops.ca.com/pages/viewpage.action?pageId=252020485







10-Oct-2016 16/82

Parmlib Member RemovedThe following parmlib member is no longer required and has been removed:

FLDHELP - Enhanced field level sensitivity

TCP Data Collection ChargesThe data gathering method for TCP-SYSTEM data collection was changed. Instead of using NETSTAT it uses the TCP Network Management Interface (NMI) to reduce the CPU and elapsed time to collect these metrics.

As a result of these changes, the following TCP-SYSTEM metrics are no longer available:

Variable Description I6RADPRO ICMP IPV6 recv admin prohibitedI6SADPRO ICMP IPV6 sent admin prohibited

Menu EnhancementsDISPGRS Menu Added - The most commonly used GRS commands (such as D GRS, D GRS, or ANALYZE) now appear on the new DISPGRS menu. You access this menu from the ENQ menu.

MENUAPM Added (only applicable for customers of CA C-E APM without CA SYSVIEW) - The most useful CA SYSVIEW commands appear on this new menu.

CA MIM Menu Changes - Menu enhancements include additional MIA commands added to the DISPMIA menu, which includes the new MIM ANALYZE TAPEDELAY command.


Base Product Commands (see page 16)

Base Product Configuration (see page 20)

Base Product CommandsThe CA SYSVIEW base product has added new commands and made enhancements to existing ones:

New Command (see page 17)Enhancements to Existing Commands (see page 17)Profile Set Keyword (see page 19)Field Status Enhancement (see page 19)


10-Oct-2016 17/82

New CommandThe following new command has been added to this release:

LCASSIST - Provides line command assistanceSee and Line Command Assist (https://docops.ca.com/display/CSPM10/Line+Command+Assist) How to View Available Line Commands (https://docops.ca.com/display/CSPM10

or use this link to watch a brief video: /How+to+View+Available+Line+Commands) Using the Line .Command Assist Display (https://www.youtube.com/watch?v=oLZT6Q2buEw)

Enhancements to Existing CommandsThe following enhancements have been made to existing commands:

Command Enhancements

ALERTSUM - Displays a summary of current exception alerts for all CA SYSVIEW components

You can now view alert status by groups.

New syntax parameters

GROUPS | NOGROUPS - Controls whether logical groups display:Logical groups display by default on modes: INSTANCE and RESOURCELogical groups do NOT display on modes: OWNER and OWNERRSCE

For more information, see Summarizing Exception Alerts (https://docops.ca.com./display/CSPM10/Summarizing+Exception+Alerts)

AUDITDEF- Displays the audit definitions

New Audit Event Type:IMS_SPOC_COMMAND - Logs an audit event each time a command is issued to any IMS region through the IMS SPOC interface.

LISTLCMD -Lists all internal and external line commands

New data fields:

Type - The navigation type of the defined command string

Possible values are:ACT - Take an actionNAV - Navigate to another command for more detailUNK - Type not defined

CursorField - Name of field on the specified command where a positioned cursor on enter causes this line command to execute.

Description - Description of the resulting command string.

NoXC - Do not execute cross system. This definition is used only for cross system data lines where XSSYSTEM name is different from the current system name. The command that is generated by the line command definition is typically executed cross system. By specifying the NOXSCONN option, the command is executed locally.






https://www.youtube.com/watch?v=oLZT6Q2buEw

https://www.youtube.com/watch?v=oLZT6Q2buEw

https://docops.ca.com/display/CSPM10/Summarizing+Exception+Alerts




10-Oct-2016 18/82


PLOTLOG - Displays the historical plot log

New Syntax Parameter:

FILTER - Display a Filter screen to allow the entering of command syntax parameters to filter the dataWhen the FILTER keyword is entered as part of the primary command, the parameters that are entered populate the filter display.

After entering desired data on the filter display, the following function keys can be used.

Function KeysENTER - Validate the data entered. No processing occursF1 - Invoke HELP for the filter displayF3 - Validate the data that is entered and process the data to build the displayF12 - Cancel the requested function

The desired state of the FILTER panel is maintained as an option of the primary command.

The subcommand OPTIONS displays the current setting.

OPTIONS subcommand Parameter ValueFILTER, NOFILTER - Specifies that the FILTER display screen displaysThe Filter screen lets you enter command syntax parameters to filter data. The Filter screen displays each time that the command is invoked. The exception is when the NOFILTER parameter is entered as part of the primary command syntax.

Syntax: OPTIONS FILTER

New Filter Display ParametersJobname - Specifies the jobname to displayName - Specified the variable name to displayArgument - Specifies the resource argument to displayAlias - Specifies the alias resource argument to display

New Line CommandPRint Displays the detail screen for a record, prints the detail report to a - sysout data set, and then returns to the display screen.

RXDISP -Executes REXX EXEC and displays the response

RXDISP < > < < >>opts execname args

opts - Any number of the following keyword options:FLUSHBefore, NOFLUSHBefore - Controls whether the REXX stack is flushed before the EXEC is calledEXEC, NOEXEC - Controls whether an EXEC name is required


10-Oct-2016 19/82

Profile Set KeywordSET FORMATNEXT formatname

Specifies the name of a command format that is selected on the next command executed

The FORMATNEXT keyword differs from the FORMAT keyword. The FORMATNEXT value is not saved in the profile and it is used only once and then cleared. FORMATNEXT takes precedence over any FORMAT value that is defined in the profile for the command.

Use the set command in any command string. For instance, you can use it as part of an externally defined user command or menu definition. It causes the command that follows it to use a specific format.

Example

Create an externally defined user command to display the “Top I/O rate address spaces”:

DEFINE TOPIO MINLEN 5 DESC 'Top I/O address spaces' CMD SET FORMATNEXT IO;ACTIVITY

Invoking the TOPIO externally defined user command causes the ACTIVITY command to display using the IO command format. The IO format moves all I/O related fields to the front of the display and sorts the display by IO/Sec descending.

Field Status EnhancementCommand displays throughout the product include fields that have condition status attributes assigned to them based on threshold and state definitions. The status attribute causes the fields to display using the screen field attributes as specified on the SCREEN command. The SCREEN attributes are stored in the profile of each user.

Before r14.1

Several commands forced a NORMAL status to display using the "DATA" attribute causing blocks of "reverse video green" to not display. This behavior caused the associated status of the field to be set to "NONE", which is inconsistent and incorrect.

Starting with r14.1

If the status of a field that is based on a threshold or state results in a NORMAL status, the field displays using the attributes that are associated with "CONDNORMAL".

The following table is from the command: SCREEN

Name Type Intens Color Hilite Description CONDNORMAL OUTPUT LOW GREEN REVERSE Normal condition status field CONDWARNNG OUTPUT LOW YELLOW REVERSE Warning condition status field CONDPROBLM OUTPUT HIGH RED REVERSE Problem condition status field DATA OUTPUT LOW GREEN NONE


10-Oct-2016 20/82

Base Product ConfigurationThe following configuration enhancements have been made in this release:

LINECMDS Parmlib Member (see page 20)LGLOOKUP Parmlib Member (see page 20)

LINECMDS Parmlib MemberUse the line command definitions (LINECMDS) to extend the out-of-the-box CA SYSVIEW experience. The line command definition has been extended to include new optional information:

DESCription - A description that briefly describes the resulting command string. The description can contain up to 40 characters in length and must be enclosed in quotes.

New definition options:

ACTion - The result of the command_string performs an action.

NAVigation - The result of the command_string navigates to another command to provide more or related detail.

NODISplay - Do not display the line command definition on the LISTLCMD commands display.

Example:

ACTIVITY ENQUEUE 1 DESC 'Enqueues for jobname' OPTS NAV CMD ENQUEUE;SELECT RNAME EQ &F_JOBNAMEACTIVITY CANCEL 1 DESC 'Cancel jobname' OPTS ACTION CMD CONFIRM Cancel job: &F_JOBNAME + ;ASCANCEL &F_JOBNAME + NODUMP NOCONFIRM NOMSG

For more information, see .LINECMDS (https://docops.ca.com/display/CSPM10/LINECMDS)

LGLOOKUP Parmlib MemberThe lognames that are defined in the LGLOOKUP parmlib member are used to associate a logname with a log stream name. The data in this member defines the log streams that are associated with data collection functions.

Use the following online commands to view these log streams:

AUDITLOG - Audit events

CEITLOG - CICS EXEC Interface trace log

CSYSDATA - CICS system interval analysis

CTRANLOG - CICS transaction log summary

CTRANSUM - CICS transaction intervals

https://docops.ca.com/display/CSPM10/LINECMDS


10-Oct-2016 21/82

1.

2.

XLOG - CICS exception log

IMSTLOG - IMS transaction log

IMSRSLOG - IMS region summary log

IMSOMAT - IMS OM audit trail log

MQRLOG - MQ request history log

PLOTLOG - Historical plot log

SMFLOG - SMF log

You can specify the log stream names in generic terms or as an alias.

When a command specifies a log stream name:

The specified name is checked against the definitions in this member.

If the name specified matches a "Logname" defined in this member, the log stream that is associated with the definition is substituted for the specified name.

Data Format:

Parm Field Description

1 Sysname

System name - Supports generic names.

2 Logname

Log name - Supports generic names.

3 Logstream

Log stream name - If the log stream name is created using symbols, the resulting value must be 26 characters or less.

For more information, see .LGLOOKUP (https://docops.ca.com/display/CSPM10/LGLOOKUP)

JES EnhancementsThe CA SYSVIEW® Performance Management for JES component has been enhanced:

Streamlined JES Reassembly ProcessThe streamlined JES reassembly process lets you avoid the need to reassemble JES offsets when either CA SYSVIEW® Performance Management or JES changes. The process makes upgrading and enterprise-wide deployments easier and reduces the risk and costs that are associated with the previous process.

https://docops.ca.com/display/CSPM10/LGLOOKUP


10-Oct-2016 22/82

Modules RemovedThe JES configuration and map modules have been removed for JES3 customers.

Parmlib Member RemovedThe JES parmlib member is no longer required for JES3 customers.


JES Commands (see page 22)

JES CommandsThe following JES command additions and changes have been made in this release:

New Commands (see page 22)Renamed Commands (see page 22)Enhanced Commands (see page 22)

New CommandsThe following new commands have been added to this release:

JJOBGRP - Displays JES2 job group informationThis command is available for z/OS 2.2 and higher.

JJOBDEP - Displays JES2 job dependenciesThis command is available for z/OS 2.2 and higher.

Renamed CommandsThe JES NODES command has been renamed to JNODES.

The JNODES command displays the status of JES nodes and has been enhanced to include support for JES3.

Enhanced CommandsThe following command has been changed:

Commands Description


10-Oct-2016 23/82


JJOBQUE - Display information about jobs on the JES job queues

New Fields:JobGroup - Job group nameJobGrpId - Job group IDJobSet - Job set nameGJStatus - Status of job in job groupFlushAct - Flush actionHoldUntilDt - Hold date for the jobHoldUntilTm - Hold time for a jobStartByDt - Start-by date for the jobStartByTm - Start-by time for a jobWith - Run job with another job

New Line Command:JJOBDEP or JDep - Invokes the JJOBDEP command to display job dependencies for the jobAvailable for JES2 2.2 and later releases only

JOBSUM - information about Displays jobs on the JES job queues

New Fields:JobGroup - Job group nameJobGrpId - Job group IDJobSet - Job set nameGJStatus - Status of job in job groupFlushAct - Flush actionHoldUntilDt - Hold date for the jobHoldUntilTm - Hold time for a jobStartByDt - Start-by date for the jobStartByTm - Start-by time for a jobWith - Run job with another job



10-Oct-2016 24/82


LISTINP - New Fields:JobGroup - Job group nameJobGrpId - Job group IDJobSet - Job set nameGJStatus - Status of job in job groupFlushAct - Flush actionHoldUntilDt - Hold date for the jobHoldUntilTm - Hold time for a jobStartByDt - Start-by date for the jobStartByTm - Start-by time for a jobWith - Run job with another job


z/OS EnhancementsThe CA SYSVIEW® Performance Management for z/OS component has been enhanced:

Support for IBM SoftwareCA SYSVIEW now supports z/OS 2.2.


Related Information:z/OS Commands (see page 24)

z/OS Configuration (see page 31)

z/OS CommandsThe following new and enhanced commands have been added to this release:

New z/OS CommandsDUMPINFO - Show information from a dump data set





10-Oct-2016 25/82

FREEGCOM - Free allocated grande common

SRBS - Displays Service Request Blocks (SRBs) for the current target address space

WEBS - Displays all Work Element Blocks (WEBs) currently in the systemEach WEB represents a dispatchable work unit.

Enhanced z/OS Commands


ACTIVITY - Displays the status of jobs executing in the system

Renamed Field Name

The following field name has changed:I/O-Count has been renamed to IOCount

ACTSUM - Job activity summary

New Data Field:

SCMStg - Storage Class Memory (SCM)

ASPERF - Address space performance

New Data Field:

SCMStg - Storage Class Memory (SCM)

COMmon - Common area storage usage

Renamed Field Name:

The following field name on the SUMMARY screen has changed:Key 0 has been renamed to Key0

CONFLICT -

Displays enqueued resources that have conflicting requests

New Parameter:The CONFLICT command now takes advantage of the new CA MIM MIMQUERY functionality by default if available. Utilizing MIMQUERY provides a more comprehensive conflict display in a CA MIM environment where MII is managing Enqueues and Reserves. A new parameter on the CONFLICT command can bypass this functionality when needed. You can specify CONFLICT, CONFLICT MIM, or CONFLICT NOMIM. For more information about MIMQUERY, see the CA MIM wiki (https://wiki.ca.com/display/CMFZS10/MIMQUERY). (https://wiki.ca.com/display/CMFZS10)

DSCAT - Cataloged data sets

New line command:DInfo - Invokes the DUMPINFO command to display information from the selected dump data set.

New data fields:The DSCAT command now displays the "true" or associated data set name and volser for those data sets defined as ALIAS:

DatasetTrue - The true data set name when the "Type" is ALIASVolTrue - The volser for the true data set name when the "Type" is ALIAS

https://wiki.ca.com/display/CMFZS10/MIMQUERY



https://wiki.ca.com/display/CMFZS10


10-Oct-2016 26/82


DSINFO - Displays information about all currently available data sets

This command now supports the Extended GDG format when running under z/OS 2.2 or higher. When issued against a GDG base, the command behaves as it has in prior releases. If accessing an extended GDG base, the command now displays limits and data set generations up to 999.

DUMPDS - Dump data sets

New Line Commands:

DInfo - Invokes the DUMPINFO command to display information from the selected dump data set

GCOMMON - Common storage above 2G

New Line Commands:

FREE - Invokes the FREEGCOM command to free the selected storage object

HCLOG - Health checker log

New syntax parameter:

FILTER - Display a Filter screen to allow the entering of command syntax parameters to filter the data. When the FILTER keyword is entered as part of the primary command, the parameters that are entered populate the filter display.


Function KeysENTER - Validate the data entered. No processing occurs.F1 - Invoke HELP for the filter display.F3 - Validate the data entered and process the data to build the display.F12 - Cancel the requested function.

The desired state of the FILTER panel is maintained as an option of the primary command.The subcommand OPTIONS displays the current setting.

OPTIONS subcommand Parameter ValueFILTER, NOFILTER - Specifies that the FILTER display screen is to displayThe Filter screen lets you enter command syntax parameters to filter data. The Filter screen displays each time the command is invoked unless the NOFILTER parameter is entered as part of the primary command syntax.


New Filter Display ParametersSysPlex - Specifies the sysplex to displaySystem - Specifies the system to displayOwner - Specifies the owner to displayName - Specifies the name to displayStatus - Specifies the status to display


10-Oct-2016 27/82


LGBROWSE - Browses the log streams


FILTER - Display a Filter screen to allow the entering of command syntax parameters to filter the data. When the FILTER keyword is entered as part of the primary command, the parameters entered are used to populate the filter display.





OPTIONS subcommand Parameter ValueFILTER, NOFILTER - Specifies that the FILTER display screen is to be displayed. The Filter screen lets you enter command syntax parameters to filter data. The Filter screen displays each time the command is invoked unless the NOFILTER parameter is entered as part of the primary command syntax.


New Filter Display Parameters

ASIS - Specifies to display the records ASIS. If the records were written using compression, a decompress is not performed.

LGSTREAM - Displays log stream definitions

New Data Field:

A new field name, AlcAhd, has been added to the LGSTREAM command to display the LG_ALLOCAHEAD value that was added to the Log Stream definition. This field specifies the number of offload data sets that are allocated and opened in advance on systems connected to the log stream. The AlcAhd field is valid only at z/OS 2.2.0 or higher.


10-Oct-2016 28/82


OPERLOG - Displays the historical plot log


FILTER - Display a Filter screen to allow the entering of command syntax parameters to filter the data. When the FILTER keyword is entered as part of the primary command, the parameters entered will be used to populate the filter display.

After entering desired data on the filter display, use the following function keys:

Function KeysENTER - Validate the data entered, no processing occursF1 - Invoke HELP for the filter displayF3 - Validate the data entered and process the data to build the displayF12 - Cancel the requested function



OPTIONS subcommand Parameter ValueFILTER, NOFILTER - Specifies that the FILTER display screen is to display. The Filter screen lets you enter command syntax parameters to filter data. The Filter screen displays each time the command is invoked unless the NOFILTER parameter is entered as part of the primary command syntax.


New Filter Display ParametersSysplex - Specifies the sysplex nameSystem - The name of the system that issued the messageOrigin - The origin of the messageJobname - The jobname that issued the messageJobID - The job ID that issued the message

PLEXCPL - Displays information about sysplex couple data sets

Renamed Field Name


STATES - Displays the current MVS state monitor definitions

Changed SubcommandRELOAD COLD - Deletes all existing definitions prior to reloading from the parmlibThis behavior is consistent across all THRESH and STATES commands.


10-Oct-2016 29/82


TASKMon -Displays task monitor

New Data Fields:WorkUnit - Address of work unit for TCB or sSRBType - Work Element type. Possible values are:

CMLP - CML promotionCMSP - CMS promotionCSRB - Client SRBESRB - Enclave SRBETCB - Enclave TCBEXIT - Async exitFSRB - SRB scheduled with FULLXMMSRB - Managed SRBPSRB - Preemptable SRBRSRB - Previously executing SRB, suspended by SUSPEND with token or by PAUSE or TRANSFERSRB - SRBSSRB - Suspended SRBTCB - TCBWEB - Address of WEB control block

THRESH - Displays the current MVS threshold definitions

Changed SubcommandRELOAD COLD - Deletes all existing definitions prior to reloading from the parmlibThis behavior is consistent across all THRESH and STATES commands.

WMACT - Displays the workload activity resource data that has been collected by the Workload Manager

Renamed Field Names

The following field names have changed:I/O-Count has been renamed to IOCountI/OTime has been renamed to IOTimeI/Ounits has been renamed to IOunits

WMADELAY - Displays, by address space, the workload activity delay data that has been collected by the Workload Manager

Renamed Field Names

The following field names have changed:I/Odly has been renamed to IOdlyI/Ouse has been renamed to IOuse


10-Oct-2016 30/82


WMDELAY - Displays, by service class, the workload activity delay data that has been collected by the Workload Manager

Renamed Field Names

The following field names have changed:I/Odly has been renamed to IOdlyI/Ouse has been renamed to IOuse

XLOG - Exception log

CICS transaction detail records containing exceptions are also written to the exception log and are displayed by the XLOG command.


FILTER - Display a Filter screen to allow the entering of command syntax parameters to filter the dataWhen the FILTER keyword is entered as part of the primary command, the parameters that are entered populate the filter display.


Function KeysENTER - Validate the data entered. No processing occursF1 - Invoke HELP for the filter displayF3 - Validate the data entered and process the data to build the displayF12 - Cancel the requested function



OPTIONS subcommand Parameter ValueFILTER, NOFILTER - Specifies that the FILTER display screen is to be displayedThe Filter screen lets you enter command syntax parameters to filter data. The Filter screen displays each time the command is invoked unless the NOFILTER parameter is entered as part of the primary command syntax.


New Filter Display ParametersSource - Specify how the source log stream is to be determined.

AUTO - When the log stream name is not explicitly specified, the name of the log stream is determined automatically. If the current target address space is a monitored CICS region, the log stream name is set based on the associated CICS logger. If not a CICS, the log stream name is set based on a match from the LGLOOKUP parmlib member


10-Oct-2016 31/82


DEFAULT - When the log stream name is not explicitly specified, the name of the log stream is set based on a match from the LGLOOKUP parmlib member.

CICS - When the log stream name is not explicitly specified, the name of the log stream is set based on a match from the LGLOOKUP parmlib member selecting a CICS exception log stream CICSLOGR.XLOG.

Owner - Specifies the owner to display

Valid values are:CICSIMSMVSTCPWEBMQ

Jobname - Specifies the jobname that is to displayName - Threshold and state exception records, specifies the exception metric name to display

CICS transaction detail records. Constant value: CICSTRAN.CICS exception class data. Specifies the exception resource type.

Rsce1 - Specifies the resource value to displayRsce2 - Specifies the resource value to displayRuleType - Specifies the rule type to display

Valid values are:UPPER - Upper limit thresholdLOWER - Lower limit thresholdCHANGE - Standard deviation changeSTATE - State exceptionCICSABND - CICS transaction abendCICSEXC - CICS exception

SummGrp - Limit the display to only those entries with a corresponding value in the SummGrp field

New Line CommandPRint Displays the detail screen for a record, prints the detail report to a - sysout data set and then returns to the display screen.

z/OS ConfigurationThe following configuration enhancements have been for this release:

MVS Data Collection Metric Added (see page 32)MVS Data Collection Metrics Removed (see page 32)SCHDMVS Parmlib Member Enhancement (see page 32)


10-Oct-2016 32/82

MVS Data Collection Metric AddedJOBSCM - This new data collection metric monitors Storage Class Memory (SCM) by address space.

MVS Data Collection Metrics RemovedThe following metrics have been removed from the MVS Data Collection:

GSPGFR - 6-PVT shared memory pages fixed realReason: The data source was never populated by IBM and was removed.

GS1MPGFR - 6-PVT shared memory 1M pages fixed realReason: The data source was never populated by IBM and was removed.

GS1MPGR - 6-PVT shared memory 1M pages realReason: The data source was never populated by IBM and was removed.

SCHDMVS Parmlib Member EnhancementThe following configuration options have changed in the parameter library member SCHDMVS:

Event Old Enabled Old Interval New Enabled New Interval

MVS-CHANNELS Yes 1Min No 2Min

MVS-CPU Yes 30Sec Yes 1Min

MVS-CPUSTATUS Yes 1Min No 1Min

MVS-DEVICES Yes 5Min No 15Min

MVS-JES-NODES Yes 1Min No 5Min

MVS-REQ-JOBS Yes 1Min No 1Min

MVS-USS Yes 1Min No 2Min

MVS-VTAM-APPLIDS Yes 1Min No 2Min

CA DATACOM EnhancementsThe CA SYSVIEW® Performance Management CA DATACOM Option has been enhanced. See the following topics for more information:

CA DATACOM Commands (see page 33)

Support DroppedSupport for CA Datacom CSF 11.0 has been dropped in this release.


10-Oct-2016 33/82

CA DATACOM CommandThe following commands have been enhanced:


DCACNT - Displays the accounting facility Renamed Field Name


DCBUFP -CA Datacom MUF buffer usage statistics

New Data Fields:Jobname - Job name of the Multi-User Facility (MUF)Use-1% - Percentage of times a buffer in this pool was referenced for the first time, after the buffer was read from DASD or copied from MRDFUse-2% - Percentage of times a buffer in this pool was referenced for a second time, after the buffer was read from DASD or copied from MRDFUse-3% - Percentage of times a buffer in this pool was referenced for a third time, after the buffer was read from DASD or copied from MRDFUse-4% - Percentage of times a buffer in this pool was referenced for a fourth time, after the buffer was read from DASD or copied from MRDFUse-5+% - Percentage of times a buffer in this pool was referenced for a fifth time (sixth time, seventh time, and so on), after the buffer was read from DASD or copied from MRDF

: New Command FormatsThe DEFAULT profile has two new formats:

COUNT - Removes the Percentage fieldsPERCENT - Removes the Count fields

DCCBS - CA Datacom MUF CBS info and stats

New Data Field:

Jobname - Job name of the Multi-User Facility (MUF)

New Syntax Keywords:

< REGion | SYStem >< XSYStem | NOXSYStem >< XSData | NOXSData >< GROUP >name

REGion - Display only the current target address space. If thecommand supports cross-system data collection, this parameterforces cross system data collection to be off for thisexecution. However, the current profile setting of XSDATA ismaintained.


10-Oct-2016 34/82


SYStem - Display data for all Datacom address spaces on thecurrent systemXSYStem, XSData - Display all Datacom address spaces for allsystems, which force cross-system data collection to be seton for this execution. The current profile setting of XSDATAis maintained.NOXSYStem, NOXSData - Forces cross-system data collection tobe set off for this execution. The current profile setting ofXSDATA is maintained.GROUP - Specifies that an argument is to follow that specifiesthe group name that contains the list of Datacom jobnames todisplay. The list of available groups with type JOBNAME arefound on the GROUPS command. Enter a group name of "*" toindicate that no group processing is required.

DCCONFIG - Displays most Multi-User startup options and console API commands that are not represented in another Dynamic System Table.

Renamed Data Field:Config Command was renamed to ConfigCommand

DCOPEN -CA Datacom MUF Open Databases

New Data Field:




REGion - Display only the current target address space. If thecommand supports cross-system data collection, this parameterforces cross system data collection to be off for this execution.However, the current profile setting of XSDATA is maintained.SYStem - Display data for all Datacom address spaces on thecurrent system XSYStem, XSData - Display all


10-Oct-2016 35/82


Datacom addressspaces for all systems, which force cross-system datacollection to be set on for this execution. The currentprofile setting of XSDATA is maintained.NOXSYStem, NOXSData - Forces cross-system data collection tobe set off for this execution. The current profile setting ofXSDATA is maintained.GROUP - Specifies that an argument is to follow that specifiesthe group name that contains the list of Datacom jobnames todisplay. The list of available groups with type JOBNAME arefound on the GROUPS command. Enter a group name of "*" toindicate that no group processing is required.

DCOPTION -CA Datacom MUF Options

New Data Field:




REGion - Display only the current target address space. If thecommand supports cross-system data collection, this parameterforces cross system data collection to be off for thisexecution. However, the current profile setting of XSDATA ismaintained.SYStem - Display data for all Datacom address spaces on thecurrent systemXSYStem, XSData - Display all Datacom address spaces for allsystems, which force cross-system data collection to be seton for this execution. The current profile setting of XSDATAis maintained.NOXSYStem, NOXSData - Forces cross-system data collection tobe set off for this execution. The current profile setting ofXSDATA is maintained.


10-Oct-2016 36/82


GROUP - Specifies that an argument is to follow that specifiesthe group name that contains the list of Datacom jobnames todisplay. The list of available groups with type JOBNAME arefound on the GROUPS command. Enter a group name of "*" toindicate that no group processing is required.

DCTASKS -CA Datacom MUF Active Tasks

New Data Field:




REGion - Display only the current target address space. If thecommand supports cross-system data collection, this parameterforces cross system data collection to be off for thisexecution. However, the current profile setting of XSDATA ismaintained.SYStem - Display data for all Datacom address spaces on thecurrent systemXSYStem, XSData - Display all Datacom address spaces for allsystems, which force cross-system data collection to be seton for this execution. The current profile setting of XSDATAis maintained.NOXSYStem, NOXSData - Forces cross-system data collection tobe set off for this execution. The current profile setting ofXSDATA is maintained.GROUP - Specifies that an argument is to follow that specifiesthe group name that contains the list of Datacom jobnames todisplay. The list of available groups with type JOBNAME arefound on the GROUPS command. Enter a group name of "*" toindicate that no group processing is required.


10-Oct-2016 37/82


DCTCBSRB -CA Datacom MUF EOJ TCB/SRB use statistics

New Data Field:





DCZIIP -CA Datacom MUF SMPTASK SRB Statistics

New Data Field:





10-Oct-2016 38/82



CICS EnhancementsThe CA SYSVIEW Option for CICS has been enhanced with the following updates:

Support for IBM Software (see page 38)CICS Data Collection Abnormal Termination and Restart (see page 39)CICS Exception Transactions (see page 39)CICS Transaction Options, Cancel, Threshold, and State Definitions (see page 40)

Support for IBM SoftwareCA SYSVIEW now supports CICS Transaction Server 5.3.


10-Oct-2016 39/82


CICS Data Collection Abnormal Termination and RestartThe SYSVIEW CICS data collector that executes within a CICS address space is a collection of CICS transactions and MVS subtasks. If a CICS data collection task abnormally terminates, the data collector shuts down or terminates for that specific CICS address space.

During the termination process, CA SYSVIEW determines if the data collector is eligible for automatic restart. If restart eligible, the data collector restarts automatically.

The following parameters are maintained from the previous initialization:

Start type: WARM, COLD

SYSVIEW subsystem ID (SSID)

Userid

If the CICS data collector is executing as part of a previous restart request, a second restart is rejected until a CA SYSVIEW for CICS System Data Interval record has been created. The SYSDATA-RECORD scheduler event controls the System Data Interval record creation.

If a system record is processed or created using the scheduler event:

The ability to restart on an unscheduled termination is enabled.

This message is written to the log: GSVC033I (SDCS) Restart on recovery has been reset and enabled.

CICS Exception TransactionsThe CA SYSVIEW for CICS data collector can monitor many CICS resources. Depending on your configuration of the CA SYSVIEW for CICS detail log streams, finding CICS detail records in the log streams can be difficult. Now you can find CICS exception transactions more easily. CA SYSVIEW duplexes a small subset of CICS detail records and sends them to another log stream (the exception log stream) in addition to the primary log stream.

Typically the number of records that are written to the CICS exception log stream is less than that of the transaction log stream. This allows the exception records to be maintained for a longer retention period. Also, the transaction exception records and any other exception records that are associated with the CICS region or transaction are logged to the same log stream.

The ability to review or query exception conditions using the CTRANLOG or XLOG commands is now much faster.

For more information, see CA SYSVIEW for CICS Data Collection Simplified (https://docops.ca.com/display./CSPM10/CA+SYSVIEW+for+CICS+Data+Collection+Simplified)




https://docops.ca.com/display/CSPM10/CA+SYSVIEW+for+CICS+Data+Collection+Simplified




10-Oct-2016 40/82

CICS Transaction Options, Cancel, Threshold, and State Definitions

In response to customer feedback, one of the main themes in this release is the simplification of CA SYSVIEW. Many of the items in this release are targeted at making CA SYSVIEW:

Easier to configure

Easier to maintain

Easier to understand

Easier to administer

Easier to navigate

Easier to operate and use

The consolidation of CA SYSVIEW CICS definitions supports these themes and has been designed to simplify the CICS system programmer tasks.

In previous releases, these CICS definitions were maintained separately for each monitored CICS region. The definitions were read from the SYSVIEW parmlib member or from the SYSVIEW Persistent Data Store (DATALIB). Definitions for each monitored CICS region were stored in the persistent data store as a unique element. The number of stored elements in DATALIB could be large depending on the number of monitored CICS regions. The number of stored elements presented some maintenance challenges, particularly for customers with many CICS regions. For this reason, many customers opted to manage these definitions in parmlib members and start the CICS data collector in COLD mode. Although they could have used WARM for the definitions for the rest of CA SYSVIEW.

Starting with this release, several new parmlib members contain a common set of definitions that are used for all monitored CICS regions on a system. The following table shows the old parmlib member names from prior releases where you could have specified an ')IF JOBNAME=cicsjobn' statement to have separate definitions for each CICS region, along with the new parmlib member names that contain the common definitions with a new JOBNAME parameter:

Old New

CICSCNCL CTRANCAN

CICSTHRS CSTATES and CTHRESH

CICSTOPT CTRANOPT

This consolidated set of definitions provides the following benefits:

Reduce the number of definitions you must create and maintain, which saves you time and increases reliability.

Reduce the need to modify CA SYSVIEW definitions as you add or remove CICS regions, transactions, and applications.

Simplify the process of making global definition changes across all the CICS regions in your


10-Oct-2016 41/82

Simplify the process of making global definition changes across all the CICS regions in your enterprise.

Simplify operations because starting CICS in WARM mode is now more compelling.

Specify the new CICS jobname parameter in the definitions as:

Specific CICS jobname

Generic CICS jobname using wildcard characters

CA SYSVIEW logical group name containing a list of CICS jobnames

You can maintain these definitions in CA SYSVIEW parmlib members or in the SYSVIEW Persistent Data Store (DATALIB). If you primarily maintain these definitions in CA SYSVIEW parmlib members, consider starting the CICS data collector in COLD mode. If you primarily maintain these definitions in DATALIB, consider starting the CICS data collector in WARM mode.

In general, maintaining definitions in DATALIB is preferred. The CA SYSVIEW persistent data store is a mechanism that allows data to be saved and retrieved. The goal of a persistent data store is to provide an environment that allows data objects to be maintained across multiple executions of CA SYSVIEW. The persistent data store maintains definitions that have been modified or added dynamically. Also, definitions in the persistent data store are migrated automatically to future product releases.

To help with consolidating your existing CICS definitions, CA SYSVIEW r14.1 provides conversion utilities in the installation procedures.


CICS Commands (see page 41)

CICS Configuration (see page 49)

CICS CommandsThe CA SYSVIEW CICS option has been updated with the following new or enhanced commands:

Functionality Changes (see page 41)New CICS Commands (see page 41)Enhanced CICS Commands (see page 42)

Functionality ChangesThe command CICSSET no longer supports the ability to checkpoint, export, and save the transaction option definitions. This functionality has been added to the CTRANOPT command. For more information, see .CTRANOPT (https://wiki.ca.com/display/CSPM/.CTRANOPT+v14.1)

New CICS CommandsThe following new commands have been added for this release:

https://wiki.ca.com/display/CSPM/.CTRANOPT+v14.1


10-Oct-2016 42/82

Command Description

CDB2TRAN

Displays defined CICS DB2 transaction definitions.

CEITRACE The CEITRACE (CICS EXEC Interface Request Tracing) command allows a user to display and modify definitions that control the monitoring or tracing of CICS EXEC Interface requests.

CICS EXEC Interface trace definitions are used to define the criteria used to determine if the monitoring performed for a CICS transaction should include the recording of EXEC Interface requests.

CA SYSVIEW creates an SMF record for each CICS transaction that is monitored. CICS EXEC Interface requests can be monitored or traced. If monitored, those traced requests are included in the CICS detail transaction record.

Use the CEITRACE command to display and modify definitions that control the monitoring or tracing of CICS EXEC Interface requests. You can create multiple definitions that control which transactions to monitor for CICS EXEC Interface requests. The definitions can be enabled or disabled as needed.

With this new command, comes a new parmlib member CEITRACE. For more information, see the CICS Members (https://docops.ca.com/display/CSPM10/CICS+Members) section. In

CICS_EI_TRACE_MODIFY addition, a new audit event, is added. For more information, see the Audit Event (https://docops.ca.com/display/CSPM10/Audit+Events) section.

CEITLOG The CEITLOG (CICS EXEC Interface trace log) command displays CICS transaction records that have been monitored or traced based on a CICS EXEC Interface trace definition.

Enhanced CICS CommandsThe following enhancements have been made to existing commands:


CICSSET -Alter CICS resources

Syntax:Set the state of CA SYSVIEW for CICS Data Collection.

CICSSET MONITOR action

action - Specify an action to take. Valid values are TERMINATE and RESTART.

Syntax:Issue generic CEDA request:

CICSSET CEDA parameters

Syntax:Issue generic CEMT request:

CICSSET CEMT parameters

Renamed Field Name

https://docops.ca.com/display/CSPM10/CICS+Members

https://docops.ca.com/display/CSPM10/Audit+Events


10-Oct-2016 43/82


CREVIEW -CICS transaction interval activity

The following field name has changed:I/OReqs has been renamed to IOReqs.

New Data Fields:

Abends - The total number of abends.

New Line Commands:

SYSD - Display system data collection interval records for the specified period. The CSYSDATA command is invoked.

TLOG - Display transaction detail records for the specified period. The CTRANLOG command is invoked.

TSUM - Display transaction summary records for the specified period. The CTRANSUM command is invoked.

TXlog - Display transaction detail records for the specified period. The CTRANLOG command is invoked specifying the CICS exception log as the log stream.

XLOG - Display exception records for the specified period. The XLOG command is invoked.

CSYSDATACICS system interval analysis

New data fields:








OPTIONS subcommand Parameter Value

FILTER, NOFILTER - Specifies that the FILTER display screen is to display. The Filter screen lets you enter command syntax parameters to filter data. The Filter screen displays each time the command is invoked unless the NOFILTER parameter is entered as part of the primary command syntax.


10-Oct-2016 44/82




Jobname - Display only those audit events that were created by the specified jobname.

New Line Command

PRint - Displays the detail screen for a record, prints the detail report to a sysout data set, and then returns to the display screen.

CTRANLOGCICS transaction log summary

New data fields:EICnt - The number of EXEC Interface requests.EITrace - The name of the EXEC Interface trace definition that requested EXEC CICS interface requests to be recorded.ONetwork - Origin network IDOApplid - Origin applidOTran - Origin transaction IDOTask# - Origin task numberOFac - Origin facility name

New detailed record data fields:

Program section of detail report updated to include the program environment type.

Type - Program environment type. Possible values are:* - Non-CICS programSYSTEM - CICS system programEXEC - Command level applicationURM - User-replaceable programTRUE - Task-related user exitPLT - Program list table program

New Filter Panel

Invoke the FILTER panel using the following two methods:Include the FILTER keyword on the primary command syntax.Enter the subcommand FILTER.


FILTER - Displays a Filter panel to enter command syntax parameters to filter the data. When the FILTER keyword is entered as part of the primary command, the parameters entered are used to populate the filter display.


Function Keys


10-Oct-2016 45/82


ENTER - Validate the data entered. No processing occurs.F1 - Invoke HELP for the filter display.F3 - Validate the data entered and process the data to build the display.F12 - Cancel the requested function.



OPTIONS subcommand Parameter ValueFILTER, NOFILTER - Specifies that the FILTER screen displays. The Filter screen lets you enter command syntax parameters to filter data. The Filter screen displays each time the command is invoked unless the NOFILTER parameter is entered as part of the primary command syntax.


New Filter Display ParametersLog Stream - Specify the log stream name you want to display data from.Start Date - Positions to the specified log date. Records are read from the starting point in a forward direction. If a date value has not been specified, the required date format is shown in the input field. If the date is not modified, an asterisk (*) is assumed.

date - Specify the date value using the date format of the user specified in the profile for the current command.

* - Use the current date.

days - Position to the current date minus the specified number of days.Start Time - Position to the specified log time. If a time value has not been specified, the required time format of the user is shown in the input field. If the time is not modified, an asterisk (*) value is assumed.

time - Specify the time value using the time format of the user as specified in the profile for the current command.

* - Use the current time.

nnAM, nnPM - Specify the time value using one of the following values:

12AM | 1AM | 2AM | ... | 11AM12PM | 1PM | 2PM | ... | 11PMNOON | MIDNIGHT

-adjust, +adjust - Set the time value to the current time plus or minus the specified adjustment value. For example:


10-Oct-2016 46/82


- 0.500000 - 0.5 seconds-60 - 60 seconds-120Sec - 120 seconds-5MINutes - 5 minutes-1Hours - 1 hour-1Days - 1 day-hh:mm:ss - hours:minutes:seconds

+ 0.500000 + 0.5 seconds+ 60 + 60 seconds+ 120Sec + 120 seconds+ 5MINutes + 5 minutes+ 1Hours + 1 hour+ 1Days + 1 day+ hh:mm:ss + hours:minutes:seconds

Period - Specifies the time period to display the records for.

Default is 0 - unlimited.

Example values:

NONE - No period (unlimited)0 - No period (unlimited)0.500000 - 0.5 seconds60 - 60 seconds120Sec - 120 seconds5MINutes - 5 minutes1Hours - 1 hour1Days - 1 dayhh:mm:ss - hours:minutes:seconds

Cushion - Specifies the time period cushion for which records are to be read for display.

Data records stored in an MVS log stream are sequenced or sorted based on the actual time the record was written to the stream. This does not ensure that the records are sorted in a time sequence based on the data and time information that is potentially contained within each record. For this reason, when a user wants to display a specific time period of data, additional records must be read on the front and back end of the read process to ensure that the records that might be out of sequence are included.

Example values:

NONE - No cushing0 - No cushion10 - 10 seconds5MINutes - 5 minutes1Hours - 1 hourhh:mm:ss - hours:minutes:seconds


10-Oct-2016 47/82


Lines - Specifies the maximum number of data rows to display. Specifying the LINES value with the primary command syntax does not alter or change the default value stored in the user profile.

Default: 25000

Minimum: 1Maximum: 1000000

Limit - Specifies the maximum number of records to read. Specifying the LIMIT value with the primary command syntax does not alter or change the default value stored in the user profile.

Default: 0 (unlimited)Elapsed - Specifies the elapsed time limit for reading or searching the log streams for data.

Example values:

NONE - No cushion0 - No cushion10 - 10 seconds5MINutes - 5 minutes1Hours - 1 hourhh:mm:ss - hours:minutes:seconds

RecTime - Specifies whether the start or end date and time is used for the records. Not all records have a start time and an end time. Records that do not have both are considered events. Interval-based records do have a start and end time. Event-based records typically do not have a start and end time.

Valid Values:END (default)STARTEVENT

Jobname - Specifies the jobname to displayTran - Specifies the transaction to displayProgram - Specifies the program name to displayTerminal - Specifies the terminal to displayUserid - Specifies the userid to displayUmbrella - Specifies the umbrella name to displayUmbType - Specifies the umbrella type to displayDefGroup - Specifies the resource definition group to displayAbendCode - Specifies the abend code to displayClient - Specifies the client type to displayWebService - Specifies the web service name to display

Metrics, Operators, and ValuesLIFETIME - Display those transactions that match the select criteria for transaction lifetime. Specify the value as time (in seconds).


10-Oct-2016 48/82


CPUTIME - Display those transactions that match the select criteria for transaction CPU time. Specify the value as time (in seconds).IOREQS - Display those transactions that match the select criteria for transaction I/O requests. Specify the value as a counter.XCT - Display those transactions that match the select criteria for transaction exceptions. Specify the value as a counter.Oper - Selection operator. Value values are:

EQ, =LT, <LE, <=GT, >GE, >=NE, ^=, <>NG, ^>NL, ^<

Value - The value to be compared.

New Line CommandPRint Displays the detail screen for a record, prints the detail report to a sysout data - set, and then returns to the display screen.

CTRANS -CICS transaction summary

New Data Fields:


CTRANSUM -

CICS transaction interval summary

New Data Fields:










10-Oct-2016 49/82


FILTER, NOFILTER - Specifies that the FILTER screen displays. The Filter screen lets you enter command syntax parameters to filter data. The Filter screen displays each time the command is invoked unless the NOFILTER parameter is entered as part of the primary command syntax.


New Filter Display ParametersJobname - Specifies the jobname to display.Tran - Specifies the transaction to display.

New Line CommandPRint Displays the detail screen for a record, prints the detail report to a sysout data - set and then returns to the display screen.

CICS ConfigurationThe following configuration enhancements have been made in this release:

New Parmlib Members (see page 49)CICSDATA (see page 49)CEITRACE (see page 49)CSTATES (see page 50)CTHRESH (see page 50)CTRANCAN (see page 51)CTRANOPT (see page 52)

CICSOPTS Parmlib Member (see page 53)CICSLOGR Parmlib Member (see page 55)Transaction Data Collection Threshold Metrics (see page 55)Configuration Options Renamed (see page 56)Configuration Options Removed (see page 57)

New Parmlib MembersThe following parmlib members have been added to this release:

CICSDATA

The CICSDATA parmlib member provides configuration options to the new subtask CICSDATA. For more information, see .CICSDATA (https://docops.ca.com/display/CSPM10/CICSDATA)

CEITRACE

parmlib member The CICS EXEC Interface trace (CEITRACE) defines the criteria used to determine whether the monitoring performed for a CICS transaction should include the recording of EXEC Interface requests. For more information, see CEITRACE (https://docops.ca.com/display/CSPM10/CEITRACE.)

https://docops.ca.com/display/CSPM10/CICSDATA

https://docops.ca.com/display/CSPM10/CEITRACE




10-Oct-2016 50/82

CSTATES

CICS State Exception Definitions

The CA SYSVIEW for CICS data collector monitors CICS system and transaction resources. Exception or states alerts can be generated when resource usage exceeds the defined range or limit.

A single set of definitions is used for all monitored CICS regions and resources on a system. The alerting mechanism can trigger any of the following actions:

Write a message to the job log or console

Write a message to the ddname GSVCXLOG

Create an SMF record that can be sent to SMF or written to a SYSVIEW log stream for online viewing

Execute a predefined IMOD (REXX EXEC)

Cancel the transaction

Send an SNMP alert trap

Send an event notification to CA OPS/MVS

Request an Event Capture

The state exception definitions are populated or read initially from the CA SYSVIEW parmlib member CSTATES. Definitions can be maintained and modified using the CA SYSVIEW online command CSTATES. The definitions are saved in the CA SYSVIEW Persistent Data Store (DATALIB). The persistent data store maintains definitions that have been modified or added dynamically. In addition, definitions in the persistent data store are migrated automatically to future product releases. For more information see, .CSTATES (https://docops.ca.com/display/CSPM10/CSTATES)

CTHRESH

CICS Threshold Exception Definitions

The CA SYSVIEW for CICS data collector monitors CICS system and transaction resources. Exception or states alerts can be generated when resource usage exceeds the defined range or limit.

A single set of definitions is used for all monitored CICS regions and resources on a system. The alerting mechanism can trigger any of the following actions:

Write a message to the job log or console

Write a message to the ddname GSVCXLOG

Create an SMF record that can be sent to SMF or written to a SYSVIEW log stream for online viewing

Execute a predefined IMOD (REXX EXEC)


https://docops.ca.com/display/CSPM10/CSTATES


10-Oct-2016 51/82


Send an SNMP alert trap

Send an event notification to CA OPS/MVS

Request an Event Capture

The threshold exception definitions are initially populated or read from the CA SYSVIEW parmlib member CTHRESH. Definitions can be maintained and modified using the CA SYSVIEW online command CTHRESH. The definitions are saved in the CA SYSVIEW Persistent Data Store (DATALIB). The persistent data store maintains definitions that have been modified or added dynamically. In addition, definitions in the persistent data store are migrated automatically to future product releases. For more information, see .CTHRESH (https://docops.ca.com/display/CSPM10/CTHRESH)

CTRANCAN

CICS Transaction Cancellation Definitions

The CA SYSVIEW for CICS data collector performs the following transaction cancellation functions:

Transaction cancellation at CICS shutdown or termination

It is common for CICS shutdown to be delayed due to a conversational transaction waiting on terminal input. You can create a definition to cancel a transaction at shutdown based on the following transaction attributes:

Transaction ID

Jobname

Facility name

Terminal

Transient data queue

Wait reason - Suspend Type

Wait reason - Suspend value

If you create definitions for long-running transactions, CICS can terminate quickly because you are not forced to wait for these transactions to complete.

Transaction Cancellation based on Exception Definitions

You can cancel CICS transactions automatically based on a threshold exception definition. Use the online command CTHRESH to view or modify the Threshold exception definitions.

Transaction cancellation can be overridden or excluded based on the current wait reason of the transaction. If it is determined that the transaction is currently abending, a transaction cancellation is not attempted.

Transaction cancel definitions are initially populated or read from the parmlib member CTRANCAN.

https://docops.ca.com/display/CSPM10/CTHRESH


10-Oct-2016 52/82

Transaction cancel definitions are initially populated or read from the parmlib member CTRANCAN. Use the online command CTRANCAN to maintain and modify definitions. The definitions are saved in the CA SYSVIEW Persistent Data Store (DATALIB). The persistent data store maintains definitions that have been modified or added dynamically. In addition, definitions in the persistent data store are migrated automatically to future product releases.

A single set of definitions is used for all monitored CICS regions. For more information, see CTRANCAN.(https://docops.ca.com/display/CSPM10/CTRANCAN)

CTRANOPT

The CA SYSVIEW for CICS data collector can monitor every CICS transaction executing in a CICS region. Sometimes you want to alter the monitoring characteristics for transactions. Transaction option definitions allow the monitoring characteristics to be specified.

A single set of definitions is used for all monitored CICS regions and transactions on a system.

A transaction can be defined as:

Specific transaction ID

Generic transaction ID specified using wildcard characters

SYSVIEW logical group containing a list of CICS transaction

The following options can be set:

Specify transactions that are required to be active

Exception processing - Include or Exclude

Transaction statistics - Include or Exclude

Logging of the detailed transaction record to the transaction log stream

Logging of the detailed transaction record to SMF

Sending the detailed transaction record to the MVS dynamic exit GSVX.CICSTRAN

Sending monitored transaction information to CA Cross-Enterprise APM

Suppress CICS SMF 110 records

Specify transaction elapsed time monitoring method

Initially the transaction option definitions are populated or read from the SYSVIEW parmlib member CTRANOPT. You can maintain and modify definitions using the SYSVIEW online command CTRANOPT. The definitions are saved in the CA SYSVIEW Persistent Data Store (DATALIB). The persistent data store maintains definitions that have been modified or added dynamically. In addition, definitions in the persistent data store are migrated automatically to future product releases. For more information, see .CTRANOPT (https://docops.ca.com/display/CSPM10/CTRANOPT)

https://docops.ca.com/display/CSPM10/CTRANCAN

https://docops.ca.com/display/CSPM10/CTRANCAN

https://docops.ca.com/display/CSPM10/CTRANOPT


10-Oct-2016 53/82

CICSOPTS Parmlib MemberThe configuration options member CICSOPTS has been enhanced to include the following options:

Option Description

TRANSACTION-DATA-DB2

Default: No

Change: This option can be modified after initialization via the CCONFIG or CICSSET commands.

The CICS data collector monitors and collects detailed information about requests and resources used by a transaction.

This option controls the collection of data made available using CICS global user exits related to the following CICS domain:

RM - Resource Manager

DB2 requests are made through the CICS Resource Manager. This option enables the collection of detailed DB2 request information.

The following related options are required:

TRANSACTION-DATA Yes

Detailed performance information regarding the overhead associated with this option can be viewed using the online command: CGBLEXIT

Valid Values:No - Do not collect dataSUMMARY, YES - Collect DB2 request information by the specific program and request type.DETAIL - Collect DB2 request information by the specific program, request type and statement number.

Related Options:TRANSACTION-DATA-DB2-SEGMENTSTRANSACTION-RECORD-DB2

TRANSACTION-DATA-EXECCICS

Default: Yes

Change: This option can be modified after initialization by using the CCONFIG or CICSSET commands.

The CICS data collector monitors and collects detailed information about requests and resources used by a transaction.

If CICS EXEC Interface requests are being monitored or traced, the EXEC Interface requests are included in the CICS detail transaction record.

This option controls the enablement of CICS global user exits related to the following CICS domain. You must enable the exits to collect the related data.

EI - EXEC Interface


10-Oct-2016 54/82

Option Description

Global user exits to be enabled:

Exitname Description (when the exit is invoked)

XEIIN Before any EXEC CICS API or SPI command runs.

XEIOUT After any EXEC CICS API or SPI command runs.

XEISPIN Before any EXEC CICS SPI command except:EXEC CICS ENABLEEXEC CICS DISABLEEXEC CICS EXTRACT EXITEXEC CICS PERFORM DUMPEXEC CICS RESYNC ENTRYNAM

XEISPOUT After any EXEC CICS SPI command except:EXEC CICS ENABLEEXEC CICS DISABLEEXEC CICS EXTRACT EXITEXEC CICS PERFORM DUMPEXEC CICS RESYNC ENTRYNAME

Detailed performance information regarding the overhead associated with this option can be viewed using the online command: CGBLEXIT

Valid Values:No - Do not collect data.Yes - Collect data. The collected data is summarized by requesting program name and EXEC CICS request. EXEC Interface requests are collected for all transactions.CEITRACE - Data collection is enabled. EXEC Interface trace definitions determine whether EXEC Interface requests are collected for a specific transaction. EXEC Interface trace definitions are in the parmlib member CEITRACE. The definitions can be modified dynamically using the online command: CEITRACE

Related Options:TRANSACTION-RECORD-EXECCICS

THRESHOLD-TASK-DYNAMIC-MXTDELAY

Default: Auto

Change: Use the CCONFIG or CICSSET commands to modify this option after initialization.

Specify if the CICS data collector is to perform exception processing on an interval basis for those tasks that have not been dispatched for the first time due to max task or transaction class max conditions.

Required Scheduler Events:

TRAN-THRESHOLDS

Valid Values: Yes - Perform exception processing.No - Do not perform exception processing.


10-Oct-2016 55/82

Option Description

Auto - Perform exception processing only if at least one of the following metrics has been defined as a threshold exception definition:

MXTDELAY - MXT delay first dispatchTCLDELAY - Tran class delay first dispatch

Related Options: THRESHOLD-TASK-DYNAMTHRESHOLD-TASK-DYNAMIC-SMFTHRESHOLD-TASK-END

For more information, see .CICSOPTS (https://docops.ca.com/display/CSPM10/CICSOPTS)

CICSLOGR Parmlib MemberConfiguration options have been added to the CICSLOGR parmlib member. The new log stream contains CICS Transaction Detail records that contain EXEC Interface segments based on CEITRACE definitions. These new options include:

LOGSTREAM-CICSEITL-DELETE-ALL

Specify if the logger is to delete all existing records in corresponding logstream. This occurs during the initialization connection process. Default = No

LOGSTREAM-CICSEITL-NAME

Specify the name of the MVS logger logstream that is to be used to log CICS EXEC Interface trace log records. If the logstream name is specified as "NONE", no logging occurs. If a log stream has not been defined, the value should be set to "NONE".

For more information, see .CICSLOGR (https://docops.ca.com/display/CSPM10/CICSLOGR)

Transaction Data Collection Threshold MetricsThe data collection threshold metrics have been enhanced to include the following new transaction variables:

TSGETSCT

Temporary storage GET SHR requests.

DFHGroup: DFHTEMP

TSPUTSCT

Temporary storage PUT SHR requests.

DFHGroup: DFHTEMP

NCTOTCT

EXEC CICS GET COUNTER/DCOUNTER requests.

https://docops.ca.com/display/CSPM10/CICSOPTS

https://docops.ca.com/display/CSPM10/CICSLOGR


10-Oct-2016 56/82

EXEC CICS GET COUNTER/DCOUNTER requests.

DFHGroup: DFHCICS

Configuration Options RenamedThe following configuration options in parameter library member CICSOPTS have been renamed.

Note: Update the CICSOPTS parameter library member to use the new names. The prior names will be deleted in a future release.

CA SYSVIEW accepts the prior names and issues message GSVC043W as a reminder to use the new names:

GSVC043W (GSVI) Configuration option PERFORMANCE-GLOBAL-EXIT-EI is obsolete. Using TRANSACTION-DATA-EXECCICS

Review the following list of new and prior option names:

New Option Name Prior Option Name

CEAPM-ENABLE WILY-INTROSCOPE

DUMP-MANAGEMENT PERFORMANCE-GLOBAL-EXIT-DU

TRANSACTION-DATA PERFORMANCE-COLLECTION

TRANSACTION-DATA-DB2 PERFORMANCE-DATA-EXIT-RM-DB2

TRANSACTION-DATA-DB2-SEGMENTS PERFORMANCE-DATA-SEGLIMIT-DB2

TRANSACTION-DATA-DLI PERFORMANCE-GLOBAL-EXIT-DL

TRANSACTION-DATA-EXECCICS PERFORMANCE-GLOBAL-EXIT-EI

TRANSACTION-DATA-FILES PERFORMANCE-GLOBAL-EXIT-FC

TRANSACTION-DATA-FILES-SEGMENTS PERFORMANCE-DATA-SEGLIMIT-FC

TRANSACTION-DATA-PROGRAMS PERFORMANCE-GLOBAL-EXIT-PC

TRANSACTION-DATA-RSCEMGR PERFORMANCE-GLOBAL-EXIT-RM

TRANSACTION-DATA-TDATA PERFORMANCE-GLOBAL-EXIT-TD

TRANSACTION-DATA-TEMPSTG PERFORMANCE-GLOBAL-EXIT-TS

TRANSACTION-DATA-TEMPSTG-SEGMENTS PERFORMANCE-DATA-SEGLIMIT-TS

TRANSACTION-DATA-WEBMQ PERFORMANCE-DATA-EXIT-RM-MQ

TRANSACTION-RECORD-CICSEMP PERFORMANCE-DATA-MCT

TRANSACTION-RECORD-CSF PERFORMANCE-LOG-CSF

TRANSACTION-RECORD-DB2 PERFORMANCE-LOG-DB2

TRANSACTION-RECORD-DLI PERFORMANCE-LOG-DLI

TRANSACTION-RECORD-EXECCICS PERFORMANCE-LOG-ECI

TRANSACTION-RECORD-FILES PERFORMANCE-LOG-FILES


10-Oct-2016 57/82

New Option Name Prior Option Name

TRANSACTION-RECORD-MEI-EVENTS PERFORMANCE-LOG-EVENTS

TRANSACTION-RECORD-PROGRAMS PERFORMANCE-LOG-PROGRAMS

TRANSACTION-RECORD-RSCEMGR PERFORMANCE-LOG-EXITRSCE

TRANSACTION-RECORD-TDATA PERFORMANCE-LOG-TRANDATA

TRANSACTION-RECORD-TEMPSTG PERFORMANCE-LOG-TEMPSTOR

TRANSACTION-RECORD-THRESHOLDS PERFORMANCE-LOG-THRESHOL

TRANSACTION-RECORD-USERDATA PERFORMANCE-LOG-USER-DATA

TRANSACTION-RECORD-WEBMQ PERFORMANCE-LOG-MQ

For more information, see .CICSOPTS (https://docops.ca.com/display/CSPM10/CICSOPTS)

Configuration Options RemovedThe following options have been removed in this release and made obsolete:

DUMP-SVCDUMP

DUMP-SVCDUMP-DAE

DUMP-SVCDUMP-FAIL-TO-SYSABEND

DUMP-SVCDUMP-RETRY-INTERVAL

DUMP-SVCDUMP-RETRY-LIMIT

DUMP-SYSABEND

LOGGER-CONNECT-RETRY-COUNT

LOGGER-CONNECT-RETRY-INTERVAL

MONITOR-ENVIRONMENT-REUSE

MONITOR-RESTORE-SETTINGS

PERFORMANCE-DATA-DB2-BY-PROGRAM

PERFORMANCE-DATA-DB2-BY-STMT

PERFORMANCE-DATA-DB2-BY-TYPE

PERFORMANCE-DATA-EXIT-AP

PERFORMANCE-DATA-EXIT-DL

PERFORMANCE-DATA-EXIT-DU

PERFORMANCE-DATA-EXIT-EI

https://docops.ca.com/display/CSPM10/CICSOPTS


10-Oct-2016 58/82

PERFORMANCE-DATA-EXIT-FC

PERFORMANCE-DATA-EXIT-IC

PERFORMANCE-DATA-EXIT-PC

PERFORMANCE-DATA-EXIT-RM

PERFORMANCE-DATA-EXIT-TC

PERFORMANCE-DATA-EXIT-TD

PERFORMANCE-DATA-EXIT-TS

PERFORMANCE-DATA-EXIT-WS

PERFORMANCE-DATA-EXIT-XM

PERFORMANCE-DATA-EXIT-ZC

PERFORMANCE-DATA-FC-BY-PROGRAM

PERFORMANCE-GLOBAL-EXIT-AP

PERFORMANCE-GLOBAL-EXIT-IC

PERFORMANCE-GLOBAL-EXIT-TC

PERFORMANCE-GLOBAL-EXIT-WS

PERFORMANCE-GLOBAL-EXIT-XM

PERFORMANCE-GLOBAL-EXIT-ZC

SHUTDOWN-STAGE

STATS-FILE-REQUESTS

STATS-FILE-REQUESTS-BY-PROGRAM

STATS-FILE-REQUESTS-BY-TRAN

SYSTEM-DATA-COLLECTION-LOGTIMES

TRANSACTION-OPTIONS-MEMBER

TRANSACTION-OPTIONS-STARTTYPE

For more information, see Configuration Options - Parmlib Member CICSOPTS (https://docops.ca.com/display/CSPM10/Configuration+Options+-+Parmlib+Member+CICSOPTS)

https://docops.ca.com/display/CSPM10/Configuration+Options+-+Parmlib+Member+CICSOPTS




10-Oct-2016 59/82

IMS EnhancementsThe CA SYSVIEW® Performance Management Option for IMS has been enhanced:

Support for IBM SoftwareCA SYSVIEW now supports IMS 14.1.


Note: Support for IMS 11.1 has been dropped.

DC Monitor Record ProcessingStarting with IMS 14.1, the ability to collect DC Monitor data is now possible using an IMSMON user exit.

If you are at this level of IMS, and are currently collecting detail transaction data in CA SYSVIEW® Performance Management by setting the following parameters in the IMSLOGR PARMLIB member:

ACTIVATE-DC-MONITOR = YES

PROCESS-DCM-TYPE = x4E:*:SET

Then you also must define the SYSVIEW exit in the IMS DFSDF PROCLIB member.nnn

For example:

*--------------------------------------------------------------------** USER EXITS SECTION **--------------------------------------------------------------------*<SECTION=USER_EXITS>EXITDEF=(TYPE=IMSMON, EXITS=(GSVPDCMX))

GSVPDCMX is the exit name provided in the CA SYSVIEW load library and must be accessible to the IMS control region using the standard search order (STEPLIB, LINKLIST, and so on).

Note: Do not code the exit if you:

Do not collect detail transaction data (ACTIVATE-DC-MONITOR is NO)

Are at a level of IMS below 14.1 that does not support the IMSMON user exit





10-Oct-2016 60/82

Related Information:

IMS Commands (see page 60)

IMS Configuration (see page 67)

IMS CommandsThe following new and enhanced commands have been added to this release:

New Command (see page 60)Enhanced and Changed Commands (see page 60)

New CommandThe following new command has been added:

Command Description

IMSUEXIT Displays information about User Exits that have been loaded into the IMS control region. This information includes the exit type, load and entry points, exit name, exit size, last REFRESH time, and call count.

Enhanced and Changed CommandsThe CA SYSVIEW® Performance Management Option for IMS has been enhanced:


IMSBALG –Display IMS balance groups

New Info Area Field:IMSPLEX – The IMSPlex name if the IMS subsystem is a member of an IMSPlex.

IMSBUFP -Display IMS buffer pools


IMSCLASS -Display IMS class information


IMSCONN -Display IMS OTMA connections


Renamed Field Name

The following field name has changed:I/O-REQ has been renamed to IOReq



10-Oct-2016 61/82


IMSDAILY -Display hourly summary of transaction usage.

IMSDBASE -Display IMS databases


IMSDBLS -Display DL/I logical database structure


IMSDBPS -Display DL/I physical database structure


IMSDCMON -Display IMS DC Monitor status information


IMSDEDB -Display DEDB database information


IMSDESS -Display external subsystem connections.


Renamed Field Name


IMSDLIDB -Display detail DL/I database information


IMSHALDB -Display detail HALDB database information


IMSHSB -Display IMS hot standby systems



10-Oct-2016 62/82


IMSLATCH -Display IMS latch delays


IMSLINES -Display IMS lines


IMSLIST -Displays IMS control regions


New Line Command:XLOG - Display exception records for the specified period. The XLOG command is invoked.

Renamed Field Name


IMSLTERM -Display IMS logical terminals


IMSLATCH -Display IMS latch delays


IMSMQGQ -Display IMS message queue statistics


IMSMTO -Display IMS master terminal output


IMSNODES -Display IMS statis and dynamic nodes


IMSOMAT -Displays IMS OM audit trail


FILTER - Display a Filter screen to allow the entering of command syntax parameters to filter the data. When the FILTER keyword is entered as part of the primary command, the parameters entered are used topopulate the filter display. After entering desired data on the filter display, the following function keys can be used:

Function KeysENTER - Validate the data entered, no processing occurs.F1 - Invoke HELP for the filter display


10-Oct-2016 63/82


F3 - Validate the data entered and process the data to build the display.F12 - Cancel the requested function



OPTIONS subcommand Parameter ValueFILTER, NOFILTER - Specifies that the FILTER display screen is display. The Filter screen lets you enter command syntax parameters to filter data. The Filter screen displays each time the command is invoked unless the NOFILTER parameter is entered as part of the primary command syntax.


New Filter Display ParameterPlex - The five-character IMSPLEX name (omit CSL)

IMSOSAM -

Display OSAM buffer pools


IMSOSUM -Display OSAM summary statistics


IMSOTMA -Display Open Transaction Manager Access info


IMSOVER -Display IMS activity and resource overview


Renamed Field Name


IMSPI -Display IMS program isolation conflicts


IMSPOOLS -Display IMS CBT pool information



10-Oct-2016 64/82


IMSPROGS -Display IMS program information


IMSPSBS -Display Program Specification Block info


IMSQPOOL -Display IMS queue pool statistics


IMSQSTAT -Display IMS Shared Message Structure Status


IMSQSUM -Display IMS Shared Message Queue Summary


IMSQTRAN -Display IMS Shared Message Queue Detail


IMSRACT -Display IMS Dependent Region Activity Detail


IMSREGNS -Display IMS Dependent Regions


Renamed Field Name


IMSRSLOG – Displays IMS region summary logs

New syntax parameters:CCODE - Specifies the transaction abend code RO - Specifies the region occupancy percentage


10-Oct-2016 65/82



After entering desired data on the filter display, the following function keys can be used:

Function KeysENTER - Validate the data entered, no processing occursF1 - Invoke HELP for the filter displayF3 - Validate the data entered and process the data to build the display.F12 - Cancel the requested function




FILTER, NOFILTER - Specifies that the FILTER display screen displays. The Filter screen lets you enter command syntax parameters to filter data. The Filter screen displays each time the command is invoked unless the NOFILTER parameter is entered as part of the primary command syntax.


New Filter Display ParametersIMSID - Specifies the IMS subsystem to displayJobname - Specified the jobname to displayTran - Specifies the transaction to displayPSBname - Specifies the PSB namd to displayType - Specifies the region typeCCODE - Specifies the transaction abend codeRO% - Specifies the region occupancy percentage

New Line CommandPRint Displays the detail screen for a record, prints the detail report to a sysout - data set and then returns to the display screen.

IMSSLOGS -Display IMS System Logs Status


IMSSSYS -Display IMS External Subsystems



10-Oct-2016 66/82


IMSSTATE - Display the Current IMS State Monitor Definitions

Changed SubcommandRELOAD COLD - Deletes all existing definitions before reloading from the parmlib. This behavior is consistent across all THRESH and STATES commands.

IMSTEXIT -Display IMS Exit Trace Status


IMSTHRSH - Display the current IMS threshold definitions.

Changed SubcommandRELOAD COLD - Deletes all existing definitions before reloading from the parmlib. This behavior is consistent across all THRESH and STATES commands.

IMSTIMES -Display IMS Transaction Times


IMSTLOG -Displays IMS transaction logs

New syntax parameter:CCODE - Specifies the transaction abend codeLIFETIME - Specifies transaction lifetimeCPUTIME - Specifies transaction CPU timeFILTER - Display a Filter screen to allow the entering of command syntax parameters to filter the data. When the FILTER keyword is entered as part of the primary command, the parameters entered are used to populate the filter display.

After entering desired data on the filter display, the following function keys can be used:

Function KeysENTER - Validate the data entered, no processing occurs.F1 - Invoke HELP for the filter displayF3 - Validate the data entered and process the data to build the display.F12 - Cancel the requested function




FILTER, NOFILTER - Specifies that the FILTER display screen is to display. The Filter screen lets you enter command syntax parameters to filter data. The Filter screen displays each time the command is invoked unless the NOFILTER parameter is entered as part of the primary command syntax.


10-Oct-2016 67/82



New Filter Display ParametersIMSID - Specifies the IMS subsystem to displayJobname - Specified the jobname to displayTran - Specifies the transaction to displayPSBname - Specifies the PSB namd to displayUOW - Specifies the unit-of-work to displayCCODE - Specifies the transaction abend codeLIFETIME - Specifies the transaction lifetimeCPUTIME - Specifies the t ransaction CPU time

New Line CommandPRint Displays the detail screen for a record, prints the detail report to a sysout - data set, and then returns to the display screen.

IMSTRANS -Display IMS Transactions


IMSTTABL -Display IMS Table Trace Status


IMSUSERS -Display IMS Users


IMSVSAM -Display IMS VSAM Statistics


IMSVSUM -Display IMS VSAM Statistics Summary


IMSWAITS -Display IMS Wait Analysis


IMS ConfigurationThe following configuration items have been enhanced for this release:

SYSVIEW Parmlib Member (see page 68)SCHDIMS Parmlib Member (see page 68)IMSLOGR Parmlib Member (see page 68)

New IMS Transaction Data Collection Metric (see page 69)


10-Oct-2016 68/82

New IMS Transaction Data Collection Metric (see page 69)

SYSVIEW Parmlib MemberThe following parmlib member is changed:

default setting in this parmlib member has been changed to reduce unnecessary - A SYSVIEW overhead. This change causes IMSDATA to start only when either the CE-APM or the IMS feature has been selected in the System Configuration member.

The start for IMSDATA changed from:

START IMSDATA,WARMSTART /* IMS data collection */

To:

)IF FEATURE EQ IMS START IMSDATA,WARMSTART /* IMS data collection */)ENDIF )IF FEATURE NE IMS )IF FEATURE EQ CEAPM START IMSDATA,WARMSTART )ENDIF )ENDIF

SCHDIMS Parmlib MemberThe following configuration options have changed in the parameter library member SCHDIMS:


IMS-BALGRPS Yes 1Min No 2Min

IMS-BUFPOOLS Yes 1Min Yes 2Min

IMS-ESUBSYS Yes 1Min Yes 2Min

IMS-LOCKS Yes 10Min No 2Min

IMS-LTERMS Yes 1Min No 10Min

IMS-OSAM Yes 1Min No 2Min

IMS-OTMA Yes 1Min No 2Min

IMS-POOLS Yes 1Min No 2Min

IMS-VSAM Yes 1Min No 2Min

IMSLOGR Parmlib MemberThe configuration options member IMSLOGR has been enhanced to include changes to the following option:

ACTIVATE-DC-MONITOR

Specifies if the IMSLOGR is to activate the DC Monitor intercept or the IMSMON User Exit (IMS 14.1 and above). Valid values are:

Yes - the DC Monitor intercept is installed if no other foreign product has already done so.

No - the DC Monitor intercept is not installed.


10-Oct-2016 69/82

No - the DC Monitor intercept is not installed.

Force - the DC Monitor intercept is installed, even if some other product has already done so. Use Force only when you are running multiple IMS monitors and there are no compatibility issues.

For more information, see .IMSLOGR (https://docops.ca.com/display/CSPM10/IMSLOGR)

New IMS Transaction Data Collection MetricThe data collection has been enhanced to include the following metric:

IMTRABNDIMS Abend Count

WebSphere MQ EnhancementsThe CA SYSVIEW WebSphere MQ component has been enhanced. See the following topics for more detailed information:

WebSphere MQ Commands (see page 69)

WebSphere MQ Configuration (see page 71)

WebSphere MQ CommandsThe CA SYSVIEW® Performance Management Option for WebSphere MQ has been enhanced:



MQRLOG -Displays the MQ request history log





https://docops.ca.com/display/CSPM10/IMSLOGR


10-Oct-2016 70/82



The subcommand OPTIONS will display the current setting.



New Filter Display ParametersQmgr - Specifies the qmgr to display.Type - Specifies the Type to display.

Valid Values:

CHANNELQUEUEQMGRMANELISTPROCESSSTGCLASSAUTHINFOCFSTRUCT

Subtype - Specifies the subtype of the object type.

Valid values for type QUEUE:

QLOCALQREMOTEQMODELQALIASQCLUSTER

Valid values for type QUEUE:

CLNTCONNCLUSRCVRCLUSSDRRCVRRQSTRSDRSVRSVRCONN

For all other types the Subtype is the same as Type.Object - Specifies the object to display.


10-Oct-2016 71/82


New Line CommandPRint Displays the detail screen for a record, prints the detail report to a - sysout data set and then returns to the display screen.

MQSTATES - Displays the current WebSphere MQ state monitor definitions.

New Data FieldRsceAttr - A resource attribute qualifier. If a resource attribute is specified on a definition where a resource attribute is not valid, it is ignored.

Changed SubcommandRELOAD COLD - Deletes all existing definitions prior to reloading from the parmlib. This behavior is consistent across all THRESH and STATES commands.

MQSTHRESH - Displays the current WebSphere MQ threshold definitions.

New Data FieldRsceAttr - A resource attribute qualifier. If a resource attribute is specified on a definition where a resource attribute is not valid, it is ignored.


WebSphere MQ ConfigurationThe following MQ parmlib members have been enhanced:

Enhanced Parmlib Members (see page 71)Parmlib Member SCHDMQS (see page 71)Parmlib Member MQSSTATE (see page 71)Parmlib Member MQSTHRSH (see page 72)

Enhanced Parmlib Members

Parmlib Member SCHDMQS

The following configuration options have changed in the parameter library member SCHDMQS:


MQSDATA-CHANNELS Yes 1Min Yes 5Min

MQSDATA-DQMGRS Yes 1Min Yes 2Min

MQSDATA-QUEUES Yes 1Min Yes 2Min

Parmlib Member MQSSTATE

The MQSSTATE parmlib member defines initial state definitions for the resources that are monitored.

New Keyword

Supports the RsceAttr keyword, which allows users to specify a channel type for channel-related


10-Oct-2016 72/82

Supports the RsceAttr keyword, which allows users to specify a channel type for channel-related metrics.

For more information, see .MQSSTATE (https://docops.ca.com/display/CSPM10/MQSSTATE)

Parmlib Member MQSTHRSH

The MQSTHRSH parmlib member defines the thresholds of resources to monitor.

The following thresholds have been added:

DEFINE MQBPUSE% QMGR = RSCE = WARNING 75 LIMIT 90 DEFINE MQCHMSGR QMGR = RSCE = WARNING 1 LIMIT 2 RULETYPE CHANGE DEFINE MQDCONA% QMGR = RSCE = WARNING 75 LIMIT 90 DEFINE MQDCONC% QMGR = RSCE = WARNING 75 LIMIT 90

The following thresholds have been removed:

DEFINE MQCHBFRR QMGR = RSCE = LIMIT 20DEFINE MQCHBFSR QMGR = RSCE = LIMIT 20DEFINE MQCHBYRR QMGR = RSCE = LIMIT 4KDEFINE MQCHBYSR QMGR = RSCE = LIMIT 4KDEFINE MQCHMSGR QMGR = RSCE = LIMIT 10DEFINE MQQDEPTH QMGR = RSCE = LIMIT 50

New Keyword

Supports the RsceAttr keyword, which allows users to specify a channel type for channel-related metrics.

For more information, see .MQSTHRSH (https://docops.ca.com/display/CSPM10/MQSTHRSH)

CA Roscoe EnhancementsThe CA Roscoe option has been enhanced. For more information, see CA Roscoe Command (see page

.72)

CA Roscoe CommandsThe following command enhancements have been made in this release:

Command Description

ROSLIBS - Displays information about CA Roscoe libraries. Renamed Field Name

The following field name has changed:

https://docops.ca.com/display/CSPM10/MQSSTATE

https://docops.ca.com/display/CSPM10/MQSTHRSH


10-Oct-2016 73/82

Command Description

I/O-Count has been renamed to IOCount.

ROSLIST - Displays information about monitored CA Roscoe jobs.

Renamed Field Name

The following field name has changed:I/O-Count has been renamed to IOCount.

Event Capture EnhancementsThe CA SYSVIEW® Performance Management Event Capture Option has been enhanced. For more information, see the following topics:

Event Capture Commands (see page 73)

Options RemovedThe following Event Capture Configuration Options have been removed:

CaptureIndexDsname

CaptureIndexHlqual

CaptureDatasetHlqual

For more information, see Event Capture Configuration Options Removed (https://wiki.ca.com/display./CSPM/.Event+Capture+Configuration+Options+Removed+v14.1)

Event Capture CommandsThe following enhancements have been made to existing commands.


SMFLOG - Exception log




Function KeysENTER - Validate the data entered. No processing occurs.F1 - Invoke HELP for the filter display.

https://wiki.ca.com/display/CSPM/.Event+Capture+Configuration+Options+Removed+v14.1




10-Oct-2016 74/82


F3 - Validate the data entered and process the data to build the display.F12 - Cancel the requested function.


The subcommand OPTIONS will display the current setting.



New Filter Display ParametersType - Specifies the SMF record type that is to be displayed.

Valid Values:

Minimum = 0

Maximum = 255

If the first character of the value is an X, then the value is interpreted as a hexadecimal value.

Example:

Hexadecimal Decimal x1E 30

SubType - Specifies the SMF record subtype that is to be displayed.

Valid Values:

Minimum = 0Maximum = 255

If the first character of the value is an X, then the value is interpreted as a hexadecimal value.

New Line CommandPRint Displays the detail screen for a record, prints the detail report to a sysout data - set and then returns to the display screen.

For more information, see Event Capture Subtask Setup (https://docops.ca.com/display/CSPM10./Event+Capture+Subtask+Setup)

https://docops.ca.com/display/CSPM10/Event+Capture+Subtask+Setup




10-Oct-2016 75/82

TCP/IP EnhancementsThe TCP/IP Option for CA SYSVIEW® Performance Management has been enhanced. See the following topics for more information:

TCP/IP Commands (see page 76)

TCP/IP Configuration (see page 76)

TCP/IP CommandsThe CA SYSVIEW Option for TCP/IP has been enhanced:



IPCONFIG - Displays TCP/IP configuration information.

New Fields

The following IPCONFIG fields have been added to the CA SYSVIEW IPCONFIG command:

- EPHEMERALPORTS- SELECTIVEACK- TIMEWAITINTERVAL- DEFLTMAXSNDBUFSIZE- RETRANSMITATTEMPT- CONNECTTIMEOUT- CONNECTINITINTVAL- KEEPALIVEPROBES- KAPROBEINTERVAL- NAGLE- QUEUEDRTT- FRRTHRESHOLD- EPHEMERALPORTS- SMCRGRPSTATS- SMCRLNKEVENT- SMCR

TCPSTATE - Displays the current TCP/IP state monitor definitions.


TCPTHRSH - Displays the current TCP/IP threshold definitions.



10-Oct-2016 76/82

TCP/IP ConfigurationThe following enhancements have been made for this release:

SCHDTCP Parmlib Member Enhancement (see page 76)TCP Data Collection Charges (see page 76)

SCHDTCP Parmlib Member EnhancementThe following configuration options have changed in the parameter library member SCHDTCP:


TCP-SYSTEM Yes 1Min Yes 5Min

TCP Data Collection ChargesThe data gathering method for TCP-SYSTEM data collection changed from using NETSTAT to using the TCP Network Management Interface (NMI). This change reduces the CPU and elapsed time to collect these metrics.

As a result of these changes, the following TCP-SYSTEM metrics are no longer available:

Variable Description I6RADPRO ICMP IPV6 recv admin prohibitedI6SADPRO ICMP IPV6 sent admin prohibited

Audit Events EnhancementsThe Audit Events component tracks or audits the activities and actions that are performed within the CA SYSVIEW® Performance Management product. The Audit Events component is designed to record activities that alter or change resources.

For more information about enhancements, see .Audit Event Commands (see page 76)

Audit Events CommandsThe following enhancements have been made to the existing command:

AUDITLOG

Audit event log


FILTER - Display a Filter screen to allow the entering of command syntax parameters to filter the data. When entering the FILTER keyword as part of the primary command, the parameters entered are used to populate the filter display.

After entering the desired data on the filter display, you can use the following function keys:


10-Oct-2016 77/82

ENTER - Validate the data entered. No processing occurs.

F1 - Invoke HELP for the filter display.

F3 - Validate the data entered and process the data to build the display.

F12 - Cancel the requested function.




FILTER, NOFILTER - Specifies that the FILTER screen display. The Filter screen lets you enter command syntax parameters to filter data. The Filter screen displays each time the command is invoked unless the NOFILTER parameter is entered as part of the primary command syntax.

Syntax OPTIONS FILTER


System - Display only those audit events that were created on the specified system.

Jobname - Display only those audit events that were created by the specified jobname.

Task - Display only those audit events that were created by the specified task name.

TaskID - Display only those audit events that were created by the specified task ID.

Userid - Display only those audit events that were created by the specified user ID.

Type - Specifies the audit event code type to display. Valid values are: See AUDITDEF command.

Event - Specifies the audit event to display. Valid values are: See AUDITDEF command.

SSID - Display only those audit events that were created on the specified subsystem.

Rels - Display only those audit events that were created by the specified product release.

BLD - Display only those audit events that were created by the specified product build number.

New Line Command

PRint Displays the detail screen for a record, prints the detail report to a sysout data set, and - then returns to the display screen.


10-Oct-2016 78/82

Graphical User Interface (GUI) EnhancementsThe CA SYSVIEW® Performance Management CA GMI component provides a modern GMI Windows GUI interface from which you can access and use CA SYSVIEW® Performance Management. This interface has been enhanced.

Objects Enhanced (GMI)OPERLOG - Displays the historical plot log


FILTER - Display a Filter screen to allow the entering of command syntax parameters to filter the data. When you enter the FILTER keyword as part of the primary command, the parameters entered populate the filter display.


Function Keys

ENTER - Validate the data entered. No processing occurs.

F1 - Invoke HELP for the filter display.

F3 - Validate the data entered and process the data to build the display.

F12 - Cancel the requested function.




FILTER, NOFILTER - Specifies that the FILTER display screen is to be displayed. The Filter screen lets you enter command syntax parameters to filter data. The Filter screen displays each time the command is invoked unless you enter the NOFILTER parameter as part of the primary command syntax.



Sysplex- Specifies the sysplex name

System - The name of the system that issued the message

Origin - The origin of the message

Jobname - The job name that issued the message


10-Oct-2016 79/82

Jobname - The job name that issued the message

JobID - The job ID that issued the message

REXX EnhancementsThe CA SYSVIEW® Performance Management REXX function has been enhanced.

SYSVIEW REXX FunctionsThe CA SYSVIEW REXX function has been enhanced to include the following new function:

TARCHVOL - Tests a supplied volume serial number to see if it is an archived volume serial number.

Security EnhancementsCA SYSVIEW® Performance Management Security has been enhanced.

Required Access to New SAF ResourceAs part of migrating to the use of the GSVXSCFG DDname in the server address spaces, it became necessary to add additional security measures. These measures prevent unauthorized users from overriding configuration options. This release now requires that all of the CA SYSVIEW® Performance Management server address spaces have access to the following resource:

ESM SAF Class SAF Entity Access

ACF2 SYSVIEW SV.CREATE.SSID.<smfid>.<ssid> READ

RACF FACILITY SV.CREATE.SSID.<smfid>.<ssid> READ

TSS CAGSVX SV.CREATE.SSID.<smfid>.<ssid> READ

<smfid> is the SMF ID of the system where the server address space is executing.

<ssid> is the Subsystem ID that was specified for the SSID= parameter during installation. The default SSID is GSVX.

Optionally define the SAF Entity as a generic resource in your External Security Manager:

SV.CREATE.SSID.*

The server address spaces include:

SYSVIEW Main Services Address Space (SYSVIEW)


10-Oct-2016 80/82

SYSVIEW User Interface Address Space (SYSVUSER)

SYSVIEW Auxiliary Services Address Space (SYSVAUX)

You should restrict update access to:

The procedure library containing the startup JCL for any of the server address spaces

The System Configuration data set pointed to by the GSVXSCFG DDname

Starting a server address space that does not have access to this SAF resource fails with the following error message:

GSVX205E Nucleus load failed, reason 30 not authorized to create or update subsystem

Data Collection EnhancementsData collection has been enhanced for this release:

Default Data Collection Changes for New Installations (see page 80)Configuration Options: Parmlib Member SCHDMVS (see page 80)Configuration Options: Parmlib Member SCHDMQS (see page 81)Configuration Options: Parmlib Member SCHDTCP (see page 81)Configuration Options: Parmlib Member SCHDIMS (see page 81)

Default Data Collection Changes for New InstallationsCA SYSVIEW now provides you with an installation featuring a limited number of features that are turned on. This approach is designed to reduce CPU consumption and help meet the consumption expectations and needs of a new installation.

The default configuration values for the following parameter library members have changed.

Configuration Options: Parmlib Member SCHDMVSThe following default configuration options have changed in the parameter library member SCHDMVS:


MVS-CHANNELS Yes 1Min No 2Min

MVS-CPU Yes 30Sec Yes 1Min

MVS-CPUSTATUS Yes 1Min No 1Min

MVS-DEVICES Yes 5Min No 15Min

MVS-JES-NODES Yes 1Min No 5Min

MVS-REQ-JOBS Yes 1Min No 1Min

MVS-USS Yes 1Min No 2Min


10-Oct-2016 81/82


MVS-VTAM-APPLIDS Yes 1Min No 2Min

Configuration Options: Parmlib Member SCHDMQSThe following default configuration options have changed in the parameter library member SCHDMQS:


MQSDATA-CHANNELS Yes 1Min Yes 5Min

MQSDATA-DQMGRS Yes 1Min Yes 2Min

MQSDATA-QUEUES Yes 1Min Yes 2Min

Configuration Options: Parmlib Member SCHDTCPThe following default configuration options have changed in the parameter library member SCHDTCP:


TCP-SYSTEM Yes 1Min Yes 5Min

Configuration Options: Parmlib Member SCHDIMSThe following default configuration options have changed in the parameter library member SCHDIMS:


IMS-BALGRPS Yes 1Min No 2Min

IMS-BUFPOOLS Yes 1Min Yes 2Min

IMS-ESUBSYS Yes 1Min Yes 2Min

IMS-LOCKS Yes 10Min No 2Min

IMS-LTERMS Yes 1Min No 10Min

IMS-OSAM Yes 1Min No 2Min

IMS-OTMA Yes 1Min No 2Min

IMS-POOLS Yes 1Min No 2Min

IMS-VSAM Yes 1Min No 2Min

Removed from ProductThe product no longer supports the following items, which have been either removed or deprecated for this release:

Chorus Infrastructure Management (Chorus IM) features have been removed


10-Oct-2016 82/82

Support for IMS 11.1 has been dropped

Support for CA Datacom CSF 11.0 has been dropped

ca sysview® performance management - docops.ca.com · ca sysview® performance management - 14.1...

Documents