N E W

D I M E N S I O N

S O F T W A R E

N E W

D I M E N S I O N

S O F T W A R E

RE

L.

5.1

.4

I OA

ADMINISTRATOR

GUIDEI-

51

4G

-A9

90

1A

Copyright 1999 by New Dimension Software Ltd. All rights reserved.

First Edition.

The software described in this document is furnished under a license agreement, and maybe used or copied only in accordance with the terms of the agreement.

All New Dimension Software products are trademarks or registered trademarks of NewDimension Software Ltd. Other brand and product names are trademarks or registeredtrademarks of their respective holders.

The information in this document is subject to change without prior notice and does notrepresent a commitment on the part of New Dimension Software Ltd.

New Dimension Software Ltd. assumes no responsibility for any errors that may appear inthis document.

I-514G-A9901A

20 19 18 17 16 15 14 13 12 11 10 9 8 7 6 5 4 3 2

IOA Rel. 5.1.4 Administrator Guide iii

About This ManualThis guide contains the information necessary for IOA administrators who are responsiblefor customizing and maintaining the IOA family of products.

Basic information about how IOA products operate is provided in user manuals for eachproduct.

Most administration information for each product is found in the section devoted to thatproduct. However, all IOA administrators should read Sections 1 and 2 before continuingwith the rest of this guide. Section 1 contains an overview of the key IOA concepts whichapply to all IOA products. Section 2 describes how to customize the IOA environment.

This guide contains the following sections:

Section 1 IOA Concepts and Components

Overview of the IOA environment and a description of key IOA concepts and components.

Section 2 Customizing and Administering IOA

How to customize and maintain the IOA environment.

Sections 3 to 7 Customizing and Administering CONTROL-x

Information about administrative tasks for each IOA product. Each section includesinformation on the products New Day processing and work flow, as well as informationabout how the relevant product can be used to perform specific tasks. These sections alsoinclude information about the structure of relevant files, operator commands, etc.

Notes CONTROLR is described together with CONTROL-M in Section 3.

CONTROLV is described together with CONTROL-D in Section 4.

Section 8 Maintaining IOA Products

Information about maintaining and updating IOA products.

Section 9 Utilities

Special features designed to help you perform specific tasks. This section contains analphabetized reference guide for all available utilities for each IOA product.

Section 10 Exits

Information on exits available with each IOA product which can be used to modifyoperations.

iv IOA Rel. 5.1.4 Administrator Guide

Section 11 CONTROL-M/WorkLoad

Information about administrative tasks for CONTROL-M/WorkLoad. This section alsoincludes information about the structure of relevant files, operator commands, etc.

Section 12 ECSGATE

Information about implementing and customizing ECSGATE.

Appendix A IOA Application Program Names

Appendix B Dataset Formatting Utilities for IOA Products

Appendix C Modifying IOA Online Facility Commands

Appendix D Logical Field Names for the CONTROL-T Repository

Appendix E IOA Online Options Cross-Reference

Appendix F IOAMEM Module

Appendix G Customizing the CONTROL-M Status Screen

Appendix H CONTROL-O Modify Commands

IOA Rel. 5.1.4 Administrator Guide v

Related Publications

IOA Installation GuideA step-by-step guide to installing IOA products using the IOA Customization andInstallation Engine (ICE) application.

IOA Security GuidesStep-by-step guides to implementing security in IOA products using the IOACustomization and Installation Engine (ICE) application. Security guides are currentlyavailable for IOA interaction with RACF, CA-TOP SECRET and CA-ACF2.

User ManualsProduct-specific manuals containing comprehensive information about the operation andimplementation of each IOA product.

IOA Messages and CodesA comprehensive listing and explanation of all IOA messages and codes.

Information New in This ReleaseInformation which is new in releases 5.0.4 and 5.1.4 is indicated by an update line | in theleft margin of the page.

We Want to Hear From YouIf you have any comments or opinions regarding this publication, we want to hear them.Your feedback will help us improve our documentation to our mutual benefit. Send yourremarks by email to publications@ndsoft.com. Please include the name and versionnumber of the publication in your email.

vi IOA Rel. 5.1.4 Administrator Guide

This page intentionally left blank.

Table of Contents

IOA Rel. 5.1.4 Administrator Guide vii

Table of Contents

Section 1: IOA Concepts and ComponentsIntroduction ..................................................................................................................................1-1

IOA Products .................................................................................................................................1-1

Installation and Maintenance...................................................................................................1-3

Installation and Customization Engine (ICE) ..........................................................................1-3

Product Maintenance .................................................................................................................1-3

Online Facility ..............................................................................................................................1-3

Primary Option Menu ................................................................................................................1-4

Logic................................................................................................................................................1-4

Automated Processing Definitions ............................................................................................1-4

Jobs.........................................................................................................................................1-5

Missions .................................................................................................................................1-5

Rules.......................................................................................................................................1-5

Monitors ......................................................................................................................................1-5

IOA Monitors .........................................................................................................................1-6

Product-Specific Monitors .....................................................................................................1-6

Daily Processing/New Day Processing ......................................................................................1-7

File Management........................................................................................................................1-8

IOA Access Method................................................................................................................1-8

IOA Core ................................................................................................................................1-8

Product Repositories............................................................................................................1-10

IOA and Product PARM Libraries .....................................................................................1-13

Miscellaneous............................................................................................................................1-13

Dynamic Destination Table ................................................................................................1-13

AutoEdit Facility .................................................................................................................1-13

Security Implementation ....................................................................................................1-14

User Exits ............................................................................................................................1-14

Utilities ................................................................................................................................1-14

