Previous Topic: Application DevelopmentNext Topic: DCMT Command Codes


CA IDMS Tools

This chapter describes the enhancements to the CA IDMS Tools products.

This section contains the following topics:

CA ADS Alive RECORD Command Enhancement

CA IDMS Dictionary Migrator Enhancements

CA IDMS Journal Analyzer Enhancements

CA IDMS Online Log Display Enhancement

CA IDMS Tools Editor Enhancement

CA IDMS Tools Queue Record Deletion Enhancement

CA IDMS Tools Site-Specific Segment Name and Database Name Enhancement

CA ADS Alive RECORD Command Enhancement

The CA ADS Alive RECORD command is enhanced so that when records to be displayed are subschema built, only those record elements that are contained in the subschema view are displayed. Otherwise, all elements are displayed. The dictionary navigation logic is updated to use the SSR-032 record as a dictionary entry point if present for the record access.

Note: For more information about the RECORD command, see the CA ADS Alive User Guide.

CA IDMS Dictionary Migrator Enhancements

CA IDMS Dictionary Migrator is enhanced to include two new options:

By default the MODIFY syntax is generated for DDDL entities in a CHANGEONLY migration. If an entity does not exist in the target dictionary, the following message is displayed: DC601014 xyz is not in the dictionary.

If the REPLACE verb is used and the entity does not exist, the entity is added to the dictionary, and the following message is displayed: DC601210 Replace changed to Add.

You can set the MODIFY and REPLACE options by changing the installation parameters. However, you do not have to change the options from their default values. The options are not mutually exclusive; one or both or neither of them can be altered from their default values. If required, you can adjust the options during installation or at a later time by altering the source member USMTPARM and reassembling and relinking a new USMTPARM module as documented in Usermod UMOD1.

The two new installation parameters are as follows:

DDLMOD Parameter

DDLMOD = Y or N (defaults to DDLMOD=N)

If set to Y, the syntax for the schema and subschema compiler entities is created using the MODIFY verb rather than the ADD verb. In addition, if DDLMOD = Y, the schema and subschema delete syntax file statements are commented out in the SCHMDEL and SUBSDEL files.

If set to N, the syntax for the schema and subschema entities is created using the ADD verb. This is the default and is consistent with behavior in prior releases.

For z/OS users, the value for this parameter is set by the WIMVPV49 VARBLIST variable.

DDDLREP Parameter

DDDLREP = Y or N (defaults to DDDLREP=N)

If set to Y, syntax for all DDDL entities is created using the REPLACE verb.

If set to N, the syntax for DDDL entities is created using the ADD or MODIFY verbs. This is the default and is consistent with behavior in prior releases.

For z/OS users, the value for this parameter is set by the WIMVPV50 VARBLIST variable.

More Information

CA IDMS Journal Analyzer Enhancements

CA IDMS Journal Analyzer enhancements include the following:

Enhanced Decompression Support

CA IDMS Journal Analyzer is enhanced to allow data records that are compressed using custom Data Characteristic Tables (DCTs) to be uncompressed and displayed in the JNLA Display output. To decompress records using custom DCTs, the appropriate DCT load modules must be available in the JNLA loadlib concatenation.

Only the highest version number schema record for a given schema within the OOAK-S set is processed. This is consistent with behavior in prior releases.

Note: CA IDMS Journal Analyzer already supports decompression ofrecords that use the generic or BUILTIN compression.

When a named DCT cannot be located, the following message is displayed: DICT - NO PRESSPACK DCT TABLE NAME PROVIDED.

Management Ranking Report Enhancement

The CA IDMS Journal Analyzer Management Ranking Report is enhanced to provide cumulative values for all like named program executions for the following attributes:

When any of these attributes are specified, an extra line is added on the Management Ranking Report (ABSOLUTE value type). This line provides a cumulative value for the specified attribute by program name.

Example

The following example shows the cumulative value of the PAGES READ and WRITTEN for all program executions by program name.

