SUBJECT: APAR NUMBER: PK10080
REFERENCE: AREA: TPFDF ZUDFM ROUTINES
SEGMENT: UFBD13 - RELEASE: TPFDF (Assembler)
SEGMENT: UFBY13 - RELEASE: TPFDF (Assembler)
SEGMENT: UFCB13 - RELEASE: TPFDF (Assembler)
SEGMENT: UFCC13 - RELEASE: TPFDF (Assembler)
SEGMENT: UFCJ13 - RELEASE: TPFDF (Assembler)
SEGMENT: UFC213 - RELEASE: TPFDF (Assembler)
SEGMENT: UFC913 - RELEASE: TPFDF (Assembler)
Pre-requisite APARs are (TPF only) :
FOR SEGMENT UFBD13 (Assembler) - REL TPFDF
PN19872 PN57526 PN88105 PQ00810 PQ32210 PQ74483
FOR SEGMENT UFBY13 (Assembler) - REL TPFDF
PN71161 PN73989 PN76765 PQ00810 PQ10797 PQ10084 PQ23091
PQ26888 PQ51339 PQ60974 PQ51955 PQ74483 PQ94935
FOR SEGMENT UFCB13 (Assembler) - REL TPFDF
PN88105 PQ51955 PQ75887
FOR SEGMENT UFCC13 (Assembler) - REL TPFDF
PQ51955
FOR SEGMENT UFCJ13 (Assembler) - REL TPFDF
PQ02090 PQ04804 PQ07900 PQ51955 PQ75887
FOR SEGMENT UFC213 (Assembler) - REL TPFDF
PQ30389 PQ51955 PQ74483
To be applied in the order listed for each segment.
ABSTRACT OF PROBLEM
___________________
The ZUDFM DEF command cannot display the DBDEF option bits for
all files or display the files that match a given option bit
pattern.
COMMENTS ON PROBLEM
___________________
Currently, the ZUDFM DEF id/OPT entry can only display the
option bit settings for the specified file. The ZUDFM DEF
command cannot display the files that have certain option bit
settings, nor can the command display the option bit settings
for a specified option byte for all files. The ZUDFM DEF
command should be enhanced to display the bit settings of a
given option byte for all files in the DBDEF table or search the
specified option byte of all files for a specific bit pattern.
SOLUTION
________
o Segment UFC9 was introduced and segments UFBD and UFCJ have
been updated to enhance the ZUDFM DEF command in the fol-
lowing two ways:
- The entry ZUDFM DEF OPT/opx can be used to display the
option byte settings of all IDs (where opx is one of the
following: OP1, OP2, OP3, OP4, OP5 or CIN).
- The entry ZUDFM DEF OPT/opx/mask can be used to search
for the specified bit pattern of the given option byte
of all IDs.
o Segments UFCC, UFC2, and UFCB were modified to reflect the
new syntax and some syntax cleanup to ZUDFM DEF and ZUDFM
OAI/DBTAB when using ZUDFM HELP or ZUDFM OAH.
o Additionally, segment UFBY was updated to remove obsolete
references.
DEPENDENCIES
____________
Related Segments Affected By This APAR.
_______________________________________
Segments to be assembled or compiled:
Segments to be link edited:
Load Modules to be loaded:
Migration Considerations
========================
TPF customers must apply co-req APAR PJ30735.
The following applies to all customers:
Because the help screen was updated for this APAR, the help database
must be rebuilt after loading this APAR, by entering ZUDFM HELP BUILD.
A new message, UDFM0355E, was introduced with this APAR.
UDFM0355E UNABLE TO OBTAIN HEAP STORAGE
Explanation: The ZUDFM OAI/DBTAB command was entered, but an error
occurred because there are limited system resources available.
System Action: The ZUDFM command is rejected.
User Response: Do the following:
1. Enter the TPF ZSYSL and ZSTAT commands to check the system resources
and determine whether the system is shutting down.
2. Enter the ZUDFM OAI/DBTAB command again when resources become
available.
See TPFDF Commands for more information about the ZUDFM OAI/DBTAB
command. See TPF Operations for more information about the ZSYSL and
ZSTAT commands.
With this APAR applied, two new parameters have been added to ZUDFM DEF:
o ZUDFM DEP OPT/opx
Where opx displays the OP1, OP2, OP3, OP4, OP5 or CIN option or common
indicator bytes (as given) for all files.
o ZUDFM DEF OPT/opx/mask
Where opx displays the OP1, OP2, OP3, OP4, OP5 or CIN option or common
indicator bytes (as given) for all files that match the input bit
selection criteria provided with the mask variable. A Y in the display
indicates the bits that are set.
Where mask represents the 8 bits that make up the OP1, OP2, OP3, OP4,
OP5 or CIN option or common indicator bytes. The mask is specified as a
combination of eight Ys, Ns, and asterisks (*) that represent the option
bits to be matched or ignored for the specified byte (one character for
each bit position of the option byte). Y indicates that an option bit is
on. N indicates that an option bit is off. The * indicates that the
option bit can be on or off.
The following example displays option byte 3 values for all TPFDF
files:
1
User: ZUDFM DEF OPT/OP3
System: CSMP0097I 14.20.42 CPU-A SS-BSS SSU-BSS IS-01
UDFM0326I 14.20.42 DBTAB DISPLAY OF OP3
XTENDED IBM IBM INDEXED CHECKPT BTREE DEFAULT
DSECT RCID VN LRECS RESERVD RESERVD FIXFILE INDEX INDXING DETAC
------ ---- -- ------- ------- ------- ------- ------- ------- -------
UNIQUE
KEY
-------
IR70DF B070 00 . . . . . . .
.
IR71DF B071 00 . . . . . Y .
.
IR73DF B073 00 . . . . . Y .
.
IR75DF B075 00 . . . . . Y .
.
IR76DF B076 00 . . . . . Y .
.
IR77DF B077 00 . . . . . Y .
.
IR7BDF B07B 00 . . . . . . .
.
IR80DF B080 00 . . . . . . .
.
IR82DF B082 00 . . . . . Y .
.
IR82DF B082 01 . . . . . Y .
.
IR82DF B082 02 . . . . . Y .
.
IRA0DF B0A0 00 . . . . . . .
.
GR94DF BD04 00 . . . . . . .
.
GR95DF BD05 00 . . . . . . .
.
MORE DATA AVAILABLE, ENTER ZPAGE TO CONTINUE
The following example shows a list of all TPFDF files that match the
bit mask specified for byte CIN.
User: ZUDFM DEF OPT/CIN/*YYN****
System: CSMP0097I 17.54.00 CPU-B SS-BSS SSU-HPN IS-01
UDFM0326I 17.54.00 DBTAB DISPLAY OF CIN
IBM CHKKEYS FORCE BTREE KEYSAVE IBM DELETE NOPACK
DSECT RCID VN RESERVD REP/MOD UNIQUE NODE INDICTR RESERVD EMPTY RECOUP
------ ---- -- ------- ------- ------- ------- ------- ------- -------
IR71DF B071 00 . Y Y . . . Y .
IR73DF B073 00 . Y Y . . . . .
IR75DF B075 00 . Y Y . . . Y .
IR75DF B075 01 . Y Y . . . . .
IR76DF B076 00 . Y Y . . . . .
IR77DF B077 00 . Y Y . . . . .
IR82DF B082 00 . Y Y . . . Y .
END OF DISPLAY
-- END APAR PK10080
Click on Link(s) to Download File(s)
Download file(s):
Login once to access server, leave window open, then
click on link(s) below.
|