z/OS Service Package: X2018018

SQ012320:: Incorrect row length (LRECL) returned from READ of a DB2 result table. This problem was introduced by PTF RI33002 to SELCOPY release 3.30.

SQ012315:: Dynamic Allocation of generation (+1) of a GDG gives immediate end-of-file on input. Same problem in previous release.

SQ012321:: Display of the BLKSIZE value for an output VSE sequential file within the SELCOPY SUMMARY block of the SYSLST output is missing. This problem is caused by APAR fix QI32001 to SELCOPY release 3.20.

IQ003961:

New callable interface, SLCIMS, introduced for SELCOPY in order to simplify IMS CHKP/XRST processing.

SLCIMS is a SELCOPY callable load module designed to be used in an IMS DL1 environment where checkpointing and restart is required.

SLCIMS is called via the SELCOPY CALL operation to perform one of the following IMS DL1 function calls when SELCOPY is executed via the IMS batch region controller (DFSRRC00):

A basic checkpoint (CHKP)
An extended restart (XRST)
An extended/symbolic checkpoint (CHKP)

Syntax:

    >> CALL SLCIMS -+- XRST -------------------------+-><
                    |                                |
                    |            +- SELC ------------+
                    |            |                   |
                    +- CHKP ---+-+-------------------+
                    |          | |                   |
                    +- XCHKP --+ +- chkp_pfx +-------+
                    +- SYMCHKP +             |       |
                                             + FORCE +

Features:

Operational in DLI or BMP regions.

Supports PSBs generated for all compiler languages (PEBGEN LANG=COBOL, PL/I or ASSEM).

Restores current position in all IMS databases being processed by SELCOPY following a checkpoint call.

Extended restart (XRST) call supports restart of a SELCOPY job from a checkpoint location. The following SELCOPY data areas are restored:
- The user work area buffer.
- For each open IMS DL1 database connection, the input and update segment counts, current and longest segment lengths, file size value and end-of-file status flag.
- The value assigned to each user &at; pointer variable.
Support for BMC Application Restart Control (AR/CTL) FORCEd check point to override its checkpoint pacing rule.

POS PCB is updated to point at the I/O PCB for the CHKP/XRST call. Therefore, POS STATUS will reference the CHKP/XRST status code.

Following a CHKP call, the system &at; pointer references the SLCIMS return object structure which contains the 8-character checkpoint identifier and status information on the Get Unique (GU) call performed on each database object in order to re-establish position.

POS RECODE and RETXV values indicate success or otherwise of the SLCIMS call.

For further details and examples of use, please refer to the SELCOPY IMS Call Module document.

IQ005007, IQ005004, IQ005002, IQ004996, IQ004968, IQ004964, IQ004960:

Text Editor fixes and enhancements:

EDITV command to set an environment variable has been updated to support DEL and DELF in order to unset an environment variable.

Correct possible loop in the DELALL macro that could occur if executed in ISPF mode and an ONLY command (or similar) has already been run.

Preserve REDO chain when a macro is executed. Loss occurred even if that executed macro did not make any changes to the file. (Loss of the REDO chain is expected if execution of the macro makes changes.)

Correct EQU macro to prevent "unexpected Error" message when attempting to set environment variable with name "RC".

Prevent "Unsupported SVC" message in VM/CMS with DOS ON when attempting to display a HEX dump view of a record (line command "HEX").

Correct possible 0C4 program check which occurred when the INPUT/INSERT primary command is executed and the focus line is beyond the End of File line marker.

IQ005029, IQ005028, IQ005024, IQ005020, IQ005018, IQ005017, IQ005015, IQ005014, IQ005010, IQ005009, IQ005006, IQ005005, IQ005001, IQ005000, IQ004998, IQ004958, IQ004951, IQ004944, IQ004924, IQ004831, IQ004828:

SDE Data Editor fixes and enhancements:

Correct 0C4 program check which occurred when SELCOPYi attempted to set the cursor position on a record which had been temporarily unloaded from storage by large dataset EDIT/BROWSE data management.

DELETE command default range changed to be ".ZFIRST .ZLAST" when DELETE ALL is used. When DELETE <n_lines> is used, the default range remains as ".ZCSR .ZLAST".

DELETE ALL EX erroneously deletes unexcluded lines if executed following LOCATE <n_lines>. This problem was introduced by PTF RS33003.

