RO Reference Guide(v11r35m1)€¦ · T ABLE OF C ONTENTS © 2013 Mantissa Corporation. All rights reserved. 5 RO_Reference_Guide(v11r35m1)TOC.fm: Revised Sunday, November 24, 2013

RM

S/O

nlin

e —

Tec

hnic

al R

efer

ence

V11.35

RMS™ is a software product of Mantissa Corporation. All rights are reserved. Reproduction of, use of, or distribution of, this documentation is prohibited unless written consent is obtained from Mantissa Corporation. This document contains proprietary information and is intended for use only by licensees and those evaluating potential use of RMS in their respective operating environment.

ADMS, Advanced Datacenter Management Solutions, AOM, Advanced Output Management, ASO, Advanced Systems Operation, RMS/Spool, RMS/DeskTop and Mantissa Directions are trademarks of Mantissa Corporation.

Mantissa, the Mantissa logo, THE REPORT MANAGEMENT SYSTEM, RMS, RDMS, QSERV, RMS/ONLINE, RDMS/SOFTCOPY, RMS/DESKTOP, OPS/MASTER, JOB/MASTER, RUN/MASTER, and CONSOLE/MASTER are registered trademarks of Mantissa Corporation.

All other company and product names are trademarks or registered trademarks of their respective companies and should be treated as such.

Copyright © Mantissa, Corporation 1983-2013

Publication InformationPublication Name: RMS System Reference ManualPublication Number: 0013.00aRMS Release: 11.35Original Publication Date: September, 1997P/N: RMS012

Revised: Sunday, November 24, 2013

ON

TEN

TS

RO

_Ref

eren

ce_G

uide

(v11

r35m

1)TO

C.fm

: Rev

ised

Sun

day,

Nov

embe

r 24,

201

3RMS/Online® Version 11.35 Table of Contents: The Report Management System

System Reference Guide

Table of Contents

TAB

LE O

F C

Chapter 1THE REPORT MANAGEMENT SYSTEM

Introduction .................................................................................................................................... 25Historical Perspective on Report Management Systems ............................................................................25High Performance RMS Characteristics .....................................................................................................26Functional Component Capabilities ............................................................................................................27

RMS/Online ..........................................................................................................................................27RMS/Spool ...........................................................................................................................................27RMS/DeskTop ......................................................................................................................................29

RMS/DeskTop Makes Reports Useful ..........................................................................................29RMS Architecture .......................................................................................................................................31

What is the repository? .........................................................................................................................31What are the limits? ..............................................................................................................................31What is the Controller? .........................................................................................................................32What is stored in the repository? ..........................................................................................................33How is the repository managed? ..........................................................................................................33How is report data placed in the repository? ........................................................................................33

Subsystem Interface (MVS) ...........................................................................................................33External Writer Interface ...............................................................................................................34

How does the user access the report information? ...............................................................................34RMS Capabilities ........................................................................................................................................34

Administrative Services ........................................................................................................................34Distribution Definition .........................................................................................................................35Packaging Capabilities .........................................................................................................................35Media Control .......................................................................................................................................35Report Viewing .....................................................................................................................................36Report Printing and Reload ..................................................................................................................36Archive / Recovery ...............................................................................................................................37Help Facilities .......................................................................................................................................37

Report Processing Cycle .............................................................................................................................38Capture ..................................................................................................................................................38Distribution Definition .........................................................................................................................39Index for Base Datasets ........................................................................................................................39Archive Retention-based for Base Datasets .........................................................................................39Distribution ...........................................................................................................................................39Index for Distributed Datasets ..............................................................................................................40Archive for Distributed Datasets ..........................................................................................................40Viewing / Printing / Recovery / Reload for Distributed and Base Datasets .........................................40

© 2013 Mantissa Corporation. All rights reserved. 3

TAB

LE OF C

ON

TENTS

RO

_Ref

eren

ce_G

uide

(v11

r35m

1)TO

C.fm

: Rev

ised

Sun

day,

Nov

embe

r 24,

201

3

Table of Contents: Report Data Capture RMS/Online® Version 11.35


Index Maintenance for Distributed and Base Datasets .........................................................................40Archive Demand for BASE Datasets ...................................................................................................40Purge Storage space release ..................................................................................................................40

Operating Environment ...............................................................................................................................40Software Requirements .........................................................................................................................40Hardware Requirements .......................................................................................................................41

Chapter 2REPORT DATA CAPTURE

