ca-easytrieve ﬁ plus for vse 6 · 2019. 12. 19. · iv ca-easytrieve plus for vse...

EZT_PL_GS_63_MASTER.doc, printed on 02/05/01, at 10:10 PM

CA-Easytrieve ® Plus for VSE 6.3

Contents iii


Table of Contents

Installing VSEPrerequisites ..................................................................... 2

Tape Contents ................................................................ 2Using MSHP ..................................................................... 3

Standard Installation JCL ...................................................... 4Installing CA-Easytrieve Plus .................................................. 5

Step 1: Install Unicenter TNG Framework for OS/390 Tape........................... 6License Management Program Processing....................................... 6

Step 2: Complete the MSHP Installation Worksheet .................................. 6Step 3: Restore Product History File and Library..................................... 8

Extract Initial Install JCL....................................................... 9JOB CAINSTB1: Initial Computer Associates Product Installation ................. 9JOB CAINSTB2: Subsequent Computer Associates Product Installation ........... 10JOB CAINSTB3: Migration of Computer Associates Products Into Production ..... 11

Step 4: Complete the CA-Easytrieve Plus Worksheet ................................ 11CA-Easytrieve Installation Worksheet ......................................... 12

Step 5: Install CA-Easytrieve Plus Components ..................................... 18INSJOB1 - 'Unload Object from Tape' .......................................... 20INSJOB2 - 'Link Edit CA-Easytrieve Plus Modules'.............................. 21INSJOB3A - 'Customize Execution Options' .................................... 22INSJOB3B - 'Regenerating Execution Options Parameters' ....................... 23

Step 6: Execute Customization Jobs................................................ 25INSJOB4 - 'Customize Extended Reporting Module'............................. 25INSJOB5 - 'Install EZTPSPRA Driver Module' .................................. 25INSJOB6 - 'Install User Requirements Table' .................................... 27INSJOB7 - 'Install DBCS Options Module' ...................................... 28

Step 7: Install VSAM Macro Library Support ....................................... 29INSJOB8A and INSJOB8B .................................................... 30

'Install Execution Options Table for VSAM Macro Library Support' ........... 30'Execute Installation Jobs INSJOB8A and INSJOB8B'......................... 30'Define and Initialize VSAM Data Set' ...................................... 31Maintaining Your VSAM Macro Library ................................... 32

iv CA-Easytrieve Plus for VSE


Member INSJOB1.Z ..........................................................35Member INSJOB2.Z ..........................................................43Member INSJOB3A.Z.........................................................51Member INSJOB3B.Z .........................................................52Member INSJOB4.Z ..........................................................54Member INSJOB5.Z ..........................................................55Member INSJOB6.Z ..........................................................56Member INSJOB7.Z ..........................................................57Member INSJOB8A.Z.........................................................58Member INSJOB8B.Z .........................................................59Member INSJOB9.Z ..........................................................66

Sample Members ................................................................69VSE Maintenance Procedures .....................................................71

VSE Genlevel Maintenance....................................................71VSE APAR Maintenance ......................................................73

VSE Operating System............................................................73VSE Files ....................................................................74

VSE JCL Examples........................................................79ICCF Installation.................................................................84

ICCF Procedure ..............................................................85

Step 8: Verify Installation of CA-Easytrieve Plus .................................... 33INSJOB9 - 'Install Sample Files'................................................ 33

VSE Installation JCL ............................................................. 35

Installing VSE 1


Installing VSE

This article describes how to install CA-Easytrieve Plus in VSE. The machine-readable program materials required for installation are distributed as a multi-file installation tape in library BACKUP format suitable for installation using the IBM Maintain System History Program (MSHP). See �Tape Contents� in this article for a detailed description of the tape format and contents.

MSHP, a tool with which you are probably familiar, is used to perform product installation and maintenance. MSHP lets you control these activities in a consistent manner. This format is also used by systems programmers to maintain the VSE operating system.

MSHP performs the installation and maintenance ofCA-Easytrieve Plus in much the same way as the operating system is installed and maintained. When you use MSHP to install a product, an MSHP history file is required to archive product information, such as product identification and library residence. The history file is subsequently used during maintenance application for product and library identification, and for archival of maintenance information. The distribution tape includes the libraries containing CA-Easytrieve Plus, which should be kept separate from the operating system's history file. Also, we recommend that the CA-Easytrieve Plus target libraries be kept apart from the VSE system libraries or sub-libraries.

Prerequisites

2 CA-Easytrieve Plus for VSE


PrerequisitesCA-Easytrieve Plus operates under VSE/SP 2.1 and laterreleases, and requires Unicenter TNG Framework for OS/390Release 1.4 or above.

The installation of CA-Easytrieve Plus requires approximately4,000 1K library blocks and 800 directory entries.

Tape Contents

File Description

001-009 CA-Easytrieve Plus Components - Encrypted

010 Tape Mark

011 History File Backup Format

012 Library Backup Format

013 MSHP Installation JCL(CAINSTB1,CAINSTB2,CAINSTB3)

014 Sample File PERSNL

015 Sample File INVMSTR

016 Sample File KANJI

017-19 Reserved

020 README File

021 Maintenance JOB1 File

022 Maintenance JOB2 File

023-025 Maintenance Library Backup Format

026-030 Reserved

031 CMS/DOS Files

Using MSHP

Installing VSE 3


File Description

032 Tape Mark

033 Maintenance CMS/DOS Files

034-083 Tape Marks

Using MSHPComputer Associates has developed standardized proceduresfor installing products using the VSE MSHP utility. Thesestandards enable a common method of installation for allComputer Associates VSE products. The installation processuses two types of history files and libraries: Production andInstallation.

■ Production Libraries and History File�These are createdwhen the first Computer Associates product tape is installedusing this standard. This library or library set and historyfile should contain all Computer Associates VSE productionproducts. Therefore, sufficient space should be allocated tocontain all VSE products expected to be installed, even ifonly one product is being installed initially. When a productis subsequently installed, or reinstalled, it is not merged intothe production library set and history file until testing iscomplete.

■ Installation Libraries and History File�These are used forsubsequent product installation to avoid installation of anew product, or new release of an existing product, into theproduction environment. These libraries and history file areused for product installation, verification, and testing. Eachproduct tape that is installed creates a separate library(s) andhistory file that is unique for that product. Once all testing iscomplete, the product is merged into the productionlibraries and history file.

Using MSHP



Creating the above two library sets requires two differentinstallation procedures and sets of JCL, depending on whetherthe installation is an initial or subsequent installation. When thefirst standardized Computer Associates VSE product tape isinstalled, one job creates the production library or library set andhistory file, and installs the product(s) into same. When asubsequent product tape is installed, the installation library orlibrary set and history file are created and used until the productis ready to be migrated into the production environment, atwhich time the installation library set is deleted.

Standard Installation JCL

Standard installation JCL is provided and must be used for the installation of all Computer Associates VSE products. This JCL is described in detail, later in this article. The following table lists the JCL members and information associated with each:

JobName

VSEVersion

WhereResides

SourceMember Description

CAINSTB1 Ver 2 sourcelibrary

CAINSTB1.Z Used to performthe initialComputerAssociatesproductinstallation usingthis standard.


CAINSTB2.Z Used to performall subsequentComputerAssociatesproductinstallations.

Using MSHP

Installing VSE 5


JobName

VSEVersion

WhereResides

SourceMember Description


CAINSTB3.Z Used to mergeproducts into theProductionlibrary(s) andHistory file wheninstalled withCAINSTB2.

Installing CA-Easytrieve Plus

The steps to install CA-Easytrieve Plus at your site are:

1. Install Unicenter TNG Framework for OS/390 tape.

2. Complete the MSHP Installation Worksheet.

3. Restore product history file and library.

4. Complete the CA-Easytrieve Plus Worksheet.

5. Install CA-Easytrieve Plus Components.

6. Execute customization jobs.

7. Install VSAM Macro Library Support.

8. Verify installation of CA-Easytrieve Plus.

Step 1: Install Unicenter TNG Framework for OS/390 Tape



Step 1: Install Unicenter TNG Framework for OS/390 Tape

CA-Easytrieve Plus uses several Unicenter TNG Framework forOS/390 facilities during the compilation and execution ofprograms. The Unicenter TNG Framework for OS/390 tapeconsists of components common to all Computers AssociatesVSE products. CA-Easytrieve Plus for VSE requires UnicenterTNG Framework for OS/390 Release 1.4 or above.

If you have already installed the latest Framework tape, thenyou can skip this step and continue to the next installation step.Otherwise, see the Unicenter TNG Framework for OS/390 GettingStarted to install the Unicenter TNG Framework for OS/390 tape.

License Management Program Processing

CA-Easytrieve Plus uses the License Management Program(LMP) services provided by Unicenter TNG Framework forOS/390 to validate the user's configuration. LMP reports onactivities related to the license, usage, and financials of CASolutions.

For complete information on defining an LMP execution key,overall usage, and other Services, see the Unicenter TNGFramework for OS/390 Getting Started.

Step 2: Complete the MSHP Installation WorksheetExecution of jobs CAINSTB1, CAINSTB2, and CAINSTB3requires certain parameters to be valued relating to theinstallation process, such as:

■ Which DASD packs are used to hold production libraries andhistory files.

■ Which DASD packs are used to hold installation libraries andhistory files.

Step 2: Complete the MSHP Installation Worksheet

Installing VSE 7


■ What file IDs and extent information are used for librariesand files.

The following worksheet is provided to help you define theseitems. It should be completed before continuing with theinstallation procedure. The keywords on the worksheet are thesame as the symbolic parameters used in the suppliedinstallation JCL. These keywords can then be used to update thesample installation JCL for proper execution.

MSHP Installation Worksheet

Description KeywordMaxLength

1. Supplyinformation topersonalize theProductionHistory File.

Customer Name

Customer Address

Customer Phone Number

Programmer Name

@CUSTNME=_________

@CUSTADD=_________

@CUSTPHN=_________

@PROGNME=_________

44

35

25

32

2. Supplyinformation forthe ProductionHistory Fileextent.

Volume ID of DASD pack

Beginning relativetrack/block

Number of tracks or blocks

@HISTVOL=__________

@HISTREL=_________

@HISTEXT=_________

6

4

4

3. Supplyinformation forInstallationHistory Fileextent.




@INSTVOL=_________

@INSTREL=_________

@INSTEXT=_________

6

4

4

4. Supply tapedrive addresswhere installationtape will bemounted.

Tape drive address CUU @TAPECUU=_________ 3

Step 3: Restore Product History File and Library



Description KeywordMaxLength

5. Supply extentinformation forProductionLibrary extent.




@DLIBVOL=_________

@DLIBREL=_________

@DLIBEXT=_________

6

4

4

6. Supplyinformation forthe InstallationLibrary extent(see VSE LibrarySpaceRequirementsdescribed earlier).




@ILIBVOL=_________

@ILIBREL=_________

@ILIBEXT=_________

6

4

4

7. Supplyproduct nameand product codeof CA-EasytrievePlus.

Product name:

Product code: (see note)

@PRODUCT= EPL

@PRODCDE= EPL63

3

5

Note: The last two digits of the product code can vary from onegenlevel to another. You should use the last five characters of thegenlevel from the product tape for the product code.

Step 3: Restore Product History File and LibraryThis step creates the Computer Associates libraries and MSHPhistory file and unloads the product from the tape.

File 13 of the CA-Easytrieve Plus product tape contains threeinstallation JCL members, CAINSTB1, CAINSTB2, andCAINSTB3.


Installing VSE 9


The restore requires the execution of either job CAINSTB1 orCAINSTB2. Job CAINSTB3 is a migration step to be performedafter a successful installation and verification of a product.

Extract Initial Install JCL

Use the following sample JCL to extract the three JCL membersand catalog them into an existing VSE user library.

* $$ JOB JNM=EXTRACT <=== complete job card// JOB CAINSTBO// SETPARM USRLIB='@USRLIB' <=== provide library name// SETPARM SUBLIB=@SUBLIB <=== provide sub library name// SETPARM USRLIBV=@USRLIBV <=== provide library volume// SETPARM TAPECUU=@TAPECUU <=== provide tape unit

// MTC REW,&TAPECUU // MTC FSF,&TAPECUU,12 // ASSGN SYSIPT,&TAPECUU // DLBL USRLIB,'&USRLIB' // EXTENT ,&USRLIBV // EXEC LIBR,PARM='ACCESS SUBLIB=USRLIB.&SUBLIB' // RESET SYSIPT /&

* $$ EOJ

Note: The initial install JCL file is located on File 13 of theproduct tape and the MSHP history and data files start on File10. This differs from several Computer Associates product tapes.

Note: Always use the jcl from the CA-Easytrieve Plus tape, it isalready customized for downloading File 10.

JOB CAINSTB1: Initial Computer Associates Product Installation

The initial product installation JCL creates the productionlibraries and history file which are to be used for the installationof all Computer Associates products for the VSE environment.Job CAINSTB1 then installs this product into the newly createdlibraries and history file. Execute job CAINSTB1 only to installthe first Computer Associates product using this standard.




Job CAINSTB1 performs the following functions:

1. Opens SYSPCH using the extent of the history file. Thisaction is a precautionary measure to avoid errors when thehistory file extent resides on a newly defined VM minidisk.

2. Creates the Computer Associates production MSHP historyfile and production libraries.

3. Installs the product into the production history file andlibraries.

If this is the first Computer Associates product to be installedusing this standard, then:

■ Modify the JCL for job CAINSTB1, setting values for theparameters as specified on your MSHP worksheet.

■ Provide a valid $$ JOB and $$ EOJ card.

■ Change any reference of '@*' to '/*' and change '@&' to '/&'.

■ Mount the product tape and submit the job for execution.

■ After successful execution, continue with Step 4.

JOB CAINSTB2: Subsequent Computer Associates Product Installation

Job CAINSTB2 is used to install a product into test libraries topermit installation, verification, and testing prior to migrationinto the production libraries.

Job CAINSTB2 performs the following functions:

1. Opens SYSPCH using the extent of the history file. Thisaction is a precautionary measure to avoid errors when thehistory file extent resides on a newly defined VM minidisk.

2. Creates the Computer Associates installation libraries andhistory file for the product being installed.

3. Installs the product into the installation history file andlibraries.

Step 4: Complete the CA-Easytrieve Plus Worksheet

Installing VSE 11


If this is not the first Computer Associates product to be installedusing this standard, then:




■ Mount the product tape and submit the job for execution.

■ After successful execution, continue with Step 4.

Note: If you must rerun this job, specify REPLACE on theDEFINE statement of job CAINSTB2.

JOB CAINSTB3: Migration of Computer Associates Products Into Production

Job CAINSTB3 is used to migrate a product from the installationlibraries and history file to the production libraries and historyfile. This job is executed only after product installation,customization, verification, and testing are complete. When youare ready to migrate the product into production, then:




■ Submit the job for execution.


After executing either job CAINSTB1 or CAINSTB2, you mustcomplete the installation of CA-Easytrieve Plus by executing jobsthat have been restored to the CA-Easytrieve Plus productlibrary.




