Micro Focus COBOL Server 2.0 for Windows for UNIX

Micro Focus COBOL Server 3.0 for UNIX

Welcome

The Micro Focus Community

Existing Customers: Upgrading from an Earlier Release

New Features

New Features in COBOL Server 3.0

Features Added in COBOL Server 2.3 Update 2

Features Added in

Features Added in 2.3

Features Added in 2.2 Update 2

Features Added in 2.2 Update 1

Features Added in 2.2

Features Added in 2.1 Update 1

Features Added in 2.1

Features Added in 2.0

Significant Changes in Behavior or Usage

New Customers: Where do I start?

Want to deploy an application

Product Information

Installation

Before Installing

Downloading the Product

System Requirements

Hardware Requirements

Operating Systems Supported

Software Requirements

Additional Software Requirements

UNIX and Linux Installer Issues

Basic Installation

Installing

Advanced Installation Tasks

Installing as an Upgrade

Installation Options

RPM Installer

Using the RPM Installer

Other RPM Installer Options

Uninstalling Using the RPM Installer

After Installing

Setting the Environment

Repairing

Uninstalling

Managing Licenses

Overview

To start Micro Focus License Administration

Installing licenses

If you have a license file

If you have an authorization code

Authorizing your product when you have an Internet connection

Authorizing your product when you don't have an Internet connection

Configuring your machine to use a central license server

Installing licenses silently

Viewing installed licenses

Uninstalling licenses

Removing licenses

Revoking licenses when you have an Internet connection

Revoking licenses when you do not have an Internet connection

Installing License Manager

Installing a local license server

Installing a standalone network license server

Installing on UNIX and Linux

Trial licenses

Commuter licenses

To obtain a commuter license

To return a commuter license

Usage log

Licensing Error Messages

Initialization error - Initializing: Cannot communicate with licensing daemon

Error - Initalizing: Cannot find initialization file

Error - Unable to manage licenses in license manager that is not running on localhost

Error [5]: Cannot talk to the license server on host "xxx.x.x.x". Server not running

Error authorizing... Remote request error - The authorization code is invalid

Error [26] - Request Denied due to clock tamper detection

Error[18]: No license code is available for feature (component)

Unable to authorize (cause)

Updates and Product Support

Micro Focus End User License Agreement

Known Errors and Restrictions

Application-Managed Services

Spool File Format Change

Contacting Micro Focus

Further Information and Product Support

Deploying COBOL Applications

Overview of Deploying Your Applications

Deploying the Micro Focus Run-Time System

COBOL Server Install Options

Deploying JVM Applications

Multi-Platform Deployment of JVM COBOL Applications

Byte ordering

Shift-JIS character encoding

Platform-specific APIs, ECMs, and preprocessors

Literals in the source code

SQL Applications

File Handling

Enterprise Server

Enterprise Server configuration and administration

Overview and Architecture

Enterprise Server Overview

Enterprise Server Architecture

Enterprise Server Instance Architecture

The Micro Focus Directory Server

Directory Server Information

Repository Statistics

Service Execution Process (SEP)

Request Handlers

Communications Processes

Listeners

Implementation Packages

XA Resources

Enterprise Server Processes

Configuration and Administration User Interface

About the Enterprise Server Administration User Interface

User Interface Tables

Navigation

Accessing the Enterprise Server Administration UI

Displaying Server Information

Refreshing a Page

Securing the Repository Files

Planning your Configuration

Introduction

Security Options

About Securing an Enterprise Server Installation

Setting up the Environment

Process User ID

System-wide Environment Variables

Firewall configuration

About Communications Processes

Deployment Services and Listeners

Deployment Services

Deployment Listeners

Enterprise Server Instance Configuration Issues

Shared Memory Area

Shared Memory Cushion

Number of Service Execution Processes

Performance Considerations

I/O-bound Services

CPU-bound Services

Short-running Client Requests

Long-running Client Requests

Configuring the Server Instance Environment

Configuring Environment Variables

How Enterprise Server uses Environment Variables

Setting Environment Variables

Setting Environment Variables for Micro Focus Directory Server

To Set Environment Variables from the User Interface

To Set Environment Variables from the Command Line

To Specify Dataset Allocation Using Environment Variables

Environment Variables by Groups

CCI Environment Variables

Enterprise Server Communications Environment Variables

File Handling and Dataset Environment Variables

Input, output and display environment variables

Security and Auditing Environment Variables

SORT Engine Environment Variables

Tracing and Debugging Environment Variables

Reserved Environment Variables

Environment variables in alphabetical order

Reserved Environment Variables

About Communications Processes

Configuring Fileshare

Using XA-compliant Resources (XARs)

Planning and Designing XARs

RM Switch Module Registration

Working with Multiple XARs

SQL xa_open string Configuration Options

Defining XA Resource Entry

To define an XA resource (XAR) for an enterprise server region

EDB PostgreSQL xa_open string

Generic one-phase commit for ODBC xa_open string

IBM DB2 xa_open string

Oracle xa_open string

To Delete an XA Resource

To Edit an XA Resource

To Enable or Disable an XA Resource

RM Switch Modules

Building RM Switch Modules

EDB PostgreSQL RM Switch Module

Generic One-phase Commit for ODBC RM Switch Module

IBM DB2 RM Switch Module

Oracle RM Switch Module

XA Logging and Recovery of in-doubt Transactions

XA Troubleshooting

XA Return Codes

XA Switch Module Diagnostics

Handling XA Connection Errors

Configuring and Administering Enterprise Server Instances

Creating and Configuring Enterprise Server Instances

To Add an Enterprise Server Instance

To Change the Number of ES licenses

To Copy an Enterprise Server Instance

To Delete an Enterprise Server Instance

To Delete a CCI Server

To Export Server Information

Connecting to a Server Instance

To start an enterprise server instance

To stop a server Instance

To Edit an Enterprise Server Instance

To Log On to Enterprise Server Administration

To Log Off from Enterprise Server Administration

Using Start and Stop Scripts

Administering Enterprise Server Instances using ESMAC

To Start ESMAC for an enterprise server instance

To Shut Down a Server from ESMAC

Viewing Enterprise Server Instance Details

The ESMAC User Interface

Defining Enterprise Server Instance Administrators

Managing an Enterprise Server Instance's SEPs

About Service Execution Processes

To Change the Number of SEPs

Interacting with Services

To Reply to an ACCEPT FROM CONSOLE Statement

Stopping and Restarting an Installation

Using the Command-line Interface

Configuring Client-Server Communications

About Communications Processes

Considerations When Configuring Communications Processes

Displaying Communications Process and Listener Information

Securing Communications

Configuring Communications Processes

Editing Communications Settings

[CCI] section

[ezasoket] Section

[HTTP] Section

maximum header value length

[listeners] Section

[MFCC] Section

[tasks] Section

wait queue sweep interval

[threading] Section

limit

To Edit a Communications Process

To Copy a Communications Process

To Delete a Communications Process

To Start a Communications Process

To Stop a Communications Process

To View Communications Processes and Listeners for an Enterprise Server Instance

To View Statistics for a Communications Process

Configuring Listener Conversation Types

Fileshare conversation type

SOAP /J2EE (legacy) conversation type

Web conversation type

logging

default

element in [virtual paths] Section

element in [allow] Section

Web Services and J2EE conversation type

Configuring Listeners

To Add a Service Listener to an Enterprise Server Instance

To Edit a Listener

To Associate a Listener with a Service

To delete a listener

To Disassociate a Listener from a Service

To Start a Listener

To Stop a Listener

Configuring Enterprise Server for IBM WebSphere MQ

Non-Mainframe Programs and WebSphere MQ

Resource Classes for WebSphere MQ

WebSphere MQ-Specific Environment Variables

Monitoring Enterprise Server

Server Instance Statuses

Monitoring the Directory Server

Starting and Stopping the Directory Server

To Start the Directory Server from the Command Line

To Stop the Directory Server

To Delete the Repository

To Import a Repository

To Restore the Repository

To Export the Repository

Displaying Server Information

Accessing Remote MF Directory Servers

To View and Use Remote Directory Server Instances

Monitoring Facilities

The Directories Page

Viewing a MF Directory Server's Statistics

To View Directory Server Statistics

Viewing a MF Directory Server's Sessions List

To View the Sessions List

Viewing the Journal

To View the Journal

To export the journal as a text file

To Delete Journal Entries

Collecting and Viewing Data on Transactions

Configuring and Starting Transaction Data Collection

Viewing HSF Information in ESMAC

Viewing HSF Information as a .csv File

Analyzing Aggregated HSF Data in .csv Files

User Exits for Request Handlers

User Exit Points Provided

Structure Definitions and Type Definitions

Linkage Section Field Names

Deploying a User Exit Program

Web Service exits exit-soap-request exit-soap-response and exit-http-headers

Implementing exit-soap-request and exit-soap-response

Implementing exit-http-headers user exits

Troubleshooting

Determining the Failure Type

Incorrect Output

Unexpected System Termination

Loops

System Hangs

One Type Of Request is Failing

All client requests are failing

Invalid Credentials Error

Collecting Information

Directory Server Journal

To View the Journal

Enterprise Server Log Files

Communications Process Log Files

Enterprise Server Log Files

To View the Enterprise Server Log Files

Enterprise Server System Directory

Dumps and Traces

Producing a core dump for run-time errors

Data Capture

Checking the Communications Process

Using a Diagnostics Server

Configuring a Diagnostics Server

Moving the Diagnostics Data

Viewing the Diagnostic Server Console Log

Viewing a System Trace: Diagnostics Example

Viewing a Dump

What You Can Do with Dumps and Traces

To Change the Trace Dataset

To Configure Dumps

To initiate a system dump

To specify what information is traced

To View a Dump

To View a Local Trace for a Client Process

To View a Local Trace for a SEP

To View a System Trace

To Configure Run-time Core Dumps

Problems Caused by Process Limits

Diagnosing Resource Limit Issues

Examining and Changing Resource Limits

Enterprise Server Administration Console Help Pages

Enterprise Server Administration Side Bar Menu

Export

Import Server Information (Page 1 of 4)

Configure Repository Options

Enterprise Server Administration Home Page

Add Server instance

Delete Server instance

Start Server confirmation

Stop Server Confirmation

Edit Server Instance Properties

Server Instance Properties: General

Server Instance Properties: XA Resources

Server Instance Properties: Add XA Resource

Server Instance Properties: Scripts

Server Instance Properties: Permissions

Server Instance Control

Server Instance Control Settings

Server Instance Diagnostics

Server Instance Diagnostics: Trace

Server Instance Diagnostics: Dump

Server Instance Diagnostics: ES Console

Server Instance Diagnostics: CS Console

Server Instance Properties: Security

Enterprise Server Monitor and Control (ESMAC)

Enterprise Server Monitor and Control - S2 Sidebar Help

Server

Monitor (1, 15)

HSF

HSF (summary)

HSF (transaction name)

Diagnostics

Resources

Services

Lists of Services

Services

Service Packages

Request Handlers

Details of Individual Services

iFileshare

Active

Lists of Active Resources

Details of an Active Resource

XAT

PIPELINE Entry (pipeline_name)

WEBSERVICE Entry (webservice_name)

RNL (RNL_sequence_number)

Users

Listeners

Copy Communications Process

Edit Communications Process

Delete Communications Process

Services

Edit Service

Delete Service

Delete Service Operation

Handlers

Packages

Security Configuration Screen Help

MF Directory Server Users, Add or Edit

Add Resource Class

