Table of Contents

z/OS MVS Programming: Sysplex Services Guide

Previous topic | Next topic | Contents | Contact z/OS | Library | PDF

Contents (exploded view)

z/OS MVS Programming: Sysplex Services Guide
SA23-1400-00

z/OS Version 2 Release 1 summary of changes

Introduction to Sysplex Services

Introduction to Sysplex Services

Sysplex Services for Communication (XCF)

Using the Cross-System Coupling Facility (XCF)

Member Attributes

Using the IXCSETUS Macro

Example of Using the IXCSETUS Macro

Using IXCSETUS for Active Members on Different Systems

Using Signaling Services to Send and Receive Messages

Using the IXCMSGOX Macro

Identifying the Message Data

Specifying the Delivery Options for Messages

Handling Error Conditions

Queueing Messages for Later Delivery

Handling IXCMSGOX Requests When a Member Terminates

Using the IXCMSGIX Macro

Using the IXCMSGC Macro

Requesting that a Message Be Discarded

Requesting Information about Messages

Requesting that a Message Be Completed

Requesting that a User Routine Is To Process a Message

Coding a Message Notify User Routine

Requesting XCF Status Monitoring

Using a Status User Routine

Normal Processing

User Routine Environment

User Routine Recovery

Entry Specifications

Return Specifications

Coded Example

Notifying Members of Changes

Coding a Group User Routine

User Routine Environment

User Routine Recovery

Entry Specifications

Obtaining XCF Information

Obtaining Tuning and Capacity Planning Information

Disassociating Members from XCF

Example of Designing and Implementing a Multisystem Application

How Does the Installation Set Up PHONBOOK on Each System?

How Does PHONBOOK Handle Different Types of Work Requests?

Using XCF for client/server communication

Overview of IXCSRVR

Using the IXCSEND macro

Sending a response to a client

Summary of IXCSEND functions

Using the IXCRECV macro

Using the XCF Server

Client/server compatibility

An example

Server and client recovery considerations

Coding a server exit routine

Sysplex Services for Recovery (Automatic Restart Management)

Using the Automatic Restart Management Function of XCF

Understanding How Your Installation Uses Automatic Restart Management

Requesting Automatic Restart Management Services

Understanding How MVS Handles Restart Processing

Designing Your Application to Use Automatic Restart Management Services

Registering as an Element (IXCARM REQUEST=REGISTER)

Specifying Restart Parameters

Parameter List Contents

Example of Using the IXCARM Macro

Sysplex Services for Data Sharing (XES)

Introduction to Sysplex Services for Data Sharing (XES)

Guide to Sysplex Services Topics

Connection Services

Overview of Connection Services

Authorizing Coupling Facility Requests

Structure Concepts

Allocating a Structure in a Coupling Facility

Specifying the Required Coupling Facility Attributes

Specifying the Structure Size

Selecting a Coupling Facility for Structure Allocation

Understanding Connectivity in a Mixed Sysplex Environment

Coupling Facility Considerations When Allocating a Structure

Understanding Coupling Facility Storage

Coupling Facility Resource Allocation â€œRulesâ€

Successful Completion of Structure Allocation

Note about designing structure connections

Connecting to a Coupling Facility Structure

Overview of Connect Processing

System-managed Processing Considerations

Selecting the Number of Data Elements and Their Size

Effect of CFLEVEL on MAXELEMNUM

Connecting to a List Structure

Selecting the Data Element Size

Effect of CFLEVEL on MAXELEMNUM

Connecting to a Lock Structure

Using the IXLCSP Service to Determine Structure Size or Attributes

Defining the Required Exit Routines

Handling Failed Attempts to Connect to a Structure

Using ENF Event Code 35

Structure Rebuild Processing

Role of CFRM Policy in the Rebuild Process

Rebuild Connectivity Requirements

User-Managed Rebuild Events and the Event Exit

XES Monitoring of Rebuild Event Responses

Starting the User-Managed Rebuild Process