Before executing these jobs, you must provide values forparameters that are used by the installation process. Thekeywords on the worksheet are the same as the symbolicparameters used in the supplied JCL.

Note: In VSE version 2, substitution is made only for values inJCL and does not take place for data statements. You mustprovide values for symbolic parameters and values in controlcard images.

CA-Easytrieve Installation Worksheet

Description Keyword

1. Supply information forProduction or InstallationLibrary.

Name of Library containingCA-Easytrieve Plus.

Sublibrary Name.


@EZTPLIB=_________

@EZTPSUB=_________

@EZTPVOL=_________

2. Supply address wheretape is to be mounted.

Tape drive address CUU @TAPECUU=_________


Installing VSE 13


Description Keyword

3. Supply CA-EasytrievePlus Options information.Indicate YES for eachOption to be installed.Indicate NO if the Optionis not to be installed.

Note: If you intend touse the SQL Option, youmust install CA-Pan/SQLas well.

Runtime Option

Compiler Option

DBCS (Double-Byte CharacterSupport) Option

CA-Datacom/DB Option

DLI Option

IDMS Option

SQL Option

SUPRA Option

TOTAL Option

Suport for COBOL II calledprograms

Support for LanguageEnvironment (Allows calls toCOBOL for VSE programs)

@RNTMOPT=________

@CMPLOPT=_________

@DBCSOPT=_________

@DTCMOPT=________

@DLIOPT=__________

@IDMSOPT=_________

@SQLOPT=__________

@SUPROPT=_________

@TOTLOPT=_________

@RNTCOB2=_________

@RNTLE=_________

4. Supply information forCA-Datacom Libraries ifDatacom Option is beinginstalled.

CA-Datacom/DB Library Name

CA-Datacom/DB SublibraryName


@DTCMLIB=_________

@DTCMSUB=________

@DTCMVOL=________

5. Supply information forDLI Libraries if DLIOption is being installed.

DLI Library Name

DLI Sublibrary Name


@DLILIB=__________

@DLISUB=__________

@DLIVOL=__________

6. Supply information forCA-IDMS Libraries ifIDMS Option is beinginstalled.

CA-IDMS Library Name

CA-IDMS Sublibrary Name


@IDMSLIB=_________

@IDMSSUB=_________

@IDMSVOL=_________




Description Keyword

7. Supply additionalinformation forCA-IDMS.

Indicate YES if running withCA-IDMS Release 12.

Specify NO if running withCA-IDMS Release 10.

Indicate YES if you want IDMSmodules to be dynamicallyloaded at runtime or NO for astatic link.

@IDDRL12=_________

@IDMSDYN=_________

8. Supply information forSUPRA Libraries ifSUPRA Option is beinginstalled.

SUPRA Library Name

SUPRA Sublibrary Name


@SUPRLIB=_________

@SUPRSUB=_________

@SUPRVOL=_________

9. Supply information forTOTAL Libraries ifTOTAL Option is beinginstalled.

TOTAL Library Name

TOTAL Sublibrary Name


@TOTLLIB=_________

@TOTLSUB=_________

@TOTLVOL=_________


Installing VSE 15


Description Keyword

10. Supply informationfor temporary work datasets.

Link Control Information DataSet Name.

Link Control Information DataSet Volume ID of DASD pack

Link Control Information DataSet Starting DASD Track

Link Control Information DataSet Number of Tracks.30 3380 tracks is sufficient.

@LINKDAT=_________

@LINKVOL=_________

@LINKSTR=_________

@LINK#TR= 30

11. If you are using theExtended Reportingfeature of CA-EasytrievePlus, supply informationfor a temporary workdata set.

Extended Reporting Work DataSet Name

Extended Reporting Work DataSet Volume ID of DASD pack

Extended Reporting Work DataSet Starting DASD Track

Extended Reporting Work DataSet Number of Tracks.30 3380 tracks is sufficient.

@XRPTOUT=_________

@XRPTVOL=_________

@XRPTSTR=_________

@XRPT#TR= 30

12. Supply informationfor CA-Easytrieve VFMfile.

VFM Data Set Volume ID ofDASD pack

VFM Data Set Starting DASDTrack

VFM Data Set Number ofTracks. 10 3380 tracks issufficient.

@VFMVOL=__________

@VFMSTR=__________

@VFM#TR= 10




Description Keyword

13. If you are installingthe DBCS Option ofCA-Easytrieve Plus,supply information for atemporary work data set.

DBCS Work Data Set Name

DBCS Work Data Set VolumeID of DASD pack

DBCS Work Data Set StartingDASD Track

DBCS Work Data Set Numberof Tracks. At least 20 3380tracks are needed.

@DBCSOUT__________

@DBCSVOL__________

@DBCSSTR=_________

@DBCS#TR= 20

14. Supply informationfor CA-EasytrieveOptions Table temporarydata set.

Options Table Output Data SetName

Options Table Output Data SetVolume ID of DASD pack

Options Table Output Data SetStarting DASD Track

Options Table Output Data SetNumber of Tracks

@OPTOUT=__________

@OPTVOL=__________

@OPTSTR=__________

@OPT#TR=__________


Installing VSE 17


Description Keyword

15. Supply informationfor CA-Easytrievepermanent sample files:SMPFILE, INVFILE,PAYFILE.

Sample File Name

Sample File Volume ID ofDASD pack

Sample File Starting DASDTrack

Sample File Number of Tracks.10 3380 tracks are sufficient.

Inventory File Name

Inventory File Volume ID ofDASD pack

Inventory File Starting DASDTrack

Inventory File Number ofTracks. 2 3380 tracks aresufficient.

Payroll File Name

Payroll File Volume ID ofDASD pack

Payroll File Starting DASDTrack

Payroll File Number of Tracks.2 3380 tracks are sufficient.

@SMPFILE=__________

@SMPFVOL=_________

@SMPFSTR=_________

@SMPF#TR= 10

@INVFILE=__________

@INVFVOL=_________

@INVFSTR___________

@INVF#TR= 2

@PAYFILE=__________

@PAYFVOL___________

@PAYFSTR___________

@PAYF#TR= 2

16. Provide informationfor LE support or COBOLII support. (See Note 1below.)

LE SCEE Library Name(SeeNote 2 below.)

LE SCEE Sublibrary

LE Library Volume

COBOL II Library Name (SeeNote 2 below.)

COBOL II Sublibrary

COBOL II Library Name

@LESCEE=___________

@SCEESUB=_________

@SCEEVOL=________

@COB2=___________

@COB2SUB=________

@COB2VOL=__________

Step 5: Install CA-Easytrieve Plus Components



Note 1: CA-Easytrieve Plus 6.3 provides support for LE(Language Environment). If your CA-Easytrieve Plus programscontain CALLs to other programs that require LE, then providevalues for the parameters thatrefer to your LE libraries,otherwise provide values that refer to your COBOL II libraries.

Note 2: If you need support for LE, provide the name of yourLE SCEE library that contains modules CEEBETBL, CEEBINT,CEEBLLST, CEEBPUBT, CEEBTRM, and CEEINT. Otherwise,provide the name of your COBOL II library that containsmodules IGZERRE and IGZEBST.

Step 5: Install CA-Easytrieve Plus ComponentsThe following members exist in the Computer Associates Product or Installation library as a result of Step 3 which restored the CA-Easytrieve Plus library from the tape. The sample jobs can be found at the end of this article.

Member Name Description

INSJOB1.Z Install Job 1 - Unload the CA-Easytrieve Pluscomponents from the tape.

INSJOB2.Z Install Job 2 - Link Edit the CA-EasytrievePlus phases.

INSJOB3A.Z Install Job 3A - Customize the ExecutionOptions Table for CA-Easytrieve Plus.

INSJOB3B.Z Install Job 3B - Utility to regenerate theoptions data for CA-Easytrieve Plus.

INSJOB4.Z Install Job 4 - Customize the ExtendedReporting Options module for CA-EasytrievePlus, if using extended reporting.

INSJOB5.Z Install Job 5 - Customize the SUPRA Driverphase, if installing the SUPRA option forCA-Easytrieve Plus.


Installing VSE 19


Member Name Description

INSJOB6.Z Install Job 6 - Install User RequirementsTable, if installing the DATACOM Option forCA-Easytrieve Plus.

INSJOB7.Z Install Job 7 - Customize the DBCS Optionsmodule, if installing the DBCS (Double-ByteCharacter Support) Option for CA-EasytrievePlus.

INSJOB8A.Z Install Job 8A - Install the VSAM MACROlibrary initialization phase MACADD, ifusing the VSAM MACRO Library support.

INSJOB8B.Z Install Job 8B - Install the VSAM librarymaintenance phase EZTPMNT, if using theVSAM MACRO Library support.

INSJOB9.Z Install Job 9 - Execute CA-Easytrieve Plusprogram to verify the installation ofCA-Easytrieve Plus.

Install Jobs 1, 2, and 3A are required to build the CA-EasytrievePlus product, installing the selected components. Execution ofthe remaining jobs are dependent on which options orcomponents are installed.

Before submitting any job for execution, you must providevalues for the parameters defined at the beginning of the JCLand for symbolic values, specified in control card images.

These statements are marked with /* <==== */ in column 60. Foreach job, you also must modify the Power JOB and EOJ card.

A description of each job follows.




INSJOB1: Unload Object from Tape

Install Job 1 unloads and decrypts the text decks for the various components of CA-Easytrieve Plus. You indicate which options or components you want to install by specifying YES for the option parameter value of the SETPARM command. A value of NO bypasses the install step for the specific option. You do not have to modify any JCL.

Replace �12345678� on the PASSWORD command statement, with the password of the option that you want to install. See the comments in the JCL later in this article. Some passwords must be provided in more than one step, such as unloading component source and unloading component object decks.

The passwords can be found on the Authorization Sheet enclosed with the product tape.

■ If an option is to be installed, indicate YES for the specificoption parameter along with its password.

■ If the option is not to be installed, indicate NO for the optionparameter without any password.

After supplying values for the required parameters, do thefollowing:

1. Mount the product tape.

2. Submit the job for execution. The job should complete with areturn code of 0.

If the job abends with a status=12* from any EXEC CAIIPDSstep, verify that you have supplied the correct password, makeany necessary corrections, and rerun the job.


Installing VSE 21


INSJOB2: Link Edit CA-Easytrieve Plus Modules

Install Job 2 executes the linkage editor for each component.Therefore, you must indicate which options or components areto be installed.

For some options, you must provide the name of other productlibraries, whose modules are link edited with CA-EasytrievePlus.

The link edit control cards exist in the CA-Easytrieve Plusproduct library. For each component, the link edit controlmember is punched to a disk file. This file requires 30 tracks of3380 disk space. The same disk space is used repeatedly as eachcomponent is link edited.

Modify the JCL as required, providing values for the parametersand symbolic values throughout the JCL member.

Submit the job for execution. The job should complete with areturn code of 0 for all modules except for the following:

1. The link edit of EZTPA00 will complete with a return codeof 4 if all components are not installed.

2. The link edit of modules EZTPETIU and EZTPETIVcomplete with a return code of 4.

3. The link edit of modules EZTPA181, EZTPD14, EZTPD141,EZTPD142, and EZTPD143 complete with a return code of 8due to unresolved external references to LE or COBOL IImodules.

You should now have a functioning CA-Easytrieve Plus baseproduct. The installation of the DLI, SQL, TOTAL, or CA-IDMSOptions are also complete; no additional steps are required.




Installation of the TOTAL Option installed the following macrosinto the CA-Easytrieve Plus product library:

ADDM DFNTOTF READM TOTALCOMADDV FINDX READR WRITMCLOSX OPENX READV WRITVDELM RDNXT SINOFDELVD READD SINON

Continue processing remaining jobs to complete the installationof other options and features.

INSJOB3A: Customize Execution Options

Install Job 3A is a required installation step which lets you defineyour CA-Easytrieve Plus Execution Options Table. You simplyspecify your options for the various parameters and assemblethe macro. You can rerun this job as many times as needed.

The Options Table (phase EZTPOPT) provides the basicparameters that control CA-Easytrieve Plus operation. The�Options Table� appendix of this guide lists each parameter inalphabetical order.

Space is provided for you to note the options that were selectedat installation.

Some of the Options can be overridden by CA-Easytrieve Plusstatements; this information is noted in the �Options Table�listing.

Several parameters apply to the installation of CA-EasytrievePlus. These are the MACRO parameters:

■ MAC#LIB

■ MACDDN

■ MACRO.


Installing VSE 23


These parameters relate to the library type that is to contain youruser-defined macros for use with CA-Easytrieve Plus.

The default macro library type is PAN for CA-Panvalet.

Installation of the SUPRA Option requires the use of theEZTPSPRA macro which is stored in the installation library. Ifyou are installing the SUPRA option, you must specifyMACRO=SSL for Install Job 3A.

If you are not sure which options you need at this time, thensimply change the company name value and execute this job.

You can always rerun the job at a later time. Execution of this jobshould complete with a return code of 0.

INSJOB3B: Regenerating Execution Options Parameters

Once installation of the execution options has occurred, it canlater become necessary to reproduce the control cards used tocreate the options table. This need can arise when the originalcontrol cards are no longer accessible and programmers are nolonger aware of which options are in effect.

The CA-Easytrieve Plus program shown on the next page callsan assembler routine, EZTPX05. EZTPX05 places the executionoption definitions into an 80-byte area (RECORD in thisexample) occurring 200 times. The CA-Easytrieve Plus programthen loops through this output area looking for the end of theexecution options (field ENDREC in this example). As it scansfor the end of the execution options, the CA-Easytrieve Plusprogram displays the record and writes the record to an outputfile, OPT.

File OPT can then be used as input to the assembler toregenerate CA-Easytrieve Plus system execution options.




When executing this job, you must be aware of the following:

■ Only options that are valued with non-default values aredisplayed and written to the output file.

■ The SYSTEM= parm_value is always displayed.

■ You must NOT modify the source program or add a PARMstatement. Adding a PARM statement would override theexecution options of the existing Options Table.

■ You must NOT link the sample program EZTPX05A. Thiswould result in linking the current Options Table withEZTPX05A; thus, always reporting the values of the linkedtable.

Execution of this job should complete with a return code of 0.*** EXAMPLE** DO NOT USE A PARM STATEMENT!FILE OPT FB (80 6160)OUTREC_ 1 80 ARECORD_ W 80 A OCCURS 200 INDEX INDEX_ENDREC_ W 80 AEND_ ENDREC_ +10 3 A VALUE('END')COUNTER_ W 5 PJOB INPUT NULL NAME X050 INDEX_ = 0 CALL EZTPX05 USING(RECORD_) COUNTER_ = 0 DO WHILE COUNTER_ < 200 INDEX_ = COUNTER_ * 80 OUTREC_ = RECORD_ PUT OPT DISPLAY OUTREC_ IF OUTREC_ = ENDREC_

COUNTER_ = 200 END-IF COUNTER_ = COUNTER_ + 1 END-DO STOP

