Initialization Parameter Statements

Select a parameter:
view
Select a parameter:
ACIFCOMP
This parameter specifies whether to use a compression algorithm for ACIF reports and resources using MVS compression services to improve compression and minimize CPU usage.
Syntax:
ACIFCOMP=YES|NO
The default is NO.
  • Yes
    Activates the compression algorithm for any new ACIF reports processed by the FSS/ACIF collector.
  • No
    Deactivates this feature and reverts to standard compression for ACIF reports and resources.
ACIFRES
This parameter specifies whether CA View should reprint AFP reports with embedded resources, allowing CA View to manage the resources associated with a report.
Syntax:
ACIFRES=YES|NO
The default is NO. The user can also override this value for an individual reprint.
  • YES
    Reprints AFP reports with embedded resources, even if a resource on your system has been updated since the report was archived.
    The product uses the appropriate older resource at reprint time.
  • NO
    Reprints AFP reports without embedded resources.
AFPSPACE
This parameter is used to 'tweak' horizontal and vertical character formatting in the AFPACIF mainframe viewer.
Syntax:
AFPSPACE=horizontal|vertical
  • horizontal
    Changes the horizontal character value from 20 to 12, causing CA View to expand the line in a horizontal direction. This change fixes the problem that occurs when applications use small fonts and online viewing shows characters overlaying words from the same line.
    Do not exceed the original value of 20.
  • vertical
    Changes the vertical character value from 30 to 20. Use vertical if the viewer is overlaying a line with data from another line and is showing too many blank lines.
    Do not exceed the original value of 30.
ANNODLFT
This parameter is used to set the annotation default creation to PRIVATE or PUBLIC.
Syntax:
ANNODFLT=PRIVATE|PUBLIC
The default is PRIVATE.
  • PRIVATE
    Causes all new annotations to default to PRIVATE unless the value is changed.
  • PUBLIC
    Causes all new annotations to default to PUBLIC unless the value is changed.
ARCHCHG
This parameter allows or prevents the changing of archive date and time using the following user exits: SARSTCUX, SARFVCUX, SARACFUX, SARPAMUX, SARPDFUX.
Syntax:
ARCHCHG=[NO | baseyear]
Valid values for baseyear are 1980 and greater.
The default is NO.
  • NO
    Specifies that CA View increments the GEN number for the reports, which are based on the standard method and execution of the SARSTC backup task.
  • baseyear
    Indicates a four-digit year that represents the year of the oldest report on the database. When baseyear is specified, CA View calculates the GEN number for the report that is based on the number of days from the baseyear to the archive date. The SEQ is then calculated based on the archive time. The generated sequence number (archive time, in seconds, divided by 1.32922 plus one) ranges from 1 to 65000 and allows new reports to be added in approximate time-of-day sequence. If the sequence number is already in use, the next available sequence number is used.
For example, if ARCHCHG=1980 and the ARCHDATE = 01/01/1980, the generation is set to 1, indicating that this is the first day since the start of the baseyear. Backup cycles still run based on the TIME parameter, but the current generation is no longer incremented by 1. Instead current generation is calculated based on the number of days that occurred from the start of the baseyear to the current date. To change the baseyear after reports are archived, SARDBASE MERGE must be run to resequence the generation numbers that are based on the new value for baseyear.
Note:
The ARCHCHG parameter has the following requirements:
  • The ARCHCHG parameter does not affect the reports that are processed by the Xerox Collector.
  • When ARCHCHG is set to a baseyear, both the EROPRO and EROOPT parameters must be set to YES. To verify that back-dated reports will not immediately be expired from the data base during the next back-up cycle, review the ERO retention table carefully.
  • The ARCHCHG parameter must be set BEFORE any reports are archived to the database; it cannot be changed after reports are archived to the database.
    If you are merging databases with the SARDBASE MERGE control statement and want the ARCHCHG baseyear functionality, you must supply the ARCHCHG=baseyear specification on the SARDBASE MERGE control statement to activate this setting on the merged database.
ARCHCOPY
This parameter controls whether one or all copies of a SYSOUT which has a COPIES parameter with a value greater than one, are archived to the database.
Syntax:
ARCHCOPY=NO|YES
The default is NO.
  • YES
    Archive as many copies of a report equal to the number of copies coded on the SYSOUT or OUTPUT statement.
  • NO
    Archive only one copy of a report even though the SYSOUT was coded with a COPIES parameter with a value greater than one.
Note:
Setting ARCHCOPY=YES performs the same as in CA View 2.0.
ARCHMSG
This parameter specifies whether the SARSTC22 processing
jobname/dsname
archival message is issued for each SYSOUT processed.
Syntax:
ARCHMSG=YES|NO
The default is NO.
ARCHSWAP
This parameter specifies whether the CA View started task is swappable.
Syntax:
ARCHSWAP=YES|NO
The default is NO.
Values are as follows:
  • YES
    Marks the started task as swappable.
  • NO
    Marks the started task as non swappable.
BCHMAXRC
This parameter specifies the maximum return code that the SARBCH program can issue.
Syntax:
BCHMAXRC=
nnn
The default is 255.
Valid values are 1-255.
BNDWDAYS
This parameter specifies the number of days that are to transpire before a report is forcibly removed from bundle wait status (BNDW).
Syntax:
BNDWDAYS
=nnn
The default is 7. The number of days (
nnn
) can be 1 to 100 days.
CCONDISP
This parameter specifies the CA View system-wide default value that controls the viewing of carriage control characters in online logical viewing.
Syntax:
CCONDISP=YES|NO
The default is YES.
Values are as follows:
  • YES
    Sets the carriage control character viewing default to YES for online viewing.
  • NO
    Sets the carriage control character viewing default to NO for online viewing.
CENTADR
This parameter specifies a comma-separated string of IP addresses or DNS names for Centera access nodes. The Centera disk interface uses these addresses when it connects to the Centera pool.
Syntax:
CENTADR=IP addresses or DNS names
CENTNAME
This parameter specifies the four-character subsystem name of the SARCAS server task.
Syntax:
CENTNAME=cas-name
CENTPDSN
This parameter specifies the dataset name of the Centera Pool Entry Authorization (PEA) dataset. This dataset is only required if the default Centera access profile is being overridden. For information about creating and using PEA files, review EMC Centera documentation or contact EMC Centera technical support.
Syntax:
CENTPDSN=dataset name
CLEAN
This parameter specifies whether the CA View backup cycle is to invoke cleanup processing of CA Deliver direct-to-CA View reports with OPEN status.
Syntax:
CLEAN=YES|NO
The default is YES.
Values are as follows:
  • YES
    Specifies cleanup processing during all backup cycles, standard and interim.
  • NO
    Specifies no cleanup processing.
    Sites that run in a nonshared JES environment should set CLEAN=NO. Use this setting because CA View cannot determine if the report was left in OPEN status or if it is actually being processed.
Notes:
  • If CLEAN=NO, cleanup must be done manually with the online C command.
  • The modify clean command does not affect CA Deliver OPEN subfiles, only SYSOUT subfiles left open by SARSTC or a CA View FSS collector.
  • SYSOUT files originating from CA Deliver left in OPEN status can only be cleaned with the online C command.
  • If long-running jobs are archiving SYSOUTs direct-to-View such as a started task archiving a log of some type, CLEAN must be set to NO because two consecutive backup cycles completed four hours apart would delete the SYSOUT and corrupt the database.
Deleting an OPEN SYSOUT
Never delete a SYSOUT in OPEN status because CA View might not be able to determine whether the report was left in OPEN status or whether it is actually being processed. The SYSOUT is marked as in delete status and is hidden in the database.
If the SYSOUT originated in CA View, it is still deleted after two consecutive backup cycles complete processing. If the SYSOUT originated in CA Deliver, it is marked for deletion. If CLEAN is set to NO, it is never deleted and continues to occupy space until CLEAN is set to YES and two consecutive backup cycles complete four hours apart.
Manually Cleaning CA Deliver Open SYSOUTs with CLEAN=NO
Use the online C command to mark a SYSOUT for cleanup.
  1. Execute the online C command.
    The command responds with CLEAN PENDING.
  2. Execute a second online C command at least four hours later.
    This time, the command responds
    sysoutid
    REMOVED. The SYSOUT is set to DISK status.
  3. You can now delete the SYSOUT with the online D command or leave it to expire under normal retention criteria.
CLSL
This parameter specifies a list of one to eight SYSOUT classes used to select SYSOUT for archival. When you specify CLSL, also specify, NEWCLSL to prevent a print-archival-print loop. If neither CLSL, DEST, nor FORM is specified, all SYSOUT is archived.
Syntax:
CLSL=xxxxxxxx
The default is ALL CLASSES.
CMAMAX
This parameter specifies the maximum number of lines that can be printed from an online session by using the P print selection code when using CA Spool.
Syntax:
CMAMAX
The default is 5000.
Valid values are 0-16770000.
The hierarchy of values is:
  • Device Definition
  • CMAMAX (If Max Lines is left blank in the Device Definition screen) and both CMAMAX and the online value for OUTLIM are set to zero, the number of lines that can be printed on-line is unlimited.
