Initialization Parameter Statements (SMF - XPRINT)

Select a parameter:
view
Select a parameter:
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
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
    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,
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
    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
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
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.
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
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
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
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
View
VTAM Print Option (VPO).
Syntax:
VPRTRINT
=nnnnn
If VPRTAPPL is specified as SARV, and SYS1.VTAMLST contains SARV0000 - SARV0009,
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
View
tries to reestablish contact to a printer and is used by the
View
VTAM Print Option (VPO).
Syntax:
VPRTRTRY
=nnn
If VPRTAPPL is specified as SARV, and SYS1.VTAMLST contains SARV0001-SARV0009,
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
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.