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

SCBLOCK

Prolog  

Control Block Contents  
   SCBLOCK DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


SCBLOCK Prolog

 Name       : SCBLOCK
 Description: Subcommand Control Block
 DSECT      : SCBLOCK
 Function   : The SCBLOCK describes the dynamic
              entry point for the SUBCOM function and is
              dynamically allocated from free storage by
              DMSITS.

 

SCBLOCK Control Block Content


SCBLOCK DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      SCBLOCK        Subcommand Control Block
0000    0 Signed       4 SCBFWPTR       CHAIN POINTER TO NEXT SCBLOCK
0004    4 Address      4 SCBWKWRD       AVAILABLE FOR USER INFORMATION
0008    8 Character    8 SCBNAME        NAME OF SUBCOMMAND ENVIRONMENT
0010   16 Dbl-Word     8 SCBPSW (0)     STARTING PSW FOR SUBCOMMAND
0010   16 Bitstring    1 SCBINT         PSW INTERRUPT BITS
      The following table shows the combination of bits
      in SCBPSW that determine what the various INTTYPEs are.
 INTTYPE             |BIT 0|BIT 1|    |BIT 7|HEX value
 --------------------------------------------------------
 NONE                   0     0        0     00
 EXTERNAL               0     0        1     01
 NONCONSOLE             0     1        0     40
 NONCONSOLE & EXTERNAL  0     1        1     41
 CONSOLE                1     0        0     80
 CONSOLE & EXTERNAL     1     0        1     81
 IO                     1     1        0     C0
 ALL                    1     1        1     C1
             NUCX FIELDS.  THESE ARE PRESENT, BUT NOT USED,
             IN SCBLOCKS ON THE NUCSCBLK CHAIN.
0011   17 Bitstring    1 SCBKEY         PSW KEY
0012   18 Bitstring    1 SCBSFLAG       SYSTEM FLAG BYTE.
          1... ....      SCBSFSYS       X'80' SCBSFSYS DENOTES "SYSTEM"
                                        ROUTINE -- WILL NOT BE
                                        AUTOMATICALLY DELETED DURING
                                        ABEND PROCESSING.
          .1.. ....      SCBSFSER       X'40' SCBSFSER DENOTES "SERVICE"
                                        ROUTINE -- WILL BE CALLED WITH
                                        "PURGE" ARGUMENT DURING ABEND
                                        PROCESSING.
          ..1. ....      SCBSFABN       X'20' SCBSFABN USED DURING ABEND
                                        PROCESSING.
          ...1 ....      SCBSFEND       X'10' SCBSFEND DENOTES 'END OF
                                        COMMAND' ROUTINE
          ..1. ....      SCBSFINT       SCBSFABN SCBSFINT USED DURING END
                                        OF COMMAND PROCESSING.
          .... 1...      SCBSPERM       X'08' SCBSPERM DENOTES THAT THIS
                                        NUCLEUS EXTENSION WON'T BE
                                        DELETED DURING NUCXDROP ALL
                                        PROCESS
          .... .1..      SCBSFIMM       X'04' SCBSFIMM DENOTES THAT THIS
                                        NUCLEUS EXTENSION CAN ALSO BE
                                        CALLED AS AN IMMEDIATE COMMAND
          .... ..1.      SCBSFX         X'02' SCBSFX DENOTES A LOOK-ASIDE
                                        ENTRY POINTING TO A REAL CMS
                                        NUCLEUS ROUTINE.
          .... ...1      SCBSHIDE       X'01' SCBSHIDE USED TO HIDE A
                                        NUCLEUS EXTENSION TEMPORARILY.
0013   19 Bitstring    1 SCBUFLAG       USER FLAG BYTE.
0014   20 Address      4 SCBENTR        ENTRY POINT ADDRESS IN PSW
0018   24 Address      4 SCBXORG        ADDRESS WHERE NUCLEUS EXTENSION
                                        WAS LOADED IN FREE STORAGE.
001C   28 Signed       4 SCBXLEN        LENGTH IN BYTES OF NUCLEUS
                                        EXTENSION. MAY BE ZERO FOR
                                        SECONDARY ENTRY POINTS.
0020   32 Bitstring    1 SCBSFLG2       F*2 SECOND FLAG BYTE
          1... ....      SCBSFA31       X'80' SCBSFA31 EXTENSION IS AMODE
                                        31
          .1.. ....      SCBSFA24       X'40' SCBSFA24 EXTENSION IS AMODE
                                        24
          ..1. ....      SCBSFSEG       X'20' SCBSFSEG SEGMENT RESIDENT
                                        WHEN BOTH ON, EXTENSION IS AMODE
                                        ANY, WHEN BOTH OFF, EXTENSION IS
                                        AMODE SAME.
          ...1 ....      SCBSFUNC       X'10' SCBSFUNC Indicate function
                                        can not be S5U29592 invoked from
                                        the command line
          .... 1...      SCBSMT         X'08' SCBSMT mt subcom
          .... .1..      SCBSTPRV       X'04' SCBSTPRV thread private
                                        subcom
0021   33 Bitstring    1 * (3)          RESERVED FOR FURTURE USE
0024   36 Character    8 SCBSEGID       LOGICAL SEGMENT IDENTIFIER
002C   44 Signed       4 SCBTESTK       thread execomm stack
0030   48 Dbl-Word     8 * (0)          KEEP DOUBLEWORD ALIGNED
          00000030       SCBLOCKB       *-SCBLOCK LENGTH IN BYTES
          00000006       SCBLOCKD       (SCBLOCKB+7)/8 LENGTH IN DWORD

 

SCBLOCK Storage Layout

          
*** SCBLOCK - Subcommand Control Block
*
*     +---------------------------+---------------------------+
*   0 |         SCBFWPTR          |         SCBWKWRD          |
*     +---------------------------+---------------------------+
*   8 |                       SCBNAME                         |
*     +------+------+------+------+---------------------------+
*  10 |SCBINT|SCBKEY|:SFLAG|:UFLAG|         SCBENTR           |
*     +------+------+------+------+---------------------------+
*  18 |         SCBXORG           |         SCBXLEN           |
*     +------+--------------------+---------------------------+
*  20 |:SFLG2|////////////////////|        SCBSEGID-          |
*     +------+--------------------+---------------------------+
*  28 |          -(024)           |         SCBTESTK          |
*     +---------------------------+---------------------------+
*  30
*
*** SCBLOCK - Subcommand Control Block

 

SCBLOCK Cross Reference

Symbol         Dspl Value
-------------- ---- -----
SCBENTR        0014
SCBFWPTR       0000
SCBINT         0010
SCBKEY         0011
SCBLOCKB       0030 00000030
SCBLOCKD       0030 00000006
SCBNAME        0008
SCBPSW         0010
SCBSEGID       0024
SCBSFABN       0012 20
SCBSFA24       0020 40
SCBSFA31       0020 80
SCBSFEND       0012 10
SCBSFIMM       0012 04
SCBSFINT       0012 20
SCBSFLAG       0012
SCBSFLG2       0020
SCBSFSEG       0020 20
SCBSFSER       0012 40
SCBSFSYS       0012 80
SCBSFUNC       0020 10
SCBSFX         0012 02
SCBSHIDE       0012 01
SCBSMT         0020 08
SCBSPERM       0012 08
SCBSTPRV       0020 04
SCBTESTK       002C
SCBUFLAG       0013
SCBWKWRD       0004
SCBXLEN        001C
SCBXORG        0018

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