Introduce support for field specific help within an SDE Browse/Edit session for use internally by SELCOPYi panel table display.

Edit or Browse of a DB2 result table specified via a DB2 VIEW name has been enhanced so that, provided the VIEW has not referenced a table column as a different name, all primary key columns of all tables specified in the VIEW are identified.

Allow open parenthesis "(" to follow an equals symbol "=" in an SDE expression.

e.g. WHERE #5 = ((15*4-30/2)/3)

Support popup panels to filter and locate lines in the current Data Edit/Browse view. FILTER primary command supported to start the dialog panel that will execute an ALL (WHERE), MORE or LESS command. LOCATE primary command with no parameters updated to open the dialog panel which executes a LOCATE NEXT/PREV/FIRST/LAST command.

Correct possible 0C4 program check during DB2 edit with AUDIT log output. Problem occurred following insert of a row where data in the row was enough to write several audit log records.

Correct possible 0C1 program check which occurred following SAVE to dataset being edited for update-in-place.

Correct EXCLUDE primary command so that where parameter ".ZCSR .ZCSR" is used, only the focus line is excluded, not all lines.

Improve performance for DELETE when Auxiliary Edit method is used.

IQ004982, IQ004976, IQ004975, IQ004972:

SDE Structure definition fixes and enhancements:

Parameter COPYBOOKPROC on CREATE STRUCTURE is no longer ignored. This parameter is used to specify whether the PL/1 compiler or SELCOPYi's internal PL/1 parser is to be used when generating a SELCOPYi SDO structure from a PL/1 copybook file.

Create SDO structure panel no longer clears the SDO title and description when the SDO dataset/member name is entered or updated in the "Structure File to Create/Edit" fields.

SDO structure definition corrected so that, after dropping a newly created SDO structure containing a default record-type entry which is not the first record-type definition in the structure, the DEFAULT attribute for this record-type is no longer lost.

Correct 0C4 program check that occurred when an SDO structure is created using an existing SDO structure as a record mapping source.

IQ005026, IQ004997, IQ004966, IQ004957, IQ004954, IQ004895:

SELCOPY Debug Utility fixes and enhancements:

Update SLC Language Reference for 3.40 new features.

Correct failure to redisplay WATCH List and possible 0C4 program check following execution of line command "D*" to delete all subsequent row entries.

Correct abend in Selcopy Debug on z/VSE where VSAM dataset is read by SELCOPY.

Prevent program check in selcopy debug if program check occurs in SELCOPY processing. Instead, abend information is displayed in the SYSPRINT output and RC=88 is set.

Add a new "Watch List" item under "View" to display the default Watch list window.

Static Watch list items now includes "New" and "Add" items where:
1. "New" will open an IPO dialog with optional name field (default blank for generated name).
2. "Add" will open an IPO dialog with Watch list window name selector field (default set to current Watch list window name).

IQ005032, IQ005030, IQ005022, IQ005021, IQ005019, IQ005013, IQ004979, IQ004978, IQ004969, IQ004961, IQ004959, IQ004946, IQ004608:

General SELCOPYi Utility fixes and enhancements:

FCOPY and FSU now allow specification of an input structure without an output structure. Required if a formatted FILTER is to be specified.

SDE PRINT output scale is no longer truncated at 256.

COMPFILE and FSU REPORT parameter now supports a DDname argument identifying the pre-allocated dataset to which the formatted report data will be written. The SDO structure, used to map the formatted report output, is automatically generated with a DSN equal to that assigned to DDname but with the additional low level qualifier ".SDO".

Relax DSN restrictions imposed by FSUUNDO when identifying the FSU report dataset to be used as input.

FCOPY dialog panel corrections to FILTER panel redisplay and to Recompile of the output records structure when specified as an Assembler module DSECT or COBOL, PL/1 copybook.

RUNSELC and RUNSLC now supported on VM/CMS.

Scroll to the correct record when the FSUEDIT/CFEDIT facility (F6) is used on an entry in the COMPFILE/FSU report to edit a VSAM file (or large dataset) which invokes the data editor.

COMPFILE now returns an error if a key position of zero is specified. The COMPFILE dialog panel now validates key field positions before allowing the user to exit.

COMPFILE parameters "SYNC KEY( )" is now default if both the NEW and OLD input datasets are VSAM KSDS with the same key length. In order to accomodate this, the COMPFILE dialog panel has been update to support "Default" as the sync option.

