Sun Logo


Sun Mainframe Transaction Processing Software Administrator's Guide

Release 8.0.1

816-5327-11



Contents

Figures

Tables

Code Samples

Preface

1. Introduction

Sun MTP Server Processes

Sun MTP Client Processes

Local Terminal Client

Sun MTP J3270 Terminal Emulator Client

TN3270 and TN3270E Emulator Clients

IBM 3270 SNA Device Clients

TCP/IP Socket Clients

Secure Sockets Layer Clients

MQSeries Clients

External Call Interface (ECI) and External Presentation Interface (EPI) Clients

Sun MTP Standards

Screen Formats

Function Keys

Data Validation

File Identifiers

Development System

Starting the Development System

procedure iconsmall spaceTo Start the Development System

Menu Options

Supported File Types

Resource Definition Limits

Complementary Components and Products

Third-Party Products

2. System Transactions

Overview of the System Transactions

CBCH - Online Batch Execution

CEBR - Browse Temporary Storage

CECI - Command Interpreter

procedure iconsmall spaceTo Start the CECI Interpreter

Defining and Executing CECI Commands

Commands Screen

Syntax Screen

procedure iconsmall spaceTo Create and Execute a Command

Hexadecimal Display Screen

EIB Screen

Variables Screen

procedure iconsmall spaceTo Add a Variable

procedure iconsmall spaceTo Delete a Variable

procedure iconsmall spaceTo Modify a Variable

Edit Variable Screen

procedure iconsmall spaceTo Edit a Variable

User Screen

Messages Screen

Dynamic Receiver Arguments

Literal Option Arguments

Program Control

Logical Units of Work

CEDA - Manipulate Resources

DEFINE Option

MAPSET Attributes

PROGRAM Attributes

TRANSACTION Attributes

DELETE Option

DISPLAY Option

INSTALL Option

CEDF - Execute Debug Facility

CEMT - Set/Display Status

INQ (I) Option

SET (S) Option

Loading a New Copy of a Resource

Loading a Shared Library or Shared Object

Enabling or Disabling Programs and Transactions

Requesting a Transaction Dump

Terminating Tasks

Managing Transient Data Queues

Controlling 3270 Devices

Controlling Intersystem Connections

Assigning Transaction Processors to Transaction Classes

Setting the System State

PERFORM (P) Option

CINI - Reinitialize Transaction Servers

CRTE - Route Transactions

CSMT - System Termination

CSPG - System Paging

Sign-On/Sign-Off Transactions

CESN - Sign-On

CSSN/CSSF - Sign-On/Off

Customizing the CSSN/CESN Transaction

procedure iconsmall spaceTo Customize a Transaction

3. Managing VSAM Files

VSAM File Organization

Calculating VSAM File Sizes

RRDS Files

ESDS Files

KSDS Files

Managing the VSAM Catalog

Defining VSAM Files in the Catalog Using File Manager

procedure iconsmall spaceTo Define VSAM Files in the Catalog

Modifying File Attributes Using File Manager

procedure iconsmall spaceTo Modify a Cluster

procedure iconsmall spaceTo Retain Data When Modifying a Cluster

Deleting a Cluster

procedure iconsmall spaceTo Delete a Cluster

Creating an Alternate Index

procedure iconsmall spaceTo Create a Catalog Entry With an Alternate Index

procedure iconsmall spaceTo Create an Alternate Index in the FCT

procedure iconsmall spaceTo Build the Alternate Index

Adding Alternate Indexes to an Existing Cluster

procedure iconsmall spaceTo Add Alternate Indexes

Spanned Files

How Sun MTP Divides Data

procedure iconsmall spaceTo Define a Spanned File Using File Manager

Defining Batch Read-locking for a File

Managing the VSAM Catalog Using Utilities

VSAM Catalog ASCII Format

procedure iconsmall spaceTo Create an ASCII Catalog File

procedure iconsmall spaceTo Maintain the VSAM Catalog Using Utilities

Changing the VSAM Block Size of the Catalog

procedure iconsmall spaceTo Change the Block Size of the Catalog

Manipulating VSAM Files

Accessing the Record Editor Functions

procedure iconsmall spaceTo Open the Data File Editor

Building a VSAM File

procedure iconsmall spaceTo Build a VSAM File

Record Processing Routines

Building a Sequential File

procedure iconsmall spaceTo Build a Sequential File