Sample output from the program above:* CA-EASYTRIEVE Plus OPTION TABLE GEN LEVEL 6.3

OPTTBL C SYSTEM=DOS, C MACRO=PDS

END

Step 6: Execute Customization Jobs

Installing VSE 25


The above output can be directly passed to the options tablebuilding procedures discussed previously.

Step 6: Execute Customization JobsInstallation Jobs 4 through 7 customize the selected options ofCA-Easytrieve Plus. They can be executed in any order.

INSJOB4: Customize Extended Reporting Module

If you want to use the Extended Reporting Facility ofCA-Easytrieve Plus, you must customize and install theExtended Reporting Module EZTPXRPT. The CA-Easytrieve PlusExtended Reporting Facility Guide explains the functionality andcustomization options that you must understand in order todefine your Extended Reporting Module.

Review this guide, then provide the necessary commands in theJCL as input to the EZTPX04 program.

You can execute this job as many times as needed.

This job should complete with a return code of 0.

INSJOB5: Install EZTPSPRA Driver Module

If you are installing the SUPRA Option for CA-Easytrieve Plus,then you must customize the SUPRA Driver phase.

The SUPRA Option consists of two phases, EZTPSLUV andEZTPSPRA.

■ Module EZTPSLUV is a renamed copy of the SUPRAmodule CSVJLUV.

■ Module EZTPSPRA is generated by compiling theCA-Easytrieve Plus macro EZTPSPRA with your specifiedoptions.




The EZTPSPRA macro is installed in the product library byInstall Job 1, INSJOB1. For this macro to be used byCA-Easytrieve Plus, you must assemble the Execution OptionsTable with MACRO=SSL. If you did not specify this value whenexecuting Install Job 3, INSJOB3, you must re-execute this jobbefore customizing your SUPRA Driver.

After you have compiled the Execution Options Table withMACRO=SSL, you can customize the SUPRA preprocessor foryour environment.

■ Modify the JCL as required, providing values for theparameters and symbolic values.

■ Modify the MACRO parameters in the JCL for job INSJOB5which are input to the EZTPA00 program. The �InstallingSUPRA Interface Option� appendix of this guide defines theparameters of the EZTPSPRA macro.

■ Remove the comment "/*<====*/" from the CA-EasytrievePlus Input Statements.

Submit the job for execution. The job should complete with areturn code of 0.

See the CA-Easytrieve Plus SUPRA Interface Option Guide forinformation on how to use the SUPRA Option.


Installing VSE 27


INSJOB6: Install User Requirements Table

If you are installing the Datacom Option for CA-Easytrieve Plus,then you must define the User Requirements Tables whichsupport your CA-Datacom/DB application programmingrequirements. You must create a CA-Easytrieve Plus URT foreach database table that is accessed by your application.

The Datacom Option for CA-Easytrieve Plus consists of thefollowing phases and macros:

Modules:

■ EZTPDTCM

■ EZTPDRVR

Macros:

■ DBCLOSE

■ DBEL

■ DBFILE

■ DBLREQ

■ DBOPEN

■ DBRA

■ DBREQ2

■ DBREQ3

■ DBSREQ

■ DBUID

■ DBWA

User Requirements Tables:

■ urtname (user defined)

The Datacom macros and phases are installed in the productlibrary by Install Job 1, INSJOB1.




INSJOB6 uses CA-Datacom/DB macros to create your UserRequirements Tables. Each User Requirements Table is linkedwith a copy of the CA-Easytrieve Plus phase, EZTPDRVR, andcreates a phase with the user-supplied name of 'urtname'.

Before submitting this job for execution:

■ Modify the sample job, specifying valid values for thetblnam, update, and usrinfo parameters of theCA-Datacom/DB macros.

See the CA-Datacom/DB Database and System AdministrationGuide for information on defining User Requirements Tables.

■ Specify a name for the link edited User Requirements Tablephase on the PHASE statement. You can catalog the UserRequirements Table in the CA-Easytrieve Plus productlibrary or in some other user library.

■ Provide values for all parameters and symbolic valuesthroughout the job.

■ Provide a valid JOB and EOJ card.

Submit the job for execution. The assembly step should completewith a return code of zero. The link step completes with a returncode of 4 and an unresolved reference to DBMSCBL.

See the CA-Datacom/DB Interface Option Guide for CA-EasytrievePlus for information on how to use the Datacom Option.

INSJOB7: Install DBCS Options Module

The CA-Easytrieve Plus DBCS Option provides support for theDouble-Byte Character Set. To install this option, you mustdefine the commands to CA-Easytrieve Plus to generate theDBCS Options Module.

Step 7: Install VSAM Macro Library Support

Installing VSE 29


The DBCS Commands are defined in the �Installing DBCSOption� appendix. Read the entire section before attempting toinstall this option. After you have decided on the commandsneeded to define your DBCS options, then do the following:

■ Enter the commands where indicated as input to phaseEZTPX03.

■ Provide values for all parameters and symbolic valuesthroughout the job.

■ Provide a valid JOB and EOJ card.

Submit the job for execution. The job should complete with areturn code of 0. You can execute this job as many times asneeded.

Step 7: Install VSAM Macro Library SupportCA-Easytrieve Plus supports five library types for the storage ofmacros:

■ CA-Panvalet

■ CA-Librarian

■ Source Statement Library

■ VSAM

■ USER-defined library structure.

You specify the library type in the CA-Easytrieve Plus OptionsTable with the MACRO parameter.

The default is CA-Panvalet.

The �Macro Libraries� appendix contains a summary of each ofthe macro interfaces. If you have chosen a library structure otherthan VSAM, then skip the remainder of this section and simplyreview the appendix.




To implement VSAM Macro Library Support, you must executethe following steps:

1. Install the Execution Options Table with the followingvalues:MACRO=VSAMUPDTVS=YESMACDD=ddname (ddname of VSAM Library, default=PANDD)

2. Execute Installation Jobs INSJOB8A and INSJOB8B.

3. Define and Initialize your VSAM data set.

4. Perform maintenance functions on your VSAM data set.

INSJOB8A and INSJOB8B

Install Execution Options Table for VSAM Macro Library Support

In order to execute INSJOB8A and INSJOB8B, you must haveinstalled your CA-Easytrieve Plus Execution Options Table withthe following values:MACRO=VSAMUPDTVS=YESMACDD=ddname of VSAM Library (default=PANDD)

If you did not specify these VSAM parameters, then you cannow run INSJOB3A 'Customize Execution Options' and return tothis step.

Execute Installation Jobs INSJOB8A and INSJOB8B

INSJOB8A uses CA-Easytrieve Plus to compile the VSAMInitialization program MACADD and link edit the module intothe Product Library. The VSAM Initialization program loads theVSAM data set with a date record.

Submit INSJOB8A for execution. This job should complete witha return code of 0.


Installing VSE 31


INSJOB8B uses CA-Easytrieve Plus to compile the VSAM MacroMaintenance program EZTPMNT and link edit the module intothe Product Library. The Maintenance program updates themaintenance date record each time maintenance is performed onthe library.

Submit INSJOB8B for execution. This job should complete with areturn code of 0.

Define and Initialize VSAM Data Set

Defining Your VSAM Data Set

You create your VSAM macro library using the IDCAMS Utility.The only CA-Easytrieve Plus requirement of your VSAM dataset is that the KEYS and RECORDSIZE statements be coded asshown in the following example: DEFINE CLUSTER (NAME(macro-library-name) -

KEYS(30 0) -SPEED -SHAREOPTIONS(2,3) -UNIQUE TO (yyddd) -VOLUME -RECORDSIZE(110 110) -RECORDS (primary,secondary))

Note: A VSAM KSDS is used to store CA-Easytrieve PlusMACRO statements.

A 30-byte key is required where:

■ The first 21-characters define the macro name, a left-justifiedalphabetic field padded with spaces.

■ The last nine bytes of the key contain a sequence number,right-justified numeric field padded with zeros.

An 80-character data area is required.




Initializing Your VSAM Macro Library

Before you can use your VSAM data set for CA-Easytrieve Plusmacros, you must load a maintenance date record in the libraryby executing the CA-Easytrieve Plus MACADD program.

The following JCL can be used for executing the VSAMInitialization program MACADD:

* $$ JOB jobname// JOB VSAM INITIALIZATION// DLBL IJSYSCT,'your.vsam.catalog',,VSAM// EXTENT ,catlvol// DLBL MACFILE,'your.easytrieve.vsam.macro.library',0,VSAM// EXTENT ,macfvol// DLBL EZTPLIB,'your.easytrieve.library',0,SD// EXTENT ,eztpvol// LIBDEF PHASE,SEARCH=EZTPLIB.sublib,TEMP// EXEC MACADD,SIZE=512K/&* $$ EOJ

Maintaining Your VSAM Macro Library

Now that the VSAM macro maintenance program is installed,you can perform maintenance functions on your VSAM macrolibrary. The following JCL can be used for performing VSAMmacro maintenance.

* $$ JOB jobname// JOB VSAM INITIALIZATION// DLBL IJSYSCT,'your.vsam.catalog',,VSAM// EXTENT ,catlvol// DLBL MACFILE,'your.easytrieve.vsam.macro.library',0,VSAM// EXTENT ,macfvol// DLBL OUTDATA,'macro.punch.file',0,SD// EXTENT ,puncvol,1,0,start,length// DLBL EZTPLIB,'your.easytrieve.library',0,SD// EXTENT ,eztpvol// LIBDEF PHASE,SEARCH=EZTPLIB.sublib,TEMP// EXEC EZTPMNT,SIZE=512K insert macro maintenance command here

/*/&* $$ EOJ

The �Macro Libraries� appendix contains the definitions of theVSAM macro maintenance statements which are valid for theEZTPMNT maintenance program.

Step 8: Verify Installation of CA-Easytrieve Plus

Installing VSE 33



INSJOB9: Install Sample Files

Install Job 9 can be used to verify the installation of yourCA-Easytrieve Plus base product. The first step of this job createsa sample file. Step 2 reads this sample file and creates apersonnel payroll file and an inventory file. Step 3 reads thepersonnel payroll file and produces a report.

Submit this job for execution after providing values for the JCLparameters. This job should complete with a return code of 0.

The following page contains a copy of the report produced bythe verification job.

The personnel payroll and inventory files produced by this jobcan be used by other examples shown throughout theCA-Easytrieve Plus guides. A layout of the two files can befound in the CA-Easytrieve Plus product library as membersPERSNL.Z and INVMSTR.Z.

Note: For verification of each option, see examples in thespecific CA-Easytrieve Plus �Options� guide.




EMPLOYEENUMBER NAME

12267 WIMN GLORIA11473 BERG NANCY02688 CORNING GEORGE00370 NAGLE MARY01963 ARNOLD LINDA11602 MANHART VIRGINIA11931 TALL ELAINE02200 BRANDOW LYDIA11357 LARSON RODNEY11467 BYER JULIE11376 HUSS PATTI11710 POWELL CAROL04234 MCMAHON BARBARA03416 FORREST BILL00445 POST JEAN00577 PETRIK KATHY01895 VETTER DENISE03571 KRUSE MAX04225 LOYAL NED02765 DENNING RALPH04132 WEST KATHY01743 THOMPSON JANICE01730 SMOTH CINDY03936 NORIDGE DEBBIE01549 ROGERS PAT12829 GREEN BRENDA12403 KELLY KEITH12641 ISAAC RUTH03890 STRIDE ANN12318 MALLOW TERRY09609 LACH LORRIE07781 EPERT LINDA09481 OSMON SAMUEL07231 GRECO LESLIE08262 CROCI JUDY05805 REYNOLDSWILLIAM05807 PHILPS SUE04589 YOUNG JANE05914 MILLER JOAN05525 TALUS RUTH06239 JOHNSON LISA05482 WARD MARINA04935 ZOLTAN JANET10949 JONES ALFRED09764 HAFER ARTHUR10260 JUDAR PAULA11211 WALTERS KAREN10961 RYAN PAMELA

VSE Installation JCL

Installing VSE 35



Member INSJOB1.Z

..$$ JOB JNM=INSJOB1 /* <==== */// JOB INSTEZT* * ** * * INSTALL CA-EASYTRIEVE Plus 6.3 AND ITS OPTIONS* * *// OPTION NODUMP,LOGNOLOG START OF SETPARM'S// SETPARM EZTPLIB='@EZTPLIB' /* <==== */// SETPARM EZTPSUB='@EZTPSUB' /* <==== */// SETPARM EZTPVOL='@EZTPVOL' /* <==== */// SETPARM TAPECUU='@TAPECUU' /* <==== */// SETPARM RNTMOPT='@RNTMOPT' /* <==== */// SETPARM CMPLOPT='@CMPLOPT' /* <==== */// SETPARM DBCSOPT='@DBCSOPT' /* <==== */// SETPARM DTCMOPT='@DTCMOPT' /* <==== */// SETPARM TOTLOPT='@TOTLOPT' /* <==== */// SETPARM SUPROPT='@SUPROPT' /* <==== */// SETPARM IDMSOPT='@IDMSOPT' /* <==== */// SETPARM IDDRL12='@IDDRL12' /* <==== */// SETPARM IDMSDYN='@IDMSDYN' /* <==== */// SETPARM DLIOPT='@DLIOPT' /* <==== */// SETPARM SQLOPT='@SQLOPT' /* <==== */NOLOG END OF SETPARM'S*// ASSGN SYS001,&TAPECUU** IF RUNTIME OPTION WAS SELECTED* OFFLOAD AND CATALOG THE RUNTIME OPTION*IF RNTMOPT='YES' THENGOTO UNLDRNTMGOTO CHKCMPL/. UNLDRNTM// MTC REW,SYS001// TLBL SYS001,'FILE01',,,,1// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// EXEC CAIIPDSMAINT LIBR COMPLB1.@EZTPSUB /* <==== */MODULE ALLOPSYS COMOPSYS VSEPASSWORD 12345678 (Runtime password)(Runtime password)(Runtime password)(Runtime password) /* <==== */COMPONENT 7FCOMPONENT INCHEND




/*/. UNLDSERV// MTC REW,SYS001// TLBL SYS001,'FILE01',,,,1// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// EXEC CAIIPDSMAINT LIBR COMPLB1.@EZTPSUB /* <==== */MODULE ALLOPSYS COMOPSYS VSEPASSWORD 12345678 (Runtime password)(Runtime password)(Runtime password)(Runtime password) /* <==== */COMPONENT 7F1COMPONENT INCHEND/*** OFFLOAD AND CATALOG RUNTIME SOURCE*// MTC REW,SYS001// TLBL SYS001,'FILE03',,,,3// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// EXEC CAIIPDSMAINT LIBR COMPLB1.@EZTPSUB /* <==== */MODULE ALLOPSYS COMOPSYS VSEPASSWORD 12345678 (Runtime password)(Runtime password)(Runtime password)(Runtime password) /* <==== */COMPONENT 7FCOMPONENT INCHEND/*/. CHKCMPLIF CMPLOPT='YES' THENGOTO UNLDCMPLGOTO CHKDBCS/. UNLDCMPL** OFFLOAD AND CATALOG THE COMPILER OPTION*// MTC REW,SYS001// TLBL SYS001,'FILE01',,,,1// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// EXEC CAIIPDSMAINT LIBR COMPLB1.@EZTPSUB /* <==== */MODULE ALLOPSYS COMOPSYS VSEPASSWORD 12345678 (Compiler password)(Compiler password)(Compiler password)(Compiler password) /* <==== */