Quick Start Checklist ..................................................................................................................... 43Placing Reports in the RMS Repository .....................................................................................................43

Assigning Meaningful Names to report datasets ..................................................................................43How Repository Attributes Are Assigned ............................................................................................44Data Capture Schematic .......................................................................................................................46Capturing Report Datasets with the Subsystem Interface ....................................................................47

Specifying Capture Criteria ...........................................................................................................47Selection Attributes ........................................................................................................................47Completing Selection Fields ..........................................................................................................48Attributes To Be Assigned .............................................................................................................48Capturing JOBLOG Datasets .........................................................................................................50

Capturing Report Datasets with the External Writer Interface .............................................................50Method 1 - Routing Individual SYSOUTS ....................................................................................51

Routing SYSOUT to RMS and Assigning Unique Names: ....................................................51in //ddname1 statement: ..........................................................................................................51

Method 2 - Routing All SYSOUT Data for a Job ..........................................................................51Routing All Job SYSOUT to RMS .........................................................................................51in //jobname statement .............................................................................................................52in //ddname statements ............................................................................................................52

RMS Controller ...........................................................................................................................................52Overview ..............................................................................................................................................52Task / File Relationship Schematic ......................................................................................................54Specifying Options ...............................................................................................................................55Starting, Modifying, and Stopping the Controller Task .......................................................................57

Task Initiation ................................................................................................................................57Task Processing Criteria Modification ..........................................................................................58Task Termination ...........................................................................................................................59

SYSOUT Selection ...............................................................................................................................60Log File Management ...........................................................................................................................60

MVS ...............................................................................................................................................60VSE ................................................................................................................................................60

Chapter 3

4 © 2013 Mantissa Corporation. All rights reserved.

TAB

LE O

F C

ON

TEN

TS

RO

_Ref

eren

ce_G

uide

(v11

r35m

1)TO

C.fm

: Rev

ised

Sun

day,

Nov

embe

r 24,

201

3RMS/Online® Version 11.35 Table of Contents: Implementation Strategy


IMPLEMENTATION STRATEGY

Overview ......................................................................................................................................... 61Administrator Responsibilities ....................................................................................................................61

Determining Report Management Requirements .................................................................................61Planning a Managed Report Environment ............................................................................................62Report Management Database ..............................................................................................................62System Security ....................................................................................................................................62Repository Management .......................................................................................................................63

Distribution Capabilities .............................................................................................................................63Consolidation of Reports ......................................................................................................................63Copy Variation .....................................................................................................................................63Priority Output ......................................................................................................................................63Sending Reports ....................................................................................................................................63Assignment Of Specific Output Attributes ...........................................................................................63Data Stream Insertion ...........................................................................................................................63Deletion of Unwanted Report Data ......................................................................................................64Selection of Total/Control Data Pages .................................................................................................64Production Of Output Separators .........................................................................................................64Media Control - Softcopy, Desktop, Hardcopy, etc. ............................................................................64

Steps in Creating a Distribution Definition .................................................................................................64Step 1 - Obtaining the Necessary Information ...............................................................................64

RM80004 Sample Job Control ................................................................................................64Class and/or destination ID serviced by the External Writer ..................................................64

Step 2 - Selecting a Group of Reports ............................................................................................65Identifying a Distribution Report Group .................................................................................65First Time Users - Selecting a Benchmark Group ...................................................................65

Step 3 - Capturing Selected Sysout Datasets .................................................................................65Report Creation for OS/MVS ..................................................................................................65Report Creation for VSE .........................................................................................................66

Step 4 - Determining Distribution Requirements ..........................................................................67Interview Sessions ...................................................................................................................68Report Ownership ....................................................................................................................68Report Breakdown ...................................................................................................................68Special Handling .....................................................................................................................68Output Media Format ..............................................................................................................68Distribution Hierarchy Definition ...........................................................................................68

Step 5 -Producing Report Maps .....................................................................................................69Step 6 -Entering the Distribution Instruction Set ...........................................................................69

Base Dataset Names ................................................................................................................69Define Distribution Requirements ...........................................................................................69Maps of the Reports .................................................................................................................69

RM80004 Processing Summary ..................................................................................................................70RM80004 Processing Flow .........................................................................................................................70

Scan Phase ............................................................................................................................................71


TAB

LE OF C

ON

TENTS

RO

_Ref

eren

ce_G

uide

(v11

r35m

1)TO

C.fm

: Rev

ised

Sun

day,

Nov

embe

r 24,