CMASPOOL
Specify CMASPOOL if you use CA Spool to print.
CMASPOOL specifies the 4-character name of the CA Spool subsystem that is defined in the CA Spool SUBID configuration parameter in member ESFPARM.
Syntax:
CMASPOOL=
subsys
There is no default.
For individual reports or jobs, users can optionally print or email output to an alternate CA Spool subsystem instead of the one in the CMASPOOL parameter. For details, see
Print Output Online or in Batch
or
Email Output
.
CODEPAGE
This parameter specifies which translation table (or codepage) to use when sending character strings to IBM-3270 type display terminals. The table is used to map nondisplay characters, or valid display characters needed for a particular language or special character.
Notes:
  • The table does not determine the actual character displayed by the terminal that is a function of either the hardware or the terminal emulator codepage.
  • The table only determines if the value of the hexadecimal character is passed to the display terminal or translated to a period (Hexadecimal character 4B).
    Syntax:
    CODEPAGE=
    xxx
    The default is 037.
  • The tables are named EBCCP
    xxx
    with the
    xxx
    characters being unique for different tables. The translation tables supplied on the CA View distribution tape are shown after the default value for this parameter.
  • The codepage charts are used to determine if the character value is passed to the display terminal or translated to a period. In this table, the lower case 'c' is used to show that the character value is passed, and the period is used to show that the character value is translated.
  • The title of each chart contains the codepage number (last three characters of the table name) and the common name associated with the terminal language.
    For example, the first table describes the default codepage table, CODEPAGE=037 which is commonly used and the English language display terminal.
    EBCCP037 - Default, English:
    0123456789ABCDEF +----------------+ 0|................|0 1|................|1 2|................|2 3|................|3 4|c.........cccccc|4 5|c.........cccccc|5 6|cc........cccccc|6 7|.........ccccccc|7 8|.ccccccccc......|8 9|.ccccccccc......|9 A|.ccccccccc......|A B|................|B C|cccccccccc..c.c.|C D|cccccccccc......|D E|c.cccccccc..c...|E F|cccccccccc......|F +----------------+ 0123456789ABCDEF
    EBCCP$01 - Kanji, Euro Country Extended Code Page (ECECP), and Country Extended Code Page (CECP)
    0123456789ABCDEF +----------------+ 0|................|0 1|................|1 2|................|2 3|................|3 4|cccccccccccccccc|4 5|cccccccccccccccc|5 6|cccccccccccccccc|6 7|cccccccccccccccc|7 8|cccccccccccccccc|8 9|cccccccccccccccc|9 A|cccccccccccccccc|A B|cccccccccccccccc|B C|cccccccccccccccc|C D|cccccccccccccccc|D E|cccccccccccccccc|E F|ccccccccccccccc.|F +----------------+ 0123456789ABCDEF
    EBCCP$02 - Version 1 Japanese and Europe:
    0123456789ABCDEF +----------------+ 0|................|0 1|................|1 2|................|2 3|................|3 4|cccccccccccccccc|4 5|ccccccc.c.cccccc|5 6|cc........cccccc|6 7|.........ccccccc|7 8|.ccccccccc......|8 9|cccccccccccccccc|9 A|.ccccccccccccccc|A B|..........cccccc|B C|cccccccccc..c.c.|C D|cccccccccc......|D E|c.cccccccc..c...|E F|cccccccccc......|F +----------------+ 0123456789ABCDEF
    EBCCP$03 - Version 2 Japanese and Europe:
    0123456789ABCDEF +----------------+ 0|................|0 1|................|1 2|................|2 3|................|3 4|cccccccccccccccc|4 5|cccccccccccccccc|5 6|cccccccccccccccc|6 7|cccccccccccccccc|7 8|cccccccccccccccc|8 9|cccccccccccccccc|9 A|cccccccccccccccc|A B|cccccccccccccccc|B C|cccccccccccccccc|C D|cccccccccccccccc|D E|c.cccccccccccccc|E F|cccccccccccccccc|F +----------------+ 0123456789ABCDEF
    EBCCP$04 - **SPARE**:
    0123456789ABCDEF +----------------+ 0|................|0 1|................|1 2|................|2 3|................|3 4|c.........cccccc|4 5|c.........cccccc|5 6|cc........cccccc|6 7|.........ccccccc|7 8|.ccccccccc......|8 9|.ccccccccc......|9 A|.ccccccccc......|A B|................|B C|cccccccccc..c.c.|C D|cccccccccc......|D E|c.cccccccc..c...|E F|cccccccccc......|F +----------------+ 0123456789ABCDEF
DAYS
This parameter specifies a string of seven characters with each character corresponding to one day of the week from Monday through Sunday. Each of the characters is specified as either Y or N.
Syntax:
DAYS=xxxxxxx
The default is YYYYYYY.
  • Y
    Specifies that the backup cycle can be automatically initiated by CA View on that day of the week.
  • N
    Suppresses the automatic backup cycle on that day of the week.
DBMSGFRQ
This parameter specifies the frequency or interval (from 1 to 65535) in number of records at which console messages are produced by either the backup cycle or the SARDBASE utility.
Syntax:
DBMSGFRQ=nnnnn
The default is 5000.
Following are the console messages produced with the backup cycle and the SARDBASE utility:
SARBKT63 STANDARD|INTERIM PHASE
n
PROCESSING
rrrrrr
, ARCHIVED ON
date
AT
time
SARDBG05 REORGANIZING
jobname
, GEN=
gen
, ARCHIVED ON
date
AT
time
SARDBR03 ATTEMPT TO COPY SYSOUT GROUP FROM OLD DATABASE - ID=
id
,GEN=
gen
, SEQ=
seq
SARDBR20 SYSOUT GROUP ADDED TO INDEX - ID=
id
, GEN=
gen
, SEQ=
seq
SARDBV11 INDEX VERIFICATION FOR ID=
id
, GEN=
gen
, SEQ=
seq
DBTHRESH
This parameter specifies the threshold percentages of database index and data extent capacities.
Syntax:
DBTHRESH=
ii,dd
The default is 80,80.
Valid values are 1-99.
When the threshold of the specific database component is reached (where
ii
specifies the index extent and
dd
specifies the data extent), the following respective messages display:
SARDBI23 ...
db_hlq
...Index files(s) at
nn
% utilization
SARDBI23 ...
db_hlq
...Data files(s) at
nn
% utilization
DEFMODE
This parameter specifies the system default user mode used for new users. This default user mode applies to new users who have not been predefined to the product by the DEF USER command.
Syntax:
DEFMODE=
abcdef
Letter
Mode
Values
a
ALL
Y|N|D
b
EXPO - Express operations
Y|N|D
c
EXP - Express
Y|N|D
d
SARO - SAR operations
Y|N|D
e
SAR
Y|N|D
f
JOB
Y|N|D
  • Y
    Lets the user enter the online operating mode.
  • N
    Prohibits the user from entering the online operating mode.
  • D
    Specifies the default mode for a first-time user.
    If multiple modes are set to D, the first one is the default mode for a first-time user.
    If no value is set to D, the first mode that is set to Y is the initial mode for a first-time user.
If you specify DEFMODE=NNNNNN, no new users are permitted.
The default is YNNNNN. It means yes for ALL mode and no for the remainder of the modes.
DELETE
This parameter specifies whether SYSOUT groups can be deleted by online users.
Syntax:
DELETE
=YES|NO
The default is NO.
DESC
This parameter specifies the descriptor code used for exceptional condition messages (message ID SARSTC99).
Syntax:
DESC=
nn
The default value is 2.
The default value highlights the messages and prevents them from rolling off a console in roll-delete mode. A value of 7 allows the messages to roll off and be deleted.
Valid values are 0-16. Specify a route code of up to 16 for the WTO that issues the messages. A route code of 0 suppresses the messages.
DEST
This parameter specifies the destination (remote name) used to select SYSOUT for archival.
Syntax:
DEST=
xxxxxxxx
The default is ALL DESTINATIONS.
When you specify DEST, also specify NEWDEST to prevent a print-archival-print loop. If neither CLSL, DEST, nor FORM is specified, all SYSOUT is archived.
DIRALLOC
This parameter specifies the number of blocks allocated for CA Deliver-direct-to-CA View archival.
Syntax:
DIRALLOC=nnn
The default is 50.
Valid values are 0-255. If 0 is specified, the default value of 50 is used.
The larger the value, the fewer the number of times large reports archived through CA Deliver direct-to CA View archival need to request additional blocks. The lower the value, the greater the chance you have of archiving into a database that is near capacity.
DRMOD
This parameter controls the disposition of a DR backup tape and DRMOD is ignored if DRTAPE is set to NO or DUPLEX.
Syntax:
DRMOD=NEVER|ALWAYS|STD
The default is NEVER.
  • NEVER
    Never append data to an existing DR backup tape.
    Always create a new DR tape for every standard and/or interim backup cycle.
  • ALWAYS
    Always append data to an existing DR Backup tape for every standard and/or interim backup cycle until the tape is full.
    If you issue a MODIFY SARSTC, NEW or INEW, or start the archival task with a NEW or INEW parameter, you cause a new DR Tape to be created.
  • STD
    Append data to an existing DR backup tape for an Interim backup cycle until the tape is full. Start with the first Interim Backup Cycle after a Standard Backup Cycle.
    If you issue a MODIFY SARSTC,NEW or INEW, or start the archival task with a NEW or INEW parameter, you cause a new DR Tape to be created.