Simulation............................................................................................................................1-14

Cross-Product Communication ...........................................................................................1-15

Inter-System Communications Facility .............................................................................1-16

Table of Contents

viii IOA Rel. 5.1.4 Administrator Guide

Section 2: IOA AdministrationIntroduction ................................................................................................................................. 2-1

IOA Online Environment........................................................................................................... 2-1

Entering the IOA Online Facility ............................................................................................. 2-2

IOA Online Monitor ................................................................................................................... 2-3

Principles of Operation......................................................................................................... 2-3

Activating the IOA Online Monitor (IOAOMON)............................................................... 2-4

Displaying a List of All Active Users................................................................................... 2-5

Deactivating the IOA Online Monitor ................................................................................. 2-6

Problem Determination ........................................................................................................ 2-6

VTAM Monitor (IOAVMON) ..................................................................................................... 2-7

Activating the VTAM Monitor (IOAVMON) ....................................................................... 2-7

Deactivating the VTAM Monitor ......................................................................................... 2-7

Displaying a List of All Active Users................................................................................... 2-7

Canceling an IOA Online Monitor User .............................................................................. 2-7

Customizing the IOA Online Environment........................................................................... 2-8

Transaction Members ................................................................................................................ 2-8

Program List Members.............................................................................................................. 2-9

Allocation Members ................................................................................................................. 2-10

Modifying IOA Online Facility Commands............................................................................ 2-13

Modifying IOA Online Facility PFKey Definitions................................................................ 2-13

IOA Primary Option Menu...................................................................................................... 2-14

Line Format Display........................................................................................................... 2-14

Box Format Display............................................................................................................ 2-15

Customizing the Menu ....................................................................................................... 2-15

Customizing IOA Screens........................................................................................................ 2-17

Modifying IOA Screens and Constants ............................................................................. 2-17

Constant Blocks .................................................................................................................. 2-19

Recommended Steps for Screen Modification ................................................................... 2-19

Customizing IOA Display Format Members.......................................................................... 2-20

@STYLE............................................................................................................................... 2-21

@HEADER .......................................................................................................................... 2-22

@LINE ................................................................................................................................. 2-22

@FIELD............................................................................................................................... 2-23

@VAL ................................................................................................................................... 2-24

@END .................................................................................................................................. 2-24

@DLM .................................................................................................................................. 2-24

Color, Highlight and Intensity Parameters ...................................................................... 2-25

Table of Contents

IOA Rel. 5.1.4 Administrator Guide ix

Extended Color Support ...........................................................................................................2-26

ISPF Characteristics ...........................................................................................................2-26

IMS/DC and IDMS/DC........................................................................................................2-26

IRMA PC Terminal Emulator Users..................................................................................2-26

Customizing Extended Color Support.....................................................................................2-26

IOA Access Method ................................................................................................................... 2-28

File Structure............................................................................................................................2-28

IOA Access Method Naming Conventions .........................................................................2-29

Files Supported by the IOA Access Method.......................................................................2-30

File Utilities ..............................................................................................................................2-31

File Definition Statements.......................................................................................................2-31

Dual Mirror Image File Support..............................................................................................2-32

Dual Mirror Image File Parameters ..................................................................................2-32

Recovering From a Damaged IOA Access Method File.....................................................2-32

IOA Profiles ................................................................................................................................ 2-33

Profile Members........................................................................................................................2-33

Profile Contents ........................................................................................................................2-34

Considerations for Profile Symbol Lines............................................................................2-35

SHOW Window Filters........................................................................................................2-35

Profile Attribute in the Screen Definition..........................................................................2-36

Saving a Profile....................................................................................................................2-36

Profile Variables .......................................................................................................................2-36

Window Display Variables..................................................................................................2-37

Color Variables ....................................................................................................................2-40

Work Mode Variables ..........................................................................................................2-42

Presentation Mode Variables..............................................................................................2-44

Miscellaneous Variables......................................................................................................2-47

Other Types of Profile Variables ........................................................................................2-48

Modifying IOA Product Defaults........................................................................................... 2-48

Modifying IOA Messages ......................................................................................................... 2-49

Recommended Steps for Message Modification ......................................................................2-50

Dynamic Destination Table .................................................................................................... 2-51

Replacing the Current Dynamic Destination Table ...............................................................2-51

Expanding the IOA Conditions/Resource File (RES) ....................................................... 2-52

Expanding the IOA LOG File (LOG) ..................................................................................... 2-52

Table of Contents

x IOA Rel. 5.1.4 Administrator Guide

Section 3: CONTROL-MGeneral........................................................................................................................................... 3-1

Activating the CONTROL-M Monitor ...................................................................................... 3-1

Shutting Down the CONTROL-M Monitor .............................................................................. 3-1

Starting the CONTROL-M EVENT MANAGER (CMEM) Facility ........................................ 3-2

Shutting Down the CMEM Facility .......................................................................................... 3-2

Replacing an Active CMEM Monitor ........................................................................................ 3-3

Modifying the CONTROL-M Sleeping Interval ..................................................................... 3-3

Refreshing the CONTROL-M Security Cache.......................................................................... 3-4

Refresh Deadline Scheduling and Job Network Dependencies................................................. 3-4

Shift DUE OUT Times for CONTROL-M Jobs ........................................................................ 3-5

Sending a Jobs SYSDATA to a Held Output Class................................................................. 3-5

Accumulating Job Execution Statistics .................................................................................... 3-6

Expanding CONTROL-M Files................................................................................................. 3-7

Expanding the Active Jobs File (CKP) ................................................................................ 3-7