201

3

Table of Contents: Implementation Strategy RMS/Online® Version 11.35


Principle 1. Page Delineation .........................................................................................................71Principle 2. Determination of Ownership ......................................................................................71Principle 3. Ownership Information Location ...............................................................................71Principle 4. Report Identification ...................................................................................................71Principle 5. Page Ownership ..........................................................................................................71Principle 6. Output Sequence Determination .................................................................................72

Order Phase ...........................................................................................................................................73Output Phase .........................................................................................................................................73

Distribution Instruction Sets. ......................................................................................................................73The RMS Distribution Definition Facility ............................................................................................73Instruction Set Records - A Functional Description .............................................................................73

Distribution Options .......................................................................................................................74Copy Control ..................................................................................................................................74Send Report ....................................................................................................................................74Translate .........................................................................................................................................74Package Control .............................................................................................................................74Dataset Selection ............................................................................................................................74Report Definition ...........................................................................................................................74

Explicit Definition ...................................................................................................................74Implicit Definition ...................................................................................................................75

Creating A Distribution Definition .............................................................................................................75RMS/DD Transactions .........................................................................................................................75Terminology .........................................................................................................................................76Step by Step ..........................................................................................................................................77

Access Authorization Panel ...........................................................................................................78Primary Menu Panel .......................................................................................................................79RMS/Distribution Definition Primary Menu Panel .......................................................................80Distribution Options Panel .............................................................................................................81

Media Production Priorities .....................................................................................................81ORD(er) ...................................................................................................................................81Recipient Field - Name/Length/Notes .....................................................................................82

Distribution Options Panel (continued) .........................................................................................82General Options .......................................................................................................................82RMS/Online Options ...............................................................................................................83Process Code Options ..............................................................................................................84Mapping Options .....................................................................................................................84

Custom Report Definition Panel ....................................................................................................85Recognizable Characteristics: .................................................................................................85Report Recognition Information ..............................................................................................87Recipient Field Line Column/Coordinate ...............................................................................88

Send Report Panel ..........................................................................................................................90Dataset Selection Panel ..................................................................................................................91

Process Code/Condition ..........................................................................................................92FCB Requirements Summary ........................................................................................................93Custom Packaging Panel ................................................................................................................94


TAB

LE O

F C

ON

TEN

TS

RO

_Ref

eren

ce_G

uide

(v11

r35m

1)TO

C.fm

: Rev

ised

Sun

day,

Nov

embe

r 24,

201

3RMS/Online® Version 11.35 Table of Contents: Repository Management


Output Priority Panel .....................................................................................................................96Recipient/Location Equate Panel ...................................................................................................97Auto Report Definition Panel ........................................................................................................98Content/Recipient Conversion Panel .............................................................................................99Recipient/Recipient Convert Panel ..............................................................................................100Automatic Packaging Panel .........................................................................................................101Data Insertion Panel .....................................................................................................................103Insertion Information ...................................................................................................................105

Testing Your Instruction Set .....................................................................................................................106Testing is performed at several levels. .........................................................................................107

Instruction Set Reorganization ..................................................................................................................107Set Reorganization Panel .............................................................................................................108

Chapter 4REPOSITORY MANAGEMENT

Concepts ....................................................................................................................................... 109Types of Repository datasets ....................................................................................................................109RMS Archive Types ..................................................................................................................................110

Base Archive Creation / Life Cycle ....................................................................................................110Packet Archive Creation / Life Cycle .................................................................................................111Retention-Based Archive Creation / Life Cycle .................................................................................112

FileSet Backup and Restore ......................................................................................................................112RM90007 (Backup) Processing ..........................................................................................................112RM90008 (Restore) Processing ..........................................................................................................113Recommendation ................................................................................................................................113

Daily Backup / Restore ................................................................................................................113Weekly and/or Monthly Backup / Restore ...................................................................................113

Repository Sharing among Filesets ...........................................................................................................114RM80001 - Base Dataset Management Utility .........................................................................................115

Guide to Commands ...........................................................................................................................115System Facilities .................................................................................................................................115

Typical uses: ................................................................................................................................116RM80001 Use ...........................................................................................................................................116

Selecting Datasets ...............................................................................................................................116Archive Scheduling ............................................................................................................................117

RM80001 Control Statements ...................................................................................................................117Notation Conventions .........................................................................................................................117Control Statement ...............................................................................................................................118

Types ............................................................................................................................................118Option ....................................................................................................................................118Select .....................................................................................................................................118