Improve FCOPY efficiency and performance for basic copy between sequential data sets.

Improve FSU performance when using FIND in conjunction with a FILTER or WHERE specification.

For COMPFILE, FSU and FCOPY utilities, support record type and field name remapping.

Previously, where input and output structures were specified, a connection would be made only between input/output fields of the same name existing in input/output record-types of the same name. This feature allows the user to connect an input record-type to an output record-type of a different name, and then input fields to output fields respectively.

Primary command syntax and utility panels have been updated to support this enhancement.

e.g.

FCOPY \ NBJ.SELCTRN.ZZST2DAT \ USING COBOL NBJ.SELCTRN.SAM1(ZZST2CPC) \ \ NBJ.SELCTRN.ZZST2DAT \ USING SDO NBJ.SDO(ZZSMUSIC) \ \ MapRecord \ ( ZARTIST from ARTIST /* Rec-type */ \ (MapField(ZRT from RT ) \ MapField(ZARTIST from ARTIST.ARTIST ) \ ) \ ZALBUM from ALBUM /* Rec-type */ \ (MapField(ZRT from RT ) \ MapField(ZALBUM from ALBUM.ALBUM ) \ ) \ )

COMPFILE support to condiotinally exclude from the compare operation specific fields within unformatted record text.

Introduces new syntax to COMPFILE primary command for unformatted compare:
```
      +----------------------------------------------+
      |                                              |
      v                                              |
    >-+----------------------------------------------+->
      |                                              |
      |         +----------+                         |
      |         v          |                         |
      + IGNore (+- pos:len +-+-------------------+-) +
                             |                   |
                             + WHEN (expression) +
```
e.g.

COMPFILE \ JGE.SELCTRN.ZZST2DAT /* New-file */ \ NBJ.SELCTRN.ZZST2DAT /* Old-file */ \ readahead(100) \ ign( 11:8 21:6 131:999 \ when( left(record,1) = '3' \ & ( record << 'blues' \ or record << 'tables' \ or substr(record,209,4) = '1997'\ ) \ ) \ ) \

Like COMPFILE, FSU now includes support for the CONTEXT parameter. This enables display of n_lines number of records that occur before and after the record(s) matching the search criteria.

IQ005027, IQ005025:

DB2 Panel Fixes and Enhancements:

Correction to the SELCOPYi DB2 unload panels which generated invalid DB2 UNLOAD utility syntax when an output copybook was used to unload a NULLable field and that field name was not preceded by another field name containing the string "NULL".

The FILTER panel for DB2 no longer displays the LEV and PIC columns in the SELECT, thereby allowing for an increase in the VALUE column width.

IQ004955, IQ004949, IQ004941:

List Window fixes and enhancements:

For all list windows, SELECT with no parameters invokes a dialog which displays a table of all column names which may be selected, deselected and/or re-ordereed as required. This facility has been corrected for DASD volume lists which did not correctly retrieve the list column names.

Correct possible 0C4 program check which occured on execution of SDE primary command DISPLAY STRUCTURE (LS) which lists attributes of each record-type definition in an SDO structure.

LISTLIBRARY (LL) is now treated as LISTPATH (LP) if the specified library name is not a valid DSN but is a valid HFS file path.

IQ005011, IQ005003, IQ004977, IQ004915:

Updates that affect installation of CBL Product Suite:

Execution of FIRSTUSE SITE by the system programmer to customise site-wide SELCOPYi operation for the installation, now opens the text editor main window in maximised state.

Install job to BIND the SELCOPY DB2 plan to a DB2 sub-system has been modernised to first BIND the DBRM to a specific package collection.

IPOLOCS macro introduced that sets default initial IPO panel window locations when operating in a windowed (non-full screen) environment.

FIRSTUSE SITE updated to inform the systems programmer to be aware that the user's personal SELCOPYi customisation datasets should be preserved. It may be necessary to amend SMS ACS routines to prevent their deletion.

IQ004974, IQ004970, IQ004935:

Updates that affect panel processing:

Introduce support for entries prefixed with a dot/period "." in a DSN field as indicating that the user prefix is to be inserted at the start of the DSN specified.

Correct possibility of unresponsive state that could occur when attempting to cancel SELCOPYi
(e.g. using "=X") when the focus window is modal
(e.g. the member selection panel).