Add Resource Entity

Add Security Manager

Add to Default ES Security Manager List

Add to ES Security Manager List

Add to MF Directory Server Security Manager List

Configure General Options

Confirm Password

Configure Journal Options

Configure Monitor Options

Configure Repository Options

Default ES Security Configuration

Directory Server Users

Edit Resource Class

Edit resource entity

Edit Security Manager

Left Pane Menu Items

MF Directory Server Security

Remove Security Manager Reference Confirmation

Security Managers Pool

SSL Options

Shut Down the MF Directory Server

Update User

User Group Members

User Groups

User Import: another user registry

User Import: previous version

Deploying and Configuring Modernized Applications

About Modernized Applications

Service Names and Operations

The Services Table

Configuring Services

Types of Services Supported

Managing Resources

Application-managed Services

Container-managed Services

Mixing Container-managed and Application-managed Services

Adding and Deleting Services

Creating Services Manually

To Add a Service to an Enterprise Server Instance

To Associate a Package with a Service

Configuring and Monitoring Services

Services and Permissions

To Monitor Services

To Record Service Input and Output

To Add a Service for Integration with the Micro Focus Development Tools

To Change the Status of a Service

To Delete a Simple Service or an Operation

To Delete a Service with Operations

To Edit a Service

To Switch Logging On for a Service

To View Services for an Enterprise Server Instance

Configuring Implementation Packages

The Packages Table

Configuring Packages

To Add a Package to an Enterprise Server Instance

To Delete a Package

To Edit a Package

To Disassociate a Package from a Service

To View Packages for an Enterprise Server Instance

To Delete Old Deployed Package Files

Configuring Request Handlers

The Request Handlers Table

Configuring Handlers

To Add a Request Handler to an Enterprise Server Instance

To Edit a Request Handler

To Associate a Request Handler with a Service

To Disassociate a Request Handler from a Service

To Delete a Request Handler

To View Request Handlers for an Enterprise Server Instance

Deploying EJBs and Resource Adapters

Enterprise Server Acting as a Resource Manager

Deploying EJBs Overview

Deploying EJBs

To Add Micro Focus Support for EJBs

To Create an .ear File for your EJB

To Deploy to WebLogic

To Deploy to WebSphere

To Deploy to JBoss

Resource Adapters Supplied by Micro Focus

To Add Support for Micro Focus Resource Adapters

To Deploy a Micro Focus Resource Adapter to a Java Application Server

Deployment Descriptors that Are Required

To Create Deployment Descriptors Manually

CustomRecord and the RuntimeProperties Support

Third Party Application Server Deployment

Troubleshooting

Enterprise Server Task Index

Accessing the Enterprise Server Administration UI

Accessing the ESMAC User Interface

Administer a Server Using ESMAC

To Change the Trace Dataset

To Configure Dumps

To Create an ESMAC User

To initiate a system dump

To stop or kill a SEP

To Monitor Services

To Record Service Input and Output

To specify what information is traced

To Start ESMAC for an enterprise server instance

To Transfer the In-memory Trace Data to the Auxiliary Dataset at Rollover

To View a Dump

To View a Local Trace for a Client Process

To View a Local Trace for a SEP

To View a System Trace

Configure the Directory Server

To Configure the MF Directory Server

To Run casperm

Deploy to Java EE Application Servers

To Deploy to WebSphere

To Deploy to WebLogic

To Deploy to JBoss

To Create Deployment Descriptors Manually

To Create an .ear File for your EJB

To Add Micro Focus Support for EJBs

To Add Support for Micro Focus Resource Adapters

To Deploy a Micro Focus Resource Adapter to a Java Application Server

Log On and Off

To Log On to Enterprise Server Administration

To Log Off from Enterprise Server Administration

Monitor Directory Server

To View the Sessions List

To View the Journal

To View and Use Remote Directory Server Instances

To View Directory Server Statistics

To export the journal as a text file

To Delete Journal Entries

To Configure Run-time Core Dumps

Start and Stop the Directory Server

To Start the Directory Server from the Command Line

To Stop the Directory Server

Work with Communication Processes and Service Listeners

To Add a Service Listener to an Enterprise Server Instance

To Associate a Listener with a Service

To set a fixed port in a listener endpoint address

To Start a Communications Process

To Stop a Communications Process

To Copy a Communications Process

To Edit a Communications Process

To Delete a Communications Process

To Start a Listener

To Stop a Listener

To Edit a Listener

To Disassociate a Listener from a Service

To delete a listener

To View Communications Processes and Listeners for an Enterprise Server Instance

To View Statistics for a Communications Process

Work with Packages

To Add a Package to an Enterprise Server Instance

To Edit a Package

To Associate a Package with a Service

To Disassociate a Package from a Service

To View Packages for an Enterprise Server Instance

To Delete a Package

To Delete Old Deployed Package Files

Work with Request Handlers

To Add a Request Handler to an Enterprise Server Instance

To Edit a Request Handler

To Associate a Request Handler with a Service

To Disassociate a Request Handler from a Service

To View Request Handlers for an Enterprise Server Instance

To Delete a Request Handler

Work with Servers

To Add an Enterprise Server Instance

To define an XA resource (XAR) for an enterprise server region

To Change the Number of ES licenses

To Change the Number of SEPs

To Copy an Enterprise Server Instance

To Create and View a Diagnostic Dump for an Enterprise Server Instance

To Delete an Enterprise Server Instance

To Delete an XA Resource

To Delete a CCI Server

To Edit an Enterprise Server Instance

To Edit an XA Resource

To Enable or Disable an XA Resource

To start an enterprise server instance

To stop a server Instance

To View the Communications Console Log for an Enterprise Server Instance

To View the Enterprise Server Log Files

To View the Control Page for an Enterprise Server Instance

Work with Services

To View Services for an Enterprise Server Instance

To Add a Service to an Enterprise Server Instance

To Edit a Service

To Change the Status of a Service

To Switch Logging On for a Service

To Add a Service for Integration with the Micro Focus Development Tools

To Delete a Service with Operations

To Delete a Simple Service or an Operation

Work with the Directory Server Repository

To Import a Repository

To Export the Repository

To Restore the Repository

To Delete the Repository

Enterprise Server Reference

Administration and Configuration Commands

Error Messages

Directory Server Error Messages

Messages 0 to 20

MDS0000I OK

MDS0001I Logged on OK

MDS0002E Logon failed

MDS0003I Logged off OK

MDS0004I Repository cleared OK

MDS0005I Network search complete

MDS0006I All objects copied successfully

MDS0007E Duplicate server exists

MDS0008E Duplicate server name already exists

MDS0009E Invalid server specified.

MDS0010E Invalid endpoint specified

MDS0012E Duplicate service name exists

MDS0013E Duplicate listener exists

MDS0014E Duplicate user already exists

MDS0015E Schema Administrators cannot reduce their own permission level

MDS0016E Invalid endpoint specified

MDS0017E Object must have a name

MDS0018I New server session

MDS0019I Client session has timed out: please log on again

MDS0020E Minimum client timeout is 60 seconds

Messages 21 to 40

MDS0021E Minimum page size is 5 entries

MDS0022E Minimum journal size is 32 KB

MDS0023E Insufficient memory for this operation

MDS0024E Password mismatch

MDS0025E Confirmation password mismatch

MDS0026E Old password required

MDS0027E New password required

MDS0028E Invalid characters in password

MDS0029E Selected object does not exist

MDS0030W Some or all objects not copied: see journal for details

MDS0031E Maximum port value is 65535

MDS0032E Object could not be added

MDS0035E Minimum object limit is 64

MDS0036E Maximum object limit is 9999

MDS0037E Operation would breach the configured object limit

MDS0038E Minimum object limit is smaller than the current number of objects

Messages 41 to 60

MDS0043I Journal exported as text into file journal.txt OK

MDS0044E Server name missing

MDS0045E Duplicate request handler or package name exists

MDS0047E Package must have an IDT path

MDS0048E Server refused state change request

MDS0049E Server refused state change request reason code:

MDS0050E Server instance count must be at least 1

MDS0051I Value change request accepted

MDS0052I Diagnostic dump request accepted

MDS0053E Diagnostic dump request failed

MDS0054I Configuration saved

MDS0055I Configuration defaults restored

MDS0056E Insufficient permission level for request

MDS0057E Resource manager ID field must have a value

MDS0058E Resource manager name field must have a value

MDS0059E Resource manager module field must have a value

MDS0060E MFRHBINP cannot be deleted

Messages 61 to 80

MDS0061I Stopping and deleting all servers...

MDS0062E Entry range invalid

MDS0063E Cannot delete a listener which is associated with a service

MDS0064E Cannot delete a package which is associated with a service

MDS0065E Requested new listener status not possible when server is stopped

MDS0066E There are no servers to delete

MDS0067E less than greater than ampersand characters are not allowed in object names

MDS0068I Schema updated

MDS0069I All servers deleted

MDS0070I Data imported

MDS0071E Data import failed

MDS0072I Server data saved

MDS0073E Server data save failed

MDS0074E User name required

MDS0075E Too many multi-byte characters in name

MDS0076E Too many multi-byte characters in path

MDS0077E Too many multi-byte characters in type

MDS0078E Too many multi-byte characters in ID

MDS0079E Too many multi-byte characters in module

MDS0080E Too many multi-byte characters in string

Messages 81 to end

MDS0081W A duplicate port value has been used: this may cause server startup errors

MDS0082E Requested license value invalid, minimum value is 0

MDS0083W Cannot set auto-refresh period if web browser timeout is set

MDS0084E Cannot restore from current repository path

MDS0085W Value changed but not saved

MDS0086I At least one Communications Process must auto-start

MDS0087E MFRHBINP cannot be renamed

MDS0091E ISC listener port must have a valid value

MDS0095E Duplicate group name exists

MDS0096I Server configuration updated

MDS0097E Duplicate initiator name exists

MDS0098W Cannot over-write existing repository data

MDS0099I Server already in requested state

MDS0100E Duplicate printer name exists

MDS0101E The maximum number of Communications Processes per server is 32

MDS0102W Passwords must contain alphanumeric characters only

MDS0103E Security Manager already referenced in list

MDS0104E There must be at least one Security Manager in list

MDS0105E Both certificate and keyfile required

MDS0106E Duplicate Security Manager name exists

MDS0107E Security Managers cannot use a reserved module name

MDS0108E Users must be a member of #AllUsrs group

MDS0109E Cannot copy deployed services or packages if server working mode is changed

MDS0110W The specified configuration change may not take effect until the server is restarted

MDS0111W Update request failure message CASRD1006E detected in the ES console log

MDS0112I Update success message CASRD1001I detected for this object in the ES console log

MDS0113W Users who are members of the #System user group cannot log on interactively

MDS1003E LDAP server connection error

Enterprise Server Error Messages

CASCD Error Messages

CASCD0001 - CASCD0015

CASCD0016 - CASCD0031

CASCD0016W

CASCD0017I cascd: cascd-message

CASCD0050 - CASCD0099

CASCD0100 - CASCD0117

CASCD0120 - CASCD0139

CASCD0141 - CASCD0159

CASCD0160 - CASCD0175

CASCD1001 - CASCD1056

CASCD1052I JES Initiator for Service execution process service execution process-name has terminated normally

CASCD1053S JES Initiator for Service execution process service execution process-name exited with value exit-value

CASCD1054I JES Printer for Service execution process service execution process-name has terminated normally

CASCD1055S JES Printer for Service execution process service execution process-name exited with value exit-value