Note:
The setting of the DRMOD parameter only affects the backup cycle. the Tape Consolidation Utility (SARPAC) appends to an existing SARPAC DR tape for a 'calendar day', each day a new SARPAC DR tape is created.
DRTAPE
This parameter controls whether a DR backup tape (DR tape) is created and used at a DR site or if the duplex should be used at the DR site.
Syntax:
DRTAPE=NO|YES|ACTIVE|DUPLEX
The default is NO.
  • NO
    Do not create a DR tape.
  • YES
    Create a DR tape but access reports on tape using the standard primary and/or duplex tapes. The creation of new backup cycle DR tapes is controlled with the DRMOD initialization parameter.
  • ACTIVE
    Create a DR tape and use the DR tapes when accessing reports on tape. If a DR tape is not available for a report, the primary and/or duplex are used.
  • DUPLEX
    Do not create a DR tape and access reports on tape using the duplex tape. If the duplex tape is not available for a report, the primary tape is used.
    Note:
    Setting DRTAPE=DUPLEX is equivalent to the CA View 2.0 parameter EASTDPLX=OLY. It allows EAS to call the duplex tapes before calling the primary tapes.
    CA View creates a DR tape if the DRTAPE parameter is set to YES or ACTIVE. This tape is not a mirror image of the primary or duplex tape. The DR tape is written during the current standard or interim backup cycle and can be sent to the DR site.
DRTIDX
This parameter specifies an alternate naming prefix (up to 17 characters) for your DR tapes. If this parameter is changed, tapes previously produced by CA View are still accessible. If omitted, the high-level name of the database is used.
Syntax:
DRTIDX=
name
DRTSEQ
This parameter specifies the starting tape sequence number for DR tapes established in a new database.
Syntax:
DRTSEQ=nnnnn
The default is 1.
Valid values are 1-65535.
Important!
This parameter is to be modified only at the direction of a
Broadcom Support
representative.
DRUNITB
This parameter specifies the tape unit name used by the backup cycle when allocating a new DR tape.
Syntax:
DRUNITB=
unitname
The default is TAPE.
DRUNITP
This parameter specifies the tape unit name used by SARPAC when allocating a new DR tape.
Syntax:
DRUNITP=
unitname
The default is the value of DRUNITB.
EASTDPLX
This parameter specifies whether SAREAS attempts to access a duplex volume if the primary volume is not cataloged. EASTDPLX=YES is normally used in a disaster recovery situation, where the primary volumes no longer exist or are inaccessible.
Syntax:
EASTDPLX=YES|NO
The default is NO.
Note:
Clients with the CA View 2.0 parameter EASTDPLX=OLY must use DRTAPE=DUPLEX. It allows EAS to call the duplex tapes before calling the primary tapes.
EASTMAXW
This parameter specifies the length of time to wait (in minutes) before time outs are to occur for online requests to the SAREAS tape server.
Syntax:
EASTMAXW=
nn
The default, EASTMAXW=00, indicates no time-outs are to occur.
Valid values are 0-99.
EASTNAM1 to EASTNAM3
These parameters allow reference to a maximum of three expanded access servers for tape and robotics when accessing report data that resides on tape or tape emulation optical.
The EASTNAM
n
parameters specify the subsystem names of the expanded access servers and related unit names used by the expanded access server. The syntax is as follows:
Syntax:
EASTNAMn=
eas-name/eas-unit1,eas-unit2
where:
  • n
    Specifies a number (from 1 to 3) used to reference up to three expanded access servers.
  • eas-name
    Specifies the four-character subsystem name of the expanded access server.
  • eas-unit1
    Specifies the optional unit name referenced in a STORGRPn parameter that can be accessed by the expanded access server.
  • eas-unit2
    Specifies the optional second unit name referenced in a STORGRPn parameter that can be accessed by the expanded access server.
    • If both
      eas-unit1
      and
      eas-unit2
      are omitted in an EASTNAM
      n
      parameter, all unit names not specifically identified by another EASTNAM
      n
      parameter can be accessed by this expanded access server subsystem.
    • The EASTNAM
      n
      parameter fields must be specified in full. Individual parameter field updates are not supported.
    • You can nullify or remove an EASTNAM
      n
      parameter by specifying no parameters. For example:
    • EASTNAM2=
    There is no default expanded access server subsystem.
ENCRYPT
Specifies whether to encrypt CA View data.
Syntax
ENCRYPT=NO | ICSF,nnn | ICSFSEC,nnn
  • NO
    - Report data is not encrypted.
    This is the default.
  • ICSF,nnn
    - Report data is encrypted using the ICSF AES algorithm. The encryption key is stored in the ICSF CKDS data set and is changed every
    nnn
    days throughout the year. Valid values are 1-366.
  • ICSFSEC,nnn
    - Report data is encrypted using an ICSF AES secure key, also referred to as a protected key or encrypted key. ICSF secure keys are keys that are encrypted with a master key, and the key used for encryption and decryption is known only to ICSF and the cryptographic hardware. The secure keys are stored in the ICSF CKDS data set. The key that is used to encrypt the data is changed every nnn days throughout the year. Valid values are 1-366.
    Use of ICSF keys requires external authorization permissions. For more details, see External Security Authorization in Data Encryption.
EXPDT
This parameter specifies the expiration date used for allocating a new tape data set.
The EXPDT and RETPD parameters are mutually exclusive. The parameter that was most recently entered (EXPDT or RETPD) takes precedence over the other. Specifying EXPDT causes RETPD to be set to spaces. If EXPDT and RETPD are specified together, EXPDT always takes precedence over RETPD and causes RETPD to be set to spaces.
Syntax:
EXPDT=yyddd EXPDT=yyyyddd
Two forms of the expiration date are provided for compatibility with IBM expiration date specifications. Use of the
yyyyddd
form requires a level of the operating system that provides Year 2000 support. A comparable level of your tape management product may also be needed. The current allowable maximum year value for the long form of EXPDT is 2155. This is an IBM restriction.
Some tape management products apply special meaning to certain expiration date specifications. For example, many tape management products use an expiration date of 99000 to indicate catalog retention (retain the tape as long as it is catalogued). We recommend catalog retention, because all backup tapes are catalogued while under the control of CA View.
There is no default expiration date. The suggested value is 99000.
Important!
Some tape management systems, such as CA 1 Tape Management (CA 1), have abend dispositions for tapes. Be sure that your tape management system defaults to the catalog on an abend. Failure to do this could result in loss of data. Refer to your tape management system documentation for complete documentation.
EXPOPRV
This parameter specifies whether the user requesting the reprint in Express Operator (EXPO) mode is to be used for reprinting. When EXPOPRV=YES (the default), the Deliver DISTIDs for this report are replaced by the DISTID of the user requesting the reprint. To append the Deliver DISTIDs to the reprint list after the user's DSITID, select option ‘D’ - Distribution Specifications on the CA Deliver Reprint Attributes screen. When EXPOPRV=NO, the DISTIDs in the reprint list are the original DISTIDs only. EXPOPRV works with the PRINT ALL DISTIDS and OUT parameters found on the Distribution Specification panel.
Syntax:
EXPOPRV=YES|NO
The default is YES.
EXPRESS
This parameter specifies the high-level name of the CA Deliver database. The high-level name is limited to 17 characters.
Syntax:
EXPRESS
=index
There is no default.
EXTPRTn
This parameter specifies the interface and attributes for printing or routing SYSOUT to an external printing product.
Syntax:
EXTPRT
n
=
printer - id
/JESDS/
class
/
destination
/
form
/
writer
EXTPRT
n=printer - id/PGM/program - name/parameter - data
There is no default.
The second parameter (JESDS or PGM) determines which interface you use: JES data set or dynamic program.
In addition to specifying a one- to three-character identifier for the printing product, each EXTPRT
n
parameter contains attributes for defining the communication mechanism. Attributes are also specified by the online DEFINE DEVICE command.
The EXTPRT
n
parameters are as follows:
  • n
    Either 1, 2, or 3.
  • printer-id
    The one- to three-character identifier for the external print product.
  • program-name
    The eight-character name of the interface program to be called.
  • class
    The one-character SYSOUT class to be used to route the external print record.
  • destination
    The eight-character SYSOUT destination to be used to route the external print record.
  • form
    The four-character SYSOUT forms name to be used to route the external print record.
  • writer
    The eight-character SYSOUT writer name to be used to route the external print record.
  • parameter-data
    Specifies up to 14 characters of parameter data to be passed to the interface program.
  • JESDS
    For the JESDS parameter specification, specify one or more of the EXTPRTn options as an asterisk (*) to indicate that they are to be supplied online by the user when printing a SYSOUT group. These options are:
    • class
    • dest
    • form
    • writer
