Previous Topic: Modify and Run the Job INSTALLNext Topic: Output from ESD or DVD Install


GSVIINST Macro—Set INSTALL Parameters

Set the GSVIINST macro parameters 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
               , *      DVD - Contains PAX file                         * 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
               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 you used in the SYSLIB statement. See 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 that is used when unzipping the ESD files 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 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 for indicating 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 for defining whether SMS is used for the data set allocation. Specify YES or NO. If you specify YES, specify an SMS storage class on the STORCLAS parameter.

Default: SMS=NO

SMSVOL

Specifies the volume serial number (volser) of the volume that is used 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 that is used 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 that you want to allocate.

Valid Values:

PDS

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

LIBRARY

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

Default: PDS

BLKSZU

Specifies the block size that is used 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 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 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

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 SMP/E HLQ generates an extra sample job (INST0004). 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 that is used to copy the dynamic installation program. This dynamic installation program:

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 the DD statements for the following data sets:

DD DSN=imshlq.SDFSRESL
MQSHLQ

Specifies 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 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. This parameter can also be coded 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 the options parameter include:

COMPONENTS

Specifies the CA SYSVIEW components that you want enabled. 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: Complete the CA SYSVIEW installation before installing or customizing some of these components and options.

SVC

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

The SVC module GSVXSVC is downward compatible. However, if you plan on sharing the SVC with prior releases of CA SYSVIEW, apply all conditioning maintenance.

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 used when contacting technical support. Use this site ID to FTP information to CA.

JOBNAME

Specifies the job name that is used 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 that is specified on 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 for use on the JOB statement.

Default: CLASS=A

MSGCLASS

Specifies the message class for use on the JOB statement.

Default: MSGCLASS=A

MSGLEVEL

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