Expanding the CONTROL-M Jobs Dependency Network File (GRF)............................... 3-7

Expanding the CONTROL-M Statistics File (STAT) ......................................................... 3-7

Expanding the IOA Manual Conditions File (NRS) ........................................................... 3-8

CDAM Files ................................................................................................................................ 3-8

Display CONTROL-M Installation Parameters....................................................................... 3-8

Switching from SAPI to PSO support....................................................................................... 3-8

Problem Determination ............................................................................................................. 3-9

Job Ordering via New Day Processing ................................................................................ 3-10

Overview................................................................................................................................... 3-10

Sample New Day Processing................................................................................................... 3-12

How the Sample Components Perform New Day Processing .......................................... 3-13

Date Control Records and Enhanced Daily Checkpointing .................................................. 3-15

Implementing New Day Processing........................................................................................ 3-16

Programs Called During New Day Processing ...................................................................... 3-23

Use of the Date Control Record by User Daily Jobs .............................................................. 3-25

New Day Procedure Flow ........................................................................................................ 3-27

Considerations for Job Ordering and Submission ................................................................. 3-28

Library Compression .......................................................................................................... 3-28

JCL Parameter MSGLEVEL ............................................................................................. 3-28

Comment Lines Added During Job Submission ............................................................... 3-28

End User Job Order Interface Defining Job Lists for Each User ...................................... 3-29

TSO User ID Masking ........................................................................................................ 3-29

CONNECT DIRECT Support.................................................................................................. 3-30

Table of Contents

IOA Rel. 5.1.4 Administrator Guide xi

Activation of Started Tasks .................................................................................................... 3-32

Daylight Savings Time Considerations ............................................................................... 3-32

Advancing the Clock Forward .................................................................................................3-32

New Day Procedure.............................................................................................................3-33

Time-Dependent Shouts......................................................................................................3-33

Time-Dependent Schedules (FROM-UNTIL) ....................................................................3-33

Cyclic Jobs............................................................................................................................3-33

IOA Log File.........................................................................................................................3-33

Moving the Clock Backwards...................................................................................................3-34

New Day Procedure.............................................................................................................3-34

Time-Dependent Shouts......................................................................................................3-34

Time-Dependent Schedules (FROM-UNTIL) ....................................................................3-34

Cyclic Jobs............................................................................................................................3-34

IOA Log File.........................................................................................................................3-34

Managing the CMEM Facility ................................................................................................ 3-35

Automatic Loading of Rules.....................................................................................................3-35

Deleting (Deactivating) an Active Rule Table ........................................................................3-37

Displaying Active Rules ...........................................................................................................3-37

Controlling CMEM Rule Operation Mode...............................................................................3-38

Modifying the CMEM Sleeping Interval .................................................................................3-38

Refreshing the CMEM Security Cache ...................................................................................3-39

Virtual Storage Requirements of the CMEM Monitor ...........................................................3-39

Calculating Region Size ......................................................................................................3-39

Troubleshooting ...................................................................................................................3-40

Storage Allocation................................................................................................................3-40

CMEM Usage of the Common Storage Area (E/CSA) ............................................................3-41

Extended CSA Usage (Above 16M Line)............................................................................3-41

CSA Usage (Below the 16M Line) ......................................................................................3-41

CMEM CONTROL-M Communication ................................................................................3-42

Coupling Facility and Coupling Facility Resource Management .....................................3-42

MVS System Logger Sysplex Interface ..............................................................................3-43

Problem Determination.......................................................................................................3-43

CONTROL-M Tuning Recommendations ............................................................................ 3-45

General Tuning Issues .............................................................................................................3-45

Placing the IOA LOAD Library in the MVS Linklist (MVS/XA Sites).............................3-45

Placing CONTROL-M/IOA Files on Appropriate Disk Packs...........................................3-46

Placing Certain CONTROL-M/IOA Files on Special Disk Devices ..................................3-46

Enlarging CONTROL-M/IOA File Blocksize .....................................................................3-47

CONTROL-M Monitor and MVS/JES Considerations ...........................................................3-48

Table of Contents

xii IOA Rel. 5.1.4 Administrator Guide

Special Considerations ....................................................................................................... 3-48

Run CONTROL-M on the Global Processor in a JES3 Complex ..................................... 3-49

Run CONTROL-M on the CPU Where Most JES2 Activity is Performed......................... 3-50

JES2PARM Tuning Considerations .................................................................................. 3-50

Assign Appropriate Priority to the CONTROL-M Monitor ................................................... 3-51

Run the CONTROL-M Monitor as Non-swappable .......................................................... 3-51

Choose an Appropriate Sleeping Interval ......................................................................... 3-51

Storage Isolation ................................................................................................................. 3-52

Tuning the Online Facility ...................................................................................................... 3-53

Preallocate Required CONTROL-M/IOA Files in TSO Logon Procedures ........................... 3-53

Try to Eliminate TSO STEPLIBs ...................................................................................... 3-53

Use the IOA Server Mechanism When Required ............................................................. 3-53

Mirror File (Dual Checkpointing Mode) Considerations....................................................... 3-53

CONTROL-M Event Manager (CMEM) Considerations....................................................... 3-54

CONTROL-M Optional Wishes............................................................................................... 3-54

CONTROL-M Multi-CPU Support.......................................................................................... 3-54

Introduction.............................................................................................................................. 3-54

Single-CPU Configuration with Multiple CONTROL-M Systems .................................. 3-56

Multi-CPU Configuration........................................................................................................ 3-57

Shared-Spool Configuration With an ENQ-Handling Product ..................................... 3-57