FEATURE
This parameter specifies special features implemented by CA after the general release of the product. The feature codes are specified by number from 1 to 32. One or more features can be specified. If more than one feature code is specified, separate the feature codes with a comma.
Note:
If any other features are already activated, and you want to continue to use these features, specify each feature number on the FEATURE statement. For example, to activate features 2 and 3, you must specify FEATURE=2,3.
Syntax:
FEATURE=
n
,
n
There is no default.
Valid values are 1-32.
The FEATURE description is as follows:
Parameter
Format
Default
Description
FEATURE
FEATURE=
NONE
New features are added to the product between releases. When a new feature is added, it is given a number and activated with this parameter. After the feature is included in the new release, it gets its own parameter.
To activate more than one feature, separate the numbers with commas. Do NOT enclose with parentheses.
FEATURE=1
Used to enable the Security RACROUTE WTO, which provides informational messages used to diagnose security problems. To enable the WTO, add the feature number '1' to the initialization parameters, run SARINIT to change the feature value in the database and recycle the interactive tasks as needed. To disable the WTO, remove the feature number'1', run SARINIT to change the feature value in the database, and recycle interactive tasks as needed.
Note:
This feature can cause excessive WTO traffic; use it only for debugging external security issues.
FEATURE=2
For CA View green screen users:
Allows a cross-report index to use 1 MB of storage.
For CA Output Management Web Viewer users:
Allows a cross-report index report limit threshold of 4000 reports.
FEATURE=3
For CA View green screen users:
Allows a cross-report index to use 4 MB of storage.
For CA Output Management Web Viewer users:
Allows a cross-report index report limit threshold of 8000 reports.
Note:
FEATURE=2,3 bypasses report limits threshold checks and also uses all the available storage. This may result in S878 storage abends.
FEATURE=4
Allows you to utilize FASTAUTH calls.
To implement FASTAUTH:
Run SARINIT specifying parameter FEATURE=4.
Be sure to list CA View resource class CHA1VIEW.
FASTAUTH only works for interfaces that use a non-zero ACEE token address, that is, DRAS and XMS.
Note:
When the ACEE token address=ZERO, AUTH calls are invoked.
FEATURE=5
Enables the JES3 BNDLMOUT enhancement.
This enhancement attempts to group the bundled reports that contain compatible print attributes.
To enable JES3 BNDLMOUT enhancement, run a SARINIT specifying FEATURE=5 and the recycle your CA View started task.
FEATURE=6
Enables an option which can display the CA View (SAR) Re-print Attributes Panel in response to On-Line Re-print (P) or Batch Re- print (J) commands instead of the Deliver (Express) Re-print Attribute Panel.
FEATURE=7
Enables an option which prevents CA Spool errors that may result when reprinting logical views.
FEATURE=8
Enables an option that displays CA Deliver (EXP) Re-print Attribute Panel in response to the on-line re-print or batch re-print command. This panel is displayed instead of the CA Deliver (EXPO) Re-print Attribute Panel when in EXPO or ALL mode.
FEATURE=9
Allows the suppression of the leading '8B' records to reprint the AFP reports. Run SARINIT specifying FEATURE=9 to allow suppression.
FEATURE=12
Enables an option which ignores the use of SAREAS when performing a SARBCH/LOAD of a report from tape. Feature 12 provides the same functionality as usermods MHA1707 in CA View 1.7 and MHA2015 in CA View 2.0.
Note:
Using FEATURE=12 can result in tape contention messages between the submitted job and the SAREAS Tape Server task.
FEATURE=13
Enables MSGSUPP=YES when invoking RACROUTE REQUEST=AUTH calls to suppress security violation messages generated by RACF/TSS/ACF2.
FEATURE=14
Enables an option which lists ONLY the originator’s distribution ID when reprinting a CA Deliver report in ALL or EXPO Mode.
FEATURE=15
Activates the display of panels to display job start date/time, end date/time, and system id, when turned on.
FEATURE=16
Enables an option which generates an extra blank line at the start of each page in a report.
FEATURE=17
For English-language panels only: Displays all text on the panel in uppercase, including fields and messages.
FEATURE=18
Collects the JESJCLIN data set with sysouts that contain JESMSGLG, JESYSMSG, and JESJCL data sets.
This feature applies
only
to output collected by the CA View started task SARSTC.
The JESJCLIN data set also appears in JOB mode.
Note:
Features are unique to specific functions and depending on the feature number, these tasks may require recycling.
FINDLAST
This parameter specifies whether users can use the LAST operand with the FIND command during an online session.
Syntax:
FINDLAST
=
YES|NO
The default is YES.
FINDLIM
This parameter limits the number of records searched before the user is required to reinvoke the online FIND command. A user can use the LIMIT online command to set the user's own FINDLIM, and the online LIMIT overrides the FINDLIM parameter.
Syntax:
FINDLIM=
nnnnnnnnn
,
mmmmmmmmm
The default is 0, which permits unlimited searches.
Valid values are 0-999999999.
The maximum override allowed by any user is set with the
mmmmmmmmm
value.
For example, you can have a default FINDLIM of 1,000 records and allow users to override this, but not to exceed a FINDLIM of 3,000 by specifying FINDLIM=1000,3000.
FINDPREV
This parameter specifies whether users can use the PREV operand with the FIND command during an online session.
Syntax:
FINDPREV
=
YES|NO
The default is YES.
FORM
This parameter specifies the one to eight character forms name used to select SYSOUT for archival. When FORM is specified, NEWFORM should also be specified to prevent a print-archival-print loop. If neither CLSL, DEST, nor FORM is specified, all SYSOUT is archived.
Syntax:
FORM=
xxxxxxxx
The default is ALL SYSOUT FORMS.
FREEPRT
This parameter specifies whether to use FREE=CLOSE during dynamic allocation of the SYSOUT data set for the print function of SARBCH.
Syntax:
FREEPRT=YES|NO
The default is YES.
Values are as follows:
  • YES
    Specifies FREE=CLOSE.
  • NO
    Does not specify FREE=CLOSE.
With FREEPRT=YES, each report is explicitly freed and is immediately available to be printed. With FREEPRT=NO, each report is held until the entire SARBCH job completes.
GEN
This parameter specifies the starting generation number to be established for a new database.
Syntax:
GEN
=nnnnn
The default is 1.
The minimum value is 1. The maximum value is 32767.
You should modify this parameter only with the direction of a
Broadcom Support
representative.
GRPUSER
This parameter specifies whether the GCRUSER field is to be used as a parameter when CA View checks for a new SYSOUT group.
Syntax:
GRPUSER=YES|NO
The default is NO.
Values are as follows:
  • YES
    Use the GCRUSER field in addition to all other criteria.
    If the GCRUSER field changes within a SYSOUT group, the CA View started task splits it into a new entry in the database.
  • NO
    Do not use the GCRUSER field.
HOLDTEMP
This parameter specifies the number of backup cycles a SYSOUT is held (after a load/restore) before it is deleted from disk. This is a temporary data set hold. Both primary and interim backups are included.
Syntax:
HOLDTEMP
=nnn
The default is 0.
Valid values are 0-255.
IMMRPT
This parameter tells the system whether to look for IMM/IDM records when doing a record or page skip for reprint from an archive tape.
Syntax:
IMMRPT=YES|NO
The default is NO.
Note:
This parameter is for performance purposes. A scan for IMM/IDM records causes all skipped records to be decompressed. It is effective only for tapes archived on CA View Release 1.6 or prior. This parameter is ignored for all other archive tapes.
INTERVAL
This parameter specifies the time interval in hours and minutes after which the backup cycle is automatically initiated. A value of 0000 is converted to the default of 2400, which is the maximum value for this parameter.
Syntax:
INTERVAL
=hhmm
The default is 2400.
Values are as follows:
  • hh
    The hour, based on a 24-hour clock.
  • mm
    The minutes.
Valid values for
hh
are 00-24. Valid values for
mm
are 00-59.
The maximum value that can be specified is 2400 (the default).
JCLASS
This parameter determines the SYSOUT class to appear on the Print Attribute panel when a SYSOUT is printed with the online J selection code.
Syntax:
JCLASS
=
*
The default is TSOCLS/NEWCLSL.
Do one of the following:
  • Specify an asterisk (JCLASS=*) to use the MSGCLASS from the original SYSOUT job
  • Leave the field blank to default to the TSOCLS initialization parameter specification.
    If TSOCLS is left blank, the NEWCLSL initialization parameter specification is the default.
