GBLK entry for GETBLK macro (Part 1)
- Entry:
- GBLK
- VIT option:
- SMS
- Event:
- GETBLK macro
- VIT processing module:
- ISTRACSM
- Control is returned to:
- ISTORCDG or ISTORCGB
This trace record shows the status of each GETBLK request issued by VTAM® components.
The FREEBLK macro is the complement of the GETBLK macro. FREEBLK must release the storage obtained by GETBLK. Each GBLK entry should eventually have a corresponding FBLK entry.
If the return code is nonzero, this entry is generated
whether the SMS option is in effect or not. It is treated as an exception
condition and is always traced if the VIT is active, regardless of
the SMS option.
- Byte (hex)
- Contents
- 00–03
- Record ID: C"GBLK"
- 04
- ID is the primary address space ID (ASID). This field is 0 if the ASID is greater than X'FF'.
- 05
- Return code
- 06
- If GBLK is followed by GBL2:
- 00
- AMUTSCBS
- 01
- AMUTSCBL
- 02
- CMPTAB
- 03
- LNKDSTAB
- 04
- MNPSRECV
- 05
- ICV29CMP
If GBLK is not followed by GBL2, possible storage pool types (in hexadecimal format) follow (see z/OS Communications Server: SNA Network Implementation Guide for more information about storage pools):00 RUPEPRIV 22 UTILCSAL 44 WAR 66 BFRTRFUL 01 RUPECOMM 23 AMU 45 UVRPL 67 SLENT 02 SIB 24 HSICB 46 DCX 68 DYPATH 03 SSCPFMCB 25 LMTABLE 47 PLUSDATA 69 PCDCA 04 NQDAT 26 SAB 48 ADJCP 6A XNINFO 05 EPTDVT 27 RAB 49 ATGB 6B GRINS 06 CDRSC 28 PRIDBLK 4A TGP 6C BSBEXT 07 ACDEB 29 PRIDQAB 4B KEYTOKEN 6D SOCKET 08 HSQH 2A AUTOLOGN 4C TRSINFO 6E MIWKE 09 ERTE 2B CPWACSA 4D COS 6F IAP 0A WREEID 2C PGIOBLK 4E NDREC 70 LIA 0B FMCBEXT 2D PRDLE 4F TGREC 71 IPWKE 0C SIBEXT 2E RIBRANT 50 ACPCB 72 VRDCB 0D (Not used) 2F CANT 51 DECB 73 UNSOL 0E UECB 30 CAB 52 NIDCB 74 COWE 0F IOBLOCK 31 CNSFACUD 53 CPRUPE 75 MARB 10 SRTE 32 BFRTRACE 54 ANDCB 76 VRRSB 11 ISTTRCEL 33 DMTSQ 55 DISKIO 77 DDEL 12 UTILPVTS 34 FMCB 56 DSERVER 78 SOCCBEXT 13 VRPL 35 PLUSFMCB 57 ADJNODE 79 RTPINFO 14 POWEPRIV 36 PXBFIXED 58 CACHE 7A CMIPPVT 15 POWECOMM 37 PXBPAGED 59 ISTSITCB 7B PVTSTATC 16 PULURDTE 38 PLUSC 5A ISTENDEL 7C PAGBLBSB 17 PAQ 39 NSSCB 5B CORCB 7D TIPACX 18 RAQ 3A (Not used) 5C LCB 7E CMOBJ 19 CPWAPVT 3B (Not used) 5D OSCB 7F CFSPRIV 1A ERICPOOL 3C (Not used) 5E SCCB 80 CFSCSA 1B SIBIX 3D FMH5 5F DSUTIL 81 SPTPOOL 1C CDAJSCP 3E OOBTSCB 60 PLOCB 82 HPRINFO 1D GWNAJSCP 3F SLD 61 TREEBLD 84 IPADDR 1E IOSIB 40 NSRUS 62 IOBLOCKL 85 IOBLOCKP 1F DSSIB 41 NSRUL 63 POWMPRIV 20 UTILPVTL 42 RUCON 64 POWMCOMM 21 UTILCSAS 43 STB 65 POAPRIV
- 07
- Flags:
- Bit
- Meaning
- 1... ....
- Length of storage requested and length of storage obtained are in GBL2 continuation
- .1.. ....
- Length of storage requested and length of storage obtained are in GBL3 continuation
- ..xx xxx.
- 0
- .... ...1
- GETBLK request converted to VTALLOC request
- 08–0B
- Address of block obtained (or 0 if GETBLK failed)
- 0C–0F
- Address of storage pool anchor block (SPTAE) or, if GBLK is followed by GBL2, address of DSPSP
- 10–13
- Address of the issuer of the GETBLK macro
- 14–15
- If byte 07, bits 0 and 1 are 0, length of storage specified by the user. Otherwise, 0.
- 16-17
- If byte 07, bits 0 and 1, are 0, length of storage obtained, rounded to the correct subpool length. Otherwise, 0. This length does not include the 8-byte GETBLK header.
- 18-1B
- Caller of utility routine or 0. If the GETBLK macro was issued from a utility routine, the address of the utility's caller is placed here. A 0 address indicates that the macro was issued directly by the caller (see return address) without a utility routine.
- 1C-1F
- Request parameter header (RPH) address