Initialization Parameter Statements (MAILDEST - SETPAGE)

Select a parameter:
view122
Select a parameter:
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
Spool
is running, and the targeted
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
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
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
    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
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
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-
    View
    archival feature of
    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,
    ACF2
    ,
    Top Secret
    , 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
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
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,
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,
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,
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
    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
    Spool
    subsystem that is defined in the CMASPOOL parameter.
  • ESFJES
    Prints to the
    Spool
    subsystem that is defined in the CMASPOOL parameter.
    If the destination is not known to
    Spool
    , prints to JES destination.
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.
PRTALL
This parameter specifies, for the EXPO mode of
View
, an initial default value used in
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
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
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.
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
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,
ACF2
, or
Top Secret
) 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.