JES3ID
Specifies an alternate subsystem ID for JES3. Specify this parameter only when the JES3 subsystem is used and the subsystem ID is not JES3.
Syntax:
JES3ID
=name
The default is spaces.
JOBMODE
Specifies whether to create index records for JOB mode in the CA View database.
YES
creates these index records.
NO
does not create these index records.
Administrators can change this setting from YES to NO at will. Reports that are archived while JOBMODE=YES
can
be viewed in JOB mode. Reports that are archived while JOBMODE=NO
cannot
be viewed in JOB mode. When users access archived reports in JOB mode, they see one of the following options:
  • all archived SYSOUT, if the report was archived while JOBMODE was set to YES.
  • no data, if the report was archived while JOBMODE was set to NO.
If you change JOBMODE from YES to NO, creation of JOB mode index records stops; however, existing JOB mode records are not deleted. These records are deleted when the associated report instance is deleted.
To delete all JOB mode records immediately, VERSION your database down to a release that does not support JOB mode (Release 12.1 or earlier) and version it back up to the current release.
For CA View 14.0 GA, JOB mode is automatically activated for databases that are versioned to a 12.2 or higher release level. PTF R095789 supplies the new JOBMODE= initialization parameter. Applying the PTF adds the parameter and lets you set its value to YES or NO to activate or deactivate JOB mode.
Applying the PTF sets the default value of the new JOBMODE parameter to NO in the following situations:
  • When the database release level is versioned to release 12.2 or higher
  • When you create a database
In all other situations, applying the PTF keeps the setting at YES.
Syntax:
JOBMODE =YES|NO
LANGUAGE
This parameter specifies a two character code that represents the system default language and panel preference code to be used when displaying online panels and messages.
Syntax:
LANGUAGE
=xx
The first character specifies the language code. The second character specifies the panel preference. The default is R.
Valid values for the language code are as follows:
  • R | blank
    Signifies English.
  • C
    Signifies Canadian French.
  • D
    Signifies Danish.
  • G
    Signifies German.
Valid values for the panel preference code are as follows:
  • (blank)
    Signifies standard selection list display panels with long report identifier.
  • S
    Signifies standard selection list display panels with short report identifier names (for compatibility with Release 2.0 format).
  • W
    Signifies wide screen display panels with long report identifier.
  • Z
    Signifies wide screen display panels with short report identifier.
Example:
The following example specifies that the default display is English and wide screen.
LANGUAGE=RW
  • If you provide a value for the panel preference code, the language code must also be specified.
  • The appropriate language panels must be loaded before LANGUAGE can be set to the value for that language.
LGNRETRY
This parameter specifies the number of logon failures that can occur before a user is forced offline.
Syntax:
LGNRETRY
=nnn
The default is 3.
Valid values are 0-256. If 0 is specified, the default of 3 is used.
This parameter specifies whether the initial CA View logo panel is displayed when the user first enters the system.
Syntax:
LOGO=YES|NO
The default is YES.
MAILDEST
Specifies the default destination to which to send the email. Examples include JES and CMASPOOL destinations.
When you specify MAILTO=JES, you can add a JES2 DESTID destination that defines the remote Network Job Entry (NJE) node where CA Spool is running, and the targeted CA Spool email printer.
The following example shows a sample JES2 DESTID definition:
/$ADD DESTID(EMAILSAR),DEST=Nnnnn.EMAILSAR
EMAILSAR
Specifies the destination name that is used in CA View as the email destination.
Nnnnn.EMAILSAR
Specifies Nnnnn as the NJE node name and EMAILSAR as the destination at this node.
When users create an email, they can override the default destination by specifying a new destination on the Email Attributes Panel.
Syntax:
MAILDEST=xxxxxxxx
Length: 1-8 characters
Default: None
For individual reports or jobs, users can optionally print or email output to an alternate CA Spool subsystem instead of the one in the CMASPOOL parameter. For details, see Print Output Online or in Batch or Email Output.
MAILFROM
Specifies whether to permit users to enter a custom value in the MAILFROM field on the Email Attribute panel.
Syntax:
MAILFROM=YES|NO
Default: YES
  • YES
    Lets users specify a custom value in the MAILFROM field.
  • NO
    Prohibits users from specifying a custom value in the MAILFROM field.
MAILTO
Specifies the system to which the email is sent.
Syntax:
MAILTO=JES|ESF
Default: None
  • JES
    Sends the email to the JES destination in the MAILDEST initialization parameter, using the OUTPUT statement mail parameters. You can use MAILTO=JES to write the email output to JES. From there you can use the Network Job Entry facility (NJE) to automatically route the email report to a remote CA Spool system.
  • ESF
    Sends the email to the CMASPOOL destination in the MAILDEST initialization parameter, using the OUTPUT mail parameters.
For individual reports or jobs, users can optionally print or email output to an alternate CA Spool subsystem instead of the one in the CMASPOOL parameter. For details, see Print Output Online or in Batch  or Email Output.
For JES and ESF, see the
IBM z/OS MVS JCL Reference
for details about the OUTPUT statement mail parameters.
MASTER
This parameter specifies the user ID of the CA View user who has
master authorit
y. Master authority allows you to issue the DEF USER command, and to define access authority for all users.
Syntax:
MASTER
=userid
|ALL
The default is MASTER=ALL.
MASTER=ALL indicates no restrictions, giving all users master authority. A user with master authority can assign master authority to any other user, with the DEF USER command.
MAXLINES
This parameter specifies the maximum number of lines to be archived to the database per SYSOUT group.
Syntax:
MAXLINES
=nnn,
BYPASS | BYPASSDS
,ddd
The default is 0.
Values are as follows:
  • nnn
    Specifies the maximum amount of lines to be archived to the database per SYSOUT group.
    Valid values are 1 to 16777216. A value of 0 indicates that there is no limit for the reports.
  • BYPASS
    An optional parameter that specifies that any lines in excess of the number (nnn) in a SYSOUT group are deleted without archival.
    If left blank, the lines in excess of nnn are passed to the user exit SARSTCUX for processing.
  • BYPASSDS
    An optional parameter that specifies that any lines in excess of the number (nnn) in a SYSOUT data set are deleted without archival. Subsequent data sets in the SYSOUT group are archived.
  • ddd
    For the direct-to-CA View archival feature of CA Deliver, specifies the maximum number of lines to be archived per report.
    Valid values are 1 to 16777216. A value of 0 indicates that there is no limit for the reports. Records in excess of the specified limit are discarded.
    If the report is also designated for printing, the entire report is printed.
Omitted values (as in MAXLINES=,,50000) are set to the default values, not to the value set in the previous run.
These options pertain to SYSOUT data that is archived to the database and do not affect SYSOUT data that is archived directly to tape (see the TAPECLSL= initialization parameter). There is no maximum number of lines for tape archival. The SARSTCUX is called:
  • When the SYSOUT group is created
  • For every line of data
  • When the SYSOUT group is completed.
These actions occur regardless of the BYPASS sub-parameter setting.
MOUNT
This parameter specifies whether online tape mounts are allowed.
Syntax:
MOUNT
=YES
|NO
The default is YES.
Values are as follows:
  • YES
    Allows online tape mounts.
    For native TSO and SPF/ISPF, when you specify this option, the user attributes (UADS) for the user determines whether online tape mounts are allowed.
    When using an external security package (RACF, CA ACF2 Security, CA Top Secret Security, and so on) the user must be granted access to the MOUNT resource under the TSOAUTH class.
  • NO
    Prevents online tape mounts.
MSORT1 to MSORT5
This parameter specifies the name of the first field to be sorted by the microfiche format program.
Syntax:
MSORT1=
xxxxxxx
MSORT2=xxxxxxx MSORT3=xxxxxxx MSORT4=xxxxxxx MSORT5=xxxxxxx
Additional fields to be sorted are specified by MSORT2, MSORT3, MSORT4, and MSORT5. These parameters determine the order in which SYSOUT is output to microfiche. The field is sorted in ascending order.
To have the microfiche program sort the field in descending order, precede the name by a minus sign (for example, MSORT1=-JNAME). The field names you can specify are shown in the following table.
Note:
If no sort parameters are specified, the microfiche format program generates output SYSOUT in ascending order by SYSOUT identification, and then descending order by date and time of archival.
Valid field names for
xxxxxxx
are as follows:
  • ATDTE
    Represents Date and time of archival.
  • CLASS
    Represents SYSOUT class.
  • DEST
    Represents SYSOUT destination.
  • FORMS
    Represents SYSOUT forms name.
  • ID
    Represents SYSOUT identification.
  • JID
    Represents Subsystem job identifier.
  • JNAME
    Represents Job name.
  • WTR
    External writer name.
  • XCODE
    Exception code.
  • Umm:nn
    User accounting data supplied by either the SARACTUX or SARSTCUX user exits (up to 20 characters of user data).
    The beginning and ending positions in the user data are specified by mm and nn, respectively:
    • If mm is omitted, 1 is assumed for the beginning position.
    • If nn is omitted, 20 is assumed for the ending position.
    • If nn is omitted, the colon can also be omitted.