Shared Spool Configuration Without an ENQ-Handling Product................................ 3-60

Shared-Spool Configuration with Multiple CONTROL-M Production Systems............. 3-61

Multi-CPU Configuration With Shared-DASD Only........................................................ 3-63

NJE Network of MVS Nodes.............................................................................................. 3-64

Special Considerations ............................................................................................................ 3-66

Mainframe with PR/SM (or MDF or MLPF) ..................................................................... 3-66

Operating MVS System(s) Under VM ............................................................................... 3-67

Support of Other Platforms (VM, DOS/VSE, AS/400, DEC, HP, etc.)............................. 3-67

Support of Network Software............................................................................................. 3-69

CONTROL-M VM Support ....................................................................................................... 3-71

Introduction.............................................................................................................................. 3-71

VM Configurations................................................................................................................... 3-71

MVS Running Under VM........................................................................................................ 3-72

MVS and VM Running on Separate Computers .................................................................... 3-73

MVS and VM Running Under PR/SM, MDF or MLPF ......................................................... 3-74

Invoking the IOA Online Facility From a VM Terminal....................................................... 3-74

Dialing Into the MVS Machine (MVS Under VM Only)........................................................ 3-75

Using VM/VTAM...................................................................................................................... 3-75

Using IOAs Logical Terminal Emulator................................................................................ 3-75

Table of Contents

IOA Rel. 5.1.4 Administrator Guide xiii

Using a Session Handling Product ..........................................................................................3-75

File Transfer From MVS to VM...............................................................................................3-75

General.................................................................................................................................3-75

Routing the Production Jobs Report to VM via JCL ........................................................3-76

Routing Production Job Sysout to VM via JCL .................................................................3-76

Routing Production Job Sysout to VM via CONTROL-M Sysout Functions.........................3-77

Sending a File to VM in the Form of a Sysout...................................................................3-77

File Transfer Products..............................................................................................................3-77

Utilize a Shared Disk Between MVS and VM ........................................................................3-78

Triggering an Event in CONTROL-M by a VM User.............................................................3-78

Submitting a Job to MVS to Execute a CONTROL-M Utility ..........................................3-78

Submitting a Job to MVS to be Monitored by CMEM.......................................................3-78

CONTROL-M Triggering of Events in VM .............................................................................3-79

Issuing a VM CP Command via IOAOPR (MVS Under VM only) ...................................3-80

Executing VM Commands via the IOAVAUTO Machine .................................................3-81

Issuing a SHOUT Message to a VM User ...............................................................................3-82

General.................................................................................................................................3-82

Using Utility IOAOPR ........................................................................................................3-83

Using the VM IOAVAUTO Machine ..................................................................................3-83

Other IOA Options ..............................................................................................................3-83

IOA An Integrated Solution..................................................................................................3-83

General.................................................................................................................................3-83

CONTROL-O .......................................................................................................................3-84

CONTROL-O/PC .................................................................................................................3-84

CONTROL-D .......................................................................................................................3-84

Disaster Recovery Planning................................................................................................... 3-85

Overview ...................................................................................................................................3-85

Recovery Tools ..........................................................................................................................3-85

Dual Checkpoint Mode........................................................................................................3-85

Journaling............................................................................................................................3-86

Restoration...........................................................................................................................3-87

Planning and Creating a Disaster Recovery Plan ..................................................................3-88

MVS, JES, Exits and Other Definitions.............................................................................3-88

Security Considerations ......................................................................................................3-88

Scheduling Libraries and Other Production Libraries......................................................3-88

Backup Procedures..............................................................................................................3-89

CONTROL-M Parameter Definitions.................................................................................3-89

Catalog Considerations .......................................................................................................3-90

Defining an Authorized TSO User .....................................................................................3-90

Table of Contents

xiv IOA Rel. 5.1.4 Administrator Guide

Problem Resolution.................................................................................................................. 3-90

General ................................................................................................................................ 3-90

AutoEdit Simulation Facility ............................................................................................. 3-92

Disaster Relocation............................................................................................................. 3-93

Manual Recovery Procedures............................................................................................. 3-94

Automatic Recovery after a System Crash........................................................................ 3-95

Section 4: CONTROL-D and CONTROL-VGeneral........................................................................................................................................... 4-1

Activating the CONTROL-D Monitor....................................................................................... 4-1

Activating Generic Processing .................................................................................................. 4-1

Activating the Compressed Dataset Access Method................................................................ 4-2

Activating the IOA Archive Server (CONTROL-V) ................................................................. 4-2

Modifying the CONTROL-D Sleeping Interval........................................................................ 4-2

Loading the Recipient Tree ....................................................................................................... 4-3

Loading the Recipient Tree into the CONTROL-D Monitor .............................................. 4-3

Loading the Recipient Tree into the IOA Online Monitor.................................................. 4-3

Loading the Recipient Tree into CONTROL-D Application Server................................... 4-4

Loading the Recipient Tree into File Transfer Monitor ..................................................... 4-4

Reloading the Manual Conditions File ..................................................................................... 4-4

Deactivating the CONTROL-D Monitor................................................................................... 4-4

Deactivating Generic Processing .............................................................................................. 4-5

Automatic Warning .............................................................................................................. 4-5

Deactivating the Compressed Dataset Access Method............................................................ 4-5

Deactivating the IOA Archive Server (CONTROL-V) ............................................................. 4-6

CONTROL-D/Decollation Server Integration .......................................................................... 4-6

New Day Processing ................................................................................................................... 4-6

Overview..................................................................................................................................... 4-6

Starting the New Day Procedure.............................................................................................. 4-7

