Contents
Preface
What this book is about
Who this book is for
What you need to know to understand this book
How to use this book
Notes on terminology
Figures
Tables
FEPI concepts and facilities
Introducing FEPI
Problems FEPI can solve
Advantages over alternative solutions
How FEPI fits into your system
Planning for FEPI
Hardware and software requirements
System integrity
Storage
Installation
Configuration
FEPI functions and services
Introducing FEPI functions
Samples
FEPI programming commands
High-level FEPI commands
Data-stream-level commands
Specialized-level commands
List of commands
Setup and resources
FEPI resources
CICS FEPI application programs
Terminals supported
FEPI Security
Signon security
Command security
Problem determination, customization, and performance
Problem determination
Customization
Performance
FEPI installation and administration
Planning for FEPI
Analysis and planning
Back-end applications and systems
Names of nodes and targets
Operator control requirements
Journaling requirements
Signon and signoff procedures
Special event handling
Using pools for control reasons
Using pools for functional reasons
Number of nodes
Setup program organization
Organizing your pools and property sets
Organizing pools
Organizing property sets
Workload balancing in a sysplex
Planning FEPI storage
Getting started with FEPI
The installation process
A note about loading FEPI modules into the LPA
Updating CICS definitions
Installing FEPI resource definitions
Starting CICS
Configuring FEPI
CICS configuration
Setup-initialization program in PLT
VTAM configuration
Defining FEPI nodes to VTAM
Availability of network resources
Selection of FEPI session parameters
Pacing of FEPI sessions
Back-end system configuration
CICS
IMS
FEPI configuration
Writing configuration programs
Writing setup programs
Running setup programs
Varying the resources installed by the setup program
Sample FEPI configuration
Writing monitoring programs
Handling unexpected events
Handling CLSDST(PASS)
Writing operator transactions
Other functions
Global user exit programs
FEPI operation
Controlling FEPI resources
SERVSTATUS
ACQSTATUS
LASTACQCODE
INSTLSTATUS
WAITCONVNUM
STATE
FEPI performance
Using CICS monitoring and statistics
Shutdown
Normal shutdown
Immediate shutdown
Forced shutdown
Using FEPI with XRF
XRF and VTAM
FEPI resource definition and XRF
XRF takeover of front-end system
XRF takeover of back-end system
Using FEPI with VTAM persistent sessions
Restart of front-end system using persistent sessions
Restart of back-end system using persistent sessions
Operator control of FEPI
CEMT--master terminal transaction
CEMT DISCARD
CEMT INQUIRE FECONNECTION
CEMT INQUIRE FENODE
CEMT INQUIRE FEPOOL
CEMT INQUIRE FEPROPSET
CEMT INQUIRE FETARGET
CEMT SET FECONNECTION
CEMT SET FENODE
CEMT SET FEPOOL
CEMT SET FETARGET
CETR--trace control transaction
VTAM commands
Customizing FEPI
FEPI global user exits
XSZBRQ
XSZARQ
The UEPSZACT and UEPSZACN exit-specific parameters
Using XMEOUT to control message output
FEPI journaling
FEPI journal operation
Printing FEPI journal records
FEPI system programming reference
The FEPI SPI commands
Command format
Arguments and data types
Errors and exception conditions
Syntax notation
Translator options
INQUIRE and SET commands
Other points
FEPI ADD POOL
Function
Syntax
Options
Conditions
FEPI DELETE POOL
Function
Syntax
Options
Conditions
FEPI DISCARD NODELIST
Function
Syntax
Options
Conditions
FEPI DISCARD POOL
Function
Syntax
Options
Conditions
FEPI DISCARD PROPERTYSET
Function
Syntax
Options
Conditions
FEPI DISCARD TARGETLIST
Function
Syntax
Options
Conditions
FEPI INQUIRE CONNECTION
Function
Syntax
Options
Conditions
FEPI INQUIRE NODE
Function
Syntax
Options
Conditions
FEPI INQUIRE POOL
Function
Syntax
Options
Conditions
FEPI INQUIRE PROPERTYSET
Function
Syntax
Options
Conditions
FEPI INQUIRE TARGET
Function
Syntax
Options
Conditions
FEPI INSTALL NODELIST
Function
Syntax
Options
Conditions
FEPI INSTALL POOL
Function
Syntax
Options
Conditions
FEPI INSTALL PROPERTYSET
Function
Syntax
Options
Conditions
FEPI INSTALL TARGETLIST
Function
Syntax
Options
Conditions
FEPI SET CONNECTION
Function
Syntax
Options
Conditions
FEPI SET NODE
Function
Syntax
Options
Conditions
FEPI SET POOL
Function
Syntax
Options
Conditions
FEPI SET TARGET
Function
Syntax
Options
Conditions
FEPI SP NOOP
Function
Syntax
Options
Conditions
Transient data queue records
Fields
FEPI problem determination
Debugging FEPI applications
FEPI dump
Using CICS dump facilities to investigate FEPI problems
FEPI trace
Taking trace entries
Interpreting FEPI trace entries
FEPI messages
FEPI abends
Restart
Message DFHSZ4099E
Message DFHSZ4155I
Reporting a FEPI problem to IBM
FEPI application programming
Basics of FEPI programming
Communication and conversations
Structure and design
Programming
FEPI key stroke and screen-image applications
General sequence of commands
Sending key stroke data
Errors
Receiving field-by-field
Command completion
Errors
Multiple attentions
Sending screen-image data
Errors
Receiving screen-image data
Command completion and errors
Extracting field data
CONVERSE
Errors
FEPI data stream applications
When to use the data stream interface
General sequence of commands
Receiving
Command completion
Errors
Sending
Errors
CONVERSE
SLU2 mode considerations
SLU P mode considerations
FEPI application design
Programs
Access program
Begin-session handler
Unsolicited-data handler
End-session handler
Application organization
Application style
Started tasks
Conversations
Signon security
How to use PassTickets
Benefits
Requirements
Error handling
Time-outs
Lost session
Previous SEND failed
Communication errors
Bypass by user exit
Unknown conversation ID
Operator/system action
Shutdown
System considerations
IMS considerations
Performance
Specialized FEPI functions
Set and test sequence number (STSN)
DRx responses
SNA commands
FEPI application programming reference
The FEPI API commands
Command format
Arguments and data types
Errors and exception conditions
Syntax notation
Translator options
Other points
FEPI ALLOCATE PASSCONVID
FEPI ALLOCATE POOL
FEPI AP NOOP
FEPI CONVERSE DATASTREAM
Previously allocated conversation
Temporary conversation
FEPI CONVERSE FORMATTED
Previously allocated conversation
Temporary conversation
FEPI EXTRACT CONV
FEPI EXTRACT FIELD
FEPI EXTRACT STSN
FEPI FREE
FEPI ISSUE
FEPI RECEIVE DATASTREAM
FEPI RECEIVE FORMATTED
FEPI REQUEST PASSTICKET
FEPI SEND DATASTREAM
FEPI SEND FORMATTED
FEPI START
Start data
Fields
Data formats
Outbound data
Inbound data
Ending status
Appendixes
Appendix A. FEPI sample programs
What you get
COBOL II Sample Restrictions
Installing the samples
The CICS front-end samples
The CICS and IMS back-end samples
Using the samples
The back-end CICS program
The back-end IMS program
Description of the samples
Setup
Monitor and unsolicited data-handler
Begin session
Key stroke CONVERSE
Screen image SEND and START
Screen image RECEIVE and EXTRACT FIELD
3270 data stream pass-through
End-session handler
SLU P one-out one-in
SLU P pseudoconversational
STSN handler
Appendix B. CVDA and RESP2 values for FEPI commands
CVDAs and numeric values in alphabetic sequence
CVDAs and numeric values in numeric sequence
RESP2 values
Bibliography
The CICS Transaction Server for z/OS library
The entitlement set
PDF-only books
Other CICS books
Accessibility
Index
Notices
Programming interface information
Trademarks
[[
Contents
Previous Page
|
Next Page
Index
]]