NAME
This parameter specifies the high-level name of the database.
Syntax:
NAME=
index
If omitted, the high-level name specified as the PARM parameter on the EXEC SARINIT JCL statement, if any, is used.
NARCCLSL
This parameter specifies a list of one to eight SYSOUT classes that CA View is not to archive. Any SYSOUT originally output to one of the classes is selected and processed but is not archived. In general, the classes should also be specified for automatic printing, or the SYSOUT is deleted.
Syntax:
NARCCLSL=
xxxxxxxx
There is no default.
NBACKUP
This parameter specifies the number of interim backups done during the time specified with the INTERVAL initialization parameter. These backups do not cause the generation number to be incremented. The backups are executed at equal intervals within this time.
Syntax:
NBACKUP=
nnnnn
The default is 0.
Valid values are 0-32767.
To determine the time spacing between interim backups, add 1 to the NBACKUP number and then divide that number into the INTERVAL number.
NEWCLSL
This parameter specifies a list of one to eight SYSOUT classes used to print archived SYSOUT, both online and in batch.
Syntax:
NEWCLSL=xxxxxxxx
The classes in the list correspond to those specified by the CLSL parameter. The default is the original class. For example, if CLSL=AB and NEWCLSL=CD are specified as parameters, any class A SYSOUT is printed by CA View as class C, and any class B SYSOUT is printed as class D. If no corresponding class is specified by using the NEWCLSL parameter, CA View prints SYSOUT using the original class under which it was created.
Note:
The TSOCLS parameter (online printing from TSO) and the JCLASS parameter (batch printing), if specified, override this parameter.
NEWDEST
This parameter specifies the destination used to print archived SYSOUT. If NEWDEST is not specified, CA View prints SYSOUT using the original destination under which it was created.
Syntax:
NEWDEST=
xxxxxxxx
There is no default.
Note:
The TSODEST parameter, if specified, overrides the parameter for online retrieval printing.
NEWFORM
This parameter specifies the one- to eight-character forms name used to print archived SYSOUT. If NEWFORM is not specified, CA View prints SYSOUT using the original forms name under which it was created.
Syntax:
NEWFORM=
xxxxxxxx
There is no default.
Note:
The TSOFORM parameter, if specified, overrides this parameter for online retrieval printing.
NEWPASS
This parameter specifies whether a new password must be entered twice to verify its accuracy.
Syntax:
NEWPASS=VERIFY|NOVERIFY
The default is NOVERIFY.
NGEND
This parameter specifies the number of generations maintained on disk.
Syntax:
NGEND
=nnnnn
The default is 3.
Valid values are 1-32767. The smallest allowable value is NGEND=1, which keeps only the current archival generation on disk.
NGENI
This parameter specifies the number of master indexes maintained on storage group 0. All storage group 0 tapes containing generations within the last NGENI generations are kept. Other storage group tapes are kept only if they contain reports that are kept.
Syntax:
NGENI
=nnnnn
The default is the value of NGENT.
Valid values are 1-32767.
NGENT
This parameter specifies the number of total generations to be maintained on tape.
Syntax:
NGENT
=nnnnn
The default is 90.
Valid values are 1-32767.
OUTLIM
This initialization parameter is used to set the maximum number of lines that can be reprinted in an online or batch environment.
Notes:
  • Some VTAM and CA Spool device definitions can have a maximum line specification or have used the VPRTMAXO and/or the CMAMAX initialization parameter to specify a default maximum line limit.
  • Any non-zero value is used in place of the on-line OUTLIM value. If the device specification value is not specified, the OUTLIM on-line value is used.
Syntax:
OUTLIM
=online,batch
Zero is the default if not specified.
  • Online
    A number between 0 and 16777000. Online reprints that exceed this number have their output truncated and appended with the message:
    SARGET01 ** Maximum lines exceeded specified limits **
    Users defined as MASTER users in the online DEF USER screen or with the SARBCH DEFUSER function are permitted to print reports that exceed the OUTLIM value; be aware that these users are not automatically assigned the Y for MASTER in their user profile -- the Y must be set with the DEF USER command or the SARBCH/DEFUSER function.
    Note:
    Zero indicates no online reprint line limit.
  • Batch
    An optional parameter that specifies that any lines in excess of the number (nnn) in a SYSOUT group are deleted without archival.
    If left blank, the lines in excess of nnn are passed to the user exit SARSTCUX for processing.
PAGEMARK
This parameter specifies whether pages are identified and numbered when archived.
Syntax:
PAGEMARK
=
YES|NO|ONLY
The default is YES.
  • YES
    Pages are to be identified and numbered when archived.
  • NO
    Pages are not to be identified and numbered when archived.
  • ONLY
    Pages are to be identified and numbered when archived, but DATASET LIST information is not to be displayed on the SARPAGE line.
PRINTTO
This parameter specifies where to route JES print requests for printer device destinations that are not predefined.
Syntax:
PRINTTO=JES|ESF|ESFJES
The default is JES.
  • JES
    Prints to JES destinations.
  • ESF
    Prints to the CA Spool subsystem that is defined in the CMASPOOL parameter.
  • ESFJES
    Prints to the CA Spool subsystem that is defined in the CMASPOOL parameter.
    If the destination is not known to CA Spool, prints to JES destination.
For individual reports or jobs, users can optionally print or email output to an alternate CA Spool subsystem instead of the one in the CMASPOOL parameter. For details, see Print Output Online or in Batch or Email Output.
PRTALL
This parameter specifies, for the EXPO mode of CA View, an initial default value used in CA Deliver reprints.
PRTALL determines whether the OUT indicator in the distribution identifier used during a reprint.
Syntax:
PRTALL=YES|NO
The default is YES.
Values are as follows:
  • YES
    The OUT indicator of the distribution identifier is ignored.
  • NO
    The OUT indicator of the distribution identifier is used.
PRTASA
This parameter specifies whether CA View reprints are to be in ASA or machine control characters.
Syntax:
PRTASA=YES|NO
The default is NO.
PRTCLSL
This parameter specifies a list of one to eight SYSOUT classes, so that any SYSOUT originally output to one of the classes is automatically printed by CA View when it is archived.
Syntax:
PRTCLSL=
xxxxxxxx
There is no default.
Note:
For this initialization parameter to work properly, the JES2 initialization statement STCCLASS must specify OUTPUT=YES.
PRTDSN
This parameter specifies whether a user can print reports to a data set.
Syntax:
PRTDSN=YES|NO
If
PRTDSN
is set to YES, then the
Print Attribute Panel
includes parameters for data set name and disposition.
The default is NO, which enables only print to SYSOUT.
The
PRTDSN
initialization parameter is supported only for databases that are versioned to
CA View®
v14.
RCVPRIM
This parameter specifies the primary space allocation for the forward recovery data sets. This is required for forward recovery to be activated.
Syntax:
RCVPRIM
=nnnnn
The default is 0.
Valid values are 0-65535.
RCVSEC
This parameter specifies the secondary space allocation for the forward recovery data sets. This space is used when the primary space allocation is exhausted or when the forward recovery is activated.
Syntax:
RCVSEC
=nnnnn
The default is 0.
Valid values are 0-65535.
RCVSPACE
This parameter specifies whether the space allocation for the forward recovery data sets is to be obtained in tracks (TRKS) or cylinders (CYLS).
Syntax:
RCVSPACE=TRKS|CYLS
The default is TRKS.
This parameter is optional.
RCVUNIT
This parameter specifies the unit name or unit type where the forward recovery data sets are to be allocated. This is required for forward recovery to be activated.
Syntax:
RCVUNIT
=unit
There is no default.
REDISP
This parameter specifies whether the Enter key will invokes the REDISP function, which causes a refresh/update of SYSOUT and report selection lists. Automatic redisplay has been disabled for sorted selection lists because of the overhead created by the online SORT command. This parameter has no effect if the user has sorted the selection list - in this case they must type REDISP to refresh the list.
Syntax:
REDISP=YES|NO
The default is NO.
RETPD
This parameter specifies the number of days to be maintained on tape when you are allocating a new tape data set.
The RETPD and EXPDT parameters are mutually exclusive. The most recently entered parameter (EXPDT or RETPD) takes precedence over the other. Specifying RETPD causes EXPDT to be set to spaces. If RETPD and EXPDT are specified together, EXPDT always takes precedence over RETPD with RETPD being set to spaces.
Syntax:
RETPD
=nnnn
There is no default.
Valid values are 1-9999.
Important!
Some tape management systems, such as CA 1, have abend dispositions for tapes. Make sure that your tape management system defaults to the catalog on an abend. Failure to do this can result in loss of data. Refer to your tape management system documentation for complete documentation.
ROUT
This parameter specifies the route code to be used for routing exceptional condition messages (message ID SARSTC99). The text for the exceptional condition message is extracted during the exceptional condition checking process or produced by the SARSTCUX user exit.
Syntax:
ROUT
=nn
The default is 0.
Valid values are 0-16. Specify a route code of up to 16 for the WTO that issues the messages. A route code of 0 suppresses the messages.
ROUTBKP
This parameter specifies a route code for the informational CA View backup messages SARBKT61 through SARBKT63.
Syntax:
ROUTBKP
=nn
The default is ROUTBKP=1.
Valid values are 1-16. The default value sends the messages to the master console.
SECID
This parameter specifies a one- to eight-character identifier that prefixes the resource name for external security.
Syntax:
SECID=
secid
The default is VIEW.
SECLIST
This parameter specifies whether selection lists are to be limited to data accessible to the user.
Syntax:
SECLIST=NONE|ALL|REPORT,INDEX,DEFINE,JOB
The default is NONE.
Values are as follows:
  • NONE
    Indicates that all of the selection list data is presented to the user, and accessibility is determined after the user selects the data.
  • ALL
    Indicates that all of the selection lists are to be limited to data accessible by the user.
  • REPORT, INDEX, DEFINE
    Identifies specific selection lists that are to be limited to data accessible to the user.
    You can specify any combination of REPORT, INDEX, DEFINE, or JOB.
    • REPORT
      Indicates the SYSOUT/Report Selection List.
    • INDEX
      Indicates the Index Name and Value Selection Lists.
    • DEFINE
      Indicates the User, SYSOUT, Distribution, Device, Filter, and View Definition Selection Lists.
      You can specify any combination of REPORT, INDEX, or DEFINE.
    • JOB
      Indicates the Job Selection List.