CASCD1057 - CASCD1069

CASCD1070 - CASCD1200

CASCD1087I Cobdebugremote process created for Server server-name, process-id = pid

CASCD1088S Cobdebugremote process for Server server-name abended by signal signal-value

CASCD1089I Cobdebugremote process for Server server-name has terminated normally

CASCD1090S Cobdebugremote process for Server server-name exited with value exit-value

CASCD1095I ES TRC Service Process created for Server server-name, process-id = pid

CASCD1096I ES TRC Service Process for Region server-name has terminated normally

CASCD1097S ES TRC Service Process for Region server-name exited with value exit-value

CASCD1098S ES TRC Service Process for Region server-name abended by signal signal-value

CASCD1105I ES MQB Service Process created for Server server-name, process-id = pid

CASCD1106I ES MQB Service Process for Region server-name has terminated normally

CASCD1107S ES MQB Service Process for Region server-name exited with value exit-value

CASCD1108S ES MQB Service Process for Region server-name abended by signal signal-value

CASCD1109I ES SNA Communications Process created for Server server-name, process-id = pid

CASCD1110I ES SNA Communications Process for Region server-name has terminated normally

CASCD1111S ES SNA Communications Process for Region server-name exited with value exit-value

CASCD1112S ES SNA Communications Process for Region server-name abended by signal signal-value

CASCD1200I

CASCD4002 - CASCD4007

CASCF Error Messages

CASCF0001 - CASCF0015

CASCF0016 - CASCF0030

CASCF0031 - CASCF0045

CASCF0046 - CASCF0064

CASCF0064W config-module: Region region-name has already been stopped

CASCL Error Messages

CASCL0000 - CASCL0012

CASCL0000S Auto-install error, NETNAME netname busy

CASCL0001S Auto-install error, ENQ on NETNAME netname error

CASCL0002S Auto-install error, NETNAME netname already in use

CASCL0003S Auto-install error, TERMTYPE termtype locate error

CASCL0004S Auto-install rejected by user exit

CASCL0005S Auto-install error, TCT rechain error = tmp-return

CASCL0006S Auto-install error, netname delete error = tmp-return

CASCL0007S Auto-install, error calling user exit

CASCL0008S Auto-install error, MODEL model locate error

CASCL0009S Auto-install error, NETNAME netname out of service

CASCL0010S Auto-install error, NETNAME netname definition not client type

CASCL0011S Auto-install error, NETNAME netname TCTUA allocation failure

CASCL0012S Auto-install error: Error calling exit "exit-name"

CASCL0020 - CASCL0027

CASCL0020I Printer term-id initialized successfully

CASCL0021I Printer term-id disconnected successfully

CASCL0022W Printer auto-install failure, RC: terminal-id

CASCL0023W Printer registration failure, return code = return-code

CASCL0024S Printer memory allocation failure, return code = malloc-return-code

CASCL0025I Terminal disconnected successfully

CASCL0026S Auto-install error, hash table processing, NETNAME = netname

CASCL0027E Auto-install error, LU1 NETNAME(netname) MODEL(), device does not support SCS

CASDU Error Messages

CASDU0001W Error return-code deleting dump/trace file dump-filename

CASDU0002W Error return-code deleting dump/trace file dump-filename

CASDU0003W Error return-code deleting diagnostic file diagnostic-filename

CASDU0004I Switched diagnostic output to diagnostic-filename

CASDU0005I AUX Trace stopped and flushed to diagnostic-filename

CASFC Error Messages

CASFC0001I Fileshare services initialized

CASFC0002I Fileshare terminated

CASFC0003S Fileshare initialization terminated abnormally

CASFC0004S Critical Fileshare storage error

CASFC0005I Fileshare services message fileshare-message

CASFC0006I Fileshare current directory set to current-directory

CASFC0007I Fileshare services recovery initiated

CASFC0008I Error accessing file () group () - status=(,). File marked as closed and disabled.

CASFC0009I User (user-id) requested (request type) on file (filename) group (file group name) from Tran (trans-id) Program (terminal-id) Terminal ().

CASFC0010I Transaction (Transaction id) task number (Task number) user (User name) waiting for shared use of dataset (Dataset name).

CASFC0011I Transaction (Transaction id) task number (Task number) user (User name) required datasets have been acquired. Execution resumed.

CASFD Error Messages

CASFD0001 - CASFD0014

CASFF Error Messages

CASFF0001I Searching 'Search-path' for the location of 'file-name'

CASFF0002I Searching for the location of 'file-name'

CASFF0003I 'file-name' was found file-name-path

CASFF0004I Searched 'Search-path' path and failed to find 'file-name'

CASFF0005I Failed to find 'file-name'

CASFF0006S Invalid parameter on command line : command-line

CASFS Error Messages

CASFS5001I Fileshare Control Process initialization started

CASFS5002S Fileshare Control Process is not running in multi-threaded mode

CASFS5003I Fileshare Control Process initialization complete; Role is node-type

CASFS5004S Fileshare Control Process registration failed, reason = reason-code

CASFS5005S Fileshare Control Process storage allocation error

CASFS5006I fs-control-message

CASFS5007I Fileshare Control Process termination started

CASFS5008I Fileshare Control Process termination complete

CASFS5011I Fileshare Control Process restart in progress

CASFS5012I Fileshare Control Process current directory set to current-directory

CASFS5013S Fileshare Control Process user user-id signon error-text

CASFS5039I Fileshare process generated a dump to dump dataset dump-dataset

CASFS5054I Fileshare control process (PID:process-id) recovery initiated

CASFS5059I Fileshare process generated a dump to dump dataset dump-dataset

CASFS5060S Fileshare Control Process engine failed to initialize, reason = reason-code

CASFS5061I Fileshare control HA VSAM Primary node preparation complete

CASFS5062I Fileshare control HA VSAM Hot Standby node preparation complete

CASFS5063E Fileshare control HA VSAM assignment as role failed. Return code = return-code

CASFS5064S Fileshare control HA VSAM replication has failed. RC=return-code

CASFS5065W Fileshare Control Process initialization failed. HA VSAM is disabled.

CASFS5066I Fileshare internal control process initialized

CASMG Error Message

CASMG9999E message-number, message-insert , message-insert ...

CASMG0001I application display text

CASPI Error Messages

CASPI0100 - CASPI0600

CASPI0110E Date Time Applid An attempt to start transaction CPIH by something other than an attach request from web domain has been made. This is not allowed.

CASPI0111E Date Time Applid Tranid Call to WebSphere MQ function MQ function returned with reason code MQ reason code. Transaction abended.

CASPI0112E Date Time Applid Tranid Unable to locate URIMAP to match HOST Hostname and PATH Pathname. Unable to process inbound MQ message.

CASPI0113E Date Time Applid Tranid URIMAP urimap_name has been located for HOST hostname and PATH pathname, but does not have USAGE(PIPELINE). Unable to process inbound MQ message.

CASPI0114E Date Time Applid Tranid The pipeline MQ transport mechanism failed because a call to WebSphere MQ function MQ function returned with reason code MQ reason_code.

CASPI0115I Date Time Applid Tranid The service provider pipeline has returned a response message to the MQ transport, but the inbound request did not expect a response. The response message is ignored.

CASPI0300E Date Time Applid CICS could not invoke WEBSERVICE WebService because it was unable to find container container_name.

CASPI0400E Date Time Applid Tranid The CICS pipeline HTTP transport mechanism failed to send a request because Reason Error. Problem occurred for URI URI.

CASPI0403E Date Time Applid Tranid The CICS pipeline HTTP transport mechanism failed to receive a response because Reason Error. Problem occurred for URI URI.

CASPI0404E Date Time Applid Tranid A failure occurred in the CICS pipeline HTTP transport mechanism for PIPELINE Pipeline WEBSERVICE Web Service Name.

CASPI0453E Date Time Applid Tranid The CICS transport manager encountered an error while trying to use URIMAP urimap_name.

CASPI0454E Date Time Applid Tranid The CICS transport manager encountered an error while trying to use provider pipeline pipeline_name.

CASPI0500E Date Time Applid Tranid The CICS Pipeline Manager DFHPIPM encountered an error while trying to link to program Program. reason. PIPELINE: Pipeline.

CASPI0501E Date Time Applid Tranid The CICS Pipeline Manager cannot proceed as the pipeline is unusable. reason. PIPELINE: Pipeline.

CASPI0504E Date Time Applid Tranid The CICS Pipeline Manager has failed to communicate with a service provider due to an error in the underlying transport. TRANSPORT: Transport, PIPELINE: Pipeline.

CASPI0506E Date Time Applid Tranid The CICS Pipeline Manager has failed to communicate with a remote server due to an invalid URI scheme being specified. URI: Uri, PIPELINE: Pipeline.

CASPI0601 - CASPI0899

CASPI0703I Date Time Applid Userid PIPELINE Pipeline is about to scan the WSDIR directory.

CASPI0704I Date Time Applid Userid PIPELINE Pipeline Implicit scan has completed. Number of wsbind files found in the WSDIR directory:...

CASPI0710I Date Time Applid userid PIPELINE (pipeline) was successfully discarded.

CASPI0900 - CASPI0999

CASPI0901I Date Time Applid Userid New WEBSERVICE Webservice is being created during a scan against PIPELINE Pipeline.

CASPI0902I Date Time Applid Userid New WEBSERVICE Webservice is being updated during a scan against PIPELINE Pipeline.

CASPI0903I Date Time Applid Userid New URIMAP Pipeline is being created during a scan against PIPELINE Webservice for WEBSERVICE .

CASPI0904I Date Time Applid Userid URIMAP Urimap could not be created for WEBSERVICE Webservice in PIPELINE Pipeline. The URI that could not be allocated is: 'Uri'.

CASPI0910I Date Time Applid Userid WEBSERVICE Webservice within PIPELINE Pipeline has been created.

CASPI0912I Date Time Applid userid WEBSERVICE (webservice) was successfully discarded.

CASPI0913I Date Time Applid userid WEBSERVICE (webservice) is being discarded.

CASPI0914E Date Time Applid Userid WEBSERVICE Webservice is UNUSABLE because: Reason.

CASPI0915I Date Time Applid Userid WEBSERVICE Webservice is now INSERVICE and is ready for use.

CASPI0916E Date Time Applid Userid WEBSERVICE Webservice within PIPELINE Pipeline was not created because it clashes with another WEBSERVICE of the same name in PIPELINE Pipeline.

CASPI0950W Date Time Applid userid Attempt to discard URIMAP (urimap) failed. RC:

CASPI0951W Date Time Applid userid Attempt to discard WEBSERVICE (urimap) failed. RC:

CASPI0952W Date Time Applid userid Attempt to discard PIPELINE (urimap) failed. RC:

CASPI0997E Date Time Applid Tranid Pipeline The CICS pipeline manager has encountered an error: reason.

CASPI9640I Date Time Applid WEBSERVICE WebService should be installed into a PIPELINE soap version that uses SOAP version .

CASPI1000 - CASPI9999

CASPI1570I Date Time Applid userid URIMAP (urimap) was successfully discarded.

CASPI1010E Date Time Applid TaskId XML or JSON generation failed. A conversion error (Cause of error) occurred when converting field Error Qualifier for WEBSERVICE or BUNDLE Webservice or Bundle name.

CASPI1009E Date Time Applid TaskId XML or JSON to data transformation failed. A conversion error (Cause of error) occurred when converting field Error Qualifier for WEBSERVICE or BUNDLE Webservice or Bundle name.