Dumping a VSAM Dataset

procedure iconsmall spaceTo Dump a Dataset

procedure iconsmall spaceTo View a Formatted Dump File

Manipulating VSAM Files With kixfile

Manipulating VSAM Files With unikixbld

Maintaining VSAM File Integrity

Backing Up a Dataset

Restoring a Dataset

Verifying File Integrity

Identifying a Corrupted Dataset

Reorganizing a Dataset

procedure iconsmall spaceTo Reorganize a Dataset

Salvaging a Corrupted Dataset

procedure iconsmall spaceTo Salvage a Corrupted Dataset

Sun MTP Recovery

Recovering From a Transaction Abort

Recovering From a System Crash

How Do Deadlocks Affect Recovery?

Conversational Transactions and Recovery

Maintaining Database Integrity

Maintaining Database Integrity in a Multi-database Environment

Using VSAM File Caching

procedure iconsmall spaceTo Specify Caching for VSAM Files

procedure iconsmall spaceTo Specify Caching for Journal Files

Specifying Cache Writes Dynamically

4. Managing Application Workloads

What Are Transaction Classes?

Setting Up Transaction Classes

procedure iconsmall spaceTo Define Transaction Classes

Assigning Transactions to Classes

procedure iconsmall spaceTo Assign Transactions to a Class

Deleting Transaction Classes

procedure iconsmall spaceTo Delete Transaction Classes Manually

procedure iconsmall spaceTo Delete Transaction Classes Using the .lst File

Monitoring Transaction Classes

procedure iconsmall spaceTo Monitor a Specific Transaction Class

procedure iconsmall spaceTo Monitor All Transaction Classes

Managing Transaction Classes

Restricting the Use of a Transaction Class

Determining When to Reassign Transaction Processors

Managing Background Tasks and Batch Jobs

Managing the KIXDFLT Transaction Class

API Support

5. Editing Records

Starting the Record Editor

procedure iconsmall spaceTo Start the Record Editor

Modifying Records in a Dataset

Adding Records to a Dataset

Deleting Records From a Dataset

procedure iconsmall spaceTo Delete a Record

6. Using Intersystem Communications (ISC)

Transaction Routing

Routing Transactions Using CRTE

Defining Outbound Transaction Routing

procedure iconsmall spaceTo Define a Transaction as Remote

Defining Inbound Transaction Routing

procedure iconsmall spaceTo Define a Terminal as Remote

Function Shipping

Defining Outbound Function Shipping

procedure iconsmall spaceTo Define a Remote File

procedure iconsmall spaceTo Define a Remote Transient Data Queue

procedure iconsmall spaceTo Define Remote Temporary Storage Queues

Defining Inbound Function Shipping

Data Conversion During Function Shipping

Asynchronous Processing

Defining Asynchronous Processing Outbound

procedure iconsmall spaceTo Define a Remote Transaction

Defining Asynchronous Processing Inbound

Distributed Program Link (DPL)

Defining Outbound DPL

procedure iconsmall spaceTo Define a Remote Program

Defining Inbound DPL

procedure iconsmall spaceTo Define Inbound DPL

Distributed Transaction Processing (DTP)

Debugging a Remote Transaction

procedure iconsmall spaceTo Debug a Remote Transaction

procedure iconsmall spaceTo Debug Inbound Transactions

Supporting ISC and 3270 Devices Simultaneously

7. Security

UNIX Security

The Superuser

Users

Logging in to a System

Maintaining User Names and Passwords

File Ownership

Becoming a Different User

Groups

Maintaining Groups

Group Ownership

Changing Groups

File Permissions

Setting Permissions on Files

Setting Permissions on Directories

Default Permissions for New Files

Changing Permissions

set-user-id and set-group-id Modes

Controlling Access at the File System Level

Sun MTP Security

Controlling Sign-on Security

Using CESN/CESF and CSSN/CSSF

Using the SIT

Using the PLT

Using Automatic Sign-on

Authenticating User Names for Predefined TCTs

Communication Paths That Use the Default Security Key

Securing Shell Scripts, Executables, and Files

Changing the State of a User's SNT Entry

Changing the User's Password in the SNT

procedure iconsmall spaceTo Provide a User With a New Password

Changing a User's SNT Status Using Function Calls

Generating Encrypted Passwords From an Application

Administering Transaction Security

Using the SNT and PCT for Transaction Security

