DSN - File control dataset name

    MACRO NAME = DFHDSND
     DESCRIPTIVE NAME = CICS/ESA File control DATA-SET NAME BLOCK
                               and BASE CLUSTER block.
          Licensed Materials - Property of IBM
           Restricted Materials of IBM 
          5655-Y04
          (C) Copyright IBM Corp. 1983, 2016 
    FUNCTION =
          Create or map an instance of the DATASET NAME block.
          This block is dependent from the File Control Table,
          and contains a dataset name (up to 44 characters long)
          or equivalently a /VSE file-ID.
          It is pointed to by any number of FCT file entries,
          for either or both the purposes:
          a) to carry a name for possible DYNAMIC ALLOCATION when the
             file is next opened. (The "optative" name.)
          b) to represent the BASE CLUSTER (in VSAM), DATA SET (BDAM),
             (or any other entity) that the file, being open,
             can update and that CICS needs to guard for backout
             integrity.
                    DATASET NAME BLOCK
     The File Control Data Set Name Block (DSNB) holds the name
     for dynamic allocation of a data set. Any number of files
     (represented by File Control Table Entries, FCTEs) may address
     a DSNB. Dynamic allocation takes place at the time a file is
     opened. At this time, if the DSNB represents a VSAM base cluster
     or a BDAM data set, further information describing the data set
     is stored in the Base Cluster Block that is part of the DSNB.
    The following fields form part of the Product Sensitive
    Programming Interface :
      FCTDNAME
      FCTDNLEN
      FCTDNVAL bit setting in byte FCTDNFL1
      FCTBCFR, FCTBCLOG, FCTBCVAL, bit settings in byte FCTBCFL1
      FCTBCFRL
Table 1.
Offset Hex Type Len Name (Dim) Description
(0) STRUCTURE 0 DFHDSNDS DUMMY SECTION START
(0) CHARACTER 8 FCTDNRN resource name(='DSN_BLK:') ,
(8) CHARACTER 44 FCTDNAME dataset name ,
(34) ADDRESS 4 FCTDNNUM DATASET NUMBER (CC KEY) ,
(38) ADDRESS 4 FCTDNBCN DITTO OF CORR. BASE CLUSTER ,
(3C) HALFWORD 2 FCTDNUC USE COUNT ,
(3E) ADDRESS 1 FCTDNLEN EFFECTIVE LENGTH OF DSNAME ,
(3F) ADDRESS 1 FCTDNTYP DSTYPE=ESDS|KSDS| RRDS|PATH ,
(40) BITSTRING 1 FCTDNFL1 FLAGS ,
(40) 1... ....   FCTDNVAL "X'80'" DSN VALIDATED IN VSAM CAT. ,
(40) .1.. ....   FCTDNRLS "X'40'" Last open was in RLS mode ,
(40) ..1. ....   FCTDNQUI "X'20'" Data set is quiesced
(41) BITSTRING 3   Reserved ,
(44) CHARACTER 44 FCTDN_BASENAME Name of base if path ,
(70) ADDRESS 4 FCTDN_LOCK_TOKEN entry_lock token ,
(74) FULLWORD 4 (0) ALIGNMENT FOR INNER BLOCK ,
(74) .111 .1..   FCTDNINC "*" START OF BASE CLUSTER BLOCK ,
                  BASE CLUSTER BLOCK