Order ............................................................................................................................................118Syntax ...........................................................................................................................................118


TAB

LE OF C

ON

TENTS

RO

_Ref

eren

ce_G

uide

(v11

r35m

1)TO

C.fm

: Rev

ised

Sun

day,

Nov

embe

r 24,

201

3

Table of Contents: Repository Management RMS/Online® Version 11.35


Parameters ....................................................................................................................................118Continuation .................................................................................................................................119

Command Descriptions ......................................................................................................................119INSERT*DATA*STREAM ........................................................................................................119INSERT*DATA*STREAM PARAMETERS .............................................................................119

Optional Parameters ..............................................................................................................119Notes on INSERT*DATA*STREAM .........................................................................................121OUTPUT*CONTROL .................................................................................................................121OUTPUT*CONTROL Command Summary ...............................................................................121OUTPUT*CONTROL PARAMETERS ......................................................................................122

Required Parameters ..............................................................................................................122Optional Parameters ..............................................................................................................122

RUN*MODE (ARCHIVE Mode) ................................................................................................123RUN*MODE Command Summary (ARCHIVE Mode) .............................................................124RUN*MODE PARAMETERS ....................................................................................................124


RUN*MODE (RECOVER Mode) ...............................................................................................124RUN*MODE Command Summary (RECOVER Mode) .............................................................124RUN*MODE PARAMETERS ....................................................................................................124


RUN*MODE (RETRIEVE Mode) ..............................................................................................124RUN*MODE Command Summary (RETRIEVE Mode) ............................................................124RUN*MODE PARAMETERS ....................................................................................................125

Required Parameters ..............................................................................................................125RUN*OPTIONS ..........................................................................................................................125RUN*OPTIONS Command Summary ........................................................................................125RUN*OPTIONS PARAMETERS ...............................................................................................125

Required Parameters ..............................................................................................................125Optional Parameters ..............................................................................................................125Notes on Process Codes: .......................................................................................................126

Select ............................................................................................................................................126select Command Summary .......................................................................................................................127Select PARAMETERS ..............................................................................................................................127


RM80001 Control Statement Examples ....................................................................................................129OS/MVS Command Examples ..............................................................................................129

File Create Examples ...................................................................................................................129Specific Report Retrieval ......................................................................................................129Specific Report Retrieval Qualified by Destination and Forms ............................................129Specific Report Dataset Retrieval by Class and Form Identifier; User Exit Output .............130Generic Report Retrieval. Qualified. Print Image Tape Output. ...........................................130“ALL” Generic Retrieval. Print Image Tape Output .............................................................130


TAB

LE O

F C

ON

TEN

TS

RO

_Ref

eren

ce_G

uide

(v11

r35m

1)TO

C.fm

: Rev

ised

Sun

day,

Nov

embe

r 24,

201

3RMS/Online® Version 11.35 Table of Contents: System Administration


Obtain an Alphabetical Cross Reference Listing of the Entries in the Repository ...............130Report Archive Examples ............................................................................................................130

Generic Archive .....................................................................................................................131Archive and Purge .................................................................................................................131Specific Archive ....................................................................................................................132

Report Recovery ........................................................................................................................................132Specific Report Recovery with Reload to repository. ...........................................................132Multiple Report Recovery .....................................................................................................133

Additional Command Examples ..................................................................................................133Microfiche File Create Examples ..........................................................................................133Generic Report Retrieval .......................................................................................................134Obtain an Alphabetical Cross Reference Listing of the Entries in the Repository ...............134

BASE Dataset Archive Examples .............................................................................................................134Generic Archive .....................................................................................................................134“ALL” Archive ......................................................................................................................134Specific Report Archive ........................................................................................................135

Report Recovery ........................................................................................................................................135Specific Report Recovery ......................................................................................................135Report Recovery Using List Attribute Record ......................................................................135Multiple Report Recovery .....................................................................................................136Recreating an Archive Directory List ....................................................................................136

Chapter 5SYSTEM ADMINISTRATION

Additional Administrative Transactions .................................................................................... 137Administrative Control Dataset Records ..................................................................................................137

Access Group Master ...................................................................................................................137User Master ..................................................................................................................................137Location Master ...........................................................................................................................137Retention Control .........................................................................................................................137

Administrative Transaction Characteristics ..............................................................................................137Panel Format .......................................................................................................................................137PF Keys ...............................................................................................................................................138Template Use ......................................................................................................................................138Multi-panel Transactions ....................................................................................................................138Help Facilities .....................................................................................................................................139

