Note
About This document
Who Should Use This document
How to Use This document
Where to find more information
How to send your comments to IBM
z/OS Version 2 Release 1 summary of changes
Introduction to the JES Common Coupling Services
Your Installation's Goals - Do You Need to Use JES XCF Component Services?
JES benefits from the use of the common coupling services component
How You Can Affect JES Message Processing
Basic JES XCF Terms and Concepts
Providing Security for JES XCF
Macro Overview
Exit Overview
Using the JES XCF exits and macros
JES and JES XCF Processing Overview
JES initialization processing
JES message processing
JES Termination Processing
Detach processing
Using JES XCF Services
The JES-Defined Attachment to JES XCF
Determining If You Should Use the JES-Defined Attachment
Retrieving the JES XCF Group Token
Creating an Installation-Defined Attachment to JES XCF (IXZXIXAT Macro)
Building a Mailbox (IXZXIXMB Macro)
Mailbox Availability
Identifying the Installation-Written POST Exit Routine
Requesting XCF Event Monitoring
Sending a Message (IXZXIXSM Macro)
Recovery levels
Sending an Asynchronous Message Without Acknowledgement or Recovery
Sending an Asynchronous Message With Acknowledgement
How to Associate an Acknowledgement with the Original ASYNCACK Message
Sending an Asynchronous Message Without Acknowledgement
Sending a Synchronous Message
Identifying Which Mailbox is to Receive the Acknowledgement
Message Segments
Sending a Single-Segment Message
Sending a Multi-Segment Message
Discontinuing a Request to Send a Multi-Segment Message
When a Sender Requires an Acknowledgement of a Multi-Segment Message
Providing a Place for Data Returned from the Message Receiver
Identifying Which Member is to Receive the Message
Restrictions and IBM Recommendations
Receiving a Message (IXZXIXRM Macro)
Mapping Messages
Restrictions
Acknowledging Receipt of a Message (IXZXIXAC Macro)
Obtaining information about JES members in the XCF group (IXZXIXIF macro)
Collecting JES3 Performance Information Data (IXZXIXPI Macro)
Indicating that System Cleanup is Complete (IXZXIXCL Macro)
Clearing a Mailbox of Messages (IXZXIXMC Macro)
Deleting a Mailbox (IXZXIXMD Macro)
System Return and Reason Codes When Messages are Undelivered
What Happens to Mailboxes When the JES Session Ends
Detaching from a JES XCF Group (IXZXIXDT Macro)
Component trace and diagnostic support
Controlling the Quantity of Traced Data
Obtaining Trace Data
Module Footprint Tracing (FLOW Sub-Level)
XCF and JES XCF Event Tracing (XCFEVT Sub-Level)
Detailed Message Tracing (MSGTRC Sub-Level)
Installation Exit Tracing (USRXIT Sub-Level)
Ending and Restarting the JESXCF Address Space
Coding the JES XCF exits
Creating Your Own Attachment to JES XCF
Determining Your Need to Create Your Own JES XCF Attachment
Defining a JES XCF Group
Using the JES XCF exits
IXZXIT01 - Transport Exit
Installing the Exit Routine
Exit Routine Environment
Exit Recovery
Exit routine processing
Changing a Message Destination
Rerouting an Acknowledgement
Changing the Message Content
Appending message extents
Processing Multi-Segment Messages
Programming Considerations
Entry Specifications
Registers at Entry
Parameter List Contents
Base Section
Exit-Specific Section
Message Extent Section
Return Specifications
Registers at Exit
Return Code Meanings
Coded Example of Exit Routine
IXZXIT02 - Receive Exit
Installing the Exit Routine
Exit Routine Environment
Exit Recovery
Exit routine processing
Rerouting an Acknowledgement for ASYNCACK Messages
Changing the Message Content
Retrieving an Appended Message Extent
Programming Considerations
Entry Specifications
Registers at Entry
Parameter List Contents
Base Section
Exit-Specific Section
Message Extent Section
Return Specifications
Registers at Exit
Return Code Meanings
Coded Example of Exit Routine
IXZXIT03 - Attach/Detach Exit
Installing the Exit Routine
Exit Routine Environment
Exit Recovery
Exit Routine Processing
Attach processing
Detach processing
Obtaining Storage During Attach Processing
Freeing Storage During Detach Processing
Example of Managing a Piece of Storage
Programming Considerations
Entry Specifications
Registers on Entry
Parameter List Contents
Base Section
Exit-Specific Section
Return Specifications
Registers at Exit
Return Code Meanings
Coded Example of Exit Routine
JES XCF macro reference
How to Read a Syntax Diagram
Controlling Macro Expansion Printing
IXZXIXAC - acknowledge receipt of a message
IXZXIXAT - Attach to a JES XCF Group
IXZXIXCL - System Cleanup Initiated Indicator
IXZXIXDT - Detach from a JES XCF Group
IXZXIXIF - obtain information about members of an XCF group
IXZXIXMB - Build a mailbox
IXZXIXMC - Clear a Mailbox
IXZXIXMD - Delete a Mailbox
IXZXIXPI - Collect JES3 Performance Information Data
IXZXIXRM - Receive a Message
IXZXIXSM - Send a Message
POST Exit Routine
Installing the Exit Routine
Exit Routine Environment
Exit Recovery
Exit Routine Processing
Programming Considerations
Entry Specifications
Registers at Entry
Parameter List Contents
Return Specifications
Registers at Exit
Return Code Meanings
Accessibility
Notices
Programming Interface Information
Trademarks