Rebuild Quiesce Information Returned in IXLYEEPL

Responding to the Rebuild Quiesce Event

Completing Outstanding Structure Requests

Completing the Rebuild Quiesce Phase

Connecting to the New Structure

Working with Structures in the Duplex Established Phase

Stopping a Duplexing Rebuild to Forward Complete

Completing the User-Managed Rebuild Process

Stopping a User-Managed Rebuild Process

Providing a Response for a Failed Connector

Handling Loss of Connectivity during Duplexing Rebuild

Handling Structure Failure

Handling Connection Failure

MVS-Initiated Rebuild Processing

Role of CFRM in System-Managed Processing

MVS-Initiated Duplexing Rebuild

Events and the Event Exit for System-Managed Processing

XES Monitoring of Active Connector Event Responses

Starting the System-Managed Process

Establishing the New Structure in System-Managed Process

New Connections

IXLYCONA Contents when Connecting during the Duplex Established Phase

Disconnecting or Failed Connections

Handling Loss of Connectivity during System-Managed Processing

Altering a Coupling Facility Structure

Overview of Structure Alter Processing

Starting the Structure Alter Process

Completing the Structure Alter Process

Altering a Structure in the Duplex Established Phase

Detecting ENF Code 35 for Structure Alter

Handling New Connections during Alter Processing

Responding to Connection Events

Handling Outstanding Event Responses

Events Reported to the Event Exit

Using IXLUSYNC to Coordinate Processing of Events

Overview of IXLUSYNC Processing

Handling Connection Failures during Synchronization

Disconnecting from a Coupling Facility Structure

Persistence Considerations

Forcing the Deletion of a Coupling Facility Object

Coding Exit Routines for Connection Services

Coding the Event Exit

Macro Instructions and Restrictions

Parameter List Contents

Return Specifications

Using IXLEERSP

Using Cache Services (IXLCACHE)

Store-in Cache

Store-through Cache

Directory-only Cache

Changing a Data Item in the Cache Structure

Casting out Data or Updating Permanent Storage

Considerations for Cast-out Using the Store-in Cache Method

Considerations for Cast-out Using the Store-through Cache Method

Considerations for Cast-out Using the Directory-only Cache Method

Maintaining Data Consistency

Registering Interest in a Data Item and Validating Local Copies

Deregistering Interest in a Data Item and Invalidating Local Copies

Invalidating Local Cache Copies of a Data Item

Determining the Validity of a Data Item through IXLVECTR

Changing the Size of the Local Cache Vector

Serializing and Managing Access to Shared Data

Managing Cache Structure Resources

Storage Reclaim

Assigning and Using Storage Classes

Storage Reclaim Considerations and the Directory-only Cache Method

Managing Storage Reclaim for Specific Data Items

Using PROCESS_REFLIST Requests

Measuring Cache Structure Resource Usage

Understanding Synchronous and Asynchronous Cache Operations

Design Considerations for Defining Buffer Storage Areas

Defining Buffer Storage Areas for a WRITE_DATALIST Request

Determining Buffer Storage Ownership

Using Real Versus Virtual Storage

Receiving Information from a Request

Specifying the IXLYCAA Level

Determining Valid Information in the Answer Area

Using the Restart Token

Restarting Requests Multiple Times with Restart Tokens

Using an Index Value

Restarting Requests Multiple Times with Index Values

Understanding the Cache Data Entry Version Number

IXLCACHE Functions for REQUEST=WRITE_DATA

Registering Interest in the Data Item for WRITE_DATA Requests

Using the REGUSER Options

Scenario

Updating an Existing Data Item: Summary

WRITE_DATALIST:Writing Multiple Data Items to a Cache Structure

IXLCACHE Functions for WRITE_DATALIST

READ_DATA: Reading a Data Item from a Cache Structure

IXLCACHE Functions for REQUEST=READ_DATA

REG_NAMELIST: Registering Interest in a List of Data Items

IXLCACHE Functions for REQUEST=REG_NAMELIST