Specifying a
SECLIST
value other than none greatly increases the number of security calls and may affect overall system performance.
SECURITY
This parameter specifies whether database security is based on the DEFMODE initialization parameter, user definition records, or external security calls.
Syntax:
SECURITY=INIT|INTERNAL|EXTERNAL|LOGON
The default is INIT.
Values are as follows:
  • INIT
    Lets a new user access a database if the DEFMODE initialization parameter is
    not
    set to NNNNNN. Otherwise, the user name must be predefined to the database.
  • INTERNAL
    Specifies the same requirements as INIT except that the system uses predefined user definitions to verify the passwords of existing users.
  • EXTERNAL
    Uses an external security product (RACROUTE calls) to verify users.
  • LOGON
    Uses an external security product to verify user logins. Otherwise, this setting specifies the same requirements as INIT.
Do not set SECURITY=EXTERNAL or LOGON until you have added your security definitions to your security system. Otherwise, problems can occur, including S047 abends.
SECTRAN
If you use external security (RACF, CA ACF2 Security, or CA Top Secret Security) and if the report id contains characters from the extended special character set, set this parameter to SECTRAN=YES. This setting causes the extended special characters to be automatically translated to ‘_’ underscores before the RACROUTE security call.
Syntax:
SECTRAN=YES|NO
Default:
NO
SETPAGE
This parameter specifies whether to set PRMODE to PAGE when PAGEDEF, FORMDEF, or both are specified.
Syntax:
SETPAGE=YES|NO
The default is YES.
Values are as follows:
  • YES
    Sets PRMODE to PAGE when PAGEDEF, FORMDEF, or both are specified.
  • NO
    Leaves PRMODE as is.
SMF
This parameter specifies whether the archival task is to create special type-6 SMF records when it prints a SYSOUT group.
Syntax:
SMF=YES|NO
The default is NO.
SMFTYPE
This parameter identifies a unique SMF record type to the System Management Facility. This parameter is used for Metrics.
Note:
For more information about Metrics, see Metrics.
Syntax:
SMFTYPE=
nnn
where
nnn
is a value from 128 to 255.
The default for the parameter is zero, which bypasses the writing of CA View SMF records.
STACKBU
This parameter specifies whether stacked backup cycles should be processed normally or ignored. Stacked backup cycles occur when the archival task becomes suspended during a backup cycle (before the cycle is completed) due to the initiation of a second backup cycle. This condition is indicated with the SARBKU03 message.
Syntax:
STACKBU=YES|NO
The default is NO.
Values are as follows:
  • YES
    Processes stacked backup cycles.
  • NO
    Ignores stacked backup cycles.
START
This parameter specifies the name of the microfiche start procedure that is started after the current archival generation is completed and backed up to tape.
Syntax:
START=
xxxxxxxx
The default is no procedure.
STORGRP0
This parameter specifies the default tape storage group. With ERO (Expanded Retention Option), you can define up to nine additional tape storage groups.
Notes:
DR tapes do not use storage groups. These parameters are only used for primary and duplex tapes.
You must run a standard or interim backup cycle to assign reports to tape storage groups specifying appropriate storage group subparameters.
Syntax:
STORGRP0
=storage-group-name/tape-index/
maxgent-value/unit1-name
,
unit2-name
/
tvser1
,
tvser2
where:
  • storage-group-name
    Not considered for STORGRP0, the default storage group.
    If you define any additional storage groups (STORGRP1 to STORGRP9):
    • You must assign each one a group-name of up to eight alphanumeric characters.
    • The name DEFAULT is reserved for use by the SARPAC tape consolidation program, and therefore cannot be specified.
    Reports are assigned to tape storage groups by the ERO table statement STORGRP=storage-group-name.
  • tape-index
    Specifies an alternate naming prefix (up to 17 characters) for your backup tapes.
    If this parameter is changed, tapes previously produced by CA View are still accessible. If omitted, the high-level name of the database is used.
    There is no default.
  • maxgent-value
    The maximum number of generations that can be written to one tape volume.
    The minimum value is 1. The maximum value is 65535.
    The default is 10.
  • unit1-name, unit2-name
unit1 The tape unit name allocated for backup tape archival generations
unit2 Activates tape duplexing, and specifies its tape unit name
When duplexing is activated, two tapes are mounted during the backup cycle. The first tape is for the primary backup tape, and the second tape is for the duplex tape.
The default is TAPE.
When retrieving output from tape, CA View always uses the primary backup tape. Should an error occur on the primary backup tape and a duplex exists, the product automatically attempts to recover from the error by switching to the duplex tape.
  • tvser1,tvser2
    A range of tape volume serial numbers to be used for the backup archival generations.
    The default is any scratch tape.
    Volume serial numbers must be the same length, end with one or more numeric digits, and have matching beginning alphanumeric characters. Whenever a new tape is required to back up a generation, the next tape in the range is used. When the end of the range is reached, the first tape in the range is used.
Two different tape storage groups can specify the exact same range of tapes, or completely distinct ranges, but no partial overlap is allowed between groups.
STORGRX0
This parameter specifies additional attributes (extensions) for the tape storage groups. If you use tape duplexing, you can specify a volume serial range for the duplex tapes here. If you use tape duplexing, (indicated by the unit2-name in the STORGRP parameter), and the STORGRX parameter is specified without any values for
dtvser
1 and
dtvser
2, a scratch pool is used for the duplex volumes.
If the database is versioned up from a release prior to 1.7, the initial values for
dtvser
1 and
dtvser
2 are the same as for
tvser
1 and
tvser
2 (the primary range).
Syntax:
STORGRX0=
dtvser1,dtvser2/mxblks
where:
  • dtvser1, dtvser2
    A range of tape volume serial numbers used for the duplex backup archival generations.
    The default is any scratch tape.
    Volume serial numbers must:
    • Be the same length
    • End with one or more numeric digits
    • Have matching beginning alphanumeric characters.
    Whenever a new tape is required to back up a generation, the next tape in the range is used. When the end of the range is reached, the first tape in the range is used.
  • mxblks
    The maximum number of storage blocks to which to write the primary and duplex volumes (the primary and duplex volumes are mirror images).
    The minimum value is 10. The maximum value is 99,999,999.
    The default of 0 means to write to end-of-volume.
Two different tape storage groups can specify the exact same range of tapes, or completely distinct ranges, but no partial overlap is allowed between groups.
TAPECLSL
This parameter specifies a list of one to eight SYSOUT classes, so that any SYSOUT originally output to one of the classes is directly archived to tape, and no archival is done to disk.
Syntax:
TAPECLSL=
xxxxxxxx
There is no default.
Note:
This parameter is a secondary criterion -- that is, output must first satisfy the primary criteria of CLSL, DEST, and FORM before it is considered for application of this parameter.
TAPEOPT
This parameter specifies the options for tape processing.
Syntax:
TAPEOPT
=
3480|EAST,HARD|NOHARD,SOFT|NOSOFT
The default is 3480,HARD,NOSOFT.
Values are as follows:
  • 3480|EAST
    Specifies whether archival tapes are written using 3480 (includes 3490 and 3590) data block location processing 3480/3490/3590 tape processing is a requirement for the expanded access server for tape and robotics.
    The Expanded Access Server for Tape/Robotics (EAST) is the same as 3480 tape processing; however, the EAST is to be used, whenever possible, to access reports from tape.
  • HARD|NOHARD
    Specifies whether the hardware compaction feature is to be used for compacting data for a tape device enabled for hardware compaction.
    HARD specifies that the hardware compaction feature is to be used.
    NOHARD specifies that the hardware compaction feature is not to be used.
    If you use 3490E/3590 tape drives, you must specify HARD.
  • SOFT|NOSOFT
    Specifies whether CA View is to compress data when creating backup tapes.
    SOFT specifies that software compression is to be used.
    NOSOFT specifies that software compression is not to be used.
