Initialization Parameter Statements (DRTAPE - LOGO)

Select a parameter:
view122
Select a parameter:
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
    View
    2.0 parameter EASTDPLX=OLY. It allows EAS to call the duplex tapes before calling the primary tapes.
    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
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
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
View
data.
Syntax
ENCRYPT=NO | ICSF,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.
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
View
.
There is no default expiration date. The suggested value is 99000.
Important!
Some tape management systems, such as
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
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
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
Broadcom
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
View
green screen users:
Allows a cross-report index to use 1 MB of storage.
For
Web Viewer
users:
Allows a cross-report index report limit threshold of 4000 reports.
FEATURE=3
For
View
green screen users:
Allows a cross-report index to use 4 MB of storage.
For
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
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
View
started task.
FEATURE=6
Enables an option which can display the
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
Spool
errors that may result when reprinting logical views.
FEATURE=8
Enables an option that displays
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
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
View
1.7 and MHA2015 in
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
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=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
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
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
    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
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
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. To view JOB mode data, set the value of this parameter to YES. 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 Release 12.2.
For
View
12.2 GA, JOB mode is automatically activated for databases that are versioned to a 12.2 release level. PTF R094022 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 database release level is versioned to release 12.2 or higher
  • When you create a new 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 default is R.
  • R (or blank)
    Signifies English.
  • C
    Signifies Canadian French.
  • D
    Signifies Danish.
  • G
    Signifies German.
Values for panel preference code (Second character of the LANGUAGE parameter) are as follows:
  • (blank)
    Signifies Standard selection list display panels.
  • S
    Signifies Selection list display panels with shortened identifier names (for compatibility with Release 2.0 format).
Notes:
  • If S is specified for the panel preference code, the language code must 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
View
logo panel is displayed when the user first enters the system.
Syntax:
LOGO=YES|NO
The default is YES.