$DOC

This member documenting the CA-7 installation and conversion steps

UNLOAD

IEBCOPY CAI.SAMPJCL from distribution cart

IEBCOPY

Copied from production SYS1.VTAMLST data set

• APPLCA7
• APPLCA7I
• APPLRDR

Copied from production CA7.JCL1 data set

• PCANDR98
• PCANDR99

Copied from production CA7.INSTALL

• CA7JOBS job to copy CA-7 install members from production LPAR
• CA7ALLOC job which allocated data sets on production LPAR

IEASVC00

Backup SYS1.PARMLIB(IEASVC00) as IEASVC99.  Add CA-7 SVC definition to use same SVC as in production.

SVCPARM 240,REPLACE,TYPE(4),APF(NO)   /* CA-7 V3R2 */

L232ADST

Allocate distribution libraries

L232ATGT

Allocate target libraries

CAINITE5

Add target/dlib SMP/E zones

CAIL232

SMP/E JCL procedure modified for OS/390 2.4 Y2K LPAR

L232REC

SMP/E RECEIVE SYSMODS

CL232S0    /* CA-7 Base Release 3.2 */

CL232C0    /* CA-7 Communications */

CL232T0    /* CA-7 ISPF Interface */

CL232SC    /* CA-7/CA-11 2.2 Interface */

Did not receive the following sysmods

CL232SB    /* CA-7/CA-11 2.0/2.1 Interface */

CL232SL    /* CA-7/CA-Librarian Interface */

L232APPK

SMP/E APPLY CHECK SYSMODS

CL232S0    /* CA-7 Base Release 3.2 */

CL232C0    /* CA-7 Communications */

CL232T0    /* CA-7 ISPF Interface */

CL232SC    /* CA-7/CA-11 2.2 Interface */

L232APP

SMP/E APPLY SYSMODS

CL232S0    /* CA-7 Base Release 3.2 */

CL232C0    /* CA-7 Communications */

CL232T0    /* CA-7 ISPF Interface */

CL232SC    /* CA-7/CA-11 2.2 Interface */

L232ACCK

SMP/E ACCEPT CHECK SYSMODS

CL232S0    /* CA-7 Base Release 3.2 */

CL232C0    /* CA-7 Communications */

CL232T0    /* CA-7 ISPF Interface */

CL232SC    /* CA-7/CA-11 2.2 Interface */

L232ACC

SMP/E ACCEPT SYSMODS

CL232S0    /* CA-7 Base Release 3.2 */

CL232C0    /* CA-7 Communications */

CL232T0    /* CA-7 ISPF Interface */

CL232SC    /* CA-7/CA-11 2.2 Interface */

L232GEN

Stage I assembly to generate library CA7.SAMPLIB

STAGE1

Output from job L232GEN is in member CA07N000; JCL for STAGE2

CA07N000

Job to create sample STAGE2 jobs in CA7.SAMPLIB.   These jobs will be copied to CA7.INSTALL where they will be modified for the environment.

Jobs in CA7.SAMPLIB will remain unmodified for reference purposes.

CA07N010

Allocate VRM database, ARF database, queue and support files

CA07N020

Copy procedures to CA7.CAIPROC.   The procedures were modified as follows:

• CA7ARK ARF data base backup; change backup data set to a Generation Data Group with a maximum of 7 entries
• CA7ARL ARF data base delete/define/reload; change backup dsn to a GDG with 7 entries
• CA7BAT Execute CA-7 in batch; no change
• CA7BKUP Data base backup; change backup dsn to a GDG with 7 entries
• CA7BTI Batch Terminal Interface; no change
• CA7ICOM Communications started task; no change
• CA7LOAD Load procedure JCL; no DDs defined for input or output
• CA7LOGP Primary log file dump; change output dump data set to a GDG with 7 entries
• CA7LOGS Secondary log file dump; change output dump data set to a GDG with 7 entries
• CA7ONL Online started task; commented out CARPROC DD statement
• CA7RELD Data base reload; change input dsn to a GDG
• CA7SVC U7SVC
• CA7TRLR Trailer
• CA7VBK VRM data base backup; change backup dsn to a GDG with 7 entries
• CA7VRL VRM data base delete/define/reload; change input dsn to a GDG
• CA7VRMT VAX remote job

CA07N030

Format and initialize data sets

CA07N120

Did not copy VTAM definitions from CA7.INSTALL to SYS1.VTAMLST as we will use the TCA7VTAM and TCA7ISPF appl definitions which already exist; appls are varied active in SYS1.VTAMLST(ATCCON00)

CA7CLIST

Backup in CA7.CAICLIB(CA7CLI99) and modify CA7.CAILIB data set name for usermod UL23211

