Global DSECT override parameters
Global DSECT override parameters override the equivalent &SW00var statements found in the DSECT macro, where var equals the 3-digit global parameter, for example, ARS.
For more information about these parameters, see Assigning values to global set symbols.
If you use a global override parameter, certain warnings may not be generated when assembling z/TPFDF applications because z/TPFDF API parameter error checking does not have access to the override parameters and uses the DSECT values instead.
- ADDCURR
- Specifies whether to limit the number of overflow blocks that are used when adding LRECs and
sets &SW00OP1 #BIT2. Specify one of the following:
- NO
- Specifies that the number of overflow blocks used is not limited.
- YES
- Specifies that the number of overflow blocks used is limited.
If no value is specified, the value specified on the OP1=opl parameter is used. If the OP1 parameter is not specified, the value for global set symbol &SW00OP1 #BIT2 is used.
Note: The overflow block limit is defined by using the NOC parameter on the DBDEF macro or by setting the number of blocks in the DSECT set symbol (&SW00NOC in the DSECT file). - ARS=blktype
- Specifies the overflow block size for the referenced file, where blktype is
one of the following block types:
- L0
- Specifies a 128-byte block size.
- L1
- Specifies a 381-byte block size.
- L2
- Specifies a 1055-byte block size.
- L4
- Specifies a 4095-byte block size.
ARS=L4 - BTREE
- Specifies whether B+Tree indexing is in use and
sets &SW00OP3 #BIT5. Specify one of the following values:
- NO
- Specifies that this file does not use B+Tree indexing.
- YES
- Specifies that this file does use B+Tree indexing.
If no value is specified, the value specified on the OP3=op3 parameter is used. If the OP3 parameter is not specified, the value for global set symbol &SW00OP3 #BIT5 is used.
- BOR=baseord
- Specifies the base relative ordinal for the file, where the value of baseord
is as follows:
- If this is a fixed file, set baseord to zero.
- If this is a miscellaneous file, baseord is a symbol (usually defined in
SYSEQ) that defines where the miscellaneous file starts in the miscellaneous fixed file type. By convention, this symbol is #, followed by the DSECT macro name, followed by F:
BOR=#dsnameF
The maximum value of the BOR parameter that you can specify is 4294967294.
Note: To specify an ordinal number greater than 2,147,483,647, you must specify the ordinal as a hexadecimal number. For example, to specify 2,147,483,648, enter BOR=X'80000000'. - CHAINCOR
-
Specifies whether the z/TPFDF product performs automatic chain correction if a broken chain is detected when you use a z/TPFDF macro or function to access an LREC. This parameter sets &SW00OP1 #BIT1. Specify one of the following:
- NO
- Specifies that automatic chain correction is not performed.
- YES
- Specifies that automatic chain correction is performed.
If no value is specified, the value specified on the OP1=op1 parameter is used. If the OP1 parameter is not specified, the value for global set symbol &SW00OP1 #BIT1 is used.
Note: Automatic chain correction is not performed under any of the following situations:- A broken chain is detected during any of the following operations:
- Operations that involve multiple LRECs when the z/TPFDF product does internal reads during processing of an external API, for example, during DBCPY or DBRST processing.
- During DBCLS processing if a subfile is being packed.
- The z/TPFDF product is traversing a z/TPFDF-managed index.
- CHAINHLD
- Specifies whether the z/TPFDF product issues a hold to
find an overflow block if the application specifies a hold. This parameter sets &SW00OP2 #BIT5.
Specify one of the following:
- NO
- Specifies that the z/TPFDF product finds an overflow block without issuing a hold (that is, the FINWC macro is issued), regardless of whether a hold is specified on the z/TPFDF API call (for example, with the HOLD parameter specified on the DBOPN macro or the DFRED_INDEX_HOLD option specified on the dfred function). This sets &SW00OP2 #BIT5 to 1.
- YES
- Specifies that the z/TPFDF product finds and holds overflow blocks by issuing a FIWHC macro if a hold is specified on the z/TPFDF API call. This sets &SW00OP2 #BIT5 to 0.
If no value is specified, the value specified on the OP2=op2 parameter is used. If the OP2 parameter is not specified, the value for global set symbol &SW00OP2 #BIT5 is used.
- CKPUKY
- Specifies whether the z/TPFDF product performs a
checkpoint automatically whenever the application program uses the DBUKY macro. This parameter sets
&SW00OP1 #BIT4. Specify one of the following:
- NO
- Specifies that checkpointing is not done automatically.
- YES
- Specifies that checkpointing is done automatically.
If no value is specified, the value specified on the OP1=op1 parameter is used. If the OP1 parameter is not specified, the value for global set symbol &SW00OP1 #BIT4 is used.
- DBUKY
- Specifies whether you want to allow application programs to generate unique keys by using the
DBUKY macro or the dfuky function. This parameter sets
&SW00OP3 #BIT7. Specify one of the following:
- NO
- Specifies that application programs cannot generate unique keys with the DBUKY macro or the dfuky function.
- YES
- Specifies that application programs can generate unique keys with the DBUKY macro or the dfuky function.
If no value is specified, the value specified on the OP3=op3 parameter is used. If the OP3 parameter is not specified, the value for global set symbol &SW00OP3 #BIT7 is used.
- DB010C
- Specifies whether the z/TPFDF product issues system
error DB010C and returns to the application program when a file that was opened without the
HOLD (DBOPN macro) or DFOPN_HOLD (dfopn function) parameter specified is modified and then
closed. This parameter sets &SW00OP2 #BIT6. Specify one of the following values:
- NO
- Specifies that system error DB010C is not issued when a file that is opened without the HOLD or DFOPN_HOLD parameter specified is modified and closed.
- YES
- Specifies that system error DB010C is issued when a file that is opened without the HOLD or DFOPN_HOLD parameter specified is modified and closed.
If no value is specified, the value specified on the OP2=op2 parameter is used. If the OP2 parameter is not specified, the value for global set symbol &SW00OP2 #BIT6 is used.
- DETAC
- Specifies whether the z/TPFDF product opens the
subfile in detac mode whenever it is opened and sets &SW00OP3 #BIT6. Specify one of the following:
- NO
- Specifies that the file is opened in detac mode only if the DETAC parameter is specified when the file is opened.
- YES
- Specifies that the file is always opened in detac mode.
If no value is specified, the value specified on the OP3=op3 parameter is used. If the OP3 parameter is not specified, the value for global set symbol &SW00OP3 #BIT6 is used.
- EOR=endord
Specifies the z/TPFDF end ordinal for the file (for z/TPFDF APIs and CRUISE),
where the value of endord is as follows:- If this is a non-partitioned and non-interleaved fixed file, do one of the following actions:
- If you want to use the entire FACE-type ordinal range, set endord to -1. The z/TPFDF product resolves the correct value when the file is opened.
- If you want to use only a subset of the FACE-type ordinal range, set endord to the wanted end ordinal.
- If this is a partitioned or interleaved file, specify the number of prime blocks in each
partition or interleave, not the total number of prime blocks in all partitions or interleaves, by
doing one of the following actions:
- If you want to use the entire FACE-type ordinal range, set endord to -1 . The z/TPFDF product calculates the number of ordinals in each partition based on the PTN parameter, or the number of ordinals in each interleave based on the ILV parameter.
- If you want to use only a subset of the FACE-type ordinal range, specify a number that is the
sum of the following values:
- The beginning ordinal (BOR)
- The number of ordinals that you want to have in each partition or interleave minus one
EOR=109
- If this is a miscellaneous file, endord is a symbol (usually defined in
SYSEQ) that defines where the miscellaneous file ends in the miscellaneous fixed file type. By
convention, this symbol is #, followed by the DSECT macro name, followed by L:
EOR=#dsnameL
The maximum value of the EOR parameter that you can specify is 4294967294.
Notes:- Do not set EOR to -1 unless EO# is
set to
-1too. Otherwise, the calculated z/TPFDF end ordinal might be incorrect, and z/TPFDF might use more ordinals than the ordinals that are processed by recoup. - The z/TPFDF end ordinal is used to determine the number of ordinals that are used by the z/TPFDF product during processing.
- To specify an ordinal number greater than 2,147,483,647, you must specify the ordinal as a hexadecimal number. For example, to specify 2,147,483,648, enter EOR=X'80000000'.