Administrative Transactions .....................................................................................................................139Access Authorization ..........................................................................................................................139Primary Menu .....................................................................................................................................139Administrative Menu ..........................................................................................................................139

Add Transactions .........................................................................................................................139Inquire Transactions .....................................................................................................................140Change Transactions ....................................................................................................................140


TAB

LE OF C

ON

TENTS

RO

_Ref

eren

ce_G

uide

(v11

r35m

1)TO

C.fm

: Rev

ised

Sun

day,

Nov

embe

r 24,

201

3

Table of Contents: System Administration RMS/Online® Version 11.35


Delete Transactions ......................................................................................................................140List Transactions ..........................................................................................................................140

Building A Management Database ...........................................................................................................140Collecting the Required Information ..................................................................................................140Creating System Control Records ......................................................................................................141

Access Authorization Panel .........................................................................................................141Primary Menu Panel .....................................................................................................................142

System Administrative Panels ...................................................................................................................142Administrative Menu Panel .........................................................................................................144Access Group Master Panel .........................................................................................................145User Master Panel ........................................................................................................................146

Security Profile ..........................................................................................................................................147User Master Panel (continued) .....................................................................................................149

Job Statement Information ........................................................................................................................149Location Master Panel .................................................................................................................150Location Master Panel (continued) ..............................................................................................151Retention Control Panel ...............................................................................................................152Output Definition Panel ...............................................................................................................153System Customization Panel .......................................................................................................157

Output Definition ......................................................................................................................................158Output Definition Highlights ..............................................................................................................159

Adding An Output Definition Record .......................................................................................................159Verification Report .............................................................................................................................161Output Request ...................................................................................................................................161Linking Output Definition Panels .......................................................................................................162

WebAccess Document Groups .................................................................................................................162RMS WebAccess Highlights ..............................................................................................................163Docgroup Definition ...........................................................................................................................163Adding a Docgroup Profile Record .................................................................................................164

Linking DOCGROUP Panels .......................................................................................................167System Administration Case Study ........................................................................................... 169

The Requirements ...............................................................................................................................169The System ...................................................................................................................................169The Reports ..................................................................................................................................169

Data Entry ...........................................................................................................................................169Administrative Menu Panel .........................................................................................................170Access Group Master Panel .........................................................................................................171Administrative Menu Panel .........................................................................................................172Location Master Panel .................................................................................................................173Location Master Panel (continued) ..............................................................................................174Administrative Menu Panel .........................................................................................................175Location Master Panel .................................................................................................................176Location Master Panel (continued) ..............................................................................................177Location Master Panel .................................................................................................................178Location Master Panel (continued) ..............................................................................................179


TAB

LE O

F C

ON

TEN

TS

RO

_Ref

eren

ce_G

uide

(v11

r35m

1)TO

C.fm

: Rev

ised

Sun

day,

Nov

embe

r 24,

201

3RMS/Online® Version 11.35 Table of Contents: System Security


Administrative Menu Panel .........................................................................................................180User-1 Master Record .................................................................................................................181User-1 Master Panel (continued) .................................................................................................183User-2 Master Record ..................................................................................................................184User-2 Master Record (continued) ...............................................................................................186User-3 Master Record .................................................................................................................187User-3 Master Panel (continued) .................................................................................................189

Resource Security ...............................................................................................................................189Resource Security Panel ..............................................................................................................190

Canceling Reports ...............................................................................................................................198Retention-Based Archive ..........................................................................................................................199

System Administration Panel .....................................................................................................200Retention Control Panel ..............................................................................................................201Retention Control Panel - RMODEL Record .............................................................................201Retention Control Panel - Report Record ...............................................................................203

Submitting Jobs from RMS .......................................................................................................................204Help Management .....................................................................................................................................205

Help Maintenance Menu ....................................................................................................................205Help List Display .........................................................................................................................205

Help Information for Help .....................................................................................................205Help Format Information .......................................................................................................205

PF Key and Option Field Assignments ..............................................................................................205Reserved Word List ............................................................................................................................206Help Characters ..................................................................................................................................206

Help Variables ..............................................................................................................................206Leaflets ...............................................................................................................................................207

Chapter 6SYSTEM SECURITY

Definition of Terms ...................................................................................................................... 209Security Level Definition ..........................................................................................................................209

