5. Maintenance › 5.4 Convert CA MICS to a New SAS Version › 5.4.2 Converting to a New SAS Version Checklist
5.4.2 Converting to a New SAS Version Checklist
*************************************************************
* *
* WARNING! This procedure converts your entire CA MICS *
* complex and all database units to a new version *
* of SAS. You CANNOT operate your CA MICS *
* complex with mixed versions of SAS. *
* *
* If you are using CA MICS Query and Reporting, *
* (Q&R) you must execute a separate instance of *
* the CA MICS Mainframe Server for each unique *
* SAS Version. *
* *
* This procedure is designed to convert your *
* CA MICS environment to SAS Version 9.1.3 or *
* higher. *
* *
* If you have any questions or concerns, contact *
* Technical Support before beginning this *
* procedure. *
* *
*************************************************************
This section provides a procedure for updating CA MICS when
you upgrade to a new SAS version. This procedure must be
completed even if your SAS System Library names are the same
as your previous SAS System Library names.
*************************************************************
* *
* NOTE: This procedure only applies to a new SAS version, *
* for example, for upgrading from SAS Version 8 to *
* SAS 9.1.3, or from SAS 9.1.3 to SAS 9.2. *
* *
* Do NOT use this procedure to upgrade to a new *
* maintenance release of your SAS system, for *
* example, upgrading from SAS 9.1.3 TS-1 to TS-2. *
* For such maintenance upgrades, see section 5.3. *
* *
*************************************************************
__ 1. (CONDITIONAL) Stop the Q&R Mainframe Server
If you are using the CA MICS Q&R Mainframe Server
with this complex, you must stop the server.
See the CA MICS Q&R Workstation Administration
Guide for general information about stopping the
Q&R Mainframe Server.
__ 2. Apply CA MICS Product Changes
Apply the CA MICS product changes that provide support
for the new SAS version.
For assistance, contact Technical Support.
__ 3. Back up Existing CA MICS SAS Libraries
Back up your existing CA MICS SAS libraries. If you
plan to use the same libraries for the new SAS version
that you use for the current SAS version, we recommend
that you make a backup copy of your current SAS
libraries before proceeding.
__ 4. (OPTIONAL) Create CA MICS SAS Libraries
Create CA MICS SAS libraries. You can reference your
site SAS libraries, and skip this step.
+----------------------------------------------------+
| Reference(s): Section 3.3.1 (SAS Libraries) |
+----------------------------------------------------+
Modify the sample job shown below to populate the
CA MICS SAS libraries from your new SAS installation
libraries by doing the following:
__ If you are using SAS 9.2 or above, use the ISASCNTL
and OSASCNTL DD statements with the CONFIG data set
by uncommenting them and commenting the ones with
the CNTL data set.
__ Change sasprefix to the data set qualifier of the
new SAS libraries.
Note that with SAS 9.1.3 or above, sasprefix may
include language and encoding abbreviation (e.g. W0
and ENW0).
__ Change micssasprefix to the data set qualifiers
that are valid for your CA MICS installation.
__ Add a JOB statement to the JCL and any installation
specific JCL.
//COPY1 EXEC PGM=IEBCOPY,REGION=2M
//SYSPRINT DD SYSOUT=*
//SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(1,1))
//SYSUT2 DD UNIT=SYSDA,SPACE=(CYL,(1,1))
//ISASAUTO DD DISP=SHR,DSN=sasprefix.AUTOLIB
//ISASCNTL DD DISP=SHR,DSN=sasprefix.CNTL
//*ISASCNTL DD DISP=SHR,DSN=sasprefix.CONFIG
//ISASLIB DD DISP=SHR,DSN=sasprefix.LIBRARY
//ISASMSG DD DISP=SHR,DSN=sasprefix.SASMSG
//*
//OSASAUTO DD DISP=OLD,DSN=micssasprefix.AUTOLIB
//OSASCNTL DD DISP=OLD,DSN=micssasprefix.CNTL
//*OSASCNTL DD DISP=OLD,DSN=micssasprefix.CONFIG
//OSASLIB DD DISP=OLD,DSN=micssasprefix.LIBRARY
//OSASMSG DD DISP=OLD,DSN=micssasprefix.SASMSG
//SYSIN DD *
COPY INDD=((ISASCNTL,R)),OUTDD=OSASCNTL
COPY INDD=((ISASLIB,R)),OUTDD=OSASLIB
COPY INDD=((ISASMSG,R)),OUTDD=OSASMSG
COPY INDD=((ISASAUTO,R)),OUTDD=OSASAUTO
/*
//COPY2 EXEC PGM=IEBGENER,REGION=1M
//SYSPRINT DD SYSOUT=*
//SYSUT1 DD DISP=SHR,DSN=sasprefix.SASHELP
//SYSUT2 DD DISP=OLD,DSN=micssasprefix.SASHELP
//SYSIN DD DUMMY
__ Submit the job and ensure that it finishes with a
return code of 0.
__ 5. (CONDITIONAL) Conversion to SAS 9.1.3 ONLY
If you are converting to SAS 9.1.3, the SAS Autocall
library (sasprefix.W0.AUTOLIB) must be converted to a
fixed block data set to address issues documented in
SAS Usage Note SN-013990. Review this SAS Usage Note
before proceeding with the rest of this conversion
checklist.
This data set should be used only for CA MICS, and is
only necessary for SAS 9.1.3. The fixed-block version
of the SAS Autocall library must be created with an
LRECL of 80 and a BLKSIZE that is a multiple of 80.
Note that standard IBM utilities, such as IEBCOPY,
will not copy variable blocked data sets to fixed
block.
The following is a sample job using the SAS provided
VBGT72 macro, referenced in SN-013990 to copy the SAS
Autocall library. VBGT72 must be downloaded from the
SAS institute support site before it can be used. In
this example, VBGT72 was downloaded and then saved
as member VBGT72 in sasprefix.VBGT72.LIBRARY:
// ....JOB....
//VBGT72 EXEC SAS
//VBGT72 DD DISP=SHR,DSN=sasprefix.VBGT72.LIBRARY
//ISASAUTO DD DISP=SHR,DSN=sasprefix.W0.AUTOLIB
//AUTOOUT DD DISP=(NEW,CATLG,DELETE),
// DSN=micssasprefix.FB.W0.AUTOLIB,
// UNIT=unit,VOL=SER=volume,
// DCB=(LRECL=80,RECFM=FB,BLKSIZE=6160),
// SPACE=(CYL,(1,1,45))
//SYSIN DD *
%INCLUDE VBGT72(VBGT72);
%VBGT72(indd=ISASAUTO);
//
The JCL will need to be modified before submission to
suit your site requirements.
Alternatively, the copy utility provided with ISPF
(Option 3.3) can be used.
*************************************************************
* *
* NOTE: If you are upgrading from SAS Version 8 to *
* SAS 9.1.3 or above, make sure all CA MICS *
* production jobs are completed at this point *
* and do not run until this checklist is finished. *
* In particular, if you enabled incremental update *
* for one or more products in any of the unit *
* databases, make sure the final DAILY job was run. *
* *
*************************************************************
__ 6. Execute MICSLS1
Activate the LOAD and PARMS libraries' version-
dependent modules for the SAS version in use and
convert the sharedprefix.MICS.MCOLIB library to the
new version of SAS.
Upon successful completion of this job, your previous
SAS sharedprefix.MICS.MCOLIB library will be renamed
to sharedprefix.MICS.MCOLIB.SASOLD.
__ Edit sharedprefix.MICS.CNTL(MICSLS1) and fill in
the parameters on the EXEC statement. Do not enter
parameters on the PROC statement.
******************************************************
* NOTE: For SAS 9.1.3 only, override the PROC *
* variable AUTOLIB to point to the fixed block *
* version of the SAS Autocall library created *
* in a previous step. *
* *
* If you are running SAS Version 8 or above, the *
* MICSLS1 job dynamically allocates the new *
* sharedprefix.MICS.MCOLIB data set using the *
* allocation parameters of the existing *
* sharedprefix.MICS.MCOLIB data set. If you *
* encounter problems with this allocation, for *
* example, due to site-specific allocation *
* and/or security requirements, you can uncomment *
* the NEWSASX DD of the COPYMCO step and define it *
* according to your requirements. *
******************************************************
__ Submit the following job.
'sharedprefix.MICS.CNTL(MICSLS1)'
+-------------------------------------------------+
| Reference(s): Section 3.2.5 |
+-------------------------------------------------+
All job steps must complete with a condition code
of zero.
If the job fails for some reason in the COPYMCO
step, after allocating the new
sharedprefix.MICS.MCOLIB.SAS9 library or in the
RENAME step; you must delete
sharedprefix.MICS.MCOLIB.SASOLD and/or
sharedprefix.MICS.MCOLIB.SAS9 before resubmitting
the above job.
__ 7. Edit JCLDEFC
Edit sharedprefix.MICS.PARMS(JCLDEFC) and update the
following parameters with information that is
applicable to the new SAS version and library names.
Note that SAS version 9.2 and above require multiple
SASCONFIGx parameters to be specified.
SASAUTOS SASCONFIGx SASHELP SASLIB
SASMSG SASNAME SASVER
+----------------------------------------------------+
|Reference(s): Section 2.3.1.6.2 (Complex Lib Def's))|
+----------------------------------------------------+
__ 8. Edit JCLGEN0
Edit sharedprefix.MICS.CNTL(JCLGEN0), changing the
parameters on the EXEC statement for the MICSDM
in-stream cataloged procedure to reflect the MICS/SAS
library names. See section 3.3.2 for a
description of the parameters.
__ 9. Execute JCLGEN0
Submit the following job:
'sharedprefix.MICS.CNTL(JCLGEN0)'
__ 10. Execute PROCJOB1
The following JCL procedures changed:
MICSCOM MICSDM MICSDOC MICSDOCH MICSGT MICSGU
MICSRPTS MICSSVR MICSASM
Move them to your CA MICS PROCLIB by submitting the
following job:
'sharedprefix.MICS.CNTL(PROCJOB1)'
If you maintain PROCs in a production PROCLIB, copy
the regenerated procedures listed above to your
production PROCLIB.
__ 11. Execute MDBGEN
Generate the meta database by submitting the following
job:
'sharedprefix.MICS.CNTL(MDBGEN)'
__ 12. (CONDITIONAL) Execute JCLGEN1
Perform this step only if the CA MICS Accounting and
Chargeback Option product is installed.
Submit the following job:
'sharedprefix.MICS.CNTL(JCLGEN1)'
__ 13. Execute MICSCNVT
Convert your CA MICS SAS libraries to the new SAS
version.
NOTE: This step is not necessary when upgrading from
SAS version 9.1.3 to 9.2.
You can run this job to convert complex-level
SAS libraries to the new SAS version. You may
or may not be using these libraries at your
installation.
(Optional) sharedprefix.MICS.SCREENS
(Optional) sharedprefix.MICS.MWFSAS.DATA
(Optional) sharedprefix.MICS.CAPACITY
(Optional) sharedprefix.MICS.CIMANAGE
(Optional) sharedprefix.MICS.TABLES
Upon successful completion of this job, your original
SAS library will be renamed to
any.data.set.name.SASOLD, where any.data.set.name
refers to any of the data sets listed above.
__ Edit sharedprefix.MICS.CNTL(MICSCNVT) and fill in
the parameters on the EXEC statement. Do not enter
parameters on the PROC statement. The DATASET=
parameter specifies the fully qualified data set
name of the data set to be converted.
If you are running SAS Version 8, 9, or above, the
MICSCNVT job dynamically allocates the new
any.data.set.name data set using the allocation
parameters of the existing any.data.set.name data
set. If you encounter problems with this
allocation, for example, due to site-specific
allocation and/or security requirements, you can
uncomment the NEWSASX DD of the COPYMCO step and
define it according to your requirements.
__ Submit the following job:
'sharedprefix.MICS.CNTL(MICSCNVT)'
+----------------------------------------------------+
| Reference(s): Section 3.2.5 |
+----------------------------------------------------+
All job steps must complete with a condition code of
zero. However, there is a potential to get a return
code of U0999 with the following error message:
ERROR: Cannot open data library DDIN because it is
uninitialized.
The above error is caused by attempting to convert an
empty data set.
If the MICSCNVT job fails in the COPYMCO step, after
allocating the new any.data.set.name.sas9 library, or
in the RENAME step, you must delete
any.data.set.name.SASOLD and/or any.data.set.name.SAS9
before resubmitting the above job.
*************************************************************
* Repeat Steps 14 through 26 for each database unit. *
*************************************************************
__ 14. Suspend Production Operations
NOTE: If you are upgrading from SAS Version 8 to
9.1.3 or above and you enabled incremental
update for one or more products in any of the unit
databases, make sure the final DAILY job was run.
Suspend production operations for the unit database by
using the Operational Status and Tracking SUSPEND
command in MWF to deactivate production scheduling.
__ 15. Execute MICSCNVT
Convert the prefix.MICS.MUOLIB formats library.
NOTE: This step is not necessary when upgrading from
SAS version 9.1.3 to 9.2.
Upon successful completion of this job, your OLD SAS
formats library will be renamed to
prefix.MICS.MUOLIB.SASOLD.
__ Edit sharedprefix.MICS.CNTL(MICSCNVT) and fill in
the parameters on the EXEC statement. Do not enter
parameters on the PROC statement. The DATASET=
parameter specifies the fully qualified data set
name of your prefix.MICS.MUOLIB data set to be
converted.
If you are running SAS Version 8, 9 or above, the
MICSCNVT job dynamically allocates the new
any.data.set.name data set using the allocation
parameters of the existing prefix.MICS.MUOLIB data
set. If you encounter problems with this
allocation, for example, due to site-specific
allocation and/or security requirements, you can
uncomment the NEWSASX DD of the COPYMCO step and
define it according to your requirements.
__ Submit the following job:
'sharedprefix.MICS.CNTL(MICSCNVT)'
+--------------------------------------------------+
| Reference(s): Section 3.2.5 |
+--------------------------------------------------+
All job steps must complete with a condition code of
zero.
If the job fails for some reason in the COPYMCO
step, after allocating the new
prefix.MICS.MUOLIB.SAS9 library or in the RENAME
step, then you must delete the
prefix.MICS.MUOLIB.SASOLD and/or the
prefix.MICS.MUOLIB.SAS9 library before resubmitting
the above job.
__ 16. Edit JCLDEF
Edit prefix.MICS.PARMS(JCLDEF) and update the
following parameters with information that is
applicable to the new SAS version or library name:
Note that SAS version 9.2 and above require multiple
SASCONFIGx parameters to be specified.
SASAUTOS SASCONFIGx SASHELP SASLIB
SASMSG SASNAME SASVER
NOTE: If you are taking advantage of JCLGEN parameter
sharing, then these parameters might not be specified
in prefix.MICS.PARMS(JCLDEF).
+---------------------------------------------------+
|Reference(s): Section 2.3.3.2 (Complex Lib Def's)) |
| Section 2.3.1.6.7 (Parameter Sharing)|
+---------------------------------------------------+
__ 17. Copy JCLGENA
Copy sharedprefix.MICS.CNTL(JCLGENA) to
prefix.MICS.CNTL(JCLGENA).
__ 18. Edit JCLGENA
Edit prefix.MICS.CNTL(JCLGENA) to point to the correct
complex-level and unit-level data sets.
__ 19. Execute JCLGENA
Regenerate the CNTL members by submitting the
following job:
'prefix.MICS.CNTL(JCLGENA)'
__ 20. Execute PROCJOB2
The following JCL procedures changed:
MICSDUx MICSNDBx
Move them to your CA MICS PROCLIB by submitting the
following job:
'prefix.MICS.CNTL(PROCJOB2)'
If you maintain PROCs in a production PROCLIB, copy
the regenerated procedures listed above to your
production PROCLIB.
__ 21. Execute JCLGENC
Regenerate the CNTL members by submitting the
following job:
'prefix.MICS.CNTL(JCLGENC)'
__ 22. Execute PROCJOB3
The following JCL procedures changed:
MICSDBx MICSSHRx
Move them to your CA MICS PROCLIB by submitting the
following job:
'prefix.MICS.CNTL(PROCJOB3)'
If you maintain PROCs in a production PROCLIB, copy
the regenerated procedures listed above to your
production PROCLIB.
__ 23. Execute JCLGEND
Submit the following job:
'prefix.MICS.CNTL(JCLGEND)'
__ 24. Execute BASPGEN
Submit the following job:
'prefix.MICS.CNTL(BASPGEN)'
__ 25. (Optional) Convert Database Files
Convert Database Files - DETAIL DAYS WEEKS MONTHS
YEARS
NOTE: This step is not necessary when upgrading from
SAS version 9.1.3 to 9.2.
NOTE: You may want to wait to convert your CA MICS
database files to the new version of SAS until all
CA MICS users have converted their job streams.
__ Submit the following job to back up all your unit-
level database files.
'prefix.MICS.CNTL(BACKUP)'
__ Delete all your unit-level database files.
__ (CONDITIONAL) If you enabled incremental update for
one or more products in this unit database, then
delete the incremental update database and
checkpoint files.
prefix.MICS.ccc.IUCKPT
prefix.MICS.ccc.IUDETAIL
prefix.MICS.ccc.IUDAYS
__ Submit the following job to allocate all your unit-
level database files.
'prefix.MICS.CNTL(ALLOCATE)'
__ (CONDITIONAL) If you enabled incremental update for
one or more products in this unit database, then
submit the following job to allocate and initialize
the incremental update database and checkpoint
files:
'prefix.MICS.CNTL(cccIUALC)'
__ Submit the following job to restore your backed-up
database files:
'prefix.MICS.CNTL(RESTORE)'
__ 26. Resume Daily Operations
*************************************************************
* Repeat Steps 14 through 26 for each database unit. *
*************************************************************
__ 27. (CONDITIONAL) Start the Q&R Mainframe Server
If you are using the CA MICS Q&R Mainframe Server
with this complex, restart the server.
__ 28. (CONDITIONAL) Review References to MWF CLIST
If the name of the CA MICS SAS load library has
changed, review the reference that discusses the
CA MICS Workstation Facility (MWF) startup CLIST.
+----------------------------------------------------+
| Reference(s): Section 3.3.6.2 |
+----------------------------------------------------+
__ 29. Review Instructions on Updating MWF
Review the instructions on updating MWF with the new
SAS version's parameter and data set name information.
NOTE: It is critical that you specify the correct SAS
version on the SAS Global Parameters for ISPF
Applications (MWF;5;0;3) panel.
+----------------------------------------------------+
| Reference(s): Section 4.4.2.3 |
+----------------------------------------------------+
__ 30. Execute MICSCPVT
Inform all your MICF users to convert their private
SAS catalogs by following the instructions given
below.
NOTE: This step is not necessary when upgrading from
SAS version 9.1.3 to 9.2.
Each MICF user may have one or more of the following
private SAS catalogs to be converted.
(Optional) userid.MICS6.USER.DATA
(Optional) userid.MICS6.USER.SAS.PROFILE
(Optional) userid.MICS6.USER.CAPACITY
NOTE: You will need to make the
sharedprefix.MICS.CNTL(MICSCPVT) job stream available
to your users so that they can execute it to convert
their private SAS catalogs.
Upon successful completion of this job, the original
SAS catalogs will be renamed by adding a .SASOLD
suffix to the original data set name.
__ Edit sharedprefix.MICS.CNTL(MICSCPVT) and,
optionally, fill in the values for SAS macro
variables USERID and PREFIX following the //SYSIN
DD statement in the first job step, BLDEXEC.
o If you leave the USERID parameter blank, the
userid associated with the batch job will be
used to construct the user data set names. The
default data set names are like the following:
&USERID..MICS.USER.TABLES
o If you specify the PREFIX parameter, this value
will appear in front of the USERID in generated
data set names. For example:
&PREFIX..&USERID..MICS.USER.TABLES
The job dynamically allocates the user's new
private data sets and copies the original
private data sets to them. If you encounter
problems with this allocation, for example, due
to site-specific allocation and/or security
requirements, you can uncomment the NEWSASX DD
of the COPYPVT step and define it according to
your requirements.
__ Submit the following job:
'sharedprefix.MICS.CNTL(MICSCPVT)'
+--------------------------------------------------+
| Reference(s): Section 3.2.5 |
+--------------------------------------------------+
All job steps except the COPYPVT step must complete
with a condition code of zero. The COPYPVT step may
complete with a condition code of zero or 4.
If the job fails for some reason in the COPYPVT
step, after allocating the new private data sets,
or in the RENAME step; you must delete the new
private data sets before resubmitting the above
job.