Skip to content
CA View® - 14.0
Documentation powered by DocOps

Initialization Parameters

Last update October 27, 2015

The SARINIT program sets or changes initialization parameters in the CA View database. Use these parameters to modify the customization options. References to the database refer to the CA View database unless otherwise noted.

Job Control Statements

Sample execution JCL can be found in member HAEXINIT in your CVDEJCL data set.

The following job control statements are required to execute SARINIT:

  • JOB
    Initiates the job.
  • EXEC
    Specifies the program name (PGM=SARINIT) and, optionally, the high-level name of the database as the PARM parameter (PARM=dbname).
  • STEPLIB DD
    Defines the load library containing SARINIT.
    If the program resides in a linklist library, omit this statement.
  • SYSPRINT DD
    Defines the sequential output data set used for listing the statements and messages.
    If this is not a SYSOUT data set, DCB=BLKSIZE=nnn must be coded, where nnn is a multiple of 133.
  • SYSIN DD
    Defines a card-image data set containing the parameter statements.

Parameter Statements

The SARINIT program reads a set of parameter statements:

  • For a new database, SARINIT initializes a new Master Control Record (MCR) and writes it out to the master index. If a statement for one of the parameters is omitted, the default values are used.
  • For an existing database, SARINIT updates the existing MCR:
    • Any parameter for which a statement is provided is set to the value supplied.
    • Any parameter for which no statement is supplied remains unchanged.
    • If a parameter statement is supplied without a value, the parameter is set to its default value.

You must stop the archival started task (SARSTC) before you change any parameters in its master index.

Parameter statements are coded as card images and have the following format:

parameter=value

  • The parameter must begin in column 1, followed by an equal sign and the value to be assigned to the parameter.
  • No blanks can be coded between the parameter and the equal sign nor between the equal sign and the value.
  • Only one parameter can be coded per card image.
  • Comments can be included within the parameter statements by coding an asterisk in column 1 of the card image containing the comment.

Activate and Modify

Features are unique to specific functions and depending on the feature number, these tasks may require recycling. Use the following chart to determine if a task must be recycled to activate a new or modified Initialization parameter.

  • Y - The task that must be re-cycled for the parameter to be active
  • L - User's session must be re-cycled (Logoff/Logon) for the parameter to be active
  • N or blank - The task does not need to be recycled

The Expanded Access Server for Tape and Robotics (SAREAS) and System Extensions (SARXTD) are EXEC statement parameter driven, and must be recycled whenever a startup parameter is added or changed.

Notes for entries in the table:

  1. Features are unique to specific functions. Depending on the feature number, these tasks can require recycling.
  2. For GEN and TAPESEQ, the parameters specify the starting generation and tape starting sequence numbers to be established for a new database.
  3. To make the ARCHCHG changes take effect, recycle the SARSTC or SARFSS task, or both. However, once reports have been archived into the View database, you cannot update the value of ARCHCHG.
PARAMETER SARSTC SARFSS SARXMS
ACIFCOMP   Y  
ACIFRES     L
AFPSPACE     L
ANNODFLT     L
ARCHCHG Note3 Note3 Note3
ARCHMSG Y Y  
ARCHSWAP Y    
BCHMAXRC      
BNDWDAYS Y    
CCONDISP     L
CLEAN N    
CLSL Y    
CMAMAX     L
CMASPOOL     L
CODEPAGE     L
DAYS Y    
DBMSGFRQ Y    
DBTHRESH Y Y  
DEFMODE      
DELETE     L
DESC Y Y  
DEST Y    
DIRALLOC      
DRMOD N    
DRTAPE N   L
DRTIDX N    
DRTSEQ N    
DRUNITB N    
DRUNITP N    
EASTDPLX     L
EASTMAXW     L
EASTNAM1     L
EASTNAM2     L
EASTNAM3     L
ENCRYPT Y Y  
EROOPT Y    
EXPDT Y    
EXPRESS   Y  
EXPOPRV     L
EXTPRT1     L
EXTPRT2     L
EXTPRT3     L
FEATURE Note 1 Note 1 Note 1
FINDLAST     L
FINDLIM     L
FINDPREV     L
FORM Y    
FREEPRT     L
GEN Note 2 Note 2 Note 2
GRPUSER Y Y  
HOLDTEMP Y    
IMMRPT Y Y  
INTERVAL Y    
JCLASS     L
JES3ID Y    
LANGUAGE      
LGNRETRY      
LOGO     L
MAILDEST     L
MAILFROM     L
MAILTO     L
MASTER     L
MAXLINES Y Y  
MOUNT     L
MSORT1 Y    
MSORT2 Y    
MSORT3 Y    
MSORT4 Y    
MSORT5 Y    
NAME Y Y Y
NARCCLSL Y    
NBACKUP Y    
NEWCLSL Y   L
NEWDEST Y   L
NEWFORM Y   L
NEWPASS     L
NGEND N    
NGENI N    
NGENT N    
PAGEMARK Y Y  
PRINTTO     L
PRTASA     L
PRTALL     L
PRTCLSL Y    
RCVPRIM Y    
RCVSEC Y    
RCVSPACE Y    
RCVUNIT Y    
REDISP     L
RETPD Y    
ROUT Y Y  
ROUTBKP Y    
SECID     L
SECLIST     L
SECTRAN     L
SECURITY     L
SETPAGE Y Y  
SMF Y Y L
SMFTYPE Y Y L
STACKBU Y    
START Y    
STORGRP0 N    
STORGRX0 N    
TAPECLSL Y    
TAPEOPT Y    
TAPESEQ Note 2 Note 2 Note 2
TBACKUP N    
TIME Y    
TPO54 Y    
TSOCLS     L
TSODEST     L
TSOFORM     L
TSOSCHED     L
UNITSPEC     L
UNLOAD Y    
USERLIB     L
USERLVL     L
VPRTAPPL     L
VPRTMAXO     L
VPRTONL     L
VPRTRINT     L
VPRTRTRY     L
WAIT Y    
WRITER     L
XPRINT Y    
Was this helpful?

Please log in to post comments.