Mainframe Analytics Recorder User Guide

Version: 10.1.x
Audience: anonymous
Part Number: MK-92HC226-08
Published: 2026-01-30

Overview of MAR
About MAR
MAR concepts and terms
About metric collection
About metric collection intervals
Prerequisites for MAR
System configuration of MAR
About MAR programs and files
About MAR programs
About MAR files
Relationship between the programs and files of MAR
Installation and setup
Workflow of installation and setup
Installing MAR
Installation workflow
Transferring the load module to a host machine
Installing using SMP/E
Installing without using SMP/E
Library datasets to be installed
Registering LINKLIB load library for authentication
Registering the LINKLIB load library HDSRLNKT for authentication
Example of dynamically linking the LINKLIB load library to LNKLST
Registering the RSINSCHK command and the RSQRYSMS command in TSO/E for authentication
Setting RACF security
Configuring security settings to use cataloged procedures
Settings for using environment configuration commands and cataloged procedures
Registering a user SVC
Registering a user SVC using the RSALCSVC command
Registering a user SVC using the IEASVCxx parmlib member
Prerequisite user SVC versions for MAR
Setting up the MAR environment variables and system symbols
About MAR environment variables and system symbols
MAR environment variables and system symbols setting items
Setting up the environment using environment variables
Setting up the environment using system symbols
Setting SMF
Verifying the setup information
Preparing to use MAR
Required settings for collecting event logs
Backing up MAR to the distribution library
Notes on system setup when a related product is installed
Notes on user SVC registration when a related product is installed
Notes on environment variable or system symbol settings when a related product is installed
Notes on specifying a prefix when a related product is installed
Upgrading MAR
Workflow for upgrading MAR
Checking the setting values of the environment
Creating a backup
Removing members of a cataloged procedure library
Removing the load library linkage
Upgrading MAR
Notes on upgrading MAR
When upgrading MAR from a version earlier than 8.6
Notes for when multiple versions of MAR coexist
Notes on static registration of a user SVC
Using MAR
Collecting metric
Workflow for metric collection
Designing the operation
Acquiring disk configuration information
Creating a metric collection parameter file
Checking the metric collection parameters
Starting metric collection
About scope of metric collection
Examples of setting metric collections
Collecting information of all volumes in the disk configuration definition file
Collecting information about some volumes in the disk configuration definition file
Collecting information about volumes not in the disk configuration definition file
Collecting information about the volumes in all subchannel sets
Collecting information about the volumes in the active subchannel set only
Examples of changing the metric collection environment
Operating procedure for changing the metric collection environment
List of examples of changing the metric collection environment and the required operations
Adding a storage system to the collection targets
Adding volumes not in the disk configuration definition file to the collection targets
Changing the collection scope within volumes in the disk configuration definition file
Adding a volume added to an SMS storage group to the collection targets
Excluding from the collection target volumes that were deleted from an SMS storage group
Excluding volumes that were deleted from the system from the collection targets
Adding I/O destination devices
Changing the interval and metrics
Terminating metric collection
Required memory size and dataset disk space
Required memory size
Required disk space for the disk configuration definition file dataset
Required disk space for the SMF dataset
Examples of calculating the amount of data of the output SMF records
MAR reference
MAR commands
Metric collection start command
Metric collection termination command
Metric collection environment refresh command
Metric collection parameter display command
SMF records count display command
RSALCSVC
RSDSPENV
RSENV
RSINSCHK
RSSETENV
MAR programs
JCL for the disk configuration acquisition program
SYSIN parameters for the disk configuration acquisition program
JCL for metric collection program
Metric collection parameters
Conventions for specifying metric collection parameters
Metric collection environment settings
Syntax of metric collection parameters
Collecting trace information and logs for troubleshooting
Trace information and logs
Collecting trace information
Log types for MAR
Collecting event logs
About event log collection methods
About event log output datasets
Event log disk space requirements
Collecting event logs using the system logger service
System logger service settings
Setting LOGR couple datasets
Defining the SMS for the system logger service
Defining a log stream
Log stream parameters
Setting access privileges for system logger resources
Starting the system logger service
JCL example for confirming a log stream
JCL example for deleting a log stream
Avoiding a full event log when using the system logger service
Redefining the log stream when the event log is full
Restarting the system logger service and redefining the log stream when the event log is full
About the event log output tool
Generating logs using the event log output tool
Control statements for the event log output tool
Output format of the event log output tool
Collecting event logs without using the system logger service
Allocating log datasets without using the system logger service
Writing to a log dataset without using the system logger service
Troubleshooting
Workaround if SMF records are not output
Checking whether the SMF record type is correctly set
Checking the status of SMF
Checking the status of I/O destination devices
Checking the status of the storage system
SMF records
Section configuration of SMF records
Standard header and self-defining section
Product section
LOST section
LDEV section
MPU section
CLPR section
PGRP section
PORT section
MPRANK20 section
PARM section
Correlation between parity group IDs and RAID rank IDs
Record versions of and changes to SMF records
Modifying the sample JCL
Values used in the sample JCL modification examples
ALLOUPLD (creating datasets used for transfers)
RECVUPLD (TSO/E RECEIVE processing)
HDSRSSIN (installing without using SMP/E)
SMPALLOC (allocating SMP/E datasets)
HDSRS1AL (allocating the distribution library and target library)
HDSRS2DF (defining the distribution library and target library)
HDSRS3RC (SMP/E RECEIVE processing)
HDSRS4AP (creating target libraries)
HDSRS5AC (creating distribution libraries)
Command syntax descriptions
Command syntax descriptions

Back to home page