Initialization Parameter Statements (ACIRCOMP - DRMOD)

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
View
should reprint AFP reports with embedded resources, allowing
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
    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
    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,
    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
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
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
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
View
backup cycle is to invoke cleanup processing of
Deliver
direct-to-
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
    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
    Deliver
    OPEN subfiles, only SYSOUT subfiles left open by SARSTC or a
    View
    FSS collector.
  • SYSOUT files originating from
    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
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
View
, it is still deleted after two consecutive backup cycles complete processing. If the SYSOUT originated in
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
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
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
Spool
to print.
CMASPOOL specifies the 4-character name of the
Spool
subsystem that is defined in the
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
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
    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
    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
Deliver
-direct-to-
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
Deliver
direct-to
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.