UL23211R

SMP/E Receive/Apply/Check usermod for TSO/ISPF interface

UL23211A

SMP/E Apply usermod for TSO/ISPF interface

PPPANEL

Backup PPPANEL as PROD.ISPPLIB(PPPANE99) and add CA-7 ISPF option to PPPANEL

CA7PDRVR

Copy CA7.CAICLIB(CA7PDRVR) to PROD.CLIST

UL232IZR

SMP/E Receive/Apply/Check interface options usermod to ICMDSECT which defines the following:

• CA-7 SMF record indicator byte location
• SMF record type support
• SVC number which was specified as SVC 240, X'0AF0'
• batch security options
• other internal control options

SCAL99PE

Create member in CA7.CL232SLD from source in CA7.SAMPLIB(UL23201)

SCAL9903

Create member from source in CA7.SAMPLIB(UL23201)

UL232IZA

SMP/E Receive/Apply/Check usermod to ICMDSECT to set CA-7 system interface options

UL23201R

SMP/E Receive usermod that contains two sample calendars for post installation testing, CAL99PET and CAL9903T

UL23201K

SMP/E Apply/check usermod that contains two sample calendars

UL23201A

SMP/E Apply usermod that contains two sample calendars

L232RIM

Copy CAIRIM initialization statements from CA7.SAMPLIB and add to CA90S.PPOPTION(CARIMPRM); backup is in CARIMP99

CAS9

Add CA7.CAILIB to PROD.PROCLIB(CAS9) STEPLIB concatenation

PROG00

Add CA7.CAILIB on volume PP0001 to SYS1.PARMLIB(PROG00); backup in PROG99

S.LOG

Enter /SET PROG=00 command to add CA7.CAILIB to APF list

Enter /S CAS9 command to start CA-7

CA07N220

Execute CA-7 in batch to define test job network and maintenance jobs.   The network can be DEMANDed to exercise CA-7 facilities and ensure they have been installed correctly

CA07LOGP

Production job to swap the primary log and dump the inactive log

CA07LOGS

Production job to swap the secondary log and dump the inactive log file

CA7BAKUP

CA7.INSTALL(CA7BAKUP) JCL is also on the production LPAR.   Backup the production CA-7 V3R0 data base in order to restore it to the Y2K CA-7 V3R2 data base

S.LOG

Start CA-7 with command

S CA7ONL,TYPE=FORM,VDUMP=DUMMY to format the queues

Do not use MOVQ to move them from production

CA7RELD

Restore the backup copy of the production CA-7 V3R0 data base created with CA7.INSTALL(CA7BAKUP) on the production LPAR

SASSSECX

User security source module copied from CA7.SOURCE(SASSSECX) on the production LPAR

SASSSY2K

User security source module modified for Y2K OS/390 2.4 LPAR

TCA99PAY

Source for 1999 payroll calendar

TCA99ACP

Source for 1999 accounts payable calendar

TCA99ACR

Source for 1999 accounts receivable calendar

TCA99BKU

Source for 1999 DASD backup calendar

TCA99MFG

Source for 1999 manufacturing application calendar

TCA99EST

Source for 1999 cost estimating application calendar

CA7AL

Procedure in PROD.PROCLIB to assemble/link calendars and security module

CA7TBLS

Job JCL to assemble/link calendars and security module

CAUTOCMD

Add START CA7ONL and START CA7ICOM commands to CA90.PPOPTION(AUTOCMD)

BATCH

Change Security statement to SECURITY,NAME=SASSSY2K in CA7.JCL1; backup is BATCH99

Add statements for JCL libraries

ONLINE

Change Security statement to SECURITY,NAME=SASSSY2K in CA7.JCL1; backup is ONLINE99

Add statements for JCL libraries

CA7JOBSL

Execute IEBCOPY to restore CA-7 JCL libraries from the production LPAR

S.LOG

Enter /S CA7ONL to start CA-7

Enter /S CA7ICOM to start CA-7 communications

COPYPROD

Copy CA7.CAILIB to PROD.CA7.CAILIB

TSO Option 2

Add PROD.CA7.CAILIB to SYS1.PARMLIB LNKLST00 and PROG00 members

Execute Steps 1-3 on the production MVS/ESA 4.2 LPAR when converting CA-7

1. Dump the queues in the following order to the UCC7QDMP DD data set

• Preprocess queue
• Request queue
• Ready queue
• Active queue
• Postprocess queue
• Prior-run queue