CASPI1008E Date Time Applid TaskId XML generation failed because of incorrect input (Cause of error Error Qualifier) for WEBSERVICE Webservice.

CASPI1007E Date Time Applid TaskId XML or JSON to data transformation failed because of incorrect input (Cause of error Error Qualifier) for WEBSERVICE or BUNDLE Webservice or Bundle name.

CASRM Error Messages

CASRM0001I ODBC resource manager initialized

CASRM0002S ODBC resource manager initialization terminated abnormally, RC=return-code

CASRM0003I ODBC resource manager terminated

CASRM0004W ODBC resource manager warning warning-message

CASRM0005S ODBC resource manager error error-message

CASSP Error Messages

CASSP0001 - CASSP0017

CASSP0001W Failed to inform region manager of process death, reason = failure-code

CASSP0002I Region informed of process termination, pinfo = process-type, process-id

CASSP0003E Process process-id termination recovery initiation failed: errno = error-number

CASSP0004E Process process-id termination recovery initiation failed: RC = return-code

CASSP0010S Syncpoint failure - resource state unpredictable

CASSP0011S Syncpoint COMMIT failure - resource state unpredictable

CASSP0013S Syncpoint ROLLBACK failure - resource state unpredictable

CASSP0014S Process termination due to RTS error RTS-error-message

CASSP0015S Syncpoint PREPARE failure - resource state unpredictable

CASSP0016S Syncpoint OTHER failure - resource state unpredictable

CASSP0017S Process thread hung with shared memory locked (this simulates an ES failure)

CASST Error Messages

CASST0000 - CASST0010

CASST0011 - CASST0023

CASST0021W Server manager termination delayed waiting for ES communications to terminate

CASST0022W Server manager termination delayed waiting for ES service processes to terminate

CASST0023W Server manager termination delayed waiting for ES core processes to terminate

CASST4000 - CASST4111

CASST5000 - CASST6002

CASXO Error Messages

CASXO0001 - CASXO0015

CASXO0016 - CASXO0034

CASXO0027I XA recovery committed in-doubt transaction XID transaction number branch XID transaction branch number on RM Resource manager

CASXO0028I XA recovery rolled back in-doubt transaction XID transaction number branch XID transaction branch number on RM Resource manager

CASXO0029I XA log reported in-doubt transaction XID transaction number branch XID transaction branch number

CASXO0030S XA Automated recovery disabled for XA Switch Resource manager ID. The xa_recovery call returned rc XA return code.

CASXO0031W ES has lost connection to the RM XA RM Name, attempting to reconnect

CASXO0032I ES has regained connection to XA RM Name

CASXO0034E ES has failed to disconnect all SEPs from XA RM Name. Monitoring disabled

COBEC Error Messages

COBEC1244S use of SOAPFAULT API requires ECM SPFAULT directive to be set

User Exits

Exit Points

Exit Interface Definition

External Data Value Modification - Input Parameter (Exit Point 1)

Internal Data Value Modification - Input Parameter (Exit Point 2)

Unmapped Named External Input Parameter (Exit Point 3)

End of Input Request Processing (Exit Point 4)

Start of Response Processing (Exit Point 5)

Internal Data Value Modification - Output Parameter (Exit Point 6)

External Data Value Modification - Output Parameter (Exit Point 7)

End of Response Processing (Exit Point 8)

End of Request Processing (Exit Point 9)

Configuring Whether a Message Shows in the Console

Support Functions

PFI

PFI_IDPES_FN_DISPLAY_TO_UTF16

PFI_IDPES_FN_UTF16_TO_DISPLAY

PFV_IDPES_FN_ALLOC_MEM

PFV_IDPES_FN_FREE_MEM

Structures

IDP_EXIT_INFO

IDP_EXIT_SERVICE_FUNCS

REQHAND_RESPONSE

REQUEST_CONTEXT

Enterprise Server Security

Securing an Enterprise Server Installation

Architecture and Overview

About Securing an Enterprise Server Installation

Threat Models

Security Architecture

System Components and Process Flows

About the External Security Facility (ESF)

About Security Managers

About Security Queries

Designing the Security Policy

Configuring Enterprise Server Security

Security Configuration Stages

Adding a Security Manager to the Pool

To Add or Remove a Security Manager in the Pool

To Edit a Security Manager's Properties

Enabling a Security Manager

To Enable or Disable a Security Manager

Defining a Security Manager List

To Add a Security Manager to the Default ES Security Manager List

To Set Default Enterprise Server Security Configuration

Setting MF Directory Server Security Configuration

Customizing the Security Settings for an Enterprise Server Instance

To Set Security Configuration Options for an Enterprise Server

Security Configuration Custom Configuration Information

Implementing Security Manager Changes

To Update using the Enterprise Server Administration Interface

To Update Security Manager Changes Using esfupdate

Configuring External Security Facility (ESF) from the Command Line

About the esfadmin Command

esfadmin Command Syntax

esfadmin Usage Notes

Setting User Passwords with esfadmin

esfadmin Sub-commands

ADDACE, ALTACE, and DELACE

ADDCLASS and ALTCLASS

ADDGROUP and ALTGROUP

ADDMEMBER and DELMEMBER

ADDRESOURCE and ALTRESOURCE

Using the MFDS Internal Security Module

Working with Users, Groups and Resources

Application Access and Administration Access

Understanding Users and Groups

Understanding Permissions

Directory Server Permissions

Server Permissions

Managing Users and Groups

Setting Permissions

Best Practice

MLDAP ESM Module

LDAP Client and Server Software

The Micro Focus LDAP Schema

Wildcards for Resource, User, and Group Names

Username Substitution

Nested Groups

Resource Access Control

Matching Rules and ACEs

Compatibility Rule Matching

Resource Rules, Search Order, and Precedence

Match Rank

Resource Access Control Lists

Users and Groups

"Use all groups" Mode

Access Levels and Permissions

ACE Precedence

Processing ACLs

Module Configuration

MLDAP ESM Module Configuration Fields

MLDAP ESM Module Custom Configuration Information

Using All Groups to Which a User Belongs

Federation in the MLDAP ESM Module

Configuring Security Using OpenLDAP

Using an LDAP client library

About OpenLDAP for the Micro Focus Environment

Installing the Required Schema Extensions

Adding default MFDS users, user groups and resources

Configuring the OpenLDAP server

Confirming Extension Installation

Creating Standard Micro Focus application containers

Configuring mldap_esm Security Manager for an LDAP

Examples

Defining a User with LDIF

Defining a Group with LDIF

Defining CAS Resources with LDIF

Defining Files with LDIF

Managing LDAP Security Manager from the Enterprise Server UI

About Managing an LDAP

Changing User Passwords Stored in an LDAP

About Users, Groups and Resources

Managing User Access

To Add a User

To Edit a User

To Delete a User

To View Permissions for a User

Managing Groups

To Add a Group

To Edit a Group

To Delete a Group

To View Permissions for a Group

Assigning Resource Permissions

About Resource Security

To Enable Resource Security

To Add a Resource Class

To Add a Resource Entity

To Assign Resource Permissions

To Edit a Resource Class

To Edit a Resource Entity

To Assign Resource Permissions When Using MFDS Internal Security

To Delete a Resource Class

To Delete a Resource Entity

Security Configuration Screen Help

MF Directory Server Users, Add or Edit

Add Resource Class

Add Resource Entity

Add Security Manager

Add to Default ES Security Manager List

Add to ES Security Manager List

Add to MF Directory Server Security Manager List

Configure General Options

Confirm Password

Configure Journal Options

Configure Monitor Options

Configure Repository Options

Default ES Security Configuration

Directory Server Users

Edit Resource Class

Edit resource entity

Edit Security Manager

Left Pane Menu Items

MF Directory Server Security

Remove Security Manager Reference Confirmation

Security Managers Pool

SSL Options

Shut Down the MF Directory Server

Update User

User Group Members

User Groups

User Import: another user registry

User Import: previous version

ESF LDAP Security Administration Web Interface

Prerequisites

Configuring the ESF LDAP Security Administration Web Interface

Operation

Managing Users

Managing Groups

Managing Resource

To Add a Resource Class

To Add a Resource Entity

To Edit a Resource Class

To Edit a Resource Entity

To Delete a Resource Class

To Delete a Resource Entity

ESF LDAP Properties

Migrating from Enterprise Server Early Versions

Integrating Security from Early Releases: casesm

Exporting MFDS Internal Security Definitions

To Export Micro Focus LDAP Schema Extensions

To Export Users and Groups to an LDIF File

To store the directory server repository in an LDAP server

Security Reference Information

Environment Variables used in Enterprise Server Security

Enterprise Server Default Users and Associated Environment Variables

Resource Classes used by Enterprise Server

Resource Classes for ESF Features

Resource Classes for ESMAC and Operator Command Security

Resource Classes for MF Directory Server

Class - Enterprise Server Administration

Class - Servers

Solutions, Restrictions, and Changes in Behavior

Service Deployment and Security

Configuring Credentials for Starting and Stopping Enterprise Servers

Sign-on Disabled for Default Users

Configuring Sun Java System Directory as a Security Manager

Using External Security Facility (ESF) Features

ESF Caching

What is Cached?

Caching and Side Effects

Using Flush on Change

Enabling and Configuring Caching

Advanced Configuration

External Administrative Update Notification

Using Update Notification Requests

Making an Update Notification Request

Handling Update Notifications in an ESM Module

ESF Passtokens

Access to Passtokens

Passtoken Options for ESF Manager

Passtoken Options for the MLDAP ESM Module

ESM Module Configuration

LDAP Attributes

Typical Passtoken Configurations

Using Passtokens

Passtoken API

Security Federation

What Federation Does

Configuring Federation

ESF Manager Messages and Logging

Manager Interface Messages

ESF API Processing Messages

103W Admin "type" request failed: "value"

104W Update ("type") request failed: "value"

105W ESM Module number ("name") returned error code value ("description") from Update (type)

110E ESM Module number ("name") returned error code value ("description") from Verify

111E ESM Module number ("name") returned error code value ("description") from Auth

112E ESM Module number ("name") returned error code value ("description") from XAuth

113E ESM Module number ("name") returned error code value ("description") from Admin

114E ESM Module number ("name") returned error code value ("description") from Update

ESM Module Interface Messages

200I Loaded ESM Module "name"

201C Unable to load ESM Module "name": reason

202C ESM Module "name" returned invalid procedure table

203C ESM Module "name" initialization failed

204W ESM Module index returned error code value from Exit

Processing Environment Messages

301W Unable to open log file "name": ("value") description

320C CAS support function "name" is not available

321E Unable to allocate ACEE (error code)

322E Unable to allocate named shared memory (error code)

Cache Messages

User Exit Messages

Auditing Messages

601C Auditing subsystem startup failed: ("value") description

602C Auditing: cobaudit_event failed: ("value") description

ESM Module Messages

Temporary Messages

ESF User Exit

ESF User Exit File Names

Enabling an ESF User Exit

To enable the ESF user exit through configuration

To enable a mandatory ESF User Exit

Configuring an ESF User Exit

Configuration options for the Referential Integrity User Exit

The Referential Integrity Sample User Exit

Configuration options for the Referential Integrity User Exit

Source Code for the Sample User Exit

Rules Enforced by the Referential Integrity User Exit

Result Codes in the ESF API Parameter Block

Typical Result Codes for Verify

Typical Result Codes for Auth and XAuth

Typical Result Codes for Admin

Long Usernames and Passwords

Long Passwords

Long Usernames

