Programming Interface Information:
This page documents intended Programming Interfaces that
allow the customer to write programs to obtain the services of z/VM.

SHVBLOCK

Prolog  

Control Block Contents  
   SHVBLOCK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


SHVBLOCK Prolog

 Name       : SHVBLOCK
 Description: Control BLocks for accessing shared variables
 DSECT      : SHVBLOCK
 Function   : Defines the CMS EXECCOMM Shared Variable Block
              Structure and some common declares for use.

 

SHVBLOCK Control Block Content


SHVBLOCK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      SHVBLOCK       Control BLocks for accessing shared variables
0000    0 Address      4 SHVNEXT        (+0) CHAIN POINTER (0 IF LAST)
0004    4 Address      4 SHVUSER        (+4) NOT USED, AVAILABLE FOR
                                        PRIVATE use EXCEPT DURING 'FETCH
                                        NEXT'
0008    8 Character    1 SHVCODE        (+8) INDIVIDUAL FUNCTION CODE
0009    9 Bitstring    1 SHVRET         (+9) INDIVIDUAL RETURN CODE FLAG
000A   10 Signed       2 *              RESERVED, SHOULD BE ZERO
000C   12 Signed       4 SHVBUFL        (+12) LENGTH OF 'FETCH' VALUE
                                        BUFFER
0010   16 Address      4 SHVNAMA        (+16) ADDR OF PUBLIC VARIABLE
                                        NAME
0014   20 Signed       4 SHVNAML        (+20) LENGTH OF PUBLIC VARIABLE
                                        NAME
0018   24 Address      4 SHVVALA        (+24) ADDR OF VALUE BUFFER (0 IF
                                        NONE)
001C   28 Signed       4 SHVVALL        (+28) LENGTH OF VALUE (SET BY
                                        'FETCH')
          00000020       SHVBLEN        *-SHVBLOCK (LENGTH OF THIS BLOCK
                                        = 32)
          FUNCTION CODES (SHVCODE):
          000000C6       SHVFETCH       C'F' COPY VALUE OF SHARED VAR TO
                                        BUFFER
          000000E2       SHVSTORE       C'S' STORE GIVEN VALUE IN SHARED
                                        VARIABLE The following function
                                        codes only apply to the System
                                        Product Interpreter.
          (Note that the symbolic name codes are lowercase)
          000000C4       SHVDROPV       C'D' DROP VARIABLE
          1... .11.      SHVSYFET       X'86' =C'f' SYMBOLIC NAME FETCH
                                        VARIABLE
          1.1. ..1.      SHVSYSET       X'A2' =C's' SYMBOLIC NAME SET
                                        VARIABLE
          1... .1..      SHVSYDRO       X'84' =C'd' SYMBOLIC NAME DROP
                                        VARIABLE
          000000D5       SHVNEXTV       C'N' FETCH 'NEXT' VARIABLE
          000000D7       SHVPRIV        C'P' FETCH PRIVATE INFORMATION
          RETURN CODE FLAGS (SHVRET):
          .... ....      SHVCLEAN       X'00' EXECUTION WAS OK
          .... ...1      SHVNEWV        X'01' VARIABLE DID NOT EXIST (SP
                                        interpreter only)
          .... ..1.      SHVLVAR        X'02' LAST VARIABLE TRANSFERRED
                                        (FOR N)
          .... .1..      SHVTRUNC       X'04' TRUNCATION OCCURRED FOR
                                        'FETCH'
          .... 1...      SHVBADN        X'08' INVALID VARIABLE NAME
          ...1 ....      SHVBADV        X'10' INVALID VARIABLE VALUE,
                                        e.g. too long (EXEC 2 ONLY).
          1... ....      SHVBADF        X'80' INVALID FUNCTION CODE
                                        (SHVCODE)

 

SHVBLOCK Storage Layout

          
*** SHVBLOCK - Control BLocks for accessing shared variables
*
*     +---------------------------+---------------------------+
*   0 |         SHVNEXT           |         SHVUSER           |
*     +------+------+-------------+---------------------------+
*   8 |:CODE |SHVRET|/////////////|         SHVBUFL           |
*     +------+------+-------------+---------------------------+
*  10 |         SHVNAMA           |         SHVNAML           |
*     +---------------------------+---------------------------+
*  18 |         SHVVALA           |         SHVVALL           |
*     +---------------------------+---------------------------+
*  20
*
*** SHVBLOCK - Control BLocks for accessing shared variables

 

SHVBLOCK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
SHVBADF        001C 80
SHVBADN        001C 08
SHVBADV        001C 10
SHVBLEN        001C 00000020
SHVBUFL        000C
SHVCLEAN       001C 00
SHVCODE        0008
SHVDROPV       001C 000000C4
SHVFETCH       001C 000000C6
SHVLVAR        001C 02
SHVNAMA        0010
SHVNAML        0014
SHVNEWV        001C 01
SHVNEXT        0000
SHVNEXTV       001C 000000D5
SHVPRIV        001C 000000D7
SHVRET         0009
SHVSTORE       001C 000000E2
SHVSYDRO       001C 84
SHVSYFET       001C 86
SHVSYSET       001C A2
SHVTRUNC       001C 04
SHVUSER        0004
SHVVALA        0018
SHVVALL        001C

This information is based on z/VM V6R1.0.
Last updated on 23 Oct 2009 at 11:03:16 EDT.
Copyright IBM Corporation, 1990, 2008