Previous Topic: Modify and Run the Job INSTALL

Next Topic: Output from Tape INSTALL


GSVIINST Macro—Set INSTALL Parameters

Set parameters for the GSVIINST macro before you submit the job INSTALL. The following example shows the default parameter values that appear in the job INSTALL.

These parameters have the following syntax:

//INSTALL  JOB (000000000),'SYSVIEW',CLASS=A
//*
//*-------------------------------------------------------------------*
//*   CA SYSVIEW                                                      *
//*   Installation generator                                          *
//*                                                                   *
//*   This job will dynamically build the other jobs that are         *
//*   required to complete the installation.                          *
//*                                                                   *
//*   *--------------------* Important Notice *-------------------*   *
//*                                                                   *
//*   CA Mainframe Software Manager                                   *
//*                                                                   *
//*   If you have used CA Mainframe Software Manager                  *
//*   to perform the installation of the product,                     *
//*   this step is required.                                          *
//*                                                                   *
//*   Step: Required                                                  *
//*                                                                   *
//*-------------------------------------------------------------------*
//ASM EXEC PGM=ASMA90,REGION=1024K,PARM='NOTERM,LIST,DECK,NOOBJECT'
//*
//SYSUT1   DD UNIT=SYSDA,SPACE=(1700,(600,100))
//SYSUT2   DD UNIT=SYSDA,SPACE=(1700,(600,100))
//SYSUT3   DD UNIT=SYSDA,SPACE=(1700,(600,100))
//SYSPUNCH DD SYSOUT=(*,INTRDR),DCB=(RECFM=FB,LRECL=80,BLKSIZE=2000)
//SYSPRINT DD SYSOUT=*
//*-------------------------------------------------------------------*
//*   The data set defined to the DDNAME SYSLIB should also           *
//*   be coded as the data set name on the GSVIINST option            *
//*   INSTLIB=.                                                       *
//*                                                                   *
//*   The options that require modification or inspection             *
//*   for specific site installation needs are marked with            *
//*   a "<---".                                                       *
//*-------------------------------------------------------------------*
//*
//SYSLIB   DD DISP=SHR,DSN=sysview.SAMPJCL                  <---INSTLIB
//*
//*
//*   Note:  When modifying the macro below, remember to include
//*          the continuation character "X" in column 72 for all
//*          lines except the last line containing the DUMMY=
//*          parameter.
//*
//*.+....1....+....2....+....3....+....4....+....5....+....6....+....7.X
//SYSIN    DD *
*
         PRINT NOGEN
         GSVIINST                                                      X
               , *---------------------------------------------------* X
               , *   Installation data set name                      * X
               , *   This is the data set name that you are          * X
               , *   editing now.                                    * X
               , *---------------------------------------------------* X
               INSTLIB=sysview.SAMPJCL,                         <---   X
               , *---------------------------------------------------* X
               , *  System parmlib data set                          * X
               , *---------------------------------------------------* X
               SYSPLIB=SYS1.PARMLIB,                            <---   X
               , *---------------------------------------------------* X
               , *    Source installation Media                      * X
               , *      ESD  - ESD file on DASD                      * X
               , *      TAPE - Physical cartridge                    * X
               , *---------------------------------------------------* X
               SOURCE=ESD,                  ESD | TAPE          <---   X
               TAPEVOL=SYD500,                                         X
               TAPUNIT=3480,                                    <---   X
               , *---------------------------------------------------* X
               , *   High-level qualifier used when the ESD file     * X
               , *   was UNZIPPED.                                   * X
               , *---------------------------------------------------* X
               ESDHLQ=yourHLQ,              ESD HLQ             <---   X
               , *---------------------------------------------------* X
               , *   Data set allocation                             * X
               , *---------------------------------------------------* X
               PREFIX=sysview,                                  <---   X
               DELETE=YES,                                             X
               DASDVOL=volume,                                  <---   X
               SMS=NO,                                                 X
               SMSVOL=,                                                X
               STORCLAS=,                                              X
               DSKUNIT=SYSDA,                                          X
               WRKUNIT=SYSDA,                                          X
               PROFTYPE=PDS,                                           X
               , *---------------------------------------------------* X
               , *   Data set blocksizes                             * X
               , *---------------------------------------------------* X
               BLKSZU=6144,                                            X
               BLKSZFB=3200,                                           X
               BLKSZVB=25600,                                          X
               , *---------------------------------------------------* X
               , *   z/FS data set allocation                        * X
               , *---------------------------------------------------* X
               ZFSHLQ=OMVS.SYSVIEW,                             <---   X
               PATHPREFIX=,                                            X
               , *---------------------------------------------------* X
               , *   SMP/E                                           * X
               , *---------------------------------------------------* X
               SMPEHLQ=,                                               X
               SMPETZ=CAIT,                                            X
               SMPEDZ=CAID,                                            X
               SMPEVOL=volume,                                  <---   X
               DLIBVOL=volume,                                  <---   X
               SMPEUNIT=SYSDA,                                         X
               DLIBUNIT=SYSDA,                                         X
               , *---------------------------------------------------* X
               , *   Data set and high level qualifiers              * X
               , *---------------------------------------------------* X
               AUTHLIB=apf.auth.dataset.name,                   <---   X
               CEEHLQ=CEE,                                      <---   X
               IMSHLQ=ims,                                      <---   X
               MQSHLQ=mqseries,                                 <---   X
               SYSTCPD=TCPIP.TCPIP.DATA,                        <---   X
               TCPMBR=,                                                X
               , *---------------------------------------------------* X
               , *   CA SYSVIEW Options                              * X
               , *---------------------------------------------------* X
               OPTIONS=(,                   Begin option list          X
               NOCAPTURE,                   ...option                  X
               NOCICS,                      ...option                  X
               NODATACOM,                   ...option                  X
               NOIMS,                       ...option                  X
               NOMVS,                       ...option                  X
               NOMQSERIES,                  ...option                  X
               NOTCPIP,                     ...option                  X
               NOCEAPM,                     ...option                  X
               ),                           End option list            X
               , *---------------------------------------------------* X
               , *   CA SYSVIEW Components                           * X
               , *---------------------------------------------------* X
               COMPONENTS=(,                Begin component list       X
               DB2                          ...component               X
               HCHECK,                      ...component               X
               MIM,                         ...component               X
               ROSCOE,                      ...component               X
               USS,                         ...component               X
               XSYSTEM,                     ...component               X
               ),                           End component list         X
               , *---------------------------------------------------* X
               , *   CA SYSVIEW GEN parameters                       * X
               , *---------------------------------------------------* X
               SVC=238,                                         <---   X
               SUBSYS=GSVX,                                            X
               , *---------------------------------------------------* X
               , * The CA customer siteid.                           * X
               , * The siteid will be used to assist technical       * X
               , * support with diagnostics. This is used when       * X
               , * FTPing information to CA. (optional)              * X
               , *---------------------------------------------------* X
               SITEID=siteid,                                   <---   X
               , *---------------------------------------------------* X
               , *   Jobcard/JCL creation                            * X
               , *---------------------------------------------------* X
               JOBNAME=,                                               X
               NAME='PROGRAMMER NAME',                          <---   X
               ACCT=(000000000),                                       X
               NOTIFY=NO,                                              X
               CLASS=A,                                                X
               MSGCLASS=A,                                             X
               MSGLEVEL=(1,1),                                         X
               ROUTE=NO,                                               X
               SYSAFF=NO,                                              X
               OUTC=*,                                                 X
               , *---------------------------------------------------* X
               , *   Assemble and Link edit                          * X
               , *---------------------------------------------------* X
               ASMPGM=ASMA90,                                          X
               LINKPGM=IEWL,                                           X
               , *---------------------------------------------------* X
               , *   End of Macro                                    * X
               , *---------------------------------------------------* X
               DUMMY=DUMMY
