Table of Contents (exploded view)
Abstract for MVS Planning: APPC Management
z/OS Version 2 Release 1 summary of changes
Introduction
Introduction to APPC/MVS
APPC Overview
How APPC Relates to SNA, LU 6.2, VTAM, and CPI-C
APPC Concepts and Commonly Used Terms
Programming Terms
Network Terms
What is APPC/MVS?
Programming Support for APPC/MVS Callable Services
Administrative System Files
Use of TP Profile and Side Information for a Scheduled Conversation
Use of Side Information for an APPC/MVS Server
z/OS System Support
Specific APPC/MVS Support
Overview of an APPC/MVS Outbound Request
Overview of an APPC/MVS Inbound Request
Planning Overview
Levels of Connections
Physical Connections
Program Connections
Logical Connections and APPC/MVS Management
APPC Management Tasks
System-Wide APPC Connections
Program management
Scheduling Transaction Programs
Overview of Transaction Scheduling
Scheduling Characteristics of the APPC/MVS Transaction Scheduler
Using the APPC/MVS Transaction Scheduler
Classes of Transaction Initiators
DISPLAY Command
TP Schedule Types
Standard Schedule Type
Multi-Trans Schedule Type
Multi-Trans Processing
SMF Accounting of Multi-Trans Resources
Security for Multi-Trans TPs
SYSOUT Processing for Multi-Trans TPs
Assigning Multi-Trans TPs to their own Class
Establishing a Multi-Trans TP that is Always Available
Logging Transaction Program Processing
The TP Message Log
Deciding Which TP Message Log Values to Use
Selecting the Type of Message Log
Choosing a Value for the MSGLIMIT Parameter
Example of Using TP Message Log Parameters
Viewing the TP Message Log During TP Run Time
Defining Scheduling Characteristics with ASCHPMxx
ASCHPMxx Parmlib Member
Changing Values
Using Default Values
Planning Specific Values
Defining a Class — CLASSADD Statement
Example of defining a class
Modifying a Class — CLASSADD Statement
Example of modifying a class
Deleting a Class — CLASSDEL
Example of deleting a class
Defining Default Options — OPTIONS
Example of Defining a Default Class
Defining Default Scheduler Options — TPDEFAULT
Example of Defining Scheduling Defaults
Examples ssing ASCHPMxx Parmlib members
Tracking Changes in Scheduling Definitions
Keeping a Hardcopy Log
Viewing the current scheduling configuration
Controlling the Execution of Transaction Programs
Determining Scheduling Characteristics
Defining the VSAM Key Sequenced Data Sets (KSDS)
Determining How Many Files to Define
Determining the Size of Each File
Side Information File
TP Profile Files for the APPC/MVS Transaction Scheduler
TP Profile Files for Non-APPC/MVS Transaction Schedulers
Using Database Tokens for File Security
Creating a TP Profile
TP Profile Key
Program Attributes Section
Transaction Scheduler Section
Summary of TP Profile Keywords
Creating Side Information
Example of Side Information
Summary of Side Information Keywords
Defining TP Profiles and Side Information Early
Specific Scheduler JCL Information for TP Profiles
SYSOUT Recommendations
JCL Size Restrictions
Unsupported Statements and Restrictions
Restrictions on &SYSUID Variable
Data Set Naming Restrictions
JOB Statement Restrictions
EXEC Statement Restrictions
DD Statement Restrictions
OUTPUT Statement Restrictions
PROCLIB Restrictions
Using the APPC/MVS Administration Utility
Utility Commands
TP Profile Commands
Side Information Commands
Database Token Commands
Syntax Requirements
Syntax Rules
Invoking the APPC/MVS Administration Utility
Invoking the APPC/MVS Administration Utility from a Batch Job
Parameters
Invoking the APPC/MVS Administration Utility from an Application Program
Invoking the APPC/MVS Administration Utility from a REXX Program
Restrictions on Invoking the APPC/MVS Administration Utility
Return Codes
Examples
Using the APPC/MVS Administration Dialog
Overview of the Dialog
TP Profile Administration
Side Information Administration
Database Token Administration
How to Use the Dialog
Using a Command Line
Using PF Keys
Using Input Fields
Receiving Messages and Getting Help
Installing the Dialog
Installing the Dialog under Application Manager
Installing the Dialog from ISPF
Customizing the Dialog
Session management
Planning Sessions
Determining the Number of Local LUs
Defining the System Base LU
Naming LUs
Using Network-Qualified Names Support
Deciding When to Use Network-Qualified Names
Defining LUs to Support Network-Qualified Names
Displaying APPC/MVS Information
Assigning a VTAM Generic Resource Name to APPC/MVS LUs
Deciding which APPC/MVS LUs should be Members of a Generic Resource Group
Distributing Session Workload
The Simplest Approach
Alternative Configurations
Defining LUs to a Generic Resource Group
Displaying APPC/MVS Information for LUs in a Generic Resource Group
Diagnosing Errors Involving LUs in a Generic Resource Group
Setting Up a Session for APPC/MVS
Defining a Local LU on MVS
Defining an APPC Logon Mode
Defining the Local LU to VTAM
VTAM APPL Statement Parameters
APPC Configuration in VTAM
Defining a Partner LU on the Same MVS System
Defining a Partner LU on a Peer System
Providing the Logon Mode Name to Applications
Customizing Sessions for APPC/MVS
Defining Additional Logon Mode Entries
Specifying a Logon Mode for a Conversation
Using APPC/MVS Protected Conversations Support
LU Capability and Mode Name Restrictions
Defining APPC/MVS LUs as Syncpoint Capable
Syncpoint Capabilities Supported by APPC/MVS
Defining a Log Stream for APPC/MVS
Determining the Size of Each Coupling Facility Structure
Develop a Naming Convention for System Logger Resources
Considerations when using the APPC LOGGING keyword
Plan DASD Space for System Logger
Managing Log Data: How Much? For How Long?
Define Authorization to System Logger Resources
Managing APPC/MVS Resources for Protected Conversations
Displaying Information
Changing the APPC/MVS Configuration or Workload
Resolving Error Conditions
RRS failures or other errors
Logging failures detected during LU initialization or restart
Errors that prevent log name exchange from completing successfully
Warm/cold log status mismatch
Log name mismatch
Obtaining Diagnostic Information
Controlling Configuration through APPCPMxx
APPCPMxx Parmlib Member
Changing Values
Default Values
Planning Specific Values
Adding a Local LU — LUADD Statement
Example of Adding LUs
Modifying a Local LU — LUADD Statement
Examples of Modifying an LU
Deleting a Local LU — LUDEL Statement
Examples of Deleting an LU
Specifying a VSAM KSDS for Side Information — SIDEINFO Statement
Examples Using APPCPMxx Parmlib Members
Initial APPC Setup
Anticipated Modifications
Deletions
Tracking Changes in the Configuration
Keeping a Hardcopy Log
Viewing the Current Configuration
Security management
Setting up Network Security
APPC/MVS Security Requirements
Giving the APPC and ASCH Started Procedures Access to Resources
Why Security for APPC?
An APPC Application Example
Planning for APPC Security
Determining the Application's Security Type
LU Security Mechanisms
Conversation Security Mechanisms
LU Security: Protecting APPC/MVS Logical Units
Coding Security Keywords on the VTAM APPL Statement
Specifying the Level of Conversation Security for VTAM
Requesting that VTAM Verify Partner LUs
Defining LU-to-LU Access Authority with RACF APPCLU Profiles
Defining LU-to-LU Access Authority for a Specific LU
Defining LU-to-LU Access Authority for LUs in a VTAM Generic Resource Group
Defining LU-to-LU Session Keys
Defining Conversation Security Levels that Sessions Allow
Activating RACF Protection with APPCLU Profiles
Controlling the Use of VTAM ACBs
Conversation Security: Protecting APPC/MVS TPs
Establishing a Security Environment for Inbound TPs on MVS
Controlling User Access to LUs
Granting Access to Only Specific Users or Groups
Prohibiting Security_None Allocate Requests
Controlling User Access to LUs in a VTAM Generic Resource Group
Using RACF Variables for the APPL Class
Controlling User Access from LUs
Controlling User Access to TP Profiles and Side Information on MVS
Giving Program Access to the APPC/MVS Administration Utility
Controlling Access to Database Tokens
Controlling User Access to Side Information
Controlling User Access to TPs
Defining RACF APPCTP Profiles
Permitting Access to RACF APPCTP Profiles
Understanding Access Checking of an Inbound Allocate Request for a TP
Protecting Multi-Trans TP Profiles
Protecting the Generic User ID at Installation Time
Granting the Appropriate Level of Access to a Multi-Trans TP
Controlling Ability to Collect API Trace Data
Restricting Access to API Trace Resources
Allowing a System Administrator to Control API Tracing Activity
Restricting API Tracing Activity to Specific Users or Conversations
Allowing API Tracing Activity for Security_None Conversations
Obtaining SYSOUT and Account Information from RACF User Profiles
Extracting SYSOUT and Account Information from RACF User Profiles
Using Persistent Verification (PV)
Diagnosing Security Problems
Maintaining MVS Passwords in an APPC Environment
What is the SIGNON/Change Password TP?
How to Create Partner LU Communication for the SIGNON/Change Password TP
Description of SIGNON/Change Password GDS Variable
General GDS Variable Format
Format for Sign-on (FF00) Sub-fields
Format for SIGNON/Change Password (FF01) Sub-fields
Format for SIGNON Reply Data (FF02) Sub-fields
Example GDS Variable - Input to SIGNON/Change Password TP
GDS Variable - Output from SIGNON/Change Password TP
SIGNON/Change Password Status Values
SIGNON/Change Password Request Formatting Errors
Using Sample Programs to Maintain User Passwords on a Partner LU
ATBMINO and COMUPASS Sample Programs
A Typical Scenario - Changing an Expired Password
Changing a Password that Has Not Expired
Diagnosing Problems when Using the Password Maintenance Sample Programs
ATBMINO Error Panels
COMUPASS Error Panels
COMUPASS Messages
How to Install the Sample Programs that Maintain Passwords
MVS Data Sets
Installation Procedure for Source Code
Installation Procedure for Executable Code
Downloading the Sample Programs (Executable Code)
Compiling the Sample Programs (Source Code Only)
Defining the ATBMINO Program to APPC on the Workstation
Defining Conversation Security
Encrypting Data and Security Information
Summary
System management
Operating APPC/MVS
Starting the APPC and ASCH Address Spaces
Restarting APPC/MVS
Displaying Information about APPC/MVS Work
Dynamically Changing the APPC/MVS Environment
Changing Parmlib Specifications through the SET Command
Changing LU Characteristics through VTAM Commands
Stopping APPC/MVS Work
Deactivating a Transaction Program through its TP Profile
Stopping an Initiator Address Space with the STOP Command
Stopping a Class of Transaction Programs with the SET Command
Stopping One or More LUs with the SET or VARY Command
Using the SET Command to Quiesce Work
Using the VARY Command to Stop Work Immediately
Stopping a TP or APPC/MVS Address Space with the CANCEL Command
Stopping a Single Instance of a TP
Stopping the APPC and ASCH Address Spaces
Stopping VTAM with the HALT Command
Summary of Methods of Stopping APPC/MVS Work
Tracking Changes to the APPC/MVS Configuration and Workload
Displaying TP Status
Displaying UR Status
Displaying Server Status
Displaying LU Status
Displaying Scheduling Status
Examples Using the DISPLAY Command
Managing Use of the APPC/MVS API Trace Facility
Planning for the Use of API Trace Data Sets
Restoring API Tracing Capability
Recovering from APPC problems
Recovery for the APPC Address Space
APPC Initialization Problems
Abnormal End of the APPC address space with restart
Abnormal end of the APPC address space without restart
Recovery for the APPC/MVS Transaction Scheduler (ASCH) address space
Abnormal Ending of the APPC/MVS Transaction Scheduler with Restart
Abnormal Ending of the APPC/MVS Transaction Scheduler without Restart
APPC/MVS Measurement and Tuning
Managing APPC Work in the System
Considering APPC/MVS Storage Requirements
Changing the Maximum for the System Workload
Monitoring APPC Performance
Using SMF to Audit APPC Work
Information that SMF Records for APPC/MVS Work
Assigning Account Numbers to Transactions
Using RMF Reports
Using the DISPLAY Operator Command
Improving Performance Through Program Design and Administration
Making Efficient Use of Callable Services
Avoiding Certain JCL Keywords
Using the Multi-Trans Schedule Type
Defining Classes and Response Time Goals
Putting Multi-Trans TPs in their Own Class
Associating TPs and LUs with the Appropriate Level
Limiting Use of the TP Message Log
Improving Performance through System Changes
Controlling Buffer Limit Size
Buffer Size Control
Conversation Level Pacing
Minimizing Use of APPC Component Trace
Controlling SMF Type 33 Recording for APPC
Improving Network Performance
Minimize Remote Communication Calls
Optimize LU-to-LU Sessions
Maximum number of APPC active conversations
Installation checklists
Installing an APPC Application
Installing a TP that Initiates an Outbound Request
Installing a TP that Responds to an Inbound Request
Character Sets
Coding the APPCLOG Utility
Parameters
Examples of using the APPCLOG Utility
Sample output
APPCLOG Formatted Dump
APPCLOG Analysis Dump