New Day Procedure Workflow .................................................................................................. 4-7

User Daily Job............................................................................................................................ 4-8

Date Control Record .................................................................................................................. 4-8

Use of the Date Control Record by the User Daily Job ...................................................... 4-9

Use of the Date Control Record by the New Day Procedure ............................................ 4-10

Programs Called During New Day Processing ...................................................................... 4-10

Parameters of the New Day Procedure .................................................................................. 4-12

Mission Scheduling ................................................................................................................... 4-13

Overview................................................................................................................................... 4-13

Table of Contents

IOA Rel. 5.1.4 Administrator Guide xv

Scheduling Methods .................................................................................................................4-13

Scheduling Missions Via the New Day Procedure (CTDNDAY) ................................................4-14

Supplied Mission List Members .........................................................................................4-15

Scheduling Missions Via a User Daily Procedure ..................................................................4-16

Scheduling a Mission Manually...............................................................................................4-16

Scheduling Workflow................................................................................................................4-17

Decollation Mission Management......................................................................................... 4-19

Overview ...................................................................................................................................4-19

Generic Decollating Missions...................................................................................................4-19

Generic Decollating Mission Workflow ..............................................................................4-19

Additional Considerations ..................................................................................................4-20

Scheduling Generic Decollating Missions Via the New Day Procedure...........................4-21

Controlling the Generic Process .........................................................................................4-21

Defining a Generic User Name List ...................................................................................4-22

Interfaces to Production Control Systems...............................................................................4-22

Overview of CONTROL-M Scheduling With CONTROL-D .............................................4-23

Job-Report Dependency ......................................................................................................4-25

Scheduling via the CONTROL-M Production Control System.........................................4-25

Scheduling via a Non-CONTROL-M Production Control System....................................4-27

Considerations for When CONTROL-M and CONTROL-D Are Installed.......................4-29

Printing Mission Management............................................................................................... 4-30

Printing Mission Workflow ......................................................................................................4-31

Printing Mission Definition ................................................................................................4-31

Preparing the Skeleton .......................................................................................................4-33

Advanced Scheduling Issues....................................................................................................4-34

Distribution According to Scheduling Dates......................................................................4-34

Report Decollating and Printing Mission Dependency .....................................................4-35

Printer Control..........................................................................................................................4-35

One-Chunk Method .............................................................................................................4-35

Multi-Chunk Method...........................................................................................................4-36

One-Outgroup Method (JES2 Only)...................................................................................4-37

Opening/Closing Printers....................................................................................................4-37

Printing Process...................................................................................................................4-38

Identifying CONTROL-D Chunks on Spool (JES2 Only) ......................................................4-39

CONTROL-D/Writer Facility...................................................................................................4-40

Activating the CONTROL-D/Writer Facility.....................................................................4-40

Printing on AFP (APA) Printers ..............................................................................................4-42

Using CDAM PAGEDEF/FORMDEF Parameters ............................................................4-43

Using a Specified OUTPUT Statement..............................................................................4-43

Table of Contents

xvi IOA Rel. 5.1.4 Administrator Guide

AFP Page Mode Output...................................................................................................... 4-44

Page Markers Under AFP.................................................................................................. 4-44

In-Stream AFP Control Statements .................................................................................. 4-44

Printing Using XEROX LCDS (DJDE) Parameters .............................................................. 4-46

Using OUTPARMS for Global Control of Printing Characteristics ................................................ 4-48

Printing to a File...................................................................................................................... 4-49

Tailoring Exit CTDX005..................................................................................................... 4-50

Advanced ACIF Interface Facility......................................................................................... 4-52

ACIF Utility Benefits............................................................................................................... 4-52

Making ACIF Accessible to CONTROL-D.............................................................................. 4-53

Activating the Advanced ACIF Interface ............................................................................... 4-53

ACIF Execution Parameters .............................................................................................. 4-53

ACIFPARM Library............................................................................................................ 4-54

WYSIWYG Viewing of XEROX Reports................................................................................. 4-56

Overview................................................................................................................................... 4-56

Initial Preparations ................................................................................................................. 4-56

Processing XEROX Reports..................................................................................................... 4-56

Parameters for the DVS Printer Emulator ............................................................................ 4-57

Activating the DVS Printer Emulator............................................................................... 4-57

CCIFPARM Library................................................................................................................. 4-57

Page On Demand ....................................................................................................................... 4-59

Introduction.............................................................................................................................. 4-59

Page On Demand Components ............................................................................................... 4-59

Viewing AFP/CCIF Reports Under Page On Demand .......................................................... 4-61

Preparation for AFP Reports ............................................................................................. 4-61

Preparation for CCIF Reports............................................................................................ 4-61

Parameter STORE of Printing Mission Definition ........................................................... 4-62

Starting Page On Demand on the Mainframe ....................................................................... 4-63

Displaying a List of All Active Users................................................................................. 4-63

Displaying Active Application Server Address Spaces..................................................... 4-64

Reloading the Recipient Tree............................................................................................. 4-64

Problem Determination ........................................................................................................... 4-64

Mainframe PC File Transfer ................................................................................................ 4-65

File Transfer Monitor .............................................................................................................. 4-65

File Transfer Protocols ............................................................................................................ 4-65

File Transfer Process ............................................................................................................... 4-65

Activating and Stopping the File Transfer Monitor ......................................................... 4-66

Reawakening the File Transfer Monitor ........................................................................... 4-66

Reloading the Recipient Tree............................................................................................. 4-66

Table of Contents

IOA Rel. 5.1.4 Administrator Guide xvii

File Transfer Monitor Parameters .....................................................................................4-66