Permitted Characters for Short Names

Name Mapping

Short-to-long Mapping

Short-to-long Mapping for Verify

Verify Request Throttling

Glossary

Enterprise Server Auditing

Configuring Enterprise Server Auditing

Audit Event Codes

Creating Custom Audit Events

Using the Security Audit Manager (deprecated)

About the Audit Manager (deprecated)

Audit Manager Architecture (deprecated)

About Audit Emitters (deprecated)

Audit Setup Configuration File (deprecated)

Default Audit Configuration (deprecated)

Getting Started with Auditing (deprecated)

Starting and Stopping the Audit Process (deprecated)

To Start the Audit Manager (deprecated)

To stop the Audit Manager (deprecated)

Configuring the AUDITFILE Emitter (deprecated)

Setting AUDITFILE Emitter Properties (deprecated)

Setting the Audit Output Type (deprecated)

Specifying a User-defined Emitter (deprecated)

Configuring the SNMP Emitter (deprecated)

Using the SNMP Audit Emitter (deprecated)

Using the SNMP Emitter with a Net-SNMP Agent (deprecated)

Configuring the emitter (deprecated)

Specifying the location of management tools (deprecated)

Configuring logging for problem diagnosis (deprecated)

Working with SNMP v3 (deprecated)

The SNMP V3 Specific Configuration Options (deprecated)

Configuring the Micro Focus Audit Emitter for SNMP V3 (deprecated)

Accessing Audit Data (deprecated)

mfauditadm command (deprecated)

To List Audit Event Consolidator Configuration Details (deprecated)

To Generate a Report for an Audit File (deprecated)

To Generate a Report for All Audit Files in a Collection (deprecated)

To Dump and Generate a Report for an Audit File (deprecated)

To Dump and Generate Reports for All Audit Files in a Collection (deprecated)

To Make the Active Audit File Available for Dumping (deprecated)

To Dump All Audit Files in a Collection (deprecated)

To Dump an Audit File (deprecated)

Audit Manager Errors (deprecated)

AUD0002E: Failed to start server (deprecated)

AUD0003E: Failed to connect to server (deprecated)

AUD0004E :Failed to initialise audit facility (deprecated)

AUD0005E: Failed to allocate memory (deprecated)

AUD0006E: File does not exist (deprecated)

AUD0007E: File is not available for dumping (deprecated)

AUD0008E: No file is available for dumping (deprecated)

AUD0009E: Invalid file format (deprecated)

AUD0010E: Invalid file name (deprecated)

AUD0011E: File not dumped (deprecated)

AUD0012E: Operation failed (deprecated)

AUD0013E: Failed to create output file (deprecated)

AUD0029E: Failed to initialise CTF (deprecated)

AUD0030E: You are not authorised to stop the server (deprecated)

AUD0031E: Failed to install service (deprecated)

AUD0032E: Failed to uninstall service (deprecated)

AUD0033E: File is not active (deprecated)

AUD0034E: You are not authorised to perform this operation (deprecated)

AUD0036E: Semaphore fault (deprecated)

Configuring a User Exit (deprecated)

AUDITFILE User Exit (deprecated)

Sample file auditfile_exit.c (deprecated)

Audit Manager APIs (deprecated)

API Return Codes (deprecated)

Audit Events (deprecated)

Audit Event Codes

Audit Configuration APIs (deprecated)

CBL_AUDIT_CONFIG_PROPERTY_GET (deprecated)

CBL_AUDIT_CONFIG_PROPERTY_SET (deprecated)

Audit Event Generation APIs (deprecated)

CBL_AUDIT_EVENT (deprecated)

CBL_AUDIT_HANDLE_GET (deprecated)

cobaudit_event (deprecated)

Audit Event Consolidator APIs (deprecated)

CBL_AUDIT_EMITTER_PROPERTY_GET (deprecated)

CBL_AUDIT_EMITTER_PROPERTY_SET (deprecated)

Audit File Processing APIs (deprecated)

CBL_AUDIT_FILE_CLOSE (deprecated)

CBL_AUDIT_FILE_OPEN (deprecated)

CBL_AUDIT_FILE_READ (deprecated)

cobaudit_file_read (deprecated)

Audit Emitter Interface (deprecated)

Audit Emitter Interface Overview (deprecated)

PFI_AUD_EMITTER_DEINIT (deprecated)

PFI_AUD_EMITTER_INIT (deprecated)

PFV_AUD_EMITTER_NOTIFY (deprecated)

PFI_AUD_EMITTER_OUTPUT (deprecated)

Structure and Typedefs (deprecated)

Structures and Typedefs for AUDIT_EMITTER_FUNCS (deprecated)

Structures and Typedefs - AUDIT_EVENT (deprecated)

Structures and Typedefs - AUDIT_EMITTER_EVENT (deprecated)

Structures and Typedefs - AUDIT_RECORD (deprecated)

Structures and Typedefs - EMITTER_NOTIF_PROP_CHANGE (deprecated)

Securing Communications

Introduction to Securing Communications

Configuring Secure Communications for Client Applications

Securing Peer to Peer Communications

Installing a Client Certificate for Enterprise Server

Adding a CA Root Certificate to your Client Application

Installing a CA Root Certificate in a Client Browser

Installing server certificates for secure communication

Installing a CA Root Certificate in a Client Browser

Setting Up Secure Communications

To enable secure communications with SSL

To configure an HTTPS listener

To Create a Secure Listener

To Start a Secure Listener and Set the Pass Phrase

To Configure the Pass Phrase in a File

Troubleshooting a Secure Connection

Accessing the Communications Server Console

To enable logging for listener startup

Troubleshooting Certificate Problems

Using the Demonstration Certificate Authority

About the Demo CA

OpenSSL and Micro Focus Demo CA

Installing Micro Focus Demo CA

Contents of the Demonstration CA

Your CA Certificate, Key and Password

Your Distinguished Name and Policy

Is the Demonstration CA a Real CA?

Tutorial: Requesting and Issuing Server Certificates

Introduction

Requesting a Server Certificate

Issuing a Server Certificate

Tutorial: Configuring SSL Security in the Server

Introduction

Creating a Secure HTTPS Listener

Installing the Server Certificate

Setting a Pass Phrase

Interpreting a Security Alert

Importing the CA's Root Certificate

Verifying the Certificate

Tidying Up

Information on OpenSSL

OpenSSL Utility

OpenSSL Configuration File

Algorithms

Interpreting OpenSSL Error Messages

Supported SSL Protocol Versions and Cipher Suites

SSL and PKI Technology Primer

SSL

What is SSL?

SSL and TLS Terminology

Encryption and Decryption

Keys and Algorithms

Public Keys, Private Keys, and Secret Keys

Using Asymmetric and Symmetric Algorithms Together

CAs and PKIs

What is a CA?

How does the CA show it trusts an entity?

How does the CA check on entities?

Why should you trust the CA?

How do you know the certificate really came from the CA?

What is a PKI?

Root and Subordinate CAs

How Do you Check a Certificate?

Certificate Validity Period and Revocation

Types of Certificates - Purpose

Authentication Modes

Typical Process

Checking, Exporting and Importing Certificates Overview

Viewing Certificates

With Internet Explorer

With Mozilla Firefox

Checking a Certificate

With Internet Explorer

With Mozilla Firefox

Exporting a Certificate from Internet Explorer

Importing a Certificate into Mozilla Firefox

Certificates

Certificate and Key Formats

Don't Edit Certificates and Key Files

To Convert Certificate Formats

Multiple PEM Format Certificates

Standards and Organizations

X.509

PKCS Standards

Some Common Algorithms: Overview

Algorithms and Key Lengths

Choosing an Algorithm

Symmetric Algorithms

Asymmetric Algorithms

Hashing

Digital Signatures

Digital Signature Standard (DSS)

Definitions for OpenSSL

Overview

ASN.1 Compiler

Encoding Rules

Distinguished or Canonical Encoding Rules

Attacks

Man-in-the-Middle Attack

Truncation Attack

Designing a PKI

General Points

Client Certificates

Security

Controlling Network Access

Controlling Physical Access

Backups

Specifying a Server Protocol and Cipher Suite Preference

Configuring a TLS Protocols List

Configuring a Cipher Suites List

Dependencies Between TLS Protocols and the Cipher Suites

Configuring the MF Directory Server to use TLS Protocols and Cipher Suites

Configuring a Listener to use TLS Protocols and Cipher Suites

Secure Communications (SSL) Legal Information

Multi-Factor Authentication

Configuring a region for Express Logon Feature

Configuring a region for Automated Sign-On for Mainframe

Enterprise Server License Messages

CASSI1002S Server manager initialization failure, no valid license found

CASKC1000I ES concurrent request limit: number

CASKC1001W Warning: Concurrent request limit exceeded number times

CASKC1002I ES concurrent request limit: number, actual: number

Running an Application from the Command Line

Command to Run a Linked System Executable Program

cobrun Command

cobrun Command Examples

Run-time System Error Messages

Key to Run-Time System Error Messages

COBRT001 - COBRT020

COBRT001 Insufficient buffer space (Recoverable)

COBRT002 File not open when access attempted (Recoverable)

COBRT003 Serial mode error (Recoverable)

COBRT004 Illegal file name (Recoverable)

COBRT005 Illegal device specification (Recoverable)

COBRT006 Index structure corrupt (Recoverable)

COBRT007 Disk space exhausted (Fatal)

COBRT008 Attempt to input from a file opened for OUTPUT (Recoverable)

COBRT009 Directory not found (Recoverable)

COBRT010 File name not supplied (Recoverable)

COBRT011 Process limit reached (Fatal)

COBRT012 Attempt to open a file which is already open (Recoverable)

COBRT013 File not found (Recoverable)

COBRT014 Too many files open simultaneously (Recoverable)

COBRT015 Too many indexed files open (Recoverable)

COBRT016 Too many device files open (Recoverable)

COBRT017 Record error: probably zero length (Recoverable)

COBRT018 Read part record error: EOF before EOR or file open in wrong mode (Recoverable)

COBRT019 Rewrite error: open mode or access mode wrong (Recoverable)

COBRT020 Device or resource busy (Recoverable)

COBRT021 - COBRT040

COBRT021 File is a directory (Fatal)

COBRT022 Illegal or impossible access mode for OPEN (Recoverable)

COBRT023 Illegal or impossible access mode for CLOSE (Recoverable)

COBRT024 Disk input-output error (Recoverable)

COBRT025 Operating system data error (Fatal)

COBRT026 Block I-O error (Fatal)

COBRT027 Device not available (Recoverable)

COBRT028 No space on device (Fatal)

COBRT029 Attempt to delete open file (Recoverable)

COBRT030 File system is read-only (Recoverable)

COBRT031 Not owner of file (Recoverable)

COBRT032 Too many indexed files, or no such process (Recoverable)

COBRT033 Physical I-O error (Fatal)

COBRT034 Incorrect mode or file descriptor (Recoverable)

COBRT035 Attempt to access a file with incorrect permission (Recoverable)

COBRT036 File already exists (Recoverable)

COBRT037 File access denied (Fatal)

COBRT038 Disk not compatible (Fatal)

COBRT039 File not compatible (Fatal)

COBRT040 National Language initialization not set up correctly (Fatal)

COBRT041 - COBRT060

COBRT041 Corrupt index file (Recoverable)

COBRT042 Attempt to write on broken pipe (Recoverable)

COBRT043 File information missing for indexed file (Fatal)

COBRT044 Attempt to OPEN an NLS file in a non-NLS program (Fatal)

