Micro Focus Enterprise Server for .NET 5.0
Product Information
Supported Operating Systems and Third-party Software
Updates and Product Support
Micro Focus End User License Agreement
Contacting Micro Focus
Further Information and Product Support
Information We Need
Contact information
The Micro Focus Community
Help on Help
Role-based Contents - Introduction
General Information for all Roles
Introduction to Enterprise Server for .NET
System Architecture
Operating Components
The WCF/WAS Operating Environment
Region Databases
Cross-region Database
Listener
Dispatcher
Advanced Dispatcher Information
Service Execution Process (SEP)
Event Monitor
Processing Event Sequence - CICS
Processing Event: Establishing Communications
Processing Event: Input Transactions
Processing Event: Scheduled Transactions
Processing Event Sequence - JES
Job Submission Sequence
Job Execution Sequence
System Architecture Options
Single Machine Architecture
Multiple Machine Architecture
Scale Out Architecture
Detailed Architecture
SEP Pool Layout Architecture
Quick Start
Installing and Verifying the Software
Setting Up the Operating Environment
To Activate Windows and IIS Components
To Install Additional Features on a Windows 2008 Server, or Windows 7
To Install Additional Features on a Windows Server (2012 or later), Windows 10 or Later
To Configure Process Logon Credentials
Installing Enterprise Server for .NET
To Run the Installation Software
To Configure IIS and WAS Support
Default Installation Paths
Upgrading from an Earlier Version
To Upgrade Definition Files after an Upgrade
To Upgrade a Resource Definition File in the Cross-region Database
Verifying the Installation
To Set Up and Start the User Interface for the First Time
Verifying A CICS Region
To Create the Demonstration CICS Region
To Start the Demonstration CICS Region
To Configure and Start the Listener for the ESDEMO Region
To Connect a 3270 Client to the ESDEMO Region and Run a Sample Transaction
To Run the CICS Installation Verification Procedure
Verifying a JES Region
To Create the Demonstration JES Region
To Start the Demonstration JES Region
To Configure and Start the Listener for the JCLDEMO Region
To Run the JES Installation Verification Procedure
Supplied Samples and Configuration Files
Supplied Configuration Files - CICS
Sample: CICS ACCT Transaction
Sample - CICS BankDemo
Sample - BankDemo JES
Samples: SQL Server Connection String Exit Programs
Sample: Terminal Configuration Exit Program
Error Messages
AD - series
AM - series
BP - series
CF - series
CM - series
CNV - series
DP - series
DT - series
EL - series
EM - series
EP - series
EX - series
JA - series
KC - series
LO - series
LS - series
MS - series
OP - series
PC - series
PS - series
RD - series
TX - series
UPG - series
WU - series
Administrator Role
General Administration
Administering anEnterprise Server for .NET Installation
Monitoring a Region's tasks
To Monitor the Tasks Running in a Region
To Kill a Task that is Running
Using the Region Console
To Open and Configure the Region Console
Setting the Message Level for a Region
To Set a Region's Console Message Level
Responding to Pending Console Input Requests
To Respond to a Pending Console Input Request from the Console View
Viewing a Region's Statistics
To View the Statistics for a Region
Viewing a Region's Sessions
To View the Sessions for a Region
Monitoring the Operating environment
Viewing Messages in the Windows Event Log
Windows Services Used By Enterprise Server for .NET
Configuring Windows Performance Counters
Administering Using SCOM (System Center Operations Manager)
System Requirements for SCOM Implementation
Installing Management Pack from Operations Manager
To Display Region Details in SCOM
Managing Event Monitors
To Delete an Event Monitor Registration from the Cross-Region Database
Configuring the Operating Environment
Setting Up the User Interface
To Set Up and Start the User Interface for the First Time
Configuring the Database
Configuring Database Authentication
To Configure Enterprise Server for .NET to Use SQL Server Authentication
Sample Machine Configuration for SQL Authentication
Changing the User for a Service
Configuring a Listener
Ensuring a Listener Remains Active
To Configure a Listener
Creating User-Specific Configurations
Example: Creating a User-Specific Listener Configuration Port
Configuring from File
Changing Inter Role Communication Parameters
Defining Program and Data Locations
About Program and Data Locations
Database Locations
File Share Configuration
Adding Configuration Files to the Cross-region Database
To Add a Region Startup File to the Cross-region Database using MMC
To Add a Region Startup File to the Cross-Region Database using seedeploy
To Add a Resource Definition File to the Cross-region Database using MMC
To Add a Resource Definition File to the Cross-Region Database using seedeploy
Adding Programs and BMS Maps to a Database at Region Startup
To Add Programs and BMS Maps to a Database at Region Startup
Adding Data Files to a Data Store
To Add a Data File using MMC
To Add a Data File using seedeploy
Adding Programs and BMS Maps to a Data Store
To Add Programs and BMS Maps to a Data Store using MMC
To Add Programs and BMS Maps to a Data Store using seedeploy
Defining Program and Data Locations in the Region Startup File
Using URLs to Define Program and Data Locations
Using Variables to Set Locations
Defining Data Locations
Configuring Regions and Resources
About Region Startup and Resource Definitions
To Define a New Region With an Existing Region Startup File
To Set a Region's Startup File
About Region Properties
To Create or Edit a Region Startup Properties File
To Start a Region With a Properties File (MMC UI)
To Start a Region With a Properties File (seestart)
To Define Properties in a Region Startup File
About Entry Point Name Mapping
To Define Entry Point Name Mappings
About File Handler Configuration
To Define File Handler Configuration
About CICS Printers
To Configure an SCS Printer
Starting and Stopping a Region
Starting a Region
To Start a Region
Stopping a Region
To Stop a Region
Securing the Environment
About User Impersonation
About the Default User Account
Configuring Security in a Multi-Machine Environment
Configuring User Access Across Domains
Configuring Surrogate User Authority
Setting the Windows Logon Type
Controlling Impersonation Behavior
Settings for User Impersonation Security
To Set Impersonation Options using machine.config
Activating User Impersonation Changes
Authenticating CICS SQL Operations
Using EXEC CICS SIGNON and SIGNOFF
Troubleshooting Impersonation Issues
Resolving Transaction Abend Issues
Tracing User Impersonation Issues
Using Logon Providers
What is a Logon Provider?
Logon Providers in Enterprise Server for .NET
Configuring Logon Providers
To Set Impersonation Options using machine.config
External Security Feature
Overview
Configuration
ESM Modules Included with ES.NET
Using the ESM Modules
LogonEsm
NullEsm
LdapEsm
ESF-Administering ESF Configuration
Configure A JES Region To Use A Security Configuration
Configuring ESF for Windows users, Impersonation, and LDAP resource control
Reducing the Attack Surface
Optional Items in the CICS Region Startup File
Optional Items in the JES Region Startup File
Optional Items in the CICS Resources Definition File
Optional Items in the Listener Configuration File
Configuring XA resources
About XA Resources
To Create a Database XA Resource Definition
To Create an MQ XA Resource Definition
SEP Recycling
To Configure SEP Recycling for a JES Region
Administering from the Command Line
General Command Line Utilities
seeazure: Administration of Azure deployments and Services
seeconsoleviewer: start a console viewer
seedeploy: deploy configuration files and programs to a database or Azure Drive
seedispatch: start a dispatcher
seedup: retrieve trace table entries.
seelistener: start, stop, or dynamically configure a communications listener
seegetmi: Get machine information
seehsf: Historical Statistics Facility (HSF) administration
seemmc: launch the Microsoft Management Console (MMC) SEE Administration UI
seemmcconfig: manage the Microsoft Management Console (MMC) region definitions
seemonitor: start an event monitor
seeseccfg: Security configuration
seestart: start a region
seestop: stop a region
seesys: administer a running system
seeupgrade: upgrade from an earlier version
seewcfutil : Windows Communication Framework configuration
seexadef: administer XA resource definitions
wasreset: reset IIS and WAS
wassetup: set up IIS and WAS
PowerShell
Adding the PowerShell SnapIn
PowerShell Cmdlets
Database Server Instance Discovery
Get-SEERegions: return regions
Get-SEERegionStatus: return the status of a region
Get-SEESEPPools: return registered SEP pools
Start-SEERegion: start a Region
Stop-SEERegion: stop a region
PowerShell Cmdlet Example
Historical Statistics Facility (HSF)
To Enable HSF for a CICS Region
To Enable HSF for a JES Region
To View and Administer HSF Data for a CICS Region
To View and Administer HSF Data for a JES Region
WebSphere MQ
To Create an MQ XA Resource Definition
To Associate an MQ XA Resource with a CICS Region Startup File
To Associate an MQ XA Resource with a SIT
To Configure a CICS Trigger Monitor
To MQ Enable a JES Region
System Monitoring and Recovery
Diagnostics
Local Trace Tables
To View Local Trace Tables from the SEP Traces View
To View Local Trace Tables from the Monitor View
Windows Event Log
Consolidated Tracing Facility (CTF)
Enabling Trace Functionality
Component Tracing Properties Reference
mf.see.admin Component Trace Properties
mf.see.comms.isc Component Trace Properties
mf.see.configuration Component Trace Properties
mf.see.dispatch Component Trace Properties
mf.see.listener Component Trace Properties
mf.see.monitor Component Trace Properties
mf.see.sep Component Trace Properties
mf.see.utils Component Trace Properties
mf.see.vsam Component Trace Properties
Emitter List
TEXTFILE Emitter Properties
BINFILE Emitter Properties
Minidumps
Diagnostic Collection Utility
Enterprise Server for .NET Context Sensitive Topics
Add Files to Deployment List
CICS Resource Files: Deployed to a Cross-region Database
Console: View Region Console
Create New Data Store
Data Store View: Deployed Datastores
Define Data Store: List Existing
Define Data Store: Select Database Instance
Define Region: Region Name
Define Region: Select Database Instance
Define Region: Startup file
Deployment List: Components Deployed to a Region Database
Deployment List: Components Deployed to Cross-region Database
Deployment List: Components Deployed to Custom Database
Edit CICS Resources
Catalog View
Spool View
Sessions View
Locks View
Cross Region Resource Locks
ListenerControl
Initiators View
Printers View
Locations View
Requests View
Program Aliases View
Edit Property File: Define Pseudo-variables
Edit Region Startup File
Dynamic Debugging
JES: Submit JCL to JES
Listener Configuration
Monitor Region
Properties: View and Edit Region Properties
Region Startup File Location: Add Region File
Region Startup Files: Deployed to a Cross-region Database
Regions: View Defined Regions
Registered Event Monitors: Remove
Remove from Region List confirmation
Remove Region File Confirmation
Shared Catalog Definitions
Start/Stop Region
Statistics: View Statistics for a Region
XA Resource Definitions
Azure Deployment : Global Configuration View
Azure Deployment : Run-time Environment View
Azure Deployment : Performance Monitoring View - Dispatcher
Azure Deployment : Performance Monitoring View - Listener
Azure Deployment : Performance Monitoring View - SEP
Azure Deployment : Service Configuration View - Dispatcher
Azure Deployment : Service Configuration View - Listener
Azure Deployment : Service Configuration View - Monitor
Azure Deployment : Service Configuration View - SEP
Azure Deployment : Configuration Editor
Azure Deployment : Publish View
Azure Deployment : Azure Certificate View
Azure Deployment : Location View
Azure Deployment : Database View
Azure Deployment : Diagnostics View
Azure Deployment : Region Definition View
Azure Deployment : Storage View
Azure Deployment : Azure Drives View
Azure Deployment : Tracing View
Azure Deployment : Local Resources View
Azure Deployment : Build Instructions view
Azure Deployment : Endpoints View
Azure Deployment : Startup Tasks View
Azure Deployment : Remote Access View
Azure Deployment : Database Connection Strings View
Azure Deployment : Role Configuration View
CICS Administration
CICS Region Configuration
CICS Region Startup Files
To Create a CICS Region Startup File
To Edit a Region Startup File Associated with a CICS Region
To Set The Artifact Location and Search Order
To Associate a Resource Definition File with a Region Startup Definition File
To Add an Existing Region to the User Interface
To Associate a Database XA Resource with a CICS Region Startup File
To Associate an MQ XA Resource with a CICS Region Startup File
Defining and Configuring Resources
About CICS Resource Definitions
Copying and Pasting Resource Definitions Items
Renaming a Resource Definitions Item
To Create a New Resource Definition File
To Open a Resource Definition File for Editing
To Edit a Resource Definitions File
To Create or Edit a Group
To Create a New Resource Within a Group
To Edit An Existing Resource Within a Group
To Create or Edit a Startup List
To Create or Edit a System Initialization Table
FCT Definition and File Location Overrides
To Associate a Database XA Resource with a SIT
To Associate a Database XA Resource with a PCT
To Associate an MQ XA Resource with a SIT
Configuring a CICS Region's Program/Map Location and Search Order
To Configure a CICS Region's Program Location and Search Order
Configuring Data Stores Located in a Database or File System
To Configure a Data Store in a User-defined Database
To Configure a Resource Definition for a VSAM File On Disk
To Configure a Resource Definition for a Fileshare Server
Configuring the CICS Terminal Type
To Enable the Auto-install Exit
Configuring HCO for SQL Server Connections
To Configure an HCO for SQL Server Connection
Configuring REST Web Services and EXCI
About CICS REST Web Services
About CICS External Call Interface
Configuring REST Web Services
Configuring REST Web Services for AJAX
Configuring a REST Web Service for EXCI
To Configure a REST Web Service
Configuring EXCI
Configuring EXCI for the server
Configuring EXCI for the client
To Add a Client EXCI Configuration
To Add a Client EXCI Configuration to a JES Region
To Configure an EXCI User Exit
Configuring a Partner JES Region
Submitting JCL from CICS
Subsystem Started Task Manager (SSTM)
To Configure a Partner JES Region
To Configure a Partner JES Region with SSTM
Migrating a native Enterprise Server Resource Definitions File
To Migrate a native Enterprise Server Resource Definitions File
CICS Command Line Utilities
casfile
casrdtex
seerdfconv: migrate an Enterprise Server resource definition file
JES Administration
JES Region Configuration
To Create a JES Region Startup File
To Edit a Region Startup File Associated with a JES Region
To Configure a JES Region's Catalog Location
To Configure a JES Region's Program Location and Search Order
To Configure Initiators in a JES Region Startup File
To Configure Initiators in a Running JES Region
To Configure Printers in a JES Region Startup File
To Configure Printers in a Running JES Region
To Configure VSE Job Execution
To Add a Client EXCI Configuration to a JES Region
Submitting JCL to a JES Region
Submitting JCL from the command line
Submitting JCL from the Enterprise Server for .NET Administration UI
Job Numbers
To Configure Maximum and Minimum Job Numbers
Program Aliasing
To Configure Program Aliases in a JES Region Startup File
To Administer Program Aliases in a Running JES Region
Sharing Catalog and Spool Files Between JES Regions
To Create a Shared Catalog Definition Using seeout
To Create a Shared Catalog Definition Using the MMC UI
To Configure a JES Region to use a Shared Catalog
To View a Shared Spool File
Spooling
Spool Housekeeping
To Configure a Spool HouseKeeping Archive Location
To Start a JES Region using a Spool Housekeeping Archive
Spool Record and File Contents Preservation
JES Command Line Utilities
casout: administer a batch job or JES region
seeout: administer an Enterprise Server for .NET JES region
cassub: submit JCL to a JES region
Using REXX
Introduction
Configuring the REXX Execution Environment
Running REXX Under IKJEFT01
Running REXX Under IRXJCL
Restrictions
Micro Focus FTP Utility MFFTP
Prerequisites
Major Features of the MFFTP Utility
Basic Operation
Differences Between FTP clients on a Mainframe and Distributed Platforms
MFFTP Statements
Configuring the MFFTP Utility
Specifying Control Variables
Specifying Control Variables
MFFTP Control Variables
MFFTP DD Statements
Input and Output Temporary Files
MFFTP Using SFTP As An FTP Client
Configuring the End-of-Line Marker
Configuring Error Codes
Configuring the Text of Messages
Running the MFFTP Utility
When FTP is the Transport Client (MFFTP_CLIENT=FTP)
When Using a Third Party as the Transport Client (MFFTP_CLIENT=USER)
Writing a Module to Support a Third Party FTP Client
MFFTP Invoking a Third Party Client
The Parameter Block
MFFTP Processing the User Module
Event Manager
Event Manager Architecture
Events Supported
seepubsub Client
Using seepubsub from the Command Line
Using seepubsub as a Service
seepubsub Configuration File
Walkthrough with MFBSI
Event Manager Samples
Deployment
Deployment Planning
The Location of Artifacts
Scale Out Versus Scale Up Deployments
Azure Deployment
Scaling Out an Enterprise Server for .NET Installation
Scale Out Configuration
Scale Out Configuration Options
Scale Out Example
Setting Up the Cluster Machines
Installing Enterprise Server for .NET on a Cluster
Setting Up Database Access for a Cluster
Configuring the Firewall for a Cluster Installation
Testing the Database Connection
Setting Up and Testing Network Load Balancing
Defining the Service Endpoints
About Service Endpoints
Using URLs to Define Program and Data Locations
Default Service URLs
Service Location Order of Precedence
Configuring Custom Locations for Services
Changing the Default Service Port using machine.config
Configuring the SEP Endpoint for the Dispatcher
Configuring the Monitor Endpoint
Configuring the Dispatcher Endpoint for the Monitor
Deployment Best Practice
Development Role
The SDLC
Problem Determination
Common Problems
Dispatcher or SEP Invoke Failure
MMC: Error Adding Enterprise Server for .NET Snap-in
MMC: Open With a .msc File Error
Region Startup: Error Invoking DFHZPLT
Region Startup: No SEP Endpoint
IIS and WAS problems
SQL Server: Cannot Connect to remote SQL Server
Cannot start tasks or trigger transactions
Enterprise Server for .NET Reference Information
CICS APIs Supported
Application Programming CICS APIs
Supported Base APIs.
Abend
Address
Address Set
Assign
BifDeedit
Change Password
Freemain
Getmain
Handle Abend
Handle Aid
Ignore Condition
Handle Condition
Signoff
Signon
Syncpoint
Verify Password
Write Operator
Push Handle
Pop Handle
Supported BMS APIs
Purge Message
Receive Map
Send Control
Send Map
Send Page
Send Text
Supported File Control APIs
Delete
EndBr
Read
ReadNext
ReadPrev
StartBr
ResetBr
Rewrite
Unlock
Write
Supported IntervalControl APIs
AskTime
Cancel
Delay
FormatTime
Post
Retrieve
Start
Wait Event
WaitCics
Supported TaskControl APIs
Delete Container
Deq
Endbrowse Container
Enq
Get Container
Getnext Container
Link
Load
Move Container
Put Container
Release
Return
Startbrowse Container
Xctl
Supported TerminalControl APIs
Disconnect
Send
Receive
Supported TSTD APIs
DeleteQ TD
DeleteQ TS
ReadQ TD
ReadQ TS
WriteQ TS
WriteQ TD
Supported CICS System Programming APIs
Overriding ASSIGN and INQUIRE Values
Configuring ASSIGN and INQUIRE Override Values
EXEC CICS ASSIGN Override Values
EXEC CICS INQUIRE FILE Override Values
EXEC CICS INQUIRE PROGRAM Override Values
EXEC CICS INQUIRE TRANSACTION Override Values
CICS Supplied Transactions
CESF - Sign Off
CEBR - Browse Temporary Storage
CESN - Sign On
CFCR - Create a File
CFMT - File Master Transaction
CINQ - Inquire On ASSIGN Values
CINS - Install a Resource Group
CMAP - Display BMS Maps and Information
CPMT - Inquire and Set Program Attributes
CRUN - Generic Run Program
EXIT - Sign Off Terminal Emulator
Resource Definitions Available in Enterprise Server for .NET
CICS Resource Definitions
DEFINE CONNECTION
Examples
DEFINE FILE
Example
DEFINE PROGRAM
Example
DEFINE TERMINAL
Example
DEFINE TRANCLASS
DEFINE TRANSACTION
Example
DEFINE TDQUEUE
Examples
DEFINE TYPETERM
Example
DEFINE _SIGNON
EZASOKET support
EZASOKET Introduction
EZASOKET - Supported API
EZASOKET - Standard Transactions and Programs
Abend Codes in CICS Transactions
ASSA
EXIF
FUNC
IRST
LANG
MATP
MBLL
MCOM
MUSR
RECU
Developing Mainframe Managed Subsystem Applications
About Developing Enterprise Server for .NET Applications
Working with Programs
Working with BMS Maps
Working with VSAM Data
Creating a Managed Code Project
To Create a Managed Project
To convert a native project to a managed one
To Import Existing Project Components
Configuring Project Properties
To Configure the Project Properties
To Configure the Properties for a Source File
Project Properties Reference
Application Project Properties
COBOL Project Properties
Debug Project Properties
Copybook Paths Project Properties
SQL Project Properties
Compiling a Project
To Compile a Project
Configuring and Running the Debugger
Configuring and Running the Debugger - CICS
To Configure a Project for Debugging
To Configure a Region for Debugging
To Enable Dynamic Debugging
To Start and Run the Debug Session
To Use a TN3270 Emulator To Run CICS Transaction From Visual Studio.
Debugging Tutorial
Configure the ACCT Transaction Program
Build the Debug Transaction
Configure the Region for Debugging
Start Debugging
Debugging A SQL Stored Procedure .
Configuring and Running the Debugger - Batch
To Configure a Project for Debugging
To Configure a Region for Debugging
To Enable Dynamic Debugging
To Start and Run the Debug Session
To Submit a JCL Job From Visual Studio
Visual Studio Managed Server Explorer
REST Web Services and EXCI
About CICS REST Web Services
About CICS External Call Interface
The REST Interface
REST Client APIs
RestClient Class
Javascript AJAX APIs
Other REST Client APIs
Server Program Considerations for REST Services
The EXCI Interface
EXCI Client APIs
EXEC CICS LINK for EXCI
DFHXCIS API
ExciClient Class
The EXCI User Exit
Server Program Considerations for EXCI
Printing in CICS
Printer Mode
SCS Control Codes in ASCII Applications
SCS Control Code Translation
Windows Azure Support
Introduction
What is Windows Azure?
Overview
Configuring the Enterprise Server for .NET System
Prerequisites
Creating A New Deployment Project
Editing A Deployment Project
Publishing And Control of a Deployment
Deploying Enterprise Server for .NET Applications into Azure
Defining an Azure Region
Defining an Azure CICS Region
Defining an Azure Batch Region
Starting a Region in Azure
Starting a CICS Region in Azure
Starting a Batch Region in Azure
Connecting Terminals to the Azure Region
Deploying the ACCT Sample Application into Azure
Using Azure File Storage with Enterprise Server for .NET
Deploying Artifacts to a File Storage Drive
Using a File Storage Drive in a Running Region
SQL Azure
What is SQL Azure?
Using SQL Azure with Enterprise Server for .NET
SQL Azure Firewall
SQL Azure Connection Strings
System Center Monitoring Pack for Windows Azure Applications
Setting the Agent Proxy
Installing the Management Pack
Adding Other Performance Counters
Users in Windows Azure
Sample - BankDemo in Azure
References
Enterprise Server for .NET Glossary
Glossary terms A to M
ACB
Access method services (AMS)
BMS Map
CICS Region
CICS resource
Cross-Region Database
DCT - Destination Control Table
Dispatcher
Endpoint
Event Monitor
FCT - File Control Table
IMS - Information Management System
ISC - Inter-system communication
IVP - Installation Verification Procedure
JES - Job Entry Subsystem
Listener
LU6.2
MMC - Microsoft Management Console
MSS - Mainframe Subsystem Support
Glossary terms N to Z
NLB - Network Load Balancing
Native Enterprise Server
OLTP - Online Transaction Processing
Package
PCT - Program Control Table
Region
Region database
SEE - Server Enterprise Edition
Self-hosted
SEP - Service Execution Processes
SEP Pool
Service Endpoint
SNA
SOA - Service-Oriented Architecture
Startup List
SIT - System Initialization Table
WAS/WPAS - Windows Process Activation Service
WCF - Windows Communication Foundation
Web Service
WPF - Windows Presentation Foundation
Copyright and Legal Information
Copyright and Trademarks