Installation for BS2000

We recommend reading this section from beginning to end before starting the installation process.

This document covers the following topics:


Installation Tape

The installation tape contains the datasets listed in the table below. The sequence of the datasets is shown in the Report of Tape Creation which accompanies the installation tape.

If used in the following document, the notation vrs or vr stands for the relevant version, release, system maintenance level number of the product.

Dataset Name Contents
MLCvrs.JOBS

Sample job library for Software AG's mainframe license check software.

Notes:

  1. The acronym "vrs" in the library name represents the version of the license check software, not the version of the Entire System Server.
  2. For more information on the license check software, see Software AG Mainframe Product Licensing.
MLCvrs.MOD

Load library for Software AG's mainframe license check software including the LICUTIL license utility

Notes:

  1. The acronym "vrs" in the library name represents the version of the license check software, not the version of the Entire System Server.
  2. For more information on the license check software, see Software AG Mainframe Product Licensing.
NPRvrs.JOBS Entire System Server installation jobs.
NPRvrs.MOD Entire System Server load library.
NPRvrs.SRC Entire System Server source library.
NPRvrs.INPL Entire System Server DDMs, a tutorial and error messages.
NPRvrs.DATA Predict data for the Entire System Server.
NPRvrs.LICS

Product license file

For more information on the license check software, see Software AG Mainframe Product Licensing.

How to Copy Data Sets from Tape to Disk

Copy the files (data sets) from the supplied installation medium to your disk before you perform the individual installation procedure for each component to be installed.

The way you copy the files depends on the installation method and the medium used:

  • If you use System Maintenance Aid (SMA), refer to the copy job instructions provided in the System Maintenance Aid documentation.

  • If you are not using SMA and want to copy the files from CD-ROM, refer to the README.TXT file on the CD-ROM.

  • If you are not using SMA and want to copy the files from tape, follow the instructions in this section.

This section explains how to copy all files from tape to disk.

Step 1: Copy Library SRVvrs.LIB from Tape to Disk

This step is not necessary if you have already copied the library SRVvrs.LIB from another Software AG installation tape. For further information, refer to the element #READ-ME in this library. The library SRVvrs.LIB is stored on the tape as a sequential file named SRVvrs.LIBS containing LMS commands. The current version vrs can be obtained from the Software AG Product Delivery Report.

  • Execute the following commands to convert SRVvrs.LIBS into an LMS library:

    /IMPORT-FILE  SUPPORT=*TAPE(FILE-NAME=SRVvrs.LIBS,-
    /   VOLUME=volser, DEV-TYPE=tape-device)
    /ADD-FILE-LINK  LINK-NAME=EDTSAM, FILE-NAME=SRVvrs.LIBS,-
    /   SUPPORT=*TAPE(FILE-SEQ=3), ACC-METH=*BY-CAT,-
    /   BUF-LEN=*BY-CAT, REC-FORM=*BY-CAT, REC-SIZE=*BY-CAT
    /START-EDT 
    @READ  '/'
    @SYSTEM 'REMOVE-FILE-LINK  EDTSAM'
    @SYSTEM 'EXPORT-FILE  FILE-NAME=SRVvrs.LIBS'
    @WRITE  'SRVvrs.LIBS'
    @HALT
    /ASS-SYSDTA  SRVvrs.LIBS
    /MOD-JOB-SW  ON=1
    /START-PROG  $LMS
    /MOD-JOB-SW  OFF=1
    /ASS-SYSDTA  *PRIMARY

    where:

    tape-device is the device type of the tape, for example, TAPE-C4, and
    volser is the VOLSER of the tape (see the Software AG Product Delivery Report).

Step 2: Copy the Procedure COPY.PROC from Tape to Disk

  • Call the procedure P.COPYTAPE in the library SRVvrs.LIB to copy the procedure COPY.PROC to disk:

    /CALL-PROCEDURE  (SRVvrs.LIB,P.COPYTAPE), -
    /   (VSNT=volser, DEVT=tape-device)

    If you use a TAPE-C4 device, you can omit the parameter DEVT.

Step 3: Copy all Product Files from Tape to Disk

  • Enter the procedure COPY.PROC to copy all product files to disk:

    /ENTER-PROCEDURE  COPY.PROC, DEVT=tape-device

    If you use a TAPE-C4 device, you can omit the parameter DEVT.

    The result of this procedure is written to the file L.REPORT.SRV.

Installation Procedure

Step 1: Scratch libraries SYSNPE and SYSNPR

(Job I051, Step 1100)

If you are upgrading from a previous version of the Entire System Server, scratch the libraries SYSNPE and SYSNPR from your existing installation. Otherwise, skip this step.

Step 2: Load the INPL File

(Job I061, Step 1100)

Use the Natural system command INPL (which is described in the Natural System Commands documentation) in order to load the Entire System Server system objects (dataset NPRvrs.INPL).

This loads the following libraries:

Library File Contents
SYSNPR FNAT Installation aid (define DBIDs and define views to Natural Security)
SYSNPE FNAT Online tutorial
SYSNPEH1 FNAT Help texts (English)
SYSNPEH2 FNAT Help texts (German)

Step 3: Change the Natural Parameter Module

Add the ASIZE parameter and the following macro to the Natural parameter module; then assemble and link it. For information on how to activate this Natural parameter module for your Natural environment, refer to the Natural Installation documentation for mainframes.

ASIZE=64
NTDB PROCESS,148

ASIZE specifies the size of the auxiliary buffer. The range of possible values for this parameter depends on the version of Natural. For example, for version 4.2 and below the minimum value is 36 KB and the maximum value is 64 KB (but you are recommended to specify a value of at least 48 KB). For version 8.2 the minimum value is 64 KB and the maximum value is 512 KB. For other versions, see section ASIZE - Entire System Server Auxiliary Buffer in the Parameter Reference chapter of the current Natural for Mainframes documentation.