- If this is a non-partitioned and non-interleaved fixed file, do one of the following actions:
- EO#=faceendord
Specifies the FACE-type end ordinal (for recoup and
ZUDFM INIT), where the value of faceendord is as follows: - If this is a nonpartitioned and noninterleaved fixed file, set faceendord to -1.
- If the file is partitioned, set faceendord to -1 or the total number of prime blocks in all the partitions of the file.
- If the file is interleaved, set faceendord to -1 or the total number of prime blocks in all the interleaves of the file.
- If the file is miscellaneous, set faceendord equal to the symbol (usually
defined in SYSEQ) that defines where the miscellaneous file ends in the miscellaneous fixed file
type. By convention, this symbol is #, followed by the DSECT macro name, followed by L:
EO#=#dsnameL
The maximum value of the EO# parameter that you can specify is 4294967294.
Notes:- If &SW01EO# is not specified in the DSECT or the DBDEF EO# parameter override, -1 is used for fixed file types.
- If &SW01EO# is not specified in the DSECT or the DBDEF EO# parameter override, the &SW00BOR value or the DBDEF BOR parameter override, is used for miscellaneous files.
- Miscellaneous file type prefixes are defined in the z/TPFDF product with the &MISTYPE(n) array in segment DBLCL. You can define as many as 20 prefixes (including those shipped with the z/TPFDF product).
- To specify an ordinal number greater than 2,147,483,647, you must specify the ordinal as a hexadecimal number. For example, to specify 2,147,483,648, enter EO#=X'80000000'.

