z/OS Service Package: X2026264
SMP/E SYSMOD:
Component:
Operating System:
Publish Date:
APAR & Description:
RS35006
FileKit
z/OS
2026/11/12
- IQ005610, IQ005613, IQ005618, IQ005619, IQ005620,
IQ005636, IQ005643, IQ005647, IQ005652, IQ005677:
- The following corrections and enhancements have been applied to the FSU (File
Search, Update, Copy) and FCOPY (File Copy) utilities:
- Support MKDIR (MD) option, used when copying to a ZFS/HFS file path from
another ZFS/HFS file directory. If necessary, the copy will create new
sub-directories in the destination directories with names that match the
selected input directories.
- Correct RECURSE option so that files in source ZFS/HFS sub-directories are
copied to sub-directories of the same name at the target ZFS/HFS location.
MKDIR should also be specified if the target directories do not already
exist.
- Support ARCHIVE (ARC) option, used when copying to a ZFS/HFS file path. If
the target file already exists, then before the copy occurs it will first be
renamed with a name in the following format:
%fn%-yyyymmdd-hhmmss.%ext%
Where %fn% is the original file name, and %ext% is the original
file extension.
- Support TIMECHK (TC) option, used when copying to and from ZFS/HFS file
paths or library members that have a "last changed" timestamp. TIMECHK will
compare the source and target last changed timestamps and only perform the
copy if the source file timestamp is later than that of the target file.
No timestamp check will occur for target files that do not have a last
changed timestamp.
- Give an error if copy to a library member fails due to failure to write the
directory record. e.g. no free PDS directory blocks.
- Correct loop that occurred in the MVS CHECK macro following a member I/O
error during a library copy operation.
- Correct possible 0C4 (and other errors) caused by unexpected positioning of
FSU primary command keywords.
- Correct loss of the first few data characters on each record when a ZFS/HFS
RECFM=V file is copied to a data set/library member. The number of characters
lost is equal to the size of the length field specified for the ZFS/HFS
RECFM=V file.
- Correct possible loop that occurred in FSU with a CHANGE ALL operand, where
an attempt to change a search string to a longer replace string fails. For
example, when the replace string would cause the record text to exceed
specified bounds or current record length.
- IQ005615, IQ005623:
- The following corrections and enhancements have been applied to the COMPFILE
(File Compare) utility:
- Support NOHEX option for LIST=TEXT output. This option will suppress
output of the vertical (up/down) display of hex values for text containing
unprintable characters.
- For LIST=FMT output, suppress generation of an SDO report mapping object
when NOREPORT is specified.
- IQ005611, IQ005612, IQ005625, IQ005633, IQ005640,
IQ005646, IQ005665, IQ005666, IQ005667, IQ005669,
IQ005672, IQ005676, IQ005680, IQ005681, IQ005682:
- The following corrections and enhancements have been applied to the REPORT utility:
- Introduce LIBRARY and CLD parameters on INPUT specification to support
multiple member input from a library DSN or concatenation of libraries.
For example, to input member "T015" and all members with names beginning
"T119" in library "CBL.TEST1":
INPUT:
CBL.TEST1(T119*,T015) \
USING SDO CBL.FKIT.SDO(TEST) \
LIBRARY
To input the first occurance of each member with name beginning "T" in a
library concatenation search path "CBL.TEST1, CBL.TEST2":
INPUT:
CBL.TEST1, CBL.TEST2(T*) \
USING SDO CBL.FKIT.SDO(TEST) \
CLD
- Support multiple, concurrent report output with different report formats
(JSON, XML, CSV and PRINT) simultaneously. Previously, to create the same
report output in different formats, the job would have to be executed
repeatedly, once for each required report format.
- Support extension to built-in function, BYPASS().
BYPASS([ [RECord] , [RESet] ])
where:
RECORD
For segmented record input (e.g. SMF records), bypass the current segment
and all remaining segments in the current record. By default, only the
current segment is bypassed.
RESET
If bypass has been triggered, then reset the field values that have been
set following input of the current record/segment, to null or blank values.
By default, these field values are reset to their original values as
assigned before input of the current record/segment.
- Support new built-in function, SKIP() which will bypass the current
record/segment but, unlike BYPASS(), will not attempt to reset field values
set following input of the current record/segment.
SKIP( [RECord] )
where:
RECORD
For segmented record input (e.g. SMF records), bypass the current segment
and all remaining segments in the current record. By default, only the
current segment is bypassed.
- Support new REPORT definition section INCLUDE:
The contents of data sets and/or library members named in this section will
be included as part of the REPORT definition input.
The contents of these files will be inserted immediately following their
specification in the INCLUDE: section.
For example:
INCLUDE:
CBL.FKIT.RPT(STD030)
CBL.FKIT.RPT(STD041)
Included definition control syntax may itself specify an INCLUDE: section
and so nested layers of included control statements may exist. To avoid
possible loops of nested included files, an error will occur if the same
file is included more than once.
- Correct situation where a BREAK section is specified without a SORT section
and input SMF records of different record types are to be processed. This
can lead to a missing report break due to the break key field being unset.
- IQ005651:
- The following corrections and enhancements have been
applied to DB2 utilities:
- Correct 0C4 that may occur on attempting to connect to a DB2 sub-system name
(SSN) that does not yet exist.
- IQ005638, IQ005650, IQ005657:
- The following corrections and enhancements have been applied to the Text Editor:
- Correct 0C4 that may occur when RCHANGE is executed in a text edit view of
a file which has a smaller LRECL than that of a file in a different text
edit view in which the last CHANGE operation was performed.
- Enhance the BLOCK Text-Edit (CBLE) REXX macro so that it will use values
set to FILE level environment variables "BLOCK_MAJ" and "BLOCK_MIN" as the
default major and minor target strings respectively.
BLOCK is usually assigned by the user to a PF Key or keyboard macro to
scroll to the next major or minor heading in the displayed text.
By default, major heading lines are identified as containing "***" or "===".
Minor heading lines are identified as containing "**" or "==".
This is equivalent to setting environment variables BLOCK_MAJ and BLOCK_MIN
as follows:
editv setlf BLOCK_MAJ /*** /|/===/
editv setlf BLOCK_MIN /** /|/==/
- Enhance the SV Text-Edit (CBLE) REXX macro so that it will bypass level and
timestamp header update on save if the library or data set DSN is one set to
the FILE level environment variable "SV#Exceptions".
For example, to bypass header update when using SV to save changes to
members edited from libraries "CBL.SS.LISTMAST" and "CBL.VV.LISTMAST", set
SV#Exceptions environment variable as follows:
EQU SV#Exceptions CBL.SS.LISTMAST CBL.VV.LISTMAST
- IQ005622, IQ005635, IQ005642, IQ005648, IQ005656,
IQ005675:
- The following corrections and enhancements have been applied to the Data Editor:
- Increase maximum prefix area width to 10 digits.
- Correct 0C4 that may occur on display of a record containing a long
horizontal hex field with comma and blank punctuation (i.e. fields of
record types HEX, VARHEX, HEXVAR, BIN or VARBIN).
- Correct INPUT primary command error where input of a value to a BINTEGER
field of length greater than 1-bit simply inputs a zero (0) value.
- For IMS database browse only, correct internal error message that occurred
when scrolling. "DOWN MAX" and repeated "UP" commands eventually gave this
internal error.
- Support DSN macro to extract the dataset name contents of the focus field
within a formatted record.
- IQ005617, IQ005626, IQ005631:
- The following corrections and enhancements have been applied to FILEIO
functionality:
- Support generic file input (like FSU or DIRDATA for SELCOPY).
+-----------+
v |
>>- FILEIO fid OPENREAD -- MASK --+-----------+----><
OPENUPD | |
+- CASEIGN -+
| |
+- SUBDIR --+
Where fid is a dataset, library member or ZFS/HFS file path containing wild
card characters as follows:
"*" (asterisk)
represents any character string of any or null length.
"%" (percent)
represents any character (i.e. length 1)
"CASEIGN" and "SUBDIR" apply to input of ZFS/HFS file paths only.
CASEIGN indicates that the character case in fid should be ignored when
matching file path names.
SUBDIR indicates that all matching file names in all sub-directories of the
directory specified in the file path will be read.
For example:
fileio /mnt/xn1/z/cg/*.kex openr name MSK mask \
caseign subdir
fileio CBL.SMF.GDG.* openr name MSK mask
fileio CBL.CBLI*.JCL(A*) openr name MSK mask
In the above, the name "MSK" is assigned to the input stream.
During input processing, return codes are set as follows:
RC=2
End of member (same as for normal LIBRARY or CLD input).
RC=4
End of dataset, HFS file or library.
RC=6
End of MASK input.
- Support new OPTION FILEID to set REXX variable name.1.FILEID to the current
input fileid for the named mask.
For example, if MSK is the name of the input stream, the following will set
MSK.1.FILEID to the current fileid:
fileio MSK option FILEID
- Support setting member timestamp and other library directory member
information.
Note: SETDIRINFO TIMESTAMP is also supported for ZFS/HFS file paths.
+---------------------+
v |
>>- FILEIO xxx SETDIRINFO -+---------------------+-><
| |
+ TIMESTAMP date time +
| |
+ USERID username ---+
| |
+ INISIZE nrecs ------+
| |
+ CURSIZE nrecs ------+
For example:
fileio NBJ.ASM openupdate
fileio NBJ.ASM member VCATALI
fileio NBJ.ASM setdirinfo timestamp 2025/05/14 16:36:01
fileio NBJ.ASM member VCATBLD
fileio NBJ.ASM setdirinfo cursize 22 inisize 11
- Correct bug which bypasses the update of the current record when UPDATE,
UPDATEV or UPDATEX is used and the supplied record is shorter than the
original. The updated record will now contain the new data plus the
remainder of the original record data.
- IQ005616, IQ005624, IQ005627, IQ005628, IQ005629,
IQ005630, IQ005632, IQ005634, IQ005639, IQ005645,
IQ005653, IQ005659, IQ005662, IQ005664:
- The following general corrections and enhancements have been applied to FileKIt:
- Enhance Library List (LL) output so that the member "Last Changed" timestamp
includes the number of seconds value.
- Correct RENAME for a VSAM object so that it no longer prompts the user for
a volser id. VSAM rename is a catalog update and volume serial id is not
required.
- Correct concatenated library directory (CLD) member list whereby a
directory block was being bypassed if its first entry is a member with a
null name.
- Additional ONLY primary command included in LLX output.
- Correct SMFB bug introduced by IQ005587 for basic display of SMF records
with FIND operand to filter records, resulting in all records being
excluded.
- Correct RANDOMIZER storage leak when a chain (e.g PATTERN) is used.
- Correct FILEKITB (batch) execution attempt to open a I/O progress window.
- Prevent FILEKITB (batch) execution error which occurred when no user INI
file exists.
- Update ERASE with operand "-Q" so that all messages are suppressed.
- Minor alterations to SELCDBJ macro which prepares JCL for SELCOPY Debug
run(s).
- Correct potential loop in output messages.
- Support DSNEWNAM for generic DSN RENAME.