Back to Bookshelf
CA MIM Programming Guide
Legal Notices
CA Technologies Product References
Contact CA Technologies
Documentation Changes
Introduction
Intended Audience
Introduction to CA MIM
Components and Facilities
CA MIA Tape Sharing
CA MIC Message Sharing
CA MII Data Sharing
CA MIM Driver
Planning Initial Settings
Overview
General Statements
Plan the MIMINIT Member
Plan the MIMCMNDS Member
Plan the MIMSYNCH Member
Plan the Message Facility Members
Advanced Topics
Communication Methods
Physical Control File Communication Methods
DASD Control Files
Coupling Facility Structure Control Files (XES)
Virtual Control File Communication Methods
Hyperstar
Initial Communication Methods Overview
CTCDASD as the Initial Communication Method
How You Implement the CTCDASD Communication Method
CTCONLY as the Initial Communications Method
Implement CTCONLY Communication
XCF as the Initial Communication Method
Implementing XCF Communication
NONE as the Communication Method
Implement COMMUNICATION=NONE
ICMF Communication Method
How You Define Your VCF Master and Error Recovery Environment
How You Select Master Systems
How You Define CTC Devices for Use in VCF Environments
Configure CTCPATH Statements for Disaster Recovery
Control and Checkpoint File Considerations
Comparison of DASD Control Files and Coupling Facility Structure Control Files
Create Checkpoint Files
How You Allocate Control and Checkpoint Files
DASD Control File Placement
Allocate DASD Control Files
Allocate Checkpoint Files
XES Control File Placement
How You Use XES Control Files
Control File Size Considerations
Change the Size of the Virtual Control File Transfer Buffer
How CA MIM Formats Control and Checkpoint Files
How You Migrate to a New Control File
How You Migrate to a DASD Control File
Migrate to a Coupling Facility Structure Control File
Migrate to a Virtual Control File
How You Replace Control Files
Replace DASD Control Files
Replace Coupling Facility Structure Control Files
Coupling Facility Structure System-Managed Rebuild
Product Activation Considerations
Startup Activities
CA MIA Startup Activities
CA MIC Startup Activities
CA MII Startup Activities
How You Override Initialization Values at Startup Time
The SYSID Override Parameter
The FORMAT Override Parameter
DASDONLY or CTCDASD Formatting
CTCONLY or XCF Formatting
How You Dynamically Change CA MIM Communication Methods
Activate XCF Communication when COMMUNICATION=DASDONLY
Revert to the Original Communication Method
Activate List Structures when COMMUNICATION=XCF or CTCONLY
Revert to the Original List Structures
Activate XCF Communication on a Subset of the Systems
Revert to CTC Communication
Add a System to the MIMplex when COMMUNICATION=CTCDASD
Revert to the Original MIMplex
Add a System when COMMUNICATION=DASDONLY
Add a System when COMMUNICATION=XCF
Format Start
Defining CA MIM in the Subsystem Name Table
Running Components in Separate Address Spaces
Product Termination Considerations
Global Shutdown Processing
CA MIA Activities During Global Shutdown
How You Automatically Free a System From the MIMplex
CA MIC Activities During Global Shutdown
CA MII Activities During Global Shutdown
Using Global SHUTDOWN Commands to Stop CA MIM
Local Shutdown Processing
CA MII Activities During Local Shutdown
CA MIA Activities During Local Shutdown
Local Shutdown Procedure
Local System Shutdown With or Without Abend Codes
Local Shutdown with Restart Manager
Local Shutdown with JES3
How You Shut Down the System in a VCF Environment
How You Free Inactive Systems
How You Free Resources and Devices
Quiesce and Restart CA MIM
WAITSTATE and SHUTDOWN WAIT
Command Security Considerations
Commands, Access Authorities, and Entity Names
How You Activate New Features with ACTIVATE COMPATLEVEL
How You Use ACTIVATE COMPATLEVEL with Checkpoint Files
How You Activate New Features with ACTIVATE FEATURE
How You Use ACTIVATE FEATURE with Checkpoint Files
How to DEACTIVATE a FEATURE
Sysplex Considerations
Performance Considerations
CA MIM Driver
Control File Internals
Global Management Record (GMR)
Control File Cycle
CA MIM Transactions
Control File Blocks and the Global-Copy Process
Control File Externals
Physical Control Files
Virtual Control Files
Control File Mediums and Performance
How to Set a Preferred Medium for VCF Communication
Tuning Control File Access Rates
Control File Tuning: Analysis
How To Display Control File Processing Information
How You Display Enqueue Request Information
Analysis Phase Summary
Control File Tuning: Parameters
Control File Tuning: Implementation
Control File Tuning: Example
How You Page-fix Cell Pooled Control Blocks
How to Offload CA MIM Work to zIIP Engines
Performance Considerations for Each Component
The CA MIM Logging Facility
z/VM Considerations
Sharing Devices Under z/VM
Serializing Access in z/VM Environments
How You Serialize Access Through Real Reserve/Release Processing
How You Determine Whether z/VM Is Sending Reserve CCWs to Devices
Telling z/VM to Send Reserve CCWs to Devices
Serializing Access Through Virtual Reserve/Release Processing
How You Invoke Virtual Reserve/Release Processing
How You Serialize Access to Minidisks
How You Alter System Definitions While CA MIM Executes
Troubleshooting
How You Resolve Problems
Diagnostic Procedures
Diagnostic Data
How You Interpret Diagnostic Data
How You Respond to Control File Access Delays
Message MIM0061W
Guidelines for Researching Message MIM0061W Problems
Message MIM0062W
Message MIM0063W
Message MIM0100A
Message MIM0200W
How You Activate Tracing
How You Send Trace Data to a SYSOUT Class
How You Send Trace Data to an Output File
How You Obtain Dumps
Product Releases and Maintenance
How You Request Enhancements
User Exits
How You Manage User Exits
Load, Enable, or Disable Exit Routines
View Exit Routine Information
Common Exit Interface (MIMINIXT)
Communication Words in Exit Routines
Multiple Exit Routines
Common Parameter List for All Exit Routines
Sample Exit Routines
Exit Routine Programming Considerations
MIMATHXT Exit
Entry Environment:
Return Code, Register 15:
MIMCMDXT Exit
Entry Environment:
Return Code, Register 15:
Issuing Messages From MIMCMDXT
MIMINIXT Exit
Entry Environment:
Utilities and Other Interfaces
CTC Path Validation Utility
Utility Components
Install the Utility
DASD Reserve Validation Utility
Utility Components
Install the Utility
Parmlib SyntaxSCAN Utility
Utility Components
Install the Utility
Using the SyntaxSCAN Utility
TSO Command Interface Utility
Utility Components
Install the Utility
Troubleshooting the TSO Command Interface Utility
Message Facility
Default Message Tables
MIMMSGS Message Table
Creating a Custom Message Table
Message Table Syntax Rules
Rule Examples
Naming Convention for Messages
Message Facility Statements and Commands
Controlling MSG Statement Logging
Help Facility
How You Add or Delete Help Topics
How You Request Information from the Help Facility
ALTSEREXTENDED Interface
Report Generation for CA MIM
Planning
Specify an SMF Record Number
Specify a Record Type
Sample Command for Record Collection
Dumping the SMF Records
Generating a Report
DDnames Used by MIMEZRPT
Report Generation Requests Using CA Easytrieve
Sample JCL for Report Generation
Control Card Syntax for MIMEZRPT SMF Report Generation
Sample Reports
Control File Performance Report Summary (CF)
Control File I/O Report Summary (FC)
Virtual Control File (CTC) Performance Report (VF)
CA MIM Health Checks
MIM_GDIF_PROCESS_ALLSYS
MIM_GDIF_ACF2_NOSMC
MIM_GDIF_CF_SZ
MIM_DRVR_CF_STATUS
MIM_GDIF_RESTART_MNGR
Integration with CA OPS/MVS
Overview
Enabling CA OPS/MVS Event Notification
API Rules
CA MIM Product State Management
CA MIM Health Check State Management
Glossary
ACL
ACL processing
action message
active ACL status
active status
address routine
alias name
allocation recovery
alternate path support
ASCB CHAP
assignable tape devices
attribute verification
attribute violation
authority level
authorization statement
AUTOFREE
broadcast
CALServ
checkpoint files
collection set
command
command alias
command prefix character
command routing path
command source
communication method
conflict
console pool
console pool member
control file
coupling facility
CP
CPU
CPU image
CTC device
CTC master system
CTC path
CTCA
DASD
data set control block
DCB
deadly embrace
dedicated device
dedicated linkage
dedicated resource
dedicated status
descriptor code
destination
device control list
device control member
device group
device preference value
DISP=SHR verification
display command
display panel
display routine
DSCB
dual allocation
ECMF
EDIF
EDIF processing list
EDIF processing statement
EDIPARMS member
EDL
EDT
eligible device list (EDL)
eligible device table (EDT)
elimination logic
ENQ facility
ENQ request
esoteric group
exclusion parameters
exclusive linkage
exempt list
exit routine
externally dedicated device
externally reserved device
GCMF
GCMF console pool
GDIEXMPT member
GDIF
generic group
global
global device name
global ENQ request
global name
GTAF
hardware reserve
I/O
ICMF
image
inaccessible device
inclusion parameters
index number
ineligible device
initialization
initialization parameters
initialization statements
initialization values
initiator
integrity exposure
JCL
linkage
LMP codes
local device name
local name
locally dedicated device
locally reserved device
locking mechanism
managed device
managed resource
master system
MCS
message ID
message routing definition
message type
migration
MIMCMNDS member
MIMINIT member
MIMMSGS member
MIMPARMS data set
MIMplex
MIMQNAME member
MIMSYNCH member
MIMTRC data set
MIMUNITS member
minidisk
monitor type
multi-line message
multiple console support
non-specific linkage
non-specific volume request
non-temporary volume request
not-available device
not-available status
offline device list
operating values
overgenned device
overgenned status
parallel sysplex
parameter data set
PDF
PDF
PDS
preference logic
preference value
processing options
pseudo-volume serial number
QNAME
QNAME list
read verification
real reserve/release processing
release CCW
REQUEUE feature
reserve CCW
RESERVE facility
RESERVE request
reserved device
reserved status
resource
resource conflict
retrieval panel
RNAME
routing code
routing definition
routing path
serialization
service cycle
service interval
shared linkage
significant characters
SMF
source system
specific linkage
specific volume request
statement
subsystem console
synchronization
sysplex
system
system alias
system ID
system index number
system name
target console
target system
temporary volume request
TPCF
trace
trace data set
TSO
TSO user ID
UCB
UCMID
update violation
utility verification
virtual control file
virtual reserve/release processing
volser
VSAM
VTOC
wait-eligible device
wildcard characters
XCF communication
z/OS
z/OS ENQ facility
z/OS RESERVE facility
z/VM