z/OS Communications Server: SNA Customization
Previous topic |
Next topic
|
Contents
|
Contact z/OS
|
Library
|
PDF
Contents (exploded view)
z/OS Communications Server: SNA Customization
SC27-3666-00
Abstract for Communications Server: SNA Customization
Summary of changes
Writing VTAM installation-wide exit routines
Session management exit routine
Initial register contents
Final register contents
Design requirements
Suggestions
Parameter lists
Parameter list structure
Begin function (function code X'FE')
Final register contents
Initial authorization function (function code X'00')
Final register contents
Secondary authorization function (function code X'01')
Final register contents
Initial and final accounting functions (function codes X'02' and X'03)
Final register contents
Gateway path selection function (function code X'04')
Final register contents
XRF session switch function (function code X'05')
Final register contents
Adjacent SSCP selection function (function code X'06')
APPN considerations for adjacent SSCP selection
Final register contents
Alias selection function (function code X'07')
Final register contents
Adjacent link station selection function (function code X'08')
Final register contents
APPN considerations for adjacent link station selection
Function specifies no alternate ALS
Exit not enabled, or exit authorizes alternate ALS
Exit replacement function (function code X'09')
Final register contents
Exit replaced function (function code X'0A')
Final register contents
Virtual route selection function (function code X'0B')
Final register contents
HPR virtual route selection function (function code X'0C')
Final register contents
End function (function code X'FF')
Final register contents
Parameter descriptions
Environment vector list
Function code and related session information
User data field
Exit options
PLU, SLU, ILU, and USERVAR resource identifier control vectors
SLU table name vector
PLU and SLU fully qualified associated resource name control vector
PLU and SLU adjacent link control vector
Session identifier
Time-of-day field
OLU gateway information vector
Gateway path selection list
SSCP name list
DLU gateway information vector
OLU adjacent SSCP vector
DLU adjacent SSCP vector
Alias selection input parameter list
Alias selection output parameter list
Session flows for alias selection function
Session initiation user data field
Adjacent link station list information vector
Adjacent link station name information vector
Virtual route/transmission priority list information vector
Session authorization data vector
VTAM exit services
Initial register contents
Final register contents
VTAM Exit Services parameter list
VTAM Exit Services message parameter list
Session management data area
TCP/IP information control vector
Virtual route selection exit routine
Initial register contents
Final register contents
Design requirements
Virtual route selection exit routine parameter list
Abend processing
Changing the virtual route selection list
Examples of virtual route selection exit routine processing
Example 1: Reordering the list
Example 2: Deleting entries from the list
Example 3: Using only a portion of the list
Example 4: Replacing a virtual route in the list
Virtual route pacing window size calculation exit routine
Initial register contents
Final register contents
Design requirements
VR pacing window size calculation exit routine parameter list
Explicit route characteristics table
Using the VR window size calculation exit routine for IMS
Session accounting exit routine
Initial register contents
Final register contents
Design requirements
Session authorization exit routine
Initial register contents
Final register contents
Design requirements
Session authorization exit routine parameter list
Configuration services XID exit routine
Initial register contents
Final register contents
Design requirements
Configuration services XID exit routine parameter list
Configuration services XID exit routine output parameter list
Vector header
Vector data formats
Begin vector (X'00')
XID vector (X'01')
Build vector (X'02')
Resource entry blocks
Connection status vector (X'03')
Failure vector (X'04')
End vector (X'FF')
Selection of definitions for dependent LUs exit routine
Naming dynamically defined dependent LUs
Specifying a model LU
Failing dynamic definition requests
Initial register contents
Final register contents
Design requirements
SDDLU exit routine parameter list
SDDLU exit routine vectors
Begin vector (X'06')
Dynamic definition request vector (X'05')
Resource entry blocks
End vector (X'07')
Command verification exit routine
Initial register contents
Final register contents
Design requirements
Return codes
Command verification exit parameter list
User data field
Examples of command verification processing
Example 1: Deactivation of critical resource with OVERRIDE specified
Example 2: Deactivation of critical resource with OVERRIDE not specified
Example 3: Deactivation of a non-critical resource
USERVAR exit routine
Initial register contents
Final register contents
Design requirements
USERVAR exit routine parameter list
User data field
Invoke flags
USERVAR parameters
Session partners list
Directory services management exit routine
Initial register contents
Final register contents
Design requirements
Diagnostic information
Parameter lists
Parameter list structure
Begin function (function code X'FE')
Initial authorization function (function code X'00')
Redrive of exit for search authorization (function code X'00' with redrive bit on)
Border node selection function (function code X'01')
Interchange node selection function (function code X'02')
CDS selection function (function code X'03')
Alternate CDS selection function (function code X'04')
Central resource registration selection function (function code X'05')
Replacing function (function code X'08')
Replaced function (function code X'09')
End function (function code X'FF')
Parameter descriptions
Environment vector list
Function code and related search information
User data field
User-supplied parameter data
Exit options
Border node and interchange node options
Interchange node list structure
OLU information structure
DLU information structure
Network-qualified adjacent CP name vector
Search correlator structure
PCID modifier structure
Search task list
Subnetwork routing list structure
CDS list structure
Generic resource resolution exit routine
Initial register contents
Final register contents
Design requirements
Generic resource resolution exit routine parameter list
User data field
Invoke flags
Generic resources parameter list
Generic resource member list
Output parameters for generic resource resolution
Generic resource resolution processing
Processing the sample generic resource resolution exit routine
Performance monitor exit routine
Multiple exit support
Initial register contents
Final register contents
Design requirements
Performance monitor exit routine parameter list
User data field
Performance data parameter list
Parameter list header format
Performance data vector general format
Global environment vector (X'000100010001')
Global installation-wide exit vector (X'000100020001')
Global storage buffer pool vector (X'000100030001')
Global storage private storage vector (X'000100030002')
Global storage CSA vector (X'000100030003')
Global storage GETBLK vector (X'000100030004')
Global session vector (X'000100040001')
Global APPN directory services vector (X'000100050001')
Global APPN directory services border node vector (X'000100050002')
Global APPN topology data vector (X'000100060001')
CSM buffer pool vector (X'000100070001')
CSM storage usage vector (X'000100070002')
Basic route data vector (X'000200010001')
RTP data vector (X'000300010001')
RTP data vector — RSCV information (X'000300010002')
RTP data vector — COS/TPF information (X'000300010003')
MNPS application recovery data vector (X'000400010001')
MNPS application data vector (X'000400010002')
MNPS structure data vector (X'000500010001')
Installing VTAM exit routines
Operator commands for VTAM exit routines
Activating and deactivating VTAM exit routines
Replacing VTAM exit routines
Passing user-defined data to installation-wide exit routines
Writing logon manager installation-wide exit routines
Logon manager exit routines
Criteria for contending CLUs
Contending CLUs for dependent SLU-initiated sessions
Contending CLUs for PLU-initiated sessions
Contending CLUs for TPF-initiated sessions
TPF sessions
Session requests from dependent SLUs
Session requests from independent and dependent PLUs
Sessions initiated by TPF
USERVAR exit routine for TPF sessions
Activation processing
Processing a USERVAR
Adding a USERVAR
Updating a USERVAR
Deleting a USERVAR
Translating a USERVAR
CLU search exit routine
Initial register contents
Final register contents
Return codes
Design requirements
CLU search exit parameter descriptions
Function code parameter lists
Exit initialization and termination (function codes X'01' and X'07')
CLU session initiation and termination (function codes X'02' and X'06')
Application program activation and deactivation (function codes X'03' and X'05')
CLU comparison (function code X'04')
REQTAIL macroinstruction
Session partners list
Writing TSO/VTAM installation-wide exit routines
TSO/VTAM exit routines
IKTCASX1: Error handling for unsupported terminals
Input to IKTCASX1
Output from IKTCASX1
IKTCASX2: User message language-hardware verification
Input to IKTCASX2
Output from IKTCASX2
IKTGETXT: Editing on unsupported terminals
Input to IKTGETXT
Output from IKTGETXT
IKTIDSX1: Output editing for IBM 3270 terminals
Input to IKTIDSX1
Output from IKTIDSX1
IKTIDSX2: Input editing for IBM 3270 terminals
Input to IKTIDSX2
Output from IKTIDSX2
IKTIDSX3: Attention handler for IBM 3270 terminals
Input to IKTIDSX3
Output from IKTIDSX3
IKTIDSX4: TGET edit for IBM 3270 terminals
Input to IKTIDSX4
Output from IKTIDSX4
IKTINX1: Logon edit
Input to IKTINX1
Output from IKTINX1
IKTINX2: I/O manager initialization
Input to IKTINX2
Output from IKTINX2
IKTRTX1: Output edit for IBM 3767, 3770, and 2741 terminals
Input to IKTRTX1
Output from IKTRTX1
IKTRTX2: Input edit for IBM 3767 and 3770 terminals
Input to IKTRTX2
Output from IKTRTX2
IKTRTX3: Attention handler for IBM 3767 and 3770 terminals
Input to IKTRTX3
Output from IKTRTX3
IKTRTX4: Edit for IBM 3767, 3770, and 2741 terminals
Input to IKTRTX4
Output from IKTRTX4
IKTWTX1: Output edit for WTTY and TWX terminals
Input to IKTWTX1
Output from IKTWTX1
Installing TSO/VTAM exit routines
Control blocks
IKTIPARM
IKTMPL
IKTOPARM
IKTWESTD
TCP/IP information control vector
IKTXSA
Defining user modules and tables
Directory size of symbol resolution table for the host network
Directory size of symbol resolution tables for other networks
CNM routing table
Installing the CNM routing table
Structure of the CNM routing table
Logon-interpret routine requirements
Initial register contents
Final register contents
Logon-interpret routine parameter list
Operation
IBM-supplied CNM routing table
VTAM session flows
Session flows for subarea
Cross-network session for CDINIT
Cross-network for INIT_OTHER_CD (third-party initiated)
Session flows for alias selection
SLU-initiated session for alias selection
PLU-initiated session for alias selection
Session flows for HPR
ILU-initiated session flows (third-party initiated)
PLU real name, NETID returned (third-party) ILU-initiated session flows with PLU real name and NETID
SLU-initiated flows with USERVAR name
DSRLST session flows
PLU-initiated session (ONLY-SHR)
PLU-initiated session (SHR-SHR)
Virtual route selection for boundary function LUs
Session flows for APPN
Mixed subarea/APPN ILU-initiated session
Mixed subarea/APPN PLU-initiated network broadcast
Mixed subarea/APPN SLU-initiated directed search
Sample session management exit
Initialization
Function selection
Begin function
Obtaining user storage
Loading NETID registration table
Returning to VTAM
Secondary authorization function
Gateway path selection function
Examining LU names
Modifying gateway path selection list
Alias selection function
Translating DLU name
Translating OLU name
Final accounting function
End function
VTAM exit services
Design considerations
Example invocation of VTAM exit services
Problem determination
Example 1
Example 2
Abend situation
Sample configuration services XID exit routine
Generating a dynamic switched major node name
Device identification
Device definition files
Name generation function
Invocation
Name generation table
Operation
Name generation table entry format
PU name construction
LU name construction
Tailoring the name generation table
Deactivating an entry
Modifying an entry
Adding an entry
Connection status records
Command verification exit routine
Sample command verification exit routine
Sample USERVAR exit routine for TPF sessions
Function code X'04' processing
Return codes
Sample CLU search exit routine for TPF sessions
Function code X'04' processing
Sample CLU search exit routine for TPF sessions
Architectural specifications
Accessibility
Bibliography
Index for Communications Server: SNA Customization
Copyright IBM Corporation 1990, 2014