Programming Interface Information:
This information is NOT intended to be
used as Programming Interfaces of z/VM.

PATH

Prolog  

Control Block Contents  
   PATH DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  


PATH Prolog

 Name       : DMSPATH
 Description: PATH TABLE MAPPING
 DSECT      : PATH
 Function   : THE PATH TABLE IS A LINKED LIST OF
              PATH ENTRIES USED BY THE CMS CONSOLE FACILITY.
              A NEW ENTRY IS CREATED WHEN A PATH IS BEING
              OPENED, AND DELETED WHEN AN APPLICATION ISSUES
              A CONSOLE CLOSE.

 

PATH Control Block Content


PATH DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      PATH           PATH TABLE MAPPING
0000    0 Address      4 PATHNEXT       ADDR OF NEXT PATH ENTRY
0004    4 Address      4 PATHDEVP       PTR TO ASSOCIATED DEVICE ENTRY
0008    8 Signed       4 PATHCQY (0)    SECTION TO BE MOVED TO USER'S
                                        BUFFER
0008    8 Address      4 PATHEXIT       USER EXIT ADDRESS
000C   12 Signed       4 PATHUWRD       USERWORD
0010   16 Bitstring    1 PATHFLG        PATH FLAG
          1... ....      PATHLIO        X'80' PATH DID LAST I/O TO ASSOC.
                                        DEVICE
          .1.. ....      PATHQRY        X'40' INDICATE REQUERY DEVICE
                                        INFO.
          ..1. ....      PATHA31        X'20' EXIT USES AMODE 31
          ...1 ....      PATHNRST       X'10' DO NOT RESET DEDICATED
                                        DEVICES
0011   17 Bitstring    3 *              RESERVED
0014   20 Signed       4 *              RESERVED
0018   24 Bitstring   12 PATHSCSW (0)   CSW INFORMATION
0018   24 Bitstring    1 PATHSLCC       LOGOUT PENDING/CONDITION CODES
          1111 1...      PATHKSL        X'F8' KEY/SUSPEND/LOG (ALL 5
                                        BITS)
          .... .1..      PATHLOG        X'04' LOGOUT PENDING
          .... ..11      PATHCC         X'03' DEFERRED CONDITION CODE
0019   25 Bitstring    3 PATHCTL        ORB AND SUBCHANNEL CONTROL BITS
001C   28 Address      4 PATHCCW        LAST CCW EXECUTED
0020   32 Bitstring    1 PATHUST        UNIT STATUS BYTE
          1... ....      PATHATTN       X'80' ATTENTION
          .1.. ....      PATHSTMD       X'40' STATUS MODIFIER
          ..1. ....      PATHCUE        X'20' CONTROL UNIT END
          ...1 ....      PATHBUSY       X'10' BUSY
          .... 1...      PATHCHEN       X'08' CHANNEL END
          .... .1..      PATHDVEN       X'04' DEVICE END
          .... ..1.      PATHUNCK       X'02' UNIT CHECK
          .... ...1      PATHUNEX       X'01' UNIT EXCEPTION
0021   33 Bitstring    1 PATHCST        CHANNEL STATUS BYTE
0022   34 Signed       2 PATHRCT        RESIDUAL COUNT
0024   36 Signed       4 PATHSCT        SENSE COUNT
0028   40 Bitstring   32 PATHSEN        SENSE DATA
0048   72 Character   16 PATHNAME       PATH NAME
          00000058       PATHSIZE       *-PATH LENGTH OF PATH ENTRY
          0000000B       PATHDBSZ       ((PATHSIZE+7)/8) SIZE OF PATH
                                        ENTRY IN DBWRDS

 

PATH Storage Layout

          
*** PATH - PATH TABLE MAPPING
*
*     +---------------------------+---------------------------+
*   0 |         PATHNEXT          |         PATHDEVP          |
*     +---------------------------+---------------------------+
*   8 |         PATHEXIT          |         PATHUWRD          |
*     +------+--------------------+---------------------------+
*  10 |:HFLG |////////////////////|///////////////////////////|
*     +------+--------------------+---------------------------+
*  18 |:HSLCC|      PATHCTL       |         PATHCCW           |
*     +------+------+-------------+---------------------------+
*  20 |:HUST |:HCST |  PATHRCT    |         PATHSCT           |
*     +------+------+-------------+---------------------------+
*  28 |                                                       |
*     =                       PATHSEN                         =
*     |                                                       |
*     +-------------------------------------------------------+
*  48 |                       PATHNAME                        |
*     |                                                       |
*     +-------------------------------------------------------+
*  58
*
*** PATH - PATH TABLE MAPPING

 

PATH Cross Reference

Symbol         Dspl Value
-------------- ---- -----
PATHATTN       0020 80
PATHA31        0010 20
PATHBUSY       0020 10
PATHCC         0018 03
PATHCCW        001C
PATHCHEN       0020 08
PATHCQY        0008
PATHCST        0021
PATHCTL        0019
PATHCUE        0020 20
PATHDBSZ       0048 0000000B
PATHDEVP       0004
PATHDVEN       0020 04
PATHEXIT       0008
PATHFLG        0010
PATHKSL        0018 F8
PATHLIO        0010 80
PATHLOG        0018 04
PATHNAME       0048
PATHNEXT       0000
PATHNRST       0010 10
PATHQRY        0010 40
PATHRCT        0022
PATHSCSW       0018
PATHSCT        0024
PATHSEN        0028
PATHSIZE       0048 00000058
PATHSLCC       0018
PATHSTMD       0020 40
PATHUNCK       0020 02
PATHUNEX       0020 01
PATHUST        0020
PATHUWRD       000C

This information is based on z/VM V4R3.0.
Last updated on 1 May 2002 at 14:08:00 EDT.
Copyright IBM Corporation, 1990, 2002