- FIRSTCH
- Specifies whether the first overflow block uses the block size specified for the prime block
instead of the block size specified for overflow blocks. This parameter sets &SW00OP1 #BIT5.
Specify one of the following values:
- NO
- Specifies that the first overflow block uses the block size specified for overflow blocks (the ARS parameter on the DBDEF macro or &SW00ARS in the DSECT).
- YES
- Specifies that the first overflow block uses the block size specified for prime blocks (the WRS parameter on the DBDEF macro or &SW00WRS in the DSECT).
If no value is specified, the value specified on the OP1=op1 parameter is used. If the OP1 parameter is not specified, the value for global set symbol &SW00OP1 #BIT5 is used.
- FIXINDEX
- Specifies whether the file is a fixed file and whether it has one or more index files that
reference it. This parameter sets &SW00OP3 #BIT3. Specify one of the following:
- NO
- Specifies that this is not a fixed file with one or more index files that reference it.
- YES
- Specifies that this is a fixed file with one or more index files that reference it.
If no value is specified, the value specified on the OP3=op3 parameter is used. If the OP3 parameter is not specified, the value for global set symbol &SW00OP3 #BIT3 is used.
- FULLBCH
- Specifies whether full backward chaining is used and sets &SW00OP1 #BIT0. Specify one of the
following values:
- NO
- Specifies that backward chaining is not used.
- YES
- Specifies that backward chaining is used.
If the DELEMPTY=YES parameter is coded on the DBDEF macro, you must specify YES for the FULLBCH parameter or ensure that bit 0 of global set symbol &SW00OP1 is set to 1.
If no value is specified, the value specified on the OP1=op1 parameter is used. If the OP1 parameter is not specified, the value for global set symbol &SW00OP1 #BIT0 is used.
- ILV=ilvnum
- Specifies the interleaving number, where ilvnum is a nonnegative decimal
number. If ilvnum is a nonzero value, it implies that the file is
interleaved. The number that you assign defines the number of interleaves. For example:
ILV=3Note: The z/TPFDF end ordinal (EOR) defines the relative end ordinal number of each interleave. If EOR is set to -1, z/TPFDF calculates the number of ordinals in each interleave. - INDEXCKP
- Specifies whether the z/TPFDF product performs a
checkpoint automatically whenever an index LREC is added or deleted from an index file. This
parameter sets &SW00OP3 #BIT4. Specify one of the following values:
- NO
- Specifies that a checkpoint is not performed whenever an index LREC is added to or deleted from an index file.
- YES
- Specifies that a checkpoint is performed whenever an index LREC is added to or deleted from an index file.
If no value is specified, the value specified on the OP3=op3 parameter is used. If the OP3 parameter is not specified, the value for global set symbol &SW00OP3 #BIT4 is used.
- MOREPACK
- specifies whether the z/TPFDF product always checks
for the packing criteria specified by &SW00PIN in every block that has been modified, regardless
of whether the DBDEL macro or the dfdel function has
been used to delete LRECs. This parameter sets &SW00OP1 #BIT6. Specify one of the following values:
- NO
- Specifies that the z/TPFDF product does not check the packing criteria.
- YES
- Specifies that the z/TPFDF product checks the packing criteria.
If no value is specified, the value specified on the OP1=op1 parameter is used. If the OP1 parameter is not specified, the value for global set symbol &SW00OP1 #BIT6 is used.
- NABVAL
- Specifies whether the z/TPFDF product validates the
next available byte (NAB) every time it files a block. This parameter sets &SW00OP2 #BIT0.
Specify one of the following values:
- NO
- Specifies that the z/TPFDF product does not validate the NAB.
- YES
- Specifies that the z/TPFDF product validates the NAB.
If no value is specified, the value specified on the OP2=op2 parameter is used. If the OP2 parameter is not specified, the value for global set symbol &SW00OP2 #BIT0 is used.
- NLR=maxlrecs
- Specifies the number of LRECs that can fit into each prime block
of a file, where maxlrecs is a nonnegative
decimal number. Only assign a value to &SW00NLR when the file
uses algorithm #TPFDB0D. With this algorithm, the file contains only
prime blocks. All LRECs must be fixed-length. Set NLR to
the maximum number of LRECs that can fit into each prime block of
the file. Notes:
- The NLR parameter is not allowed for B+Tree data files.
- Using the NLR parameter will result in an MNOTE being issued because the z/TPFDF product calculates this value, and any value specified is ignored.
- NOC=maxchains
- Specifies the maximum number of overflow blocks to use in implementing
add current files, where maxchains is a
decimal number from 0 to 255. If NOC is set to zero, the z/TPFDF product uses only
the prime block of the subfile. Only assign a value to NOC when bit
2 of &SW00OP1 is set on. For example:
instructs the z/TPFDF product to use the prime block and 5 overflow blocks.NOC=5 - OP1=op1
- Specifies z/TPFDF processing
options, where op1 is a bit setting that
overrides the &SW00OP1 bit setting. For example:
OP1=10000000In the example, OP1 bit 0 is set to indicate that the file uses backward chaining and resets all other bits of OP1 to 0. See Assigning values to global set symbols for more information about &SW00OP1 processing options.
- OP2=op2
- Specifies z/TPFDF processing
options, where op2 is a bit setting that
overrides the &SW00OP2 bit setting. For example:
OP2=00010000In the example, OP2 bit 3 is set so that the file uses new overflow blocks and releases old overflow blocks when a tape load operation completes successfully. This resets all other bits of OP2. See Assigning values to global set symbols for more information about &SW00OP2 processing options.
- OP3=op3
- Specifies z/TPFDF processing
options, where op3 is a bit setting that
overrides the &SW00OP3 bit setting. For example:
OP3=00000100In the example, OP3 bit 5 is set to indicate that the file uses B+Tree indexing. This resets all other bits of OP3. See Assigning values to global set symbols for more information about &SW00OP3 processing options.
If this parameter is specified, the value for bit 0 must match the value specified for bit 0 in the &SW00OP3 variable in the corresponding DSECT because the assembler APIs use the value specified in the &SW00OP3 variable of the DSECT.
- PACKNEW
- Specifies whether new pools are used for overflow blocks when a file is packed and sets
&SW00OP2 #BIT1. Specify one of the following values:
- NO
- Specifies that new pools are not used for overflow blocks when a file is packed.
- YES
- Specifies that new pools are used for overflow blocks when a file is packed.
If no value is specified, the value specified on the OP2=op2 parameter is used. If the OP2 parameter is not specified, the value for global set symbol &SW00OP2 #BIT1 is used.
New pools are not used for prime blocks when a file is packed regardless of this setting
- PIN=packthresh
- Specifies the packing threshold, where packthresh is
a decimal number in the range 0 - 100. For example:
PIN=60 - PRIMEHLD
- Specifies whether the z/TPFDF product issues a hold to
find the prime block if the application specifies a hold. This parameter sets &SW00OP2 #BIT4.
Specify one of the following values:
- NO
- Specifies that the z/TPFDF product finds the prime block without issuing a hold (that is, the FINWC macro is issued), regardless of whether a hold is specified on the z/TPFDF API call (for example, with the HOLD parameter specified on the DBOPN macro or the DFRED_INDEX_HOLD option specified on the dfred function. This sets &SW00OP2 #BIT4 to 1.
- YES
- Specifies that the z/TPFDF product finds and holds the prime block by issuing a FIWHC macro if a hold is specified on the z/TPFDF API call. Because open file processing does not perform an I/O, the FIWHC macro is processed on the subsequent z/TPFDF call that accesses the subfile. This sets &SW00OP2 #BIT4 to 0.
If no value is specified, the value specified on the OP2=op2 parameter is used. If the OP2 parameter is not specified, the value for global set symbol &SW00OP2 #BIT4 is used.
- PTN=ptnnum
- Specifies the number of partitions, where ptnnum is
a nonnegative decimal number. If ptnnum is
a nonzero value, it implies that the file is partitioned. The number
you assign defines the number of partitions. For example:
PTN=4For more information about partitioning, see Partitions.
Note: The z/TPFDF end ordinal (EOR) defines the relative end ordinal number of each partition. If EOR is set to -1, z/TPFDF calculates the number of ordinals in each partition. - PUSHDOWN
- Specifies whether pushdown chaining is used and sets &SW00OP1 #BIT3. Specify one of the
following values:
- NO
- Specifies that pushdown chaining is not used.
- YES
- Specifies that pushdown chaining is used.
If no value is specified, the value specified on the OP1=op1 parameter is used. If the OP1 parameter is not specified, the value for global set symbol &SW00OP1 #BIT3 is used.
- RBV=algtype
- Specifies the algorithm you want to use with this file, where algtype is one
of the following values:
- #TPFDB01
- #TPFDB02
- #TPFDB03
- #TPFDB04
- #TPFDB05
- #TPFDB06
- #TPFDB07
- #TPFDB08
- #TPFDB09
- #TPFDB0A
- #TPFDB0B
- #TPFDB0C
- #TPFDB0D
- #TPFDB0F
- #TPFDB10
- #TPFDB11
- #TPFDB12
- #TPFDBFF
For example:
RBV=#TPFDB0CYou can also create a unique user-defined algorithm and specify it as algtype. See the &SW00RBV description in Assigning values to global set symbols for more information about specifying an algorithm.
If this parameter is specified, the value must match the value specified by the &SW00RBV variable in the corresponding DSECT (if present) because the assembler APIs use the value specified in the &SW00RBV variable of the DSECT.
- RCT=recordtype
- Specifies the record type for fixed or miscellaneous files, where recordtype is
a defined record type. The record type must not be defined as processor
unique or I-stream unique on the RAMFIL macro in the SIP stage 1 deck.
See z/TPF and z/TPFDF System Generation for
more information about the RAMFIL macro. For example:
RCT=#USREC - RSTNEW
- Specifies whether new pools are used when a file is restored and sets &SW00OP2 #BIT2.
Specify one of the following values:
- NO
- Specifies that new pools are not used when a file is restored.
- YES
- Specifies that new pools are used when a file is restored.
If no value is specified, the value specified on the OP2=op2 parameter is used. If the OP2 parameter is not specified, the value for global set symbol &SW00OP2 #BIT2 is used.
- SEQUPDT
- Specifies whether the z/TPFDF product maintains a file
sequence update counter in the prime block of the file. This parameter sets &SW00OP1 #BIT7.
Specify one of the following values:
- NO
- Specifies that the z/TPFDF product does not maintain a file sequence update counter. The prime block is filed only when it is updated.
- YES
- Specifies that the z/TPFDF product maintains a file sequence update counter. The
YES value might require additional input/output (I/O) each time the file is
modified because the prime block is always filed to ensure that the sequence number was updated.
You must specify this value when you call the DBRST macro with the SEQ parameter specified or the dfrst function with the DFRST_SEQ option specified. Additionally, consider specifying the YES value when you use z/TPF support for MongoDB or data event processing, or if you want faster ZUDFM displays.
If no value is specified, the value specified with the OP1 parameter is used. If the OP1 parameter is not specified, the value for global set symbol &SW00OP1 #BIT7 is used.
- SKE=ske
- Specifies the search key extract for block index support, where ske equals
the length, in bytes, of the key fields to be removed from the first
LREC of each overflow block. The z/TPFDF product stores this
in a TLREC (LREC ID = X'02'). The length you specify must
include the primary key (the LREC ID). For example, if the last field
in the key is GR21SRLAST, you would specify:
SKE='GR21SRLAST-GR21SRKEY+L'GR21SRLAST'Notes:- Make SKE large enough to hold any field used as a key field by any application program that might use this file.
- If the file contains several different formats of LRECs, each identified by a separate LREC ID, set SKE equal to the size of the largest key that needs to be used.
- Do not use block index support with add current files (these are indicated by bit 2 of &SW00OP1 being set).
- SKE is not allowed for B+Tree data files.
- TLDNEW
- Specifies whether new pools are used when a file is loaded from tape and sets &SW00OP2
#BIT3. Specify one of the following values:
- NO
- Specifies that new pools are not used when a file is loaded from tape.
- YES
- Specifies that new pools are used when a file is loaded from tape.
If no value is specified, the value specified on the OP2=op2 parameter is used. If the OP2 parameter is not specified, the value for global set symbol &SW00OP2 #BIT3 is used.
- TQK=maxtlrec
- Specifies the highest technical LREC ID that the z/TPFDF product can use for this file, where
maxtlrec is a decimal number in the range 1–15. For block indexed files,
maxtlrec must be set to a value greater than 2. For B+Tree data files, maxtlrec must be set
to a value greater than 4. For B+Tree index files, it
must be set to a value less than 3. For example:
TQK=2If the TQK parameter is not specified, the value for global set symbol &SW00TQK is used.
Note: Technical LREC IDs 1–15 are reserved for IBM. Except for B+Tree index files, set TQK=15 to avoid conflicts with the z/TPFDF product. - TYP=filetype
- Specifies the file type, where filetype is
R, W, T, or P. B+Tree data
files must be R-type files. For example:
TYP=RSee File names (DSECT names) for more information about file types.
- WID=fileid
- Specifies the file identifier, where fileid is a 2-character alphanumeric
value (for example, WID=AB), or a 4-character hexadecimal value (for example, WID=B075). The
fileid must resolve to a value from X'0001'–X'FFFF'. Use a unique file ID for
every file.
If this parameter is specified, the value must match the value specified by the &SW00WID variable in the corresponding DSECT (if present) because the assembler APIs use the value specified in the &SW00WID variable of the DSECT.
- WRS=blktype
- Specifies the size of the prime block, where blktype is
one of the following block types:
- L0
- Specifies a 128-byte block size.
- L1
- Specifies a 381-byte block size.
- L2
- Specifies a 1055-byte block size.
- L4
- Specifies a 4095-byte block size.
For example:
WRS=L4 - XTDLREC
- Specifies whether all LRECs in the file are extended LRECs and sets &SW00OP3 #BIT0. Specify
one of the following values:
- NO
- Specifies that not all LRECs in the file are extended LRECs.
- YES
- Specifies that all LRECs in the file are extended LRECs.
If no value is specified, the value specified on the OP3=op3 parameter is used. If the OP3 parameter is not specified, the value for global set symbol &SW00OP3 #BIT0 is used.
If XTDLREC=YES is specified, bit 0 must be set to 1 in the &SW00OP3 variable in the corresponding DSECT. If XTDLREC=NO is specified, bit 0 must be set to 0 in the &SW00OP3 variable.
