UDAS Interfaces

Installation and Configuration › Interface Configuration Enhancements › UDAS Interfaces

UDAS Interfaces

With Version 18.0, the UDAS interfaces have been configured to make installation and maintenance easier by separating user-generated code from the main UDAS interface routines. Because of these changes, you must regenerate all of your UDAS interfaces when upgrading to Version 18.0.

The remainder of this section describes changes in the way you link your UDAS interfaces.

For information on all of the necessary steps to generate a UDAS interface, see the System Operations Guide.

UDAS CICS Interface

Prior to Version 18.0, UDAS CICS front-end programs contained all the executable code for UDAS CICS front-end processing. Now these programs only contain an options table and a small stub module that calls the main processing routines that reside in separate modules.

Create a UDAS CICS Front-end Program

To create a UDAS CICS front-end program

Create a UDASCIC source module as described in the System Operations Guide.
Save the UDASCIC source module in your custom source library.
Assemble and link it into your custom load library by executing the z/OS Assemble and Link-Edit JCL
Substitute the name of your UDASCIC source member and insert the following binder statements:
```
 ORDER DFHEAI
 INCLUDE CAGJLOAD(UDSCICX0)     
 INCLUDE CUSTLIB(idmscint)
 ENTRY udascice 
 SETOPT PARM(AMODE=31,RMODE=24) 
 NAME udascic(R)
```
idmscint

Specifies the name of your IDMSCINT interface module.

udascice

Specifies the entry point name of your UDASCIC options module.

Note: Use UDSCXEP1 or the name specified as the label on the assembler instruction that invokes the #UDASCIC macro.

udascic

Specifies the name of your UDAS CICS front-end load module.

UDAS Batch Interface

Prior to Version 18.0, UDAS batch front-end programs contained all the executable code for UDAS batch front-end processing. Now these programs only contain an options table and a small stub module that calls the main processing routines that reside in separate modules.

Create a UDAS Batch Front-end Program

To create a UDAS batch front-end program

Create a UDASBCH source module as described in the System Operations Guide.
Save the UDASBCH source module in your custom source library.
Assemble and link it into your custom load library by executing the z/OS Assemble and Link-Edit JCL
Substitute the name of your UDASBCH source member and insert the following binder statements:
```
 INCLUDE CUSTLIB(idmsopti)  (Optional)
 ENTRY udasbche 
 SETOPT PARM(REUS=NONE,AMODE=31,RMODE=24)
 NAME udasbchi(R) 
```
idmsopti

Specifies the name of your IDMSOPTI module

udasbche

Specifies the entry point name of your UDAS Batch front-end load module:

Note: Use UDASBCH or the name specified as the label on the assembler instruction that invokes the #UDASBCH macro.

udasbchi

Specifies the name of your UDAS batch front-end load module

Optional APAR Replacement

Optional APARs are no longer used to tailor CA IDMS behavior. In Version 18.0, optional APARs are replaced either with syntax or numbered options that are implemented through flag settings in the RHDCOPTF module.

The following table lists the optional APARs that were eliminated in Version 18.0 and indicates how to achieve equivalent functionality using standard CA IDMS facilities:

APAR	Description	Version 18.0 Replacement
CI98234	CA IDMS Culprit: override DDNAME for SYS004 file	Profile parameter: OUTDD
CS82781	CA IDMS DC/UCF: Override the default queue retention	SYSGEN: SYSTEM Queue Retention parameter
CS98817	CA Online Query: Allow blocked OLQ batch SYSIPT file	Numbered option 283
GS09836	CA IDMS: DBCS-compatible menu box character	Numbered option 284
GS23359	CA IDMS Culprit: Suppress 750009 message	Profile parameter: RECMSG
GS26164	CA IDMS: Allow recursive IDD program associations	Numbered option 287
GS27525	CA IDMS: Override CV Retry message codes	SYSIDMS: CVRETRY_MSG_CODES
GS28742	CA IDMS DC/UCF: Override message buffer size for debugging	SYSGEN: Debug Message Buffers
GS33482	CA Online Query: Suppress password reporting in OLQ batch	Numbered option 286
GS48843	CA IDMS: Protect ASF/IDB signon fields	Numbered option 289
GS48844	CA IDMS: Protect ASF/IDB signon fields	Numbered option 289
GS53980	CA IDMS: Allow CV to run attached	Invoke it using a name of IDMSCV (alias for RHDCOMVS)
GS81247	CA IDMS Performance Monitor: Allow setting refresh interval on a UCF terminal	Numbered option 288
LS17909	CA IDMS: Prevent cancelling driver tasks	Obsolete. Drivers cannot be cancelled.
LS19767	CA IDMS Culprit: Specify SSN formatting	Profile parameter: SSN
LS25619	CA IDMS DC/UCF: DBCS-compatible pageable map definition in MAPC	Numbered option 307
LS25622	CA IDMS: DBCS-compatible editing for ASF initial values	Numbered option 307
LS36498	CA IDMS Masterkey: Enable tailored PFKEY defaults	PFKEY table in SSKTPARM option module
LS38822	CA ADS: Override default ADS comment delimiter	SYSGEN: ADSO Comment Delimiter
LS39409	CA IDMS SQL Option: Generate uppercase AMC messages	Obsolete. Uppercase is used if necessary based on RHDCCODE.
LS39411	CA IDMS Culprit: DBCS-extended character recognition	Profile parameter: HD
LS40898	CA IDMS DC/UCF: Override report line length for online reports	SYSGEN: SYSTEM Overriding Report Line Length
LS49906	CA IDMS: Force use of 10.2 interface to avoid CSV002I	Obsolete. Fixed in code.
LS58334	CA IDMS Dictionary Migrator: Avoid duplication of EDIT/CODE tables.	USMTPARM: TABNULL forces "EXCLUDE VALUES NULL"
LS63145	CA ADS: Force use of 4-digit years.	Numbered option 285
LS63259	CA IDMS: Override year to be treated as base for 20nn	SYSGEN: SYSTEM EVAL Base Year SYSIDMS: EVAL_BASE_YEAR
LS71078	CA ADS Alive: Disable use of NOSTOP	Numbered option 303
LS71683	CA ADS Alive: Allow special characters in record display	USGTPARM: CHARTAB table defines valid display characters
LS78113	CA IDMS DML Online: User-tailored message from USDMLXIT	USDTPARM: Defines text of messages
LS78489	CA ADS: Upward compatibility for ADS ZERO test	Numbered option 290
LS80233	CA IDMS: Set OPER refresh to 10 seconds	Numbered option 291
LS80772	CA IDMS: Make IDD USAGE RETRIEVAL the default.	Numbered option 292
LS85112	CA ADS: Support debugging dialogs > 64K	Numbered option 293
LS88822	CA IDMS Dictionary Migrator: Generate MODIFY verb instead of ADD	USMTPARM: EXPMOD=YES forces generation of MODIFY
LS88828	CA IDMS: Override default of 1 sort passes to catch more errors	SYSIDMS: DBAN_SORT_PASSES
LS88839	CA IDMS: Override ARCHIVE JOURNAL default 10% free space warning threshold	SYSIDMS: ARCHIVE_JOURNAL_WARNING_ PERCENT
LS88860	CA IDMS: Set low and high centuries for validation	SYSGEN: SYSTEM century validation SYSGEN: SYSTEM EVAL Low Century SYSGEN: SYSTEM EVAL High Century SYSIDMS: CENTURY_VALIDATION SYSIDMS: EVAL_LOW_CENTURY SYSIDMS: EVAL_HIGH_CENTURY
LS89002	CA IDMS Culprit: Override year to be treated as base for 20nn	Profile parameter: US12YR
LS94973	CA IDMS DML Online: Use BIND instead of BIND ALL	Numbered option 302
LS95989	CA IDMS: Disable SVC screening	SYSIDMS: DISABLE_SVC_SCREEN
LS96927	CA ADS Alive: Avoid displaying dialog selection list unless dialog name supplied	Numbered option 304
QO38508	Force task snaps	SYSGEN: SNAP TASK … TRACE DCMT: SNAP TASK … TRACE
QS00476	CA Endevor/DB for CA IDMS: Preserve map datetime stamp during migration	Numbered option 294
QS00477	CA Endevor/DB for CA IDMS: Retain action CLEs during compress	Numbered option 295
QS00481	CA Endevor/DB for CA IDMS: Make current date the default start date in online management facility.	Numbered option 296
QS00482	CA Endevor/DB for CA IDMS: Generate DCMT V PRO ENABLE before V NC	Numbered option 297
QS00514	CA Endevor/DB for CA IDMS: Don’t generate SIGNON statement	Numbered option 298
QS00515	CA Endevor/DB for CA IDMS: Don’t generate DCUF SET DICTNAME	Numbered option 299
QS00516	CA Endevor/DB for CA IDMS: Don’t generate SIGNON statements	Numbered option 300
QS13727	CA IDMS DML Online: Increase stack from 4 to 16K	USDTPARM: STKSIZE
QS15800	CA IDMS Database Extractor: Specify target DMCL	USVTPARM: SYSIDMS_DMCL
QS16472	CA IDMS Journal Analyzer: Selectively bypass run units	BYPASS parameter
QS21024	CA IDMS Task Analyzer: Disable exits	SYSIDMS: TASK_ANALYZER_EXITS
QS29629	CA Endevor/DB for CA IDMS: Don’t route messages to console or system log	Numbered option 301
QS39434	CA IDMS: Force RC of 0 if PRINT/ARCHIVE LOG has nothing to to print.	Numbered option 282
QS56063	CA IDMS: Override default of 1 sort pass to catch more errors	SYSIDMS: DBAN_SORT_PASSES
QS68666	CA IDMS DC/UCF: Override retention for message queues	SYSGEN: SYSTEM Message Retention
QS80740	Avoid SKTHRED BLDL failure under SAS 9	Obsolete. Fixed in code
QS90515	CA Endevor/DB for CA IDMS: Protect fields on signon screen	Numbered option 306

For a complete list of the numbered options that are supported in Version 18.0, see PIB RI29610.