Installing VSE 37


COMPONENT U2COMPONENT INCHEND/*/. CHKDBCSIF DBCSOPT='YES' THENGOTO UNLDDBCSGOTO CHKDTCM/. UNLDDBCS** OFFLOAD AND CATALOG THE DBCS OPTION*// MTC REW,SYS001// TLBL SYS001,'FILE01',,,,1// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// EXEC CAIIPDSMAINT LIBR COMPLB1.@EZTPSUB /* <==== */MODULE ALLOPSYS COMOPSYS VSEPASSWORD 12345678 (DBCS password)(DBCS password)(DBCS password)(DBCS password) /* <==== */COMPONENT 5ZCOMPONENT INCHEND/*/. CHKDTCMIF DTCMOPT='YES' THENGOTO UNLDDTCMGOTO CHKSQL/. UNLDDTCM** OFFLOAD AND CATALOG THE DATACOM OPTION*// MTC REW,SYS001// TLBL SYS001,'FILE01',,,,1// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// EXEC CAIIPDSMAINT LIBR COMPLB1.@EZTPSUB /* <==== */MODULE ALLOPSYS COMOPSYS VSEPASSWORD 12345678 (Datacom password)(Datacom password)(Datacom password)(Datacom password) /* <==== */COMPONENT 7ZCOMPONENT INCHEND/*** OFFLOAD AND CATALOG DATACOM MACROS*// MTC REW,SYS001// TLBL SYS001,'FILE03',,,,3




// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// EXEC CAIIPDSMAINT LIBR COMPLB1.@EZTPSUB /* <==== */MODULE ALLOPSYS COMOPSYS VSEPASSWORD 12345678 (Datacom password)(Datacom password)(Datacom password)(Datacom password) /* <==== */COMPONENT 7ZCOMPONENT INCHEND/*/. CHKSQLIF SQLOPT='YES' THENGOTO UNLDSQLGOTO CHKDLI/. UNLDSQL** OFFLOAD AND CATALOG THE SQL OPTION*// MTC REW,SYS001// TLBL SYS001,'FILE01',,,,1// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// EXEC CAIIPDSMAINT LIBR COMPLB1.@EZTPSUB /* <==== */MODULE ALLOPSYS COMOPSYS VSEPASSWORD 12345678 (SQL password)(SQL password)(SQL password)(SQL password) /* <==== */COMPONENT 8ECOMPONENT INCHEND/*/. CHKDLIIF DLIOPT='YES' THENGOTO UNLDDLIGOTO CHKIDMS/. UNLDDLI** OFFLOAD AND CATALOG THE DLI OPTION*// MTC REW,SYS001// TLBL SYS001,'FILE01',,,,1// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// EXEC CAIIPDSMAINT LIBR COMPLB1.@EZTPSUB /* <==== */MODULE ALLOPSYS COMOPSYS VSE


Installing VSE 39


PASSWORD 12345678 (DLI password)(DLI password)(DLI password)(DLI password) /* <==== */COMPONENT ETCOMPONENT INCHEND/** ** * CATALOG EZT DLI LINK CONTROL CARDS FOR A00* *// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// EXEC LIBR,PARM='MSHP;AC S=COMPLB1.&EZTPSUB' CATALOG LNKA00.OBJ REPLACE=YES PHASE EZTPA00,+0 INCLUDE EZTPA00 INCLUDE DQSZTC INCLUDE DQSZTX INCLUDE DLZLI000 ENTRY A000DOS/+/*/. CHKIDMSIF IDMSOPT='YES' THENGOTO UNLDIDMSGOTO CHKTOTL/. UNLDIDMS** OFFLOAD AND CATALOG THE IDMS OPTION*// MTC REW,SYS001// TLBL SYS001,'FILE01',,,,1// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// EXEC CAIIPDS

MAINT LIBR COMPLB1.@EZTPSUB /* <==== */MODULE ALLOPSYS COMOPSYS VSEPASSWORD 12345678 (IDMS password)(IDMS password)(IDMS password)(IDMS password) /* <==== */COMPONENT 7TCOMPONENT INCHEND/*IF IDDRL12='NO' THENGOTO UNLDID10GOTO UNLDID12/. UNLDID10** OFFLOAD AND CATALOG THE IDMS IDD REL10 MODULES** * MTC FSF,SYS001,5// MTC REW,SYS001// TLBL SYS001,'FILE01',,,,1// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL




// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// EXEC CAIIPDSMAINT LIBR COMPLB1.@EZTPSUB /* <==== */MODULE ALLOPSYS COMOPSYS VSEPASSWORD 12345678 (IDMS password)(IDMS password)(IDMS password)(IDMS password) /* <==== */COMPONENT 7T1COMPONENT INCHEND/*GOTO CHKTOTL/. UNLDID12** OFFLOAD AND CATALOG THE IDMS IDD REL12 MODULES*// MTC REW,SYS001// TLBL SYS001,'FILE02',,,,2// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// EXEC CAIIPDSMAINT LIBR COMPLB1.@EZTPSUB /* <==== */MODULE ALLOPSYS COMOPSYS VSEPASSWORD 12345678 (IDMS password)(IDMS password)(IDMS password)(IDMS password) /* <==== */COMPONENT 7T2COMPONENT INCHEND/*/. CHKTOTLIF TOTLOPT='YES' THENGOTO UNLDTOTLGOTO CHKSUPR/. UNLDTOTL** OFFLOAD AND CATALOG THE TOTAL MACROS*// MTC REW,SYS001// TLBL SYS001,'FILE03',,,,3// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// EXEC CAIIPDSMAINT LIBR COMPLB1.@EZTPSUB /* <==== */MODULE ALLOPSYS COMOPSYS VSEPASSWORD 12345678 (TOTAL password)(TOTAL password)(TOTAL password)(TOTAL password) /* <==== */COMPONENT 8TCOMPONENT INCHEND/*


Installing VSE 41


/. CHKSUPRIF SUPROPT='YES' THENGOTO UNLDSPRAGOTO CHKOPTNS/. UNLDSPRA** OFFLOAD AND CATALOG THE SUPRA MACROS*// MTC REW,SYS001// TLBL SYS001,'FILE03',,,,3// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// EXEC CAIIPDSMAINT LIBR COMPLB1.@EZTPSUB /* <==== */MODULE ALLOPSYS COMOPSYS VSEPASSWORD 12345678 (SUPRA password)(SUPRA password)(SUPRA password)(SUPRA password) /* <==== */COMPONENT 9ZCOMPONENT INCHEND/*/. CHKOPTNSIF IDMSOPT='NO' THENGOTO RENAME* ** * IF THE IDMS OPTION IS BEING INSTALLED* * IF DYNAMIC LOAD OF IDMS IS NOT SELECTED* * IF THE DLI OPTION IS BEING INSTALLLED* * THEN COPY 'LINK EDIT EZTPA00 WITH IDMS AND DLI'* * ELSE* * THEN COPY 'LINK EDIT EZTPA00 WITH IDMS'* *IF IDMSDYN='YES' THENGOTO RENAMEIF DLIOPT='YES' THENGOTO LKDLIDMGOTO LKIDMS/. LKDLIDM* ** * CATALOG 'LINK EZTPA00 WITH IDMS AND DLI'* *// EXEC LIBR,PARM='MSHP;AC S=COMPLB1.&EZTPSUB' CATALOG LNKA00.OBJ REPLACE=YES PHASE EZTPA00,+0 INCLUDE EZTPA00 INCLUDE DQSZTC INCLUDE DQSZTX INCLUDE DLZLI000 INCLUDE IDMSIDVS INCLUDE IDMSCANC INCLUDE IDMSOPTI ENTRY A000DOS/+/*




GOTO RENAME/. LKIDMS** CATALOG 'LINK EZTPA00 WITH IDMS'*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// EXEC LIBR,PARM='MSHP;AC S=COMPLB1.&EZTPSUB' CATALOG LNKA00.OBJ REPLACE=YES PHASE EZTPA00,+0 INCLUDE EZTPA00 INCLUDE DQSZTC INCLUDE DQSZTX INCLUDE IDMSIDVS INCLUDE IDMSCANC INCLUDE IDMSOPTI ENTRY A000DOS/+/*/. RENAME** RENAME MACROS FROM TYPE A TO TYPE Z*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// EXEC LIBR,PARM='MSHP;AC S=COMPLB1.&EZTPSUB' ACCESS S=COMPLB1.@EZTPSUB /* <==== */ RENAME *.A:*.Z RENAME OPTENV.Z:OPTENV.A RENAME OPTTBL.Z:OPTTBL.A/*/. END/*/&..$$ EOJ /* <==== */


Installing VSE 43


Member INSJOB2.Z

..$$ JOB JNM=INSJOB2 /* <==== */// JOB LINKEZT* ** * LINK EDIT CA-EASYTRIEVE Plus COMPONENTS* *// OPTION NODUMP,LOGNOLOG START OF SETPARM'S// SETPARM EZTPLIB='@EZTPLIB' /* <==== */// SETPARM EZTPSUB='@EZTPSUB' /* <==== */// SETPARM EZTPVOL='@EZTPVOL' /* <==== */// SETPARM RNTMOPT='@RNTMOPT' /* <==== */// SETPARM CMPLOPT='@CMPLOPT' /* <==== */// SETPARM DBCSOPT='@DBCSOPT' /* <==== */// SETPARM DTCMOPT='@DTCMOPT' /* <==== */// SETPARM TOTLOPT='@TOTLOPT' /* <==== */// SETPARM SUPROPT='@SUPROPT' /* <==== */// SETPARM IDMSOPT='@IDMSOPT' /* <==== */// SETPARM IDDRL12='@IDDRL12' /* <==== */// SETPARM DLIOPT='@DLIOPT' /* <==== */// SETPARM SQLOPT='@SQLOPT' /* <==== */// SETPARM DLILIB='@DLILIB' /* <==== */// SETPARM DLISUB='@DLISUB' /* <==== */// SETPARM DLIVOL='@DLIVOL' /* <==== */// SETPARM TOTLLIB='@TOTLLIB' /* <==== */// SETPARM TOTLSUB='@TOTLSUB' /* <==== */// SETPARM TOTLVOL='@TOTLVOL' /* <==== */// SETPARM SPRALIB='@SUPRLIB' /* <==== */// SETPARM SPRASUB='@SUPRSUB' /* <==== */// SETPARM SPRAVOL='@SUPRVOL' /* <==== */// SETPARM IDMSLIB='@IDMSLIB' /* <==== */// SETPARM IDMSSUB='@IDMSSUB' /* <==== */// SETPARM IDMSVOL='@IDMSVOL' /* <==== */// SETPARM LINKDAT='@LINKDAT' /* <==== */// SETPARM LINKVOL='@LINKVOL' /* <==== */// SETPARM LINKSTR='@LINKSTR' /* <==== */// SETPARM LINK#TR='@LINK#TR' /* <==== */// SETPARM LESCEE='@LESCEE' /* <==== */// SETPARM SCEESUB='@SCEESUB' /* <==== */// SETPARM SCEEVOL='@SCEEVOL' /* <==== */NOLOG END OF SETPARM'S*IF RNTMOPT='YES' THENGOTO LINKRNTMGOTO CHKCMPL/. LINKRNTM** LINK EDIT THE RUNTIME OPTION*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IJSYSPH,'&LINKDAT',0,SD// EXTENT SYSPCH,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSPCH,DISK,VOL=@LINKVOL,SHR /* <==== */




// EXEC LIBR ACCESS S=COMPLB1.@EZTPSUB /* <==== */ PUNCH LINKRNTM.Z FORMAT=NOHEADER/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL LESCEE,'&LESCEE'// EXTENT ,SCEEVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB,LESCEE.&SCEESUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// DLBL IJSYSIN,'&LINKDAT',0,SD// EXTENT SYSIN,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSIN,SYSPCH/*CLOSE SYSPCH,cuu /* <==== *//*/. LINKSRVR** LINK EDIT THE RUNTIME HOST SERVER*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IJSYSPH,'&LINKDAT',0,SD// EXTENT SYSPCH,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSPCH,DISK,VOL=@LINKVOL,SHR /* <==== */// EXEC LIBR ACCESS S=COMPLB1.@EZTPSUB /* <==== */ PUNCH LINKSRVR.Z FORMAT=NOHEADER/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// DLBL IJSYSIN,'&LINKDAT',0,SD// EXTENT SYSIN,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSIN,SYSPCH/*CLOSE SYSPCH,cuu /* <==== *//*/. CHKCMPLIF CMPLOPT='YES' THENGOTO LINKCMPLGOTO CHKDBCS/. LINKCMPL** LINK EDIT THE COMPILE OPTION*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IJSYSPH,'&LINKDAT',0,SD// EXTENT SYSPCH,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSPCH,DISK,VOL=@LINKVOL,SHR /* <==== */// EXEC LIBR ACCESS S=COMPLB1.@EZTPSUB /* <==== */ PUNCH LINKCMPL.Z FORMAT=NOHEADER/*// DLBL COMPLB1,'&EZTPLIB'


Installing VSE 45


// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// DLBL IJSYSIN,'&LINKDAT',0,SD// EXTENT SYSIN,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSIN,SYSPCH/*CLOSE SYSPCH,cuu /* <==== *//*/. CHKDBCSIF DBCSOPT='YES' THENGOTO LINKDBCSGOTO CHKDTCM/. LINKDBCS** LINK EDIT THE DBCS OPTION*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IJSYSPH,'&LINKDAT',0,SD// EXTENT SYSPCH,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSPCH,DISK,VOL=@LINKVOL,SHR /* <==== */// EXEC LIBR ACCESS S=COMPLB1.@EZTPSUB /* <==== */ PUNCH LINKDBCS.Z FORMAT=NOHEADER/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// DLBL IJSYSIN,'&LINKDAT',0,SD// EXTENT SYSIN,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSIN,SYSPCH/*CLOSE SYSPCH,cuu /* <==== *//*/. CHKDTCMIF DTCMOPT='YES' THENGOTO LINKDTCMGOTO CHKDLI/. LINKDTCM** LINK EDIT THE DATACOM OPTION*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IJSYSPH,'&LINKDAT',0,SD// EXTENT SYSPCH,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSPCH,DISK,VOL=@LINKVOL,SHR /* <==== */// EXEC LIBR ACCESS S=COMPLB1.@EZTPSUB /* <==== */ PUNCH LINKDTCM.Z FORMAT=NOHEADER/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB




// DLBL IJSYSIN,'&LINKDAT',0,SD// EXTENT SYSIN,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSIN,SYSPCH/*CLOSE SYSPCH,cuu /* <==== *//*/. CHKDLIIF DLIOPT='YES' THENGOTO LINKDLIGOTO CHKIDMS/. LINKDLI** LINK EDIT THE DLI OPTION*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IJSYSPH,'&LINKDAT',0,SD// EXTENT SYSPCH,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSPCH,DISK,VOL=@LINKVOL,SHR /* <==== */// EXEC LIBR ACCESS S=COMPLB1.@EZTPSUB /* <==== */ PUNCH LINKDLI.Z,FORMAT=NOHEADER/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// DLBL IJSYSIN,'&LINKDAT',0,SD// EXTENT SYSIN,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSIN,SYSPCH/*CLOSE SYSPCH,cuu /* <==== *//*/. CHKIDMSIF IDMSOPT='YES' THENGOTO LINKIDMSGOTO CHKSQL/. LINKIDMS** LINK EDIT THE IDMS OPTION*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IJSYSPH,'&LINKDAT',0,SD// EXTENT SYSPCH,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSPCH,DISK,VOL=@LINKVOL,SHR /* <==== */// EXEC LIBR ACCESS S=COMPLB1.@EZTPSUB /* <==== */ PUNCH LINKIDMS.Z FORMAT=NOHEADER/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IDMSLIB,�&IDMSLIB�// EXTENT ,&IDMSVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB,IDMSLIB.&IDMSSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// DLBL IJSYSIN,'&LINKDAT',0,SD


Installing VSE 47


// EXTENT SYSIN,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSIN,SYSPCH/*CLOSE SYSPCH,cuu /* <==== *//*IF IDDRL12='YES' THENGOTO LINKID12GOTO LINKID10/. LINKID12** LINK EDIT THE IDMS IDD FOR REL 12 OR GREATER*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IJSYSPH,'&LINKDAT',0,SD// EXTENT SYSPCH,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSPCH,DISK,VOL=@LINKVOL,SHR /* <==== */// EXEC LIBR ACCESS S=COMPLB1.@EZTPSUB /* <==== */ PUNCH LINKIDD2.Z FORMAT=NOHEADER/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// DLBL IJSYSIN,'&LINKDAT',0,SD// EXTENT SYSIN,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSIN,SYSPCH/*CLOSE SYSPCH,cuu /* <==== *//*GOTO CHKSQL/. LINKID10** LINK EDIT THE IDMS IDD FOR REL 10 OR LOWER*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IJSYSPH,'&LINKDAT',0,SD// EXTENT SYSPCH,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSPCH,DISK,VOL=@LINKVOL,SHR /* <==== */// EXEC LIBR ACCESS S=COMPLB1.@EZTPSUB /* <==== */ PUNCH LINKIDD0.Z FORMAT=NOHEADER/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// DLBL IJSYSIN,'&LINKDAT',0,SD// EXTENT SYSIN,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSIN,SYSPCH/*CLOSE SYSPCH,cuu /* <==== *//*/. CHKSQLIF SQLOPT='YES' THEN




GOTO LINKSQLGOTO CHKTOTL/. LINKSQL** LINK EDIT THE SQL OPTION*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IJSYSPH,'&LINKDAT',0,SD// EXTENT SYSPCH,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSPCH,DISK,VOL=@LINKVOL,SHR /* <==== */// EXEC LIBR ACCESS S=COMPLB1.@EZTPSUB /* <==== */ PUNCH LINKSQL.Z FORMAT=NOHEADER/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// DLBL IJSYSIN,'&LINKDAT',0,SD// EXTENT SYSIN,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSIN,SYSPCH/*CLOSE SYSPCH,cuu /* <==== *//*/. CHKTOTLIF TOTLOPT='YES' THENGOTO LINKTOTLGOTO LINKA00/. LINKTOTL** LINK EDIT TOTAL MODULE DATBAS AS EZTPDBAS*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IJSYSPH,'&LINKDAT',0,SD// EXTENT SYSPCH,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSPCH,DISK,VOL=@LINKVOL,SHR /* <==== */// EXEC LIBR ACCESS S=COMPLB1.@EZTPSUB /* <==== */ PUNCH LINKTOTL.Z FORMAT=NOHEADER/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL TOTLLIB,'&TOTLLIB'// EXTENT ,&TOTLVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB,TOTLLIB.&TOTLSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// DLBL IJSYSIN,'&LINKDAT',0,SD// EXTENT SYSIN,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSIN,SYSPCH/*CLOSE SYSPCH,cuu /* <==== *//*/. CHKSUPRIF SUPROPT='YES' THENGOTO LINKSUPR


Installing VSE 49


GOTO LINKA00/. LINKSUPR** LINK EDIT SUPRA MODULE CSVJLUV AS EZTPSLUV*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IJSYSPH,'&LINKDAT',0,SD// EXTENT SYSPCH,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSPCH,DISK,VOL=@LINKVOL,SHR /* <==== */// EXEC LIBR ACCESS S=COMPLB1.@EZTPSUB /* <==== */ PUNCH LINKSUPR.Z FORMAT=NOHEADER/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL SUPRLIB,'&SUPRLIB'// EXTENT ,&SUPRVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB,SUPRLIB.&SUPRSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// DLBL IJSYSIN,'&LINKDAT',0,SD// EXTENT SYSIN,&LINKVOL,1,0,&LINKSTR,&LINK#TRASSGN SYSIN,SYSPCH/*CLOSE SYSPCH,cuu /* <==== *//*/. LINKA00IF DLIOPT='YES' AND IDMSOPT='YES' THENGOTO LKA0DLIDGOTO A0DLI/. LKA0DLID** LINK EDIT EZTPA00 FOR DLI AND IDMS*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL DLILIB,'&DLILIB'// EXTENT ,&DLIVOL// DLBL IDMSLIB,'&IDMSLIB'// EXTENT ,&IDMSVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB,DLILIB.&DLISUB,IDMSLIB.&IDMSSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// OPTION LOG,CATAL INCLUDE LNKA00/*GOTO END// EXEC LNKEDT/*/. A0DLIIF DLIOPT='YES' AND IDMSOPT='NO' THENGOTO LKA0DLIGOTO A0IDMS/. LKA0DLI** LINK EDIT EZTPA00 FOR DLI*// DLBL COMPLB1,'&EZTPLIB'




// EXTENT ,&EZTPVOL// DLBL DLILIB,'&DLILIB'// EXTENT ,&DLIVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB,DLILIB.&DLISUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// OPTION LOG,CATAL INCLUDE LNKA00/*// EXEC LNKEDT/*GOTO END/. A0IDMSIF IDMSOPT='YES' AND DLIOPT='NO' THENGOTO LKA0IDMGOTO END/. LKA0IDM** LINK EDIT EZTPA00 FOR IDMS*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IDMSLIB,'&IDMSLIB'// EXTENT ,&IDMSVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB,IDMSLIB.&IDMSSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// OPTION LOG,CATAL INCLUDE LNKA00/*// EXEC LNKEDT/*/. END/*/&..$$ EOJ /* <==== */


Installing VSE 51


Member INSJOB3A.Z

..$$ JOB JNM=INSJOB3A /* <==== */// JOB EZTPOPT* ** * CUSTOMIZE CA-EASYTRIEVE Plus OPTIONS TABLE* *// OPTION NODUMP,LOGNOLOG START OF SETPARM'S// SETPARM EZTPLIB='@EZTPLIB' /* <==== */// SETPARM EZTPSUB='@EZTPSUB' /* <==== */// SETPARM EZTPVOL='@EZTPVOL' /* <==== */NOLOG END OF SETPARM'S*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// OPTION CATAL,NODECK,LOG PHASE EZTPOPT,+0// EXEC ASSEMBLY,SIZE=128K

COPY OPTENVCOPY OPTTBLOPTTBL COMPNME='your.company.name', /* <==== */ X MACRO=SSL, /* <==== */ X MACDDN=MACDD, /* <==== */ X UPDTVS=NOEND /* <==== */

/*// EXEC LNKEDT/*/&..$$ EOJ /* <==== */




Member INSJOB3B.Z

..$$ JOB JNM=INSJOB3B /* <==== */// JOB EZTPX05A* * ** * * REGENERATE OPTIONS* * *// OPTION DUMP,LOGNOLOG START OF SETPARM'S// SETPARM EZTPLIB='@EZTPLIB' /* <==== */// SETPARM EZTPSUB='@EZTPSUB' /* <==== */// SETPARM EZTPVOL='@EZTPVOL' /* <==== */// SETPARM OPTOUT ='@OPTOUT' /* <==== */// SETPARM OPTVOL ='@OPTVOL' /* <==== */// SETPARM OPTSTR ='@OPTSTR' /* <==== */// SETPARM OPT#TR ='@OPT#TR' /* <==== */// SETPARM VFMVOL ='@VFMOUT' /* <==== */// SETPARM VFMSTR ='@VFMSTR' /* <==== */// SETPARM VFM#TR ='@VFM#TR' /* <==== */NOLOG END OF SETPARM'S/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL OPT,'&OPTOUT',0,SD// EXTENT SYS001,&OPTVOL,1,0,&OPTSTR,&OPT#TR// ASSGN SYS001,DISK,VOL=&OPTVOL,SHR// DLBL EZTVFM,,0,SD// EXTENT SYS010,&VFMVOL,1,0,&VFMSTR,&VFM#TR// ASSGN SYS010,DISK,VOL=&VFMVOL,SHR// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// EXEC EZTPA00,SIZE=512K** EXAMPLE** DO NOT USE A PARM STATEMENT!FILE OPT FB (80 6160)OUTREC_ 1 80 ARECORD_ W 80 A OCCURS 200 INDEX INDEX_ENDREC_ W 80 AEND_ ENDREC_ +10 3 A VALUE('END')COUNTER_ W 5 P


Installing VSE 53


JOB INPUT NULL NAME X050 INDEX_ = 0 CALL EZTPX05 USING(RECORD_) COUNTER_ = 0 DO WHILE COUNTER_ < 200 INDEX_ = COUNTER_ * 80 OUTREC_ = RECORD_ PUT OPT DISPLAY OUTREC_ IF OUTREC_ = ENDREC_

COUNTER_ = 200 END-IF COUNTER_ = COUNTER_ + 1 END-DO STOP/*/&..$$ EOJ /* <==== */




Member INSJOB4.Z

..$$ JOB JNM=INSJOB4 /* <==== */// JOB EZTPXRPT* ** * CUSTOMIZE EXTENDED REPORTING OPTIONS MODULE* *// OPTION NODUMP,LOGNOLOG START OF SETPARM'S// SETPARM EZTPLIB='@EZTPLIB' /* <==== */// SETPARM EZTPSUB='@EZTPSUB' /* <==== */// SETPARM EZTPVOL='@EZTPVOL' /* <==== */// SETPARM XRPTOUT='@XRPTOUT' /* <==== */// SETPARM XRPTVOL='@XRPTVOL' /* <==== */// SETPARM XRPTSTR='@XRPTSTR' /* <==== */// SETPARM XRPT#TR='@XRPT#TR' /* <==== */NOLOG END OF SETPARM'S*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IJSYSPH,'&XRPTOUT',0,SD// EXTENT SYSPCH,&XRPTVOL,1,0,&XRPTSTR,&XRPT#TRASSGN SYSPCH,DISK,VOL=@XRPTVOL,SHR /* <==== */// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// OPTION NODECK,LOG// EXEC EZTPX04,SIZE=900K insert extended reporting commands here /* <==== *//*CLOSE SYSPCH,cuu /* <==== *//*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IJSYSIN,'&XRPTOUT',0,SD// EXTENT SYSIPT,&XRPTVOL,1,0,&XRPTSTR,&XRPT#TRASSGN SYSIPT,DISK,VOL=@XRPTVOL,SHR /* <==== */// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// OPTION CATAL ACTION NOAUTO PHASE EZTPXRPT,+0 INCLUDE// EXEC LNKEDT,SIZE=128K/*CLOSE SYSIPT,cuu /* <==== *//*/&..$$ EOJ


Installing VSE 55


Member INSJOB5.Z

00000010 00000020 00000040

..$$ JOB JNM=INSJOB5 /* <==== */// JOB INSTSUPR* * ** * * CUSTOMIZE SUPRA DRIVER FOR CA-EASYTRIEVE Plus* * *// OPTION DUMP,LOGNOLOG START OF SETPARM'S// SETPARM EZTPLIB='@EZTPLIB' /* <==== */// SETPARM EZTPSUB='@EZTPSUB' /* <==== */// SETPARM EZTPVOL='@EZTPVOL' /* <==== */// SETPARM VFMVOL='@VFMVOL' /* <==== */// SETPARM VFMSTR='@VFMSTR' /* <==== */// SETPARM VFM#TR='@VFM#TR' /* <==== */NOLOG END OF SETPARM'S/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL EZTVFM,,0,SD// EXTENT SYS010,&VFMVOL,1,0,&VFMSTR,&VFM#TR// ASSGN SYS010,DISK,VOL=&VFMVOL,SHR// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// OPTION CATAL,NODECK,LOG// EXEC EZTPA00,SIZE=512KPARM LINK (EZTPSPRA R)%EZTPSPRA.Z SCHEMA schema-name + /* <==== */

OVERRIDE yes|no + /* <==== */ FIELDS maxfields + /* <==== */ OPEN yes|no + /* <==== */ SCAN start-column THRU end-column /* <==== */

END/*// EXEC LNKEDT/*/&..$$ EOJ /* <==== */




Member INSJOB6.Z

..$$ JOB JNM=INSJOB6 /* <==== */// JOB EZTPURT* ** * INSTALL DATACOM USER REQUIREMENTS TABLE FOR CA-EASYTRIEVE Plus* *// OPTION NODUMP,LOGNOLOG START OF SETPARM'S// SETPARM EZTPLIB='@EZTPLIB' /* <==== */// SETPARM EZTPSUB='@EZTPSUB' /* <==== */// SETPARM EZTPVOL='@EZTPVOL' /* <==== */// SETPARM DTCMLIB='@DTCMLIB' /* <==== */// SETPARM DTCMSUB='@DTCMSUB' /* <==== */// SETPARM DTCMVOL='@DTCMVOL' /* <==== */// SETPARM URTLIB='@URTLIB' /* <==== */// SETPARM URTLSUB='@URTLSUB' /* <==== */// SETPARM URTLVOL='@URTLVOL' /* <==== */NOLOG END OF SETPARM'S*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL DTCMLIB,'&DTCMLIB'// EXTENT ,&DTCMVOL// DLBL URTLIB,'&URTLIB'// EXTENT ,&URTLVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB,DTCMLIB.&DTCMSUB)// LIBDEF *,CATALOG=URTLIB.&URTLSUB,TEMP// OPTION LOG,CATAL PHASE urtname,* /* <==== */ INCLUDE EZTPDRVR// EXEC ASSEMBLY

DBURINF URTABLE=ASM, X OPEN=USER, X BACKSPT=NO, X COBOL=NODBURSTR ABEND=NO, X MSTNAM=DBTTLST, X MULTUSE=YESDBURTBL ACCESS=RANSEQ, X DBID=1, X SEQBUFS=2, X TBLNAM=name, /* <==== */ X UPDATE=yes|no /* <==== */DBUREND SYSTEM=DOS, X USRINFO=provide any information /* <==== */END

