We recommend reading this section from beginning to end before starting the installation process.
This document covers the following topics:
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:
|
MLCvrs.MOD |
Load library for Software AG's mainframe license check software including the LICUTIL license utility Notes:
|
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. |
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.
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).
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.
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.
(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.
(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) |
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.
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
|
Assemble this module as described in the section Installing the Entire System Server Interface in the Natural Installation documentation for mainframes.
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.
(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.
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.
Copy member NPRPARMS from the library
NPRvrs.SRC to a SAM or ISAM file.
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.
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.
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.
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.
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
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.
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.
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.
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.
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
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.
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
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
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
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.