CASTOUT_DATA: Casting Out Data from a Cache Structure

Cast out and Unchanged Data

CASTOUT_DATALIST: Casting Out a List of Data Items

IXLCACHE Functions for REQUEST=CASTOUT_DATALIST

Understanding the Use of the Buffer Areas

UNLOCK_CASTOUT: Releasing Cast-Out Locks

IXLCACHE Functions for REQUEST=UNLOCK_CASTOUT

Releasing Cast-Out Locks: Summary

UNLOCK_CO_NAME: Releasing a Single Cast-Out Lock

IXLCACHE Functions for REQUEST=UNLOCK_CO_NAME

Releasing a Single Cast-Out Lock: Summary

DELETE_NAME: Deleting Data Items From a Cache Structure

IXLCACHE Functions for REQUEST=DELETE_NAME

Identifying Data Items to Delete

DELETE_NAMELIST: Deleting a List of Data Items

IXLCACHE Functions for REQUEST=DELETE_NAMELIST

CROSS_INVAL: Invalidating Other Users' Copies of Data Items

CROSS_INVALLIST: Invalidating a List of Data Items

IXLCACHE Functions for REQUEST=CROSS_INVALLIST

SET_RECLVCTR: Overriding or Restoring the Default Reclaim Algorithm

PROCESS_REFLIST: Marking Data Items as Referenced

IXLCACHE Functions for REQUEST=PROCESS_REFLIST

RESET_REFBIT: Marking Data Items as Unreferenced

IXLCACHE Functions for REQUEST=RESET_REFBIT

READ_DIRINFO: Reading Cache Directory Entries

IXLCACHE Functions for REQUEST=READ_DIRINFO

READ_COCLASS: Reading A Cast-Out Class

IXLCACHE Functions for REQUEST=READ_COCLASS

READ_COSTATS: Reading Cast-Out Class Statistics

IXLCACHE Functions for REQUEST=READ_COSTATS

READ_STGSTATS: Reading Storage Class Statistics

IXLCACHE Functions for REQUEST=READ_STGSTATS

Coding a Complete Exit for IXLCACHE

Registers at Entry:

Managing Cache Structure Utilization

Using List Services (IXLLIST)

List Structure Concepts

What is a List Structure?

List Structure Enhancements

Understanding List Entry Key Assignment

Available Options for Automatic List Entry Key Assignment

Understanding the List Cursor

Understanding List Structure Monitoring

Understanding the Event Queue

Understanding the List Authority Value

Using the IXLFCOMP Macro with MODE=ASYNCTOKEN or MODE=SYNCTOKEN

Understanding the Serialized List Structure

Overview of Locking Functions

Conditional and Unconditional Lock Requests

Understanding Lock Contention and the Notify Exit

Understanding the List Entry Version Number

Selecting the Buffer Format

Specifying the Buffer Storage Key

WRITE: Writing to a List Entry

Understanding the Write Operation

Receiving Answer Area Information from a WRITE Request

Determining if the Answer Area is Valid

READ, READ_MULT, READ_LIST: Reading List Entries

READ: Reading a Single List Entry

READ_LIST: Reading Multiple List Entries from a List

The Effect of List Changes on Request Resumption

Receiving Answer Area Information from a READ_LIST Request

READ_MULT: Reading Multiple List Entries from One or More Lists

MOVE: Moving a List Entry

Understanding the MOVE Operations

DELETE, DELETE_MULT, DELETE_ENTRYLIST: Deleting List Entries

DELETE: Deleting a Single List Entry

DELETE_MULT: Deleting Multiple List Entries

DELETE_ENTRYLIST: Deleting a List of Entries

READ_LCONTROLS: Reading List Controls

WRITE_LCONTROLS: Writing List Controls

LOCK: Performing a Lock Operation

MONITOR_LIST: Monitoring List Transitions

The List Notification Vector

Receiving Answer Area Information from a MONITOR_LIST Request

