Contents
Preface
What this book is about
How to use this book
What you need to know to understand this book
Notes on terminology
Figures
Tables
Overview of CICS external interfaces
Interfaces to CICS transactions and programs
The Client/Server concept
Distributed computing
Security support
TCP/IP protocols
TCP/IP internet addresses and ports
ONC and DCE concepts
DCE
EXCI concepts
3270 bridge concepts
The 3270 Bridge and FEPI
Bridging to 3270 transactions
Introduction to the 3270 bridge
The Link3270 bridge mechanism
The bridge facility
Lifetime of the bridge facility
The application data structure (ADS)
The ADS descriptor (ADSD)
Link3270 programming considerations
Transaction Routing considerations
Allocating a bridge facility name for a pseudoconversation when using the Link3270 bridge for transaction routing
Using the Link3270 bridge
Establish Link3270 suitability
Using the Load Module Scanner Utility
Using the 3270 Bridge Passthrough SupportPak
Writing the Link3270 client
Select Link3270 client scenarios
Analyze the 3270 application
Select operation mode
Using Link3270 messages
Inbound BRIV vectors
Outbound BRIV vectors
Link3270 bridge basic and extended support
Copybooks and default vectors
Using Link3270 single transaction mode
Updating data length fields
Using Link3270 session mode
How to create a message
Allocating a bridge facility
Running transactions
Deleting a bridge facility
Delivering large messages
Recovery from connection failure
Validity of Link3270 requests
Calling the Link3270 bridge
Calling Link3270 using LINK
Calling Link3270 using EXCI
Calling Link3270 using ECI
Multiple Router regions
Using data conversion with Link3270
Converting BRIH and BRIV header data
Converting RETRIEVE data
Converting User data
Managing the Link3270 bridge environment
Defining Link3270 SIT parameters
Defining the bridge facility
Defining the facilitylike
Defining the bridge facility name
Defining a specific bridge facility name
Initializing the TCTUA
Accessing bridge facility properties
Managing Link3270 bridge resources
INQUIRE/SET AUTOINSTALL with the Link3270 bridge
INQUIRE/SET BRFACILITY with the Link3270 bridge
INQUIRE TASK with the Link3270 bridge
INQUIRE/SET TRACETYPE with the Link3270 bridge
INQUIRE TRANSACTION with the Link3270 bridge
XPI commands for the Link3270 bridge
Using Link3270 bridge load balancing
Using the dynamic transaction routing program with Link3270
Link3270 message formats
Link3270 message header (BRIH)
Inbound BRIH message header
Outbound BRIH message header
Inbound Link3270 vectors
Link3270 inbound vector header
Link3270 INPUT CONVERSE vector
Link3270 RECEIVE vector
Link3270 RECEIVE MAP vector
Link3270 RETRIEVE vector
Outbound Link3270 vectors
Link3270 output vector header
Link3270 ISSUE ERASEAUP vector
Link3270 SEND vector
Link3270 SEND CONTROL vector
Link3270 SEND MAP vector
Link3270 SEND TEXT vector
Link3270 SEND PAGE vector
Link3270 PURGE MESSAGE vector
Link3270 SYNCPOINT vector
Link3270 CONVERSE request vector
Link3270 RECEIVE request vector
Link3270 RECEIVE MAP request vector
Link3270 ADS descriptor
ADS descriptor header
ADS field descriptor
Link3270 diagnostics
BRIH-RETURNCODE values
Using the Link3270 samples
The NACT transaction
Running the sample client programs
Setup the Link3270 environment
Setup for the CICS-based clients
Setup for OS/390 based client
Setup for the workstation client
Setup for the NACT transaction
External CICS Interface
Introduction to the external CICS interface
Overview
The EXCI programming interfaces
Choosing between the EXEC CICS and the CALL interface
Illustrations of the external CICS CALL interface
Illustration of the EXCI EXEC CICS interface
Resource recovery
Using RRMS with the external CICS interface
Taking a syncpoint in the client program
Requirements for the external CICS interface
The EXCI CALL interface
The EXCI CALL interface commands
Initialize_User
Allocate_Pipe
Open_Pipe
DPL_Request
Close_PIPE
Deallocate_Pipe
EXCI call response code values
Return area for the EXCI CALL interface
Return area and function call EQUATE copybooks
Return codes
Dpl_retarea return codes
Example of EXCI CALLs with null parameters
The EXCI EXEC CICS interface
Using EXEC CICS LINK command
Retries on an EXEC CICS LINK command
Translation required for EXEC CICS LINK command
Defining connections to CICS
CONNECTION resource definition for EXCI
SESSIONS resource definitions for EXCI connections
Inquiring on the state of EXCI connections
The EXCI user-replaceable module
Using the EXCI options table, DFHXCOPT
Compiling and link-editing EXCI client programs
Job control language to run an EXCI client program
CICS-supplied procedures for the EXCI
EXCI programming considerations
PL/I considerations
C considerations
Setting the return code (R15) at termination
Using EXCI sample application programs
Description of the sample applications
Installing the EXCI sample definitions
Running the EXCI sample applications
Results of running the EXCI sample applications
EXCI security
Using MRO logon and bind-time security
Defining DFHAPPL FACILITY class profiles for an EXCI region
Link security
User security
Surrogate user checking
Problem determination
Trace
Formatting GTF trace
Using System dumps
Formatting system dumps
Capturing SYSMDUMPs
Using the MVS DUMP command at the console for dumps
MVS 04xx abends for the external CICS interface
The EXCI service trap, DFHXCTRA
Problem determination with RRMS
EXCI trace entry points
Response and reason codes returned on EXCI calls
Reason code for response: OK
Reason codes for response: WARNING
Reason codes for response: RETRYABLE
Reason codes for response: USER_ERROR
Reason codes for response: SYSTEM_ERROR
Messages and Codes
CICS ONC RPC support
Introduction to ONC RPC
ONC RPC concepts
RPC
ONC
TCP/IP
ONC RPC facilities
XDR routines
RPCGEN compiler
ONC RPC API library
ONC RPC naming and routing
Procedure zero
Registration and the Portmapper
Routing
Types of remote procedure call
CICS ONC RPC concepts
ONC RPC remote procedures and CICS programs
Where the CICS program might be
CICS ONC RPC transactions
Connection manager (CRPC)
Server controller (CRPM)
Alias (CRPA)
CICS ONC RPC user-replaceable programs
XDR routines
Resource checker module
Converters
CICS ONC RPC control flow
Updating recoverable resources
CICS ONC RPC data flow
From client to CICS program
Data format in the CICS program communication area
From CICS program to client
Setting up CICS ONC RPC
CICS ONC RPC setup tasks
Creating the CICS ONC RCP data set
JCL entry for dump formatting
Migrating between CICS versions
Modifying TCP/IP for MVS data sets
Defining CICS ONC RPC resources to CICS
Transaction definitions for CICS ONC RPC transactions
Transaction definitions for extra alias transactions
Program definitions for CICS ONC RPC programs
Program definitions for user-written programs
Mapset definition
Transient data definitions
XLT definitions
Configuring CICS ONC RPC using the connection manager
Starting the connection manager
Using the connection manager BMS panels
Starting the connection manager when CICS ONC RPC is disabled
Starting the connection manager when CICS ONC RPC is enabled
Updating CICS ONC RPC status
Changing the CICS ONC RPC status
Enabling CICS ONC RPC
Setting and modifying options
Validating, saving, and activating options
When CICS ONC RPC is enabled
Defining, saving, modifying, and deleting 4-tuples
Defining the attributes of a 4-tuple
Saving new 4-tuple definitions
Modifying existing 4-tuple definitions
Deleting existing 4-tuple definitions
Registering the 4-tuples
Limits on registration
Unregistering 4-tuples
Unregistering 4-tuples one by one
Unregistering 4-tuples from a list
Disabling CICS ONC RPC
On CICS normal shutdown
On CICS immediate shutdown
Updating the CICS ONC RPC data set
Updating the CICS ONC RPC definition record
Working with a list of 4-tuples
Changing the attributes of a 4-tuple
Processing the alias list
Programming with CICS ONC RPC
Developing an ONC RPC application for CICS ONC RPC
Step 1--Decide what data is to be sent
Step 2--Decide the format of the communication area
Step 3--Write the XDR routines
Step 4--Write the converter
Step 5--Write a resource checker
Step 6--Compile and link
Step 7--Make CICS definitions
Step 8--Make a connection manager entry
Write theCICS ONC RPC converter
Tasks that can be performed by a converter
Organizing the converter
Writing a converter in C
Writing a converter in COBOL
Using converters
Reference information for the converter functions
Getlengths
Decode
Encode
CICS ONC RPC security
Security in ONC RPC
Security in CICS and its effect on CICS ONC RPC operations
Using RACF Secured Sign-on
Writing the resource checker
Reference information for the resource checker
CICS ONC RPC problem determination
CICS ONC RPC recovery procedures
CICS ONC RPC operational considerations
MVS task control blocks (TCBs) used by ONC RPC
ONC RPC task-related user exit (TRUE)
Troubleshooting CICS ONC/RPC
Defining the problem
Documentation about the problem
Using messages and codes for ONC RPC
CMAC (online help facility for messages and codes)
CICS ONC RPC trace information
Feature trace points
Numeric values of response and reason codes
ONC RPC dump and trace formatting
Debugging the ONC RPC user-replaceable programs
XDR routines
Converter and resource checker
CICS ONC RPC performance and tuning
Using CICS as a DCE server
Introduction to the Distributed Computing Environment
What is DCE?
Remote procedure call (RPC)
Directory Service
Security Service
Time Service
File Service
Threads
DCE remote procedure calls
Overview of DCE with CICS
DCE terminology
What CICS server programs can do
What you need for DCE RPC to a CICS server
Defining CICS programs as DCE servers
Application programming for DCE remote procedure calls
Appendixes
Appendix. Routing program-link requests
Static routing
Dynamic routing
Bibliography
The CICS Transaction Server for z/OS library
The entitlement set
PDF-only books
Other CICS books
Accessibility
Index
Notices
Trademarks
[[
Contents
Previous Page
|
Next Page
Index
]]