Data in the trailer queue is also unloaded during the dump of the above queues. The CA-7 scratch queue, which contains messages, and the DQTQ are not unloaded. This same procedure, however, must be used if moving or reallocating the scratch queue or the DQTQ. The VRM database component contains "active" resource records which relate to jobs currently in the CA-7 queues. The VRM active resource records track resource use by job and, if in use, must match the CA-7 queue records. These active records are dumped to the VRM Dump queue file, CA7VDMP DD and, they are date/time stamped to match the queue records to ensure synchronization during DMPQ/MOVQ processing.  No VRM data sets exist on the production LPAR.

2. After the queues are dumped (see Step 1, above), backup the CA-7 databases by submitting the following job

TSO Option 6:

SUB 'CA7.PDS.CNTL(CA7BAKUP)'

The output from the job which was executed to backup the queues for the initial CA-7 V3R2 install is in data set CA7.PDS.OUTPUT(CA7BAKUP)

3. IEBCOPY the CA-7 JCL libraries by submitting the following job

TSO Option 6:

SUB 'CA7.PDS.CNTL(CA7JOBS)'

 

The following data sets will be copied:

CA7.HELP

CA7.OVERRIDE

CA7.JOBLIB1

CA7.JOBLIB2

CA7.JCLLIB3

CA7.JCL1

CA7.JCL2

CA7.JCL3

CA7.JCL4

CA7.JCL5

CA7.JCL6

CA7.JCL7

CA7.EMER.JCL

Execute steps 4-7 on the test OS/390 LPAR when converting CA/7

4. Reload the database to the test LPAR from the production backup file.

Edit CA7.INSTALL(CA7RELD); code the backup cartridge serial number in the VOL=SER JCL parameter.   After editing, SUBMIT the job

TSO option 6

SUB "CA7.INSTALL(CA7RELD)"

5. To reload the queues to the Y2K LPAR from the production VRM file, enter the following command from the master console:

S CA7ONL,TYPE=MOVQ,VDUMP=DUMMY

A VRM data set is not coded in the production CA7ONL procedure, therefore, override the VRM data set name with DUMMY during the conversion only.

If a VRM data set had been coded then, during the reload process, the VRM Dump file is read to determine if any VRM active resource records must be reloaded to match the CA-7 queue records. The VRM active records would have been unloaded during the same DMPQ shutdown process as the queue records. A control record is written to the VRM dump file to ensure that the queue records and the VRM active records are synchronous. Any VRM "active" records found on the VRM database component are deleted prior to reloading the active records found on the VRM dump file.

6. Execute this step only if calendar or security changes have been made to CA-7 production since 06/10/1999

Submit CA7TBLS to assemble/link the current production calender and/or security module.

TSO Option 6:

SUB 'CA7.INSTALL(CA7TBLS)'

If the security module name is changed from SASSSY2K, then also change the SECURITY statement in CA7.JCL1 members BATCH and ONLINE from SECURITY,NAME=SASSSY2K to the name of your security module.

SASSSY2K was modified and assembled for the Y2K LPAR to add contractor userids to the test CA7.SOURCE(SASSSECX) security module.

The following calendars were assembled for the test OS/390 2.4 Y2K LPAR:

TCA99PAY

TCA99ACP

TCA99ACR

TCA99BKU

TCA99MFG

TCA99EST

7. Restore the production JCL libraries by submitting the following job

TSO Option 6:

SUB 'CA7.INSTALL(CA7JOBSL)'

Code the backup cartridge volume serial number in jobstep JSTEP02, SYSUT1 DD statement. If you change the output JCL library data set names, you must also change the JCL statements in CA7.JCLLIB members ONLINE and BATCH.

Because 155 254 200 and 0 could not be respecified, the JCL statements generated with the install were deleted and the following statements were added

JCL,DSN=CA7.HELP,INDEX=255,DYN=2

JCL,DSN=CA7.OVERRIDE,INDEX=254,DYN=2,DSORG=PD

JCL,DSN=CA7.JOBLIB1,INDEX=0,LTERM=MASTER,DYN=2,DSORG=

JCL,DSN=CA7.JOBLIB2,INDEX=1,DYN=2,DSORG=PDS

JCL,DSN=CA7.JOBLIB3,INDEX=3,DYN=2,DSORG=PDS

JCL,DSN=CA7.JCL1,INDEX=200,DYN=2

JCL,DSN=CA7.JCL2,INDEX=2,DYN=2,DSORG=PDS

JCL,DSN=CA7.JCL4,INDEX=4,DYN=2,DSORG=PDS

JCL,DSN=CA7.JCL5,INDEX=5,DYN=2,DSORG=PDS

JCL,DSN=CA7.JCL6,INDEX=6,DYN=2,DSORG=PDS

JCL,DSN=CA7.JCL7,INDEX=7,DYN=2,DSORG=PDS

JCL,DSN=CA7.EMER.JCL,INDEX=8,DYN=2,DSORG=PDS