Introduction to Startup Parameters

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

This document covers the following topics:


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/OSD

  • 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/OSD

**********************************************************************
* 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 >