3. Installation › 3.8 Installation Checklists › 3.8.6 Loading New Products
3.8.6 Loading New Products
************************ BACKGROUND *************************
* *
* The CA MICS tape or ESD PAX file includes code and *
* documentation for all CA MICS products. It also *
* delivers maintenance and enhancements for your licensed *
* CA MICS products as part of the CA MICS Product Support *
* Program (PSP). *
* *
* Use these instructions to install newly licensed CA MICS *
* products into an existing CA MICS complex. Since product *
* installation may need the most current CA MICS *
* maintenance, the installation process will check to *
* ensure that the most recent PSP maintenance has been *
* loaded from the distribution medium. *
* *
* CA LMP keys are required for each product you install. *
* You must ensure that the keys for new products have been *
* installed on each CPU on which the new products will be *
* installed. *
* *
*************************************************************
To load the new product, complete the following steps:
__ 1. Ensure Libraries are Cataloged
Make sure that the following libraries are cataloged.
If they are not, contact Technical Support at
http://ca.com/support.
The libraries are:
sharedprefix.MICS.PSP.CNTL
sharedprefix.MICS.PSP.PC.TEXT
sharedprefix.MICS.PSP.ISPTLIB
sharedprefix.MICS.TAPELOAD.CNTL
__ 2. Ensure Libraries are Not Migrated
Ensure your sharedprefix.MICS and
sharedprefix.MICS.PSP libraries are not migrated.
Their data set names begin with the following
qualifiers:
sharedprefix.MICS (complex libraries)
sharedprefix.MICS.PSP (PSP libraries)
__ 3. Compress Libraries
The code and text for the products on your tape are
copied directly to your sharedprefix.MICS and
sharedprefix.MICS.PSP libraries. To avoid potential
space problems, compress your sharedprefix.MICS and
PSP libraries before loading the new product.
__ 4. Back Up Complex and PSP Libraries
The code and text for the products on the PSP
distribution medium are copied directly to your
sharedprefix.MICS and sharedprefix.MICS.PSP libraries.
To avoid potential space problems, compress your
sharedprefix.MICS and PSP libraries before loading the
new product.
__ 5. Ensure PSP Libraries have been Refreshed
Ensure that your Product Support Program (PSP)
libraries have been previously refreshed from the most
recently available PSP distribution. If not, it would
be best to refresh your PSP libraries before
continuing.
__ 6. Ensure MWF is Initialized
Refer to the "How to Use the PSP" guide for detailed
instructions on initializing the CA MICS Workstation
Facility (MWF) and using PSP Online to apply product
changes.
__ 7. Review the Cover Letter
Review the cover letter and associated product
maintenance letters (PML) for the latest important
technical information.
__ 8. Install LMP Keys for New Products
You are required to obtain and install a CA LMP key
for each CA MICS product. One key is required for
each CPU that the product will be loaded to. Refer to
Section 3.2.2 for more information. If there are
questions about CA LMP keys, contact Technical
Support at http://ca.com/support.
__ 9. Load Optional Products
Optional products can be loaded from either tape or
ESD PAX. There are two ways to load the products,
either via the panel-driven load process or via
pre-existing JCL. Select one of the following
substeps to load the product:
Step 9a. - Panel-driven process that supports tape
and ESD PAX.
Step 9b. - ESDPLD1 - JCL supporting ESD PAX
Step 9c. - PRODLD1 - JCL supporting tape
__ 9a. Load Optional Products Using MWF
This step uses a panel-driven process to generate the
JCL to load your optional products to DASD. It
combines parameters you provide on MWF panels with
parameters that were specified during the
complex-level JCLGEN, and generates the JCL to
load from the PSP distribution data sets.
__ Select the MWF panel called Select New Products and
Submit the Product Load Job (MWF;5;2;3;4).
__ Type the following parameters on the panel:
SR is the new product being loaded. Type the
three-letter code of the new product.
If you are loading more than one new
product, each code must be separated by a
blank.
Note: Only specify your NEW products! If
you specify products that are already
installed, they will be overlayed. This
can critically impact your CA MICS
database.
Use the MWF CONFIG command to help you
determine which CA MICS products are
installed.
From When the incoming PSP distribution files
Tape are on a tape, specify YES. Otherwise,
specify NO or leave this blank. Note that
this option is mutually exclusive with the
"From ESD-DASD" option below.
Tape is the volume serial number of the PSP
VOLSER distribution tape that you want to load.
Tape is the expiration date for a foreign tape
EXPDT if your tape management system requires
one.
Tape is the name of the tape device on which the
UNIT CA MICS distribution tape is to be mounted.
From When the CA MICS distribution files come
ESD- from an ESD PAX file, specify YES.
DASD Otherwise, specify NO or leave this blank.
Note that this option is mutually exclusive
with the "From Tape" option above.
High is the high level data set qualifier(s)
Level that are common to all the incoming PSP
Qualif- distribution files on DASD. It corresponds
ier to "yourHLQ" used in the ESD PAX UNZIPJCL
job.
PSP is the volume serial number of the
VOLSER direct access storage device to be used to
store the new PSP libraries. This will be
used as the default VOLSER for allocation
of new PSP data sets. It can be overridden
for individual data set names by modifying
entries in PSPOVER as described in Appendix
A.1. If the "SMS JCL Tailoring" option
(below) is "YES", this parameter is
ignored.
PSP is the unit name of the direct access
UNIT storage device to be used to store the new
PSP data sets. This will be used as the
default unit for allocation of new PSP data
sets. It can be overridden for individual
data set names by modifying entries in
PSPOVER as described in Appendix A.1. If
the "Omit UNIT & VOL=SER from JCL" option
(below) is YES, this parameter is ignored.
PSP is the SMS STORCLAS to be used to store the
STOR- new PSP data sets. This will be used as
CLAS the default STORCLAS for allocation of new
PSP data sets. It can be overridden for
individual data set names by modifying
entries in PSPOVER as described in Appendix
A.1.
PSP is the SMS DATACLAS to be used to store the
DATA- new PSP data sets. This will be used as
CLAS the default DATACLAS for allocation of new
PSP data sets. It can be overridden for
individual data set names by modifying
entries in PSPOVER as described in Appendix
A.1.
PSP is the SMS MGMTCLAS to be used to store the
MGMT- new PSP data sets. This will be used as
CLAS the default MGMTCLAS for allocation of new
PSP data sets. It can be overridden for
individual data set names by modifying
entries in PSPOVER as described in Appendix
A.1.
PSP can be either blank or LIBRARY. Specify
DSNTYPE LIBRARY to allocate new PSP data sets as
PDSE data sets (partition data sets
extended). It can be overridden for
individual data set names except for the
PSP LOAD library, by modifying entries in
PSPOVER as described in Appendix A.1.
PSP is the disposition of all PSP libraries
DISP except sharedprefix.MICS.PSP.CNTL,
PSP.PC.TEXT, and PSP.ISPTLIB.
Note: If the libraries listed below exist,
specify "OLD,KEEP". If the libraries do
not exist, specify "NEW,CATLG,DELETE".
sharedprefix.MICS.PSP.ASM
sharedprefix.MICS.PSP.BIN
sharedprefix.MICS.PSP.CLIST
sharedprefix.MICS.PSP.DIC.TEXT
sharedprefix.MICS.PSP.DOC.TEXT
sharedprefix.MICS.PSP.GENLIB
sharedprefix.MICS.PSP.INC.TEXT
sharedprefix.MICS.PSP.INCLLIB
sharedprefix.MICS.PSP.ISPHLIB
sharedprefix.MICS.PSP.ISPMLIB
sharedprefix.MICS.PSP.ISPPLIB
sharedprefix.MICS.PSP.ISPSLIB
sharedprefix.MICS.PSP.LOAD
sharedprefix.MICS.PSP.MACAUTOS
sharedprefix.MICS.PSP.MACLIB
sharedprefix.MICS.PSP.OBJ
sharedprefix.MICS.PSP.PARMS
sharedprefix.MICS.PSP.PROTOLIB
sharedprefix.MICS.PSP.SASFLS
sharedprefix.MICS.PSP.SOURCE
sharedprefix.MICS.PSP.USOURCE
If your site does not have its PSP
libraries, new PSP libraries will be
allocated as part of the INSTALL steps.
These PSP libraries will contain all
product changes required to install your
new products. For more information about
the PSP libraries, see "How To Use the
PSP".
PSP is the block size that will be used to
BLOCK- allocate your new PSP data sets.
SIZE
Note: Do not override the default of 6160
unless required by your site.
Loader is the program name of the IBM Loader at
your site. This is typically IEWLDRGO,
HEWLDRGO, or LOADER. If in doubt, contact
your system programmer.
Region is the region for each step. The default
size of 4096 KB should be adequate.
Omit will cause the JCL to be generated without
UNIT & "VOL=SER=" or "UNIT=" parameters in DD
VOL=SER statements for temporary disk data sets or
From for allocating new PSP data sets. If the
JCL System Managed Storage (DFSMS)
implementation at your site requires that
UNIT= and VOL=SER= parameters be omitted,
then specify YES, otherwise, specify NO.
Edit is either YES or NO. If YES, then you will
gener- be given an opportunity to edit the load
ated JCL before it is submitted.
JCL
__ When your parameters are complete, do one of the
following:
__ Press END to continue
OR
__ Type CANCEL and press ENTER to stop the process.
__ If you pressed END and if Edit generated JCL was
YES, then you will see a temporary data set
containing the generated tape load job.
__ Review the JCL and verify that it conforms to
your site's standards. Make a copy of the JCL
in a permanent data set for future reference.
__ Press END to submit the job.
Note: Modules are written to disk by executing the
program named LPEBLDD. It runs as a
"non-authorized" program. Some mainframe security
systems, such as CA Top Secret, have a feature that
restricts non-authorized programs from writing
authorized load modules. (An authorized load module
is link-edited with an attribute of AC(1).) If your
site has this security feature activated and is
licensed for the CA MICS Space Collector (VCC),
then the load job will fail with an S913 ABEND
while trying to write an authorized VCC load
module. To prevent this ABEND, request your
security administrator to permit LPEBLDD to write
authorized load modules.
__ Exit PSP Online. Do this by pressing END until the
CA MICS Administrator Facility panel is displayed.
__ After the job finishes, check the return codes.
All steps must have a return code of zero except
the following:
COMPABND must not execute. It only executes if the
PSP refresh requirement is not met. It will force
the job to ABEND.
PSPCHK2 may be 0 or 4.
#ASCOPY2 and PSPUPDTE must be 0 when PSPCHK2 is 4.
#ASCOPY2 and PSPUPDTE will not execute when PSPCHK2
is 0. This is normal.
Any other return codes are errors. If there is an
error, you must correct it and resubmit the job.
If the error persists, contact Technical Support at
http://ca.com/support.
__ Proceed to Step 10.
__ 9b. Execute ESDPLD1
This step supports loading your optional products to
disk from an ESD PAX file.
***********************************************************
* CAUTION: Do NOT EXECUTE STEP 9b if you have already *
* executed Step 9a or Step 9c. *
***********************************************************
__ Edit sharedprefix.MICS.TAPELOAD.CNTL(ESDPLD1).
Provide a JOB card and complete the following JCL
statements on the LOADPROD EXEC statement.
//***********************************************************
//LOADPROD EXEC LOADPROC, *
//* PARM *
//* ------------------- *
// RSIZE='4096K', <--- REGION FOR ALL STEPS *
// YOURHLQ='_____', <--- MICS ESD PREFIX *
// SPREFIX='_____', <--- MICS SHARED PREFIX *
// SMICS='MICS.', <--- SHARED MICSLEVEL? *
// SASPFX='______', <--- SAS SYSTEM LIBRARY PREFIX *
// SASNAME='entry', <--- SAS for SAS V9 *
//* SASXAL for SAS V8 *
// SASCFG='config', <--<< BATCH IF SAS V8 *
//* BATW0 IF SAS V9 *
// LANG1='', <--<< SAS V9 LANGUAGE *
//* EN = ENGLISH *
//* BLANK IF V8 *
// LANG2='', <--<< SAS V9 ENCODING VALUE *
//* W0. = EBCDIC (1047) *
//* MUST HAVE TRAILING . *
//* BLANK IF V8 *
// PSPVOL=, <--- VOLUME FOR NEW PSP LIBS *
// PSPDSP='_____', <--- PSP LIB DISPOSITION *
// PSPUNIT=, <--- UNIT FOR NEW PSP LIBS *
// PSPSTORC=, <-- OPTIONAL PSP STORCLAS= *
// PSPDATAC=, <-- OPTIONAL PSP DATACLAS= *
// PSPMGMTC=, <-- OPTIONAL PSP MGMTCLAS= *
// PSPDSNT=, <-- OPT., PUT LIBRARY FOR PDSE *
// BLOCK=6160, <--- PSP LIBRARY BLOCKSIZE OK? *
// WKUNIT=SYSDA , <--- IS WORK DASD UNIT OK? *
// SR='___', <--- NEW PRODUCTS. SEPARATE WITH*
//* A BLANK. ENCLOSE WITHIN *
//* APOSTROPHES. *
// LOADER=IEWLDRGO <--- YOUR SITE'S LOADER NAME *
//***********************************************************
You must complete the following parameters on the
LOADPROD EXEC statement, not those on the PROC
statement:
RSIZE is the region for each step. The default of
4 MB should be adequate.
YOURHLQ specifies the high level qualifier of the
ESD PAX data sets. It must be replaced with
the "yourHLQ" used in the ESD PAX UNZIPJCL
job.
SPREFIX is the standard CA MICS sharedprefix. Do
not end the sharedprefix with a period (.).
SMICS is the MICS level for the sharedprefix.MICS
and sharedprefix.MICS.PSP libraries.
Specify this parameter with a trailing
period. If you have specified NOMICSLEVEL
on the sharedprefix statement in the JCLDEFC
member of sharedprefix.MICS.PARMS, you must
change SMICS to null (SMICS=,).
SASPFX specifies the common data set name prefix
for your SAS libraries. Note that this name
is specified with no trailing period. This
prefix is used in the following DDs to form
the names of your site's SAS libraries used
for CA MICS:
STEPLIB - SAS load library
CONFIG - SAS CNTL library that holds a
SAS system configuration file
SASHELP - SAS help library
SASMSG - SAS message library
Review the data set names specified in the
DDs. If they are incorrect, correct the
names and comment out SASPFX.
SASNAME specifies the program name of the SAS
Program Product in the load library
specified in the STEPLIB DD.
SASCFG is the member name of your SAS configuration
file. Normally this is a member of the SAS
CNTL data set. For SAS version 8, the
member name is usually BATCH. For version 9
and above it is usually BATW0.
LANG1 is the language code required with SAS
Versions 9 and higher, for example, EN
stands for English. The value is blank for
SAS Version 8.
LANG2 is the encoding value required with SAS
Version 9 and higher. The value for EBCDIC
is W0 and must have a trailing period (.).
The value is blank for SAS Version 8.
PSPUNIT specify the unit name and volume serial
and number of the direct access storage device
PSPVOL to be used to store the new PSP libraries.
These parameters will be used as default
parameters for allocation of new PSP data
sets. They can be overridden for individual
data set names by modifying entries in
PSPOVER as described in Appendix A.1. If
you do not need to specify a parameter for
PSPUNIT, code it as null (that is,
'PSPUNIT=,'). Likewise, if you do not need
to specify a parameter for PSPVOL, code it
as null (that is, 'PSPVOL=,').
PSP is the SMS STORCLAS to be used to store the
STORC new PSP libraries. This will be used as
the default STORCLAS for allocation of new
PSP data sets. It can be overridden for
individual data set names by modifying
entries in PSPOVER as described in Appendix
A.1. If you do not need to specify a
parameter for PSPSTORC, code it as null
(that is, 'PSPSTORC=,').
PSP is the SMS DATACLAS to be used to store the
DATAC new PSP libraries. This will be used as
the default DATACLAS for allocation of new
PSP data sets. It can be overridden for
individual data set names by modifying
entries in PSPOVER as described in Appendix
A.1. If you do not need to specify a
parameter for PSPDATAC, code it as null
(that is, 'PSPDATAC=,').
PSP is the SMS MGMTCLAS to be used to store the
MGMTC new PSP libraries. This will be used as
the default MGMTCLAS for allocation of new
PSP data sets. It can be overridden for
individual data set names by modifying
entries in PSPOVER as described in Appendix
A.1. If you do not need to specify a
parameter for PSPMGMTC, code it as null
(that is, 'PSPMGMTC=,').
PSP can be either blank or LIBRARY. Specify
DSNT LIBRARY to allocate new PSP data sets as
partitioned data set extended (PDSE) data
sets. It can be overridden for individual
data set names except for the PSP LOAD
library, by modifying entries in PSPOVER
as described in Appendix A.1.
PSPDSP is the disposition of all PSP libraries
except sharedprefix.MICS.PSP.CNTL,
PSP.PC.TEXT, and PSP.ISPTLIB. If the
following libraries exist, use the value
'OLD,KEEP'. If the following libraries do
not exist, use the value 'NEW,CATLG,DELETE'.
Verify that you have the
sharedprefix.MICS.PSP.CNTL, PSP.PC.TEXT, and
PSP.ISPTLIB libraries already allocated.
sharedprefix.MICS.PSP.ASM
sharedprefix.MICS.PSP.BIN
sharedprefix.MICS.PSP.CLIST
sharedprefix.MICS.PSP.DIC.TEXT
sharedprefix.MICS.PSP.DOC.TEXT
sharedprefix.MICS.PSP.GENLIB
sharedprefix.MICS.PSP.INC.TEXT
sharedprefix.MICS.PSP.INCLLIB
sharedprefix.MICS.PSP.ISPHLIB
sharedprefix.MICS.PSP.ISPMLIB
sharedprefix.MICS.PSP.ISPPLIB
sharedprefix.MICS.PSP.ISPSLIB
sharedprefix.MICS.PSP.LOAD
sharedprefix.MICS.PSP.MACAUTOS
sharedprefix.MICS.PSP.MACLIB
sharedprefix.MICS.PSP.OBJ
sharedprefix.MICS.PSP.PARMS
sharedprefix.MICS.PSP.PROTOLIB
sharedprefix.MICS.PSP.SASFLS
sharedprefix.MICS.PSP.SOURCE
sharedprefix.MICS.PSP.USOURCE
WKUNIT specifies the unit name for a direct access
work device.
BLOCK is the block size value used for the new PSP
libraries. Do not override the default of
6160 unless required by your site.
SR is the three-letter code for the new product
being loaded.
If you are loading more than one new
product, each code must be separated by a
blank.
Note: Only specify your NEW products! If
you specify products that are already
installed, they will be overlayed. This can
critically impact your CA MICS database.
Use the MWF CONFIG command to help you
determine which CA MICS products are
installed.
LOADER specifies the program name of the IBM
Loader at your site. This is typically
IEWLDRGO, HEWLDRGO, or LOADER. If in doubt,
contact your system programmer.
__ Submit 'sharedprefix.MICS.TAPELOAD.CNTL(ESDPLD1)'.
Note: Modules are written to disk by executing the
program named LPEBLDD. It runs as a
"non-authorized" program. Some mainframe security
systems, such as CA Top Secret, have a feature that
restricts non-authorized programs from writing
authorized load modules. (An authorized load
module is link-edited with an attribute of AC(1)).
If your site has this security feature activated
and is licensed for the CA MICS Space Collector
(VCC), then the load job will fail with an S913
ABEND while trying to write an authorized VCC load
module. To prevent this ABEND, request your
security administrator to permit LPEBLDD to write
authorized load modules.
__ After the job finishes, check the return codes.
All steps must have return codes of zero except the
following:
COMPABND must not execute. If it does execute, the
PSP refresh level requirement has not been met and
it will force the job to ABEND.
PSPCHK2 may be 0 or 4.
#ASCOPY2 and PSPUPDTE must be 0 if PSPCHK2 is 4.
#ASCOPY2 and PSPUPDTE will not execute if PSPCHK2
is 0. This is normal.
Any other return codes are errors. If there is an
error, you must correct it and resubmit the job.
If the error persists, contact Technical Support at
http://ca.com/support.
__ Proceed to Step 10.
__ 9c. Execute PRODLD1
This step supports loading your optional products to
disk from a magnetic tape.
***********************************************************
* CAUTION: Do NOT EXECUTE STEP 9c if you have already *
* completed step 9a or Step 9b. *
***********************************************************
__ Edit sharedprefix.MICS.TAPELOAD.CNTL(PRODLD1).
Provide a JOB card and complete the following JCL
statements on the LOADPROD EXEC statement.
//***********************************************************
//LOADPROD EXEC LOADPROC, *
//* PARM *
//* -------------- *
// RSIZE='4096K', <--- REGION FOR ALL STEPS *
// SPREFIX='______________', <--- MICS SHARED PREFIX *
// SMICS='MICS.', <--- SHARED MICSLEVEL? *
// TUNIT='____', <--- IS TAPE UNIT OK? *
// TEXPDT=98000, <--- IS TAPE EXPDT OK? *
// TVOL=______, <--- TAPE VOLSER *
// SASPFX='_______________', <--- SAS SYSTEM LIBRARY PREFIX*
// SASNAME=SASXAL, <--- SAS PROGRAM NAME *
// SASCFG='config', <--<< BATCH IF SAS V8 *
//* BATW0 IF SAS V9 *
// LANG1='', <--<< SAS V9 LANGUAGE *
//* EN = ENGLISH *
//* BLANK IF V8 *
// LANG2='', <--<< SAS V9 ENCODING VALUE *
//* W0. = EBCDIC (1047) *
//* MUST HAVE TRAILING . *
//* BLANK IF V8 *
// PSPVOL=, <--- VOLUME FOR NEW PSP LIBS *
// PSPDSP='________', <--- PSP LIB DISPOSITION *
// PSPUNIT=, <--- UNIT FOR NEW PSP LIBS *
// PSPSTORC=, <-- OPTIONAL PSP STORCLAS= *
// PSPDATAC=, <-- OPTIONAL PSP DATACLAS= *
// PSPMGMTC=, <-- OPTIONAL PSP MGMTCLAS= *
// PSPDSNT=, <-- OPT, PUT LIBRARY for PDSE*
// BLOCK=6160, <--- PSP LIBRARY BLOCKSIZE OK?*
// WKUNIT=SYSDA, <--- IS WORK DASD UNIT OK? *
// SR='___', <--- NEW PRODUCTS.SEPARATE *
//* WITH A BLANK. ENCLOSE *
//* WITHIN APOSTROPHES. *
// LOADER=IEWLDRGO <--- YOUR SITE'S LOADER NAME *
//***********************************************************
You must complete the following parameters on the
LOADPROD EXEC statement, not those on the PROC
statement:
RSIZE is the amount of region storage for steps
in this job.
SPREFIX is the sharedprefix for the shared CA MICS
and PSP libraries. Note that this is
specified with no trailing period (for
example, DB1.SP rather than DB1.SP.).
SMICS is the MICS level for the
sharedprefix.MICS and
sharedprefix.MICS.PSP libraries. Specify
this parameter with a trailing period. If
you have specified NOMICSLEVEL on the
sharedprefix statement in the JCLDEFC
member of sharedprefix.MICS.PARMS, you
must change SMICS to null (SMICS=,).
TUNIT is the unit name of the tape device on
which the CA MICS distribution tape is to
be mounted.
TEXPDT is the tape expiration date, if your
site uses a tape management system.
TVOL is the volume serial number of the CA MICS
distribution tape as it appears on the "CA
MICS Encryption Parameters."
SASPFX is the common data set name prefix for
your SAS libraries. Note that this name
is specified with no trailing period.
This prefix is used in the following DDs
to form the names of your site's SAS
libraries for CA MICS:
STEPLIB - SAS load library
CONFIG - SAS CNTL library that holds a
SAS system configuration file
SASHELP - SAS help library
SASMSG - SAS message library
Review the data set names specified in the
DDs. If they are incorrect, correct the
names and comment out SASPFX.
SASNAME is the program name of the SAS Program
Product in the load library specified in
the STEPLIB DD.
SASCFG is the member name of your SAS
configuration file. Normally this is a
member of the SAS CNTL data set. For SAS
Versions 7 and 8, the member name is
usually BATCH and BATW0 for Versions 9 and
above.
LANG1 is the language code required with SAS
Versions 9 and higher, for example, EN
stands for English. The value is blank for
SAS Version 8.
LANG2 is the encoding value required with SAS
Version 9 and higher. The value for
EBCDIC is W0 and must have a trailing
period (.). The value is blank for Sas
Version 8.
PSPVOL is the name of the DASD volume where the
new PSP libraries will be located. If
they already exist, code this parameter as
null (that is, PSPVOL=,).
PSPDSP is the disposition of all PSP libraries
except sharedprefix.MICS.PSP.CNTL,
PSP.PC.TEXT, and PSP.ISPTLIB. If the
following libraries exist, use the value
'OLD,KEEP'. If the following libraries do
not exist, use the value
'NEW,CATLG,DELETE'. Verify that you have
the sharedprefix.MICS.PSP.CNTL,
PSP.PC.TEXT, and PSP.ISPTLIB libraries
already allocated.
sharedprefix.MICS.PSP.ASM
sharedprefix.MICS.PSP.BIN
sharedprefix.MICS.PSP.CLIST
sharedprefix.MICS.PSP.DIC.TEXT
sharedprefix.MICS.PSP.DOC.TEXT
sharedprefix.MICS.PSP.GENLIB
sharedprefix.MICS.PSP.INC.TEXT
sharedprefix.MICS.PSP.INCLLIB
sharedprefix.MICS.PSP.ISPHLIB
sharedprefix.MICS.PSP.ISPMLIB
sharedprefix.MICS.PSP.ISPPLIB
sharedprefix.MICS.PSP.ISPSLIB
sharedprefix.MICS.PSP.LOAD
sharedprefix.MICS.PSP.MACAUTOS
sharedprefix.MICS.PSP.MACLIB
sharedprefix.MICS.PSP.OBJ
sharedprefix.MICS.PSP.PARMS
sharedprefix.MICS.PSP.PROTOLIB
sharedprefix.MICS.PSP.SASFLS
sharedprefix.MICS.PSP.SOURCE
sharedprefix.MICS.PSP.USOURCE
PSPUNIT is the unit name of the DASD volumes where
the new PSP libraries will be located. If
PSP libraries already exist, code this
parameter as null (that is, PSPUNIT=,).
PSP is the SMS STORCLAS to be used to store
STORC the new PSP libraries. This will be used
as the default STORCLAS for allocation of
new PSP data sets. It can be overridden
for individual data set names by modifying
entries in PSPOVER as described in
Appendix A.1. If you do not need to
specify a parameter for PSPSTORC, code it
as null (that is, 'PSPSTORC=,').
PSP is the SMS DATACLAS to be used to store
DATAC the new PSP libraries. This will be used
as the default DATACLAS for allocation of
new PSP data sets. It can be overridden
for individual data set names by modifying
entries in PSPOVER as described in
Appendix A.1. If you do not need to
specify a parameter for PSPDATAC, code it
as null (that is, 'PSPDATAC=,').
PSP is the SMS MGMTCLAS to be used to store
MGMTC the new PSP libraries. This will be used
as the default MGMTCLAS for allocation of
new PSP data sets. It can be overridden
for individual data set names by modifying
entries in PSPOVER as described in
Appendix A.1. If you do not need to
specify a parameter for PSPMGMTC, code it
as null (that is, 'PSPMGMTC=,').
PSPDSNT can be either blank or LIBRARY. Specify
LIBRARY to allocate new PSP data sets as
partitioned data set extended (PDSE) data
sets. It can be overridden for individual
data set names except for the PSP LOAD
library, by modifying entries in PSPOVER
as described in Appendix A.1.
BLOCK is the block size value used for the new
PSP libraries.
WKUNIT is the unit name for a direct access work
device.
SR is the three-letter code for the new
product being loaded.
If you are loading more than one new
product, each code must be separated by a
blank.
Note: Only specify your NEW products! If
you specify products that are already
installed, they will be overlayed! This
can critically impact your CA MICS
database.
Use the MWF CONFIG command to help you
determine installed CA MICS products.
LOADER is the program name of the IBM Loader at
your site. This is typically IEWLDRGO,
HEWLDRGO, or LOADER. If in doubt, contact
your system programmer.
__ Submit the following job:
'sharedprefix.MICS.TAPELOAD.CNTL(PRODLD1)'
Note: Modules are written to disk by executing the
program named LPEBLDD. It runs as a
"non-authorized" program. Some mainframe security
systems, such as CA Top Secret, have a feature that
restricts non-authorized programs from writing
authorized load modules. (An authorized load module
is link-edited with an attribute of AC(1)). If your
site has this security feature activated and is
licensed for the CA MICS Space Collector (VCC),
then the load job will fail with an S913 ABEND
while trying to write an authorized VCC load
module. To prevent this ABEND, request your
security administrator to permit LPEBLDD to write
authorized load modules.
__ After the job finishes, check the return codes.
All steps must have return codes of zero except the
following:
COMPABND must not execute. If it does execute, the
PSP refresh level requirement has not been met and
it will force the job to ABEND.
PSPCHK2 may be 0 or 4.
#ASCOPY2 and PSPUPDTE must be 0 if PSPCHK2 is 4.
#ASCOPY2 and PSPUPDTE will not execute if PSPCHK2
is 0. This is normal.
Any other return codes are errors. If there is an
error, you must correct it and resubmit the job.
If the error persists, contact Technical Support at
http://ca.com/support.
__ Proceed to the next step.
__ 10. Receive New Tables
NOTE: This step is ESSENTIAL for product installation!
Use PSP Online to receive new product tables. Select
the Product Support Online Services panel (MWF;5;2).
The Receive New PSP Tables dialog will be displayed.
Respond to the prompts to ensure that the tables are
received and saved.
__ 11. Complete Optional Product Installation
Note: This step is ESSENTIAL for product installation.
Use PSP Online to complete product installation.
The ccc0000 job, which you are about to execute, helps
ensure that required product maintenance is applied.
It also copies product parameters, account routines,
and MICF inquiries to their required libraries. This
must be done for the product to execute correctly.
Use PSP Online to select and print product change
ccc0000 (where "ccc" is the three-character identifier
listed in your new product shipment letter).
Note: When the ccc0000 product change is selected, all
unapplied prerequisite and corequisite product changes
will be selected as well. You must ALSO print the
checklists for these product changes.
If you are reinstalling an optional product and
ccc0000 does not appear on the Select Product Changes
for Apply panel in PSP Online, perform the following
steps to select the product change:
__ Type "X ccc0000" on the command line and press
ENTER.
__ Type "R" on the line next to ccc0000 and press
ENTER.
__ Type "S" on the line next to ccc0000 and press
ENTER.
__ If you experience difficulty with this process,
contact Technical Support.
Note: Review all PC text documents for requisite
product changes and for possible local
modification conflicts before applying any
product changes.
Apply the product change. You must ensure that
the ccc0000 installation job ends with a
condition code of zero.
For assistance, contact Technical Support at
http://ca.com/support.
__ 12. Complete Checklists for Each Optional Product
You must ensure that ALL checklists, including those
used for the optional product's installation and its
prerequisite and corequisite product changes, are
completed in the following order:
__ Each prerequisite product change
__ The ccc0000 product change
__ Each corequisite product change
__ 13. Back Up System
Create a backup copy of all sharedprefix and prefix
libraries.
__ 14. Retain Distribution Tape
Retain your CA MICS distribution files. They may be
used to install other CA MICS optional products.