Security Key

Triggering the Sun MTP Security Facilities

Managing Automatic Transactions

Security for Sun MTP System Transactions

Security Examples

User Sign-on Security

Group ID Security

CESN or CSSN Transaction

User-supplied Security Transaction

Shell Scripts and Executables Security

Database File Security

Transaction Security

8. Sun MTP Secure

Introduction to External Security Management

Integrating an ESM With Sun MTP

Using Sun MTP Secure

Enabling Sun MTP Secure

Default User Name

Authenticating Preset Terminal User Names

procedure iconsmall spaceTo Configure User Names and Passwords

Communication Paths Requiring Default User Name

Sun MTP Secure Resource Class Types

Using Sun MTP Secure for Transaction and Resource Security

Administering Resource Security

Using the KIX-FILES Resource Class

Using the KIX-COMMANDS Resource Class

Using Point-of-Entry Security

Resource Name Prefixing

ESM Results Logging

Security Access Results Caching

9. Sun Mainframe Security Facility (Sun MSF)

Introduction to Sun MSF

User Profiles

Super Administrator

Security Administrator

Sun MTP User

Integrating Sun MSF With Sun MTP

Setting up the Database for the Security Repository

Setting Up the Security Repository

Using an Oracle Database

procedure iconsmall spaceTo Create the Table Space

procedure iconsmall spaceTo Create User IDs Associated With the Table Space

Using a Sybase Database

procedure iconsmall spaceTo Set Up the Sybase Database

Installing the Sun MSF Software

Installation Guidelines

procedure iconsmall spaceTo Install Sun MSF

Configuring the Sun MSF Software

Modifying the Configuration Files

Configuring the Security Server and Other Security Properties

procedure iconsmall spaceTo Configure the Security Server and Other Aspects of Sun MSF

Setting the Administrator's Environment

procedure iconsmall spaceTo Set the Environment

Managing the Security Log Collection

Starting the Security Log Servers

Shutting Down the Security Log Servers

Changing the Security Log Server Directory

Changing the Security Log Server Files Within the Same Directory

Displaying Security Log Server Information

Initializing the Repository and Creating the Security Administrator

procedure iconsmall spaceTo Create the Security Administrator and Initialize the Repository

Security Management Tasks

Adding a Principal

Adding a Role

Adding a Resource

Adding a Resource Domain

Adding Permissions to Principals and Roles

Adding Multiple Objects to the Repository

procedure iconsmall spaceTo Add Multiple Objects Using the snt.lst File

Committing and Activating Changes to the Security Repository

Listing Objects in the Repository

Deleting Objects From the Repository

Deleting Roles

Deleting Resource Domains

SecAdmin Tool

procedure iconsmall spaceTo Start a SecAdmin Session

SecAdmin Commands

quit

help

listSummary

loadFile

listPrincipals

listPrincipalsWithNoRole

createPrincipal

resetPassword

resetPasswordDuration

modifyExpDate

suspendPrincipal

enablePrincipal

deletePrincipal

setPrimaryRole

listRoles

createRole

deleteRole

setRoleParent

printRoleTree

listResourceDomains

createResourceDomain

deleteResourceDomain

setResourceDomainParent

printDomainTree

listResourceTypes

listResourcesWithNoDomain

createResourceType

deleteResourceType

listResources

createResource

deleteResource

addResourceToDomain

removeResourceFromDomain

addPrincipalPermissions

removePrincipalPermissions

addRolePermissions

removeRolePermissions

listPermissionTypes

createPermissionType

deletePermissionType

commit

rollback

Using Sun MSF

Setting the Region's Environment Variables

Starting the Security Server

Shutting Down the Security Server

Refreshing Security Rules

Displaying Security Server Statistics

User Tasks

Logging Security Events

Sun MSF Examples

procedure iconsmall spaceTo Set the Example Region Environment

Authentication and Authorization Examples

10. Accounting

UNIX Accounting

When to Use a Third-Party Accounting Package

Sun MTP Accounting

Enabling Accounting

procedure iconsmall spaceTo Enable Accounting

Accounting Options

Accounting Journals

Accounting Journal Format

Recovering Accounting Journals

Using the kixjas Accounting Conversion Program

ASCII Record Format

kixjournal Shell Script

Setting Up User Journals

11. Customizing Your Application Environment

Customization Tools

RDBMS User Exit Routines

