Use this system macro to return the physical size of a storage
block.
- Note:
- You cannot use all of the available physical storage in a block. You
can only use the user size of the block, which is available from the SIZBC
macro. The remaining portion of the block is available for system use
only. This portion will not be saved on DASD if a block is
filed.
See TPF General Macros for more information about
the SIZBC macro.
Required Authorizations
|
Key0
| Restricted
| System
| Common Storage
|
| X
|
|
|
Format
- TYPE=R1|Rn
- The specified register contains the logical storage block type
value. Register R1 is the default value. R0 is not valid for all
calls and R8 through R13 are not valid for E-type calls.
Sizes are returned for the following block type equates:
- LECB (or L3)
- Entry Control Block
- LIOCB
- I/O Control Block
- LSWB
- System Work Block
- LCOMMON
- Common frame
- LFRAME
- Frame
Entry Requirements
- R9 must contain the address of the entry control block (ECB) if this macro
is called from a ECB-controlled program.
- For E-type programs R10 must be available as scratch register.
- The specified register must contain the desired storage block type.
The valid block types are listed above. These types are defined in the
CLHEQ macro.
- This macro can be run in the EVM or the SVM, in either 24-bit or 31-bit
addressing mode.
Return Conditions
- Control is returned to the next sequential instruction (NSI).
- The specified register contains the desired physical storage block
size.
- The contents of all other registers are preserved across the macro call
(except for R10 on an ECB-controlled program call).
- The condition code is not preserved across the macro call.
Programming Considerations
- This macro can be run on any I-stream.
- R0 may not be specified.
- This macro is for use in the control program (CP) or an ECB-controlled
program.
- The usage of the PHYBC macro requires authorization to issue a restricted
macro (CHECK=RESTR) by the $CKMAC macro.
- A system error dump can occur when servicing a PHYBC macro
request. See Messages (System Error and
Offline) for more information.
Examples
None.