View
0
Download
0
Category
Preview:
Citation preview
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
System Reference Guide
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
System Reference Guide
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
© 2013 Mantissa Corporation. All rights reserved. 5
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
System Reference Guide
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
6 © 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: Repository Management
System Reference Guide
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
© 2013 Mantissa Corporation. All rights reserved. 7
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
System Reference Guide
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
Required Parameters ..............................................................................................................124Optional Parameters ..............................................................................................................124
RUN*MODE (RECOVER Mode) ...............................................................................................124RUN*MODE Command Summary (RECOVER Mode) .............................................................124RUN*MODE PARAMETERS ....................................................................................................124
Required Parameters ..............................................................................................................124Optional 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
Required Parameters ..............................................................................................................127Optional 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
8 © 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: System Administration
System Reference Guide
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
© 2013 Mantissa Corporation. All rights reserved. 9
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
System Reference Guide
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
10 © 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: System Security
System Reference Guide
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
© 2013 Mantissa Corporation. All rights reserved. 11
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
System Reference Guide
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
12 © 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: Problem Determination and Resolution
System Reference Guide
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
© 2013 Mantissa Corporation. All rights reserved. 13
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
System Reference Guide
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
14 © 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: Installation
System Reference Guide
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
© 2013 Mantissa Corporation. All rights reserved. 15
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
System Reference Guide
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
16 © 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: Installation
System Reference Guide
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 ...........................
Recommended