/* ENTRY DRVR// EXEC LNKEDT/*/&..$$ EOJ /* <==== */


Installing VSE 57


Member INSJOB7.Z

00000010 00000020 00000040

..$$ JOB JNM=INSJOB7 /* <==== */// JOB EZTPDBCS* ** * CUSTOMIZE DBCS OPTIONS FOR CA-EASYTRIEVE Plus* *// OPTION NODUMP,LOGNOLOG START OF SETPARM'S// SETPARM EZTPLIB='@EZTPLIB' /* <==== */// SETPARM EZTPSUB='@EZTPSUB' /* <==== */// SETPARM EZTPVOL='@EZTPVOL' /* <==== */// SETPARM DBCSOUT='@DBCSOUT' /* <==== */// SETPARM DBCSVOL='@DBCSVOL' /* <==== */// SETPARM DBCSSTR='@DBCSSTR' /* <==== */// SETPARM DBCS#TR='@DBCS#TR' /* <==== */NOLOG END OF SETPARM'S*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IJSYSPH,'&DBCSOUT',0,SD// EXTENT SYSPCH,&DBCSVOL,1,0,&DBCSSTR,&DBCS#TRASSGN SYSPCH,DISK,VOL=@DBCSVOL,SHR /* <==== */// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// OPTION NODECK,LOG// EXEC EZTPX03,SIZE=900K insert dbcs commands here /* <==== *//*CLOSE SYSPCH,cuu /* <==== *//*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL IJSYSIN,'&DBCSOUT',0,SD// EXTENT SYSIPT,&DBCSVOL,1,0,&DBCSSTR,&DBCS#TRASSGN SYSIPT,DISK,VOL=@DBCSVOL,SHR /* <==== */// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB,TEMP// OPTION CATAL ACTION NOAUTO PHASE EZTPDBCS,+0 INCLUDE// EXEC LNKEDT,SIZE=128K/*CLOSE SYSIPT,cuu /* <==== *//*/&..$$ EOJ /* <==== */




Member INSJOB8A.Z

00000010 00000020 00000040

..$$ JOB JNM=INSJOB8A /* <==== */// JOB MACADD* * ** * * INSTALL CA-EASYTRIEVE PROGRAM MACADD* * *// OPTION DUMP,LOGNOLOG START OF SETPARM'S// SETPARM EZTPLIB='@EZTPLIB' /* <==== */// SETPARM EZTPSUB='@EZTPSUB' /* <==== */// SETPARM EZTPVOL='@EZTPVOL' /* <==== */NOLOG END OF SETPARM'S/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// OPTION CATAL,NODECK,LOG// EXEC EZTPA00,SIZE=350KPARM LINK(MACADD R)********************************************************************* THIS PROGRAM IS USED TO INITIALLY LOAD THE 'MAINTDATE' ** RECORD ONTO THE VSAM MACRO LIBRARY, AT THAT POINT ANY MAINTENANCE** CAN BE DONE AGAINST THE LIBRARY: 'MAINTDATE' HOLDS THE LAST ** MAINTENANCE DATE FOR USE IN THE DIRECTORY LISTING *********************************************************************FILE MACFILE VS CREATE WORKAREA 110 MACRO-KEY 1 30 A MACRO-NAME 1 21 A MACRO-SEQ 22 9 N MACRO-DATA 31 80 A LW-VAL W 9 A VALUE X'000000000000000000'SKIP 3JOB INPUT (NULL) START (START-PROC)STOPSTART-PROC. PROC MOVE 'MAINTDATE' TO MACRO-NAME MOVE LW-VAL TO MACRO-SEQ MOVE SYSDATE TO MACRO-DATA PUT MACFILEEND-PROC/*// EXEC LNKEDT/*/&..$$ EOJ /* <==== */


Installing VSE 59


Member INSJOB8B.Z

..$$ JOB JNM=INSJOB8B /* <==== */// JOB EZTPMNT* * ** * * INSTALL CA-EASYTRIEVE PROGRAM EZTPMNT* * *// OPTION DUMP,LOGNOLOG START OF SETPARM'S// SETPARM EZTPLIB='@EZTPLIB' /* <==== */// SETPARM EZTPSUB='@EZTPSUB' /* <==== */// SETPARM EZTPVOL='@EZTPVOL' /* <==== */NOLOG END OF SETPARM'S/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// LIBDEF *,CATALOG=COMPLB1.&EZTPSUB// OPTION CATAL,NODECK,LOG// EXEC EZTPA00,SIZE=350KPARM LINK(EZTPMNT R)*********************************************************************** THIS PROGRAM PERFORMS THE MAINTENANCE FUNCTIONS TO THE VSAM MACRO* LIBRARY.**********************************************************************FILE MACFILE VS UPDATE WORKAREA 110 MACRO-KEY 1 30 A MACRO-NAME 1 21 A MACRO-SEQ 22 9 N MACRO-DATA 31 80 A MACRO-DATE MACRO-DATA 8 A. *LAST MAINT DATE IS AT THE BIGINNING

*OF THE MACRO DATA FOR THE 'MAINTDATE'*RECORD ON THE MACRO FILE

**** KEY WORK AREA **** WORK-KEY W 30 A WORK-MACRO-NAME WORK-KEY 21 A WORK-SEQ WORK-KEY +21 9 A HEADING 'MACRO-SEQ'*********************** WORK-DATE W 8 A. *LAST MAINT DATE FROM 'MAINTDATE'

*RECORD ON MACRO FILE**** WORK-COMMAND W 10 A LW-VAL W 9 A VALUE X'000000000000000000' HGH-VAL W 9 A VALUE X'FFFFFFFFFFFFFFFFFF' ADD-CNT W 4 P 0 MAINT-DATE-UPDATED W 1 A VALUE 'N'. *INDICATOR FOR 'MAINTDATE'

*RECORD UPDATED DURING JOB NAME-LENGTH W 2 P 0. *NUMBER OF CHARS IN THE MACRO NAME WORK-NAME-HOLD W 21 A. *HOLD AREA FOR MACRO NAME, USED IF

*MACRO TO BE ADDED IS AT THE END OF*THE LIBRARY, MUST POINT TO BEGINNING

SKIP 2FILE MACDATA CARD MACDATA-REC 1 80 A COMMAND-DELIMITER 1 2 A




COMMAND-CHAR 3 1 A INDEX NAME-X. *USED TO FIND # OF CMD CHARS COMMAND-CHARS 3 1 A INDEX NAME-Y. *USED TO FIND # OF MAC CHARS COMMAND-NAME 3 1 ASKIP 2FILE OUTDATA F(80) OUTDATA-REC 1 80 A OUTDATA-COMMAND 1 12 A OUTDATA-NAME 13 21 ASKIP 3JOB INPUT (NULL) START (START-PROC)DO WHILE NOT EOF MACDATA WORK-MACRO-NAME = ' ' ******************************* FIND END OF MAINT COMMAND, MUST START IN COL 3 GOES TO 1ST SPACENAME-X = 0DO WHILE COMMAND-CHAR NQ ' ' AND NAME-X LS 54

NAME-X = NAME-X + 1 END-DO ****************************** MOVE COMMAND-NAME NAME-X TO WORK-COMMAND IF WORK-COMMAND = 'UPDATE ' PERFORM DELETE-MACRO PERFORM ADD-MACRO GO TO END-PROCESS END-IF ******************************* IF UPDATE COMMAND USED AND MACRO NOT FOUND, COMMAND WILL PROCESS* LIKE AN ADD COMMAND******************************IF WORK-COMMAND = 'ADD '

PERFORM ADD-MACRO GO TO END-PROCESS END-IF IF WORK-COMMAND = 'DELETE ' PERFORM DELETE-MACRO GO TO END-PROCESS END-IF IF WORK-COMMAND = 'DISPLAY ' 'PUNCH ' 'DSPCH ' PERFORM DISPLAY-MACRO GO TO END-PROCESS END-IF IF WORK-COMMAND = 'DIRECTORY ' PERFORM DIRECTORY GO TO END-PROCESS END-IF DISPLAY '**** COMMAND TYPE NOT IDENTIFIABLE ****' -

+2 MACDATA-REC PERFORM FIND-NEXT-COMMANDSKIP 2END-PROCESS.END-DOSKIP 1DISPLAY '**** MACRO PROCESSING COMPLETED ****'STOPNEWPAGEADD-MACRO. PROC IF WORK-COMMAND NE 'UPDATE '


Installing VSE 61


PERFORM MACRO-NAME-RTN END-IF ***************************** MACRO-NAME-RTN WILL ALREADY BE PERFORMED IN DELETE-MACRO PROC* WHEN AN 'UPDATE' COMMAND IS BEING PROCESSED****************************MOVE LW-VAL TO WORK-SEQPOINT MACFILE GE WORK-KEY STATUSIF EOF MACFILE

MOVE WORK-MACRO-NAME TO WORK-NAME-HOLD MOVE LW-VAL TO WORK-MACRO-NAME FILL X'00' POINT MACFILE GE WORK-KEY GET MACFILE MOVE WORK-NAME-HOLD TO WORK-MACRO-NAME GO TO CONTINUE ***************************** IF EOF ON MACRO LIB, LIB MUST BE REPOSITIONED AT THE BIGINNING* AND A RECORD AVAILABLE BEFORE YOU CAN ADDRESS THE I/O AREA* SINCE 'MAINTDATE' RECORD IS ALWAYS AVAILABLE THIS WILL BE FINE* FOR THE FIRST MACRO YOU ADD TO THE LIB****************************END-IFIF FILE-STATUS (MACFILE) NOT ZERO

GO TO CONTINUE END-IF GET MACFILE IF MACRO-NAME = WORK-MACRO-NAME DISPLAY '**** ' WORK-MACRO-NAME +2 'NOT ADDED, +

DUPLICATE EXISTS ****' PERFORM FIND-NEXT-COMMAND GO TO END-ADD-MACRO END-IFCONTINUE. MACRO-NAME = WORK-MACRO-NAME MACRO-SEQ = 0 GET MACDATA ADD-CNT = 0 IF EOF MACDATA OR COMMAND-DELIMITER = '++' -

OR COMMAND-DELIMITER = '--' DISPLAY '****' +2 WORK-MACRO-NAME +2 'NOT ADDED, +

NO DATA AVAILABLE ****' GO TO END-ADD-MACRO END-IF DO WHILE NOT EOF MACDATA AND COMMAND-DELIMITER NQ '++' -

AND COMMAND-DELIMITER NQ '--' ADD-CNT = ADD-CNT + 1 MACRO-SEQ = MACRO-SEQ + 100 MACRO-DATA = MACDATA-REC WRITE MACFILE ADD GET MACDATA END-DO DISPLAY '****' +2 ADD-CNT +2 'RECORDS INPUT FOR ' WORK-MACRO-NAME + ' ****' IF MAINT-DATE-UPDATED = 'N' PERFORM UPDATE-MAINT-DATE END-IFEND-ADD-MACRO.




END-PROCNEWPAGEDELETE-MACRO. PROC PERFORM MACRO-NAME-RTN MOVE LW-VAL TO WORK-SEQ POINT MACFILE GE WORK-KEY STATUS IF FILE-STATUS (MACFILE) ZERO AND NOT EOF MACFILE GO TO CHECK-NAME END-IF IF WORK-COMMAND = 'UPDATE ' DISPLAY '**** ' WORK-MACRO-NAME ' NOT FOUND, +

UPDATE CHANGED TO ADD ****' GO TO END-DELETE-MACRO ELSE DISPLAY '**** ' WORK-MACRO-NAME ' NOT DELETED, +

MACRO NOT FOUND ****' PERFORM FIND-NEXT-COMMAND GO TO END-DELETE-MACRO END-IFCHECK-NAME. GET MACFILE STATUS IF MACRO-NAME = WORK-MACRO-NAME GO TO DELETE-RTN END-IF IF WORK-COMMAND = 'UPDATE ' DISPLAY '**** ' WORK-MACRO-NAME ' NOT FOUND, +

UPDATE CHANGED TO ADD ****' GO TO END-DELETE-MACRO ELSE DISPLAY '****' +2 WORK-MACRO-NAME +2 'NOT DELETED, +

MACRO NOT FOUND ****' PERFORM FIND-NEXT-COMMAND GO TO END-DELETE-MACRO END-IFDELETE-RTN. DO WHILE NOT EOF MACFILE AND MACRO-NAME = WORK-MACRO-NAME WRITE MACFILE DELETE GET MACFILE STATUS END-DO DISPLAY '****' +2 WORK-MACRO-NAME +2 'DELETED ****' IF MAINT-DATE-UPDATED = 'N' PERFORM UPDATE-MAINT-DATE END-IF IF WORK-COMMAND NE 'UPDATE ' GET MACDATA END-IFEND-DELETE-MACROEND-PROCNEWPAGEDISPLAY-MACRO. PROC PERFORM MACRO-NAME-RTN MOVE LW-VAL TO WORK-SEQ IF WORK-MACRO-NAME = 'ALLMACROS' MOVE LW-VAL TO WORK-MACRO-NAME FILL X'00' POINT MACFILE GE WORK-KEY GET MACFILE PERFORM DISPLAY-ALLMACS


Installing VSE 63


GET MACDATA GO TO END-DISPLAY-MACRO END-IF POINT MACFILE GE WORK-KEY STATUS IF FILE-STATUS (MACFILE) NOT ZERO OR EOF MACFILE DISPLAY '****' +2 WORK-MACRO-NAME +2 'NOT DISPLAYED/PUNCHED, +

MACRO NOT FOUND ****' PERFORM FIND-NEXT-COMMAND GO TO END-DISPLAY-MACRO END-IF GET MACFILE STATUS IF MACRO-NAME NQ WORK-MACRO-NAME DISPLAY '****' +2 WORK-MACRO-NAME +2 'NOT DISPLAYED/PUNCHED, +

MACRO NOT FOUND ****' PERFORM FIND-NEXT-COMMAND GO TO END-DISPLAY-MACRO END-IF IF WORK-COMMAND = 'PUNCH' 'DSPCH' OUTDATA-REC = ' ' OUTDATA-COMMAND = '++UPDATE' OUTDATA-NAME = WORK-MACRO-NAME PUT OUTDATA END-IF DO WHILE NOT EOF MACFILE AND MACRO-NAME = WORK-MACRO-NAME IF WORK-COMMAND = 'DISPLAY' 'DSPCH' IF MACRO-NAME = 'MAINTDATE'

