Adabas is delivered with its own data conversion capability called universal encoding support (UES). Entire Net-Work detects when it is connected to a target database that converts data and passes the data through to Adabas without converting it.
To ensure UES processing is handled properly, perform the following steps.
The Adabas database must include the correct libraries and have appropriate zaps applied.
A sample startup job for a UES-enabled nucleus is provided in member ADANUCU.X in the sublibrary ADAvrs. For more information, read JCL Required for UES Support (z/VSE).
For information about UES, read Universal Encoding Support (UES) as well as ADADEF Utility: Define a Database and ADACMP Utility: Compress-Decompress Data.
Ensure that UES support has been activated in the Adabas link routines. Verify that the load modules for all Adabas 8 link routines have been linked with LNKUES and the default (or updated) translation tables and that the LGBLSET SVCNO parameter has been set. For Adabas 8, UES is enabled by default for all link routines. For information on altering UES enablement in the link routines read appropriate sections of Installing Adabas With TP Monitors, starting with the section UES-Enabled Link Routines.
UES-enabled databases can be connected to machines with different architectures through Com-plete, Software AG internal product software (APS), or through Entire Net-Work (WCP). Connections through Com-plete or Software AG internal product software (APS) use the Adabas Com-plete link routines; connections through Entire Net-Work use the Adabas batch link routines.
Effective with Adabas Version 8.3, only APS version 3.3.1 fix pack 19 and above are supported on z/VSE. Users should note that, with APS version 3.3.1 fix pack 19, a new system parameter TCPIP has been introduced. Users should add parameter TCPIP=NO to the APS reader files in use for all UES-enabled Adabas nucleus jobs.
Note:
The use of UES-enabled link routines and a UES-enabled nucleus is
transparent to applications, including applications that do not require
universal encoding translation support. Therefore, it is not necessary to
disable UES if it is already enabled.
This document covers the following topics:
To install the libraries:
The following LIBR sublibraries are distributed with Adabas for UES support:
ADAvrsCS APSvrsnn APSvrs
Ensure that all these sublibraries are restored to disk. Refer to the Software AG Product Delivery Report for the file positions on the distribution tape
Modify the Adabas startup JCL, adding the UES environment section after the ADARUN parameters:
ADARUN ..... ADARUN .... /* TCPIP=NO ENVIRONMENT_VARIABLES=/SAGLIB/ADAvrs/ENVVARS.P /* /& * $$ EOJ
Notes:
If the library containing the ECS objects in sublibary ADAvrsCS is not already defined to your Adabas startup procedure, add labels to define it:
// ASSGN SYS020,DISK,VOL=vvvvvv,SHR // DLBL DDECSOJ,’ADABAS.ADAvrs.ECSLIB’ // EXTENT SYS020,vvvvvv,1,0,ssss,tttt
Add the APS libraries to the LIBDEF chain (be sure SAGLIB.APSvrsnn is referenced before SAGLIB.APSvrs) or, if your libraries are defined via procedure ADAVvLIB, update the procedure:
// LIBDEF PHASE,SEARCH=(SAGLIB.USRLIB,SAGLIB.ADAvrs, X SAGLIB.AOSvrs,SAGLIB.ADEvrs,SAGLIB.ACFvrs, X SAGLIB.APSvrsnn,SAGLIB.APSvrs)
If you are running UES with TCP/IP support, set up the LIBDEF chain as follows (setup of the WCPvrs and WTCvrs libraries referenced in this chain is described in your Entire Net-Work documentation):
// LIBDEF PHASE,SEARCH=(SAGLIB.USRLIB,SAGLIB.ADAvrs, X SAGLIB.AOSvrs,SAGLIB.ADEvrs,SAGLIB.ACFvrs, X SAGLIB.WCPvrs,SAGLIB.WTCvrs, X SAGLIB.APSvrsnn,SAGLIB.APSvrs)
Note:
The example JCL above assumes that all sublibraries are
restored into the single library defined in the JCL via DLBL SAGLIB. If some of
the sublibraries are restored into different libraries, additional DLBL and
EXTENT labels for these libraries will be required.
Modify the ENVVARS.P file in sublibrary ADAvrs, to define the library and sublibrary where the ECS objects are located:
* This member contains Environment Variables used by APS and * APS-based applications. * ECSOBJDIR=FILE://DDECSOJ/ADAvrsCS
Note:
The example above assumes that the ECS objects are in
sublibrary ADAvrsCS of the library defined in the
JCL via DLBL DDECSOJ.
Run the ADADEF utility setting UES=YES.
* $$ JOB JNM=ADADEF,CLASS=0,DISP=D * $$ LST CLASS=A,DISP=D // JOB ADADEF EXECUTE THE ADABAS VERSION 7 UTILITY ***DEF*** // OPTION LOG,PARTDUMP * // EXEC PROC=ADAVvLIB * // EXEC PROC=ADAVvFIL * // EXEC ADARUN,SIZE=ADARUN * ADARUN PROG=ADADEF,MODE=SINGLE,SVC=svc,DEVICE=dddd,DBID=nnnn /* ADADEF MODIFY UES=YES /* /& * $$ EOJ
Start the database.
You should see the following message:
ENTIRE CONVERSION SERVICES INITIALIZED