System Security ..................................................................................................................................209Access Group Level Security .............................................................................................................209User Level Security ............................................................................................................................209Resource Level Security .....................................................................................................................209Security Maintenance .........................................................................................................................210

Access Group Master Panel .........................................................................................................211Security Considerations .........................................................................................................211

Security Considerations for User Records ...................................................................................212Security Considerations .........................................................................................................212

Transaction Security Add/Delete/Inquire Panel ..........................................................................213Transaction Security ..............................................................................................................213

Location/Report Security Add/Delete/Inquire Panel ...................................................................214


TAB

LE OF C

ON

TENTS

RO

_Ref

eren

ce_G

uide

(v11

r35m

1)TO

C.fm

: Rev

ised

Sun

day,

Nov

embe

r 24,

201

3

Table of Contents: Display Print Facility RMS/Online® Version 11.35


Transaction Security ..............................................................................................................214Security Examples .....................................................................................................................................214

Step 1. ..........................................................................................................................................215Step 2. ...........................................................................................................................................216Step 3. ...........................................................................................................................................217Step 4. ...........................................................................................................................................218Step 5. ...........................................................................................................................................219Step 6. ...........................................................................................................................................220Step 7. ...........................................................................................................................................221Step 8. ...........................................................................................................................................222Step 9. ...........................................................................................................................................223Step 10. .........................................................................................................................................224Step 11. .........................................................................................................................................225

Chapter 7DISPLAY PRINT FACILITY

Introduction .................................................................................................................................. 227Access .......................................................................................................................................................227

Report Access .....................................................................................................................................227System Access ....................................................................................................................................227

Communicating Your Report Access Requirements ................................................................................229Requesting On-line Report Access .....................................................................................................229

Report Title and Originating System ...........................................................................................229Viewing Capabilities .................................................................................................................................229How to Use RMS/DPF ..............................................................................................................................230

Panel Management Characteristics .....................................................................................................230Panel Format ................................................................................................................................230Selection Characteristics ..............................................................................................................230Scrolling Characteristics ..............................................................................................................230

Program Function Key Utilization .....................................................................................................231System Help Facilities ...............................................................................................................................231

System User Panels ............................................................................................................................231Session Example 1. ......................................................................................................................232

Objective ................................................................................................................................232Session Example 2. ......................................................................................................................232

Objective ................................................................................................................................232Session Example 3. ......................................................................................................................233

Objective ................................................................................................................................233Access Authorization Panel .........................................................................................................234Primary Menu Panel .....................................................................................................................235Display/Print Menu Panel ............................................................................................................236Index Panel ...................................................................................................................................237Versions Panel ..............................................................................................................................238


TAB

LE O

F C

ON

TEN

TS

RO

_Ref

eren

ce_G

uide

(v11

r35m

1)TO

C.fm

: Rev

ised

Sun

day,

Nov

embe

r 24,

201

3RMS/Online® Version 11.35 Table of Contents: Problem Determination and Resolution


Display Panel ...............................................................................................................................239Command Description ..............................................................................................................................240Line Positioning/Scroll Operations ...........................................................................................................245

Recover / Print Panel ....................................................................................................................246RMS Note Pad Facility .............................................................................................................................246

Note Pad Panel .............................................................................................................................247RMS Security for Note pad access .....................................................................................................248Note pad Usage Step by Step .............................................................................................................251Note pad Usage – Reload from Group Archive .................................................................................265Task/Panel Cross Reference ...............................................................................................................276

Using the Display for the First Time User ................................................................................................276Important Keys .............................................................................................................................276System Help Facilities .................................................................................................................276

How to get started ...............................................................................................................................276Primary Menu Panel .....................................................................................................................277Display/Print Menu Panel ............................................................................................................278Index Panel ...................................................................................................................................279Versions Panel ..............................................................................................................................280Display Panel ...............................................................................................................................281

Report Viewing Features ...........................................................................................................................281Report Formatting ...............................................................................................................................282Saving Your Format for Later Use .....................................................................................................283Line Positioning/Scroll Operations ....................................................................................................283Locating Information Within the Report ............................................................................................284Using the Windowing Features ..........................................................................................................285Informational Commands ...................................................................................................................286Using the Note Pad Capability ...........................................................................................................287

Selective And Full Version Printing .........................................................................................................287Printing an Entire Report ....................................................................................................................288

Recover / Print Panel ....................................................................................................................289Printing Selective Pages .....................................................................................................................289

Chapter 8PROBLEM DETERMINATION AND RESOLUTION

Common Problems /Solutions .................................................................................................... 291