WORK-SEQ = ' ' END-IF PRINT DISPLAY-RPT END-IF IF WORK-COMMAND = 'PUNCH' 'DSPCH' MOVE MACRO-DATA TO OUTDATA-REC PUT OUTDATA END-IF GET MACFILE STATUS END-DO DISPLAY '**** MACRO DISPLAYED/PUNCHED' +2 WORK-MACRO-NAME +2 '****' GET MACDATAEND-DISPLAY-MACRO.END-PROCSKIP 3DISPLAY-ALLMACS. PROC DO WHILE NOT EOF MACFILE MOVE MACRO-NAME TO WORK-MACRO-NAME IF MACRO-NAME = 'MAINTDATE' WORK-SEQ = ' ' ELSE MOVE MACRO-SEQ TO WORK-SEQ END-IF PRINT DISPLAY-RPT GET MACFILE END-DOEND-PROCNEWPAGEDIRECTORY. PROCMOVE 'MAINTDATE' TO WORK-MACRO-NAMEMOVE LW-VAL TO WORK-SEQ




READ MACFILE KEY WORK-KEY STATUSIF FILE-STATUS (MACFILE) NOT ZERO PERFORM UPDATE-MAINT-DATE WORK-DATE = SYSDATEELSE WORK-DATE = MACRO-DATEEND-IFMOVE SPACES TO WORK-MACRO-NAMEPOINT MACFILE GE WORK-KEY STATUSDO WHILE FILE-STATUS (MACFILE) ZERO AND NOT EOF MACFILE GET MACFILE STATUS PRINT DIRECTORY-RPT MOVE MACRO-NAME TO WORK-MACRO-NAME MOVE HGH-VAL TO WORK-SEQ POINT MACFILE GE WORK-KEY STATUSEND-DOGET MACDATAEND-PROCNEWPAGE********** UTILITY PROCS ***********SKIP 3MACRO-NAME-RTN. PROC ******************************* SEARCH FOR BEGINNING OF THE MACRO NAME IN THE COMMAND*DO WHILE COMMAND-CHAR SPACE

NAME-X = NAME-X + 1 END-DO ******************************* SEARCH FOR THE END OF THE MACRO NAME IN THE COMMAND*NAME-LENGTH = 0NAME-Y = NAME-XDO WHILE COMMAND-CHARS NQ ' ' ','

NAME-LENGTH = NAME-LENGTH + 1 NAME-Y = NAME-Y + 1 END-DO ****************************** MOVE COMMAND-CHAR NAME-LENGTH TO WORK-MACRO-NAMEEND-PROCSKIP 5FIND-NEXT-COMMAND. PROC GET MACDATA DO WHILE NOT EOF MACDATA AND COMMAND-DELIMITER NQ '++' GET MACDATA END-DOEND-PROCSKIP 3UPDATE-MAINT-DATE. PROC MOVE WORK-MACRO-NAME TO WORK-NAME-HOLD MOVE 'MAINTDATE' TO WORK-MACRO-NAME MOVE LW-VAL TO WORK-SEQ READ MACFILE KEY WORK-KEY STATUS MOVE SYSDATE TO MACRO-DATE IF FILE-STATUS (MACFILE) NOT ZERO MACRO-KEY = WORK-KEY WRITE MACFILE ADD


Installing VSE 65


ELSE WRITE MACFILE UPDATE END-IF MOVE WORK-NAME-HOLD TO WORK-MACRO-NAME MAINT-DATE-UPDATED = 'Y'END-PROCSKIP 3START-PROC. PROC GET MACDATA IF EOF MACDATA OR COMMAND-DELIMITER NQ '++' AND -

COMMAND-DELIMITER NQ '--' DISPLAY '**** NO DATA OR NO COMMAND ****' PERFORM FIND-NEXT-COMMAND END-IFEND-PROCNEWPAGEREPORT DIRECTORY-RPT LINESIZE 73 TITLE 'DIRECTORY LISTING OF THE MACRO FILE' TITLE 3 'LAST MAINT DATE:' WORK-DATE HEADING MACRO-NAME ('MACRO' 'NAME') LINE MACRO-NAMETERMINATION. PROC DISPLAY SKIP 1 COL 27 '*********************'END-PROCSKIP 3REPORT DISPLAY-RPT LINESIZE 105 CONTROL FINAL NOPRINT WORK-MACRO-NAME NEWPAGE TITLE 'LISTING OF MACRO FILE MEMBER -' WORK-MACRO-NAME HEADING TALLY ('#' 'OF' 'STATEMENTS') LINE WORK-SEQ MACRO-DATA TALLY/*// EXEC LNKEDT/*/&..$$ EOJ /* <==== */




Member INSJOB9.Z

..$$ JOB JNM=INSJOB9 /* <==== */// JOB EZTPDEMO* ** * CA-EASYTRIEVE Plus INSTALL VERIFICATION* *NOLOG START OF SETPARMS// SETPARM EZTPLIB='@EZTPLIB' /* <==== */// SETPARM EZTPSUB='@EZTPSUB' /* <==== */// SETPARM EZTPVOL='@EZTPVOL' /* <==== */// SETPARM VFMVOL='@VFMVOL' /* <==== */// SETPARM VFMSTR='@VFMSTR' /* <==== */// SETPARM VFM#TR='@VFM#TR' /* <==== */// SETPARM SMPFILE='@SMPFILE' /* <==== */// SETPARM SMPFVOL='@SMPFVOL' /* <==== */// SETPARM SMPFSTR='@SMPFSTR' /* <==== */// SETPARM SMPF#TR='@SMPF#TR' /* <==== */// SETPARM INVFILE='@INVFILE' /* <==== */// SETPARM INVFVOL='@INVFVOL' /* <==== */// SETPARM INVFSTR='@INVFSTR' /* <==== */// SETPARM INVF#TR='@INVF#TR' /* <==== */// SETPARM PAYFILE='@PAYFILE' /* <==== */// SETPARM PAYFVOL='@PAYFVOL' /* <==== */// SETPARM PAYFSTR='@PAYFSTR' /* <==== */// SETPARM PAYF#TR='@PAYF#TR' /* <==== */NOLOG END OF SETPARMS/*// UPSI 1* ** * DITTO SAMPLE FILE TO DISK* *// DLBL SAMPFLE,'&SMPFILE',0,SD// EXTENT SYS001,&SMPFVOL,1,0,&SMPFSTR,&SMPF#TR// ASSGN SYS001,DISK,VOL=&SMPFVOL,SHR// EXEC DITTO$$DITTO CSQ FILEOUT=SAMPFLE

input data stream (not shown here)/*$$DITTO EOJ/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// DLBL SAMPLE,'&SMPFILE',,SD// EXTENT SYS004,&SMPFVOL,1,0,&SMPFSTR,&SMPF#TR// ASSGN SYS004,DISK,VOL=&SMPFVOL,SHR// DLBL INVSMPL,'&INVFILE',0,SD// EXTENT SYS024,&INVFVOL,,,&INVFSTR,&INVF#TR// ASSGN SYS024,DISK,VOL=&INVFVOL,SHR// DLBL PAYSMPL,'&PAYFILE',,SD// EXTENT SYS025,&PAYFVOL,,,&PAYFSTR,&PAYF#TR// ASSGN SYS025,DISK,VOL=&PAYFVOL,SHR// EXEC EZTPA00,SIZE=512K FILE SAMPLE FB(80 3120) DISK


Installing VSE 67


RECIN 1 80 A TESTREC 1 5 AFILE INVSMPL FB(200 3200) DISK INVREC1 1 80 A INVREC2 81 80 A INVREC3 161 40 AFILE PAYSMPL FB(150 1800) DISK PAYREC1 1 80 A PAYREC2 81 70 AJOB INPUT NULL GET SAMPLE DO WHILE TESTREC NQ '*****' INVREC1 = RECIN GET SAMPLE INVREC2 = RECIN GET SAMPLE INVREC3 = RECIN PUT INVSMPL GET SAMPLE END-DO GET SAMPLE DO WHILE NOT EOF SAMPLE PAYREC1 = RECIN GET SAMPLE PAYREC2 = RECIN PUT PAYSMPL GET SAMPLE END-DO DISPLAY NEWPAGE ' ' DISPLAY SKIP 3 'INVENTORY AND PAYROLL SAMPLE FILES INSTALLED' DISPLAY SKIP 2 RECORD-COUNT(INVSMPL) ' INVENTORY FILE RECORDS' DISPLAY SKIP 2 RECORD-COUNT(PAYSMPL) ' PAYROLL FILE RECORDS' STOP/*// DLBL COMPLB1,'&EZTPLIB'// EXTENT ,&EZTPVOL// DLBL EZTVFM,,0,SD// EXTENT SYS010,&VFMVOL,1,0,&VFMSTR,&VFM#TR// ASSGN SYS010,DISK,VOL=&VFMVOL,SHR// LIBDEF *,SEARCH=(COMPLB1.&EZTPSUB)// DLBL SEQFILE,'&PAYFILE',,SD// EXTENT SYS025,&PAYFVOL,,,&PAYFSTR,&PAYF#TR// ASSGN SYS025,DISK,VOL=&PAYFVOL,SHR// EXEC EZTPA00,SIZE=512KFILE SEQFILE FB(150 1800)************************************************************************ CA-EASYTRIEVE Plus PERSONNEL TEST FILE FIELD DEFINITIONS*********************************************************************** REGION 1 1 N BRANCH 2 2 N SSN 4 5 P MASK '999-99-9999' +

HEADING ('SOCIAL' 'SECURITY' - 'NUMBER')

EMP# 9 5 N HEADING ('EMPLOYEE' 'NUMBER') CODE 16 1 N HEADING ('SECURITY' 'CODE')




NAME 17 16 ANAME-LAST NAME 8 A HEADING ('LAST' 'NAME')NAME-FIRST NAME +8 8 A HEADING ('FIRST' 'NAME')

ADDRESS 37 39 AADDR-STREET 37 20 A HEADING 'STREET'ADDR-CITY 57 12 A HEADING 'CITY'ADDR-STATE 69 2 A HEADING 'STATE'ADDR-ZIP 71 5 N HEADING ('ZIP' 'CODE')

PAY-NET 90 4 P 2 HEADING ('NET' 'PAY') PAY-GROSS 94 4 P 2 HEADING ('GROSS' 'PAY') DEPT 98 3 N HEADING 'DEPARTMENT' DATE-OF-BIRTH 103 6 N MASK (Y 'Z9/99/99') +

HEADING ('DATE' 'OF' 'BIRTH') TELEPHONE 117 10 N MASK '(999) 999-9999' +

HEADING ('TELEPHONE' 'NUMBER') SEX 127 1 N HEADING ('SEX' 'CODE')

* 1 - FEMALE* 2 - MALE

MARITAL-STAT 128 1 A HEADING ('MARITAL' 'STATUS')* M - MARRIED* S - SINGLE

JOB-CATEGORY 132 2 N HEADING ('JOB' 'CATEGORY') SALARY-CODE 134 2 N HEADING ('SALARY' 'CODE') DATE-OF-HIRE 136 6 N MASK Y +

HEADING ('DATE' 'OF' 'HIRE')**********************************************************************JOB INPUT SEQFILE NAME MYPROG PRINT REPORT1*REPORT REPORT1 LINESIZE 65 LINE EMP# NAME/*/&..$$ EOJ /* <==== */

Sample Members

Installing VSE 69


Sample MembersThe following members can be found in the CA-Easytrieve Plusproduct library and are available for your use.

Name Description

CBLCNDOC.Z Documentation on how to use theCBLCNVRT Macro.

CBLCNVRT.Z CBLCNVRT Macro converts COBOLdefinitions to CA-Easytrieve Plusdefinitions.The COBOL convert macros include:■ CBLDII■ CBLDII12■ CBLDII13■ CBLDMPII■ CBLDMPVS■ CBLDVS■ CBLIII■ CBLIII12■ CBLIII13■ CBLINTVS■ CBLIVS■ CBLSII12■ CBLSII13■ CBLSRCII■ CBLSRCVS■ CBLSVS

DATEVAL.Z DATEVAL Macro validates the format ofa date. See the CA-Easytrieve PlusReference Guide for additional informationon using this macro.

Sample Members



Name Description

DATECONV.Z DATECONV Macro converts a date froma given format to any specified format.See the CA-Easytrieve Reference Guide foradditional information on using thismacro.

EZTPCONV.Z Program to convert CA-Easytrieve fielddefinitions to CA-Easytrieve Plusdefinitions.

EZTPMNT.Z VSAM macro data set maintenanceprogram, used by sample job MACMNT.

MACADD.Z Program to initialize a VSAM macro dataset, used by sample job MACINIT.

STRSRDOC.Z Documentation on how to use theSTRSRCH Macro.

STRSRCH.Z STRSRCH Macro; String Search Macro.

VERNUMP.Z VERNUMP Macro; Verify NumericParameter.

FONTHTML.Z Example of Extended Printer Definitionused to create HTML reports in theexample CA-Easytrieve programs.

Note: See the CA-Easytrieve Plus ExtendedReporting Facility Guide for instruction onhow to compile this printer definition.)

XRPTHTML.Z JCL used to compile and link theFONTHTML Extended Printer definition.

SAM1HTML.Z Part I of an example of a simpleCA-Easytrieve application that producesan HTML report.

SAM2HTML.Z Part II of an example of a simpleCA-Easytrieve application that producesan HTML report.

VSE Maintenance Procedures

Installing VSE 71


Name Description

SUM1HTML.Z Part I of an example of a more advancedCA-Easytrieve application that producesan HTML report.

SUM2HTML.Z Part II of an example of a more advancedCA-Easytrieve application that producesan HTML report.


VSE Genlevel Maintenance

Maintenance for CA-Easytrieve Plus is provided on theCA-Easytrieve Plus installation tape when a new genlevelbecomes available. Application of genlevel maintenance isperformed by restoring the maintenance file from the installationtape and executing the MSHP (Maintain System HistoryProgram).

File 20 of the installation tape contains a README file whichcontains the latest information about the maintenance process.

Files 21 and 22 of the installation tape contain JCL that can beused to apply the VSE maintenance to your CA-Easytrieve Plusproduct.




Use the following JCL to unload these three files from the tape.Modify the statements containing the comment "/* <=== */" to bevalid for your site.* $$ JOB JNM=DITTO /* <==== */* $$ PUN /* <==== */// JOB DITTO* * ** * * Unload README File* * *// UPSI 1// ASSGN SYS006,tapecuu /* <==== */// MTC REW,SYS006// MTC FSF,SYS006,19// EXEC DITTO$$DITTO TC INPUT=SYS006,NBLKS=399$$DITTO EOJ* * ** * * Unload Maintenance JCL from Tape , Files 21 and 22* * ** $$ PUN /* <==== */// ASSGN SYS006,tapecuu /* <==== */// EXEC DITTO$$DITTO TC INPUT=SYS006,NBLKS=399$$DITTO EOJ/** $$ PUN /* <==== */// ASSGN SYS006,tapecuu /* <==== */// EXEC DITTO$$DITTO TC INPUT=SYS006,NBLKS=399$$DITTO EOJ/*/&* $$ EOJ

Before executing any maintenance jobs, read the README filefor the latest information regarding the application ofmaintenance. Then, modify the maintenance jobs, providingvalues for the symbolic parameters.

File 21 contains Maintenance Job 1, MNTJOB1. This job creates amaintenance library and restores the maintenance library fromthe tape to the library just created.

File 22 contains Maintenance Job 2, MNTJOB2, which applies themaintenance members to your CA-Easytrieve Plus productlibrary.