ID RELEASE CA IDMS JOURNAL ANALYZER DATE TIME PAGE Rnn.nn MANAGEMENT RANKINGS mm/dd/yy hh:mm:ss 23 mm/dd/yy hh:mm - mm/dd/yy hh:mm ALL RUN UNITS RANKED HIGHEST (TO LOWEST) BY PAGES READ + WRITTEN RANK RUN UNIT PROGRAM START VALUE ---- -------- ------------ ----------------- ------------ 1 2090437 IDMSDDDL ONL mm/dd/yy hh:mm:ss 1,113 TOTALS IDMSDDDL 1,113 2 2092894 ADSOGEN1 ONL mm/dd/yy hh:mm:ss 403 3 2092734 ADSOGEN1 ONL mm/dd/yy hh:mm:ss 389 4 2090152 ADSOGEN1 ONL mm/dd/yy hh:mm:ss 379 5 2092617 ADSOGEN1 ONL mm/dd/yy hh:mm:ss 375 TOTALS ADSOGEN1 1,546 6 2090589 RHDCSGEN ONL mm/dd/yy hh:mm:ss 366 7 2090664 RHDCSGEN ONL mm/dd/yy hh:mm:ss 361 8 2090509 RHDCSGEN ONL mm/dd/yy hh:mm:ss 358 9 2090365 RHDCSGEN ONL mm/dd/yy hh:mm:ss 355 10 2090269 RHDCSGEN ONL mm/dd/yy hh:mm:ss 351 TOTALS RHDCSGEN 1,791

More Information

For more information, see the CA IDMS Journal Analyzer User Guide.

CA IDMS Online Log Display Enhancement

CA IDMS Online Log Display forces the current DDLDCLOG buffer to be written at initial task invocation. This ensures that the most recent log data is included in the display.

Note: For more information about CA IDMS Online Log Display, see the CA IDMS Online Log Display User Guide.

CA IDMS Tools Editor Enhancement

The CA IDMS Tools Editor is enhanced to include the ECHO command. The ECHO command preserves the primary command line when this option is set on. The Profile command used to display all the environmental settings will include the ECHO setting.

The ECHO command is available for the following CA IDMS Tools online products in both browse and edit modes:

In addition, if CA IDMS DME is entered using the ADSC Interface, the ECHO command is also available.

ECHO Command

Use the ECHO command to preserve the primary command line. If ECHO is turned on, the last command entered on the command line is preserved and redisplayed. If ECHO is turned off, the last command entered is not preserved. The ECHO setting is maintained in the Editor profile for the signed on CA IDMS/DC userid. The syntax for the ECHO command is the following:

ECHO {ON
      OFF}

Default: OFF

This command is available in edit and browse modes.

More Information

For more information about any of the CA IDMS Tools online products, see the following guides:

CA IDMS Tools Queue Record Deletion Enhancement

CA IDMS is enhanced with a new PROKEEP installation parameter to allow queue records to be deleted after a specified time for the following CA IDMS Tools online products:

Queue records are used to save settings that are used in the product's operation. These settings include: module names, PF key values, caps, and tabs. A number of unused queue records can accumulate over time.

PROKEEP=nnn

This installation parameter lets you specify a retention date for the CA IDMS Tools online products when a retention date is not already provided.

nnn specifies the number of days to retain profile queue records in the dictionary. You must specify an integer between 0 and 255. A value of 255 retains the queue records indefinitely.

More Information

For more information about any of the CA IDMS Tools online products and specifying installation parameters, see the following guides:

CA IDMS Tools Site-Specific Segment Name and Database Name Enhancement

This installation enhancement allows CA IDMS Tools users to specify their own segment name and database name values for each database associated with a CA IDMS Tools product. By specifying these names as installation parameters, you no longer have to alter the generated installation JCL to change the CA-supplied segment name and database name values to match the existing names at your site.

To use this feature, override the default segment name and database name values using the installation parameters listed in the following table.

When performing an upgrade installation, you need to know the existing segment name and database name values. You can obtain them in one of the following ways:

The following are the new installation variables for the CA IDMS Tools installation that allow you to specify site-specific segment names and database names for each database associated with a CA IDMS Tools product:

Product Name

VARBLIST Segment Name Variable

Default Segment Name

VARBLIST Database Name Variable

Default Database Name

CA IDMS Dictionary Migrator Assistant

DMA#SEG

DMA

DMA#DBN

DMA

CA IDMS DMLO

DMLO#SEG

DMLO

DMLO#DBN

DMLO

CA IDMS Enforcer

ENFR#SEG

ENFORCER

ENFR#DBN

ENFORCER

CA IDMS Extractor

DBX#SEG

DBX

DBX#DBN

DBX

CA IDMS Masterkey

MAST#SEG

MASTRKEY

MAST#DBN

MASTRKEY

CA IDMS SASO

SDS#SEG and SDC#SEG

SASOSTR and SASODOC

SASO#DBN

SPG

Note: CA IDMS SASO defines 2 segments, SASODOC and SASOSTR. Both should be included in a single database name.

Note: For more information about installation parameters, see the CA IDMS Installation and Maintenance Guide—z/OS.