Introduction to Startup Parameters

#### Search Results

Search

# Introduction to Startup Parameters

This section explains how to use the Entire System Server startup parameters.

Note
Support for z/VSE is deprecated. Support for BS2000 is also deprecated, except in conjunction with the ESM adapter. Features that are z/VSE and BS2000 specific will be removed from future releases.

This document covers the following topics:

- Using the Startup Parameters

- Parameters without Default Value

- Example Parameter Members

## Using the Startup Parameters

You must edit this member as part of the installation procedure. This includes customizing parameter values to suit your site, and/or adding any parameters that are specific to add-on systems that use the Entire System Server (for example, Entire Operations, Entire Event Management, Entire Output Management).

Note
Parameters specific to an add-on system are described in that system's installation manual.

Thereafter, you can modify parameters as required for customization purposes to reflect changing conditions at your site. After each modification of the parameter member, you must restart the Entire System Server to pick up the changes.

## Parameters without Default Value

Unspecified parameters take the default value. The parameters listed below have no default value and must be specified:

### z/OS, z/VSE

- `ADA5SVC`

- `NODE`

### BS2000

- `JOBSERVER`

- `NODE`

## Example Parameter Members

Example parameter members are illustrated below according to operating system.

Note
Not all possible parameters are listed. Parameters specific to any add-on system can be added (these are described in the relevant system's installation manual). Optional parameters not specified take the default value.

In the following examples, the abbreviation `NPRvrs` stands for the current version, release, system maintenance level of the product.

### z/OS, z/VSE:

      ***********************************************************************
      *            Startup Parameters for Entire System Server              *
      ***********************************************************************
      *
      *   Identification
      *
      NODE=148
      IDENTIFIER=TEST-SYSTEM
      LOCAL=NO
      FORCE=NO
      ***********************************************************************
      *
      *   Interface to spooling system
      *
      SPOOL=JES2                  /* SPOOL=POWR for z/VSE
      ***********************************************************************
      *
      *   Interface to external security system
      *
      SECURITY=RACF
      AUTOLOG=YES
      ***********************************************************************
      *
      *   Interface to Adabas
      *
      ADA5SVC=249
      ***********************************************************************
      *
      *   Interface to VTAM
      *
      SPOOLACB=DNOM148S         /* see SYS1.VTAMLST(APPLNA)
      VTAMACB=DNOM148V          /* see SYS1.VTAMLST(APPLNA)
      VTAMQLEN=100
      ***********************************************************************
      *
      *   Logging parameters
      *
      LOGGING=NO
      LOGCB=YES
      LOGFB=YES
      LOGRB=YES
      LOGSB=YES
      LOGVB=YES
      ***********************************************************************
      *
      *   Queue and time parameters
      *
      NCQE=30
      NABS=20
      CDATALEN=200
      *
      TIME=100
      LOOP=30
      NONACT=30
      ***********************************************************************
      *
      *   Miscellaneous parameters
      *
      TEMPUNIT=SYSDA
      MSGLEVEL=2
      SMFREC=0
      ***********************************************************************
      *
      *   Natural parameters
      *
      NATNUMSUB=6
      NATMOD=NSATT05           /* Natural Monitor Module (z/OS only)
      *STRTNTP1=STACK=(LOGON SYSSAT SATMON SATMON; /* (for SAT products only)
      *STRTNTP2=SATSTART ESYUSER=SATMON)           /* (for SAT products only)
      *NUMLIBS=300             /* (z/VSE only)
      *NUMTASK=10              /* (z/VSE only)
      *              END**END**END**END**END**END**END**END**END             *

### BS2000

    **********************************************************************
    * Startup Parameter NODE 199                                         *
    **********************************************************************
    * JOB...- and PRM...-Parameters must contain the complete syntax,    *
    * as it is needed for the corresponding parameters of ENTER command. *
    *                                                                    *
    * Example:                                                           *
    * ISP .... JOBSERVER=$SAG.NPRvrs.JOBS(E.ESYSERV)                     *
    * SDF .... JOBSERVER=*LIB-ELEM(LIB=$SAG.NPRvrs.JOBS,ELEM=E.ESYSERV)  *
    *                                                                    *
    * The value of JOB... cards is appended to command                   *
    * ISP .... 'ENTER '                                                  *
    * SDF .... 'ENTER-JOB FROM-FILE='.                                   *
    *                                                                    *
    **********************************************************************
    *
    NODE=199
    IDENTIFIER=PRODUCTION-NODE
    *
    ACCOUNT-NATSUB=1              No default     NATURAL-SUB-TASK Account
    AUTOLOG=YES                   Def.: YES      YES|NO
    CDATALEN=1024                 Def.: 0 K      Size of COMMON-DATA MP
    CONACCESS=WRITE               Def.: NONE     Access NONE|READ|WRITE
    EVENTLEN=1024                 Def.: 0 K      Size of EVENTING MP
    FORCE=NO                      Def.: NO       DBID table entry overwrite
    HOST-CODE-PAGE=EDF03IRV *NEW* No default     Host code page
    IDTNAME=ADABAS5B              Def.: ADABAS5A Name of ADABAS IDT MP
    IUBL=12000                    Def.: 8000     MAXLEN of all ADABAS bufs
    LANGUAGE=E                    Def.: E        Language code E|G
    LOCAL=NO                      Def.: NO       Local node
    LOGCB=YES                     Def.: NO       Log ACB of ADABAS
    LOGFB=YES                     Def.: NO       Log ADABAS format buffer
    LOGGING=NO                    Def.: NO       Activate command logging
    LOGRB=YES                     Def.: NO       Log ADABAS record buffer
    LOGSB=YES                     Def.: NO       Log ADABAS search buffer
    LOGVB=YES                     Def.: NO       Log ADABAS value buffer
    LOOP=0                        Def.: 0 SEC    Loop time limit
    MONITOR-CANCEL=YES      *NEW* Def.: NO       Cancel Natural subtasks
    MSGLEVEL=I                    Def.: I        Message level I|W|E
    NABS=20                       Def.: 10       Number attached buffers
    NATDYNPAR=FILE                Def.: SYSDTA   FILE|SYSDTA|SYSIPT
    NATNUMSUB=20                  Def.: 0        Number NATURAL-SUB-TASKS
    NCQE=20                       Def.: 10       Number CMD-QUEUE-ELEMENTS
    NONACT=30                     Def.: 60 MIN   User non-activity time
    NUMCONSMSG=2048         *NEW* Def.: 1024     Number CONSOLE MSG entries
    NUMFAT=256                    Def.: 128      Number Fast Access Tables
    NUMMAIL=256                   Def.: 0        Number E-MAIL Entries
    NUMTASK=1                     Def.: 4        Number SERVER Tasks
    NUMUSER=128                   Def.: 128      10 - 512 USER CBs
    PRODUCT=M                     No default     M = LMS
    RECALL=NO                     Def.: YES      Recall migrated files
    SDF=YES                       Def.: NO       Internal use of SDF CMDs
    SECURITY=BS2                  Def.: NONE     User security
    SERVER-DYN=YES                Def.: NO       Dynamic SERVER Management
    SERVER-MAX=16                 Def.: 16       Max # SERVER
    SERVER-MIN=1                  Def.: 1        Min # SERVER

    SERVER-NONACT=5 Def.: 10 MIN SERVER non-activity time
    SERVER-QUEUE-DEPTH=2 Def.: 5 Depth of SERVER input Q
    SHUTDOWN-MAX-DELAY=180 Def: 0 SEC 0 - 600
    SMTP-HOST=mailhost No default SMTP Host (Mail gateway)
    SMTP-PORT=25 Def.: 25 SMTP Host port number
    SPOOL=BS2 Def.: BS2 BS2|NONE
    * STDUSER= No default Default USER-ID ASCII world
    * SYNCDB=(063,11177) Def.: NONE DBIDs which must be active
    * SYNCTIME=5 Def.: 0 SEC Wait time before next check
    * TAPES=NO Def.: NO Tape support
    TIME=30 Def.: 30 SEC Timeout for user replies
    TRACE=PREP Def.: PREP PREP|YES|NO
    TRACE-LEN=1024 Def.: 8 K Size of TRACE MP
    TRACE-SAV=YES Def.: YES Save traces at exit
    * UEX4=RESYEXIT No default Name ADABAS Exit 4
    * VIEWSEC=NONE Def.: NONE View processor exit
    *
    JOBCONS=*LIBRARY-ELEMENT(LIBRARY=$SAG.NPRvrs.JOBS,ELEMENT=E.ESYCONS)
    JOBEMAIL=*LIBRARY-ELEMENT(LIBRARY=$SAG.NPRvrs.JOBS,ELEMENT=E.ESYMAIL4)
    JOBEVENT=*LIBRARY-ELEMENT(LIBRARY=$SAG.NPRvrs.JOBS,ELEMENT=E.ESYEVTM)
    * JOBNATSUB=*LIBRARY-ELEMENT(LIBRARY=$SAG.NPRvrs.JOBS,ELEMENT=E.SAT)
    JOBSERVER=*LIBRARY-ELEMENT(LIBRARY=$SAG.NPRvrs.JOBS,ELEMENT=E.ESYSERV)
    *
    PRMCONS=START=*IMMEDIATELY,RESOURCES=*PARAMETERS(CPU-LIMIT=*NO)
    PRMEMAIL=START=*IMMEDIATELY,RESOURCES=*PARAMETERS(CPU-LIMIT=*NO)
    PRMEVENT=START=*IMMEDIATELY,RESOURCES=*PARAMETERS(CPU-LIMIT=*NO)
    PRMNATSUB=START=*IMMEDIATELY,RESOURCES=*PARAMETERS(CPU-LIMIT=*NO)
    PRMSERVER=START=*IMMEDIATELY,RESOURCES=*PARAMETERS(CPU-LIMIT=*NO)
    *
    *--------------------------------------------------------------------*
    * NATURAL-SUB-TASK skeleton:                                         *
    *--------------------------------------------------------------------*
    *
    SATSKEL-BEGIN
    /.&UID    SET-LOGON-PARAMETERS
    / MODIFY-JOB-OPTIONS  INFORMATION-LEVEL=*MEDIUM, -
    /                     OPERATOR-INTERACTION=*YES, -
    /                     LOGGING=*PARAMETERS(LISTING=*YES)
    / MODIFY-TEST-OPTIONS DUMP=*YES
    / ASSIGN-SYSDTA       TO=*SYSCMD
    / ASSIGN-SYSLST       TO=L.&UID.&TSN.&CTR
    / SHOW-JOB-STATUS     JOB-IDENTIFICATION=*OWN
    / ADD-FILE-LINK       LINK-NAME=BLSLIB00, -
    /                     FILE-NAME=&NPRLIB
    / ADD-FILE-LINK       LINK-NAME=DDLNKPAR, -
    /                     FILE-NAME=ADALNK.PARMS
    / ADD-FILE-LINK       LINK-NAME=DDLIB2, -
    /                     FILE-NAME=&NPRLIB
    / ADD-FILE-LINK       LINK-NAME=P02, -
    /                     FILE-NAME=*DUMMY
    / SKIP-COMMANDS       TO-LABEL=&DYNPAR
    *
    * NATURAL DYNPAR = FILE
    *
    /.FILE                SET-JOB-STEP
    / MODIFY-JOB-SWITCHES ON=(4,5)
    / START-PROGRAM       FROM-FILE=$EDT
    &PARMS
    @W '#TMP.&UID.&TSN.&CTR' O
    @HALT
    / SET-JOB-STEP / MODIFY-JOB-SWITCHES OFF=(4,5)
    / ADD-FILE-LINK       LINK-NAME=CMPRMIN, -
    /                     FILE-NAME=#TMP.&UID.&TSN.&CTR
    / MODIFY-JOB-SWITCHES ON=2
    / START-PROGRAM       FROM-FILE=&NATBAT
    / SET-JOB-STEP
    / MODIFY-JOB-SWITCHES OFF=2
    / SKIP-COMMANDS       TO-LABEL=END
    *
    * NATURAL DYNPAR = SYSDTA
    *
    /.SYSDTA              SET-JOB-STEP
    / MODIFY-JOB-SWITCHES ON=2
    / START-PROGRAM       FROM-FILE=&NATBAT
    &PARMS
    / SET-JOB-STEP
    / MODIFY-JOB-SWITCHES OFF=2
    / SKIP-COMMANDS       TO-LABEL=END
    *
    * NATURAL DYNPAR = SYSIPT
    *
    /.SYSIPT              SET-JOB-STEP
    / ASSIGN-SYSIPT       TO=*SYSCMD
    / MODIFY-JOB-SWITCHES ON=2
    / START-PROGRAM       FROM-FILE=&NATBAT
    &PARMS
    /EOF
    / SET-JOB-STEP
    / MODIFY-JOB-SWITCHES OFF=2
    / SKIP-COMMANDS       TO-LABEL=END
    *
    /.END                 SET-JOB-STEP
    / ASSIGN-SYSLST       TO=*PRIMARY
    / PRINT-FILE          FILE-NAME=L.&UID.&TSN.&CTR, -
    /                     DEVICE-NAME=DRGW1, -
    /                     SPOOLOUT-NAME=&UID
    / EXIT-JOB            MODE=*NORMAL,SYSTEM-OUTPUT=*NONESATSKEL-END
    *
    * < end of params >

### On this page

- Using the Startup Parameters
- Parameters without Default Value
- Example Parameter Members