(74) .111 .1..   DFHBCCDS "*" ,
(74) HALFWORD 2 FCTBCUC Count of ACBs that are open for files in the cluster, or are in transition to or from that state.
(76) HALFWORD 2 FCTBCUUC Count of ACBs open for update
(78) BITSTRING 1 FCTBCFL1 VARIOUS FLAGS -
(78) 1... ....   FCTBCSRP "X'80'" LOCALLY-SHARED RESOURCES APPLY
(78) .1.. ....   FCTBCKVL "X'40'" ATTRIBUTES ..KYL & ..RKP ARE VALID
(78) .111 1...   FCTBCRCV "FCTBCFL1" RECOVERY ATTRIBUTES OF BASE CLUSTER
(78) ..1. ....   FCTBCFR "X'20'" FORWARD RECOVERY
(78) ...1 ....   FCTBCLOG "X'10'" LOGGING
(78) .... 1...   FCTBCVAL "X'08'" VALID FLAG FOR RECOVERY ATTRIBUTES
(78) .... .1..   FCTBCMIS "X'04'" Recov Attrs Mismatch Flag
(78) .111 1...   FCTBCSHP "FCTBCFL1" SHARE OPTIONS INDICATOR
(78) .... ..11   FCTBSH4 "X'03'" SHARE OPTIONS 4
(78) .... ..1.   FCTBSH34 "X'02'" SHARE OPTIONS 3 OR 4
(78) .... ...1   FCTBSH24 "X'01'" SHARE OPTIONS 2 OR 4
(79) ADDRESS 1 FCTBCFRL FRLOG ID FOR FORWARD RECOVERY
(7A) ADDRESS 1 FCTBCAS AVAILABILITY STATE
(7A) ..1. ....   FCTBCUNA "X'20'" unavailability
(7A) ...1 ....   FCTBCRPL "X'10'" RREPL
(7B) ADDRESS 1 FCTBCKYL Length of key
(7C) ADDRESS 2 FCTBCRKP Relative key position
(7E) ADDRESS 4   Reserved D95683A
(80) FULLWORD 4 FCTBCCIS Base cluster Control Interval Size.
(84) ADDRESS 4 FCTBCVSC Anchor for chain of VSWAs executing requests against this base.
(88) FULLWORD 4 FCTBCSRB Relative byte address for ESDS
(8C) HALFWORD 2 FCTBCPUC No. of open ACBs with DSname sharing
(8E) HALFWORD 2 FCTBCRUC Count of ACBs that are open against this recoverable ESDS base.
(90) FULLWORD 1 FCTBCLSR LSR pool identifier
(91) BITSTRING 1 FCTBCFIC Fuzzy Image Copy flags
(91) 1... ....   FCTBCFUZ "X'80'" Fuzzy backup enabled
(91) .1.. ....   FCTBCVFS "X'40'" Valid fuzzy state
(92) HALFWORD 2 FCTBCFUC Fuzzy File update count
(94) ADDRESS 4 FCTBCACB Address of ACB for base cluster. Allocated at the time of first PUT ADD or MASS INSERT against the path.
(98) ADDRESS 4 (2) Add/Delete counts
(A0) ADDRESS 4 FCTBC_FLLB_CHAIN Start of FLLB chain
(A4) BITSTRING 1 FCTBC_RLS_INDS Data table and RLS flags
(A4) .1.. ....   FCTBC_LOST_LOCKS "X'40'" Data set in lost locks state
(A5) BITSTRING 1   Data table ECB
(A6) BITSTRING 1   Data table loaded ECB
(A7) BITSTRING 1 FCT_BC_MISC_INDS Assorted flags
(A7) 1... ....   FCTBC_EXTENDED "X'80'" Extended addressing
(A7) .1.. ....   FCTBC_THREADSAFE_WORK "X'40'" Threadsafe work done
(A7) ..1. ....   FCTBC_REPLICATION_LOG "X'20'" Replication logging active
(A8) CHARACTER 8   Table name
(B0) ADDRESS 4 FCTBCDTK Table token
(B4) ADDRESS 4   Open FCTE chain
(B8) FULLWORD 4 FCTBCTKN FR Log Tkn from CICS Logger
(BC) BITSTRING 1 FCTBCFL2 Recovery Attribute Flags
(BC) 1... ....   FCTBCCAT "X'80'" Attrs originate from catalog
(BC) .1.. ....   FCTBCRLS "X'40'" Attrs set on RLS file open
(BC) ..1. ....   FCTBCRA "X'20'" BCB has RLS ACBs open
(BC) ...1 ....   FCTBCNRA "X'10'" BCB has non-RLS ACBs open
(BC) .... 1...   FCTBCRCO "X'08'" XFCRLSCO has allowed RLS and non-RLS ACBs open for this base cluster block
(BC) .... .1..   FCTBCCON "X'04'" XFCRLSCO footprint FCN COEX
(BC) .... ..1.   FCTBCCOW "X'02'" XFCRLSCO footprint FCN WORK
(BC) .... ...1   FCTBCCOR "X'01'" XFCRLSCO footprint FCRO
(BD) CHARACTER 26 FCTBCCRL FR Logstream Name from Catalog
(D7) CHARACTER 1 FCTBC_QSTATE RLS quiesce progress state for QUICLOSE, QUICOPY or QUIBWO
(D8) FULLWORD 4 FCTBC_0890_COUNT Requests awaited for 08-90
(DC) CHARACTER 8 FCTBC_QTOKEN RLS quiesce token, returned to VSAM when QUICMP issued
(E4) ADDRESS 4 FCTBC_CONN_CHAIN Chain of connected FCTEs
(E8) ADDRESS 4 FCTBC_OWNING_FRAB Holder of ESDS write lock
(EC) FULLWORD 4 FCTBC_SAFE_RBA Highest safe RBA for update
(F0) FULLWORD 4 FCTBC_QCOUNT Number of UOWs to reach syncpoint before QUICMP can be issued for QUICOPY or QUIBWO
(F4) CHARACTER 8 FCTBC_BWO_STAMP OPEN TIMESTAMP FOR BWO
  Force doubleword alignment
(FC) ADDRESS 4 FCTBC_0890_CHAIN Head of 0890 wait chain
(100) CHARACTER 8 FCTBC_HI_XRBA Relative byte address for extended addressing ESDS
(108) CHARACTER 8 FCTBC_SAFE_XRBA Highest safe XRBA for update
(110) FULLWORD 4 FCTBC_LOCK_TOKEN BCB Lock Token
(114) FULLWORD 4 FCTBC_SPHERE_LOCK_ TOKEN SPHERE Lock Token
(118) FULLWORD 4 FCTBC_FRLOG_LK_TOKEN DSNB Log Lock Token
(11C) HALFWORD 2 FCTBC_NRUC Non RLS file open with updateable servreqs count
(11E) HALFWORD 2 FCTBCUCN Count of ACBs that are open against this dataset for Non RLS files
(120) HALFWORD 2 FCTBCUCR Count of ACBs that are open against this dataset for RLS files
(122) HALFWORD 2   Reserved
(128) DBL WORD 8 DFHBCEND (0) Align, to round up gross length to double word
(128) 1.11 .1..   DFHBCLEN "DFHBCEND-DFHBCCDS" ,
  Constants for FCTBC_QSTATE. This tracks the progress of a VSAM RLS
  QUICLOSE, QUICOPY or QUIBWO quiesce request.
(128) .... ....   FCTBC_QSTATE_NORMAL "0"
(128) .... ...1   FCTBC_QSTATE_ QUIESCING "1"
(128) .... ..1.   FCTBC_QSTATE_ QUIESCE_CANCELLING "2"
(128) .... ..11   FCTBC_QSTATE_COPYING "3"
(128) .... .1..   FCTBC_QSTATE_COPY_ CANCELLING "4"
(128) .... .1.1   FCTBC_QSTATE_COPY_ POLICING "5"
(128) .... .11.   FCTBC_QSTATE_BWOING "6"
(128) .... .111   FCTBC_QSTATE_BWO_ CANCELLING "7"