CONTROL-D/Image................................................................................................................... 4-67

Sample Files..............................................................................................................................4-67

Implementing CONTROL-D/Image.........................................................................................4-68

Packing and Transferring CONTROL-D/Image Files............................................................4-68

Decollating and Indexing CONTROL-D/Image Files .............................................................4-68

Viewing CONTROL-D/Image Files .........................................................................................4-70

Backup Mission Management ................................................................................................ 4-71

Overview ...................................................................................................................................4-71

Advanced Scheduling Issues....................................................................................................4-71

Backup According to Scheduling Dates .............................................................................4-71

Report Decollating and Backup Mission Dependency.......................................................4-72

Backup Mission Workflow........................................................................................................4-73

Exception Handling.............................................................................................................4-75

Changing the Backup Mission Retention Period....................................................................4-75

Backup Mission Considerations...............................................................................................4-76

Restore Mission Management ................................................................................................ 4-77

Overview ...................................................................................................................................4-77

Advanced Scheduling Issues....................................................................................................4-77

Restoring According to Scheduling Dates..........................................................................4-77

Restore Mission Workflow........................................................................................................4-78

Exception Handling.............................................................................................................4-81

Restoring With the Original Backup Utility......................................................................4-81

Migration Mission Management (CONTROL-V Only) ...................................................... 4-82

Overview ...................................................................................................................................4-82

Migrating Reports.....................................................................................................................4-82

Multi-stage Migration ..............................................................................................................4-83

Migration Mission Report Correspondence .........................................................................4-83

MIG and MSM Migration Types..............................................................................................4-83

Scheduling Criteria ..................................................................................................................4-84

Primary and Secondary Migration ..........................................................................................4-84

Migration Mission Skeleton Jobs.............................................................................................4-85

Sample Skeleton Job ...........................................................................................................4-86

Target Media Types..................................................................................................................4-88

Migration to Cartridge (CART) ..........................................................................................4-88

Migration to ROSs/OSS.......................................................................................................4-88

Migration to Disk, Fat-DASD, and IBM 3995 Optical Library Dataserver (in 3390Emulation Mode) .................................................................................................................4-89

Migration to FileTek Storage Machine ..............................................................................4-89

Table of Contents

xviii IOA Rel. 5.1.4 Administrator Guide

Migration to OAM............................................................................................................... 4-90

Naming Conventions ............................................................................................................... 4-91

CDAM Datasets .................................................................................................................. 4-91

Indexes ................................................................................................................................ 4-92

Migration Mission Workflow................................................................................................... 4-93

Example: Multi-stage Migration Mission Workflow......................................................... 4-95

Exception Handling ................................................................................................................. 4-97

Job Archiving ............................................................................................................................. 4-98

IOA Archive Server ................................................................................................................. 4-100

General ................................................................................................................................... 4-100

Device Definition and Usage................................................................................................. 4-100

Cartridge (CART) Media .................................................................................................. 4-100

DataWare/ROSs/OSS Usage ............................................................................................ 4-101

Updating the OSS Database ............................................................................................ 4-101

FileTek Storage Machine Media Definition .................................................................... 4-102

Object Access Method (OAM) Usage ............................................................................... 4-103

Media and Resource Control ................................................................................................. 4-103

Media Control ................................................................................................................... 4-103

Resource Control............................................................................................................... 4-103

ROSs/OSS Media DataWare/ROSs/OSS Storage Subsystem...................................... 4-104

CART Media 3480/3490/3490E/3590 Tape Cartridge Subsystem............................... 4-104

FTK FileTek Storage Machine (SM) or OAM Object Access Method Media........... 4-105

Logical Device Status ....................................................................................................... 4-105

Reducing/Increasing the Number of Usable Devices...................................................... 4-106

Displaying Media Information .............................................................................................. 4-107

Problem Determination ......................................................................................................... 4-108

User Report List File Management..................................................................................... 4-109

Overview................................................................................................................................. 4-109

Permanent User Report List File.......................................................................................... 4-110

Active User Report List File.................................................................................................. 4-112

Migrated User Report List File............................................................................................. 4-113

History User Report List File................................................................................................ 4-113

User Report List File Maintenance ...................................................................................... 4-115

Repository Maintenance........................................................................................................ 4-116

General ................................................................................................................................... 4-116

Expanding the Active Missions File ..................................................................................... 4-116

Expanding the Active Transfer File ..................................................................................... 4-117

User Report List File Housekeeping..................................................................................... 4-117

Reorganizing the Files...................................................................................................... 4-118

Table of Contents

IOA Rel. 5.1.4 Administrator Guide xix

Dynamic Sorting of the Active User Report List File......................................................4-118

Rebuilding the Index Component.....................................................................................4-119

Recovering a Damaged File ..............................................................................................4-119

SMF Accounting ...................................................................................................................... 4-120

Section 5: CONTROL-OGeneral ...........................................................................................................................................5-1

Starting CONTROL-O................................................................................................................5-1

Shutting Down CONTROL-O ....................................................................................................5-2

Replacing an Active CONTROL-O Monitor ..............................................................................5-2

Replacing the Active CONTROL-O Executor Module (CTOWTO).....................................5-2

Replacing the Active CMEM Executor Module (CTOAIDT)...............................................5-2

Rule Types...................................................................................................................................5-3

Automatic Loading of Rules.......................................................................................................5-4

Manual Loading of Rules ...........................................................................................................5-5

Manual Loading of CMEM Rules ..............................................................................................5-6

Deleting (Deactivating) an Active Rule Table ..........................................................................5-7

