VSE/VTAM Tuning Agenda

WAVV 2000
ASI Procedure Considerations

VTAM Partition Considerations

VTAM Buffer Pools

VTAM Start Options

Class of Service

Jon von Wolfersdorf Channel Coattailing

IBM Corporation
VSE System Center Session Pacing
Endicott, New York
References

wolff @ us.ibm.com
(C) Copyright International Business Machines Corporation 1998

Page 1 Page 2

VSE/VTAM Tuning Basics

 IPL Procedure Parms VSE/ESA 2.x IPL Proc

500,$$A$SUPX, VSIZE=180M, VIO=512K,VPOOL=64K,LOG

VSIZE ADD 500:51F,3277
ADD D00:D03,3390
ADD E20:E23,3490
- include data space (VTAM 4.2) ADD FEC,3505 POWER DUMMY READER, DO NOT DELETE
- monitor with MAP command ADD FED,2520B2 POWER DUMMY PUNCH, DO NOT DELETE
ADD FEE,PRT1 POWER DUMMY PRINTER, DO NOT DELETE
ADD FEF,PRT1 POWER DUMMY PRINTER, DO NOT DELETE
ADD FFA,3505 ICCF INTERNAL READER, DO NOT DELETE
ADD FFC,3505 ICCF DUMMY READER, DO NOT DELETE
ADD FFD,2520B2 ICCF DUMMY PUNCH, DO NOT DELETE
ADD FFE,PRT1 ICCF DUMMY PRINTER, DO NOT DELETE
BUFSIZE ADD FFF,CONS DUMMY CONSOLE, DO NOT DELETE
SET ZONE=WEST/00/00
- supervisior I/O buffer usage DEF SYSCAT=DOSRES
- monitor with SIR command DEF SYSREC=SYSWK1
SYS JA=YES
SYS BUFSIZE=1500
SYS NPARTS=44
SYS SEC=NO
SYS PASIZE=30M
System GETVIS SYS SPSIZE=0K
SYS BUFLD=YES
DPD VOLID=DOSRES,CYL=211,NCYL=15,TYPE=N,DSF=N
- SVA-24 DPD VOLID=SYSWK1,CYL=446,NCYL=15,TYPE=N,DSF=N
- SVA-31 (VTAM 4.2) DPD VOLID=DOSRES,CYL=414,NCYL=14,TYPE=N,DSF=N
DPD VOLID=DOSRES,CYL=428,TYPE=N,DSF=N
- monitor with GETVIS command DLA NAME=AREA1,VOLID=DOSRES,CYL=64,NCYL=3,DSF=N
SVA SDL=300, GETVIS=(768K,3M), PSIZE=(256K,2000K)

Page 3 Page 4

VSE/VTAM Tuning Basics

 ALLOC Procedure JCL0 Procedure

VTAM Partition Size Partition Priority

- environment 'B' default 6M - default setting
- major factors:
program area size PRTY BG,FB,FA,F9,F8,F7,F6,F5,F4,F2,F3,F1
buffer pool requirements
use of 31-bit partition GETVIS (VTAM 4.2)

VTAM Ahead of POWER

- use no priority checking parm
DSIZE (VTAM 4.2)
- environment 'B' default 20M PSTART F3,K3,NPC
- major factors:
data space requirements (VDISK, sort, etc...)
number of VTAM applications
use of VTAM data compression PRTYIO
- AR command
- default setting is FIFO

Page 5 Page 6

VSE/VTAM Tuning Basics

 VTAM Startup Parms VTAM 4.2 Startup JCL