Function Calls

kxsysinfo

kxtctinfo

kxsetmsg

kxttyinfo

Source Example - kxusrexit.c

kxusrexit.c - Oracle RDBMS Functions

kxusrexit.c - DB2 RDBMS Functions

kxusrexit.c - Sybase RDBMS Functions

User Module Source Examples

Customizing the Conversion Tables

procedure iconsmall spaceTo Modify the Conversion Table File

Customizing the Sockets User Exit

Customizing the SSL User Exit

procedure iconsmall spaceTo Customize the SSL User Exit

Customizing the ISC User Exits

Translation Routine for Transaction Routing

procedure iconsmall spaceTo Copy the Binary Fields

Translation Routine for Other ISC Types

procedure iconsmall spaceTo Modify the User Exit

Terminal Not Found Exit

procedure iconsmall spaceTo Modify the Terminal Not Found Exit

Security User Exit Routines

Security User Exit Functions and Parameters

Validating the User Name and Password Using the SNT

procedure iconsmall spaceTo Create a New Security User Exit Routine

Customizing Record Processing Routines

procedure iconsmall spaceTo Modify an Existing Record Processing Routine

Creating a New Record Processing Routine

procedure iconsmall spaceTo Create a New Record Processing Routine

Recovery Processor User Exit

Recovery Backout Function Calls

Return Code From the Backout Function

Customizing the Recovery Process

procedure iconsmall spaceTo Rebuild the Recovery Processor

Rebuilding Sun MTP Executables

Building Executables Using the make Command

Building All Executables

Building Selected Executables

Binding User-written C Functions

Building or Rebuilding Executables Using kixinstall

procedure iconsmall spaceTo Integrate User-written Modules

procedure iconsmall spaceTo Build a New Online Transaction Server

Building a New Batch COBOL Runtime System

procedure iconsmall spaceTo Build a Standard Batch COBOL Runtime System

procedure iconsmall spaceTo Build a Sun MBM COBOL Runtime System

12. Sun Mainframe Administration Tool (Sun MAT)

Introduction to Sun MAT

Prerequisites

Installation

Installing Sun MAA

procedure iconsmall spaceTo Install Sun MAA

Installing Sun MAT

Installing Sun MAT on Solaris or Other UNIX Systems

procedure iconsmall spaceTo Install Sun MAT on Solaris or Other UNIX System

Installing Sun MAT on Windows Systems

procedure iconsmall spaceTo Install Sun MAT on Windows Systems

Installing Sun MAT on Other Systems

procedure iconsmall spaceTo Install Sun MAT on Other Systems

Configuring and Starting Sun MAA

Deciding on a Port Number

Choosing an Appropriate UserID

procedure iconsmall spaceTo Start Sun MAA

Starting Sun MAT

procedure iconsmall spaceTo Start Sun MAT on Solaris or Other UNIX Systems

procedure iconsmall spaceTo Start Sun MAT on Windows

procedure iconsmall spaceTo Start Sun MAT on Other Systems

Accessing Sun MTP Regions

procedure iconsmall spaceTo Access Sun MTP Regions

Configuring Sun MAT to Access an Agent System

procedure iconsmall spaceTo Access an Agent System

Registering a Region With Sun MAA

procedure iconsmall spaceTo Enable the unikixadmin Server

procedure iconsmall spaceTo Register a Region With Sun MAA

Displaying Region Information

procedure iconsmall spaceTo Display Region Information

A. Modifying Shell Scripts

Modifying Shell Scripts

procedure iconsmall spaceTo Modify a Shell Script

Changing the Default Editor

procedure iconsmall spaceTo Change the Default Editor

B. Date/Time Configuration

Starting the Date/Time Configuration Utility

procedure iconsmall spaceTo Start the Date/Time Configuration Utility

Setting the Sun MTP Startup Date

procedure iconsmall spaceTo Set the Startup Date

Setting the Current Date for Sun MTP and Sun MBM

procedure iconsmall spaceTo Set the Current Date

Displaying the Present Date/Time

procedure iconsmall spaceTo Display the Date and Time

Resetting the Current Date to the System Date

procedure iconsmall spaceTo Reset the Date

Displaying the Help Screen

procedure iconsmall spaceTo Display the Help

Exiting the Date/Time Configuration Utility

procedure iconsmall spaceTo Exit the Utility

Glossary

Index