>>-DISPLAY-- --NET--,--BFRUSE-----------------------------------> .-,--BUFFER--=--*--------------------------------. >--+------------------------------------------------+---------->< '-,--BUFFER--=--+-*----------------------------+-' +-SHORT------------------------+ +-SUMMARY----------------------+ +-buffid-----------------------+ '-(--buffid--+------------+--)-' '-,--SUMMARY-'
Abbreviations
| Operand | Abbreviation |
|---|---|
| DISPLAY | D |
| BUFFER=* | BUF=* |
| BUFFER=buffid | BUF=buffid |
| BUFFER=SHORT | BUF=SH |
| BUFFER=SUMMARY | BUF=SUMM |
When using an abbreviation in place of an operand, code the abbreviation exactly as shown in the table. For example, when coding the abbreviation for BUFFER=SHORT, code only BUF=SH. Do not code BUFFER=SH.
Purpose
The DISPLAY BFRUSE (buffer use) command displays information about VTAM® buffer use. It also displays storage usage summary information for VTAM modules.
Operands
- BUFFER
- Specifies the buffers to display. Table 1 shows, for each buffer pool, the buffer pool ID, its name, and its abbreviation.
- BUFFER=*
- Displays all buffer pools and information along with:
- Common service area (CSA) usage for buffers
- Intermediate routing node buffer usage limit (IRNLIMIT)
- VTAM private storage usage for buffers
- Common service area (CSA) usage for modules
- VTAM private storage usage for modules
- BUFFER=SHORT
- Displays a shortened format of buffer-related information. Five
digits are shown instead of 10. If the number is too large for display
in 5 digits, then 5 asterisks (*****) are displayed. To view the data
for that buffer, you can use the BUFFER=buffid operand. The SHORT operand displays buffer pool information, along with:
- CSA usage for buffers
- IRNLIMIT buffer usage
- VTAM private storage usage for buffers
- CSA usage for modules
- VTAM private storage usage for modules
- BUFFER=SUMMARY
- Displays information about:
- CSA usage for buffers
- IRNLIMIT buffer usage
- VTAM private storage usage for buffers
- CSA usage for modules
- VTAM private storage usage for modules
The information supplied by SUMMARY is independent of the information supplied by buffid. SUMMARY can be specified with or without buffid.
- BUFFER=buffid
- Displays buffer pool count information for one or more standard VTAM buffer pools. Buffer pool count information will be displayed for the specified pools. A buffer name can be the full name, the buffer ID, or an abbreviation.
Resulting display
For each
buffer pool requested, the resulting VTAM display
shows:
- The buffer pool identification (name of the buffer pool).
- Queued buffer requests (indicated by a Q after the buffer pool identification). The message display shows the expansion limit for the Q buffer and the number of buffers needed to satisfy the queued requests.
- Whether an expansion attempt has failed (indicated by an F after the buffer pool identification). The message display shows the expansion limit for the F buffer and the number of buffers needed to satisfy the queued requests.
- The size of each buffer, in bytes. (For certain buffer pools, such as IOBUF, the size displayed might not match the size specified in the buffer pool start options because VTAM increases the size of some buffers for buffer headers that must be added.
- The number of buffers currently assigned to the pool.
- The number of buffers currently available for use.
- The maximum number of buffers ever assigned to the pool (since the last SMS trace record was written, if an SMS trace is active).
- The maximum number of buffers ever used within the pool (since the last SMS trace record was written, if an SMS trace is active).
- The number of times that the buffer pool has been expanded (since the last SMS trace record was written, if an SMS trace is active).
- The number of available buffers at or below which expansion will occur.
- The number of available buffers at or above which contraction will be attempted.
- The number of buffers to be added during each expansion. This field contains "NA" (not applicable) if the dynamic buffer expansion function is not being used.
VTAM displays
additional storage usage information when the BUFFER operand is not
coded, when BUFFER=*, when BUFFER=SHORT, or when BUFFER=SUMMARY is
specified:
- For VTAM's common service
area (CSA), including 24-bit and 31-bit addressable storage:
- The usage limit for buffers
- The current usage for buffers and modules Note: Current usage for buffers is shown in message IST449I. Current usage for modules is shown in message IST1565I.
- The maximum CSA usage for buffers since the last DISPLAY BFRUSE command
- The maximum CSA usage for buffers since VTAM was started
- The system CSA limit (90% of the total 24-bit and 31-bit CSA defined to the system)
- For 24-bit addressable CSA storage:
- The usage limit for buffers
- The current usage for buffers and modules Note: Current usage for buffers is shown in message IST449I. Current usage for modules is shown in message IST1565I.
- The maximum CSA usage for buffers since the last DISPLAY BFRUSE command
- The maximum CSA usage for buffers since VTAM was started
Note: If VTAM requests 31-bit addressable storage and the operating system cannot honor the CSA storage request, the operating system provides VTAM with 24-bit addressable storage. The resulting display, however, shows the explicit storage request. - VTAM's intermediate routing node buffer usage limit (IRNLIMIT), current buffer usage, and maximum buffer usage
- Current VTAM private storage
usage for buffers and modules and the maximum amount of VTAM private storage for buffers ever in use
since VTAM was started. Note: The private storage amount includes storage allocated by VTAM's Storage Management services, plus the storage for VTAM tables and installation-wide exit routines.
Current usage for buffers is shown in message IST981I. Current usage for modules is shown in message IST1565I.
For more information about using VTAM buffer use data, see the z/OS Communications Server: SNA Diagnosis Vol 1, Techniques and Procedures.
Table 1 shows the IDs, names, and abbreviated names of the buffer pools. For descriptions of VTAM buffer pools, see the z/OS Communications Server: SNA Network Implementation Guide.
| ID | Name | Abbrev |
|---|---|---|
| IO00 | IOBUF | IO |
| BS00 | BSBUF | BS |
| LP00 | LPBUF | LP |
| XD00 | XDBUF | XD |
| LF00 | LFBUF | LF |
| CRPL | CRPLBUF | CR |
| SF00 | SFBUF | SF |
| SP00 | SPBUF | SP |
| AP00 | APBUF | AP |
| TI00 | TIBUF | TI |
| T100 | T1BUF | T1 |
| T200 | T2BUF | T2 |
| CRA4 | CRA4BUF | CRA4 |
| CRA8 | CRA8BUF | CRA8 |
Examples
Displaying VTAM buffer usage for a specific
buffer:
d net,bfruse,buffer=io00
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = BUFFER POOL DATA
IST920I IO00 BUFF SIZE 334 EXP INCREMENT 55
IST921I TIMES EXP 0 EXP/CONT THRESH 36 / *NA*
IST922I CURR TOTAL 110 CURR AVAILABLE 110
IST923I MAX TOTAL 110 MAX USED 1
IST989I EXP LIMIT 2147483647 BUFFS REQUESTED 0
IST314I ENDDisplaying a storage usage summary:
d net,bfruse,buffer=summary
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = BUFFER POOL DATA
IST449I CSALIMIT = 464565K, CURRENT = 40692K, MAXIMUM = 40692K
IST790I MAXIMUM CSA USED = 40692K
IST1667I SYSTEM CSA LIMIT = 516184K
IST1831I 84% OF SYSTEM CSA STORAGE REMAINING = 433967K
IST449I CSA24 LIMIT = NOLIMIT, CURRENT = 59K, MAXIMUM = 59K
IST790I MAXIMUM CSA24 USED = 60K
IST595I IRNLIMIT = NOLIMIT, CURRENT = 0K, MAXIMUM = 0K
IST981I VTAM PRIVATE: CURRENT = 1300K, MAXIMUM USED = 1343K
IST924I -------------------------------------------------------------
IST2403I 64-BIT STORAGE TYPE CURRENT MAXIMUM LIMIT
IST2404I HVCOMMON 7M 7M NOLIMIT
IST2405I TRACE HVCOMMON 4M 4M 2048M
IST2413I PRIVATE 22M 22M NOLIMIT
IST2412I FIXED HVCOMMON 11M 11M NOLIMIT
IST2414I FIXED PRIVATE 22M 22M NOLIMIT
IST2415I TOTAL FIXED 33M 33M **NA** 
IST924I -------------------------------------------------------------
IST1565I CSA MODULES = 1796K
IST1565I CSA24 MODULES = 40K
IST1565I PRIVATE MODULES = 7700K
IST314I END Displaying VTAM buffer usage for a buffer pool and a storage
usage summary:
d net,bfruse,buffer=(io00,summary)
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = BUFFER POOL DATA
IST920I IO00 BUFF SIZE 619 EXP INCREMENT 504
IST921I TIMES EXP 0 EXP/CONT THRESH 500 / *NA*
IST922I CURR TOTAL 4002 CURR AVAILABLE 4002
IST923I MAX TOTAL 4002 MAX USED 1
IST989I EXP LIMIT 696846 BUFFS REQUESTED 0
IST924I -------------------------------------------------------------
IST449I CSALIMIT = 464565K, CURRENT = 40692K, MAXIMUM = 40692K
IST790I MAXIMUM CSA USED = 40692K
IST1667I SYSTEM CSA LIMIT = 516184K
IST1831I 84% OF SYSTEM CSA STORAGE REMAINING = 433917K
IST449I CSA24 LIMIT = NOLIMIT, CURRENT = 59K, MAXIMUM = 59K
IST790I MAXIMUM CSA24 USED = 60K
IST595I IRNLIMIT = NOLIMIT, CURRENT = 0K, MAXIMUM = 0K
IST981I VTAM PRIVATE: CURRENT = 1300K, MAXIMUM USED = 1343K
IST924I -------------------------------------------------------------
IST2403I 64-BIT STORAGE TYPE CURRENT MAXIMUM LIMIT
IST2404I HVCOMMON 7M 7M NOLIMIT
IST2405I TRACE HVCOMMON 4M 4M 2048M
IST2413I PRIVATE 22M 22M NOLIMIT
IST2412I FIXED HVCOMMON 11M 11M NOLIMIT
IST2414I FIXED PRIVATE 22M 22M NOLIMIT
IST2415I TOTAL FIXED 33M 33M **NA**
IST924I -------------------------------------------------------------
IST1565I CSA MODULES = 1796K
IST1565I CSA24 MODULES = 40K
IST1565I PRIVATE MODULES = 7700K
IST314I END Displaying a VTAM buffer usage summary in table
format and a storage usage summary:
d net,bfruse,buffer=short
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = BUFFER POOL DATA 850
IST632I BUFF BUFF CURR CURR MAX MAX TIMES EXP/CONT EXP
IST633I ID SIZE TOTAL AVAIL TOTAL USED EXP THRESHOLD INCR
IST356I IO00 619 4002 4002 4002 1 0 500/----- 504
IST356I BS00 260 70 70 70 0 0 29/----- 70
IST356I LP00 2032 12 10 12 4 0 2/----- 6
IST356I XD00 697 5 5 5 0 0 4/----- 5
IST356I LF00 120 30 27 30 3 0 1/----- 30
IST356I CRPL 144 75 75 75 1 0 29/----- 75
IST356I SF00 112 32 30 32 2 0 1/----- 32
IST356I SP00 176 21 21 21 0 0 1/----- 21
IST356I AP00 56 56 56 56 0 0 3/----- 56
IST356I TI00 632 26004 26004 26004 5 0 60/----- 1002
IST356I T100 1004 500 500 500 0 0 60/----- 300
IST356I T200 2028 9000 9000 9000 0 0 60/----- 300
IST356I CRA4 4080 100 98 100 4 0 20/----- 10
IST356I CRA8 8176 12 11 12 4 0 2/----- 6
IST449I CSALIMIT = 464565K, CURRENT = 40692K, MAXIMUM = 40692K
IST790I MAXIMUM CSA USED = 40692K
IST1667I SYSTEM CSA LIMIT = 516184K
IST1831I 84% OF SYSTEM CSA STORAGE REMAINING = 433917K
IST449I CSA24 LIMIT = NOLIMIT, CURRENT = 59K, MAXIMUM = 59K
IST790I MAXIMUM CSA24 USED = 60K
IST595I IRNLIMIT = NOLIMIT, CURRENT = 0K, MAXIMUM = 0K
IST981I VTAM PRIVATE: CURRENT = 1300K, MAXIMUM USED = 1343K
IST924I -------------------------------------------------------------
IST2403I 64-BIT STORAGE TYPE CURRENT MAXIMUM LIMIT
IST2404I HVCOMMON 7M 7M NOLIMIT
IST2405I TRACE HVCOMMON 4M 4M 2048M
IST2413I PRIVATE 22M 22M NOLIMIT
IST2412I FIXED HVCOMMON 11M 11M NOLIMIT
IST2414I FIXED PRIVATE 22M 22M NOLIMIT
IST2415I TOTAL FIXED 33M 33M **NA**
IST924I -------------------------------------------------------------
IST1565I CSA MODULES = 1796K
IST1565I CSA24 MODULES = 40K
IST1565I PRIVATE MODULES = 7700K
IST314I END Displaying VTAM buffer usage for all buffers and a storage
usage summary:
d net,bfruse
IST097I DISPLAY ACCEPTED
IST350I DISPLAY TYPE = BUFFER POOL DATA 860
IST920I IO00 BUFF SIZE 619 EXP INCREMENT 504
IST921I TIMES EXP 0 EXP/CONT THRESH 500 / *NA*
IST922I CURR TOTAL 4002 CURR AVAILABLE 4001
IST923I MAX TOTAL 4002 MAX USED 5
IST989I EXP LIMIT 696846 BUFFS REQUESTED 0
IST924I -------------------------------------------------------------
IST920I BS00 BUFF SIZE 260 EXP INCREMENT 70
IST921I TIMES EXP 0 EXP/CONT THRESH 29 / *NA*
IST922I CURR TOTAL 70 CURR AVAILABLE 70
IST923I MAX TOTAL 70 MAX USED 0
IST924I -------------------------------------------------------------
IST920I LP00 BUFF SIZE 2032 EXP INCREMENT 6
IST921I TIMES EXP 0 EXP/CONT THRESH 2 / *NA*
IST922I CURR TOTAL 12 CURR AVAILABLE 10
IST923I MAX TOTAL 12 MAX USED 4
IST924I -------------------------------------------------------------
IST920I XD00 BUFF SIZE 697 EXP INCREMENT 5
IST921I TIMES EXP 0 EXP/CONT THRESH 4 / *NA*
IST922I CURR TOTAL 5 CURR AVAILABLE 5
IST923I MAX TOTAL 5 MAX USED 0
IST924I -------------------------------------------------------------
IST920I LF00 BUFF SIZE 120 EXP INCREMENT 30
IST921I TIMES EXP 0 EXP/CONT THRESH 1 / *NA*
IST922I CURR TOTAL 30 CURR AVAILABLE 26
IST923I MAX TOTAL 30 MAX USED 4
IST924I -------------------------------------------------------------
IST920I CRPL BUFF SIZE 144 EXP INCREMENT 75
IST921I TIMES EXP 0 EXP/CONT THRESH 29 / *NA*
IST922I CURR TOTAL 75 CURR AVAILABLE 73
IST923I MAX TOTAL 75 MAX USED 2
IST924I -------------------------------------------------------------
IST920I SF00 BUFF SIZE 112 EXP INCREMENT 32
IST921I TIMES EXP 0 EXP/CONT THRESH 1 / *NA*
IST922I CURR TOTAL 32 CURR AVAILABLE 30
IST923I MAX TOTAL 32 MAX USED 2
IST924I -------------------------------------------------------------
IST920I SP00 BUFF SIZE 176 EXP INCREMENT 21
IST921I TIMES EXP 0 EXP/CONT THRESH 1 / *NA*
IST922I CURR TOTAL 21 CURR AVAILABLE 21
IST923I MAX TOTAL 21 MAX USED 0
IST924I -------------------------------------------------------------
IST920I AP00 BUFF SIZE 56 EXP INCREMENT 56
IST921I TIMES EXP 0 EXP/CONT THRESH 3 / *NA*
IST922I CURR TOTAL 56 CURR AVAILABLE 56
IST923I MAX TOTAL 56 MAX USED 0
IST924I -------------------------------------------------------------
IST920I TI00 BUFF SIZE 632 EXP INCREMENT 1002
IST921I TIMES EXP 0 EXP/CONT THRESH 60 / *NA*
IST922I CURR TOTAL 26004 CURR AVAILABLE 26004
IST923I MAX TOTAL 26004 MAX USED 5
IST924I -------------------------------------------------------------
IST920I T100 BUFF SIZE 1004 EXP INCREMENT 300
IST921I TIMES EXP 0 EXP/CONT THRESH 60 / *NA*
IST922I CURR TOTAL 500 CURR AVAILABLE 500
IST923I MAX TOTAL 500 MAX USED 0
IST924I -------------------------------------------------------------
IST920I T200 BUFF SIZE 2028 EXP INCREMENT 300
IST921I TIMES EXP 0 EXP/CONT THRESH 60 / *NA*
IST922I CURR TOTAL 9000 CURR AVAILABLE 9000
IST923I MAX TOTAL 9000 MAX USED 0
IST924I -------------------------------------------------------------
IST920I CRA4 BUFF SIZE 4080 EXP INCREMENT 10
IST921I TIMES EXP 0 EXP/CONT THRESH 20 / *NA*
IST922I CURR TOTAL 100 CURR AVAILABLE 98
IST923I MAX TOTAL 100 MAX USED 4
IST924I -------------------------------------------------------------
IST920I CRA8 BUFF SIZE 8176 EXP INCREMENT 6
IST921I TIMES EXP 0 EXP/CONT THRESH 2 / *NA*
IST922I CURR TOTAL 12 CURR AVAILABLE 11
IST923I MAX TOTAL 12 MAX USED 4
IST924I -------------------------------------------------------------
IST449I CSALIMIT = 464565K, CURRENT = 40695K, MAXIMUM = 40695K
IST790I MAXIMUM CSA USED = 40695K
IST1667I SYSTEM CSA LIMIT = 516184K
IST1831I 84% OF SYSTEM CSA STORAGE REMAINING = 433943K
IST449I CSA24 LIMIT = NOLIMIT, CURRENT = 59K, MAXIMUM = 59K
IST790I MAXIMUM CSA24 USED = 60K
IST595I IRNLIMIT = NOLIMIT, CURRENT = 0K, MAXIMUM = 0K
IST981I VTAM PRIVATE: CURRENT = 1352K, MAXIMUM USED = 1352K
IST924I -------------------------------------------------------------
IST2403I 64-BIT STORAGE TYPE CURRENT MAXIMUM LIMIT
IST2404I HVCOMMON 7M 7M NOLIMIT
IST2405I TRACE HVCOMMON 4M 4M 2048M
IST2413I PRIVATE 22M 22M NOLIMIT
IST2412I FIXED HVCOMMON 11M 11M NOLIMIT
IST2414I FIXED PRIVATE 22M 22M NOLIMIT
IST2415I TOTAL FIXED 33M 33M **NA**
IST924I -------------------------------------------------------------
IST1565I CSA MODULES = 1796K
IST1565I CSA24 MODULES = 40K
IST1565I PRIVATE MODULES = 7700K
IST314I END