148 is the database ID with which the Entire System Server DDMs are cataloged. This does not affect the use of additional Entire System Server nodes with different node IDs, since these can be addressed via the NODE field in each Entire System Server view. See also Multiple Entire System Server Node Support in the section Using the Entire System Server in the Entire System Server Administration documentation.

Note:
If you are upgrading from a previous version of Entire System Server, use the startup parameter NODE to assign different node IDs to different versions of Entire System Server running on the same system. You may, for instance, have an earlier Entire System Server Version running in production using node ID 148, and specify NODE=199 in the startup parameter for the current version during installation and test.

Ensure the Natural session parameter LE is set to OFF, otherwise you may experience problems with the Online Tutorial.

Step 4: Change Defaults

  1. Module NATPNIP:

    • To change defaults in the parameter module NATPNIP, edit the source member NATPNIP (in the Natural source library).

      Assemble it as described in Section Installing the Entire System Server Interface in the Natural Installation documentation for mainframes.

      NATPNIP contains the following parameters and defaults:

      Parameter Explanation
      BUFLEN=8192 Length of all Adabas buffers.
      NUMREQ=5 Number of parallel requests.
      MAXCBL=3000 Complex FIND buffer length.
      MAXEDL=3000 Editor session buffer length.
      EXTUSER=USER When running under openUTM, value USER should be used to ship Natural's *USER to Entire System Server.

      When running in BATCH mode or under TIAM, value ADDRESS-SPACE should be fetched to ship the User ID of the task to Entire System Server.

  2. Assemble this module as described in the section Installing the Entire System Server Interface in the Natural Installation documentation for mainframes.

  3. The Entire System Server Interface (ESX) has been an integrated part of Natural since Version 2.3.4. All ESX modules will be automatically linked to the front-end part of Natural in Version 2.3.4 and above. For further information, see Installing the Entire System Server Interface in the Natural Installation documentation for mainframes.

Step 5: Load the Predict DATA File

(Job I200, Step 1100)

This step is optional.

All Entire System Server views have been documented in Software AG's repository Predict. The NPRvrs.DATA dataset on the installation medium contains these Predict view descriptions that can be loaded with the MIGRATE/COORDINATOR utility in Predict.

The MIGRATE/COORDINATOR utility is described in the Predict Reference documentation.

If, however, you have already loaded these descriptions from earlier versions of the Entire System Server (or Natural Process), you must also logon to Predict's online system to check the database name of DBID 148, to which the views are linked.

Its name must be ENTIRE-SYSTEM-SERVER. If it is not, change the database name before running Job I200 to load the dataset NPRvrs.DATA.

Step 6: Natural Security Considerations

If Natural Security is installed, define the libraries SYSNPE, SYSNPR, SYSNPEH1 and SYSNPEH2 to Natural Security. If these applications are to be people-protected, link those user IDs to them that require authorization. Define libraries without XREF=YES to load all objects.

  • SYSNPE contains the online tutorial;

  • the installation aid in library SYSNPR can be used to apply initial security definitions for the Entire System Server views.

Step 7: Customize Startup Parameters

  1. Copy member NPRPARMS from the library NPRvrs.SRC to a SAM or ISAM file.

  2. Edit this parameter file to set the correct startup parameters according to the requirements of your site.

For a description of the parameters and an example, see the section Startup Parameters in the Entire System Server Administration documentation.