Chapter 9MESSAGES AND CODES

RMS Messages ............................................................................................................................. 297Introduction ...............................................................................................................................................297

Explanation of Message Format .........................................................................................................297


TAB

LE OF C

ON

TENTS

RO

_Ref

eren

ce_G

uide

(v11

r35m

1)TO

C.fm

: Rev

ised

Sun

day,

Nov

embe

r 24,

201

3

Table of Contents: Tutorial RMS/Online® Version 11.35


Messages ...................................................................................................................................................298RM Codes ...........................................................................................................................................298

RMS Abend Codes ....................................................................................................................................415Call Status Codes ......................................................................................................................................423

From ESFOPEN/ESFOPNC Interface .........................................................................................423From ESFCLOS Interface .........................................................................................................................425From ESFWRIT Interface .........................................................................................................................425From ESFREAD Interface ........................................................................................................................427From ESFSTAT/ESFSTAC Interface .......................................................................................................428From ESFPURG/ESFPURC Interface ......................................................................................................428From ESFROUT/ESFROUC Interface .....................................................................................................430From ESFNECT Interface .........................................................................................................................430From ESFCOMI Interface .........................................................................................................................432Dynamic Allocation Return Codes ...........................................................................................................433

Chapter 10TUTORIAL

Report Distribution Tutorial ........................................................................................................ 435Distribution Problem Definition and Results ............................................................................................435

Example ..............................................................................................................................................435Screen 1 - Define the Distribution Options ..................................................................................436Screen 2 - Define the “Stock” Report ..........................................................................................437Screen 3 - Define the “VENACT” Report ...................................................................................438Screen 4 - Define the “PROFIT” Report .....................................................................................438Screen 5 - Adjust Stock Report Copies for Client 002 ................................................................439Screen 6 - Send Client 001 Profit Report to Client 003 ...............................................................440Screen 7 - Define Client 001 Packaging Requirements ...............................................................441Screen 8 - Define Client 002 Packaging Requirements ...............................................................442Screen 9 - Define Client 003 Packaging Requirements ...............................................................442

Dataset Profile (MVS only) ......................................................................................................................443Specifying Capture Criteria ................................................................................................................443

Selection Attributes ...................................................................................................................................444Completing Selection Fields ...............................................................................................................445

Attributes to be Assigned ..........................................................................................................................445Examples of Sysout/Report Management Coding ....................................................................................447

Existing Customer ..............................................................................................................................447Viewing Dataset Profiles ...........................................................................................................................449Using the Primary Menu ...........................................................................................................................450

Creating a Packet Containing a Single Report .............................................................................451Distribution Options Panel ........................................................................................................................456Dataset Selection Panel .............................................................................................................................459Custom Report Definition Panel for Sales Activity Report ......................................................................463Custom Packaging Panel for Sales Activity Report ..................................................................................469


TAB

LE O

F C

ON

TEN

TS

RO

_Ref

eren

ce_G

uide

(v11

r35m

1)TO

C.fm

: Rev

ised

Sun

day,

Nov

embe

r 24,

201

3RMS/Online® Version 11.35 Table of Contents: Installation


Chapter 11INSTALLATION

MVS System Installation/Verification ......................................................................................... 475Introduction ...............................................................................................................................................475Release Level Upgrade .............................................................................................................................475RMS MVS Installation Checklist ..............................................................................................................476

Task 1 ...........................................................................................................................................477Upload install files ..........................................................................................................................477

Task 2 ...........................................................................................................................................479Installing the System .......................................................................................................................479

Task 3 ...........................................................................................................................................482Prepare Repository/Start RMS Subsystem .................................................................................482132 Column Support CICS Table Parms ...............................................................................485TSO Environment Preparation ......................................................................................................485

Task 4 ...........................................................................................................................................486System Verification .......................................................................................................................486Initial User ID/Password .......................................................................................................488

Task 5 ..........................................................................................................................................489Task 6 ...........................................................................................................................................490

RMS/WebAccess Installation ................................................................................................490VSE System Installation/Verification ......................................................................................... 498

Introduction ...............................................................................................................................................498Late-breaking Installation notes .........................................................................................................498System Requirements .........................................................................................................................498

Release Level Upgrade .............................................................................................................................498RMS VSE Installation Checklist ...............................................................................................................500

Task 1 ...........................................................................................................................................501Download Install Job ......................................................................................................................501

Task 2 ...........................................................................................................................................502Installing the System .......................................................................................................................502

