z/OS DFSMStvs Administration Guide
Previous topic |
Next topic
|
Contents
|
Contact z/OS
|
Library
|
PDF
Contents (exploded view)
z/OS DFSMStvs Administration Guide
GC52-1388-00
Abstract for DFSMStvs Administration Guide
z/OS Version 2 Release 1 summary of changes
Evaluating, planning, and installing DFSMStvs
Evaluating and planning for DFSMStvs
Software dependencies
z/OS
DFSMS
CICS Transaction Server
CICS VSAM Recovery
Global Resource Serialization
z/OS Security Server
IMS
DB2
Language products
Language Environment
Programming languages and environments
Processing restrictions
Migrating to z/OS Version 1 Release 4
SYS1.PARMLIB changes for DFSMStvs
JCL changes for DFSMStvs
System command changes for DFSMStvs
Access method services
Macros
Messages and codes
Migration tasks
Additional information
Installing DFSMStvs
Enabling DFSMStvs on your z/OS system
Coding IGDSMSxx
Administering resources for DFSMStvs
Controlling access to VSAM data sets
Accessing data sets in DFSMStvs mode
Using VSAM record-level sharing
Record-level sharing CF caching
CICS use of VSAM RLS
Recoverable and nonrecoverable data sets
CICS transactional recovery for VSAM recoverable data sets
Non-CICS use of VSAM RLS
Read sharing of recoverable data sets
Read-sharing integrity across KSDS CI and CA splits
Read and write sharing of nonrecoverable data sets
Non-RLS access to VSAM data sets
Differences between RLS access and non-RLS access
Share options
Locking
Retaining locks
Supporting non-RLS access while retained locks exist
VSAM options not supported by RLS
VSAM RLS request execution mode requirements
VSAM RLS read integrity options
Specifying read integrity
Specifying a timeout value for lock requests
Defining data sets for DFSMStvs access
Allocating data sets
Restrictions
Allocation of SMS-managed data sets
Allocation of non-SMS-managed data sets
Return codes for the ALLOCATE command
Syntax for ALLOCATE parameters
Required parameters
Optional parameters
ALLOCATE examples
Allocate a data set using SMS class specifications: Example 1
Allocate a VSAM data set using SMS class specifications: Example 2
Allocate a new data set: Example 3
Allocate a non-VSAM data set: Example 4
Allocate a partitioned data set extended: Example 5
Listing and controlling SMSVSAM recovery
SHCDS parameters
Required parameters
Optional parameters
SCHDS examples
Using PERMITNONRLSUPDATE with a generic data set name specification: Example 1
Listing data sets with the high-level qualifier SYSPLEX: Example 2
Listing data sets with JOBS: Example 3
Listing shunted entries: Example 4
Altering data set attributes
Entry types that can be altered
ALTER parameters
Required parameters
Optional parameters
ALTER examples
Alter a cluster's attributes using SMS keywords: Example 1
Roll-In a generation data set: Example 2
Alter the entry names of generically named clusters: Example 3
Alter the attributes of a generation data group: Example 4
Alter a data set expiration date: Example 6
Migrate a DB2® cluster to a linear data set cluster: Example 7
Alter a cluster name and the associated data and index names: Example 8
Defining alternate indexes
DEFINE ALTERNATEINDEX parameters
Required parameters
Optional parameters
Data and index components of an alternate index
DEFINE ALTERNATEINDEX examples
Define an alternate index using SMS data class specification: Example 1
Define an SMS-managed alternate index: Example 2
Define an alternate index: Example 3
Define an alternate index with RECATALOG: Example 4
Defining attributes for clusters and cluster components
DEFINE CLUSTER parameters
Required parameters
Optional parameters
Data and index components of a cluster
DEFINE CLUSTER examples
Define an SMS-managed key-sequenced cluster: Example 1
Define an SMS-managed key-sequenced cluster specifying data and index parameters: Example 2
Define a key-sequenced cluster specifying data and index parameters: Example 3
Define a key-sequenced cluster and an entry-sequenced cluster: Example 4
Define a relative record cluster in a catalog: Example 5
Define a reusable entry-sequenced cluster in a catalog: Example 6
Define a key-sequenced cluster in a catalog: Example 7
Define an entry-sequenced cluster using a model: Example 8
Define a VSAM volume data set: Example 9
Define a relative record data set with expiration date beyond 1999: Example 10
Define a linear data set cluster in a catalog: Example 11
Securing log streams
Customizing the DFSMStvs environment
Coding VSAM macros
Subparameters with GENCB, MODCB, SHOWCB, and TESTCB
Use of list, execute, and generate forms of VSAM macros
List-form keyword
Execute-form keyword
Generate-form keyword
Examples of generate, list, and execute forms
Example: Generate form (reentrant)
Example: Remote-list form (reentrant)
Example: Execute form (reentrant)
ACB—generate an access method control block at assembly time
Example 1: ACB macro
Example 2: ACB macro
EXLST—generate an exit list at assembly time
EXLST macro syntax
Example: EXLST macro
GENCB—generate an access method control block at execution time
Example 1: GENCB macro (generate an access method control block)
Example 2: GENCB macro (generate an access method control block)
GENCB—generate an exit list at execution time
Example: GENCB macro (generate an exit list)
GENCB—generate a request parameter list at execution time
Building a chain of request parameter lists
Example: GENCB macro (generate a request parameter list)
Example: GENCB macro (generate a request parameter list)
GENCB—list form
GENCB—execute form
GENCB—generate form
IDALKADD—RLS record locking
MODCB—modify an access method control block
Example: MODCB macro (modify an access method control block)
MODCB—modify an exit list
Example: MODCB macro (modify an exit list)
MODCB—modify a request parameter list
Example: MODCB macro (modify a request parameter list)
MODCB—list form
MODCB—execute form
MODCB—generate form
RPL—generate a request parameter list at assembly time
RPL macro syntax
Example: RPL macro
SCHBFR—search buffer
SHOWCAT—display the catalog
SHOWCAT—standard form
SHOWCAT—list form
SHOWCAT—execute form
Expressions that can be used for SHOWCAT
Understanding VSAM macro return and reason codes
OPEN return and reason codes
CLOSE return and reason codes
Control block manipulation macro return and reason codes
Record management return and reason codes
Return codes (RPLRTNCD)
Asynchronous request
Synchronous request
Component codes (RPLCMPON)
Reason codes (RPLERRCD)
Reason code (successful request)
Reason code (logical errors)
Positioning following logical errors
Reason code (physical errors)
Reason code (server errors)
Return codes from macros used to share resources among data sets
BLDVRP return codes
DLVRP return codes
End-of-volume return codes
SHOWCAT return codes
Coding VSAM user-written exit routines
General guidelines for coding exit routines
Programming guidelines
Information
Multiple request parameter lists or data sets
Return to a main program
IGW8PNRU routine for batch override
Register contents
Programming considerations
EODAD exit routine to process end of data
Register contents
Programming considerations
EXCEPTIONEXIT exit routine
Register contents
Programming considerations
JRNAD exit routine to journalize transactions
Register contents
Programming considerations
Journalizing transactions
RBA changes
Control interval splits
Parameter list
LERAD exit routine to analyze logical errors
Register contents
Programming considerations
RLSWAIT exit routine
Register contents
Request environment
SYNAD exit routine to analyze physical errors
Register contents
Programming considerations
Example of a SYNAD user-written exit routine
UPAD exit routine for user processing
Register contents
Programming considerations
User-security-verification routine
Programming applications to use DVSMStvs
Modifying applications to use DFSMStvs
Designing and coding applications to use DFSMStvs
Handling DFSMStvs error codes
Module identifiers
Initialization reason codes
Open and close reason codes
Command processor reason codes
Front end (VSAM record management) reason codes
Message processing reason codes
Quiesce reason codes
Shunt processing reason codes
Restart reason codes
Peer recovery reason codes
Syncpoint reason codes
Miscellaneous reason codes
Logging reason code prefixes
Logging services reason codes
Operating in the DFSMStvs transaction processing environment
Setting up the storage management subsystem
Preparing for the storage management subsystem
Allocating control data sets
Calculating the size of storage and active control data sets
Calculating the size of a COMMDS
Selecting volumes for control data sets
Allocating an SCDS
Allocating an ACDS
Allocating a COMMDS
Modifying the SYS1.PARMLIB data set
Starting the SMS address space
Accessing the storage administrator Primary Option Menu
Activating storage management subsystem configurations
Manually activating a storage management subsystem configuration
Step 1: IPL each system in the SMS complex
Step 2: Prepare one system
Step 3: Activate the configuration from one system
Activating with the ISMF ACTIVATE command
Activating with the SETSMS operator command
Step 4: Activate SMS on the other systems
Automatically activating a storage management subsystem configuration
Changing storage management subsystem parameters
Parameters of the SETSMS operator command
Considerations for changing storage management subsystem configurations
OAM considerations for changing SCDSs
Displaying storage management subsystem information
Changing storage management subsystem parameters
Controlling DVSMStvs processing
Monitoring application programs that use DFSMStvs
Changing DFSMStvs status
Maintaining data integrity during backup-while-open processing
Data integrity—serialization
Backup-while-open data sets (CICS and DFSMStvs)
Backup-while-open status definition
Backup-while-open processing
Backup-while-open and concurrent copy
TOLERATE (ENQFAILURE) and SHARE considerations
Recovery data
Diagnosing DFSMStvs problems
Incorrect output keyword
Procedure
VSAM RLS—incorrect output keyword
Procedure
DFSMStvs—incorrect output keyword
Procedure
Catalog management—incorrect output keyword
Procedure
Abend keyword
Symptoms of the failure
Procedure
Procedure for SVC dump
Procedure for SYSABEND, SYSMDUMP, or SYSUDUMP
Procedure for building the abend keyword
Message keyword
Procedure
Definitions of message keyword terms
VSAM, DFSMStvs, and VSAM RLS record management—message keyword
Procedure
VSAM diagnostic aids
Access method services (AMS) diagnostic aids
Trace tables
Intermodule trace table
Intramodule trace table
Dump points
TEST option
TEST keyword
How to use the TEST option
Catalog management diagnostic aids
VSAM OPEN/CLOSE/end-of-volume (O/C/EOV) diagnostic aids
Generalized trace facility
VSAM GTF X'F61' record
Considerations for requesting X'F61' records
Mapping of the X'F61' record
Interactive problem control system (IPCS)
Printing GTF records
Input
Output
VSAM OPEN/CLOSE/End-of-Volume return and reason codes
VSAM record-level sharing diagnostic aids
VSAM RLS component trace
TRACE command for VSAM RLS component trace
Trace options
Formatting the VSAM RLS component trace table
SMSVSAM abends
Activation of the SMSVSAM address space
Termination of the SMSVSAM address space
Console dumps
SMSVSAM initialization errors
Sharing-control problems
VSAM RLS hang conditions
VSAM RLS deadlock and timeout problems
VSAM record-level sharing return and reason codes
Return codes from SMSVSAM
Return codes from SMPM_CFPurge
Return codes from SMPM_CFQuery
VSAM record management (R/M) diagnostic aids
Control block information
UPAD exit or WAITX
RLSWAIT exit
Error conditions
Exclusive control error analysis
ABEND0CX error analysis
Damaged data sets (Non-RLS access)
Determining which data set might be damaged
Damaged indexes
Recovering from index damage
Damaged data control intervals
Recovering from data CI damage
Physical I/O errors
VSAM record management trace facility (non-RLS access)
When to use the record management trace facility
Starting the record management trace function
Example of a DD statement requesting trace
Adding trace points
Ending the record management trace function
Printing the record management trace output
VSAM record management return and reason codes
Return codes from the record-management (request) macros
Function codes for logical and physical errors
Logical-error return codes
Physical-error return codes
Control block manipulation return codes
Copyright IBM Corporation 1990, 2014