ADSO Migration Utility User's Guide
Copyright © 1983-2017 Laderman Associates


OS Installation
DOS Installation

OS Installation

Installation of the ADSO Migration Utility is a simple matter of copying load modules from the installation tape to a load library of your choice.

//jobname 	JOB 	site parameters
//step1  	EXEC  PGM=IEBCOPY
//TAPEIN  	DD  	DSN=AMU120.LOAD,DISP=OLD,UNIT=tape,
// 	      VOL=SER=AMU120
//LOAD  	DD    DSN=amu.loadlib,DISP=(,CATLG,DELETE),UNIT=disk,
// 	      SPACE=(TRK,(50,5,4),RLSE),DCB=(RECFM=U,BLKSIZE=blksz)
//SYSUT3 	DD  	UNIT=disk,SPACE=(TRK,1)
//SYSPRINT 	DD  	SYSOUT=sysout class
//SYSIN DD  *
  COPY OUTDD=LOAD,INDD=TAPEIN
/*
//

All programs are written in COBOL. If the COBOL subroutine library is not specified in your link pack area, you will have to include it as part of the STEPLIB concatenation for the execution of all AMU programs.

File 2 of the installation tape (DSN=AMU120.SAMPJCL) contains sample execution JCL for all programs in the AMU. Note that this is intended to ease the chore of coding the JCL from scratch, but will certainly require extensive modifications for use at your facility. Figure 5 within System Description may be helpful in tracking the usage of the various sequential files. Use IEBGENER or a similar sequential file copy utility to unload these 80-byte records to a disk file accessible by your text editor.

DOS Installation

Installation of the ADSO Migration Utility is a simple matter of cataloging relocatable modules from the installation tape and linking them into the core-image library of your choice. All programs are linked as other standard IDMS batch COBOL programs in your environment.

* $$ JOB JNM=jobname,site parameters
// JOB site parameters
* step 1 - MAINT
LIBDEFS here specify as TO the relocatable library and core-image library
	       which will contain the AMU
LIBDEFS specify as SEARCH the libraries which contain
	       COBOL and IDMS routines.
// TLBL IJSYSIN,'AMU120.RELO',0
   ASSGN SYSIPT,cuu 		cuu is tape drive address
// EXEC LIBR,PARM='ACCESS=libname'
/*
* step 2 - LNKEDT LADAMU05
// ASSGN SYSIPT,SYSRDR
// OPTION CATAL
 PHASE LADAMU05
 INCLUDE LADAMU05
 INCLUDE IDMSCANC
 INCLUDE idmsidms       your standard IDMS interface
 INCLUDE IDMSOPTI       only if you will wish to execute through central version
/*
 ENTRY LADAMU05
// EXEC LNKEDT
/*
* steps 3 thru 13 - Execute LNKEDT for each of the following programs. 
  LADAMU10 should include the same modules as LADAMU05 and, additionally, should include LADAMUS1. 
  LADAMU30 should include the same modules as LADAMU05. 
  The remainder of the programs need only include IDMSCANC.

 	LADAMU07 	LADAMU19
	LADAMU10 	LADAMU20
	LADAMU11 	LADAMU25
	LADAMU12 	LADAMU30
	LADAMU15 	LADAMU35
	LADAMU17 	LADAMU40

Unresolved external references for IJGFxEWZ may be ignored.

File 5 of the installation tape (i.e. the file past the fourth tape mark) contains sample JCL for all programs in the AMU. Note that this is intended to ease the chore of coding the JCL from scratch, but will certainly require extensive modifications for use at your facility. Figure 5 within System Description may be helpful in tracking the usage of the various sequential files. Use DITTO, or any sequential file copy utility, to unload these 80-byte records (blocking factor = 100) to a file accessible by your text editor.