This document describes the Adabas Review 4.9 enhancements.
The command REGEN ALL
was changed to use
the Natural CATALL
command for cataloging generated
display programs. There are now two steps:
Generating the display programs and SAVE them
Cataloging the generated sources.
It is possible to generate display programs without cataloging them. Reports, which cannot be generated e.g. because of missing definitions of user-defined variable, or existing sources, which cannot be cataloged because of Natural errors, do no longer stop the generation process. Those modules can be listed after the REGEN process.
The new syntax of the REGEN ALL
command
is as follows:
REGEN ALL [SAVE] [SCROLL] [REPORT]
For more information see REGEN or RG Command.
The new command RECAT [ALL] [SCROLL]
[REPORT]
catalogs existing display programs, without regenerating
them. For more information see RECAT
Command.
The new command CHECK
returns information
whether display programs do not exist and need to be generated, or exist and
need to be re-cataloged, e.g. because a GDA timestamp mismatch. For more
information see CHECK
Command.
The following table summarizes the changes made to Adabas Review fields in this release. For complete information about fields, refer to Field Reference.
Note:
The new fields will work with Adabas for Mainframes Version 8.4.2
or above.
Field Name | New or Changed | Description | |
---|---|---|---|
AB-ALLOCATED-ENTRIES, AB-ALLOCATED-SIZE, AB-MAX-PERCENT, AB-MAXUSED, AB-SIZE, ADABAS-ISN-LOWER-LIMIT, ADABAS-THREAD-NUM, BUFF-EFFICIENCY, BUFF-FLUSH, BUFFER-WAITS, COMMANDS-PER-ACCT, COMPLETE-TID, CQ-ALLOCATED-ENTRIES, CQ-ALLOCATED-SIZE, CQ-MAX-PERCENT, CQ-MAXUSED, CQ-SIZE, CQ-TOTAL-ENTRIES, ELAPSED, FORMAT-OW, FORMAT-TR, HOLDISN, HQ-ALLOCATED-ENTRIES, HQ-MAX-PERCENT, HQ-MAXUSED, HQ-SIZE, HQ-USER-ENTRIES, IO-TO-CMD, LFP-ALLOCATED-ENTRIES, LFP-ALLOCATED-SIZE, LFP-MAX-PERCENT, LFP-MAXIMUM, LFP-MAXUSED, LFP-SIZE, LWP-ALLOCATED-ENTRIES, LWP-ALLOCATED-SIZE, LWP-MAX-PERCENT, LWP-MAXIMUM, LWP-MAXIMUM-ENTRIES, LWP-MAXUSED, LWP-SIZE, MULTICNT, NUMBER-OF-THREADS, ORG-DURATION, SECONDS, THREAD-SWITCHES, THROW-BACKS, TI-ALLOCATED-ENTRIES, TI-ALLOCATED-SIZE, TI-MAX-PERCENT, TI-MAXUSED, TI-SIZE, TS-ALLOCATED-ENTRIES, TS-ALLOCATED-SIZE, TS-MAX-PERCENT, TS-MAXUSED, TS-SIZE, UQ-ALLOCATED-ENTRIES, UQ-ALLOCATED-SIZE, UQ-MAX-PERCENT, UQ-MAXUSED |
Changed | Format length enlarged in REVIEW-ADABAS-CLOG to cover the full range of possible values. This has no effect on the output length of the fields. | |
Category Adabas Buffer Fields (BUF): MB, MBSEGnn, PB, PBSEGnn |
New | Refer to the individual field description in Field Reference. | |
Category Adabas Control Block Fields (CB): ERRFLDOF, MBL, OP3, PBL |
New | Refer to the individual field description in Field Reference. | |
Category Adabas I/O Fields (I/O): ASSOREAG, ASSOWRIG, CLREADS, CLWRITES, DATAREAG, DATAWRIG, PLOGBLKS, PLOGDIFF, PLOGIOS, PLREADS, PLWRITES, TOTREADS, TOTWRITS, WK1PBLKS, WK1PDIFF, WK1PIOS, WORKREAG, WORKWRIG |
New | Refer to the individual field description in Field Reference. | |
Category Adabas Nucleus Fields (NUC): AUTORSRT, BUFFLUSG, FLSHBLKS, FLSHIOS, FLSHPH, FLSHRTNE, FLSHRTNI, FLSHRTNL, FORMATOG, HLCMDS, INTCMDS, LGREADS, LOCLCMDS, MOCAJOB, MOCASECU, MOCAUSER, MOIOJOB, MOIOSECU, MOIOUSER, MOSTCALL, MOSTIOS, MOSTTHTI, MOTTJOB, MOTTSECU, MOTTUSER, NUCCPU, NUCDURA, NUCSDATE, NUCSTIME, NUCWAIT, OPERCMDS, REMCMDS, REPINCTR, REPPNDTR, REPTOTTR, SESSIONS, THBKISN, THBKSPAC |
New | Refer to the individual field description in Field Reference. | |
Category Adabas Nucleus statistical Buffer Fields (NUC): DQALLOC, DQDATE, DQENT, DQPCT, DQSIZE, DQTIME, DQUSED, HQALLOC, LFPDATE, LFPTIME, LWPDATE, LWPTIME, PIALLOC, PIDATE, PIENT, PIPCT, PISIZE, PITIME, PIUSED, RDALLOC, RDDATE, RDENT, RDPCT, RDSIZE, RDTIME, RDUSED, RPALLOC, RPDATE, RPENT, RPPCT, RPSIZE, RPTIME, RPUSED, SCALLOC, SCDATE, SCENT, SCPCT, SCSIZE, SCTIME, SCUSED, UFALLOC, UFDATE, UFENT, UFPCT, UFSIZE, UFTIME, UFUSED, W1ALLOC, W1BALLOC, W1BDATE, W1BENT, W1BPCT, W1BSIZE, W1BTIME, W1BUSED, W1DATE, W1ENT, W1PCT, W1SIZE, W1TIME, W1USED, W2ALLOC, W2DATE, W2ENT, W2PCT, W2SIZE, W2TIME, W2USED, W3ALLOC, W3DATE, W3ENT, W3PCT, W3SIZE, W3TIME, W3USED, WIALLOC, WIDATE, WIENT, WIPCT, WISIZE, WITIME, WIUSED, XIDALLOC XIDDATE, XIDENT, XIDPCT, XIDSIZE, XIDTIME, XIDUSED |
New | Refer to the individual field description in Field Reference. | |
Category Operating System Fields (OS): ZIIP |
New | Refer to the individual field description in Field Reference. | |
Category Transaction Processing Monitor Fields (TP): RDBLKUSR |
New | Refer to the individual field description in Field Reference. |
In mode DISPLAY=EDITOR it is now possible for the user to define the output format of fields in a report, e.g to reduce the output length for a clearly arranged output according the user’s needs.
For this purpose the Natural Text member REDEFS in library SYSREVDB, if existing, will be read to obtain user defined formats.
REDEFS may be generated with the latest field definitions using the stand-alone Natural program GENREDEF in library SYSREVDB. To execute GENREDEF, stop SYSREVDB if running, so that you are at the Natural NEXT prompt in library SYSREVDB. Enter GENREDEF in the NEXT or Command line and press Enter. It will generate the Natural Text member REDEFvrs (currently REDEV491) in library SYSREVDB. To activate the just generated REDEFvrs file, rename or copy it to REDEFS. If a Natural Text member with the name REDEFS already exits and you what to keep it, make a backup copy by renaming it or copy it to another library.
Redefinitions may be specified in the section of this file, starting with <FIELDS-REDEF-START> and ending with <FIELD-REDEF-END>. This section will be read when a display program will be (re-)generated. Valid field names with valid format definitions and headers within this section will overwrite the default values. See the documentation at the top of text member REDEF<vers> for the format of such an entry. Also, the REDEF<vers> file contains the latest SYSREVDB field definitions as comments.
The format of a variable (A, B, N) may not be changed. Keep in mind that the minimum column width is the size of the header. Some output columns may be reduced in width just by a shortened header.
User defined fields may not be re-defined here.
In conjunction with the Adabas System Coordinator, dynamic invocation of the Adabas Review client exits REVEXIT1 and REVEXIT2 is possible.
Using the LGBLSET parameter options REVIEW=COR and RVCLNT=COR, the decision to invoke REVEXIT1 and REVEXIT2 is deferred to the Adabas System Coordinator client runtime controls "Review" and "Client Monitor" respectively.
Deferring the activation of client reporting to the control of the Adabas System Coordinator enables automatic activation to occur at job start-up and also provides the following additional benefits:
For batch, activation can be controlled at the Stepname level
For CICS, activation can be controlled at the Transaction name or Login ID level.
Natural and 3GL APIs are available to enable activation at the individual client level.
Refer to the Adabas documentation for more information on the LGBLSET parameter options and the Adabas System Coordinator documentation for more information on the availability of the client runtime controls.
The following new parameters are available for the REPORT statement to enable the scheduling of Adabas Review reports:
START-SCHEDULE
SCHED-STRTDATE
SCHED-STRTTIME
SCHED-ENDDATE
SCHED-ENDTIME
SCHED-DURATION
SCHED-INTERVAL
For details, refer to the individual parameter description in REPORT Statement in section Running Reports as Batch Jobs.
The output of the LS command is enhanced for scheduled reports. There is an additional function LC for scheduled reports not currently running.
For performing Adabas Review Online Functions from Natural Programs, there are the new commands EZSCHED and SCHEDULE to support scheduling.
For using Adabas Review in batch Natural there is the new batch Natural program SCHEDULE to support scheduling. The programs LODREP and ULDREP now require a work file 1 with the record length 4096 (enlarged from 2048) to handle the scheduling data for report definitions.
Specialty reports and Client Reports cannot be scheduled.
Alpha field length for fields in mode DISPLAY=BASIC is now limited to 64 byte. This is to avoid problems generating display programs, where the assumed page width is 72 bytes.