Rule Loading Errors Related to Type of Table..........................................................................5-7

Virtual Storage Requirements of the CONTROL-O Monitor.............................................5-9

Calculating Region Size .............................................................................................................5-9

Troubleshooting ........................................................................................................................5-10

Storage Allocation.....................................................................................................................5-10

Structure of the IOA Conditions/Resources File.....................................................................5-10

CONTROL-O Usage of the Common Storage Area (E/CSA)............................................. 5-11

Extended CSA Usage (Above the 16M Line)...........................................................................5-11

CSA Usage (Below the 16M Line)............................................................................................5-11

Recommended Organization Method................................................................................... 5-12

Replacing the IPL CONTROL-O .............................................................................................5-14

Rule Scheduling........................................................................................................................5-15

Displaying Active Rules ......................................................................................................5-15

Management of CONTROL-O Facilities............................................................................... 5-16

Controlling the Message Statistics Facility ............................................................................5-16

Preventing Unnecessary Enlargement of Statistics Files.................................................5-17

Handling Near-Full and Full Conditions for the Statistics File.......................................5-17

Controlling the Automation Log Facility ................................................................................5-18

Determining the Size of the Log .........................................................................................5-18

Preventing Logging of Unnecessary Messages..................................................................5-19

Management of the CONTROL-O Status Monitoring System (COSMOS)...........................5-19

Table of Contents

xx IOA Rel. 5.1.4 Administrator Guide

Controlling Rule Operation Mode........................................................................................... 5-20

Controlling OpenEdition (UNIX for MVS) Support............................................................... 5-21

Global AutoEdit Variables ...................................................................................................... 5-23

Defining a New Global Member or Variable Database .................................................... 5-25

Automatic Compression of the Global AutoEdit Library ................................................. 5-27

Modifying the CONTROL-O Sleeping Interval...................................................................... 5-28

Refreshing the CONTROL-O Security Cache ........................................................................ 5-29

Problem Determination ........................................................................................................... 5-30

Customization of Automation Options................................................................................. 5-34

AOP Overview.......................................................................................................................... 5-34

Menus ....................................................................................................................................... 5-35

Menu Member Syntax ........................................................................................................ 5-35

Parameters.......................................................................................................................... 5-35

Format Members...................................................................................................................... 5-39

Client Programs....................................................................................................................... 5-39

Program Input.......................................................................................................................... 5-40

Execution Process .................................................................................................................... 5-40

Client Program Linkage Conventions .................................................................................... 5-40

Considerations for When CONTROL-M and CONTROL-O Are Installed..................... 5-41

CONTROL-O/CICS Interface .................................................................................................. 5-42

CONTROL-O Interface for the CICS Environment............................................................... 5-42

CONTROL-O/IMS Interface..................................................................................................... 5-43

Operating the CONTROL-O/IMS Interface ........................................................................... 5-43

CONTROL-O/IMS Commands................................................................................................ 5-43

Starting CONTROL-O Communication Support (CTOGATE)............................................... 5-44

Displaying a List of All Active Users...................................................................................... 5-44

Problem Determination ........................................................................................................... 5-44

Table of Contents

IOA Rel. 5.1.4 Administrator Guide xxi

Section 6: CONTROL-BGeneral ...........................................................................................................................................6-1

CONTROL-B New Day Procedure............................................................................................6-1

Reformatting the Active Balancing File Utility CTBFRM....................................................6-2

Scheduling Balancing Missions .................................................................................................6-2

Date Control Record ...................................................................................................................6-2

Format of the Date Control Record ...........................................................................................6-3

Use of the Date Control Record by the New Day Procedure....................................................6-3

Invoking CONTROL-B (Runtime Environment) ..................................................................6-5

Passing Arguments While Invoking CONTROL-B ..................................................................6-5

Invoking CONTROL-B Via a Direct Call ..................................................................................6-7

Invoking CONTROL-B From a Job Step or Application Program ..........................................6-8

Invoking CONTROL-B by CONTROL-M..................................................................................6-9

Invoking CONTROL-B by CONTROL-D ..................................................................................6-9

Invoking CONTROL-B With Balancing Missions ..................................................................6-10

Section 7: CONTROL-TGeneral ...........................................................................................................................................7-1

CONTROL-T Real-Time Environment ....................................................................................7-2

Initialization ...............................................................................................................................7-2

Procedure CTTINIT....................................................................................................................7-3

Loading of Rules .........................................................................................................................7-6

Termination ................................................................................................................................7-6

New Day Procedure.....................................................................................................................7-7

New Day Functions ....................................................................................................................7-7

New Day Processing ..............................................................................................................7-7

Repository Structure...................................................................................................................7-9

Media Database Structure .........................................................................................................7-9

Data File Contents ..............................................................................................................7-10

Fields in the Data File.........................................................................................................7-11

Index File Contents .............................................................................................................7-12

Structure of the Trace File.......................................................................................................7-17

Structure of the Stacking Database ........................................................................................7-18

Repository Maintenance ......................................................................................................... 7-19

Verifying Data Integrity of Media Databases.........................................................................7-19

Manual Update of the Media Database...................................................................................7-21

Enlarging the Media Database................................................................................................7-21

Table of Contents

xxii IOA Rel. 5.1.4 Administrator Guide

Enlarging the Trace File ......................................................................................................... 7-22

Enlarging the Stacking Database........................................................................................... 7-24

Repository Backup and Recovery......................................................................................... 7-25

General ..................................................................................................................................... 7-25

Media Database Backup.......................................................................................................... 7-25

Media Database Recovery ....................................................................................................... 7-25

Disaster Recovery .................................................................................................................... 7-26

