Appendix A. SETTING OPTIONAL PARAMETERS › A.1 Overriding Dynamic Allocation Parameters
A.1 Overriding Dynamic Allocation Parameters
The standard PSP refresh job automatically estimates space
and directory blocks required for PSP data sets. It compares
the allocated space and directory blocks of existing PSP data
sets to the required amounts. If either is insufficient, the
data set is marked for deletion and a report is produced in
the PSPLOG.
o If the JCL parameter MODE is set to RPT, the refresh job
will end with an abend code of U0100.
o If MODE is set to DASD, the refresh job will delete
unsuitable PSP data sets and will allocate all required PSP
data sets.
The data set names for this process are determined using the
default &SPREFIX..&SMICS (provided in JCL) as the high-level
qualifier followed by the standard PSP data set names that
are identified in Figure A-1. If you do not want to use the
standard PSP data set names, you may override them as
described below. The overridden data set names will be used
to search for existing PSP data sets and to allocate new data
sets, if required.
CAUTION: You should change PSP data set names only if
absolutely necessary. If you change names, you must
ensure that the PSP data sets named in the
batch-driven refresh job are manually modified to
reflect the overridden data set names.
You must also ensure that the corresponding data set
names are changed in the PSP Online panel, Define
the PSP Libraries (MWF Option 5;2;3;1). See Figure
A-2 for the correlation between the PSP installation
ddnames and the PSP Online ddnames.
You can also override a limited number of parameters used in
the allocation of new PSP data sets. These parameters will
be ignored, however, if an existing PSP data set meets the
space and directory block requirements. The parameters are:
PARAMETER FORMAT
Data set name DSN=fully qualified data set name
Block size BLKSIZE=nnnnn
Expiration date EXPDT=yyddd
Retention period RETPD=nnnn
Volume serial VOLSER=vvvv
Unit UNIT=uuuuuuuu
SMS STORCLAS STORCLAS=cccccccc
SMS DATACLAS DATACLAS=cccccccc
SMS MGMTCLAS MGMTCLAS=cccccccc
DSNTYPE* DSNTYPE=cccccccc
Private PRIVATE=PRIVATE
Note, DSNTYPE specified for ddname PLOAD will be ignored.
Each PSP library's ddname and the defaults for data set name,
block size, unit, and VOLSER are listed in Figure A-1.
If you want to override any of these parameters, edit the
PSPOVER member of sharedprefix.MICS.TAPELOAD.CNTL and specify
the desired ddnames and parameters. Separate each parameter
with a blank. If a statement must be continued, follow the
completed parameter with a slash (/) and continue the
statement on the next line. Do not leave a blank line between
any statements. If the default is desired, do not code it.
If no overrides are desired, do not edit PSPOVER.
EXAMPLES OF CHANGES IN PSPOVER:
1. The PSP ISPF table library (ISPTLIB) is reblocked to a
block size of 23440; all other allocations use the
defaults:
DDN=PISPT BLKSIZE=23440
2. The PSP.LOAD library must be allocated on a 3390 that has
a VOLSER of PSPLOD; all other allocations use the
defaults:
DDN=PLOAD VOLSER=PSPLOD UNIT=3390
3. The name for the PSP source library is BDEF.ISMGMT.PSPSRC;
all other allocations use the defaults:
DDN=PSRC DSN=BDEF.ISMGMT.PSPSRC
4. The name for the PSP documentation text library is
BDEF.ISMGMT.MICS6.PSP.DOC.TEXT. Its VOLSER is PSPDOC,
which is a 3380. This statement uses the continuation
character:
DDN=PDOCTX DSN=BDEF.ISMGMT.MICS6.PSP.DOC.TEXT /
VOLSER=PSPDOC UNIT=338O
NOTES:
o Code the DDN first.
o If you specify a VOLSER, you MUST specify a UNIT.
o Do not use quotes on data set names.
o If a data set name is specified, you must edit the
equivalent name in the batch-driven refresh job. You must
also specify the name in the PSP Online panel, Define the
PSP Libraries (MWF Option 5;2;3;1).
o Do not reblock the PLOAD library to a smaller block size!
o Do not code EXPDT and RETPD together on any override;
dynamic allocation will fail.
o If EXPDT or RETPD is used, your system operator will
receive a message requesting permission to write on the
data set.
o Do not use blank lines.
o If a data set can be reused, its block size will not be
overridden.
DDNAME DATA SET NAME RECFM LRECL BLKSIZE DSORG UNIT VOLSER
PASM &SPREFIX..&SMICS.PSP.ASM FB 80 6160 PO &PSPUNIT &PSPVOL
PBIN &SPREFIX..&SMICS.PSP.BIN VB 6140 6144 PO &PSPUNIT &PSPVOL
PCLIST &SPREFIX..&SMICS.PSP.CLIST FB 80 6160 PO &PSPUNIT &PSPVOL
PCNTL &SPREFIX..&SMICS.PSP.CNTL FB 80 6160 PO &PSPUNIT &PSPVOL
PDICTX &SPREFIX..&SMICS.PSP.DIC.TEXT VB 137 6160 PO &PSPUNIT &PSPVOL
PDOCTX &SPREFIX..&SMICS.PSP.DOC.TEXT VB 137 6160 PO &PSPUNIT &PSPVOL
PGEN &SPREFIX..&SMICS.PSP.GENLIB FB 80 6160 PO &PSPUNIT &PSPVOL
PINCTX &SPREFIX..&SMICS.PSP.INC.TEXT VB 137 6160 PO &PSPUNIT &PSPVOL
PINCL &SPREFIX..&SMICS.PSP.INCLLIB FB 80 6160 PO &PSPUNIT &PSPVOL
PISPH &SPREFIX..&SMICS.PSP.ISPHLIB FB 80 6160 PO &PSPUNIT &PSPVOL
PISPM &SPREFIX..&SMICS.PSP.ISPMLIB FB 80 6160 PO &PSPUNIT &PSPVOL
PISPP &SPREFIX..&SMICS.PSP.ISPPLIB FB 80 6160 PO &PSPUNIT &PSPVOL
PISPS &SPREFIX..&SMICS.PSP.ISPSLIB FB 80 6160 PO &PSPUNIT &PSPVOL
PISPT &SPREFIX..&SMICS.PSP.ISPTLIB FB 80 6160 PO &PSPUNIT &PSPVOL
PLOAD &SPREFIX..&SMICS.PSP.LOAD U 0 6160 PO &PSPUNIT &PSPVOL
PMACA &SPREFIX..&SMICS.PSP.MACAUTOS FB 80 6160 PO &PSPUNIT &PSPVOL
PMACL &SPREFIX..&SMICS.PSP.MACLIB FB 80 6160 PO &PSPUNIT &PSPVOL
PMCOL &SPREFIX..&SMICS.PSP.MCOLIB FB 6144 6144 PO &PSPUNIT &PSPVOL
POBJ &SPREFIX..&SMICS.PSP.OBJ FB 80 6160 PO &PSPUNIT &PSPVOL
PPARMS &SPREFIX..&SMICS.PSP.PARMS FB 80 6160 PO &PSPUNIT &PSPVOL
PCTEXT &SPREFIX..&SMICS.PSP.PC.TEXT VB 137 6160 PO &PSPUNIT &PSPVOL
PPROTO &SPREFIX..&SMICS.PSP.PROTOLIB FB 80 6160 PO &PSPUNIT &PSPVOL
PSASFLS &SPREFIX..&SMICS.PSP.SASFLS FB 6144 6144 PO &PSPUNIT &PSPVOL
PSRC &SPREFIX..&SMICS.PSP.SOURCE FB 80 6160 PO &PSPUNIT &PSPVOL
PUSRC &SPREFIX..&SMICS.PSP.USOURCE FB 80 6160 PO &PSPUNIT &PSPVOL
Figure A-1. Default PSP Installation Library DDnames, Data Set Names and Parameters
&SPREFIX, &SMICS, &PSPUNIT, and &PSPVOL all come from
sharedprefix.MICS.TAPELOAD.CNTL(PSPyymmL), which is used to
execute the PSP refresh job. Likewise, default SMS storage
class, data class, and management class are taken from the
&PSPSTORC, &PSPDATAC, and &PSPMGMTC parameters in
sharedprefix.MICS.TAPELOAD.CNTL(PSPyymmL), which is used to
execute the PSP refresh job.
DDNAMES USED BY DDNAMES USED BY
PSP INSTALLATION PSP ONLINE
PASM ASM
PBIN BIN
PCLIST CLIST
PCNTL SHRCNTL
PDICTX VDIC
PDOCTX VDOC
PGEN GENLIB
PINCTX VINC
PINCL INCLLIB
PISPH ISPHLIB
PISPM ISPMLIB
PISPP ISPPLIB
PISPS ISPSLIB
PISPT ISPTLIB
PLOAD LOAD
PMACA SASAUTOS
PMACL MACLIB
PMCOL MCOLIB
POBJ OBJ
PPARMS SHRPARMS
PCTEXT PCDOC
PPROTO PROTOLIB
PSASFLS SASFLS
PSRC SOURCE
PUSRC SHRUSORC
Figure A-2. DDnames Used in PSP Installation and DDnames Used by PSP Online
Use Figure A-2 only if you want to change the name of any of
your PSP libraries:
o The names in the column DDNAMES USED BY PSP INSTALLATION
can be coded in PSPOVER.
o The names in the column DDNAMES USED BY PSP ONLINE are used
to identify PSP data sets in the PSP Online "Define the PSP
Libraries" panel (MWF Option 5;2;3;1).