COBRT045 Attempt to OPEN an NLS file using incompatible language definition (Fatal)

COBRT047 Indexed structure overflow (Fatal)

COBRT048 Attempt to divide by zero (Fatal)

COBRT051 (message text is intentionally blank)

COBRT055 Routine table overflow (Fatal)

COBRT061 - COBRT080

COBRT064 Incompatible file locking mode (Recoverable)

COBRT065 File locked (Recoverable)

COBRT066 Attempt to add duplicate record key to indexed file (Fatal)

COBRT067 Indexed file not open (Recoverable)

COBRT068 Record locked (Recoverable)

COBRT069 Illegal argument to isam module (Fatal)

COBRT070 Too many indexed files open (Recoverable)

COBRT071 Bad indexed file format (Fatal)

COBRT072 End of indexed file (Fatal)

COBRT073 No record found in indexed file (Fatal)

COBRT074 No current record in indexed file (Fatal)

COBRT075 Indexed data file name too long (Fatal)

COBRT076 Can't create lock file in /isam directory (Fatal)

COBRT077 Internal ISAM module error (Fatal)

COBRT078 Illegal key description in indexed file (Fatal)

COBRT079 COBCONFIG syntax error (Fatal)

COBRT080 Can't convert to/from Unicode codeset (Fatal)

COBRT081 - COBRT100

COBRT081 Key already exists in indexed file (Fatal)

COBRT082 CALL convention not supported (Fatal)

COBRT086 Remote file system failure (Fatal)

COBRT096 Invalid use of fork() (Fatal)

COBRT097 Acu library routine is and will remain unimplemented

COBRT098 The library routine is not available in Visual COBOL (<routine-name>) Please contact Micro Focus Customer Care for information

COBRT099 Illegal operation in SORT/MERGE module (Fatal)

COBRT100 Invalid file operation (Fatal)

COBRT101 - COBRT120

COBRT101 Illegal operation on an indexed file (Fatal)

COBRT102 Sequential file with non-integral number of records (Fatal)

COBRT103 Parameter cannot be passed BY VALUE (Fatal)

COBRT104 Null file name used in a file operation (Fatal)

COBRT105 Memory allocation error (Fatal)

COBRT106 Dictionary error (Fatal)

COBRT107 Operation not implemented in this run-time system (Fatal)

COBRT108 Failure to initialize data division (Fatal)

COBRT109 Invalid checksum in run-time system (Recoverable)

COBRT110 Generated code not supported by this RTS (Fatal)

COBRT111 Incompatible Class Library and Run-Time Environment versions (Fatal)

COBRT112 Unable to locate/access the required security key (Recoverable)

COBRT114 Attempt to access item beyond bounds of memory (Fatal)

COBRT115 Unexpected signal (Fatal)

COBRT116 Cannot allocate memory (Fatal)

COBRT117 Bad collating sequence (Fatal)

COBRT118 Symbol not found (Fatal)

COBRT119 Symbol redefined (Fatal)

COBRT120 Symbol string table of zero size (Fatal)

COBRT121 - COBRT140

COBRT121 Symbol is not in TEXT section (Fatal)

COBRT122 Coblongjmp() called below level of cobsavenv() (Fatal)

COBRT123 Unknown relocation type (Fatal)

COBRT124 Communication failure during I/O request to the central file handler

COBRT125 All locks/ current transactions canceled due to exceeding time limit

COBRT126 Record size exceeds system limit (Fatal)

COBRT127 coblongjmp() called from a different thread to cobsetjmp() (Fatal)

COBRT128 Connection to Fileshare Server refused

COBRT129 Attempt to access record zero of relative file (Recoverable)

COBRT130 Connection to Fileshare Server re-established (Recoverable)

COBRT135 File not found (Recoverable)

COBRT136 Corrupt or invalid executable file (Fatal)

COBRT137 Illegal device specification - not mass storage

COBRT138 File closed with lock - cannot be opened (Recoverable)

COBRT139 Record length or key data inconsistency (Recoverable)

COBRT141 - COBRT160

COBRT141 File already open - cannot be opened (Recoverable)

COBRT142 File not open - cannot be closed (Recoverable)

COBRT143 Rewrite/delete in sequential mode not preceded by successful read (Recoverable)

COBRT144 Boundary violation (Recoverable)

COBRT146 No current record defined for sequential read (Recoverable)

COBRT147 Wrong open mode or access mode for read/start (Recoverable)

COBRT148 Wrong open mode or access mode for write (Recoverable)

COBRT149 Wrong open mode or access mode for rewrite/delete (Recoverable)

COBRT151 Random read on sequential file (Recoverable)

COBRT152 REWRITE on file not opened I-O (Recoverable)

COBRT153 Subscript out of range (Fatal)

COBRT154 PERFORM nested too deeply (Fatal)

COBRT155 Illegal command line (Fatal)

COBRT156 Too many parentheses in compute statement (Fatal)

COBRT157 Not enough program memory: object file too large to load (Recoverable)

COBRT158 Attempt to REWRITE to a line-sequential file (Recoverable)

COBRT159 Malformed line-sequential file (Recoverable)

COBRT160 Overlay loading error (Recoverable)

COBRT161 - COBRT180

COBRT161 Illegal intermediate code (Fatal)

COBRT162 Arithmetic overflow or underflow (Fatal)

COBRT163 Illegal character in numeric field (Fatal)

COBRT164 Run-Time subprogram not found (Fatal)

COBRT165 Version number incompatibility (Fatal)

COBRT166 Recursive COBOL CALL is illegal (Fatal)

COBRT167 Too many USING items (Fatal)

COBRT168 Stack overflow (Fatal)

COBRT169 Illegal configuration information (Fatal)

COBRT170 System program not found (Fatal)

COBRT171 Japanese operations illegal with this RTS (Fatal)

COBRT173 Called program file not found in drive/directory (Fatal)

COBRT174 Imported file not found (Fatal)

COBRT175 Attempt to run intermediate code program which had severe errors in it (Fatal)

COBRT176 Illegal intersegment reference (Fatal)

COBRT177 Attempt to cancel program failed (Fatal)

COBRT179 Error during chain (program not found) (Fatal)

COBRT180 End-of-file marker error (Fatal)

COBRT181 - COBRT200

COBRT181 Invalid parameter error (Fatal)

COBRT182 Console input or console output open in wrong direction (Fatal)

COBRT183 Attempt to open line sequential file for I-O (Fatal)

COBRT184 ACCEPT/DISPLAY I-O error (Fatal)

COBRT185 File malformed (Recoverable)

COBRT186 Attempt to open stdin, stdout or stderr with incorrect mode (Recoverable)

COBRT187 Run-time system not found on $COBDIR path (Fatal)

COBRT188 Filename too large (Fatal)

COBRT189 Intermediate code load error (Fatal)

COBRT190 Too many arguments to CALL (Fatal)

COBRT191 Terminal type not defined (Fatal)

COBRT192 Required terminal capability description missing (Fatal)

COBRT193 Error in variable length count (Fatal)

COBRT194 File size too large (Fatal)

COBRT195 DELETE/REWRITE not preceded by a read (Fatal)

COBRT196 Record number too large in relative or indexed file (Fatal)

COBRT197 Screen handling system initialization error (Fatal)

COBRT198 Load failure (Fatal)

COBRT199 Operating System error code lies outside expected range (Fatal)

COBRT200 Run-time system internal logic error (Fatal)

COBRT201 - COBRT220

COBRT201 I-O error in paging system (Fatal)

COBRT203 CALL parameter not supplied (Fatal)

COBRT205 Invalid mainframe pointer value (Fatal)

COBRT206 Reading unwritten data from memory (Fatal)

COBRT207 Machine does not exist (Recoverable)

COBRT208 Error in multi-user system (Fatal)

COBRT209 Network communication error (Recoverable)

COBRT210 File is closed with lock (Fatal)

COBRT211 Program not executable by Run-Time System (Fatal)

COBRT212 Run-Time System version incompatible with object-oriented program (Fatal)

COBRT213 Too many locks (Recoverable)

COBRT214 GO TO has not been ALTERed (Fatal)

COBRT215 Cannot DEBUG a program running COMMUNICATIONS (Fatal)

COBRT216 Cannot initialize the named communications device (Fatal)

COBRT217 Incompatible host for native code file (Fatal)

COBRT218 Malformed MULTIPLE REEL/UNIT file (Fatal)

COBRT219 Operating system shared file limit exceeded (Recoverable)

COBRT220 Attempt to execute more than one SORT or MERGE simultaneously (Fatal)

COBRT221 - COBRT240

COBRT221 Internal sort error (Fatal)

COBRT222 Merge files out of sequence (Fatal)

COBRT223 NLS language expansion error (Fatal)

COBRT224 External Language Initialization failure

COBRT225 Dynamic load error - program component missing (Fatal)

COBRT226 EXTERNAL file definition inconsistent

COBRT227 EXTERNAL data definition inconsistent (Fatal)

COBRT228 Could not allocate memory for EXTERNAL item (Fatal)

COBRT229 SORT/MERGE module does not support EXTERNAL using/giving files (Recoverable)

COBRT230 SORT RETURN attempted after the at end condition was returned

COBRT231 GENERATE encountered before corresponding INITIATE in report (Fatal)

COBRT232 Reference modification out of bounds

COBRT235 Error in debugger communications channel (Fatal)

COBRT236 Debugged program has terminated unexpectedly (Fatal)

COBRT237 Unable to initialize debugged process (Fatal)

COBRT238 STOP RUN encountered during GNT animation (Informational)

COBRT239 Shared run-time system initialization failure (Informational)

COBRT240 Object reference not valid (Fatal)

COBRT241 - COBRT260

COBRT241 Cannot instantiate an abstract class (Fatal)

COBRT242 Could not resolve DoesNotUnderstand message (Fatal)

COBRT243 Class could not be loaded (Fatal)

COBRT244 Licensing initialization error (Fatal)

COBRT245 There are no valid product licenses (Fatal)

COBRT246 Maximum number of product licenses exceeded (Fatal)

COBRT247 Licensing error (Fatal)

COBRT250 Not enough mainframe address space to load or run the program (Fatal)

COBRT251 Attempt to load AMODE(24) program when current setting is AMODE(31) only (Fatal)

COBRT252 Memory corruption detected (Fatal)

COBRT253 Cannot load file - unsupported format (Fatal)

COBRT254 Keyboard interrupt to ANIMATOR during ACCEPT (Fatal)

COBRT255 CODESET cannot open double byte conversion table

Data Access

Data Files

Data File Editor

Current Restrictions

Accessing Data File Editor

Launching Data File Editor from a Shell Prompt

Preferences

Set the Editor Preferences

Using the Data File Editor

Creating Data Files

Create a Non-indexed Data File

Create an Indexed Data File

Editing Data Files

Working with Data Sets in Enterprise Server

Opening a Data Set in Enterprise Server

Enterprise Server Error Messages

Insert a Record

Edit an Unformatted Record

Edit a Formatted Record

Layout and Field Validation

Fix Validation Warnings

Edit a Record Using Hexadecimal Values

Delete a record

Profile Files

Viewing and Filtering Data Files

View File Information

Filtering a Data File

Filter the Data File

Filter Operators

Navigate a Data File

Show the Contents of a Data File in Hexadecimal

Select the Encoding for a Data File

Order a Data File using Indexed Keys

Backing Up Data Files

Back up a data file

Using the Classic Record Layout Editor

Create a Structure File and Record Layouts