VSE Operating System

Installing VSE 73


VSE APAR Maintenance

If you need an immediate fix for a severe problem, contactCA-Easytrieve Plus support.

Any APARs available through the support line must be applied,using the Maintain System History Program, (MSHP), andincorporate the required JCL.

More information regarding MSHP can be found in the MaintainSystem History Program Reference guide.

VSE Operating SystemThis section describes all files and JCL required for executingCA-Easytrieve Plus in the VSE operating system.

■ Files prefixed by SYS, KJ, and SORT are operatingsystem-related files.

■ Files prefixed by EZT are CA-Easytrieve Plus related.

■ Files prefixed by PAN are macro file related.

The EZT and PAN prefixes can be respecified by optionsWKDSPF and MACDDN.




VSE Files

The following are the file names and descriptions of their use.

SYSIPT

(required for compilation only)

File name Description

Purpose Source statement input plus optional datainput

Characteristics Fixed length, 80-bytes

Considerations Optional data input follows the ENDstatement, which delimits the sourceprogram input. The file can be assigned toany device supported by DTFCP for input.

SYSLST

(required)


Purpose Compiler and default report output

Characteristics Fixed length, 121 to 133 bytes

Considerations The file can be assigned to any devicesupported for output by DTFCP.


Installing VSE 75


PANDD1

(optional)


Purpose Provides access to CA-Easytrieve Plusmacros stored in a CA-Panvalet library. (Ifyou are using a VSAM macro library, usefile name PANDD or if you are using an SSLmacro library, use a LIBDEF to define thesource library to be searched for macromembers.)

MASTER

(optional)


Purpose Provides access to CA-Easytrieve Plusmacros stored in a CA-Librarian library.

EZTVFM

(optional)


Purpose Work file space for the Virtual File Manager

Characteristics Sequential DASD workfile, fixed length,record length determined by VFM

Considerations VFM is used for work files duringcompilation, by report spool files, and byuser VIRTUAL files during execution.




VFM attempts to buffer all data in storage. If there is insufficientstorage to buffer all data, an EZTVFM data set is required.

The EZTVFM data set must be a single extent data set on DASD.The size of the EZTVFM data set depends on the amount of datato be maintained by the VFM during execution. VFM maintainsat least 90 percent utilization of the disk space. If the totalnumber of bytes to be maintained by VFM at any one time isknown, the formula for tracks of disk space is:

bytes of data -----------------------------

0.9 * track-length

SORTWKn

(optional)


Purpose Provide sort work space for the VSE sort

Characteristics Either DASD or tape files as required by thesort program

Considerations If work files are DA, then this must matchthe options table NUMWORK specificationor be overridden on the PARM statement.


Installing VSE 77


SYSLNK

(optional)


Purpose Output file for CA-Easytrieve Plus objectmodules; used as input to the VSE linkageeditor

Characteristics Fixed length, 82 bytes

Considerations The file can be assigned to any devicesupported by DTFCP for output.

userfiles

(optional)


Purpose Provides access to files described byCA-Easytrieve Plus FILE statements

Characteristics As required by coding on the FILEstatements.

CA-IDMS

(CA-IDMS)


Purpose Supplies the required CA-IDMS PHASEs.




SYSJRNL

(IDMS local)


Purpose Identifies the CA-IDMS journal file. Thejournal is usually a tape file. The filenumber is given by f.

SYSIDMS

(IDMS)


Purpose Identifies the CA-IDMS (release 12.0 andabove) environment parameters.

idmsdb

(IDMS local)


Purpose Identifies the areas comprising the database.

IDMSDICT

(IDMS local)


Purpose Identifies the dictionary to be used forlibrary definitions.


Installing VSE 79


UPSI

(optional)


Purpose Supplies variable information to theCA-Easytrieve Plus program or to CA-IDMS.

VSE JCL Examples

The following example illustrates the JCL necessary to compileand go with sort and external VFM work file:* $$ JOB JNM=jobname// JOB jobname// DLBL EZTP,'your.eztp.library',0,SD// EXTENT SYS003,volser,1,0,start,lgth// ASSGN SYS003,nnn// LIBDEF PHASE,SEARCH=EZTP.sublib,TEMP// ASSGN SYS001,...// ASSGN SYS010,...// ASSGN SYS008,...// DLBL SORTWK1,,0,DA// EXTENT SYS001,volser,,,start,lgth// DLBL EZTVFM,,0,SD// EXTENT SYS010,volser,,,start,lgth// DLBL INREC,,0,SD// EXTENT SYS008,volser,,,start,lgth// EXEC EZTPA00,SIZE=512K CA-Easytrieve Plus source statements/*/&* $$ EOJ




This example illustrates the JCL necessary to compile and linkedit a phase to be executed later:* $$ JOB JNM=jobname// JOB jobname// DLBL EZTP,'your.eztp.library',0,SD// EXTENT SYS003,volser,1,0,start,lgth// ASSGN SYS003,nnn// LIBDEF PHASE,CATALOG=EZTP.sublib,TEMP// LIBDEF PHASE,SEARCH=EZTP.sublib,TEMP// ASSGN SYS010,...// DLBL EZTVFM,,0,SD// EXTENT SYS010,volser,,,start,lgth// OPTION CATAL// EXEC EZTPA00,SIZE=512KPARM LINK(TESTPGM) ...CA-Easytrieve Plus source statements.../*// EXEC LNKEDT/&* $$ EOJ

The following example illustrates the JCL necessary to execute apreviously compiled and link edited phase:* $$ JOB JNM=jobname// JOB jobname// DLBL EZTP,'your.eztp.library';0,SD// EXTENT SYS003,volser,1,0,start,lgth// ASSGN SYS003,nnn// LIBDEF PHASE,SEARCH=EZTP.sublib,TEMP// ASSGN SYS001,...// ASSGN SYS010,...// ASSGN SYS008,...// DLBL SORTWK1,,0,DA// EXTENT SYS001,volser,,,start,lgth// DLBL EZTVFM,,0,SD// EXTENT SYS010,volser,,,start,lgth// DLBL INREC,,0,SD// EXTENT SYS008,volser,,,start,lgth// EXEC TESTPGM,SIZE=512K ...optional CARD input.../*/&* $$ EOJ


Installing VSE 81


The following JCL can be used for executing CA-Easytrieve Pluswith DL/I:* $$ JOB JNM=jobname// JOB EZTDLI// UPSI 00000000// ASSGN SYS011,nnn// TLBL LOGOUT// ASSGN SYS006,nnn// DLBL INVPRT1,'INVENTORY',99/365,VSAM// EXTENT SYS006,volser// EXEC DLZRRC00,SIZE=512KDLI,EZTPA00,psbname,RC=YES. ...CA-Easytrieve Plus DLI statements... . ./*/&* $$ EOJ

When executing CA-Easytrieve Plus programs with both DL/Iand DB2 for VSE statements, change the JCL statement givenabove from:// EXEC DLZRRC00,SIZE=512K

to:// EXEC DLZRRC00,SIZE=(AUTO,xxxK)

where xxxK is the amount of storage needed to execute yourCA-Easytrieve Plus program. xxxK is usually between 256K and512K.




The following example illustrates the VSE JCL to executeCA-Easytrieve Plus with CA-IDMS under central version:* $$ JOB JNM=jobname// JOB jobname// UPSI b// DLBL EZTP,'your.eztp.library'// EXTENT ,volser// DLBL IDMS,'cdms.library'// EXTENT ,volser// LIBDEF PHASE,SEARCH=(EZTP.sublib,IDMS.sublib)// ASSGN SYS001,DISK,VOL=volser,SHR// DLBL SORTWK1,,0// EXTENT SYS001,volser,,,start,length// DLBL EZTVFM,,0,SD// EXTENT SYS010,volser,,,start,length// EXEC EZTPA00,SIZE=512K ... CA-Easytrieve Plus source statements .../*

The following example illustrates the VSE JCL to executeCA-Easytrieve Plus with CA-IDMS under local mode:* $$ JOB JNM=jobname// JOB jobname// UPSI b// DLBL EZTP,'your.eztp.library'// EXTENT ,volser// DLBL IDMS,'cdms.library'// EXTENT ,volser// LIBDEF PHASE,SEARCH=(EZTP.sublib,IDMS.sublib)// ASSGN SYS001,DISK,VOL=volser,SHR// DLBL SORTWK1,,0// EXTENT SYS001,volser,,,start,length// ASSGN SYS004,DISK,VOL=volser,SHR// DLBL idmsdb,'your.database',,DA// EXTENT SYS004,volser,,,start,length// ASSGN SYS005,DISK,VOL=volser,SHR// DLBL idmsdb,'cdms.dictdb',,DA// EXTENT SYS005,volser,,,start,length// ASSGN SYS009,cuu// TLBL sysjrnl,'cdms.tapejrnl',,volser,,f// DLBL EZTVFM,,0,SD// EXTENT SYS010,volser,,,start,length// EXEC EZTPA00,SIZE=512K ... CA-Easytrieve Plus source statements .../*


Installing VSE 83


The following example illustrates the VSE JCL to execute apreviously compiled and link edited CA-Easytrieve Plusprogram with CA-IDMS under central version:* $$ JOB JNM=jobname// JOB jobname// UPSI b// DLBL EZTP,'your.eztp.library'// EXTENT ,volser// DLBL IDMS,'cdms.library'// EXTENT ,volser// LIBDEF PHASE,SEARCH=(EZTP.sublib,IDMS.sublib)// ASSGN SYS001,DISK,VOL=volser,SHR// DLBL SORTWK1,,0// EXTENT SYS001,volser,,,start,length// DLBL EZTVFM,,0,SD// EXTENT SYS010,volser,,,start,length// EXEC TESTPGM,SIZE=512K/*

The following example illustrates the VSE JCL to execute apreviously compiled and link edited CA-Easytrieve Plusprogram with CA-IDMS under local mode:* $$ JOB JNM=jobname// JOB jobname// UPSI b// DLBL EZTP,'your.eztp.library'// EXTENT ,volser// DLBL IDMS,'cdms.library'// EXTENT ,volser// LIBDEF PHASE,SEARCH=(EZTP.sublib,IDMS.sublib)// ASSGN SYS001,DISK,VOL=volser,SHR// DLBL SORTWK1,,0// EXTENT SYS001,volser,,,start,length// ASSGN SYS004,DISK,VOL=volser,SHR// DLBL idmsdb,'your.database',,DA// EXTENT SYS004,volser,,,start,length// ASSGN SYS005,DISK,VOL=volser,SHR// DLBL idmsdb,'cdms.dictdb',,DA// EXTENT SYS005,volser,,,start,length// ASSGN SYS009,cuu// TLBL sysjrnl,'cdms.tapejrnl',,volser,,f// DLBL EZTVFM,,0,SD// EXTENT SYS010,volser,,,start,length// EXEC TESTPGM,SIZE=512K/*

ICCF Installation



The following example illustrates the JCL necessary to executeCA-Easytrieve Plus with DB2 for VSE.* $$ JOB JNM=jobname// JOB jobname// UPSI b// DLBL EZTP,'your.eztp.library'// EXTENT ,volser// ASSGN SYS001,DISK,VOL=volser,SHR// DLBL SORTWK1,,0// EXTENT SYS001,volser,,,start,lgth// ASSGN SYS010,DISK,VOL=volser,SHR// DLBL EZTVFM,,0,SD// EXTENT SYS010,volser,,,start,lgth// DLBL SQLLIB,'your.pansql.library',0,SD// EXTENT ,volser// LIBDEF PHASE,SEARCH=(SQLLIB.sublib,EZTP.sublib)// EXEC EZTPA00,SIZE=512KPARM USERID('user-id' 'password') ... CA-Easytrieve Plus DB2 for VSE source statements .../*/&* $$ EOJ

Note: When executing a CA-Easytrieve Plus program with DB2for VSE, no JCL changes are required for Multiple User Mode.

For the Single User Mode of DB2 for VSE, you should specify theSIZE=(AUTO,xxxK) parameter on your JCL EXEC statement,where xxxK is the amount of storage required for normalCA-Easytrieve Plus execution. The xxxK value is usuallybetween 256K and 512K.

ICCF InstallationCA-Easytrieve Plus can execute interactively in the ICCFenvironment. Interactive execution is in an ICCF foregroundpartition. This is easily accomplished by creating an ICCFprocedure after completing the VSE installation.

ICCF Installation

Installing VSE 85


ICCF Procedure

Use the following sample ICCF procedure to executeCA-Easytrieve Plus:/LOAD EZTPA00/OPTION GETVIS=P-68 INCON/FILE NAME=SORTWK1,UNIT=SYS003,SPACE=30/FILE NAME=IJSYS03,UNIT=SYS003,SPACE=30/FILE NAME=EZTVFM,SPACE=30/FILE NAME=input,SER=volser,ID='input.file'/FILE NAME=output,SER=volser,ID='output.file',LOC=1416,10**CA-Easytrieve Plus statements here/RUN

This ICCF PROC loads CA-Easytrieve Plus, reserving all but 68Kof space for GETVIS area. Sort work files and the VFM file areallocated as ICCF dynamic space files.

INPUT and OUTPUT files are also identified by the proc. The/Run causes execution of your program.

When the SORT or SEQUENCE statements are used in aprogram, CA-Easytrieve Plus invokes your standard operatingsystem SORT. For more information, see the SORTOPT option,described in the �Options Table� appendix of this guide. If youuse IBM's SORT/MERGE product, you should be aware ofspecial considerations for running it under ICCF. Your SORTmust also not PFIX its I/O buffers.

Documentation Legal Notice

This Documentation, which includes embedded help systems and electronically distributed materials, (hereinafter referred to as the “Documentation”) is for your informational purposes only and is subject to change or withdrawal by CA at any time. This Documentation is proprietary information of CA and may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without the prior written consent of CA.

If you are a licensed user of the software product(s) addressed in the Documentation, you may print or otherwise make available a reasonable number of copies of the Documentation for internal use by you and your employees in connection with that software, provided that all CA copyright notices and legends are affixed to each reproduced copy.

The right to print or otherwise make available copies of the Documentation is limited to the period during which the applicable license for such software remains in full force and effect. Should the license terminate for any reason, it is your responsibility to certify in writing to CA that all copies and partial copies of the Documentation have been returned to CA or destroyed.

TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION “AS IS” WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOST INVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THE POSSIBILITY OF SUCH LOSS OR DAMAGE.

The use of any software product referenced in the Documentation is governed by the applicable license agreement and such license agreement is not modified in any way by the terms of this notice.

The manufacturer of this Documentation is CA.

Provided with “Restricted Rights.” Use, duplication or disclosure by the United States Government is subject to the restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-7014(b)(3), as applicable, or their successors.

Copyright © Broadcom. All Rights Reserved. The term “Broadcom” refers to Broadcom Inc. and/or its subsidiaries. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies.

Ca A Broadcom® Company

technologies

ca-easytrieve ﬁ plus for vse 6 · 2019. 12. 19. · iv ca-easytrieve plus for vse...

Documents