Task 3 ...........................................................................................................................................504Prepare Report Repository/Start RMS Subsystem. .....................................................................504

Task 4 ...........................................................................................................................................505CICS Environment Preparation ....................................................................................................505

Task 5 ...........................................................................................................................................506JCL Preparation ...............................................................................................................................506

Task 6 ...........................................................................................................................................509Installation Verification ..................................................................................................................509Initial User ID/Password .......................................................................................................509

Task 7 ...........................................................................................................................................510CICS Transaction Gateway and RMS/WebAccess ...............................................................510

Component Configurations ........................................................................................................ 516


TAB

LE OF C

ON

TENTS

RO

_Ref

eren

ce_G

uide

(v11

r35m

1)TO

C.fm

: Rev

ised

Sun

day,

Nov

embe

r 24,

201

3

Table of Contents: Installation RMS/Online® Version 11.35


Archive / Distribution Component Configuration ....................................................................................516NOTES: ...................................................................................................................................... 517

Online Component Configuration .............................................................................................................517Initial User ID/Password ....................................................................................................................520

Control File Configuration ........................................................................................................................520Directives ............................................................................................................................................520

fsname - File set name ...........................................................................................................520fencePrimary - Fence the primary subsystem. ......................................................................520ignoreAux - Ignore Auxiliary Subsystems if down (for write operations) ...........................521drain - Drain a subsystem ......................................................................................................521useOrder - Use order of cache array members ......................................................................521maxpercent - Maximum percentage utilization (before NOT being considered) ..................522minfreeBlk - Minimum free blocks (before use) ...................................................................522minfreeFqe - Minimum free file queue elements (before use) ..............................................522tmessageLevel - Trace message level ....................................................................................522

RMS Integrity via QXCNTRL ...........................................................................................................523Sample QXCNTRL Definition (INST02) without an array. ..............................................................523Adding an auxiliary subsystem to cache array ...................................................................................524Sample QXCNTRL Definition (INST02) with an array. ...................................................................524

Multiple Filesets ........................................................................................................................................525Additional Filesets .................................................................................................................525Let’s Recap ............................................................................................................................525RvvrmCTL Startup: The FSETnn is an entry in QXPARMS DD ........................................527Controller startup ...................................................................................................................527Parm Member: RvvrmCTP ....................................................................................................527Multiple Fileset DDNAMES: Site oriented ..........................................................................528

VSAM Dataset Configuration ...................................................................................................................529VSAM Space Allocation ..............................................................................................................529Description and Suggested Placement of VSAM Datasets ..........................................................529

QXACDS ...............................................................................................................................529QXRCDS ...............................................................................................................................529QXDCDS ...............................................................................................................................529QXWKDS ..............................................................................................................................529Placement ..............................................................................................................................529

RMS Controller Configuration .................................................................................................................530CICS front end for RMS/Online ...............................................................................................................532RMS/WebAccess CICS Security Management ........................................................................................533

Overview ............................................................................................................................................533Dependencies ......................................................................................................................................534Sign-On Security ................................................................................................................................534Access Security ...................................................................................................................................534ESM Definitions .................................................................................................................................534$RMSVIEW Security Class ...............................................................................................................535$RMSCMD Security Class .................................................................................................................535Exit Modifications ..............................................................................................................................536


TAB

LE O

F C

ON

TEN

TS

RO

_Ref

eren

ce_G

uide

(v11

r35m

1)TO

C.fm

: Rev

ised

Sun

day,

Nov

embe

r 24,

201

3RMS/Online® Version 11.35 Table of Contents: Installation


Compile and Link Exit .......................................................................................................................536Parameter List: Sign-On Request .......................................................................................................536Returned Messages: Sign-On Request ...............................................................................................536Parameter List: Report Access Request ..............................................................................................537

RMS SVC ..................................................................................................................................................537SVC Installation .................................................................................................................................537

JES Exits ...................................................................................................................................................539JES Exit Installation ...........................................................................................................................539

NOTES: ........................................................................................................................................540RMS Subsystem Initialization ..................................................................................................... 541

Overview ...................................................................................................................................................541Space Allocations ...............................................................................................................................541

Initialization Parameters ...........................

Documents

RO Reference Guide(v11r35m1)€¦ · T ABLE OF C ONTENTS © 2013 Mantissa Corporation. All rights reserved. 5 RO_Reference_Guide(v11r35m1)TOC.fm: Revised Sunday, November 24, 2013