Previous Topic: Modify and Run the Job INSTALLNext Topic: Output from INSTALL


GSVIINST Macro—Set INSTALL Parameters

Set the 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
               , *-----------------------------------------------------*   X
               SOURCE=ESD,	  ESD|DVD	<-- 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
               SITEDSN=YES,                                      <---   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
               SMPEHLQ=                                                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
               NOWILYAPM,                   ...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. Ensure that you use the same high-level qualifier that you used in the SYSLIB statement 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:

ESDHLQ=yourHLQ

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

Specifies the high-level qualifier for unzipping the ESD files to z/OS data sets. UNZIPJCL performs this job.

Specifies the high-level qualifier for unzipping the ESD files to z/OS data sets. UNZIPJCL performs this job.

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

PREFIX

Specifies the prefix that is used for allocating data sets.

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

Default: PREFIX=sysview

SITEDSN

Specifies whether to use a set of site libraries for maintaining your customized library members.

The site data sets can be reused and carried forward when you migrate or update to a new release of CA SYSVIEW.

Valid Values:

YES

Generates the sample job INST0006. This job creates a set of site libraries and updates the sample GSVX* System configuration member accordingly.

NO

The sample job INST0006 is not generated.

Default: SITEDSN=YES

DELETE

Specifies the parameter that is used 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 that is used to define whether SMS is used for the 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 for allocating the SMS data sets.

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

STORCLAS

Specifies the SMS storage class that you use when you specify 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 that you want to allocate.

Valid Values:

PDS

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

LIBRARY

Allocates a 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 when allocating data sets with an undefined record length. Use this parameter for allocating the load library data sets.

Default: BLKSZU=6144

BLKSZFB

Specifies the block size when allocating fixed block data sets.

Default: BLKSZFB=3200

BLKSZVB

Specifies the block size when allocating variable block data sets.

Default: BLKSZVB=25600

ZFSHLQ

Specifies the high-level qualifier for the z/FS data set 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

This prefix resolves 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 the SMP/E HLQ generates an extra sample job (INST0004). This job creates a set of run-time libraries using the HLQ specified with PREFIX.

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 for copying the dynamic installation program. When this dynamic installation program executes, it performs the following tasks:

CEEHLQ

Specifies your site C language environment high-level qualifier.

IMSHLQ

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

DD DSN=imshlq.SDFSRESL
MQSHLQ

Specifies your site WebSphere MQ high-level qualifier. If multiple releases of WebSphere MQ are being used, specify the highest level. This high-level qualifier is used to generate the 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

Enables 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 that you want 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.

This parameter includes the following values:

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

SVC

Specifies the supervisor call (SVC) number for use with 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 for contacting technical support. Use this site ID to FTP information to CA.

JOBNAME

Specifies the job name that you use to create 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 when it is necessary to build a JOB statement.

Default: ACCT=(00000000)

NOTIFY

Specifies the user ID that is notified when the job completes. If NO is specified, this parameter is not generated on the JOB statement.

Default: NOTIFY=NO

CLASS

Specifies the job class that is used on the JOB statement.

Default: CLASS=A

MSGCLASS

Specifies the message class that is used on the JOB statement.

Default: MSGCLASS=A

MSGLEVEL

Specifies the message level that is used 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 for 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