MONITOR_EVENTQ: Monitoring an Event Queue

MONITOR_SUBLIST, MONITOR_SUBLISTS: Monitoring Sublists

Receiving Answer Area Information from a MONITOR_SUBLISTS Request

READ_EMCONTROLS: Reading Event Monitor Controls

Receiving Answer Area Information from a READ_EMCONTROLS Request

READ_EQCONTROLS: Reading Event Queue Controls

DEQ_EVENTQ: Retrieving Events from the Event Queue

Coding a Complete Exit

Registers at Entry

Return Specifications

Programming Considerations

Circumstances a User Exit Should Be Prepared to Handle

Coding a Notify Exit

Registers at Entry

Return Specifications

Programming Considerations

Coding a List Transition Exit

Registers at Entry

Return Specifications

Programming Considerations

Managing List Structure Utilization

Enhancements to Sublist Monitoring

Using List Services (IXLLSTE, IXLLSTM, IXLLSTC)

Additional List Services Provided at OS/390 Release 9 and Higher

Comparing IXLLSTC, IXLLSTE, and IXLLSTM with IXLLIST

IXLLSTE: List Structure Single Entry Services

Selecting an Entry for Processing by IXLLSTE

Requesting Comparison Criteria when Creating a List Entry

Reading a List Entry

Requesting Comparison Criteria when Reading a List Entry

Deleting a List Entry

IXLLSTM: List Structure Multiple Entry Services

Selecting Entries for Processing by IXLLSTM

Deleting List Entries from Multiple Lists

Moving a List of List Entries

Deleting a List of List Entries

IXLLSTC: List Structure Control Services

Understanding Threshold Counts

Using Threshold Counts when Monitoring List State Transitions

Setting the Threshold Counts for List Monitoring

Using Threshold Counts when Monitoring a Range of Key Values

Using Lock Services (IXLLOCK)

Resource Concepts

What Can You Do in a Contention Exit?

Informing a User of Request Completion

Using the IXLLOCK MODE Parameter

Lock Structure Concepts

The Lock Table

Identifying a Lock Table Entry

Record Data Entries

Size Considerations for a Lock Structure

Recovery Considerations

Designing for Recovery

Sample Recovery Protocol - An Alternative

Requesting Lock Services

Return and Reason Codes

Return and Reason Codes

Return and Reason Codes

Processing Multiple Resource Requests (REQUEST=PROCESSMULT)

Processing a Lock Request Block

Determining the Completion of a PROCESSMULT Request

Using Exits for Coupling Facility Lock Services

General Requirements

Coding a Complete Exit

Coding a Contention Exit

Coding a Notify Exit

Using the Synchronous Update Service (IXLSYNCH)

Using the Lock Cleanup and Recovery Service (IXLRT)

Specifying the Level of Information

Supplementary List, Lock, and Cache Services

Using the IXLFCOMP Macro

Issuing IXLFCOMP During Recovery Processing

Purging a Coupling Facility Operation

Using the IXLVECTR Macro

List Notification Vector

Local Cache Vector

Using the TESTLOCALCACHE and LTVECENTRIES Requests with a Serialization Protocol

Using Note Pad Services (IXCNOTE)

Note pad concepts and terminology

What is a note

What is an XCF Note Pad

Note pad name

Timestamp when created

What is a connection

Termination scope

Using the IXCNOTE macro

XCF component failures

Note pad requests

Connection requests

Create connection

Using the CONNECTION keyword

Single note requests

Overview

Multi-note requests

Overview

Delete notes

Note pad related limits

Coupling Facility Accounting and Measuring Services

Using IXLMG

Dumping Services for Coupling Facility Structures

Using Component Data in the Dump Data Set

Associating Macros with the Data Types

Documenting your Coupling Facility Requirements

Specifying the Coupling Facility Structure Requirements

FOOTER

Go to the next page

Notices | Terms of use | Support | Contact z/OS | zFavorites

Copyright IBM Corporation 1990, 2014