* $$ JOB JNM=VTAMSTRT,DISP=L,CLASS=3
SETPFIX LIMIT // JOB VTAMSTRT START VTAM
// OPTION DUMP,SADUMP=5
- 424K default (w/supplied JCL) // SETPARM XNCPU=''
// EXEC PROC=$COMVAR,XNCPU
- 640K recommended minimum // EXEC DTRSETP,PARM='CPUVAR&XNCPU;;SET XSTATF3=ACTIVE'
- 31-bit PFIX used if partition > 16M (VTAM 4.2) /*
// SETPFIX LIMIT=424K
* // SETPFIX LIMIT=(,300K)
// ASSGN SYS000,UA
// ASSGN SYS001,DISK,VOL=SYSWK1,SHR TRACE FILE ASSIGNMENT
SIZE // ASSGN SYS004,DISK,VOL=SYSWK1,SHR TRACE FILE ASSIGNMENT
// ASSGN SYS005,DISK,VOL=SYSWK1,SHR NCP LOAD/DIAG FILE ASSGN
- 2268K recommended for VTAM 3.4 // LIBDEF *,SEARCH=(PRD2.COMM,PRD2.COMM2,PRD2.CONFIG, *
PRD1.BASED,PRD1.BASE),PERM
- ISTINCVT recommended for VTAM 4.2 // LIBDEF DUMP,CATALOG=SYSDUMP.F3,PERM
// EXEC ISTINCVT, SIZE=ISTINCVT, PARM='CUSTNO=C555-555-5555,VTAMPW=5979-4*
015-4627-6185-9388', DSPACE=2M
// EXEC DTRSETP,PARM='CPUVAR&XNCPU;;SET XSTATF3=INACTIVE'
/*
/&
DSPACE (VTAM 4.2) * $$ EOJ

- 1M minimum
- 2M default (w/supplied JCL)

Page 7 Page 8

VSE/VTAM Tuning Basics

 VTAM Partition Storage Layout Tuning VTAM Buffer Pools
(2 G) (2 G) Supplied Values are a Starting Point
CRPLBUF
LFBUF
N/A SVA - 31 LPBUF Calculate Buffer Sizes for:
SFBUF
- maximum efficiency
31 - BIT
PARTITION
SPBUF - minimum storage waste
N/A BSBUF
GETVIS
(16 M) (16 M)
I/O Buffers
LFBUF SPBUF - every environment is unique
24 - BIT
BSBUF XDBUF - use a common value across network hosts
PARTITION XDBUF
VPBUF VFBUF
GETVIS - optimum value = average PIU size

Primary Tool:
SIZE = 2268K
PROGRAM AREA - D NET,BFRUSE command
SIZE = ISTINCVT
CRPLBUF
LPBUF SVA - 24 I OBUF
Average PIU Size is Growing
SFBUF
- graphics applications
- file transfer programs
VSE/ESA 1.3.X SUPERVISOR VSE/ESA 2.X.X
VSE/ESA 1.4.X
(0 M) (0 M)
VSE/VTAM 3.4 VSE/VTAM 4.2

Page 9 Page 10

VSE/VTAM Tuning Basics

 Monitoring Buffer Pool Usage VTAM 3.4 Tuning Guidelines
D NET,BFRUSE,BUFFER=SHORT
1C39I COMMAND PASSED TO ACF/VTAM
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = BUFFER POOL DATA
I/O Buffer Pool
IST632I BUFF BUFF CURR CURR MAX MAX TIMES EXP/CONT EXP
IST633I ID SIZE TOTAL AVAIL TOTAL USED EXP THRESHOLD INCR - select BUFSIZE (even number)
IST356I SF 112 32 30 32 2 0 1/----- 32 - optimize # of buffers/page, LFBUF formula:
IST356I IO 359 70 52 110 102 42 6/00046 20
IST356I SP 144 210 210 210 0 0 1/----- 51 coded value + 63 + 16 rounded up to doubleword boundry
IST356I LP 2032 12 7 12 8 0 2/----- 6 divide into 4096 for buffers per page
IST356I LF 120 90 88 90 2 0 1/----- 30
IST356I BS 216 34 34 34 0 0 17/----- 17 remainder is wasted storage/page
IST356I XD 681 10 10 10 0 0 5/----- 5
IST356I CR 164 60 50 60 27 0 29/----- 22
- set UNITSZ in NCP <= BUFSIZE
- set BASENO to 4K page increment
- set XPANNO to 4K page increment (VTAM rounds up)
- set XPANPT - SLOWPT >= largest MAXBUFRU

Other Buffer Pools

- formula:
BUFSIZE + 16 rounded up to doubleword boundry
BUFF SIZE - does not include 16 byte SMS header or rounding
CURR TOTAL - current # of buffers in pool (baseno + expansions) divide into 4096 for buffers per page
CURR AVAIL- # of free buffers in pool, out of CURR TOTAL - set BASENO to 4K page increment
MAX TOTAL - maximum # of buffers in pool (baseno + expansions)
MAX USED - maximum # of buffers used in pool, out of MAX TOTAL
- set XPANNO to 4K page increment (VTAM rounds up)
TIMES EXP - # of times the pool expanded - set VPBUF & VFBUF to 4K page increment (VTAM rounds up)
EXP THRESHOLD - pool expansion point (xpanpt)
CONT THRESHOLD - pool contraction point (2 * EXP INCR + EXP THRESHOLD)
EXP INCR - pool expansion increment (xpanno)

Page 11 Page 12

VSE/VTAM Tuning Basics

 VTAM 4.2 Tuning Guidelines VSE/VTAM Buffer Sizes

I/O Buffer Pool

Buffer Pool VTAM 3.4 VTAM 4.2 Notes
- select BUFSIZE (even number)
- optimize # of buffers/page, IOBUF formula: 168 232
BSBUF 17/pg
24/pg
coded value + 71 + 16 rounded up to doubleword boundry
168 184
divide into 4096 for buffers per page CRPLBUF 24/pg 22/pg
remainder is wasted storage/page
see 136 #/pg in VTAM 3.4 depends
- set UNITSZ in NCP <= BUFSIZE LFBUF
notes 30/pg on size coded in ATCSTRxx
- set BASENO to 4K page increment (VTAM rounds up) see #/pg in VTAM 4.2 depends
- set XPANNO to 4K page increment (VTAM rounds up) IOBUF N/A
notes on size coded in ATCSTRxx
- set XPANPT - SLOWPT >= largest MAXBUFRU 2048 2048
LPBUF 2/pg 2/pg
416 128
Other Buffer Pools SFBUF
9/pg 32/pg

- formula: 144 160

SPBUF
28/pg 25/pg
BUFSIZE + 16 rounded up to doubleword boundry
divide into 4096 for buffers per page 696 704
XDBUF
5/pg 5/pg
- set BASENO to 4K page increment
see VTAM 3.4 code # of bytes
(VTAM rounds up except for CRPLBUF & SPBUF) VFBUF N/A
notes rounded up to a 4k page
- set XPANNO to 4K page increment (VTAM rounds up)
see VTAM 3.4 code # of bytes
VPBUF N/A
notes rounded up to a 4k page

Page 13 Page 14

VSE/VTAM Tuning Basics

 Tuning Examples VTAM Start Options

HOTIOTRM
VSE/VTAM 3.4
BSBUF=(28,,,1), BSBUF=(48,,,24),
- detection and termination of HOT I/O
CRPLBUF=(60,,,1), CRPLBUF=(72,,,24), set HOTIOTRM start option and XPANLIM on IOBUF
LFBUF=(70,288,,11), LFBUF=(72,432,4,24,12), - detection only
LPBUF=(12,,,6), LPBUF=(12,,,6), set XPANLIM on IOBUF
SFBUF=(20,,,20), SFBUF=(27,,,9),
SPBUF=(210,,,32), SPBUF=(224,,,28),
VFBUF=102400, VFBUF=102400, SGALIMIT
VPBUF=446464, VPBUF=446464,
XDBUF=(6,,,1) XDBUF=(10,,,5) - limits SVA24 (VTAM 3.4)
- limits SVA31 (VTAM 4.2)

VSE/VTAM 4.2 SGA24

BSBUF=(28,,,,1), BSBUF=(34,,,,17), - limits SVA24 (VTAM4.2)
CRPLBUF=(60,,,,1), CRPLBUF=(66,,,,22),
LFBUF=(70,,,,11), LFBUF=(30,,,,30),
IOBUF=(70,288,,,11), IOBUF=(72,424,4,,24,12), SONLIM
LPBUF=(12,,,,6), LPBUF=(12,,,,6),
SFBUF=(32,,,,32), - session outage notification limit
SFBUF=(20,,,,20),
SPBUF=(210,,,,32), SPBUF=(225,,,,25), - one IOBUF/SON is required
XDBUF=(6,,,,1) XDBUF=(10,,,,5) - default setting
SONLIM=(60,30)
NOTE:
The IBM supplied values in ATCSTR00.B do not represent recommended or customized
values. These examples assume the supplied values of BASENO for each buffer pool are
appropriate and tunes for minium storage waste.

Page 15 Page 16

VSE/VTAM Tuning Basics

 Class of Service Sample COS Table
Traffic Prioritization
- 2 = high priority (VTAM internal)
* $$ JOB JNM=CATCOS,CLASS=5,DISP=D
- 1 = medium priority (interactive) // JOB CATCOS CREATE ACF/VTAM COS TABLE
- 0 = low priority (batch) // LIBDEF *,SEARCH=(PRD1.BASE,PRD2.CONFIG),TEMP
// LIBDEF PHASE,CATALOG=PRD2.CONFIG
// OPTION CATAL
Implemented Via Table/LOGMODE PHASE ISTSDCOS,*
// EXEC ASSEMBLY
PRINT NOGEN
- no default table provided for subarea ISTSDCOS COSTAB
- default priority for all traffic = (0,0) *** High Priority Traffic ***
ISTVTCOS COS VR=((0,2),(1,2),(2,2),(3,2),(4,2),(5,2),(6,2),(7,2))
- COS name specified in LOGMODE entry SUPPORT COS VR=((0,2),(1,2),(2,2),(3,2),(4,2),(5,2),(6,2),(7,2))
*** Medium Priority Traffic ***
INTERACT COS VR=((0,1),(1,1),(2,1),(3,1),(4,1),(5,1),(6,1),(7,1))
Required Table Name ***
COS VR=((0,1),(1,1),(2,1),(3,1),(4,1),(5,1),(6,1),(7,1))
Low Priority Traffic ***
BATCH COS VR=((0,0),(1,0),(2,0),(3,0),(4,0),(5,0),(6,0),(7,0))
- ISTSDCOS COSEND
END
/*
Special COS Names // EXEC LNKEDT
/&
- ISTVTCOS * $$ EOJ

- (blank)

Page 17 Page 18

VSE/VTAM Tuning Basics

 Sample MODETAB Using COS VTAM I/O Basics

TSH SMS TH RH RU

IESINCLM MODETAB PIU

* PNET mode entry
PNET MODEENT LOGMODE=PNET,FMPROF=X'03',TSPROF=X'03', I/O BUFFER
PRIPROT=X'72',SECPROT=X'72',PSNDPAC=X'03',
SSNDPAC=X'03',SRCVPAC=X'03',COS=BATCH
* SNA Printer in SCS mode entry
SCSCSPRT MODEENT LOGMODE=SCSCSPRT,FMPROF=X'03',TSPROF=X'03',
PRIPROT=X'B1',SECPROT=X'90',COMPROT=X'3080', I/O Buffer Anatomny
SSNDPAC=X'01',SRCVPAC=X'01',RUSIZES=X'8585',
PSNDPAC=X'01',PSERVIC=X'01000000E100000000000000', - Transmission Subsystem Header (TSH)
COS=BATCH
* SNA 3270 terminal mode entry - Storage Management Services (SMS)
SP3272QS MODEENT LOGMODE=SP3272QS,FMPROF=X'03',TSPROF=X'03', - Path Information Unit (PIU)
PRIPROT=X'B1',SECPROT=X'90',COMPROT=X'3080',
RUSIZES=X'88F7',PSERVIC=X'028000000000185000000300', - Transmission Header (TH)
COS=INTERACT - Request Header (RH)
* My SNA terminal mode entry
WOLFF MODEENT LOGMODE=WOLFF,FMPROF=X'03',TSPROF=X'03', - Request Unit (RU)
PRIPROT=X'B1',SECPROT=X'90',COMPROT=X'3080',
RUSIZES=X'88F7',PSERVIC=X'028000000000185000000300',
COS=SUPPORT
MODEEND
Concepts
END - I/O is done on a PU basis
- only one PIU per I/O buffer is allowed
- PIU's can span multiple I/O buffers
- TSH provides a CCW skeleton
- channel programs are chained writes, followed by
chained reads

Page 19 Page 20

VSE/VTAM Tuning Basics

 Effects of DELAY on 1M file
Coattailing
download through OSA-2
Blocking of PIU's
- increases channel throughput
- reduces channel I/O 600
- reduces CPU utilization 546 Default Value

- can impact response time

500

Implement Coattailing with DELAY Parm 400 411

400 377
- CA Majornode
345
* GROUP/LINE/PU for CTCA (default .1) 315
* GROUP/LINE/PU for NCP (default .2)

Seconds
300
- NCP Majornode 243
* PCCU statement (default .2) 209
- XCA Majornode 200 183
* PORT statement (default .05)
- LOCAL SNA Majornode
100 80
* PU statement (default .2) 68
43 37
17 28

Channel Program Triggers 0

0-.028 .029 .03 .04 .05 .06 .07 .08 .09 .10 .20 .50 1.0 5.0 9.999
- DELAY timeout
- channel 'QDPTH' reached
Coded DELAY Value
- ATTN request for 'READ' NOTE:
- priority PIU received Your mileage WILL vary...

Page 21 Page 22

VSE/VTAM Tuning Basics

 Effects of DELAY on 1M file Improving Throughput
download through 3174-11L Recommendations

Default Value

150
140
135
Larger BASENO of IOBUF's
110
100 Larger XPANNO of IOBUF's
100
85
80
Larger MAXBFRU values
Seconds

70

Larger IOBUF size

50
40
30
25 25 25 Small non-zero DELAY value
18 15

0
0-.029 .03 .05 .10 .125 .15 .20 .25 .30 .40 .50 1.0 5.0 9.999

NOTE:
Coded DELAY Value
Your mileage WILL vary...

Page23 Page 24

VSE/VTAM Tuning Basics

 Pacing and Flow Control Determining Pacing Values

Types of Session Pacing

- fixed session pacing
- adaptive session pacing DLOGMOD Entry
- PSNDPAC (PS)
Pacing Stages - SRCVPAC (SR)
- SSNDPAC (SS)
- one stage
- two stage

Four Pacing Windows LU Definition

- primary send (PS) - PACING Parm (default=1)
- secondary receive (SR) - VPACING Parm (default=2)
- secondary send (SS)
- primary receive (PR)
PRIMARY LU BOUNDARY FUNCTION SECONDARY LU

One-Stage Outbound
---------------------------------------------------------------------------------------------------->
APPL Definition
primary send (PS) = secondary receive (SR)
- AUTH=NVPACE (default VPACE)
Two-Stage Outbound
-------------------------------> -------------------------------->
- VPACING Parm (default 7)
primary send (PS) secondary receive (SR)

One-Stage Inbound
<---------------------------------------------------------------------------------------------------
primary receive (PR) = secondary send (SS)

Two-Stage Inbound
<------------------------------- <--------------------------------
Page 25 Page 26
primary receive (PR) secondary send (SS)

VSE/VTAM Tuning Basics

 Pacing Guidelines Test Configuration

APPLICATION to APPLICATION
PRIMARY LU SECONDARY LU
outbound, one-stage inbound, one-stage VTMAPPL VBUILD TYPE=APPL
-------------------------> <--------------------------
DBDCCICS APPL AUTH=(PASS,ACQ),MODETAB=IESINCLM,PARSESS=YES
if PLU AUTH=NVPACE use 0 if SSNDPAC = 0 use it
else if PSNDPAC ¬= 0 use it else use PLU VPACING PRODCICS APPL AUTH=(PASS,ACQ),MODETAB=IESINCLM,PARSESS=YES
else use SLU VPACING POWER APPL AUTH=(ACQ)
PNET APPL AUTH=(PASS,ACQ),VPACING=3,MODETAB=VTMLOGTB,DLOGMOD=PNET
APPLICATION to NCP SNA LU
PSFAPPL APPL AUTH=ACQ,EAS=1,SONSCIP=YES
PRIMARY LU SECONDARY LU
outbound, two-stage inbound, one-stage IESWAITT APPL AUTH=(NOACQ)
-------------------------> <--------------------------
(first stage)
if PLU AUTH=NVPACE use 0 if SSNDPAC = 0 use it
else if PSNDPAC ¬= 0 use it else use PLU VPACING
else use SLU VPACING IBM 9221-191
VSE/ESA 2.3.1
(second stage)
VSE/VTAM 4.2
if SRCVPAC ¬= 0 use it
else use SLU PACING 6140 Token Ring ICA

APPLICATION to LOCAL SNA LU 16M Token Ring LAN Segment

PRIMARY LU SECONDARY LU
outbound, two-stage inbound, two-stage
-------------------------> <--------------------------
(first stage) (first stage)
if SRCVPAC ¬= 0 use it if SSNDPAC = 0 use it IBM Pentium 200MMX PC
else use SLU VPACING else use PLU VPACING TOKENLAN VBUILD TYPE=SWNET IBM OS/2 Warp 4
* IBM CM/2
(second stage) (second stage)
if SRCVPAC ¬= 0 use it if SSNDPAC = 0 use it VSEPU01 PU ADDR=01, 16M PCI Token Ring Adaptor
else use SLU VPACING else use PLU VPACING IDBLK=05D,
IDNUM=18100,
APPLICATION to X-DOMAIN SNA LU
LANSW=YES,
PRIMARY LU SECONDARY LU
outbound, two-stage inbound, two-stage MAXDATA=265,
-------------------------> <-------------------------- MAXOUT=7,
(first stage) (first stage) PUTYPE=2,
if PLU AUTH=NVPACE use 0 use SSNDPAC SAPADDR=4, SP3272QS MODEENT LOGMODE=SP3272QS,FMPROF=X'03',TSPROF=X'03',PRIPROT=X'B*
else if PSNDPAC ¬= 0 use it
PACING=1, 1',SECPROT=X'90',COMPROT=X'3080',RUSIZES=X'85C7',PSERVIC*
else use SLU VPACING
VPACING=2, =X'028000000000185000000300'
(second stage) (second stage) DLOGMOD=SP3272QS,
if SRCVPAC ¬= 0 then use it if SSNDPAC = 0 use it MODETAB=IESINCLM,
else use SLU PACING else use PLU VPACING
SSCPFM=USSSCS,
APPLICATION to NON-SNA LU USSTAB=VTMUSSTR
PRIMARY LU SECONDARY LU *
outbound, one-stage inbound, one-stage VSELU01A LU LOCADDR=2,ISTATUS=ACTIVE
Page 27 Page 28
-------------------------> <--------------------------
VSELU01B LU LOCADDR=3,ISTATUS=ACTIVE
use SRCVPAC use SSNDPAC

VSE/VTAM Tuning Basics

 Effects of VPACING on 1M file
Reference Sources
transfer through 9221 TR ICA
VSE/ESA Planning
(SC33-6606)
2500
2210 VSE/ESA System Control Statements
(SC33-6613)
2000
Default VPACING Value

VSE/ESA Networking Support

1500
(SC33-6608)
Download
VTAM Resource Definition Reference
Seconds

Upload
1000 955 (SC31-6498)

540 VTAM Network Implementation Guide

500
330
(SC31-6494)
165 210 185
110 95 90 85
70 75 80 70 75 30 70 VTAM Customization
0
(LY43-0063)
0 1 2 3 4 5 6 7 8

Coded VPACING Value VTAM Diagnosis

NOTE: (LY43-0065)
Your mileage WILL vary...

Page29 Page 30

VSE/VTAM Tuning Basics