z/OS BDT Installation
Previous topic |
Next topic
|
Contents
|
Contact z/OS
|
Library
|
PDF
Contents (exploded view)
z/OS BDT Installation
SC14-7582-00
About This Book
Who Should Read This Book
How to Use This Book
Related Reading
Syntax Conventions Used in This Book
z/OS Version 2 Release 1 summary of changes
Introduction
Planning Your Configuration
Defining BDT to MVS
Defining BDT to VTAM
Allocating BDT and TQI Data Sets
Formatting TQI Data Sets
Creating a BDT Initialization Stream
Writing BDT and TQI Start Procedures
Writing User Exit Routines
Planning Your Configuration
Step 1. Plan Global and Local Relationships (File-to-File Customers Only)
Global-local relationships in a central hub network
Global-local relationships in a decentralized network
The effect of global-local relationships on users
Step 2. Plan the Use of TQI
What TQI Does
TQI Prevents Loss of User Requests
TQI Routes BDT Messages to Users
The data sets that TQI uses
Example of TQI flow—TQI and BDT in the same processor
Example of TQI flow—TQI and BDT in different processors
Running without TQI
Step 3. Decide whether to have a poly-BDT complex
Defining BDT to MVS
Step 1. Define BDT As an MVS Secondary Subsystem—SYS1.PARMLIB Member IEFSSNxx
Step 2. Specify MVS System Parameters—SYS1.PARMLIB Member IEASYSxx
Step 3. Authorize SYS1.SBDTLIB
Step 4. Authorize SYS1.MIGLIB
Step 5. Define BDT to JES3 (JES3 Customers Only)—CONSOLE, SYSID, and NJERMT Statements
Defining BDT to VTAM
Step 1. Define a Node for File-to-File Transfers—APPL Definition Statement
Step 2. Define a Node for SNA NJE Transfers—APPL Definition Statement
Step 3. Define Remote Nodes as Cross-Domain Resources—CDRSC Definition Statement
Step 4. Define File-to-File Session Parameters—Logon Mode Table
Step 5. Define SNA NJE Session Parameters—Logon Mode Table
Allocating BDT and TQI Data Sets
Step 1. Allocate a Data Set for the BDT Initialization Stream
Step 2. Allocate a Data Set for the BDT Work Queue
Step 3. Allocate a System GMJD Library (File-to-File Customers Only)
Step 4. Allocate ISPF Data Sets (File-to-File Customers Only)
ISPF Version 3
Other Considerations
Step 5. Allocate the TQI Checkpoint Data Set
Step 6. Allocate the TQI Bit-Map Data Set
Step 7. Allocate Message Data Sets
Formatting TQI Data Sets
Step 1. Format the TQI Checkpoint, Bit-Map, and Message Data Sets
Creating a BDT Initialization Stream
How Many Initialization Streams Should You Have?
The IBM-Supplied Initialization Streams
Rules for coding initialization statements
Place Comments in the Initialization Stream
BDTNODE—Define Characteristics of a Home File-to-File Node
BDTNODE—Define Session Characteristics between Home and Remote Nodes
CELLPOOL—Allocate Cell Pools
DYNALLOC—Dynamically Allocate BDT Data Sets
ENDINIT—End the Initialization Stream
ENDRBAM—Mark the End of Definitions So Far
OPTIONS—Define Operating Characteristics of the BDT Subsystem
SNABUF—Define Data Buffers
SYSID—Name the Home Node
Initialization Statement Parameters That the Operator Can Override
Writing BDT and TQI Start Procedures
Step 1. Write a BDT Start Procedure
Step 2. Write a TQI Start Procedure
Writing User Exit Routines
Step 1. Understand Which Authorization Exit Routines You Must Write
Authorization Exit Routine in the Link Pack Area
Authorization Exit Routines in the BDT Address Space
Authorization Exit Routine in the JES3 Address Space
Step 2. Decide Whether You Want to Write Customization Exit Routines
Exit Routines to Alter Initialization
Exit Routines to Alter Message Processing
Exit Routines to Alter Transaction Processing
Exit Routines to Alter Command Processing
Exit routines to recognize user-defined BSIDMOD fields
Step 3. Code Your Exit Routines
General Considerations When Writing BDT Exit Routines
How exit routines are invoked
Names of Modules That Invoke the Exit Routines
Using Text Units to Customize BDT Transaction Processing
A Short Cut for Testing BDT
How Authorization Exit Routines Fit into the Flow in a BDT File-to-File Subsystem
BDT Request Routing
How Requests Enter a BDT File-to-File Subsystem
BDT Requests from a TSO Terminal
BDT Requests from a Batch Job
BDT Requests from an MCS Console
BDT Requests from a JES3 Console
Checkpointing requests in BDT TQI
Routing from BDTSSBDT to the BDT address space
Routing of a file-to-file transaction
Routing of a Command
Step 4. Assemble Your Exit Routines
Step 5. Link-Edit Your Exit Routines
Exit Routines That Will Run in the Link Pack Area
Exit Routines That Will Run in the JES3 Address Space
Exit Routines That Will Run in the BDT Address Space
Step 6. Load Your Exit Routines
Loading Exit Routines into the Link Pack Area
Loading Exit Routines into the BDT Address Space
Loading Exit Routines into the JES3 Address Space
User Exit Routine Reference
BDTUX01—BDT Initialization and Termination Processing
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX01 Is Not Used?
BDTUX02—Unrecognized Spool Data Management (RBAM) Initialization Statements
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX02 Is Not Used?
BDTUX03—Unrecognized BDT Network Initialization Statements
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX03 Is Not Used?
BDTUX04—Unrecognized Keywords on BDTNODE Statements for File-to-File Nodes
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX04 Is Not Used?
BDTUX05—BDTNODE Statement Keyword Processing for File-to-File Nodes
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX05 Is Not Used?
BDTUX06—BDT Post-Initialization Processing
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX06 Is Not Used?
BDTUX07—User-Defined Parameters on the MSGCLASS Keyword of File-to-File Transactions
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX07 Is Not Used?
BDTUX08—User-Defined File-to-File Transaction Keywords
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX08 Is Not Used?
BDTUX10—Command Password Processing
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX10 Is Not Used?
BDTUX11—Unrecognized BSID Modifier
Type
General Description
Register Conventions on Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX11 Is Not Used?
BDTUX12—BDT Message Routing
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX12 Is Not Used?
BDTUX14—BDT User-Defined XOID Type Conversion
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX14 Is Not Used?
BDTUX15—Unrecognized Parameters on PARMS Keyword
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX15 Is Not Used?
BDTUX16—BDT Job Message Log
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX16 Is Not Used?
BDTUX17—BDT Job Start
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX17 Is Not Used?
BDTUX18—BDT Job Termination
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX18 Is Not Used?
BDTUX19—File-to-File Transaction Modification
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
Programming Notes
What If BDTUX19 Is Not Used?
BDTUX24—Monitoring and Modifying the Type 59 SMF Record
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX24 Is Not Used?
BDTUX25—Entry Level Authorization in the BDT Address Space
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX25 Is Not Used?
BDTUX26—Global Node Level Authorization
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX26 Is Not Used?
BDTUX27—Node Level Authorization
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX27 Is Not Used?
BDTUX28—MCS Console Authorization
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX28 Is Not Used?
BDTUX29—Initial Authorization of TQI-Enabled Transactions
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX29 Is Not Used?
BDTUX30—Dynamic Deallocation
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX30 Is Not Used?
BDTUX31—INQUIRY and MODIFY Command Authorization
Type
General Description
Register Conventions at Entry
Register Conventions at Exit
Operation
Environment
Data Areas
What If BDTUX31 Is Not Used?
Mapping Macro Reference
BDTDBSID
BDTDCNS
BDTDDATU
BDTDGSD
BDTDINT
BDTDJCT
BDTDLCT
BDTDMJD
BDTDREG
BDTDRLT
BDTDSEQ
BDTDSMF
BDTDTVT
BDTDXOID
Executable Macro Reference
BDTDKYWD
BDTDTUD
BDTXASRV
BDTXJCT
BDTXJQE
BDTXTRC
BDTXTUAM
Parameter map
Virtual Storage Required for the BDT Address Space
Moving Transactions to a New TQI Checkpoint Data Set
SNALINE Statement (File-to-File Feature Only)
Initialization Flow and User Exit Routines
Flow diagram for initialization exits
Internal to External Conversion of the XOID Format
External to internal conversion of the XOID format
Flow diagram for the invocation of BDTUX17 (job start)
Flow diagram for the invocation of BDTUX18 (job end)
Modules That Issue the BDTXXOID Macro
Sample User Exit Routine
Assembler Code for Sample Routine
GLOSSARY
Copyright IBM Corporation 1990, 2014