Rebuild

Overview

Command Line

Option Files

Redirection of Information

Rebuild Options

Reorganizing Indexed Files

Rebuilding a Corrupt Indexed File

Converting a File

Validating an Indexed File

Rebuild through Fileshare

Callable Rebuild

Rebuild Examples

File Handling

File Handling Reference

Configuration File

Format of the Configuration File

Path and filename tag

Example

Configuration File Options

Operation Codes

Standard Operation Codes

Standard Operation Codes - Overview

Special Operation Codes

Special Operation Codes - Overview

FSView

FSVIEW

Redirection of Information

Command Files

FSVIEW Command Line Syntax

File Status

Extended File Status Codes

Microsoft COBOL V2 File Status Codes

Sort Utilities

Introduction

Invoking Mfsort

Instructions

FIELDS Instruction

Field Types

Defining Input and Output Files

RECORD Instruction

ORG Instruction

KEY Instruction

Creating a Statistics Report

Example Commands

Sorting Using More Than One File

Character Sort in Ascending Order

Numeric Sort in Descending Order

Omitting Records

Single File Sort Using INCLUDE and a Sub-string Comparison

Single File Sort Using Environment Variables

Transforming Records Using OUTREC

Sort Using OUTFIL for Complex Reporting

Sorting Files

Callable Sort Module

Sort Module Function Codes

Sort File Control Description

SORT Environment Variables

Mfsort Error Messages

Messages 0001 to 0099

SORT014U Status = value

SORT015U Command statement error(s) detected

SORT019I Key length truncated to 4096 bytes

SORT020U SORT(EXTSM) failed - sort engine status = Value

SORT032I Number records sorted

SORT033I Number records merged

SORT034I Number records copied

SORT036U SORTIN record length missing or invalid

SORT037U SYSIN RECFM value invalid

SORT038U SORTIN RECFM value invalid

SORT039U SORTOUT RECFM value invalid

SORT040U SORT terminated by E15 Operator

SORT041U SORT terminated by E35 Operator

SORT042U Memory allocation failure

SORT043U Too many OUTFIL files specified

SORT044U Too many USE files specified

SORT045U Too many GIVE files specified

SORT050U ICETOOL input file not found

SORT051U ICETOOL output file not found

SORT093U SORT terminated - missing SORTIN or SORTIN01

SORT094U SORT terminated - missing SORTOFvalue

SORT095U SORT terminated - Bad data in CHANGE field

SORT096U SORT terminated - missing FNAMES dataset value

Messages 0100 to 0199

SORT100E Missing operator

SORT101E Malformed operator

SORT102E Expected operand missing

SORT103E Invalid operator operator

SORT104E Invalid operand keyword keyword

SORT105E Expected continuation not present

SORT106E Field formats improperly specified

SORT107E Field format field-format invalid

SORT108E Sequence sequence invalid

SORT109E Too many fields specified

SORT110E Non-numeric data detected

SORT111E operator operator already processed

SORT112E exit exit not supported

SORT114E Expected '(' not found

SORT115E Boolean operator operator invalid

SORT118E SORT / MERGE conflict

SORT119E INCLUDE / OMIT conflict

SORT120E SORT statement missing FIELDS operand

SORT121E MERGE statement missing FIELDS operand

SORT122E INCLUDE statement missing COND operand

SORT123E OMIT statement missing COND operand

SORT124E FIELD position field-position invalid

SORT125E FIELD length field-length invalid

SORT126E RECORD length record-length invalid

SORT127E Missing SORT/MERGE/COPY command statement

SORT128E Expected ')' not found

SORT129E Expected '=' not found

SORT130E Expected 'F' OR 'V' not found

SORT131E Expected 'IX', 'RL', 'SQ', or 'LS' not found

SORT132E Prime key must be specified first

SORT133E Expected 'P', 'AD', 'A', or 'C' not found

SORT134E Keyword/value value invalid for DFSORT emulation

SORT135E Keyword/value value invalid for SYNCSORT emulation

SORT136E No GIVE file specified for OUTFIL group

SORT137E No USE file specified

SORT138E Target literal literal too long in CHANGE

SORT139E Substring comparison must be with character literal

SORT140E Invalid binary digit detected

SORT141E Cannot specify SAVE with either INCLUDE or OMIT

SORT142E Repeated FILE= or FNAMES=

SORT191I Operator operator ignored

SORT192I Operand operand ignored

SORT193E Invalid hex digit detected

SORT194 I No ALTSEQ command specified for 'AQ' SORT field formats; 'CH' assumed

SORT196E SUM / COPY conflict

SORT197E INREC / MERGE conflict

SORT198E Non-numeric data detected in 'ZD' SUM field

SORT199E Too many OUTFIL statements

Messages 0200 to 0399

SORT200E Bad or unknown symbol

SORT201E No previous offset defined for symbols

SORT202E No previous length defined for symbols

SORT203E No previous format defined for symbols

SORT204I *********************Sort Statistics*********************

SORT205I INPUT file filename

SORT206I OUTPUT file filename

SORT207I OUTFIL file filename

SORT214I Format operand ignored

SORT215E Reformatting field error

SORT216I Record type is V - Data starts at position 5

SORT217I Record length L1 or L3 overridden

SORT232E Field length exceeds maximum allowed

SORT399I End of Micro Focus MFJSORT Utility

Tracing File Operations

Introduction

Configuring Tracing and Logging

Dynamic Tracing

Using the FCD to Control Tracing

Using Library Routines to Control Tracing

Fileshare Guide

Introduction

Overview

How Fileshare Works

Standard Operation

Fileshare Client

Specifying the Fileshare Server

As a Filename

In a Configuration File

Specifying the Communications Protocol

Configuring Your Fileshare Client

Fileshare Client Configuration Options

Example Client Configuration File

Using the File Handling Redirector Module

FHREDIR Return Codes

Fileshare Server

Configuring the Fileshare Server

Specifying a Fileshare Server Name

Specifying the Communications Protocol

Fileshare Server Configuration Options

Example Server Configuration File

Starting the Fileshare Server

Stopping the Fileshare Server

Configuring CCI Communications for Fileshare

About Fileshare Communications

Specifying the Communications Protocol

Using CCITCP

Using UNIX named pipes: ccinampu

Logging Fileshare Messages: CCI Trace

Using Multiple Protocols with Test Programs

Configuring the CCI Timeout

Database Integrity

Transaction Processing

Automatic Record Lock Timeout

Transaction Processing - Fileshare Client

Transaction Processing - Fileshare Server

Recovery Logging

Basic Recovery Logging

Advanced Recovery Logging

Enabling Advanced Recovery Logging

Fileshare Exit Procedure - fsexitproc.cbl

Viewing the Log Files

Fileshare Recovery

Basic Rollforward Recovery

Advanced Rollforward Recovery

Advanced Rollback Recovery

Database Sequence Numbering

Database Sequence Numbers - Fileshare Server

Database Backup and Recovery

Automatic Database Backup and Rollforward Recovery

Hot Backups

Running a Hot Backup

Database Reference File Maintenance

Recovery Log File Records

Disk Space Warning (/p)

Flushing the Log File (/lc)

Erasing a Log File Record (/e)

Example

Filename Record

Alternative Filename (/af)

Virtual File Handler (/ap)

Data and Key Compression (/k)

Disable Logging (/o l)

Disable Database Sequence Numbering (/o s)

Disable Transaction Processing (/o t)

Erasing a Filename Record

Examples

File String Record

Erasing a File String Record

Example

Backup Folder Record

Best Practices for Backup and Recovery

Best Practices Basic Logging

Best Practices Advanced Logging

Security

Password System

Fileshare Client

Fileshare Server

Writing Your Own FHRdrLngPwd Module

Logon Validation Module

File Access Validation Module

Password File Maintenance

User-ID Groups

Supervisor Mode

Advanced Operation

Running Fileshare as a Background Process

The NFILES Setting

Single User Mode

Filename Mapping

Fileshare Server

Data and Key Compression

Data and Key Compression - Fileshare Server

Virtual File Handler Interface

Fileshare Server

Monitoring Fileshare

Fileshare Manager

Fileshare Manager Configuration

Byte-stream I/O Calls

FS_LOCATE_FILE

FS_SPLIT_FILENAME and FS_JOIN_FILENAME

Performance Considerations

Fileshare Performance on UNIX

Large File Support with Fileshare

Error Handling

Fileshare Extended Status Codes

Communications Errors

Transaction Processing Errors

Fileshare Server Messages

Messages from FS001-S to FS050-W

FS001-S The parameter "text " is not recognized as a valid parameter.

FS004-S The parameter "text " specifies a time-out value that is invalid.

FS005-S The parameter "text " is too long or invalid.

FS006-S The parameter "text " has already been specified.

FS007-S Invalid parameter combination.

FS008-S Communications Initialization Failure.

FS009-S The required communications module cannot be found.

FS011-W Communications send failure.

FS012-W Communications disconnect failure.

FS013-W Communications receive error.

FS014-W Communications data length not as expected.

FS015-W Request from unknown user - request rejected.

FS016-S The parameter "text " is invalid.

FS017-S Unable to open the file : filename.

FS018-S Log file corrupt - unrecognizable record in file.

FS019-S Log file corrupt - can't read header.

FS020-S The log file does not match the database sequence numbers - recovery aborted.

FS021-S There is no log filename specified in the database reference file.

FS022-S The log filename given cannot be found in the database reference file.

FS024-S Failed to open log file : filename.

FS025-S Write failure to the log file, Fileshare Server is closing down.

FS026-W Failed to close the log file.

FS027-S A second log file parameter has been found.

FS028-W The log file shows the last session was not shut down successfully.

FS029-S The log filename is already specified in the database reference file.

FS030-S Insufficient disk space to continue logging to log file.

FS031-I Record lock time-out failure on user : user.

FS034-S A filename or log file parameter must be specified.

FS035-S A database reference file must be specified.

FS037-I The file filename does not have a file header record. Sequence checking is switched off for this file.

FS038-S A matching sequence number not found in filename.

FS039-S Improperly closed file - filename.

FS040-S Unable to read the file header record in the file filename.

FS041-S Unable to update the sequence number in the file filename.

FS042-S Unable to open the database reference file: filename.

FS043-S The database reference file contains an invalid entry.

FS044-S Error reading the database reference file.

FS045-W Duplicate filename specified in the database reference file.

FS050-W A log file is not specified in the database reference file.

Messages from FS051-W to FS099-W

FS051-W Failure to allocate a larger buffer, the I-O request failed.

FS052-S Failure to allocate required memory. The Fileshare Server is closing down.

FS055-S The parameter "text " specifies a configuration file that does not exist.

FS056-S The parameter "text " specifies a data compression value that is not within the range 0-255.

FS057-S The parameter "text " specifies a key compression value that is not within the range 0-7.

FS058-S Failure to allocate memory for the decompression of the log file.

FS059-S Failure to allocate the memory required for processing the database reference file.

FS062-S Failure creating the password file filename.

FS063-S Failure opening the password file filename.

FS064-S Failure reading the password file filename.

FS065-S The password file is not of a recognized format.

FS066-S The specified user name already exists in the password file.

FS068-I The password file is now empty and has been deleted.

FS069-S The specified entry could not be found in the password file.

FS070-S Failure writing to the password file.

FS071-W Unable to load the module FHXSCOMP to decompress the data area.

FS072-S The parameter "text " contains a wild card which is not allowed with this parameter.

FS073-S Failure to allocate memory to process the password file.