Selective Recovery.................................................................................................................... 7-27

Cartridge Message Display Customization......................................................................... 7-27

CONTROL-R Support for CONTROL-T................................................................................ 7-29

CONTROL-R Driver Exit CTRX001G .................................................................................... 7-29

Installing the CONTROL-R Interface .................................................................................... 7-29

CONTROL-T Application Programming Interface ........................................................... 7-30

Background Information......................................................................................................... 7-31

CONTROL-T Control Table (TCT).......................................................................................... 7-31

Creating a Local TCT .............................................................................................................. 7-32

Obtaining the Address of the Real-Time TCT........................................................................ 7-33

Media Database Structure ...................................................................................................... 7-34

Base Level vs. High Level API ................................................................................................ 7-34

Base Level API ........................................................................................................................... 7-35

Record Access by the Base Level API ..................................................................................... 7-35

Macro CTTIOS ......................................................................................................................... 7-36

Base Level API Access of the Media Database....................................................................... 7-40

Examples for Base Level API.................................................................................................. 7-42

Macro CTTACCDB .................................................................................................................. 7-54

Macro CTTCHKDB.................................................................................................................. 7-55

Media Database Error Handling Routine .............................................................................. 7-56

Example for High Level API ................................................................................................... 7-57

Input ......................................................................................................................................... 7-61

Output ...................................................................................................................................... 7-61

Invoking the Rule Search API................................................................................................. 7-63

Sample Call to the Rule Search API.................................................................................. 7-64

Return Codes....................................................................................................................... 7-64

Sample For Using the Rule Search API ................................................................................. 7-65

Table of Contents

IOA Rel. 5.1.4 Administrator Guide xxiii

Section 8: Maintaining IOA ProductsIntroduction ..................................................................................................................................8-1

IOA Release 5.1.4 Packaging .....................................................................................................8-1

Product Packaging......................................................................................................................8-1

Language Support ......................................................................................................................8-2

Applying Periodic Maintenance...............................................................................................8-4

Preliminary Steps.......................................................................................................................8-4

Installation Steps........................................................................................................................8-4

Step 1 Apply Periodic Maintenance ....................................................................................8-4

Applying Ad Hoc Maintenance .................................................................................................8-5

Introduction ................................................................................................................................8-5

Installation Steps........................................................................................................................8-5

Step 1 Run SMP/E to RECEIVE, APPLY CHECK and APPLY the Fix ...........................8-5

Step 2 Customize and Propagate Fix Elements to Working Libraries..............................8-7

Processing Elements with DEFPARMx Members or a SYSLIB Library of GENERAL....8-9

Step 3 Enable Fixes Applied to ICE ..................................................................................8-11

Step 4 Copy JCL Procedures and ISPF Elements to System Libraries (Optional) ........8-11

Section 9: UtilitiesGeneral ...........................................................................................................................................9-1

Summary of Utilities ...................................................................................................................9-1

IOA Utilities................................................................................................................................9-1

CONTROL-M Utilities ...............................................................................................................9-2

CONTROL-D/V Utilities ............................................................................................................9-3

CONTROL-O Utilities................................................................................................................9-4

CONTROL-B Utilities ................................................................................................................9-4

CONTROL-T Utilities ................................................................................................................9-5

IOA Utilities...................................................................................................................................9-7

IOABLCAL Build Calendars ..................................................................................................9-7

IOACLRES Clean IOA Conditions/Resources File ..............................................................9-13

IOACND Perform IOA Condition/Resource Adjustments...................................................9-16

IOACOPRS Copy/Resize IOA Conditions/Resources File ...................................................9-20

IOACPLOG Copy the IOA Log File ......................................................................................9-21

IOADBF Allocate/Format an IOA Access Method File........................................................9-23

IOADBSR Sort Records in an IOA Access Method Data Component ................................9-31

IOADCPY Recover an IOA Access Method File...................................................................9-33

IOADIG Verify Integrity of an IOA Access Method File Data Component........................9-35

Table of Contents

xxiv IOA Rel. 5.1.4 Administrator Guide

IOADII Verify Integrity of an IOA Access Method File Index Component....................... 9-36

IOADLD Load IOA Access Method File Contents .............................................................. 9-37

IOADPT Print IOA Access Method File Content................................................................ 9-39

IOADUL Unload IOA Access Method File Contents .......................................................... 9-40

IOAFRLOG Allocate and Format the IOA Log File............................................................ 9-42

IOAFRNRS Allocate and Format the IOA Manual Conditions File.................................. 9-43

IOAFRRES Allocate and Format the IOA Conditions/Resources File .................................... 9-44

IOALDNRS Load IOA Manual Conditions File .................................................................. 9-46

IOANOTE Write a Message to the IOA Log File ................................................................ 9-49

IOAOPR - Issue Operator Commands Via a Job or STC....................................................... 9-50

IOATEST Simulate Production Environment Events........................................................ 9-51

IOAVERFY Verify IOA File Installation and Status ......................................................... 9-53

CONTROL-M Utilities............................................................................................................... 9-59

CTMBGRP Convert Regular Scheduling Tables to Group Scheduling Tables ................. 9-59

CTMCAJF Maintain the Active Jobs File or History File.................................................. 9-62

CTMFRCKP Allocate and Format the Active Jobs File ..................................................... 9-68

CTMFRJNL Allocate and Format the Journal File............................................................ 9-69

CTMJSA Job Statistics Accumulation................................................................................. 9-70

CTMRSTR Restore the CONTROL-M Active Jobs File...................................................... 9-73

CONTROL-B Utilities ...................................................................................................