*
*        Do not remove the following line.
*
         END
/*

You can modify the following GSVIINST parameters:

INSTLIB

Names the current installation library data set. Be sure that you use the same high-level qualifier used in the SYSLIB statement set in the step Modify and Run the Job INSTALL.

Default: sysview.SAMPJCL

SYSPLIB

Specifies the system parameter library that contains the system configuration options member.

Default: SYS1.PARMLIB

SOURCE=source

Specifies the source installation media type.

Valid values are:

TAPEVOL

Specifies the volume serial number (volser) assigned to the tape. For TAPEVOL, specify the volser from the tape label.

Note: This parameter is ignored if SOURCE=ESD.

TAPUNIT

Specifies the tape unit type.

Default: TAPUNIT=3480

Note: This parameter is ignored if SOURCE=ESD.

ESDHLQ=yourHLQ

This parameter is only used and required if SOURCE=ESD.

Specifies the high-level qualifier to use when the ESD files are unzipped to z/OS data sets. UNZIPJCL performs this job.

The UNZIPJCL job references the high-level qualifier as yourHLQ. Use the same value for the ESDHLQ= value.

PREFIX

Specifies the prefix to use when allocating data sets.

Limit: The length of PREFIX and SUFFIX must not exceed 20 characters.

Default: PREFIX=sysview

DELETE

Specifies the parameter to use to indicate whether to generate a DELETE request for each new library before allocation. Specify YES or NO. If you are reinstalling to an existing set of libraries, specify DELETE=NO.

Default: DELETE=YES

DASDVOL

Specifies the volume serial number (volser) of the volume on which to allocate data sets.

SMS

Specifies the parameter to use to define whether SMS is used for data set allocation. Specify YES or NO. If you specify YES, then specify an SMS storage class on the STORCLAS parameter.

Default: SMS=NO

SMSVOL

Specifies the volume serial number (volser) of the volume to allocate the SMS data sets.

Note: Some sites do not allow the volser to be specified for SMS.

STORCLAS

Specifies the SMS storage class to use when you have specified YES on the SMS parameter.

DSKUNIT

Specifies the disk unit type.

Default: DSKUNIT=SYSDA

WRKUNIT

Specifies the disk work unit type.

Default: WRKUNIT=SYSDA

PROFTYPE

Specifies the profile data set type to allocate.

Valid values are:

PDS

Allocates the PDS profile data set. One PDS is shared across multiple sysplexes.

LIBRARY

Allocates the PDSE profile data set, which can only be shared within a single sysplex. If your configuration contains more than one sysplex, each sysplex requires a unique data set allocated.

Default: PDS

BLKSZU

Specifies the block size that is used when allocating data sets with an undefined record length. Use this parameter to allocate the load library data sets.

Default: BLKSZU=6144

BLKSZFB

Specifies the block size that is used when allocating fixed block data sets.

Default: BLKSZFB=3200

BLKSZVB

Specifies the block size that is used when allocating variable block data sets.

Default: BLKSZVB=25600

ZFSHLQ

Specifies the high-level qualifier for the following two z/FS data sets that are created during the installation process:

fmid

Contains the CA SYSVIEW SMP/E fmid.

Default: ZFSHLQ=OMVS.SYSVIEW

PATHPREFIX

Specifies the pathname prefix for the mount point of the z/FS data sets.

Default: PATHPREFIX=,

Example:

PATHPREFIX=/instpath

Will resolve to the following mount points:

instpath/usr/lpp/sysview 
instpath/usr/lpp/sysview/fmid
fmid

Contains the CA SYSVIEW SMP/E fmid.

SMPEHLQ

Specifies the HLQ for the SMP/E libraries. Specifying a value for SMP/E HLQ generates an additional sample job (INST0005). This job creates a set of run-time libraries using the PREFIX specified HLQ.

SMPETZ

Specifies the SMP/E target zone.

Default: SMPETZ=CAIT

SMPEDZ

Specifies the SMP/E distribution zone.

Default: SMPEDZ=CAID

SMPEVOL

Specifies the volume where you allocated the internal SMP/E and target data sets.

DLIBVOL

Specifies the volume where you allocate the SMP/E distribution data sets.

SMPEUNIT

Specifies the unit type for the SMPEVOL specified volume.

DLIBUNIT

Specifies the unit type for the DLIBVOL specified volume.

AUTHLIB

Specifies the data set name of an existing APF-authorized library to copy the dynamic installation program. This dynamic installation program performs the following tasks:

CEEHLQ

Specifies the C language environment high-level qualifier at your site.

IMSHLQ

Specifies the IMS high-level qualifier for your site. If multiple releases of IMS are being used, specify the highest level. This high-level qualifier is used to generate DD statements for the following data sets:

DD DSN=imshlq.SDFSRESL
MQSHLQ

Specifies the WebSphere MQ high-level qualifier for your site. If multiple releases of WebSphere MQ are being used, specify the highest level. This high-level qualifier is used to generate DD statements for the following data sets:

DD DSN=mqshlq.SCSQAUTH
DD DSN=mqshlq.SCSQLOAD
DD DSN=mqshlq.SCSQANLE
SYSTCPD

Specifies the name of the system TCP/IP configuration file. You can also code this parameter as a Hierarchical File System (HFS) path.

Default: TCPIP.TCPIP.DATA

TCPMBR

Specifies the member name from the TCP/IP data set (if any).

Note: This parameter is required only if the data set specified on the SYSTCPD parameter is a PDS.

Default: None

OPTIONS

Specifies to enable those options that are licensed to the customer. The options include the base product. Specifying an option value lets you use the option commands. By default, you can access commands for the option from the CA SYSVIEW main menu.

Note: Specify at least one option.

Values for this parameter include:

COMPONENTS

Specifies the CA SYSVIEW components to enable. Specifying a component value lets you use the component commands. By default, you can access commands for the component from the CA SYSVIEW main menu.

Note: DB2 is a new component and requires a license (LMP key) for CA Insight for DB2.

Values for the components parameter include:

Note: Perform additional installation or customization for some of these components and options after completing this installation of CA SYSVIEW.

SVC

Specifies the supervisor call (SVC) number to use for CA SYSVIEW. A type-3 user SVC is required.

Default: 238

SUBSYS

Specifies the suffix for the System Configuration Options member name in the system parameter library. Use GSVX if it is not already in use by another product. The same subsystem can share multiple releases of CA SYSVIEW.

Default: SUBSYS=GSVX

SITEID=siteid

Specifies the CA customer site ID to used when contacting technical support. Use this site ID to FTP information to CA.

JOBNAME

Specifies the job name to use when creating a JOB statement for installation jobs. If no parameter is specified, the name of the installation member is used.

NAME

Specifies the programmer name from the JOB statement.

ACCT

Specifies the account number if it is necessary to build a JOB statement.

Default: ACCT=(00000000)

NOTIFY

Specifies the user ID to notify at job completion. If NO is specified, this parameter is not generated on the JOB statement.

Default: NOTIFY=NO

CLASS

Specifies the job class to use on the JOB statement.

Default: CLASS=A

MSGCLASS

Specifies the message class to use on the JOB statement.

Default: MSGCLASS=A

MSGLEVEL

Specifies the message level to use on the JOB statement.

Default: MSGLEVEL=(1,1)

ROUTE

Generates the following route statement: /*ROUTE PRINT userid. If NO is specified, this statement is not generated.

Default: ROUTE=NO

SYSAFF

Generates the following system affinity statement: /*JOBPARM SYSAFF=sysname. If NO is specified, this statement is not generated.

Default: SYSAFF=NO

OUTC

Specifies the output class to use with SYSOUT.

Default: OUTC=*

ASMPGM

Specifies the name of the program that is used to assemble modules. Possible values are IEV90 and ASMA90.

Default: ASMPGM=ASMA90

LINKPGM

Specifies the name of the program that is used to link edit modules.

Default: LINKPGM=IEWL

More information:

Modify and Run the Job INSTALL