Step 8: Edit the Entire System Server Jobs

  1. Adjust job control for the Entire System Server ESYMAIN Task.

    Edit the example Element E.ESYMAIN and adjust the library and file names used in it.

    /.XCOM199             SET-LOGON-PARAMETERS
    / SKIP-COMMANDS       TO-LABEL=START
    
      *------------------------------------------------------------------*
      * Run Entire System Server ESYMAIN Task.                              *
      *------------------------------------------------------------------*
    
    /.START               REMARK
    / MODIFY-JOB-OPTIONS  INFORMATION-LEVEL=*MEDIUM, -
    /                     OPERATOR-INTERACTION=*YES, -
    /                     LOGGING=*PARAMETERS(LISTING=*YES)
    / MODIFY-TEST-OPTIONS DUMP=*YES
    / ASSIGN-SYSLST       TO=$SAG.LST.ESYMAIN.199.&($SYSJV.TSN)
    / ASSIGN-SYSLST       TO=$SAG.LST.ESYMAIN.199.&($SYSJV.TSN).ZAPS, -
    /                     SYSLST-NUMBER=1
    / SHOW-JOB-STATUS     JOB-IDENTIFICATION=*OWN
    / CREATE-FILE         FILE-NAME=$SAG.NPRvrs.CLOG.199, -
    /                     SUPPORT=*PUBLIC-DISK -
    /                     ( SPACE=*RELATIVE -
    /                       ( PRIMARY-ALLOCATION   = 12, -
    /                         SECONDARY-ALLOCATION = 12 ) )
    / SET-JOB-STEP
    / CREATE-FILE         FILE-NAME=$SAG.NPRvrs.LICREP.199, -
    /                     SUPPORT=*PUBLIC-DISK -
    /                     ( SPACE=*RELATIVE -
    /                       ( PRIMARY-ALLOCATION   = 12, -
    /                         SECONDARY-ALLOCATION = 12 ) )
    / SET-JOB-STEP
    / CREATE-FILE         FILE-NAME=$SAG.NPRvrs.TRAC.199, -
    /                     SUPPORT=*PUBLIC-DISK -
    /                     ( SPACE=*RELATIVE -
    /                       ( PRIMARY-ALLOCATION   = 12, -
    /                         SECONDARY-ALLOCATION = 12 ) )
    / SET-JOB-STEP
    / ADD-FILE-LINK       LINK-NAME=BLSLIB00,FILE-NAME=$SAG.NPRvrs.USER.MOD
    / ADD-FILE-LINK       LINK-NAME=CLOG    ,FILE-NAME=$SAG.NPRvrs.CLOG.199
    / ADD-FILE-LINK       LINK-NAME=DDLIB   ,FILE-NAME=$SAG.ADAvrs.MOD
    / ADD-FILE-LINK       LINK-NAME=DDLIB2  ,FILE-NAME=$SAG.NPRvrs.MOD
    / ADD-FILE-LINK       LINK-NAME=LICENSE ,FILE-NAME=$SAG.NPRvrs.LICS
    / ADD-FILE-LINK       LINK-NAME=LICREP  ,FILE-NAME=$SAG.NPRvrs.LICREP.199
    / ADD-FILE-LINK       LINK-NAME=MLCLIB  ,FILE-NAME=$SAG.MLCvrs.MOD
    / ADD-FILE-LINK       LINK-NAME=PARMS   ,FILE-NAME=$SAG.NPRvrs.PARM.199
    / ADD-FILE-LINK       LINK-NAME=TRACE   ,FILE-NAME=$SAG.NPRvrs.TRAC.199
    / START-PROGRAM       FROM-FILE=*MODULE -
    /                     ( LIBRARY=$SAG.NPRvrs.MOD, -
    /                       ELEMENT=ESYMAIN, -
    /                       PROGRAM-MODE=*ANY, -
    /                       RUN-MODE=*ADVANCED ), -
    /                     MONJV=#ESYMAIN.&($SYSJV.TSN)
    / SET-JOB-STEP
    / SHOW-JOB-STATUS     JOB-IDENTIFICATION=*OWN
    / SKIP-COMMANDS       TO-LABEL=OKAY, -
    /                     IF=JV(COND=(#ESYMAIN.&($SYSJV.TSN),1,2) EQ '$T')
    / WRITE-TEXT          TEXT='***** ESYMAIN failed *****'
    / SKIP-COMMANDS       TO-LABEL=STOP
    
    /.OKAY                REMARK
    / WRITE-TEXT          TEXT='***** ESYMAIN successfully executed *****'
    / SKIP-COMMANDS       TO-LABEL=STOP
    
    /.STOP                REMARK
    / EXIT-JOB            MODE=*NORMAL,SYSTEM-OUTPUT=*NONE
    

    This job is used to start the Entire System Server. The file referenced by the link name PARMS contains the Entire System Server startup parameters. For a description of startup parameters, see the section Startup Parameters in the Entire System Server Administration documentation.

    Also, the license necessary to run the Entire System Server is verified.

    The ADD-FILE-LINK statement to assign link name CLOG is only needed if the logging facility of Entire System Server is activated by setting the appropriate parameter LOGGING=YES in the startup parameter file or dynamically via operator command interface:

    /INTR tsn, LOGGING=YES 

    where tsn is the TSN assigned to the MAIN task.

    The file assigned by link name TRACE is needed to save the TRACE data buffer at exit of the ESY MAIN Task. The assignment is not required if startup parameter TRACE-SAV=NO was specified.

    The library concept of Entire System Server is described in detail under Library Concept on BS2000 for Entire System Server in the section BS2000 Considerations in the Entire System Server Administration documentation.

    More information about running Entire System Server on BS2000 is available under Details for Running Entire System Server on BS2000 in the section BS2000 Considerations in the Entire System Server Administration documentation.

  2. Adjust job control for the Entire System Server ESYSERV Task.

    Edit the example element E.ESYSERV and adjust the library and file names used in it.

     /.XSRV199             SET-LOGON-PARAMETERS
     / SKIP-COMMANDS       TO-LABEL=START
     *------------------------------------------------------------------*
     * Run Entire System Server ESYSERV Task.                           *
     *                                                                  *
     * Filename / LMS-element-name of this job must be specified in     *
     * startup parameters. It will be started automatically at startup  *
     * of Entire System Server by ESYMAIN Task.                         *
     * If Dynamic Server Management is enabled, ESYSERV Tasks will be   *
     * started dynamically during runtime to handle increasing work     *
     * load.                                                            *
     *------------------------------------------------------------------*
     /.START               REMARK
     / MODIFY-JOB-OPTIONS  INFORMATION-LEVEL=*MEDIUM, -
     /                     OPERATOR-INTERACTION=*YES, -
     /                     LOGGING=*PARAMETERS(LISTING=*YES)
     / MODIFY-TEST-OPTIONS DUMP=*YES
     / ASSIGN-SYSLST       TO=LST.ESYSERV.199.&($SYSJV.TSN)
     / ASSIGN-SYSLST       TO=LST.ESYSERV.199.&($SYSJV.TSN).ZAPS, -
     /                     SYSLST-NUMBER=1
     / SHOW-JOB-STATUS     JOB-IDENTIFICATION=*OWN
     / ADD-FILE-LINK       LINK-NAME=DDLIB2 ,FILE-NAME=$SAG.NPRvrs.MOD
     / ADD-FILE-LINK       LINK-NAME=BLSLIB00,FILE-NAME=$SAG.NPRvrs.USER.MOD
     / START-PROGRAM       FROM-FILE=*MODULE -
     /                     ( LIBRARY=$SAG.NPRvrs.MOD, -
     /                       ELEMENT=ESYSERV, -
     /                       PROGRAM-MODE=*ANY, -
     /                       RUN-MODE=*ADVANCED ), -
     /                     MONJV=#ESYSERV.&($SYSJV.TSN)
     / SET-JOB-STEP
     / SHOW-JOB-STATUS     JOB-IDENTIFICATION=*OWN
     / SKIP-COMMANDS       TO-LABEL=OKAY, -
     /                     IF=JV(COND=(#ESYSERV.&($SYSJV.TSN),1,2) EQ '$T')
     / WRITE-TEXT          TEXT='***** ESYSERV failed *****'
     / SKIP-COMMANDS       TO-LABEL=STOP
     /.OKAY                REMARK
     / WRITE-TEXT          TEXT='***** ESYSERV successfully executed *****'
     / SKIP-COMMANDS       TO-LABEL=STOP
     /.STOP                REMARK
     / EXIT-JOB            MODE=*NORMAL,SYSTEM-OUTPUT=*NONE

    This job is used to start the Entire System Server ESYSERV Tasks. They will be started automatically by the ESYMAIN Task. The location of this job (file or LMS element) and the number of server tasks to be started are specified in startup parameters JOBSERVER and NUMTASK. For a description, see the section Startup Parameters in the Entire System Server Administration documentation.

    It is also possible to run a Dynamic Server Management with Entire System Server. For detailed information, see the Dynamic Server Management for Entire System Server in the section Common Entire System Server Features in the Entire System Server Administration documentation.

  3. Adjust job control for the Entire System Server Eventing Manager Task.

    Edit the example element E.ESYEVTM and adjust the library and file names used in it.

     /.XEVE199             SET-LOGON-PARAMETERS
     / SKIP-COMMANDS       TO-LABEL=START
     *------------------------------------------------------------------*
     * Run Entire System Server Eventing Manager Task.                  *
     *                                                                  *
     * Filename / LMS-element-name of this job must be specified in     *
     * startup parameters. It will be started automatically at startup  *
     * of Entire System Server by MAIN Task.                            *
     *------------------------------------------------------------------*
     /.START               REMARK
     / MODIFY-JOB-OPTIONS  INFORMATION-LEVEL=*MEDIUM, -
     /                     OPERATOR-INTERACTION=*YES, -
     /                     LOGGING=*PARAMETERS(LISTING=*YES)
     / MODIFY-TEST-OPTIONS DUMP=*YES
     / ASSIGN-SYSLST       TO=$SAG.LST.ESYEVTM.199.&($SYSJV.TSN)
     / ASSIGN-SYSLST       TO=$SAG.LST.ESYEVTM.199.&($SYSJV.TSN).ZAPS, -
     /                     SYSLST-NUMBER=1
     / SHOW-JOB-STATUS     JOB-IDENTIFICATION=*OWN
     / ADD-FILE-LINK       LINK-NAME=DDLIB2 ,FILE-NAME=$SAG.NPRvrs.MOD
     / ADD-FILE-LINK       LINK-NAME=BLSLIB00,FILE-NAME=$SAG.NPRvrs.USER.MOD
     / START-PROGRAM       FROM-FILE=*MODULE -
     /                     ( LIBRARY=$SAG.NPRvrs.MOD, -
     /                       ELEMENT=ESYEVTM, -
     /                       PROGRAM-MODE=*ANY, -
     /                       RUN-MODE=*ADVANCED ), -
     /                     MONJV=#ESYEVTM.&($SYSJV.TSN)
     / SET-JOB-STEP
     / SHOW-JOB-STATUS     JOB-IDENTIFICATION=*OWN
     / SKIP-COMMANDS       TO-LABEL=OKAY, -
     /                     IF=JV(COND=(#ESYEVTM.&($SYSJV.TSN),1,2) EQ '$T')
     / WRITE-TEXT          TEXT='***** ESYEVTM failed *****'
     / SKIP-COMMANDS       TO-LABEL=STOP
     /.OKAY                REMARK
     / WRITE-TEXT          TEXT='***** ESYEVTM successfully executed *****'
     / SKIP-COMMANDS       TO-LABEL=STOP
     /.STOP                REMARK
     / EXIT-JOB            MODE=*NORMAL,SYSTEM-OUTPUT=*NONE

    This job is used to start the Entire System Server Eventing Manager Task. It will be started automatically by the MAIN Task at Entire System Server startup if startup parameter EVENTLEN is not 0. The location of this job (file or LMS element) is specified in the startup parameter JOBEVENT. For a description of startup parameters, see the section Startup Parameters in the Entire System Server Administration documentation.

  4. Adjust job control for the Entire System Server CONSOLE Task.

    Edit the example element E.ESYCONS and adjust the library and file names used in it. With parameter APPL-NAME of the SET-DCAM-APPL-LINK statement in the example job, the name of the DCAM application which will connect to UCON (application $CONSOLE) is defined. This name must be uniquely defined for every Entire System Server running in the same host.

    /.XCON199             SET-LOGON-PARAMETERS
    / SKIP-COMMANDS TO-LABEL=START *------------------------------------------------------------------* * Run Entire System Server CONSOLE Task. * * * * Filename / LMS-element-name of this job must be specified in * * startup parameters. It will be started automatically at startup * * of Entire System Server by MAIN Task. * *------------------------------------------------------------------* /.START REMARK / 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=$SAG.LST.ESYCONS.199.&($SYSJV.TSN) / ASSIGN-SYSLST TO=$SAG.LST.ESYCONS.199.&($SYSJV.TSN).ZAPS, - / SYSLST-NUMBER=1 / SHOW-JOB-STATUS JOB-IDENTIFICATION=*OWN / ADD-FILE-LINK LINK-NAME=DDLIB2 ,FILE-NAME=$SAG.NPRvrs.MOD / SET-DCAM-APPL-LINK LINK-NAME=ESYCONAP, "must not be changed" - / APPLICATION-NAME=ESYCONS2 "may be changed" / START-PROGRAM FROM-FILE=*MODULE - / ( LIBRARY=$SAG.NPRvrs.MOD, - / ELEMENT=ESYCONS, - / PROGRAM-MODE=*ANY, - / RUN-MODE=*ADVANCED ), - / MONJV=#ESYCONS.&($SYSJV.TSN)CON6,C'CON6' / SET-JOB-STEP / SHOW-JOB-STATUS JOB-IDENTIFICATION=*OWN / SKIP-COMMANDS TO-LABEL=OKAY, - / IF=JV(COND=(#ESYCONS.&($SYSJV.TSN),1,2) EQ '$T') / WRITE-TEXT TEXT='***** ESYCONS failed *****' / SKIP-COMMANDS TO-LABEL=STOP /.OKAY REMARK / WRITE-TEXT TEXT='***** ESYCONS successfully executed *****' / SKIP-COMMANDS TO-LABEL=STOP /.STOP REMARK / EXIT-JOB MODE=*NORMAL,SYSTEM-OUTPUT=*NONE
  5. This job is used to start the UCON interface task (CONSOLE Task) of Entire System Server. It will be started automatically by the MAIN Task at Entire System Server startup, if startup parameter CONACCESS is not NONE. The location of this job (file or LMS element) is specified in the startup parameter JOBCONS. For a description of startup parameters, see Startup Parameters in the Entire System Server Administration documentation.

    Authorization for connection to UCON (connection message) must be specified as parameter of the program ESYCONS.

  6. Adjust job control for the Entire System Server Shutdown Program.

    Edit the example element E.ESYSTOP and adjust the library and file names used in it.

     /.ESYSTOP             SET-LOGON-PARAMETERS
     / SKIP-COMMANDS       TO-LABEL=START
     *------------------------------------------------------------------*
     * Execute ESYSTOP to shutdown Entire System Server.                *
     *------------------------------------------------------------------*
     /.START REMARK
     / 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=$SAG.LST.ESYSTOP.199.&($SYSJV.TSN)
     / SHOW-JOB-STATUS     JOB-IDENTIFICATION=*OWN
     / ADD-FILE-LINK       LINK-NAME=DDLIB2 ,FILE-NAME=$SAG.NPRvrs.MOD
     / ADD-FILE-LINK       LINK-NAME=BLSLIB00,FILE-NAME=$SAG.NPRvrs.USER.MOD
     / START-PROGRAM       FROM-FILE=*MODULE -
     /                     ( LIBRARY=$SAG.NPRvrs.MOD, -
     /                       ELEMENT=ESYSTOP, -
     /                       PROGRAM-MODE=*ANY, -
     /                       RUN-MODE=*ADVANCED ), -
     /                     MONJV=#ESYSTOP.&($SYSJV.TSN)
     --JNAME XCOM199
     / SET-JOB-STEP
     / SHOW-JOB-STATUS     JOB-IDENTIFICATION=*OWN
     / SKIP-COMMANDS       TO-LABEL=OKAY, -
     /                     IF=JV(COND=(#ESYSTOP.&($SYSJV.TSN),1,2) EQ '$T')
     / WRITE-TEXT          TEXT='***** ESYSTOP failed *****'
     / SKIP-COMMANDS       TO-LABEL=STOP
     /.OKAY                REMARK
     / WRITE-TEXT          TEXT='***** ESYSTOP successfully executed *****'
     / SKIP-COMMANDS       TO-LABEL=STOP
     /.STOP                REMARK
     / EXIT-JOB            MODE=*NORMAL,SYSTEM-OUTPUT=*NONE

    This job should be used to shutdown the Entire System Server. For further information,

    see Shutdown of Entire System Server on BS2000 in the section BS2000 Considerations in the Entire System Server Administration documentation.

  7. Adjust job control for the Entire System Server Trace Program.

    Edit the example element E.ESYTRACE and adjust the library and file names used in it.

     /.ESYTRACE            SET-LOGON-PARAMETERS
     / SKIP-COMMANDS       TO-LABEL=START
     *------------------------------------------------------------------*
     * Execute ESYTRACE to run Entire System Server TRACE analyzer.     *
     *------------------------------------------------------------------*
     /.START               REMARK
     / 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=$SAG.LST.ESYTRACE.199.&($SYSJV.TSN)
     / SHOW-JOB-STATUS     JOB-IDENTIFICATION=*OWN
     / CREATE-FILE         FILE-NAME=$SAG.NPRvrs.TROU.199, -
     /                     SUPPORT=*PUBLIC-DISK -
     /                     ( SPACE=*RELATIVE -
     /                       ( PRIMARY-ALLOCATION = 12, -
     /                         SECONDARY-ALLOCATION = 12 ) )
     / SET-JOB-STEP
     / ADD-FILE-LINK       LINK-NAME=TRIN    ,FILE-NAME=$SAG.NPRvrs.TRAC.199
     / ADD-FILE-LINK       LINK-NAME=TROUT   ,FILE-NAME=$SAG.NPRvrs.TROU.199
     / ADD-FILE-LINK       LINK-NAME=DDLIB2  ,FILE-NAME=$SAG.NPRvrs.MOD
     / ADD-FILE-LINK       LINK-NAME=BLSLIB00,FILE-NAME=$SAG.NPRvrs.USER.MOD
     / START-PROGRAM       FROM-FILE=*MODULE -
     /                     ( LIBRARY=$SAG.NPRvrs.MOD, -
     /                       ELEMENT=ESYTRACE, -
     /                       PROGRAM-MODE=*ANY, -
     /                       RUN-MODE=*ADVANCED ), -
     /                     MONJV=#ESYTRACE.&($SYSJV.TSN)
     199 --POLL
     / SET-JOB-STEP
     / SHOW-JOB-STATUS     JOB-IDENTIFICATION=*OWN
     / SKIP-COMMANDS       TO-LABEL=OKAY, -
     /                     IF=JV(COND=(#ESYTRACE.&($SYSJV.TSN),1,2) EQ '$T')
     / WRITE-TEXT          TEXT='***** ESYTRACE failed *****'
     / SKIP-COMMANDS       TO-LABEL=STOP
     /.OKAY                REMARK
     / WRITE-TEXT          TEXT='***** ESYTRACE successfully executed *****'
     / SKIP-COMMANDS       TO-LABEL=STOP
     /.STOP                REMARK
     / EXIT-JOB            MODE=*NORMAL,SYSTEM-OUTPUT=*NONE

    This job is used to run program ESYTRACE. It analyzes the TRACE data of Entire System Server if startup parameter TRACE=YES is defined. In order to start ESYTRACE in Monitor mode, parameter line 199 --POLL is specified. The assignment of LINK-NAME TRIN is not needed here, because all data is read from memory pool only. The analyzed and edited TRACE data will be written to the file assigned by LINK-NAME TROUT.

    This task must be stopped explicitly with operator command QUIT due to argument --POLL

    For further information, see Creating Trace Data in the Entire System Server in the section Common Entire System Server Features in the Entire System Server Administration documentation.

  8. Adjust job control for the Entire System Server E-Mail Manager Task

    There are job control examples to run the Entire System Server E-Mail Manager Task based on IP Version 4 or IP Version 6. Please contact your network administrator to determine which IP version is used. The job control for the Entire System Server E-Mail Manager Task based on IP Version 4 is available in the sample element E.ESYMAIL4, the job control for the Entire System Server E-Mail Manager Task based on IP Version 6 is available in the sample element E.ESYMAIL. This allows defining the required IP version in the Entire System Server startup parameter file by specifying E.ESYMAIL4 or E.ESYMAIL as value for parameter JOBEMAIL.

    Edit the example element E.ESYMAIL4 or E.ESYMAIL and adjust the library and file names used in it. Element E.ESYMAIL is listed below.

    /.XEML199             SET-LOGON-PARAMETERS
    / SKIP-COMMANDS       TO-LABEL=START
      *------------------------------------------------------------------*
      * Run Entire System Server E-Mail Manager Task.                    *
      *                                                                  *
      * Filename / LMS-element-name of this job must be specified in     *
      * startup parameters. It will be started automatically at startup  *
      * of Entire System Server by MAIN Task.                            *
      *------------------------------------------------------------------*
    /.START               REMARK
    / MODIFY-JOB-OPTIONS  INFORMATION-LEVEL=*MEDIUM, -
    /                     OPERATOR-INTERACTION=*YES, -
    /                     LOGGING=*PARAMETERS(LISTING=*YES)
    / MODIFY-TEST-OPTIONS DUMP=*YES
    / ASSIGN-SYSLST       TO=$SAG.LST.ESYMAIL.199.&($SYSJV.TSN)
    / ASSIGN-SYSLST       TO=$SAG.LST.ESYMAIL.199.&($SYSJV.TSN).ZAPS, -
    /                     SYSLST-NUMBER=1
    / SHOW-JOB-STATUS     JOB-IDENTIFICATION=*OWN
    / ADD-FILE-LINK       LINK-NAME=DDLIB2  ,FILE-NAME=$SAG.NPRvrs.MOD
    / ADD-FILE-LINK       LINK-NAME=BLSLIB00,FILE-NAME=$SAG.NPRvrs.USER.MOD
    / START-PROGRAM       FROM-FILE=*MODULE -
    /                     ( LIBRARY=$SAG.NPRvrs.MOD, -
    /                       ELEMENT=ESYMAIL, -
    /                       PROGRAM-MODE=*ANY, -
    /                       RUN-MODE=*ADVANCED ), -
    /                     MONJV=#ESYMAIL.&($SYSJV.TSN)
    / SET-JOB-STEP
    / SHOW-JOB-STATUS     JOB-IDENTIFICATION=*OWN
    / SKIP-COMMANDS       TO-LABEL=OKAY, -
    /                     IF=JV(COND=(#ESYMAIL.&($SYSJV.TSN),1,2) EQ '$T')
    / WRITE-TEXT          TEXT='***** ESYMAIL failed *****'
    / SKIP-COMMANDS       TO-LABEL=STOP
    /.OKAY                REMARK
    / WRITE-TEXT          TEXT='***** ESYMAIL successfully executed *****'
    / SKIP-COMMANDS       TO-LABEL=STOP
    /.STOP                REMARK
    / EXIT-JOB            MODE=*NORMAL,SYSTEM-OUTPUT=*NONE

    This job is used to start the Entire System Server E-Mail Manager Task based on IP Version 6. It will be started automatically by the MAIN Task at Entire System Server startup if startup parameter NUMMAIL is not 0. The location of this job (file or LMS element) is specified in the startup parameter JOBEMAIL. For a description of startup parameters, see the section Startup Parameters in the Entire System Server Administration documentation.

    For further information about E-Mail administration, see Run E-Mail Client in the section Common Entire System Server Features in the Entire System Server Administration documentation.

Step 9: Edit the Entire System Server Procedures

As an alternative to the delivered start up jobs, you may run Entire System Server by an SDF-P procedure. All tasks can be managed via SDF-P procedure P.ESY.

/  "-----------------------------------------------------------------"
/  " PROC-NAME: P.ESY                                                "
/  " FUNCTION : Run Entire System Server Tasks                       "
/  "                                                                 "
/  " Parameter  Description                                          "
/  " ---------  ---------------------------------------------------  "
/  " PGM        Program to be executed                               "
/  "            ESYCONS  - Run CONSOLE Task                          "
/  "            ESYEVTM  - Run Eventing Manager Task                 "
/  "            ESYMAIL  - Run E-Mail Manager Task                   "
/  "            ESYMAIN  - Run MAIN Task                             "
/  "            ESYSERV  - Run SERVER Task                           "
/  "            ESYSTOP  - Run ESY Shutdown                          "
/  "            ESYTRACE - Run TRACE analyzer                        "
/  "                                                                 "
/  " ADA-MOD    Name of the Adabas module library                    "
/  " APPL-NAME  DCAM name of the CONSOLE application                 "
/  " CONS-AUTH  Console authorization name                           "
/  " CONS-PASS  Console password                                     "
/  " NODE       Entire System Server node number                     "
/  " NPR-JOBS   Name of the Entire System Server jobs library        "
/  "            containing Entire System Server startup parameters   "
/  " NPR-MOD    Name of the Entire System Server module library      "
/  " NPRPARMS   Name of LMS-element in library &(NPR-JOBS)           "
/  " USER-ID    User Id for files                                    "
/  " USER-MOD   Name of the Entire System Server user library        "
/  "-----------------------------------------------------------------"
/  SET-PROCEDURE-OPTIONS DATA-ESCAPE-CHAR = *STD
/
/  BEGIN-PARAMETER-DECLARATION
/    DECLARE-PARAMETER  PGM            (*PROMPT)
/    DECLARE-PARAMETER  ADA-MOD        ('$SAG.ADAvrs.MOD')
/    DECLARE-PARAMETER  APPL-NAME      ('ESYCONS2')
/    DECLARE-PARAMETER  CONS-AUTH      ('CON6')
/    DECLARE-PARAMETER  CONS-PASS      ('CON6')
/    DECLARE-PARAMETER  NODE           ('199')
/    DECLARE-PARAMETER  NPR-JOBS       ('$SAG.NPRvrs.JOBS')
/    DECLARE-PARAMETER  NPR-MOD        ('$SAG.NPRvrs.MOD')
/    DECLARE-PARAMETER  NPR-PARMS-ELEM ('NPRPARMS')
/    DECLARE-PARAMETER  NPR-USER-MOD   ('$SAG.NPRvrs.USER.MOD')
/    DECLARE-PARAMETER  USER-ID        ('$SAG')
/  END-PARAMETER-DECLARATION
/
/  "-----------------------------------------------------------------"
/  " Procedure Initialization                                        "
/  " ------------------------                                        "
/  " 1. Set variables                                                "
/  "    o  DATA - Data for ESY-programs                              "
/  "    o  LST - Name of SYSLST file                                 "
/  "    o  TSN - BS2000 task sequence number                         "
/  "    o  PFX - Prefix of the logging files                         "
/  " 2. Assign SYSLST                                                "
/  " 3. Modify job and test options                                  "
/  "-----------------------------------------------------------------"
/  DATA    = ' '
/  PFX     = '&(PGM).&(NODE)'
/  TSN     = JV('$SYSJV.TSN')
/  UTILITY = 'NO'
/  LST     = '&(USER-ID).LST.&(PFX).&(TSN)'
/
/  IF (PGM = 'ESYSTOP')
/    UTILITY = 'YES'
/  END-IF
/
/  IF (PGM = 'ESYTRACE')
/    UTILITY = 'YES'
/  END-IF
/
/  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=&(LST)
/
/  IF (UTILITY = 'NO')
/    ASSIGN-SYSLST     TO=&(LST).ZAPS,SYSLST-NUMBER=1
/  END-IF
/
/  SHOW-JOB-STATUS
/
/  "-----------------------------------------------------------------"
/  " CONSOLE Task specific actions                                   "
/  "-----------------------------------------------------------------"
/  IF (PGM = 'ESYCONS')
/    SET-DCAM-APPL-LINK  LINK-NAME = ESYCONAP, -
/                        APPL-NAME = &(APPL-NAME)
/    DATA = '&(CONS-AUTH),C''&(CONS-PASS)'''
/  END-IF
/
/  "-----------------------------------------------------------------"
/  " MAIN Task specific actions                                      "
/  "-----------------------------------------------------------------"
/  IF (PGM = 'ESYMAIN')
/    START-LMS
//     MOD-LMS-DEFAULTS MAX-ERROR-WEIGHT=*RECOVERABLE
//     EXTRACT-ELEMENT *LIB(&(NPR-JOBS),&(NPR-PARMS-ELEM),S), -
//       TO-FILE = #NPRPARMS, -
//       FILE-ATTR = (ACCESS-METHOD=*SAM), -
//       WRITE-MODE = *ANY
//     END
/    CREATE-FILE   FILE-NAME=&(USER-ID).CLOG.&(NODE), -
/                  SUPPORT=*PUBLIC-DISK -
/                  ( SPACE=*RELATIVE -
/                    ( PRIMARY-ALLOCATION   = 12, -
/                      SECONDARY-ALLOCATION = 12 ) ), -
/                  SUPPRESS-ERROR = *FILE-EXIST
/    CREATE-FILE   FILE-NAME=&(USER-ID).TRACE.&(NODE), -
/                  SUPPORT=*PUBLIC-DISK -
/                  ( SPACE=*RELATIVE -
/                    ( PRIMARY-ALLOCATION   = 12, -
/                      SECONDARY-ALLOCATION = 12 ) ), -
/                  SUPPRESS-ERROR = *FILE-EXIST
/    ADD-FILE-LINK LINK=PARMS,FILE-NAME=#NPRPARMS
/    ADD-FILE-LINK LINK=CLOG, FILE-NAME=&(USER-ID).CLOG.&(NODE)
/    ADD-FILE-LINK LINK=TRACE,FILE-NAME=&(USER-ID).TRACE.&(NODE)
/    ADD-FILE-LINK LINK=DDLIB,FILE-NAME=&(ADA-MOD)
/  END-IF
/
/  "-----------------------------------------------------------------"
/  " ESY Shutdown specific actions                                   "
/  "-----------------------------------------------------------------"
/  IF (PGM = 'ESYSTOP')
/    DATA = '--JNAME XCOM&(NODE)'
/  END-IF
/
/  "-----------------------------------------------------------------"
/  " TRACE analyzer specific actions                                 "
/  "-----------------------------------------------------------------"
/  IF (PGM = 'ESYTRACE')
/    CREATE-FILE   FILE-NAME=&(USER-ID).TROUT.&(NODE), -
/                  SUPPORT=*PUBLIC-DISK -
/                  ( SPACE=*RELATIVE -
/                    ( PRIMARY-ALLOCATION   = 12, -
/                      SECONDARY-ALLOCATION = 12 ) ), -
/                  SUPPRESS-ERROR = *FILE-EXIST
/    ADD-FILE-LINK LINK=TRIN, FILE-NAME=&(USER-ID).TRACE.&(NODE)
/    ADD-FILE-LINK LINK=TROUT,FILE-NAME=&(USER-ID).TROUT.&(NODE)
/    DATA = '&(NODE) --POLL'
/  END-IF
/
/  "-----------------------------------------------------------------"
/  " Start Program                                                   "
/  "-----------------------------------------------------------------"
/  ADD-FILE-LINK LINK=DDLIB2,  FILE-NAME=&(NPR-MOD)
/  ADD-FILE-LINK LINK=BLSLIB00,FILE-NAME=&(NPR-USER-MOD)
/
/  IF (DATA = ' ')
/    START-EXEC-PROG (&(NPR-MOD),&(PGM))
/  ELSE
/    START-EXEC-PROG (&(NPR-MOD),&(PGM))
&(DATA)
/  END-IF
/
/  "-----------------------------------------------------------------"
/  " Exit Procedure                                                  "
/  "-----------------------------------------------------------------"
/  IF-BLOCK-ERROR
/    SHOW-JOB-STATUS
/    WRITE-TEXT  '***** &(PGM) failed *****'
/  ELSE
/    SHOW-JOB-STATUS
/    WRITE-TEXT  '***** &(PGM) successfully executed *****'
/  END-IF
/
/  EXIT-PROCEDURE
  1. Customize the values in the parameter declaration section according to your site's specific needs and use the delivered procedures P.ESYMAIN, P.ESYSTOP and P.ESYTRACE to run the Entire System Server, to stop it, and to retrieve trace data from the node.

  2. Adjust job control for the Entire System Server MAIN Task.

    Edit the example Element P.ESYMAIN and adjust the parameters used in it.

    /.ESYMAIN BEGIN-PROC  LOGGING=*NO, -
    /                     PARAMETERS=*NO
    / ENTER-PROCEDURE     FROM-FILE=*LIBRARY-ELEMENT -
    /                     ( LIBRARY=$SAG.NPRvrs.JOBS, -
    /                       ELEMENT=P.ESY ), -
    /                     PROCEDURE-PARAMETERS=(PGM=ESYMAIN), -
    /                     PROCESSING-ADMISSION=*PARAMETERS -
    /                     ( USER-IDENTIFICATION=TSOS, -
    /                       PASSWORD=C'pwd' ), -
    /                     JOB-CLASS=TSOSBAT, -
    /                     JOB-NAME=XCOM199, -
    /                     RESOURCES=*PARAMETERS -
    /                     ( CPU-LIMIT=*NO, -
    /                       RUN-PRIORITY=255 ), -
    /                     SCHEDULING-TIME=*PARAMETERS -
    /                     ( START=*IMMEDIATELY )
    /.ESYMAIN END-PROC
  3. Adjust job control for the Entire System Server Shutdown Program.

    Edit the example element P.ESYSTOP and adjust the parameters used in it.

    /.ESYSTOP BEGIN-PROC  LOGGING=*NO, -
    /                     PARAMETERS=*NO
    / ENTER-PROCEDURE     FROM-FILE=*LIBRARY-ELEMENT -
    /                     ( LIBRARY=$SAG.NPRvrs.JOBS, -
    /                       ELEMENT=P.ESY ), -
    /                     PROCEDURE-PARAMETERS=(PGM=ESYSTOP), -
    /                     PROCESSING-ADMISSION=*PARAMETERS -
    /                     ( USER-IDENTIFICATION=TSOS, -
    /                       PASSWORD=C'pwd' ), -
    /                     JOB-CLASS=TSOSBAT, -
    /                     JOB-NAME=ESYSTOP, -
    /                     RESOURCES=*PARAMETERS -
    /                     ( CPU-LIMIT=*NO, -
    /                       RUN-PRIORITY=255 ), -
    /                     SCHEDULING-TIME=*PARAMETERS -
    /                     ( START=*IMMEDIATELY )
    /.ESYSTOP END-PROC
  4. Adjust job control for the Entire System Server Trace Program.

    Edit the example element P.ESYTRACE and adjust the parameters used in it.

    /.ESYTRACE BEGIN-PROC LOGGING=*NO, -
    /                     PARAMETERS=*NO
    / ENTER-PROCEDURE     FROM-FILE=*LIBRARY-ELEMENT -
    /                     ( LIBRARY=$SAG.NPRvrs.JOBS, -
    /                       ELEMENT=P.ESY ), -
    /                     PROCEDURE-PARAMETERS=(PGM=ESYTRACE), -
    /                     PROCESSING-ADMISSION=*PARAMETERS -
    /                     ( USER-IDENTIFICATION=TSOS, -
    /                       PASSWORD=C'pwd' ), -
    /                     JOB-CLASS=TSOSBAT, -
    /                     JOB-NAME=ESYTRACE, -
    /                     RESOURCES=*PARAMETERS -
    /                     ( CPU-LIMIT=*NO, -
    /                       RUN-PRIORITY=255 ), -
    /                     SCHEDULING-TIME=*PARAMETERS -
    /                     ( START=*IMMEDIATELY )
    /.ESYTRACE END-PROC

Step 10: E-Mail Client Requirements

SEND-EMAIL view requires the Entire System Server E-Mail Manager Task active to work properly. See the subsection Adjust job control for the Entire System Server E-Mail Manager Task in Step 8: Edit the Entire System Server Jobs for necessary changes to the job control.

For more information about E-Mail administration, see Run E-Mail Client in the section Common Entire System Server Features in the Entire System Server Administration documentation.