TAPESEQ
This parameter specifies the starting tape sequence number established in a new database.
Syntax:
TAPESEQ
=nnnnn
The default is 1.
Valid values are 1-65535.
This parameter is to be modified only at the direction of a
Broadcom Support
representative.
TBACKUP
This parameter specifies backup options.
Syntax:
TBACKUP
=
YES|NO|IDX
The default is YES.
The CA View database has a tape capacity of 65535 tapes. Once tape capacity reaches 90 percent, SARBKT98 informational messages are in the SARSTC task. If full tape capacity is reached, an SARTPO61 error message is issued, and the SARSTC task issues an U0061 abend.
Values are as follows:
  • YES
    Both the SYSOUT groups archived to the current disk generation and the master index are written to tape as part of the backup cycle.
  • NO
    Neither the SYSOUT groups archived to the current disk generation nor the master index is written to tape as part of the backup cycle.
  • IDX
    Only the master index is written to tape as part of the backup cycle.
Specifying either NO or IDX for the TBACKUP parameter can prevent future recovery of data if there is a media failure or other type of failure.
TIME
This parameter specifies the time at which the first backup cycle is automatically initiated by CA View.
Syntax:
TIME=
hhmm
The default is 0, which suppresses all automatic backup cycles.
The value is based on a 24-hour clock, where
hh
is the hour, and
mm
is the minute. Subsequent backup cycles are automatically initiated at regular intervals specified with the INTERVAL parameter. Automatic backup cycles are suppressed on those days identified by an N in the DAYS parameter.
Note:
Those areas that conform to Daylight Savings Time should consider a backup cycle start time outside the range of 1:00 a.m. through 3:00 a.m. A start time between 1:00 a.m. and 2:00 a.m. may cause two backup cycles to be processed when the time is changed back to standard time. A start time between 2:00 a.m. and 3:00 a.m. can cause a backup cycle to be missed when the time is set forward to Daylight Savings Time. Both of these conditions affect the generation number within the database.
TPO54
This parameter specifies whether message SARTPO54 (TAPE TO BE MOUNTED NEEDS WRITE CAPABILITY) is to be displayed for the remounting of archival tapes.
Syntax:
TPO54=YES|NO
The default is YES.
TSOCLS
This parameter specifies the SYSOUT class to appear on the Print Attribute panel when a SYSOUT is printed with the online P selection code from the TSO online retrieval facility.
Syntax:
TSOCLS
=x
The default is NEWCLSL/original.
Specify an asterisk (TSOCLS=*) to have the TSO online retrieval session class used as the CLASS. The default is the NEWCLSL initialization parameter, and, if NEWCLSL is not specified, the CLSL from the original SYSOUT job.
TSODEST
This parameter specifies a valid SYSOUT destination used to print SYSOUT with the TSO online retrieval feature. Specify an asterisk to use the system default SYSOUT destination.
Syntax:
TSODEST=
xxxxxxxx
The default is NEWDEST/original.
TSOFORM
This parameter specifies a one- to eight-character SYSOUT forms name used to print SYSOUT with the online retrieval feature.
Syntax:
TSOFORM
=xxxxxxxx
The default is the NEWFORM/original forms name.
Specify an asterisk to use the system default forms name for the online session.
TSOSCHED
This parameter schedules background SYSOUT retrieval.
Syntax:
TSOSCHED=SUBMIT|INTRDR
The default is SUBMIT.
Values are as follows:
  • SUBMIT
    Uses the TSO SUBMIT command processor to schedule background SYSOUT retrieval from a foreground session.
  • INTRDR
    Directly allocates an internal reader to schedule background SYSOUT retrieval from a foreground session.
This parameter is used for the ISPF and TSO online interfaces,
not
the ISPF/cross-memory or TSO/cross-memory interface.
UNITSPEC
This parameter is used if there is the possibility of a conflict of units during dynamic allocation of backup media. CA View uses the MVS catalog device types to allocate backup media. If necessary, use this parameter to specify the esoteric names of up to two backup media units (tape, optical, and so on) that have the same device type as other devices in the system.
Syntax:
UNITSPEC=
unit1
,
unit2
There is no default.
For example, if you have a pool of 3480-type tape drives, and a pool of 3480-type optical drives, you can specify:
UNITSPEC=
optname
where
optname
is the esoteric name of the optical drives.
UNLOAD
This parameter specifies whether the tape is to be unloaded and the drive freed during direct-to-tape archival.
Syntax:
UNLOAD=NO|YES|NOWORK
The default is NO.
Values are as follows:
  • YES
    Unloads the tape after the SYSOUT group is archived direct-to-tape.
  • NO
    Leaves the tape mounted after the SYSOUT group is archived direct-to-tape.
  • NOWORK
    Leave the tape mounted until there are no more SYSOUT groups to be direct-to-tape archived, even if the remaining groups are going to disk.
USERLIB
USERLIB=YES|NO
  • YES
    Allocates the reprints output statement with all USERLIBs either stored with the reports or added to the Reprint Attribute Output Parameters.
  • NO
    Bypasses all the output statement USERLIB allocations.
USERLVL
This parameter determines whether users get the Beginning or Advanced Primary Selection Menu in the online modes EXP and EXPO. This parameter affects only the Primary Selection Menu.
Syntax:
USERLVL=BEGINNER|ADVANCED
The default is BEGINNER.
VPRTAPPL
This parameter specifies the first four characters of the VTAM APPLIDs to be used by the CA View VTAM Print Option (VPO). These characters are coupled with a number, from 000 to 9999, to form the actual VTAM APPLID.
Syntax:
VPRTAPPL
=cccc
There is no default.
Note:
A value for this number (if provided in the application program definition tables, usually located in SYS1.VTAMLST) is used.
VPRTMAXO
This parameter specifies the maximum number of lines that can be printed from an online session by using the P print selection code and is used by the CA View VTAM Print Option (VPO).
Syntax:
VPRTMAXO
=nnnnn
The default is 0.
Valid values are 0-65535.
Note:
The hierarchy of values is:
  • Device Definition
  • VPRTMAXO (if a Maximum Line is left blank in the Device Definition)
  • OUTLIM
If a Maximum Line is left blank in the Device Definition and both VPRTMAXO and the on-line value for OUTLIM are set to zero, there is no limit to the number of lines that can be printed online.
VPRTONL
This parameter specifies whether users can print from an online session using the P (print) selection code used by the CA View VTAM Print Option (VPO).
Syntax:
VPRTONL=YES|NO
The default is YES.
Note:
The user's terminal is locked for the duration of the printing.
VPRTRINT
This parameter specifies the interval in seconds between attempts to establish contact with a printer and is used by the CA View VTAM Print Option (VPO).
Syntax:
VPRTRINT
=nnnnn
If VPRTAPPL is specified as SARV, and SYS1.VTAMLST contains SARV0000 - SARV0009, CA View attempts to contact the designated printer using SARV0001, SARV0002…SARV0009.
The minimum value is 1. The maximum value is 65535.
The default is 60.
VPRTRTRY
This parameter specifies the number of times CA View tries to reestablish contact to a printer and is used by the CA View VTAM Print Option (VPO).
Syntax:
VPRTRTRY
=nnn
If VPRTAPPL is specified as SARV, and SYS1.VTAMLST contains SARV0001-SARV0009, CA View attempts to contact the designated printer using SARV0001, then SARV0002,…SARV0009. The minimum value is 1. The maximum value is 255.
The default is 10.
WAIT
This parameter specifies whether the archival task is to wait for SYSOUT to archive or terminates when there is no more SYSOUT available from JES.
Syntax:
WAIT=YES|NO
The default is YES.
Most sites use the default value.
WRITER
This parameter specifies whether the WRITER field is to be propagated from DEST=ESF.USER1 with the WRITER being made equal to USER1.
Syntax:
WRITER=ASIS|DESTUSER
The default is ASIS.
  • ASIS
    The WRITER field is left unchanged.
  • DESTUSER
    The USER1 portion of DEST=ESF.USER1 is propagated to the WRITER field.
XPRINT
This parameter specifies whether CA View automatically prints any SYSOUT in which an exceptional condition occurs. Exceptional conditions are determined during the exceptional condition checking process or are determined by user code in the SARSTCUX user exit.
Syntax:
XPRINT=YES|NO
The default is YES.