See also the section Define SAT, Natural, Product Parameters in Installation on Mainframe Platforms of the System Automation Tools documentation.
For each Entire Event Management Server you must define the run time environment in one or more Natural members in the SAT user library SYSSATU.
If you want to run various Entire Event Management Servers on different Entire System Server nodes vrs, you must provide startup parameters at least in the related "main" members. These must conform to the following naming convention: SATPvrs. In addition, you can provide further Entire Event Management- specific parameters in a second member, whose name must not match the naming convention for the "main" members.
This document covers the following topics:
Mandatory Parameter Blocks and Parameters for Entire Event Management
Optional Parameter Blocks and Parameters for Entire Event Management
<Prefix> <block-identifier> [<keyword>=<value>,...]
where:
| Parameter | Description |
|---|---|
| <Prefix> | SAT or compressed product code + prefix as specified in the SATSTART instruction. |
| <block-identifier> | SATENV/NATENV/SATSTART or product block identifier. |
| [<keyword>=<value>,...> | Block-specific parameter. |
| Parameter Block | Parameter | Description |
|---|---|---|
| NCLENV | NCLSEQF= | Prefix for the name of the Backup Files used by the Entire Event Management Server (see also the section Create Backup Files). |
| VOLSER= | z/VSE only: Volume to which the Backup Files used by the Entire Event Management Server are allocated. | |
| NCLREFR=Y/N | If set to "Y", Entire Event Management Server downloads the currently assigned definitions from the data base to the backup file and loads from there into main storage. If set to "N", definitions are loaded directly from the backup file. | |
| SATENV | NSC=YES/NO | Indicates whether Natural Security is installed or not. |
| NSCUSER= | If Natural Security is installed, this is the user ID for logging on to it. | |
| NSCPSWD= | Password for logging on to Natural Security. | |
| ESYUSER= | User ID for logging on to Entire System Server, if it is installed and an interface to an external security system is activated. | |
| NATTASK= | Name of the Natural subtask module for starting a server as a subtask. | |
| NATENV | LFILE=(202,<NCLSYSF2-DBID>,<NCLSYSF2-FNR>) | |
| Pointer to Entire Event Management System File 2. Make sure that this pointer coincides with the pointer to the Entire Event Management System File 2 provided with the SERVSYSF parameter in the SATSTART block. 1 | ||
| LFILE=(203,<NCLSYSF3-DBID>,<NCLSYSF3-FNR>) | ||
| Pointer to Entire Event Management System File 3. 1 | ||
| LFILE=(204,<SAT-FNAT-DBID>,<SAT-FNAT-FNR>) | ||
| Pointer to FNAT for System Automation Tools. 1 | ||
| ULANG=1 | Language code. | |
| SATSTART | SATVERS=31 | Entire Event Management Server startup program supports SAT version 3.1. |
| PRODUCT=NCL | 3-byte product code. | |
| PREFIX= | PRODUCT and PREFIX are compressed into a prefix which identifies the Server- specific parameters. | |
| TYPE=SUBTASK | Entire Event Management Servers are always started as subtasks. 2 | |
| APPLLIB=SYSNCLSV | Name of the Natural library where Entire Event Management Server is installed. | |
| SERVSYSF= | Pointer to the Entire Event Management System File 2 (must be unique within all SATSTART instructions of this node). | |
Notes:
1 These pointers can be alternately set in the common NATPARM module created for the System Automation Tools products or in a Natural parameter profile indicated by the Natural parameter PROFILE.
2 On BS2000/OSD these subtasks are simulated by Entire System Server, which submits jobs with names following the convention NCLxxvrs, where xx stands for the Entire Event Management subtask and vrs for the Server number. Values for xx can be:
| MA | Main Task |
| LO | Logging Task |
| AC | Action Task |
| AN | Analysis Task |
| GE | Collect Task |
| US | User Action Tasks |
| CL | System File 3 Cleanup Task |
| PI | API Receiver Task |
Furthermore, you can overwrite the SATENV and NATENV parameters with Entire Event Management-specific or even Entire Event Management-subtask-specific assignments. The naming convention for the prefix which identifies the parameter block is:
| Parameter Block | Parameter | |
|---|---|---|
| NATENV | LFILE=(216,<NOPSYSF1-DBID>,<NOPSYSF1-FNR>) | 1,2,3 |
| LFILE=(131,<SATLOG-DBID>,<SATLOG-FNR>) | 1,3,4 | |
| SATSTART | MEMBER= | 5 |
1 These pointers are only needed if Entire Operations is installed and the Entire Event Management Server is to start Entire Operations job networks as automated actions.
2 Pointer to Entire Operations System File 1.
3 These pointers can be alternately set in the common NATPARM module created for the System Automation Tools products or in a Natural parameter profile indicated by the Natural parameter PROFILE.
4 Pointer to SAT log file.
5 You can specify a member where Entire Event Management-specific parameters are located.
The member SATP148 in SYSSAT provides an example of a "main" member. You can take this as the basis for your own member: just copy it to SYSSATU and adapt it.
In the example below it is assumed that you are running three products of the SAT product family (Entire Event Management, Entire Output Management and Entire Operations) as subtasks on Node 148. The parameters of Entire Event Management are located in a second member NCLPARMS.
| SAT | SATENV |
NATTASK=NATvrSAT, |
1 |
| SAT | NATENV |
DU=OFF, |
2 |
| SAT | SATSTART |
SATVERS=31, |
3 |
| SAT | SATSTART |
SATVERS=31, |
4 |
| SAT | SATSTART |
SATVERS=31, |
5 |
1 Sets the System Automation Tools defaults for all System Automation Tools products, here: Entire Event Management, Entire Output Management and Entire Operations. The notation vr stands for the relevant version and release of installed Natural.
2 Sets the Natural defaults for all System Automation Tools products: the Natural profile parameters are provided in the profile SATMON.
3 Specifies that the server for Entire Output Management 3.1.1 should be started as a subtask.
4 Specifies that the server for Entire Operations 5.1.1 should be started as a subtask.
5 Specifies that the server for Entire Event Management 2.2.1 should be started as a subtask and that the default parameters are to be overlaid with the parameters from NCLPARMS.
| NCL221 | NCLENV | NCLSEQF=NCL.SYSF | 1 |
| NCLREFR=N | 1 | ||
| NCL221MAIN | SATENV | ESYUSER=NCLMAIN | 2 |
| NCL221GETM | SATENV | ESYUSER=NCLGETM | 2 |
| NCL221ANLS | SATENV | ESYUSER=NCLANLS | 2 |
| NCL221LOGG | SATENV | ESYUSER=NCLLOGG | 2 |
| NCL221ACTN | SATENV | ESYUSER=NCLACTN | 2 |
| NCL221PIRC | SATENV | ESYUSER=NCLPIRC | 2 |
1 Specify Entire Event Management-specific product parameters.
2 Specify User IDs for each Entire Event Management subtask for logging on to Entire System Server.