PSST

Prolog  

Control Block Contents  
   PSST DSECT

Storage Layout  

Cross Reference (Contains links to field and bit definitions)  

PSST Prolog

 Name       : HCPPSST
 Description: PTE Serialization Status Tracking block
 DSECT      : PSST
 Function   : A PTE Serialization Status Tracking block
              describes the PTE serialization that a task
              believes it currently holds on a specific
              PTE. It is not the actual PTE serialization
              state, but rather a record used by a routine
              to keep track of what it currently holds.
 Located by : N/A.
 Created by : N/A.
              This is not a control block that is allocated, but
              rather a DSECT typically used to redefine a portion
              of a savearea.
 Deleted by : N/A.
 Notes      : The HCPPGSER, HCPTPGSR, and HCPPTERD macros provide
              a TRACKING parameter which is used with this DSECT.
              HCPPGSER and HCPPTERD assist in maintaining the state
              of the PSST DSECT while HCPTPGSR will verify that the
              TRACKING value is consistent file the actual PTE
              serialization state reflected in the PGSTE.

PSST Control Block Content

PSST DSECT

Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      PSST           PTE Serialization Status Tracking
                                        block
      PSSFLAGS provides additional information related to the
      PTE serialization state in the PSSPGSER byte.
      PSSRESERVED must never be on because of dependencies in
      the HCPPGSER and HCPTPGSR macros.
0000    0 Bitstring    1 PSSFLAGS       Flag bits related to PSSPGSER.
          1... ....      PSSRESERVED    X'80' Reserved - must never be
                                        on.
          .... ...1      PSSREDRIVE     X'01' Task is committed to
                                        redrive.
      PSSPGSER is a code that represents the PTE Serialization
      state that the task currently holds. It is a record of
      what the task believes it holds, not the actual PTE
      Serialization state which is in the PGSTE. The value
      corresponds to a single PTE serialization state unlike
      the PGSTE which may need to reflect that both PCLONLY
      and SOFTLONG are held by different tasks.
0001    1 Bitstring    1 PSSPGSER       PTE Serialization task holds.
          00000000       PSSNONE        X'00' No PTE serialization is
                                        held.
          00000080       PSSPCLONLY     PSSPCL X'80'
          000000C0       PSSSHORT       PSSPCL+PSSPCL2 X'C0'
          000000E0       PSSHARDLONG    PSSPCL+PSSPCL2+PSSLTSER X'E0'
          00000060       PSSSOFTLONG    PSSPCL2+PSSLTSER X'60'
          000000C1       PSSERRSHORT    PSSPCL+PSSPCL2+PSSERROR X'C1'
          1... ....      PSSPCL         PGSPCL X'80'
      The following equates shouldn't be used directly. They
      define the individual bits that the PTE serialization states
      are composed of.
          00000040       PSSPCL2        PGSPCL2 X'40'
          00000020       PSSLTSER       PGSLTSER X'20'
          00000001       PSSERROR       PGSERROR X'01'
      END OF DEFINITION

PSST Storage Layout

          
*** PSST - PTE Serialization Status Tracking block
*
*     +------+------+
*   0 |:FLAGS|:PGSER| 2
*     +------+------+
*
*** PSST - PTE Serialization Status Tracking block

PSST Cross Reference

Symbol         Dspl Value
-------------- ---- -----
PSSERROR       0001 00000001
PSSERRSHORT    0001 000000C1
PSSFLAGS       0000
PSSHARDLONG    0001 000000E0
PSSLTSER       0001 00000020
PSSNONE        0001 00000000
PSSPCL         0001 80
PSSPCLONLY     0001 00000080
PSSPCL2        0001 00000040
PSSPGSER       0001
PSSREDRIVE     0000 01
PSSRESERVED    0000 80
PSSSHORT       0001 000000C0
PSSSOFTLONG    0001 00000060