SX26-3807-05
DFSMS/MVS Version 1 Release 5 IBM
Summary of Access Method
Services for the Integrated
Catalog Facility
SX26-3807-05
Note!
Before using this information and the product it supports, be sure to read
the general information under “Notices” on page v.
Order publications through your IBM representative or the IBM branch office
serving your locality. Publications are not stocked at the address given below.
A form for readers' comments appears at the back of this publication. If the
form has been removed, address your comments to:
When you send information to IBM, you grant IBM a nonexclusive right to use
or distribute the information in any way it believes appropriate without incurring
any obligation to you.
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Notational Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Functional Commands . . . . . . . . . . . . . . . . . . . . . . . . . 1
ALLOCATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
ALTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
ALTER LIBRARYENTRY . . . . . . . . . . . . . . . . . . . . . . . . . 3
ALTER VOLUMEENTRY . . . . . . . . . . . . . . . . . . . . . . . . . 4
BLDINDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
CNVTCAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
CREATE LIBRARYENTRY . . . . . . . . . . . . . . . . . . . . . . . . 6
CREATE VOLUMEENTRY . . . . . . . . . . . . . . . . . . . . . . . . 6
DCOLLECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
DEFINE ALIAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
DEFINE ALTERNATEINDEX . . . . . . . . . . . . . . . . . . . . . . . 8
DEFINE CLUSTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
DEFINE GENERATIONDATAGROUP . . . . . . . . . . . . . . . . . . 13
DEFINE NONVSAM . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
DEFINE PAGESPACE . . . . . . . . . . . . . . . . . . . . . . . . . . 14
DEFINE PATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
DEFINE USERCATALOG|MASTERCATALOG . . . . . . . . . . . . . 15
DELETE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
DIAGNOSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
EXAMINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
EXPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
EXPORT DISCONNECT . . . . . . . . . . . . . . . . . . . . . . . . . 19
IMPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
IMPORT CONNECT . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
LISTCAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
PRINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
REPRO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
VERIFY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
SHCDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Modal Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
CANCEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
IF-THEN-ELSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
PARM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Licensees of this program who wish to have information about it for the
purpose of enabling: (i) the exchange of information between independently
created programs and other programs (including this one) and (ii) the mutual
use of the information which has been exchanged, should contact:
IBM Corporation
Information Enabling Requests
Dept. DWZ
5600 Cottle Road
San Jose, CA 95193
Any pointers in this publication to non-IBM Web sites are provided for con-
venience only, and do not in any manner serve as an endorsement of these
Web sites.
AIX
DFSMS/MVS
IBM
This book does not apply to access method services commands for VSAM
catalogs, and should not be used as a substitute for DFSMS/MVS Access
Method Services for VSAM, SC26-4905 .
| Passwords are no longer honored for protecting an ICF catalog, or data sets
| contained in an ICF catalog. If they are specified, they will be ignored and no
| message will be issued. Previously, passwords were ignored only for
| SMS-managed data sets. RACF, or an equivalent security package, should
| be used to protect data.
| All instances of passwords have been deleted from the command syntax in
| this book. Also note that passwords in parameters such as ATTEMPTS,
| AUTHORIZATION, CODE, and LOCK will be ignored.
Notational Conventions
The command syntax definitions in this book use the following notational
conventions:
[ ] Brackets enclose an optional entry. You may, but need not,
include the entry.
| An OR sign (a vertical bar) separates alternative entries. You
must specify one, and only one, of the entries unless you allow
an indicated default.
{ } Braces enclose alternative entries. You must use one, and only
one, of the entries.
... An ellipsis indicates that the entry immediately preceding the
ellipsis may be repeated.
‘ ’ A ‘ ’ indicates that a blank (an empty space) must be present
before the next parameter.
UPPERCASE BOLDFACE
Uppercase boldface type indicates entries that you must code
exactly as shown. These entries consist of keywords and the fol-
lowing punctuation symbols: commas, parentheses, and equal
signs.
viii DFSMS/MVS V1R3 Summary of the Access Method Services for ICF
Functional Commands
ALLOCATE
Dynamically allocate VSAM and non-VSAM data sets
ALTER
Modify attributes of previously defined catalog entries
[CATALOG(catname)] CAT
ALTER LIBRARYENTRY
Modify attributes of previously defined tape library entries
3
Parameters for ALTER LIBRARYENTRY Abbreviation
[NULLIFY([LIBDEVTYPE][LOGICALTYPE])] LDEVT
LOGTYP
[NUMBEREMPTYSLOTS(numslots)] NUMESLT
[NUMBERSCRATCHVOLUMES(MEDIA1(num) NUMSCRV
MEDIA2(num) MEDIA3(num) MEDIA4(num))]
[NUMBERSLOTS(numslots)] NUMSLT
[SCRATCHTHRESHOLD(MEDIA1(num) MEDIA2(num) SCRTHR
MEDIA3(num) MEDIA4(num))]
ALTER VOLUMEENTRY
Modify attributes of previously defined tape volume entries
[CATALOG(catname)] CAT
CNVTCAT
Convert VSAM catalog or OS CVOL entries into integrated catalog facility
catalog entries
5
CREATE LIBRARYENTRY
Create tape library entries
CREATE VOLUMEENTRY
Create tape volume entries
DCOLLECT
Collect data set, volume usage, and migration utility information
DEFINE ALIAS
Define an alternate name for a user catalog or a non-VSAM data set
7
DEFINE ALTERNATEINDEX
Define a catalog entry for an alternate index
[DATA( —
{CYLINDERS(primary[ secondary])| CYL
KILOBYTES(primary[ secondary])| KB
[INDEX( IX
{CYLINDERS(primary[ secondary])| CYL
KILOBYTES(primary[ secondary])| KB
MEGABYTES(primary[ secondary])| MB
RECORDS(primary[ secondary])| REC
TRACKS(primary[ secondary])} TRK
[VOLUMES(volser[ volser...])] VOL
[ATTEMPTS(number)] ATT
[AUTHORIZATION(entrypoint[ string])] AUTH
[CODE(code)] —
[CONTROLINTERVALSIZE(size)] CISZ, CNVSZ
[EXCEPTIONEXIT(entrypoint)] EEXT
[FILE(ddname)] —
[IMBED|NOIMBED] IMBD NIMBD
[MODEL(entryname [ catname])] —
[NAME(entryname)] —
[ORDERED|UNORDERED] ORD UNORD
[OWNER(ownerid)] —
[REPLICATE|NOREPLICATE] REPL NREPL
9
Parameters for DEFINE ALTERNATEINDEX Abbreviation
[REUSE|NOREUSE] RUS NRUS
[SHAREOPTIONS(crossregion[ crosssystem])] SHR
[WRITECHECK|NOWRITECHECK])] WCK NWCK
[CATALOG(catname)] CAT
Notes:
1. CYLINDERS, KILOBYTES, MEGABYTES, RECORDS, or TRACKS
must be specified either as a parameter of ALTERNATEINDEX, as a
parameter of DATA, or as a parameter of both DATA and INDEX. CYL-
INDERS, RECORDS, or TRACKS is not required if MODEL is specified.
2. VOLUMES must be specified as a parameter of ALTERNATEINDEX or
as a parameter of both DATA and INDEX if MODEL is not specified or if
the base cluster is not managed by SMS.
DEFINE CLUSTER
Define a catalog entry for a VSAM cluster
[DATA( —
{CYLINDERS(primary[ secondary])| CYL
KILOBYTES(primary[ secondary])| KB
MEGABYTES(primary[ secondary])| MB
RECORDS(primary[ secondary])| REC
TRACKS(primary[ secondary])}
[VOLUMES(volser[ volser...])] VOL
[ATTEMPTS(number)] ATT
[AUTHORIZATION(entrypoint[ string])] AUTH
[BUFFERSPACE(size)] BUFSP,
BUFSPC
[CODE(code)] —
[CONTROLINTERVALSIZE(size)] CISZ, CNVSZ
[ERASE|NOERASE] ERAS NERAS
[EXCEPTIONEXIT(entrypoint)] EEXT
[FILE(ddname)] —
[FREESPACE(CI-percent[ CA-percent]) ]3 FSPC
[KEYRANGES((lowkey highkey)3 KRNG
[(lowkey highkey)...])]
[KEYS(length offset)]3 —
[MODEL(entryname[ catname])] —
[NAME(entryname)] —
[ORDERED|UNORDERED] ORD UNORD
[OWNER(ownerid)] —
[RECORDSIZE(average maximum)] RECSZ
[REUSE|NOREUSE] RUS NRUS
11
Parameters for DEFINE CLUSTER Abbreviation
[SHAREOPTIONS(crossregion[ crosssystem])] SHR
[SPANNED|NONSPANNED]4 SPND NSPND
[SPEED|RECOVERY] — RCVY
[WRITECHECK|NOWRITECHECK])] WCK NWCK
[INDEX(3 IX
{CYLINDERS(primary[ secondary])| CYL
KILOBYTES(primary[ secondary])| KB
MEGABYTES(primary[ secondary])| MB
RECORDS(primary[ secondary])| REC
TRACKS(primary[ secondary])} TRK
[VOLUMES(volser[ volser...])] VOL
[ATTEMPTS(number)] ATT
[AUTHORIZATION(entrypoint[ string])] AUTH
[CODE(code)] —
[CONTROLINTERVALSIZE(size)] CISZ,CNVSZ
[EXCEPTIONEXIT(entrypoint)] EEXT
[FILE(ddname)] —
[IMBED|NOIMBED]3 IMBD NIMBD
[MODEL(entryname[ catname])] —
[NAME(entryname)] —
[ORDERED|UNORDERED] ORD UNORD
[OWNER(ownerid)] —
[REPLICATE|NOREPLICATE]3 REPL NREPL
[REUSE|NOREUSE] RUS NRUS
[SHAREOPTIONS(crossregion[crosssystem])] SHR
[WRITECHECK|NOWRITECHECK])] WCK NWCK
[CATALOG(catname)] CAT
Notes:
1. CYLINDERS, KILOBYTES, MEGABYTES, RECORDS, or TRACKS
must be specified either as a parameter of CLUSTER, as a parameter
of DATA, or as a parameter of both DATA and INDEX. CYLINDERS,
RECORDS, or TRACKS is not required if MODEL or RECATALOG is
specified.
2. VOLUMES must be specified as a parameter of CLUSTER or as a
parameter of both DATA and INDEX if MODEL is not specified or if the
base cluster is not managed by SMS.
3. Can only be specified for a key-sequenced cluster.
4. When SPANNED is specified, the default is RECORDSIZE
(4086 32600). Otherwise, the default is RECORDSIZE (4089 4089).
[CATALOG(catname)] CAT
DEFINE NONVSAM
Define a catalog entry for a non-VSAM data set
[CATALOG(catname)] CAT
Note:
1. When COLLECTION is used, DEVICETYPES and VOLUMES are not
required and are ignored if specified.
13
DEFINE PAGESPACE
Define a catalog entry for a page space
[CATALOG(catname)] CAT
DEFINE PATH
Define a relationship between an alternate index and its base cluster
[CATALOG(catname)] CAT
DEFINE USERCATALOG|MASTERCATALOG
Create an integrated catalog facility user or master catalog
15
Parameters for DEFINE UCAT|MCAT Abbreviation
[TO(date)|FOR(days)] ——
[WRITECHECK|NOWRITECHECK]) WCK NWCK
[DATA —
{CYLINDERS(primary[ secondary])| CYL
KILOBYTES(primary[ secondary])| KB
MEGABYTES(primary[ secondary])| MB
RECORDS(primary[ secondary])| REC
TRACKS(primary[ secondary])} TRK
[BUFFERSPACE(size)] BUFSP,
BUFSPC
[BUFND(number)] BFND
[CONTROLINTERVALSIZE(size)] CISZ, CNVSZ
[FREESPACE(CI-percent[ CA-percent]|0 0)] FSPC
[RECORDSIZE(average maximum| 4086 32400)] RECSZ
[WRITECHECK|NOWRITECHECK])] WCK NWCK
[INDEX IX
{CYLINDERS(primary[ secondary])| CYL
KILOBYTES(primary[ secondary])| KB
MEGABYTES(primary[ secondary])| MB
RECORDS(primary[ secondary])| REC
TRACKS(primary[ secondary])} TRK
[BUFNI(number)] BFNI
[CONTROLINTERVALSIZE(size)] CISZ or
CNVSZ
[IMBED|NOIMBED] IMBD NIMBD
[REPLICATE|NOREPLICATE] REPL NREPL
[WRITECHECK|NOWRITECHECK])] WCK NWCK
[CATALOG(mastercatname)] CAT
Notes:
1. CYLINDERS, KILOBYTES, MEGABYTES, RECORDS, or TRACKS
must be specified either as a parameter of UCAT|MCAT, as a parameter
of DATA, or as a parameter of both DATA and INDEX. CYLINDERS,
RECORDS, or TRACKS is not required if MODEL is specified.
2. VOLUME must be specified as a parameter of UCAT|MCAT or as a
parameter of both DATA and INDEX if MODEL is not specified or if the
base cluster is not managed by SMS.
[CATALOG(catname)] CAT
Note:
1. When you delete a truename, user catalog, or VVR entry, you cannot
delete any other type of entry. You must identify the type of entry to be
deleted by specifying TRUENAME, USERCATALOG, NVR, or VVR.
17
DIAGNOSE
Diagnose data structures
EXAMINE
Inspect key-sequenced data set clusters
EXPORT DISCONNECT
Disconnect a user catalog
IMPORT
Restore a VSAM cluster, alternate index, or integrated catalog facility catalog
from an EXPORT portable data set
19
Parameters for IMPORT Abbreviation
[LOCK|UNLOCK] ——
[OBJECTS((entryname OBJ
[FILE(ddname)] —
[KEYRANGES((lowkey highkey) KRNG
[(lowkey highkey)...])]
[MANAGEMENTCLASS(class)] MGMTCLAS
[NEWNAME(newname)] NEWNM
[ORDERED|UNORDERED] ORD, UNORD
[STORAGECLASS(class)] STORCLAS
[VOLUMES(volser[ volser...])]) VOL
[(entryname...)...])]
[PURGE|NOPURGE] PRG, NPRG
[SAVRAC|NOSAVRAC] ——
[CATALOG(catname)] CAT
IMPORT CONNECT
Connect a user catalog
[CATALOG(catname)] CAT
LISTCAT
List entries from a catalog
[CREATION(days)] CREAT
[ENTRIES(entryname[ entryname...])| ENT
LEVEL(level)] LVL
[EXPIRATION(days)] EXPIR
[FILE(ddname)] —
[LIBRARY(libname)] LIB
[NAME|HISTORY|VOLUME| — HIST VOL
ALLOCATION|ALL] ALLOC —
[OUTFILE(ddname)] OFILE
[CATALOG(catname)] CAT
PRINT
Print the contents of a data set
21
REPRO
Copy data sets, copy catalogs, and split or merge catalogs
[ENCIPHER1 ENCPHR
({EXTERNALKEYNAME(keyname)| EKN
INTERNALKEYNAME(keyname)| IKN
PRIVATEKEY} PRIKEY
[CIPHERUNIT(number|1)] CPHRUN
[DATAKEYFILE(ddname)| DKFILE
DATAKEYVALUE(value)] DKV
[SHIPKEYNAMES(keyname[ keyname...])] SHIPKN
[STOREDATAKEY|NOSTOREDATAKEY] STRDK
NSTRDK
[STOREKEYNAME(keyname)] STRKN
[USERDATA(value)])] UDATA
[DECIPHER1 DECPHR
({DATAKEYFILE(ddname)| DKFILE
Note:
1. ENCIPHER and DECIPHER apply only with IBM Programmed
Cryptographic Facility (5740-XY5) or IBM Cryptographic Unit Support
(5740-XY6).
VERIFY
Restore a VSAM cluster's end-of-file values
SHCDS
List SMSVSAM recovery related to online applications and spheres
accessed in RLS mode
23
Parameters for SHCDS Abbreviation
[CFRESET({INFILE(ddname)|INDATASET(dsname)}] CFRES
[({LIST|NOLIST})]]| —
[CFRESETDS(base-cluster)} CFRDS
[OUTFILE(ddname)] OUTDD
CANCEL
Terminates processing of the current job step.
CANCEL
IF-THEN-ELSE
Controls command execution on the basis of condition codes.
PARM
Specifies diagnostic aids and printed output options.
PARM [TEST({[TRACE]
[AREAS(areaid[ areaid...])]
[FULL((dumpid[ count1[ count2]])[(dumpid...)...])]|
OFF})]
[GRAPHICS(CHAIN(chain)|TABLE(mname))]
[MARGINS(leftmargin rightmargin)]
SET {MAXCC|LASTCC}=number
Overall, how satisfied are you with the information in this book?
Very Very
Satisfied Satisfied Neutral Dissatisfied Dissatisfied
Overall satisfaction Ø Ø Ø Ø Ø
How satisfied are you that the information in this book is:
Very Very
Satisfied Satisfied Neutral Dissatisfied Dissatisfied
Accurate Ø Ø Ø Ø Ø
Complete Ø Ø Ø Ø Ø
Easy to find Ø Ø Ø Ø Ø
Easy to understand Ø Ø Ø Ø Ø
Well organized Ø Ø Ø Ø Ø
Applicable to your tasks Ø Ø Ø Ø Ø
Name Address
Company or Organization
Phone No.
NO POSTAGE
NECESSARY
IF MAILED IN THE
UNITED STATES
SX26-38ð7-ð5