The installation tape is a standard labeled tape with three files containing Date Simulator components: 1) load library of load modules, 2) CA-IDMS RHDCSGEN syntax to add program and task statements, and 3) CA-IDMS IDMSDDDL syntax to add messages to the dictionary.

Date Simulator executes within the CA-IDMS environment and, as such, installs at the CA-IDMS CV level (i.e. each CV that will use Date Simulator must have all components defined).

1) Copy Date Simulator Load Library

The Date Simulator load modules may be copied into an existing CA-IDMS load library defined to the CV start-up JCL or the entire load library may be copied to a new Date Simulator load library that will be defined to the CV start-up JCL. This example assumes a new Date Simulator load library is created.

First, determine the name to be used for the Date Simulator load library. Next, offload the first file to disk using the IEBCOPY utility and JCL similar to the following:

// user jobcard
//*
//*               	copy the Date Simulator load library
//* 
//COPYLOD	EXEC	PGM=IEBCOPY
//CART    	DD 	DSN=DBSDS1.DATESIM.LOADLIB,
//                          	DISP=OLD,
//                          	UNIT=cart,
//                          	VOL=SER=DBSDS1,
//                          	LABEL=1
//DASD     	DD 	DSN=user.date.simulator.loadlib.dsn,
//                          	DISP=(NEW,CATLG,DELETE),
//                          	UNIT=sysda,
//                          	DCB=BLKSIZE=23476,
//                          	SPACE=(TRK,(5,5,2))
//SYSUT3   	DD    	SPACE=(TRK,(1,1)),
//                          	DISP=(,DELETE),
//                          	UNIT=sysda
//SYSUT4    	DD    	SPACE=(TRK,(1,1)),
//                          	DISP=(,DELETE),
//                          	UNIT=sysda
//SYSPRINT	DD    	SYSOUT=*
//SYSIN     	DD    	*
 COPYMOD INDD=CART,OUTDD=DASD,MAXBLK=23476
/*
//

CAUTION: The BLKSIZE for the user.date.simulator.loadlib.dsn must be determined based on where the loadlib will be positioned in the CA-IDMS CV start-up concatenation. As a general rule, the loadlib with the largest BLKSIZE must be named first in the start-up concatenation. Assuming the user.date.simulator. loadlib.dsn will not be first in the concatenation, make sure the BLKSIZE is no larger than the BLKSIZE for the first load library.

---

The user.date.simulator.loadlib.dsn must be defined to the CA-IDMS CV start-up concatenation. If the Date Simulator load modules were copied into a load library already defined to the start-up concatenation, skip this step.

3) Define Date Simulator Task and Program Statements to the CA-IDMS CV

There are several Date Simulator task and program statements that must be defined to the CA-IDMS CV. File 2 on the installation tape contains the required task and program statements. Execute an IEBGENER and the RHDCSGEN compiler using file 2 as input and JCL similar to the following:

// user jobcard
//*
//*               	add the Date Simulator task and program statements
//* 
//GENER	EXEC	PGM=IEBGENER
//SYSUT1	DD	DSN=DBSDS1.DATESIM.RHDCSGEN,
//                          	DISP=OLD,
//                          	UNIT=cart,
//                          	VOL=SER=DBSDS1,
//                          	LABEL=2
//SYSUT2	DD	DSN=&&TEMP,
//		DISP=(,PASS),
//		UNIT=SYSDA,
//		SPACE=(TRK,(5,5)),
//		DCB=(RECFM=FB,LRECL=80,BLKSIZE=8000)
//SYSPRINT	DD	SYSOUT=A
//SYSIN	DD	DUMMY
//*
//SYSGEN	EXEC	PGM=RHDCSGEN
//STEPLIB	DD	DSN=idms.dba.loadlib.dsn,DISP=SHR
//	DD	DSN=idms.loadlib.dsn,DISP=SHR
//SYSCTL	DD	DSN=idms.sysctl.dsn,DISP=SHR
//SYSLST	DD	SYSOUT=A
//SYSPCH	DD	SYSOUT=A
//SYSOUT	DD	SYSOUT=A
//*
//*	the following is required for CA-IDMS Release 12.0 sites
//*
//SYSIDMS	DD	*
DMCL=dmcl-name
other SYSIDMS parameters as required
//SYSIPT	DD	DDNAME=SIGNON
//	DD	DSN=&&TEMP,DISP=OLD
//SIGNON	DD	*
	SIGNON USER userid PASS password .
	SET OPTIONS INPUT 1 80 .
	MOD SYSTEM dc-system-number .
/*
//



4) Add Date Simulator Messages to the Dictionary

Date Simulator messages are stored in and retrieved from the dictionary. File 3 on the installation tape contains the Date Simulator messages in IDMSDDDL syntax. Execute an IEBGENER and the IDMSDDDL compiler using file 3 as input and JCL similar to the following:

// user jobcard
//*
//*               	add the Date Simulator messages
//* 
//GENER	EXEC	PGM=IEBGENER
//SYSUT1	DD	DSN=DBSDS1.DATESIM.IDMSDDDL,
//                          	DISP=OLD,
//                          	UNIT=cart,
//                          	VOL=SER=DBSDS1,
//                          	LABEL=3
//SYSUT2	DD	DSN=&&TEMP,
//		DISP=(,PASS),
//		UNIT=SYSDA,
//		SPACE=(TRK,(5,5)),
//		DCB=(RECFM=FB,LRECL=80,BLKSIZE=8000)
//SYSPRINT	DD	SYSOUT=A
//SYSIN	DD	DUMMY
//*
//IDMSDDDL EXEC	PGM=IDMSDDDL
//STEPLIB	DD	DSN=idms.dba.loadlib.dsn,DISP=SHR
//	DD	DSN=idms.loadlib.dsn,DISP=SHR
//SYSCTL	DD	DSN=idms.sysctl.dsn,DISP=SHR
//SYSLST	DD	SYSOUT=A
//SYSPCH	DD	SYSOUT=A
//SYSOUT	DD	SYSOUT=A
//*
//*	the following is required for CA-IDMS Release 12.0 sites
//*
//SYSIDMS	DD	*
DMCL=dmcl-name
other SYSIDMS parameters as required
//SYSIPT	DD	DDNAME=SIGNON
//	DD	DSN=&&TEMP,DISP=OLD
//SIGNON	DD	*
	SIGNON USER userid PASS password .
	SET OPTIONS INPUT 1 80 .
/*
//

5) Re-cycle the CV

The CV must be re-cycled to recognize the Date Simulator task and program statements and load library.

6) Verify Date Simulator Installation

Verify that the Date Simulator installation is successful. Issue the following command:

V1 ENTER NEXT TASK CODE:
SHOWCLK

If installed correctly, Date Simulator will display an empty clock table and empty use table.

7) Turn Date Simulator On

Finally, turn Date Simulator on by entering the following command:

V1 ENTER NEXT TASK CODE:
VARYCLK ON

Date Simulator is now available.

8) Date Simulator Base Installation is Complete!!!