Page 3 - IBM
OS/390 IBM Security Server (RACF)Planning: Installation and Migration GC28-1920-01
Page 4 - Second Edition, September 1996
Note Before using this information and the product it supports, be sure to read the general information under “Notices” on page xi. Second Edition, September 1996 This is a major revision of GC28-1920-00. This edition applies to Version 1 Release 2 of OS/390 (5645-001) and to all subsequent releases...
Page 5 - iii
Page 6 - iv
iv OS/390 V1R2.0 Security Server (RACF) Planning: Installation and Migration
Page 7 - Contents
Contents Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi Trademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xii About This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii Who Should U...
Page 9 - vii
Chapter 9. Operational Considerations . . . . . . . . . . . . . . . . . . . . . 49 Enhancements to the RESTART Command . . . . . . . . . . . . . . . . . . . . 49 Enabling and Disabling RACF . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 Chapter 10. Application Development Considerations ...
Page 10 - viii
viii OS/390 V1R2.0 Security Server (RACF) Planning: Installation and Migration
Page 11 - Figures; ix
Figures 1. Function Shipped In OS/390 Release 1 Security Server (RACF) . . . . . . 5 2. Function Introduced After the Availability of OS/390 Release 1 SecurityServer (RACF) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3. Function Introduced In OS/390 Release 2 Security Ser...
Page 13 - Notices; xi
Notices References in this publication to IBM products, programs, or services do not implythat IBM intends to make these available in all countries in which IBM operates. Any reference to an IBM product, program, or service is not intended to state orimply that only IBM's product, program or service...
Page 14 - Trademarks; xii
Trademarks The following terms are trademarks of the IBM Corporation in the United States orother countries or both: AS/400 BookManager CICS CICS/ESA DB2 DFSMS DFSMS/MVS IBM IBMLink IMS Library Reader MVS MVS/ESA MVS/XA NetView OpenEdition OS/2 OS/390 Parallel S...
Page 15 - About This Book; Who Should Use This Book; xiii
About This Book This book contains information about the Resource Access Control Facility (RACF),which is part of the OS/390 Security Server. The Security Server has twocomponents: RACF OpenEdition DCE Security Server For information about the OpenEdition DCE Security Server, see the publication...
Page 16 - xiv
Chapter 7, “Administration Considerations” on page 37, summarizes changesto administration procedures for the new release of RACF. Chapter 8, “Auditing Considerations” on page 45, summarizes changes toauditing procedures for the new release of RACF. Chapter 9, “Operational Considerations” on p...
Page 17 - xv
RACF Courses The following RACF classroom courses are also available: Effective RACF Administration, H3927 MVS/ESA RACF Security Topics, H3918 Implementing RACF Security for CICS/ESA, H3992 IBM provides a variety of educational offerings for RACF. For more information onclassroom courses and o...
Page 18 - Other Sources of Information; IBM Discussion Areas; MVSRACF; Internet Sources; RACF home page; Sample code; xvi
Other Sources of Information IBM provides customer-accessible discussion areas where RACF may bediscussed by customer and IBM participants. Other information is available throughthe Internet. IBM Discussion Areas Two discussion areas provided by IBM are the MVSRACF discussion and theSECURITY discuss...
Page 19 - Restrictions; To Request Copies of IBM Publications; xvii
You can get sample code, internally-developed tools, and exits to help you useRACF. All this code works 1 , but is not officially supported. Each tool or sample has a README file that describes the tool or sample and any restrictions on itsuse. The simplest way to reach this code is through the RACF...
Page 20 - Elements and Features in OS/390; xviii
Elements and Features in OS/390 You can use the following table to see the relationship of a product you are familiar with and how it isreferred to in OS/390 Release 2. OS/390 Release 2 is made up of elements and features that containfunction at or beyond the release level of the products listed in ...
Page 21 - xix
Product Name and Level Name in OS/390 Base orOptional OpenEdition Application Services OpenEdition Application Services base OpenEdition DCE Base Services (OSFDCE level 1.1) OpenEdition DCE Base Services base OpenEdition DCE Distributed File Service(DFS) (OSF DCE level 1.1) OpenEdition D...
Page 22 - xx
xx OS/390 V1R2.0 Security Server (RACF) Planning: Installation and Migration
Page 23 - Summary of Changes; xxi
Summary of Changes Summary of Changesfor GC28-1920-01OS/390 Release 2 This book contains new information for OS/390 Release 2 Security Server (RACF). Summary of Changesfor GC28-1920-00OS/390 Release 1 This book contains information previously presented in RACF Planning: Installation and Migration, G...
Page 24 - xxii
xxii OS/390 V1R2.0 Security Server (RACF) Planning: Installation and Migration
Page 25 - Chapter 1. Planning for Migration; Migration Planning Considerations
Chapter 1. Planning for Migration This chapter provides information to help you plan your installation's migration tothe new release of RACF. Before attempting to migrate, you should define a planto ensure a smooth and orderly transition. A well thought-out and documentedmigration plan can help mini...
Page 26 - Installation Considerations; Customization Considerations
Installation Considerations Before installing a new release of RACF, you must determine what updates areneeded for IBM-supplied products, system libraries, and non-IBM products.(Procedures for installing RACF are described in the program directory shipped withthe product, not in this book.) Be sure ...
Page 29 - Chapter 2. Release Overview; New and Enhanced Support
Chapter 2. Release Overview This chapter lists the new and enhanced features of RACF for OS/390 Release 2.It also lists the support that has not been updated in the new release. New and Enhanced Support For OS/390 Release 2, RACF provides new and enhanced support for: OS/390 OpenEdition DCE OS/3...
Page 30 - OS/390 OpenEdition DCE
Figure 2 on page 6 identifies function introduced after the availability of OS/390Release 1 Security Server (RACF). Figure 3 identifies function introduced in OS/390 Release 2 Security Server(RACF). Figure 4 identifies function not shipped in OS/390 Release 2 Security Server(RACF), but available via...
Page 32 - Auditing the Passing of Access Rights; SOMobjects for MVS
OS/390 OpenEdition OS/390 Release 2 OpenEdition adds new capabilities for which RACF providessupport. Authorizing and Auditing Server Access to the CCS and WLMServices OS/390 Release 2 OpenEdition adds the capability to check whether servers areauthorized to use the console communications service (C...
Page 33 - Multisystem Nodes in an RRSF Network
so that the user's information can be customized independently of the user'sworkstation type. The SystemView Launch window lets users log on once, authenticating with theirRACF password, and then get access to applications that SystemView for MVSsupports by selecting an application from their custom...
Page 34 - OS/390 Enable and Disable Functions
Output and notifications from commands that were directed via the AT orONLYAT keywords. These are returned to the system on which the directedcommand was issued. Notifications from RACLINK commands. These are returned to the system onwhich the RACLINK command was issued. Output from password c...
Page 35 - NetView; IRRUT100 Support for the FILE and DIRECTRY classes
the IRRDCR00 module to allow customers to convert a 3-byte packed decimal dateto a 4-byte packed decimal date, using RACF's interpretation of the yy value. For more information on IRRDCR00, see “Year 2000 Support” on page 51. NetView RACF has added the NGMFVSPN field to the NETVIEW segment of the RA...
Page 36 - Function Not Upgraded
The PTF must be applied to all systems in the sysplex in order for theseenhancements to take effect. However, systems with and without the PTF appliedcan coexist in the sysplex, and there is no requirement to IPL all systems in thesysplex when the PTF is applied. Note: PTF UW90293 is not shipped wit...
Page 38 - Commands
Figure 7 lists classes for which there are changes. Figure 6 (Page 2 of 2). New Classes Class Name Description Support FILE This class controls protection of shared file system(SFS) files on VM. RACF 1.10for VM KEYSMSTR This class holds a key to encrypt DCE passwordsstored in the RACF database. The ...
Page 42 - New Messages; Changed Messages
New Messages The following messages are added: RACF Initialization Messages: ICH562I RACF Processing Messages: IRR418I Dynamic Parse (IRRDPI00 Command) Messages: IRR52152I RACF Database Split/Merge Utility (IRRUT400) Messages: IRR65038I Messages Issued by the RACF Subsystem: IRRB022I, IRRB077I, IRRB...
Page 43 - Panels; Publications Library
Panels Figure 13 lists RACF panels that are changed. Figure 13. Changed Panels for RACF Panel Description Support ICHP41IICHP42I Existing panels for user administration of theNETVIEW segment have been updated to allow auser to add, change, or delete the NGMFVSPNfield. NetView Publications Library Fi...
Page 44 - Templates
SYS1.SAMPLIB Figure 16 identifies changes to RACF members of SYS1.SAMPLIB. Figure 16. Changes to SYS1.SAMPLIB Member Description Support IRRADULD This member has been updated with the SMF type80 record for the new event code 65. OS/390OpenEdition IRRADULD This member has been updated to support RACF...
Page 45 - Utilities
Figure 17. Changes to Templates Template Description of Change Support General A new SVFMR segment provides the followinginformation: Field Description SCRIPTN Script name PARMN Parameter list name SystemViewfor MVS Group A new OVM segment provides OpenEdition for VMinformation associated with a gro...
Page 47 - Chapter 4. Planning Considerations; Migration Strategy
Chapter 4. Planning Considerations This chapter describes the following high-level planning considerations forcustomers upgrading to Security Server (RACF) Release 2 from Security Server(RACF) Release 1: Migration strategy Migration paths Hardware requirements Software requirements Compati...
Page 49 - Compatibility
Figure 19. Software Requirements for New Function Function Software Requirements OS/390 OpenEdition DCE interoperabilitysupport OpenEdition/MVS Release 3 plus APAROW15865 (PTF UW23684)C Run Time Library plus APAR PN75309(PTF UN90158) SOMobjects for MVS support Version 1 Release 2 of SOMobjects forMV...
Page 51 - Chapter 5. Installation Considerations; Enabling RACF
Chapter 5. Installation Considerations This chapter describes changes of interest to the system programmer installingOS/390 Release 2 Security Server (RACF): Enabling RACF Considerations for RRSF networks Virtual storage considerations Customer additions to the CDT Templates Enabling RACF ...
Page 56 - RACF Storage Considerations; Virtual Storage
RACF Storage Considerations This section discusses storage considerations for RACF. Virtual Storage Figure 21 estimates RACF virtual storage usage, for planning purposes. Figure 21 (Page 1 of 2). RACF Estimated Storage Usage Storage Subpool Usage How to Estimate Size FLPA RACF service routines, if I...
Page 57 - Customer Additions to the CDT
Figure 21 (Page 2 of 2). RACF Estimated Storage Usage Storage Subpool Usage How to Estimate Size ELSQA Connect group table 64 + (48 × number_of_groups_connected) In-storage generic profiles 160 + number_of_generic_profiles × (14 + average_profile_size +average_profile_name_length) RACF storage track...
Page 58 - Templates for RACF on OS/390 Release 2
Templates for RACF on OS/390 Release 2 The RACF database must have templates at the Security Server (RACF) Release 2level in order for RACF to function properly. If a Security Server (RACF) Release 2system is sharing the database with a lower-level system (RACF 1.9, RACF 1.9.2,RACF 1.10, RACF 2.1, R...
Page 59 - Chapter 6. Customization Considerations; Exit Processing
Chapter 6. Customization Considerations This chapter identifies customization considerations for RACF. For additional information, see OS/390 Security Server (RACF) System Programmer's Guide. Customer Additions to the CDT Installations must verify that classes they have added to the class descriptor...
Page 60 - IRRSXT00 Installation Exit
– The first check uses the client ACEE. This is the ACEE that is associated with the current task. If the request is successful, the second check isperformed. – The second check uses the ACEE associated with the server. This is the same ACEE that is associated with the address space. When each of th...
Page 61 - Chapter 7. Administration Considerations; mvsexpt
Chapter 7. Administration Considerations This chapter summarizes the changes to administration procedures that the securityadministrator should be aware of. For more information, see OS/390 Security Server (RACF) Security Administrator's Guide. OS/390 OpenEdition DCE The interoperation of RACF with ...
Page 62 - Attention; Activating the DCEUUIDS Class; Single Signon to DCE
database. The mvsexpt utility takes a specified input file or the DCEregistry for each principal specified and creates the RACF DCE segmentand profiles in the RACF general resource class, DCEUUIDS. For more information on these utilities, see OpenEdition DCE Administration Guide. Although you can ad...
Page 63 - Specifying the DCE Encryption Key; OS/390 OpenEdition DCE Application Considerations
The MVS user must have saved the current DCE password in the RACF DCEsegment by invoking the DCE storepw command. Note: Users still need to maintain their passwords for RACF and OpenEdition DCE separately, and must use the DCE storepw to keep the DCEpassword that is stored in RACF current. Single ...
Page 64 - Threads and Security
OpenEdition Planning, and in OS/390 OpenEdition Programming: AssemblerCallable Services Reference. The C language support for thepthread_security_np() function is discussed in OS/390 R2 C/C ++ Run-Time Library Reference. Threads and Security An application that uses the pthread_security_np service c...
Page 65 - Changes to RACF Authorization Processing
Changes to RACF Authorization Processing Extensions have been introduced to RACF's processing of authorization requests inwhich both the RACF identity of the server and the RACF identity of a client of the server application are used in a resource access decision. RACF support for OpenEdition DCE in...
Page 66 - Controlling the R_dceruid Callable Service; Enhancements to the Remove ID Utility
resources. Profiles must reside in storage before RACROUTEREQUEST=FASTAUTH can be used to verify a user's access to a resource. The client/server relationship is not propagated from the application server. If the security administrator implements access control to resources that use both the serve...
Page 67 - SystemView for MVS
SystemView for MVS Before an installation can use SystemView for MVS, the security administratormust: Create profiles in the SYSMVIEW class for SystemView for MVS applications.The profiles define logon script and parameter information for the applications. Authorize SystemView for MVS users to a...
Page 69 - Chapter 8. Auditing Considerations; SMF Records
Chapter 8. Auditing Considerations This section summarizes the changes to auditing procedures for the RACF: SMF records Report writer utility SMF data unload utility The auditor must decide on appropriate global auditing options for the new classesand on which auditing reports are to be produc...
Page 70 - Auditing New OS/390 OpenEdition MVS Services
For more information on SMF records, see OS/390 Security Server (RACF) Macros and Interfaces. Figure 23 (Page 2 of 2). Changes to SMF Records RecordType RecordField Description of Change Support 80 Relocate65 For event code 2, this SMF recordcontains flags indicating the ACEE type: Unauthenticated...
Page 71 - SMF Data Unload Utility
Auditing OS/390 OpenEdition DCE Support RACF provides one new audit function code (94) to audit OS/390 OpenEdition DCEsupport. Auditing SystemView for MVS Support Depending on the auditing options selecting when using the RACF SMF dataunload utility (IRRADU00), customers might see SMF records return...
Page 73 - Chapter 9. Operational Considerations; Enhancements to the RESTART Command
Chapter 9. Operational Considerations This section summarizes the changes to operating procedures for RACF forOS/390 Release 2. Enhancements to the RESTART Command The RESTART command has been enhanced. The new SYSNAME keywordallows an operator to restart connections to systems on a multisystem node...
Page 75 - Chapter 10. Application Development Considerations; OS/390 OpenEdition DCE Application Servers
Chapter 10. Application Development Considerations Application development is the process of planning, designing, and codingapplication programs that invoke RACF functions. This section highlights newsupport that might affect application development procedures: Year 2000 support OS/390 OpenEditi...
Page 76 - New Application Services and Security
The security administrator has the option of enforcing the use of both theapplication server's RACF identity and the RACF identity of the client in resource access control decisions. RACF support for OS/390 OpenEdition DCE introduces new indicators in theACEE. These indicators mark the ACEE as a cli...
Page 79 - Chapter 11. General User Considerations
Chapter 11. General User Considerations RACF general users use RACF to: Log on to the system Access resources on the system Protect their own resources and any group resources to which they haveadministrative authority This chapter highlights new support that might affect general user procedur...
Page 81 - Chapter 12. NJE Considerations; Before Applying the PTF for APAR OW08457
Chapter 12. NJE Considerations Several APARs shipped on OS/390 Release 2 Security Server (RACF) haveimplications for NJE. APAR OW14451 OS/390 Release 2 Security Server (RACF) includes a PTF that provides functionsthat change the way inbound NJE jobs and NJE sysout are handled by RACF. Ifyour install...
Page 82 - Actions Required
Actions Required With OW08457 and OW14451, group propagation and group translation has beenfixed for NODES profiles, both for batch jobs and for SYSOUT. This change cansignificantly alter the external results of your NJE environment and your installationmust decide what changes will best suit your n...
Page 85 - Chapter 13. Scenarios; Migrating an Existing RRSF Network to Use Multisystem Nodes
Chapter 13. Scenarios This chapter contains scenarios that might help you in planning your migration toSecurity Server (RACF) Release 2. Migrating an Existing RRSF Network to Use Multisystem Nodes If an existing RRSF network contains single-system RRSF nodes that share aRACF database, you can reconf...
Page 87 - Note: Rerun the remaining commands after you complete step 5.
5. Issue a TARGET command from the operator's console to define system SYSTEM1 as the MAIN system for the multisystem node. (Issuing thiscommand allows you to reconfigure the node to make SYSTEM2 the mainsystem at some future time.) prefixTARGET NODE(MIAMI1) SYSNAME(SYSTEM1) LOCAL MAIN OPERATIVE PRE...
Page 88 - Note: The TARGET commands for SYSTEM1 and SYSTEM2 are now
On MIAMI2: 1. Issue a TARGET command from the operator's console to define the connection with ORLANDO. prefixTARGET NODE(ORLANDO) OPERATIVEPREFIX(...) PROTOCOL(...) WORKSPACE(...) Add this command to the RACF parameter library for SYSTEM2. Note: The TARGET commands for SYSTEM1 and SYSTEM2 are now i...
Page 89 - Glossary
Glossary A access. The ability to obtain the use of a protectedresource. access authority. An authority related to a request fora type of access to protected resources. In RACF, theaccess authorities are NONE, EXECUTE, READ,UPDATE, CONTROL, and ALTER. accessor environment element (ACEE). Adescriptio...
Page 97 - Index
Index A ADDUSER command 15 administration classroom courses xv administration considerations migration 2 Airline Control System/MVS, support for 11 ALCS/MVS support ALCSAUTH class 13 ALCS/MVS, support for 11 ALCSAUTH class 11, 13 ALTUSER command 15 application development considerations DCE support ...
Page 106 - Communicating Your Comments to IBM
Communicating Your Comments to IBM OS/390Security Server (RACF)Planning: Installation and Migration Publication No. GC28-1920-01 If you especially like or dislike anything about this book, please use one of the methodslisted below to send your comments to IBM. Whichever method you choose, make sure ...
Page 107 - Reader's Comments — We'd Like to Hear from You
Reader's Comments — We'd Like to Hear from You OS/390Security Server (RACF)Planning: Installation and Migration Publication No. GC28-1920-01 You may use this form to communicate your comments about this publication, its organization, or subjectmatter, with the understanding that IBM may use or distr...
Page 108 - BUSINESS REPLY MAIL
Cut or FoldAlong Line Cut or FoldAlong Line Reader's Comments — We'd Like to Hear from YouGC28-1920-01 IBM Fold and Tape Please do not staple Fold and Tape NO POSTAGENECESSARYIF MAILED IN THEUNITED STATES BUSINESS REPLY MAIL FIRST-CLASS MAIL PERMIT NO. 40 ARMONK, NEW YORK POSTAGE WILL BE PAID BY A...
Page 110 - Drop in
IBM Program Number: 5645-001 Printed in the United States of Americaon recycled paper containing 10%recovered post-consumer fiber. Drop in Back Cover Image Here. GC28-192ð-ð1