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 |
|---|---|
ESAvrs.JOBS
|
Entire Systems Management Adapter installation jobs. |
ESAvrs.MOD
|
Entire Systems Management Adapter load library. |
ESAvrs.SRC
|
Entire Systems Management Adapter source library. |
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 want to copy the files from CD-ROM, refer to the README.TXT file on the CD-ROM.
If you 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.
Copy member NPRPARMS from the library
ESAvrs.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.
Adjust job control for the Entire Systems Management Adapter ESAMAIN task.
Edit the example Element E.ESAMAIN and adjust the library and file
names used in it.
/.XCOM199 SET-LOGON-PARAMETERS / SKIP-COMMANDS TO-LABEL=START *------------------------------------------------------------------* * Run Entire Systems Management Adapter (ESA) 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.ESAMAIN.199.&($SYSJV.TSN) / ASSIGN-SYSLST TO=$SAG.LST.ESAMAIN.199.&($SYSJV.TSN).ZAPS, - / SYSLST-NUMBER=1 / SHOW-JOB-STATUS JOB-IDENTIFICATION=*OWN / CREATE-FILE FILE-NAME=$SAG.ESAnnn.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.ESAnnn.USER.MOD / ADD-FILE-LINK LINK-NAME=DDLIB2 ,FILE-NAME=$SAG.ESAnnn.MOD / ADD-FILE-LINK LINK-NAME=PARMS ,FILE-NAME=$SAG.ESAnnn.PARM.199 / ADD-FILE-LINK LINK-NAME=TRACE ,FILE-NAME=$SAG.ESAnnn.TRAC.199 / START-PROGRAM FROM-FILE=*MODULE - / ( LIBRARY=$SAG.ESAnnn.MOD, - / ELEMENT=ESAMAIN, - / PROGRAM-MODE=*ANY, - / RUN-MODE=*ADVANCED ), - / MONJV=#ESAMAIN.&($SYSJV.TSN) / SET-JOB-STEP / SHOW-JOB-STATUS JOB-IDENTIFICATION=*OWN / SKIP-COMMANDS TO-LABEL=OKAY, - / IF=JV(COND=(#ESAMAIN.&($SYSJV.TSN),1,2) EQ '$T') / WRITE-TEXT TEXT='***** ESAMAIN failed *****' / SKIP-COMMANDS TO-LABEL=STOP /.OKAY REMARK / WRITE-TEXT TEXT='***** ESAMAIN successfully executed *****' / SKIP-COMMANDS TO-LABEL=STOP /.STOP REMARK / EXIT-JOB MODE=*NORMAL,SYSTEM-OUTPUT=*NONE
This job is used to start theEntire Systems Management Adapter.
The file referenced by the link name PARMS
contains the Entire Systems Management Adapter startup parameters.
For a description of startup parameters, see section Startup Parameters.
The file assigned by link name TRACE is needed
to save the TRACE data buffer at exit of the ESAMAIN
Task. The assignment is not required if startup parameter
TRACE-SAV=NO was specified.
The library concept of Entire Systems Management Adapter is described in detail under Library Concept.. More information about running Entire Systems Management Adapter on BS2000 is available in the section BS2000 Considerations in the Entire Systems Management Adapter Administration documentation.
Adjust job control for the Entire Systems Management Adapter ESASERV Task.
Edit the example element E.ESASERV and adjust
the library and file names used in it.
/.XSRV199 SET-LOGON-PARAMETERS / SKIP-COMMANDS TO-LABEL=START *------------------------------------------------------------------* * Run Entire Systems Management Adapter (ESA) SERVER Task. * * * * Filename / LMS-element-name of this job must be specified in * * startup parameters. It will be started automatically at startup * * of Entire Systems Management Adapter by MAIN Task. * * If Dynamic Server Management is enabled, SERVER 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=$SAG.LST.ESASERV.199.&($SYSJV.TSN) / ASSIGN-SYSLST TO=$SAG.LST.ESASERV.199.&($SYSJV.TSN).ZAPS, - / SYSLST-NUMBER=1 / SHOW-JOB-STATUS JOB-IDENTIFICATION=*OWN / ADD-FILE-LINK LINK-NAME=DDLIB2 ,FILE-NAME=$SAG.ESAnnn.MOD / ADD-FILE-LINK LINK-NAME=BLSLIB00,FILE-NAME=$SAG.ESAnnn.USER.MOD / START-PROGRAM FROM-FILE=*MODULE - / ( LIBRARY=$SAG.ESAnnn.MOD, - / ELEMENT=ESASERV, - / PROGRAM-MODE=*ANY, - / RUN-MODE=*ADVANCED ), - / MONJV=#ESASERV.&($SYSJV.TSN) / SET-JOB-STEP / SHOW-JOB-STATUS JOB-IDENTIFICATION=*OWN / SKIP-COMMANDS TO-LABEL=OKAY, - / IF=JV(COND=(#ESASERV.&($SYSJV.TSN),1,2) EQ '$T') / WRITE-TEXT TEXT='***** ESASERV failed *****' / SKIP-COMMANDS TO-LABEL=STOP /.OKAY REMARK / WRITE-TEXT TEXT='***** ESASERV successfully executed *****' / SKIP-COMMANDS TO-LABEL=STOP /.STOP REMARK / EXIT-JOB MODE=*NORMAL,SYSTEM-OUTPUT=*NONE
This job is used to start the Entire Systems Management Adapter ESASERV
Tasks.
They will be started automatically by the ESAMAIN
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.
It is also possible to run a Dynamic Server Management with Entire Systems Management Adapter. For detailed information, see section Administration > Entire Systems Management Adapter Features > Dynamic Server Management.
Adjust job control for the Entire Systems Management Adapter Eventing Manager Task.
Edit the example element E.ESAEVTM and adjust
the library and file names used in it.
/.XEVT199 SET-LOGON-PARAMETERS / SKIP-COMMANDS TO-LABEL=START *------------------------------------------------------------------* * Run Entire Systems Management Adapter (ESA) Eventing Task. * * * * Filename / LMS-element-name of this job must be specified in * * startup parameters. It will be started automatically at startup * * of Entire Systems Management Adapter 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.ESAEVTM.199.&($SYSJV.TSN) / ASSIGN-SYSLST TO=$SAG.LST.ESAEVTM.199.&($SYSJV.TSN).ZAPS, - / SYSLST-NUMBER=1 / SHOW-JOB-STATUS JOB-IDENTIFICATION=*OWN / ADD-FILE-LINK LINK-NAME=DDLIB2 ,FILE-NAME=$SAG.ESAnnn.MOD / ADD-FILE-LINK LINK-NAME=BLSLIB00,FILE-NAME=$SAG.ESAnnn.USER.MOD / START-PROGRAM FROM-FILE=*MODULE - / ( LIBRARY=$SAG.ESAnnn.MOD, - / ELEMENT=ESAEVTM, - / PROGRAM-MODE=*ANY, - / RUN-MODE=*ADVANCED ), - / MONJV=#ESAEVTM.&($SYSJV.TSN) / SET-JOB-STEP / SHOW-JOB-STATUS JOB-IDENTIFICATION=*OWN / SKIP-COMMANDS TO-LABEL=OKAY, - / IF=JV(COND=(#ESAEVTM.&($SYSJV.TSN),1,2) EQ '$T') / WRITE-TEXT TEXT='***** ESAEVTM failed *****' / SKIP-COMMANDS TO-LABEL=STOP /.OKAY REMARK / WRITE-TEXT TEXT='***** ESAEVTM successfully executed *****' / SKIP-COMMANDS TO-LABEL=STOP /.STOP REMARK / EXIT-JOB MODE=*NORMAL,SYSTEM-OUTPUT=*NONE
This job is used to start the Entire Systems Management Adapter Eventing Task. It will be
started automatically by the MAIN Task at Entire Systems Management
AdapterEntire Systems Management Adapter 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.
Adjust job control for the Entire Systems Management Adapter CONSOLE Task.
Edit the example element E.ESACONS 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 Systems Management Adapter running in the same
host.
/.XCON199 SET-LOGON-PARAMETERS / SKIP-COMMANDS TO-LABEL=START *------------------------------------------------------------------* * Run Entire Systems Management Adapter (ESA) CONSOLE Task. * * * * Filename / LMS-element-name of this job must be specified in * * startup parameters. It will be started automatically at startup * * of Entire Systems Management Adapter 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.ESACONS.199.&($SYSJV.TSN) / ASSIGN-SYSLST TO=$SAG.LST.ESACONS.199.&($SYSJV.TSN).ZAPS, - / SYSLST-NUMBER=1 / SHOW-JOB-STATUS JOB-IDENTIFICATION=*OWN / ADD-FILE-LINK LINK-NAME=DDLIB2 ,FILE-NAME=$SAG.ESAnnn.MOD / SET-DCAM-APPL-LINK LINK-NAME=ESACONAP, "must not be changed" - / APPLICATION-NAME=ESACONS2 "may be changed" / START-PROGRAM FROM-FILE=*MODULE - / ( LIBRARY=$SAG.ESAnnn.MOD, - / ELEMENT=ESACONS, - / PROGRAM-MODE=*ANY, - / RUN-MODE=*ADVANCED ), - / MONJV=#ESACONS.&($SYSJV.TSN) CON6,C'CON6' / SET-JOB-STEP / SHOW-JOB-STATUS JOB-IDENTIFICATION=*OWN / SKIP-COMMANDS TO-LABEL=OKAY, - / IF=JV(COND=(#ESACONS.&($SYSJV.TSN),1,2) EQ '$T') / WRITE-TEXT TEXT='***** ESACONS failed *****' / SKIP-COMMANDS TO-LABEL=STOP /.OKAY REMARK / WRITE-TEXT TEXT='***** ESACONS 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 Systems Management Adapter. It will be started automatically by the
MAIN task at Entire Systems Management Adapter 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.
Authorization for connection to UCON (connection
message) must be specified as parameter of the program ESACONS.
Adjust job control for the Entire Systems Management Adapter Shutdown Program.
Edit the example element E.ESASTOP and adjust
the library and file names used in it.
/.ESASTOP SET-LOGON-PARAMETERS / SKIP-COMMANDS TO-LABEL=START *------------------------------------------------------------------* * Execute ESASTOP to shutdown Entire Systems Management Adapter. * *------------------------------------------------------------------* /.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.ESASTOP.199.&($SYSJV.TSN) / SHOW-JOB-STATUS JOB-IDENTIFICATION=*OWN / ADD-FILE-LINK LINK-NAME=DDLIB2 ,FILE-NAME=$SAG.ESAnnn.MOD / ADD-FILE-LINK LINK-NAME=BLSLIB00,FILE-NAME=$SAG.ESAnnn.USER.MOD / START-PROGRAM FROM-FILE=*MODULE - / ( LIBRARY=$SAG.ESAnnn.MOD, - / ELEMENT=ESASTOP, - / PROGRAM-MODE=*ANY, - / RUN-MODE=*ADVANCED ), - / MONJV=#ESASTOP.&($SYSJV.TSN) --JNAME XCOM199 / SET-JOB-STEP / SHOW-JOB-STATUS JOB-IDENTIFICATION=*OWN / SKIP-COMMANDS TO-LABEL=OKAY, - / IF=JV(COND=(#ESASTOP.&($SYSJV.TSN),1,2) EQ '$T') / WRITE-TEXT TEXT='***** ESASTOP failed *****' / SKIP-COMMANDS TO-LABEL=STOP /.OKAY REMARK / WRITE-TEXT TEXT='***** ESASTOP 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 Systems Management Adapter.
For further information, see Shutdown of Entire Systems Management Adapter on BS2000 Considerations.
Adjust job control for the Entire Systems Management Adapter Trace Program.
Edit the example element E.ESATRACE and adjust
the library and file names used in it.
/.ESATRACE SET-LOGON-PARAMETERS / SKIP-COMMANDS TO-LABEL=START *------------------------------------------------------------------* * Execute ESATRACE to run ESM Adapter (ESA) 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.ESATRACE.199.&($SYSJV.TSN) / SHOW-JOB-STATUS JOB-IDENTIFICATION=*OWN / CREATE-FILE FILE-NAME=$SAG.ESAnnn.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.ESAnnn.TRAC.199 / ADD-FILE-LINK LINK-NAME=TROUT ,FILE-NAME=$SAG.ESAnnn.TROU.199 / ADD-FILE-LINK LINK-NAME=DDLIB2 ,FILE-NAME=$SAG.ESAnnn.MOD / ADD-FILE-LINK LINK-NAME=BLSLIB00,FILE-NAME=$SAG.ESAnnn.USER.MOD / START-PROGRAM FROM-FILE=*MODULE - / ( LIBRARY=$SAG.ESAnnn.MOD, - / ELEMENT=ESATRACE, - / PROGRAM-MODE=*ANY, - / RUN-MODE=*ADVANCED ), - / MONJV=#ESATRACE.&($SYSJV.TSN) 199 --POLL / SET-JOB-STEP / SHOW-JOB-STATUS JOB-IDENTIFICATION=*OWN / SKIP-COMMANDS TO-LABEL=OKAY, - / IF=JV(COND=(#ESATRACE.&($SYSJV.TSN),1,2) EQ '$T') / WRITE-TEXT TEXT='***** ESATRACE failed *****' / SKIP-COMMANDS TO-LABEL=STOP /.OKAY REMARK / WRITE-TEXT TEXT='***** ESATRACE successfully executed *****' / SKIP-COMMANDS TO-LABEL=STOP /.STOP REMARK / EXIT-JOB MODE=*NORMAL,SYSTEM-OUTPUT=*NONE
This job is used to run program ESATRACE. It
analyzes the TRACE data of Entire Systems Management Adapter if startup parameter
TRACE=YES is defined. In order to start ESATRACE 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. 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 section Administration >
Entire Systems Management Adapter >
Creating
Trace Data for Diagnostic Purposes.
Adjust job control for the Entire Systems Management Adapter E-Mail Manager Task There are job control examples to run the Entire Systems Management Adapter 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 Systems Management Adapter E-Mail Manager Task based on
IP Version 4 is available in the sample element E.ESAMAIL4, the
job control for the Entire Systems Management Adapter E-Mail Manager Task based on IP Version 6 is
available in the sample element E.ESAMAIL.
This allows defining the required IP version in the Entire Systems Management Adapter
startup parameter file by specifying E.ESAMAIL4 or
E.ESAMAIL as value for parameter
JOBEMAIL.
Edit the example element E.ESAMAIL4 or
E.ESAMAIL and adjust the library and file names used in it.
Element E.ESAMAIL is listed below.
/.XEML199 SET-LOGON-PARAMETERS / SKIP-COMMANDS TO-LABEL=START *------------------------------------------------------------------* * Run Entire Systems Management Adapter (ESA) E-Mail Task. * * * * Filename / LMS-element-name of this job must be specified in * * startup parameters. It will be started automatically at startup * * of Entire Systems Management Adapter 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.ESAMAIL.199.&($SYSJV.TSN) / ASSIGN-SYSLST TO=$SAG.LST.ESAMAIL.199.&($SYSJV.TSN).ZAPS, - / SYSLST-NUMBER=1 / SHOW-JOB-STATUS JOB-IDENTIFICATION=*OWN / ADD-FILE-LINK LINK-NAME=DDLIB2 ,FILE-NAME=$SAG.ESAnnn.MOD / ADD-FILE-LINK LINK-NAME=BLSLIB00,FILE-NAME=$SAG.ESAnnn.USER.MOD / START-PROGRAM FROM-FILE=*MODULE - / ( LIBRARY=$SAG.ESAnnn.MOD, - / ELEMENT=ESAMAIL, - / PROGRAM-MODE=*ANY, - / RUN-MODE=*ADVANCED ), - / MONJV=#ESAMAIL.&($SYSJV.TSN) / SET-JOB-STEP / SHOW-JOB-STATUS JOB-IDENTIFICATION=*OWN / SKIP-COMMANDS TO-LABEL=OKAY, - / IF=JV(COND=(#ESAMAIL.&($SYSJV.TSN),1,2) EQ '$T') / WRITE-TEXT TEXT='***** ESAMAIL failed *****' / SKIP-COMMANDS TO-LABEL=STOP /.OKAY REMARK / WRITE-TEXT TEXT='***** ESAMAIL successfully executed *****' / SKIP-COMMANDS TO-LABEL=STOP /.STOP REMARK / EXIT-JOB MODE=*NORMAL,SYSTEM-OUTPUT=*NONE
This job is used to start the Entire Systems Management Adapter E-Mail Manager Task based
on IP Version 6. It will be started automatically by the MAIN Task at Entire
Systems Management AdapterEntire Systems Management Adapter 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. For further information about E-Mail
administration, see
Run
E-Mail Client.
As an alternative to the delivered startup jobs, you may run Entire Systems Management Adapter
by an SDF-P procedure. All tasks can be managed via
SDF-P procedure P.ESA.
/ "-----------------------------------------------------------------"
/ " PROC-NAME: P.ESA "
/ " FUNCTION : Run Entire Systems Management Adapter (ESA) Tasks "
/ " "
/ " Parameter Description "
/ " ---------------- ---------------------------------------------- "
/ " PGM Program to be executed "
/ " ESACONS - Run CONSOLE Task "
/ " ESAEVTM - Run Eventing Manager Task "
/ " ESAMAIL - Run E-Mail Manager Task "
/ " ESAMAIN - Run MAIN Task "
/ " ESASERV - Run SERVER Task "
/ " ESASTOP - Run ESA Shutdown "
/ " ESATRACE - Run TRACE analyzer "
/ " "
/ " APPL-NAME DCAM name of the CONSOLE application "
/ " CONS-AUTH Console authorization name "
/ " CONS-PASS Console password "
/ " ESA-JOBS Name of the ESA jobs library "
/ " containing ESA startup parameters "
/ " ESA-MOD Name of the ESA module library "
/ " ESA-PARMS-ELEM Name of LMS-element in library &(ESA-JOBS) "
/ " ESA-USER-MOD Name of the ESA user library "
/ " NODE Entire Systems Management Adapter node number "
/ " USER-ID User Id for files "
/ "-----------------------------------------------------------------"
/ SET-PROCEDURE-OPTIONS DATA-ESCAPE-CHAR = *STD
/
/ BEGIN-PARAMETER-DECLARATION
/ DECLARE-PARAMETER PGM (*PROMPT)
/ DECLARE-PARAMETER APPL-NAME ('ESYCONS2')
/ DECLARE-PARAMETER CONS-AUTH ('CON6')
/ DECLARE-PARAMETER CONS-PASS ('CON6')
/ DECLARE-PARAMETER ESA-JOBS ('$SAG.ESAnnn.JOBS')
/ DECLARE-PARAMETER ESA-MOD ('$SAG.ESAnnn.MOD')
/ DECLARE-PARAMETER ESA-PARMS-ELEM ('NPRPARMS')
/ DECLARE-PARAMETER ESA-USER-MOD ('$SAG.ESAnnn.USER.MOD')
/ DECLARE-PARAMETER NODE ('199')
/ DECLARE-PARAMETER USER-ID ('$SAG')
/ END-PARAMETER-DECLARATION
/
/ "-----------------------------------------------------------------"
/ " Procedure Initialization "
/ " ------------------------ "
/ " 1. Set variables "
/ " o DATA - Data for ESA-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 "
/ "-----------------------------------------------------------------"
/
/&*IF (PGM = 'ESAMAIL')
/&* PGM = 'ESAMAIL4'
/&*END-IF
/
/ DATA = ' '
/ PFX = '&(PGM).&(NODE)'
/ TSN = JV('$SYSJV.TSN')
/ UTILITY = 'NO'
/ LST = '&(USER-ID).LST.&(PFX).&(TSN)'
/
/ IF (PGM = 'ESASTOP')
/ UTILITY = 'YES'
/ END-IF
/
/ IF (PGM = 'ESATRACE')
/ 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 = 'ESACONS')
/ SET-DCAM-APPL-LINK LINK-NAME = ESACONAP, -
/ APPL-NAME = &(APPL-NAME)
/ DATA = '&(CONS-AUTH),C''&(CONS-PASS)'''
/ END-IF
/
/ "-----------------------------------------------------------------"
/ " MAIN Task specific actions "
/ "-----------------------------------------------------------------"
/ IF (PGM = 'ESAMAIN')
/ START-LMS
// MOD-LMS-DEFAULTS MAX-ERROR-WEIGHT=*RECOVERABLE
// EXTRACT-ELEMENT *LIB(&(ESA-JOBS),&(ESA-PARMS-ELEM),S), -
// TO-FILE = #NPRPARMS, -
// FILE-ATTR = (ACCESS-METHOD=*SAM), -
// WRITE-MODE = *ANY
// END
/ 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=TRACE,FILE-NAME=&(USER-ID).TRACE.&(NODE)
/ END-IF
/
/ "-----------------------------------------------------------------"
/ " ESA Shutdown specific actions "
/ "-----------------------------------------------------------------"
/ IF (PGM = 'ESASTOP')
/ DATA = '--JNAME XCOM&(NODE)'
/ END-IF
/
/ "-----------------------------------------------------------------"
/ " TRACE analyzer specific actions "
/ "-----------------------------------------------------------------"
/ IF (PGM = 'ESATRACE')
/ 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=&(ESA-MOD)
/ ADD-FILE-LINK LINK=BLSLIB00,FILE-NAME=&(ESA-USER-MOD)
/
/ IF (DATA = ' ')
/ START-EXEC-PROG (&(ESA-MOD),&(PGM))
/ ELSE
/ START-EXEC-PROG (&(ESA-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.ESAMAIN, P.ESASTOP and P.ESATRACE to
run the Entire Systems Management Adapter, to stop it, and to retrieve trace data from the node.
Adjust job control for the Entire Systems Management Adapter MAIN Task.
Edit the example Element P.ESAMAIN and adjust
the parameters used in it.
/.ESAMAIN BEGIN-PROC LOGGING=*NO, - / PARAMETERS=*NO / ENTER-PROCEDURE FROM-FILE=*LIBRARY-ELEMENT - / ( LIBRARY=$SAG.ESAvrs.JOBS, - / ELEMENT=P.ESA ), - / PROCEDURE-PARAMETERS=(PGM=ESAMAIN), - / 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 ) /.ESAMAIN END-PROC
Adjust job control for the Entire Systems Management Adapter Shutdown Program.
Edit the example element P.ESASTOP and adjust
the parameters used in it.
/.ESASTOP BEGIN-PROC LOGGING=*NO, - / PARAMETERS=*NO / ENTER-PROCEDURE FROM-FILE=*LIBRARY-ELEMENT - / ( LIBRARY=$SAG.ESAvrs.JOBS, - / ELEMENT=P.ESA ), - / PROCEDURE-PARAMETERS=(PGM=ESASTOP), - / PROCESSING-ADMISSION=*PARAMETERS - / ( USER-IDENTIFICATION=TSOS, - / PASSWORD=C'pwd' ), - / JOB-CLASS=TSOSBAT, - / JOB-NAME=ESASTOP, - / RESOURCES=*PARAMETERS - / ( CPU-LIMIT=*NO, - / RUN-PRIORITY=255 ), - / SCHEDULING-TIME=*PARAMETERS - / ( START=*IMMEDIATELY ) /.ESASTOP END-PROC
Adjust job control for the Entire Systems Management AdapterTrace Program.
Edit the example element P.ESATRACE and adjust
the parameters used in it.
/.ESATRACE BEGIN-PROC LOGGING=*NO, - / PARAMETERS=*NO / ENTER-PROCEDURE FROM-FILE=*LIBRARY-ELEMENT - / ( LIBRARY=$SAG.ESAvrs.JOBS, - / ELEMENT=P.ESA ), - / PROCEDURE-PARAMETERS=(PGM=ESATRACE), - / PROCESSING-ADMISSION=*PARAMETERS - / ( USER-IDENTIFICATION=TSOS, - / PASSWORD=C'pwd' ), - / JOB-CLASS=TSOSBAT, - / JOB-NAME=ESATRACE, - / RESOURCES=*PARAMETERS - / ( CPU-LIMIT=*NO, - / RUN-PRIORITY=255 ), - / SCHEDULING-TIME=*PARAMETERS - / ( START=*IMMEDIATELY ) /.ESATRACE END-PROC
SEND-EMAIL view requires
the Entire Systems Management Adapter E-Mail Manager Task active to work properly.
See the subsection Adjust job control for the Entire Systems Management Adapter E-Mail Manager Task in Step 2: Edit the Entire Systems Management Adapter Jobs for necessary changes to the job control.
For more information about E-Mail administration, see Run E-Mail Client.