CA Easytrieve Report Generator 11.6 用户手册说明书

CA Easytrieve® Report Generator 11.6
Contents
Announcements and News (15)
Release Notes (15)
New Features (15)
New Features Since Release 6.4 (17)
Differences Between Releases (22)
Release Comparison (35)
Migration Guidelines (36)
CA SMP/E Internet Service Retrieval (37)
Portfolio Simplification (37)
Simplified Design System (39)
Documentation Changes (39)
Installing (40)
Installation Best Practices (41)
Install CA Easytrieve for Windows (41)
Install CA Easytrieve for UNIX and Linux for zSeries (43)
Install CA Easytrieve for Linux PC (45)
Install CA Easytrieve for z/OS (50)
How the Installation Process Works (52)
Preparing for Installation (53)
Install Your Product Using CA CSM (53)
Installing Your Product Using Pax ESD or DVD (90)
SAMPJCL and CBAAJCL Contents (104)
Upgrade CA Easytrieve for z/OS (107)
Install CA Easytrieve Packaged with CCS (107)
Install CA Easytrieve SDS (108)
Install the License Key (108)
Maintain Your Product (109)
Configuring (110)
Configuration Best Practices (110)
Configure Your Product (111)
Configure With CA CSM (112)
Configure Without CA CSM (112)
Configure Your System (119)
Setting Environment Variables (120)
Updating the Table (122)
Getting Started (160)
Programming Lessons (164)
Lesson 1 - Library Section, FILE and DEFINE Statements (164)
Lesson 2 - Activity Section, JOB and IF Statements (167)
Library Section - Describe and Define Data (181)
Describe Files and Fields (184)
Activity Section - Processing and Logic (196)
JOB Activities (196)
SORT Activities (214)
PROGRAM Activities (217)
Activity Section - Input and Output (218)
Activity Section - Reporting (229)
Processing of Reports (234)
Label Report (241)
Testing Aid Parameters (244)
Format Determination Parameters (244)
Multiple Reports (246)
Report Procedures (PROCs) (249)
System-Defined Fields (260)
General Purpose Fields (260)
File Processing Fields (261)
Report Processing Fields (262)
Using (263)
Using Best Practices (263)
Create and Format a Report (265)
Compile and Link Your Program (271)
Controlling Compilation (271)
Results of the Compilation (272)
Program Compilation and Link-Editing Using JCL (275)
Submitting Your Program for Non-Mainframe Compilation (288)
Link-Editing Non-Mainframe Programs (291)
Execute a Program (297)
Execute a Program in UNIX and Linux for zSeries (298)
Execute a Program in Windows (298)
Execute a Program in z/OS (299)
File Description String (Non-Mainframe Only) (300)
Execute a Windows Indexed File Program (302)
Execute a Btrieve Program (303)
Execute a C-ISAM Program (304)
Report Display Facility (z/OS Only) (305)
Error Analysis Report (309)
Execute a Program on a Web Server (311)
Alternate Collating Sequence Table (317)
Extended Reporting (320)
Printing Concepts (322)
Printer Characteristics (336)
Font Characteristics (350)
Set Up Source Control Supports (357)
Workbench (359)
Main Window (360)
Opening Windows (363)
Manage Files and Applications (363)
Edit Source or Text Files (368)
Workbench Tools and Utilities (396)
Creating Toolkit and Writing Scripts (410)
Workbench Help (425)
CA Easytrieve/Earl Usage (425)
CA Easytrieve SDS (427)
Create a JCL/Submit Prolog Source File (427)
Create a Project and Host Profile (428)
Import File and Field Definitions (429)
Design and Run a Report (429)
Programming (430)
Text Conventions and Field Rules (430)
Code Programs (432)
Structured Programming (432)
Program Sections (433)
Define Files and Fields (434)
8-Byte Binary Fields (438)
Declarations (440)
Literal and Data Formatting Rules (441)
Control Program Flow (445)
Assignments and Moves (451)
Table Processing (461)
Array Processing (463)
Inter-Program Linkage (472)
Code Efficient Programs (488)
Code CICS Programs (489)
Multiple Platform Considerations (489)
SQL Database Processing (490)
Programming Methods (490)
CA Easytrieve SQL Statement Rules (491)
Program Environment (491)
Library Section Definition (494)
CA Easytrieve SQL Files (501)
Automatic Retrieval Without a File (507)
Native SQL Processing (509)
ODBC Data Sources (514)
CA IDMS Database Processing (516)
CA IDMS Interface (517)
IDD Interface (531)
Sample Database and Logical Record (533)
IMS/DLI Database Processing (538)
Test Database (539)
PCB and PSB Processing (540)
Automatic Input (541)
Controlled Processing Using DLI Statements (547)
IMS Fast Path DEDB Processing (553)
CA Datacom/DB Database Processing (553)
Access the Database (554)
Indexed Files (575)
Relative Files (578)
Sorting Files (582)
Synchronized File Processing (584)
PRINTER Files (589)
Non-Mainframe Files (590)
Report Processing (591)
PRINT Statement (Report Processing) (592)
Report Formats (594)
Report Generation (596)
Standard Reports (597)
Label Reports (604)
XML Reports (607)
Sequenced Reports (609)
CONTROL Reports (609)
Report Procedures (629)
Routing Printer Output (641)
Use Extended Reporting (643)
Extended Reporting Concepts (644)
Report Layout Processing (656)
Screen Processing (663)
Screen Format (664)
Use the SCREEN Statement (666)
Screen Title Area (668)
Screen Work Area (669)
Format an Item for Display (671)
Screen Message Area (685)
Screen Function Key Area (685)
Screen Key Processing (685)
Screen Procedures (686)
Commit Processing (693)
Sample Screen Applications (697)
Macro Facility (706)
Invoke a Macro (708)
Define Macros (709)
Process Macros (711)
In-stream Macros (712)
SUPRA Interface Option (714)
SUPRA Interface Operation (715)
TOTAL Interface Option (726)
%ADDM - Add Master (TOTAL) (728)
%ADDV - Add Variable (TOTAL) (729)
%CBLCNVRT (730)
%CLOSX - Close TOTAL File (730)
%CONCAT (730)
%CONVAE (731)
%CONVEA (731)
%DFNTOTF (737)
%EZSSID (737)
%EZTINI (737)
%FINDX (738)
%GETCALEN (739)
%GETJULI (739)
%RDNXT (739)
%OPENX (740)
%READD (740)
%READM (741)
%READR (742)
%READV (743)
%RGHTJUST (744)
%SINOF (744)
%SINON (744)
%VERNUMP (745)
%WRITM (745)
%WRITV (746)
Example - Retrieve Records Using a Tickler File (747)
Language Reference (749)
Character Sets (749)
Statements (751)
Statement Overview (758)
% (Macro Invocation) Statement (761)
* (Comment) Statement (762)
ACCESS Statement (762)
AFTER-BREAK Report Procedure (763)
AFTER-LINE Report Procedure (765)
AFTER-SCREEN Screen Procedure (767)
Assignment Statement (767)
ATTR Parameter (772)
BEFORE-BREAK Report Procedure (774)
BEFORE-LINE Report Procedure (775)
BEFORE-SCREEN Screen Procedure (776)
CALL Statement (776)
CASE and END-CASE Statements (777)
CLOSE Statement (779)
COMMIT Statement (780)
Conditional Expressions (780)
CONTROL Statement (791)
COPY Statement (792)
CURSOR Statement (793)
DECLARE Statement (793)
DEFAULT Statement (795)
DEFINE Statement (797)
DELETE Statement (805)
DO UNTIL and DO WHILE Statements (811)
ENDPAGE Report Procedure (813)
END-PROC Statement (813)
ENDTABLE Statement (814)
EXECUTE Statement (814)
EXIT Statement (815)
FETCH Statement (815)
FILE Statement (816)
GET Statement (825)
GOTO Statement (826)
HEADING Statement (828)
IDD FILE Statement (829)
IDD NAME Statement (829)
IDD RECORD Statement (830)
IDD SUBSCHEMA Statement (831)
IDD VERSION Statement (831)
IDMS ACCEPT DBKEY Statement (832)
IDMS ACCEPT PAGE-INFO Statement (832)
IDMS ACCEPT PROCEDURE Statement (833)
IDMS ACCEPT STATISTICS Statement (833)
IDMS BIND Statement (833)
IDMS BIND FILE Statement (834)
IDMS BIND PROCEDURE Statement (834)
IDMS COMMIT Statement (835)
IDMS CONNECT Statement (835)
IDMS DISCONNECT Statement (835)
IDMS ERASE Statement (836)
IDMS FIND and IDMS OBTAIN Statements (836)
IDMS FINISH Statement (839)
IDMS GET Statement (839)
IDMS IF Statement (839)
IDMS KEEP Statement (840)
IDMS MODIFY Statement (840)
IDMS OBTAIN Statement (841)
IDMS READY Statement (841)
IDMS RETURN Statement (841)
IDMS ROLLBACK Statement (842)
IDMS STORE Statement (842)
IF, ELSE-IF, ELSE, and END-IF Statements (843)
INITIATION Screen Procedure (847)
INSERT Statement (847)
JOB Statement (848)
KEY Statement (850)
LINE Statement (853)
LINK Statement (854)
LIST Statement (855)
MACRO Statement (855)
MASK Parameter (856)
MEND Statement (860)
MESSAGE Statement (860)
PERFORM Statement (873)
POINT Statement (874)
POP Statement (875)
PRINT Statement (875)
PROC Statement (876)
PROGRAM Statement (877)
PUSH Statement (879)
PUT Statement (879)
READ Statement (880)
RECORD Statement (CA IDMS and IMS/DLI) (881)
REFRESH Statement (882)
RELEASE Statement (883)
REPEAT and END-REPEAT Statements (884)
REPORT Statement (885)
REPORT-INPUT Report Procedure (890)
RESHOW Statement (891)
RETRIEVE Statement (CA IDMS and IMS/DLI) (892)
ROLLBACK Statement (894)
ROW Statement (895)
SCREEN Statement (898)
SEARCH Statement (899)
SELECT Statement (File-based SQL) (901)
SELECT Statement (Non-file SQL) (902)
SELECT Statement (Report Selection) (903)
SELECT Statement (Sort Selection) (904)
SEQUENCE Statement (904)
SET Statement (905)
SKIP Statement (907)
SORT Statement (908)
SQL Statement (910)
SQL INCLUDE Statement (913)
STOP Statement (915)
SUM Statement (916)
TERMINATION Report Procedure (916)
TERMINATION Screen Procedure (917)
TITLE Statement (Reports) (917)
TITLE Statement (Screens) (918)
TRANSFER Statement (919)
UPDATE Statement (920)
WRITE Statement (921)
Symbols and Reserved Words (922)
Conversion from Old to Current CA Easytrieve Version (925)
Messages and Codes (926)
SUPRA Diagnostic Messages (926)
Operational Diagnostic Messages (927)
Syntax Diagnostic Messages (930)
EZABX016 (934)
EZABX020 (934)
EZABX024 (934)
EZABX046 (935)
EZABX047 (935)
EZABX048 (935)
EZABX049 (935)
EZABX050 (936)
EZABX051 (936)
EZABX053 (936)
EZABX054 (936)
EZABX055 (936)
EZABX056 (937)
EZABX057 (937)
EZABX058 (937)
EZABX059 (937)
EZABX060 (937)
EZABX061 (938)
EZABX062 (938)
Linking, Transferring and Calling Messages (938)
EZACT001 (938)
EZACT002 (938)
EZACT005 (939)
Utility Messages (939)
EZALT001 (939)
EZALT002 (939)
EZALT003 (940)
EZALT004 (940)
EZALT005 (940)
EZALT006 (940)
EZALT007 (940)
EZALT008 (941)
EZALT009 (941)
EZALT010 (941)
EZALT011 (941)
EZALT012 (942)
EZALT013 (942)
EZALT014 (942)
Configuration Manager Messages (942)
EZCM001 (942)
EZCM002 (943)
EZCM003 (943)
EZCM004 (943)
EZCM005 (943)
EZCM006 (943)
EZCM007 (944)
EZCM008 (944)
EZCM014 (945)
EZCM015 (945)
EZCM016 (945)
EZCM017 (945)
EZCM018 (945)
EZCM019 (946)
EZCM020 (946)
EZCM021 (946)
EZCM022 (946)
EZCM023 (946)
EZCM024 (946)
IMS_DLI Messages (947)
EZDLI001 (947)
EZDLI002 (947)
EZDLI003 (947)
Program Abend Messages (EZEIP) (947)
EZEIP001 (948)
EZEIP003 (948)
EZEIP004 (948)
EZEIP005 (948)
EZEIP006 (949)
EZEIP007 (949)
EZEIP011 (949)
EZEIP015 (949)
EZEIP017 (949)
EZEIP018 (950)
EZEIP019 (950)
EZEIP021 (950)
EZEIP022 (950)
EZEIP023 (950)
EZEIP024 (951)
EZEIP025 (951)
EZEIP028 (951)
EZEIP992 (951)
EZEIP997 (952)
IDMS Messages (952)
EZIDM001 (952)
EZIDM002 (952)
EZIDM003 (952)
File I_O Messages (952)
EZIOE001 (953)
EZIOE002 (953)
EZIOE003 (954)
EZIOE004 (955)
EZIOE005 (956)
EZIOE007 (956)
EZIOE008 (956)
System Initialization Messages (958)
EZKX0001 (958)
EZKX0004 (958)
EZKX0012 (959)
EZKX0013 (959)
EZKX0014 (959)
EZKX0016 (959)
EZKX0017 (959)
EZKX0060 (959)
EZKX0061 (960)
ETOPLOAD Utility Messages (960)
EZOPT001 (960)
EZOPT002 (960)
EZOPT003 (960)
EZOPT004 (961)
EZOPT005 (961)
EZOPT008 (961)
EZOPT009 (961)
EZOPT010 (961)
EZOPT011 (962)
EZOPT012 (962)
EZOPT013 (962)
EZOPT014 (962)
EZOPT015 (962)
EZOPT016 (963)
EZOPT017 (963)
EZOPT018 (963)
EZOPT020 (963)
EZOPT021 (963)
System Termination Message (963)
EZSHT101 (964)
SQL Messages (964)
EZSQL001 (964)
EZSQL002 (964)
EZSQL003 (965)
EZSQL004 (965)
EZSQL005 (965)
Sort Messages (965)
EZSRT008 (965)
EZSRT009 (966)
EZSRT013 (966)
Compiler Messages (967)
EZTC0744E (967)
Runtime Error Check Codes (968)
EBND (968)
EBSN (968)
Runtime Code Generator Codes (968)
ECGO (968)
IMS_DLI Interface Codes (968)
EDLI (969)
Dynamic Segment Manager Codes (969)
EDSA (969)
EDSO0 (969)
EDSS (969)
EDST (969)
EDSX (970)
Heap Manager Codes (970)
EBND0 (970)
EBSL (970)
EFLD (970)
EFML (970)
EFNF (970)
EFVL (970)
EHMD (970)
EHMF (971)
EHMH (971)
EHMI (971)
EHML (971)
EHMN (971)
EHMO (971)
EHMQ (971)
EHMR (972)
EHMV (972)
EHMW (972)
EHMX (972)
Input_Output Statement Handler Codes (972)
EIO0 (972)
EIO1 (972)
EIO2 (972)
EIO3 (973)
EIO4 (973)
EIO5 (973)
EIO6 (973)
EIO9 (973)
EIOA (973)
EIDA (973)
EIOX (974)
Activity Management Codes (974)
EJA1 (974)
System Spool Printer Interface Module Codes (974)
EJSO (974)
EJSC (974)
EJSW (974)
Task Execution Control Program Codes (974)
EKX0 (974)
EKX1 (975)
EKX2 (975)
EKX5 (975)
EKS6 (975)
EKXE (976)
EKXF (976)
EKXG (976)
EKXH (976)
Task Management Program Codes (976)
EKX3 (976)
EKX4 (977)
EKX80 (977)
EKXA (977)
EKXD (977)
EKXI (977)
EKXO (977)
EKXS (977)
Program Link Manager Codes (978)
EPML (978)
Printer File Manager Codes (978)
EPR0 (978)
EPR1 (978)
EPR2 (978)
EPR3 (978)
EPR4 (978)
EPR5 (978)
EPR6 (979)
EPR9 (979)
Reporting Codes (979)
ERP1 (979)
ERP2 (979)
Runtime Initialization Stub Codes (979)
ERS0 (979)
ERS1 (979)
Sort Interface Codes (979)
ESIB (980)
SQL Interface Codes (980)
ESQ1 (980)
ESQ2 (980)
ESQX (980)
ESQY (980)
EZIO (980)
Terminal Printer Despooler Program Codes (980)
ETID (981)
ETIO (981)
ETIS (981)
ETIX (981)
Terminal Printer Interface Program Codes (981)
ETPS (981)
Virtual File Manager Codes (981)
EVF0 (981)
EVF6 (982)
EVF7 (982)
EVF8 (983)
EVF9 (983)
EVFA (983)
EVFB (983)
EVFC (983)
EVFD (983)
EVFE (983)
EVFF (984)
EVFG (984)
EVFH (984)
EVFI (984)
CA EZ/Key (984)
Documentation for Previous Releases (984)
Additional Resources (985)
Product Names (986)
Product Accessibility Features (986)
Documentation Legal Notice (987)
1 Announcements and News
Includes information about conferences, community events, and product news.
•You can download documentation for previous releases of CA Easytrieve® products. To learn more, select Legacy Bookshelves and PDF on the Tech Docs Portal.
•CA Easytrieve Version 11.6 now uses Continuous Delivery (CD) to provide features and fixes more efficiently. The Incremental Release model bundled groups of features and fixes together into incremental updates. The CD model provides more flexibility to select which service stream elements you want to apply and lets us provide you with earlier access to features and fixes. To learn more, see the New Features article.
2 Release Notes
New features, release comparison, and migration guidelines.
Welcome to the CA Easytrieve® Report Generator Release Notes for Release 11.6. This section includes the following articles:
New Features
This article describes the new features, enhancements, and changes for Release 11.6:
This article describes the following new features, enhancements, and changes in CA Easytrieve Report Generator for Release 11.6:
8-Byte Binary Field Support
Support for 8-byte binary fields has been added. This allows access to BIGINT fields when processing a DB2 database. Support for 8-byte binary fields also allows communicating with external programs that process 8-byte binary data. Previously, this was not possible. Support for 8-byte binary provides extended range for CA Easytrieve Report Generator programs that process binary data that exceeds the range of 4-byte binary data. For more information, see 8-Byte Binary Fields.
Big Integer Value Support
Support for processing Big Integer (BIGINT) fields as 8-byte binary fields has been added to eliminate the possibility of data loss. Previously, BIGINT fields were processed as 10-byte packed fields. Because 10-byte packed fields can have no more than 18 digits and BIGINT fields can have up to 19 digits, data loss could have occurred.
CA Chorus Software Manager Support
CA Easytrieve Report Generator now supports CA Chorus™ Software Manager (CA CSM) Release 6.0. CA CSM is an application that simplifies and unifies the management of CA Technologies mainframe products on z/OS systems.
CA CSM provides services that make it easier for you to perform the following actions:
•Acquire, install, deploy, and configure products
•Automatically obtain and apply maintenance
These services let you easily manage your software based on industry-accepted best practices. The web-based interface provides a user-friendly environment that lets you install and maintain your products faster and with less chance of error.
With CA CSM Release 6.0, you can:
•Configure products without the need to deploy them first.
•Filter target zones in a multizone SMP/E environment and organize them in zone sets.
•Schedule an automatic maintenance update for all or some products that are installed in an SMP/E environment.•Manage product maintenance in a unified and simplified manner.
In addition, the SMP/E Environments tab was reworked to let you navigate through your SMP/E environments easier and
•To install CA CSM, go to the DOWNLOAD MANAGEMENT section of CA Support at .
•For more information about CA CSM, see the CA CSM documentation.
•For information about installing CA Easytrieve Report Generator, see Installing.
Linux PC Support
CA Easytrieve Report Generator can now be installed in the Linux PC environment. For more information, see Install CA Easytrieve for Linux PC.
Character Comparison Using Custom Collating Sequence Table
The new keyword COMPAREUSINGALTSEQ has been added to the PARM statement to enable character comparison using custom collating sequence table. For more information, see PARM Statement.
EZTCOM Module Size Increase
The EZTCOM module is larger in CA Easytrieve Report Generator Release 11.6. Depending on your system settings, you may need to specify a region on the EXEC statement or JOBCARD to obtain enough space.
Examples
The EXEC statement has the following format:
The JOBCARD has the following format:
IDD NAME RETRIEVAL Parameter Ignored
The RETRIEVAL parameter of the IDD NAME statement is now ignored. Previously, the RETRIEVAL parameter caused a compiler error. Ignoring the RETRIEVL parameter lets your job continue without error.
Library Name Changes
The library names have been changed to conform to new CA Technologies z/OS packaging standards.
We recommend that you review the following table to determine the impact to your installation:
Original Name New Name Description
CAIJCL CBAAJCL Target library
CAILIB CBAALOAD Target library
CAIMAC CBAAMAC Target library
C$AB5LLD ABAALOAD Distribution library
C$AB5MLD ABAAMAC Distribution library
C$AB5SLD ABAASRC Distribution library
Continuous Delivery
CA Easytrieve uses the continuous delivery (CD) release model for the delivery of new features. In the CD release model:•Enhancements are delivered in the maintenance service stream as feature PTFs. New product features and fixes are no longer bundled together.
•Enhancements are delivered disabled to give you more control over when and how the features are implemented. With new features disabled, you control when to make the new features available for use in your environment. An explicit action is required to enable the feature.
•Individual product fixes are provided when needed, separate from product features. You can apply product fixes without
After full integration and regression testing with other CA Technologies products, the enhancement and product fixes are added into the CA Recommended Service for z/OS (CA RS), ensuring product quality and the integrity of your environment. CA RS is an important part of a good preventive maintenance philosophy that lets you develop and implement a proactive maintenance strategy in which you apply preventive maintenance on a regular schedule.
Important: We recommend that you use the CA SMP/E Internet Service Retrieval to acquire product maintenance. This service uses the IBM SMP/E RECEIVE ORDER command and can reduce hours of maintenance time to just minutes. You can acquire maintenance on demand or can schedule an SMP/E job to run regularly, which eliminates time consuming fix searches and the need to select maintenance manually through the Broadcom Support Portal.
New Features Since Release 6.4
This article summarizes the new features and enhancements since CA Easytrieve Plus Release 6.4 that are included in this release.
This article summarizes the new features and enhancements since CA Easytrieve Plus Release 6.4 that are included in this release.
Enhancements Since Release 11 SP4
Enhancements since Release 11 SP4 include:
•Workfile Site Option
•Warning Message Condition Code Option
Workfile Site Option
Storage of intermediate reporting data can now be automatically directed to Report Workfiles (temporary sequential disk files), instead of Virtual files (VFM). This is accomplished through the WORKFILE option. You can additionally specify the number of cylinders to be allocated for each dynamically allocated Report Workfile by using the WORKFSPA parameter. Warning Message Condition Code Option
WARNCC specifies which condition code the compiler returns for warning messages. Typically a compilation that reports only warning messages returns with a condition code of 4. You cannot override this value during program compilation.
The WARNCC option has the following format:
•F
Returns a condition code of 4 for warnings. This is the default.
•S
Returns a condition code of 16 for warnings.
•Z
Returns a condition code of 0 for warnings.
Enhancements for Release 11 SP3
Enhancements for Release 11 SP3 include:
•Support for multiple SSIDs with CA PAN/SQL feature
•Determine data set block size
•New Function mode
Support for Multiple SSIDs with CA Pan/SQL Feature
This feature allows a CA Easytrieve Report Generator program to invoke a specific DB2 PAN/SQL installation from among multiple installations based on the value specified for PARM SSID in the program. With this feature, if you have multiple versions of DB2 installed, you can have multiple CA PAN/SQL installations for each DB2 within a single library, and select the DB2 you want to access by way of the PARM SSID value in the program. This is done by building the Easytrieve SSID
SSIDTBL is used to build the table. Information about how to create multiple PAN/SQL for DB2 installations in the same load library is provided with PAN/SQL.
Note:
In Release 11.6, member SSIDTBL is in hlq.CBAAJCL.
Determine Data Set Blocksize
The new BLOCK0 option specifies whether a system-determined block size is used for files that do not have the logical length and block size coded. This option passes a zero value to the operating system, which in turn determines the optimum block size.
Use this option only if your operating system supports IBM system determined block size.
Note: You can override this option through Block-length of the FILE statement. There is no PARM statement override.
This option has the following format:
•N
Indicates that the system does not determine the block size for data sets. Specify the block size through JCL or the FILE statement. This is the default.
•D
Indicates that the system determines the block size for data sets that are stored in a tape or a disk.
•P
Indicates that the system determines the block size for data sets stored in a PRINTER.
•A
Indicates that the system determines the block size for data sets stored in a tape, disk or a PRINTER.
Note:
This option was available in Release 6.4 but was not in Release 11 prior to SP3.
New Function Mode
NEWFUNC is a new option in the Options Table. The NEWFUNC option specifies whether to use the standard Release 11.x compiler or the compatibility mode compiler to compile your CA Easytrieve Report Generator programs. This option does not have any impact on link-edited CA Easytrieve Report Generator application programs. NEWFUNC applies only to z/OS.
The NEWFUNC option has the following format:
•Y
Compiles and runs programs using the latest product release. This option incorporates all new functionality. This is the default.
•N
Compiles and runs programs using the compatibility mode of CA Easytrieve Plus Report Generator. This option gives you more control when moving your applications to CA Easytrieve Report Generator Release 11.x.
Note:
•You cannot override this option in the PARM statement.
•For more information about the standard and compatibility mode compilers, see Migration Guidelines.
•For information about running programs in New Function mode, see Configuration Best Practices.
Enhancements for Release 11 SP2
Enhancements for Release11 SP2 include:
•Unsupported options
New Options
New options for Release 11 SP2 include:
•AMODE31 {Y|N}
Specifies the location of where memory is to be allocated during the execution of the CA Easytrieve Report
Generator application program. (execution time, z/OS only)
•Setting AMODE31 to Y allows all possible memory allocations to be made above the 16meg line.
•Setting AMODE31 to N causes all possible memory allocations to be made below the 16meg line.
•Storage allocation below the 16meg line is required if the Easytrieve application program calls, (or uses as a FILE EXIT), a 24-bit subprogram. The default is Y.
•You can override this value through PARM CALL(AMODE31|AMODE24)
When the subprogram being called is link-edited as AMODE(24) and if any parameters are being passed to that program, those parameters must reside in memory that is located below the 16meg line. Memory location can be controlled at the following installation level as well as at the program level:
•Installation level
To force all storage below the 16meg line for all CA Easytrieve Report Generator programs, set the AMODE31
Installation Option to N. For more information see Configuration Best Practices and Updating the Table.
•Program level
To force storage below the 16meg line for a specific CA Easytrieve Report Generator program, you must specify the CALL(AMODE24) parameter in the PARM statement in the program.
•MTVSERR (Y|N)
Determines how an empty input VSAM file is to be handled. Setting MTVSERR to Y will cause the CA Easytrieve Report Generator I/O system to treat an empty VSAM input file as an I/O error condition. This will cause the immediate abnormal termination of the program. Setting MTVSERR to N will cause an empty VSAM input file to be handled as though it is at End-Of-File. The default is N.
•SPRTXIT modname
Specifies the name of a user-supplied SYSPRINT exit routine. The modname must be a valid program name. For more information on the SYSPRINT exit capability, see Unit Record Exits. This is an execution time option for z/OS only. The default is no exit name (blanks).
Modified Options
The following options have been renamed or modified:
Former 6.X Name Current Release 11.x Name
ALL31AMODE31
ALTSEQ ALTSEQU
LIST LISTPRM, LISTFIL, LISTUC
MACRO MACMOD, MACTYPE
NUMERIC SEPOTDC, SEPOTTH
PAGESIZE PAGESIZE, DISPPAGE
SCANCOL SCANCOLS, SCANCOLE
SEPDATE DATESEP
SEPTIME TIMESEP
SORTSIZE SORTSIZE, SORTMAX
SQLBIND BIND
SQLSYNTX SQLSYNTAX
The LIST(FILE) option setting default is now changed to LIST(NOFILE). In past releases the generation of end-of-job File Statistics was the default operation. With this release, the default is changed to generate no File Statistics by default. Unsupported Options。