FS074-S The Fileshare Server (NLM) failed to log on to NetWare with the login id specified.

FS075-W Unable to load the module FSSECLOG - LOGON has been denied.

FS076-W Unable to load the module FSSECOPN - OPEN has been denied.

FS077-S A Fileshare Server of the same name has already been defined - the Fileshare Server is closing down.

FS078-S No password file has been specified for the use of background mode.

FS079-S A supervisor password entry must exist for the use of background mode.

FS080-S No password file has been specified for the use of the synchronous communications mode.

FS081-S A supervisor password must be specified in the password file for the synchronous communications mode.

FS082-S The Netbios communications protocol is not responding. Ensure the requester software is loaded and functional.

FS083-S Incompatible CCIIPX.NLM version.

FS084-I Fileshare Server is starting.

FS085-I Fileshare Server is active.

FS086-I Fileshare Server is closing down.

FS087-I Fileshare Server has closed down.

FS089-I Database Reference File Maintenance Utility.

FS090-I Database Reference File installation completed successfully.

FS091-I Rollforward Recovery Utility

FS092-I Rollforward Recovery has completed.

FS094-I Password File Maintenance Utility.

FS096-I Password File installation has completed.

FS097-I Are you sure that you wish to close down the Fileshare Server ? (Y/N)

FS099-W File I/O status was not as expected. Returned status: status Expected status: status Action code: text File: filename.

Messages from FS101-I to FS149-I

FS101-I text -- parameter has been accepted.

FS103-I The log filename has been added to the database reference file.

FS104-I The log file cannot be found, creating a new recovery log file.

FS105-W The disk free space for the log file is below acceptable limits.

FS106-I filename - added to database reference file.

FS107-I filename - removed from the database reference file.

FS108-I Processing the files specified in the database reference file.

FS109-W The file filename does not exist.

FS110-I filename - OK.

FS111-W Files are still open. Continue to close down the Fileshare Server (Y/N) ?

FS114-W Waiting for the old log file to be removed.

FS118-I The database sequence number matches the sequence number in the log file, no recovery is needed.

FS122-I Communications too busy on CCI SEND - retrying.

FS123-I Communications too busy on CCI RECEIVE - retrying.

FS124-I Checking the validity of the log file, please wait.

FS125-I Recovery possible to last valid recovery log file record.

FS126-I Performing recovery, please wait.

FS127-S Invalid name mapping command.

FS128-W Fileshare Server closedown invoked by Stop Run processing.

FS129-I The Fileshare Server is still active.

FS130-I Reading database reference file, please wait.

FS131-W Invalid communications mode - parameter ignored.

FS132-I The Fileshare Server is running with the following communication protocol(s):

FS133-I Processing the password file, please wait.

FS134-I The password file cannot be found - creating a new password file.

FS135-I Fileshare Server security is active.

FS136-I Fileshare Server security is not active.

FS138-W The log file has been backed up and a new one has been created.

FS139-I A matching date and time entry has been found in the log file.

FS140-I No matching date and time entry has been found in the log file.

FS142-W The Operating System does not permit the log file to be flushed to disk.

FS143-W The Operating System does not allow free disk space information to be obtained.

FS144-W More than one communications protocol has been specified - synchronous communications mode not active.

FS145-W Fileshare Client disconnected, cannot contact user: text.

FS146-W Unexpected action code, action-code - discarded.

FS147-I A duplicate network message was received and discarded.

FS148-I CCI return-code (function func) = code.

FS149-I CCI SEND not complete, status will be checked later.

Messages from FS151-I to FS200-W

FS151-I CCI message size received = text. Indicated send message size = text

FS153-I The Fileshare Server name has been reregistered on the network.

FS154-I Please enter the FSVIEW supervisor password to enable the use of CCI Trace.

FS155-I Password accepted - CCI Trace is enabled. Do you want CCI Trace active immediately? (Y/N)

FS156-W Incorrect password - CCI Trace is disabled.

FS158-I CCI Trace activated.

FS159-I CCI Trace switched off.

FS160-I Fileshare trace activated.

FS161-I Fileshare trace switched off.

FS163-I Input useropcode [filename-1] [ filename-2].

FS170-I Input- Logon.

FS171-I Input- Logoff user.

FS172-I Input- Find File userfilename.

FS173-I Output- userstatus.

FS176-W There is no backup directory specified in the database reference file.

FS177-S The backup directory specified cannot be found in the database reference file.

FS178-I The backup directory has been added to the database reference file.

FS179-S A backup directory is already specified in the database reference file.

FS180-W The log filename specified has an extension. The name of the log file has been changed to "filename".

FS182-W Output- Access Denied

FS188-W Fileshare Server database reference file installation completed with errors.

FS189-W The backup directory does not exist.

FS190-W The backup directory specifies the name of an existing file.

FS191-W An error occurred accessing the backup directory.

FS192-S More than one log file exists in the log file directory.

FS193-S Unable to open the log file.

FS194-I The log file "filename-1" has been backed up successfully to "filename-2".

FS195-I The Fileshare Server is using the log file "filename".

FS196-W Unable to create the log file "filename".

FS197-S Unable to create the log file "filename".

FS198-W The attempt to backup the log file failed because the backup file "filename" already exists.

FS199-S The attempt to backup the log file failed because the backup file "filename" already exists.

FS200-W The attempt to backup the log file to "filename" failed.

Messages from FS201-S to FS252-S

FS201-S The attempt to backup the log file to "filename" failed.

FS202-I The Fileshare Server will continue logging to the log file "filename".

FS203-I The Fileshare Server is appending to the log file "filename".

FS204-W The Fileshare Server is unable to log to the log file "filename". Rollforward recovery logging is disabled.

FS205-W Unable to remove the old recovery log file "filename".

FS206-S There is more than one starter log file. The Recovery Utility is unable to determine which one to use.

FS207-I There is no starter log file in the log file directory.

FS208-S There is no starter log file in the backup directory.

FS209-I A starter log file has been located in the backup directory.

FS210-S There is more than one starter log file in the backup directory.

FS211-S An error occurred checking the header on the log file "filename".

FS212-I The Rollforward Recovery Utility is processing the log file "filename".

FS213-W Unable to locate the continuation log file "filename" in the log file directory.

FS214-I Searching for a backed up log file in the log file directory.

FS215-I Searching for a backed up log file in the backup directory.

FS216-I No backed up starter log file can be found in the log file directory.

FS217-I No backed up starter log file can be found in the backup directory.

FS218-I No backed up continuation log file can be found in the log file directory.

FS219-I No backed up continuation log file can be found in the backup directory.

FS220-I A backed up starter log file has been found in the log file directory.

FS221-I A backed up starter log file has been found in the backup directory.

FS222-I A backed up continuation log file has been found in the log file directory.

FS223-I A backed up continuation log file has been found in the backup directory.

FS224-S The log file directory contains more than one backed up starter log file.

FS225-S The backup directory contains more than one backed up starter log file.

FS227-W Failure to set Fileshare Server's access rights.

FS228-I CCI SEND status checked.

FS229-I Unrecognized CCI session ID - could not disconnect user.

FS230-I User : user-IDuser-name

FS231-S The parameter "nnn" is not numeric.

FS232-I Date : date.

FS233-W Unable to set the maximum amount of dynamic memory to the limit specified.

FS234-W The parameter "text " specifies a memory limit below the minimum of 6 Mbytes allowed.

FS235-W Failure to allocate memory for incomplete CCI SEND processing.

FS236-I The log file name has been removed from the database reference file.

FS237-S The next log file to use filename already exists, unable to back up current log file.

FS237-W The next log file to use filename already exists, unable to back up current log file.

FS238-I Terminating communications with this user.

FS239-I Output - user Record locked. Retry operation.

FS240-I Output - user File locked. Retry operation.

FS241-I Output - user Insufficient log file disk space. Retry operation.

FS243-S Failure backing up the file filename1 to filename2.

FS244-S Failure restoring the backed up file filename1 to filename2.

FS245-S Failure deleting the log file filename.

FS246-I Backing up database files to directory backup directory. Please wait.

FS247-I Restoring database files from directory backup directory. Please wait.

FS248-I Commencing automatic Fileshare Recovery.

FS249-I Restarting Fileshare Server.

FS250-I Deleting all unwanted log files.

FS251-S Logging must be activated for all files when specifying a backup directory.

FS252-S Failure deleting the file filename.

Messages from FS301 - FS400

FS302-S Unable to continue - A log file already exists

Tools

Consolidated Tracing Facility

To enable CTF tracing

CTF Trace File Formats

CTF Viewer

Annotation Files for CTF Events

Bookmarks in the CTF viewer

To create and load a binary trace file into the CTF Viewer

To search in the CTF Viewer

Components Traced by CTF

mf.cci Properties

mf.mffh.fs Properties

mf.mffh.xfh Properties

mf.mffh.xsm Properties

mf.rts Properties

CTF Configuration File

mftrace.application

mftrace.comp.component-name#property

mftrace.dest

mftrace.dest.component-name

mftrace.emitter.emitter-name#property

mftrace.level

mftrace.level.component-name

mftrace.time

Example CTF Configuration Files

CTF Emitter List

BINFILE Emitter Properties

JAVALOGGER Emitter Properties

TEXTFILE Emitter Properties

CTF Tracing Examples

Profiler

Introduction to Profiler

Invoking Profiler from the Command Line

Profiler Output

Time Spent in Called Programs

Directives for Profiler

The cobutf8 Utility

Configuring the cobutf8 Configuration File

Running Your Application Through the cobutf8 Utility

Error Messages

Configuring CCI

CCITCP Configuration

CCI Support For TCP/IP

CCI Support Modules for TCP/IP

TCP/IP Configuration

Running the CCI Configuration Utility

CCI Configuration for UNIX Users

Using CCITCP2

Using Directory Server Instead of CCITCP2

CCITCP2 Search Order

CCITCP2 Troubleshooting

Advanced Features

Using CCI Over TCP/IP Without CCITCP2

Direct Connection and Starting Servers on Fixed Ports

Environment Variables and the CCI.INI File

CCITCP Environment Variables

CCITCP Options in the CCI.INI File

Application Configuration

CCITCP Server Name

CCITCP Machine Name

CCINAMPU Configuration

CCI Support for UNIX Named Pipes (FIFOs)

CCI Support Module for UNIX Named Pipes

Transport Speed

CCI.INI File Options for CCINAMPU

Application Configuration

CCINAMPU Server Name

CCINAMPU Machine Name

Default Service Location

Common Error Status

CCI Tracing

Enabling CCI Tracing

CCITRACE Environment Variable

Tracing Options for CCI.INI

Activating CCI Tracing for Fileshare

CCI.INI - The CCI Configuration File

What is the CCI.INI File?

Where to Locate CCI.INI

The Format of CCI.INI

General Configuration Options for CCI.INI

errlog_path

CCI Status Messages

CCI Message Table

Terminfo Database and Terminal Devices

Overview

System Terminfo

Portable Terminfo for COBOL

COBOL Screen Handling Requirements

Searching Portable and System Terminfo Databases

Terminal Devices

Screen Handling Requirements

Essential Entries

Optional Entries

Highlighting

Performance Considerations

Wide Terminal Mode

Line Drawing

Color

Special Terminal Facilities

Wide Terminal Mode

Terminal Emulators

The Portable Terminfo Utilities mftic and mfinfocmp

Terminfo Compiler (mftic)

Terminfo Lister (mfinfocmp)

Search Sequence

UNIX Key Usage Chart

Notations and Conventions