access method services

DFSMS/MVS Version 1 Release 5 IBM

Summary of Access MethodServices for the IntegratedCatalog Facility

SX26-3807-05

Note!

Before using this information and the product it supports, be sure to readthe general information under “Notices” on page v.

Sixth Edition (March 1999)

This edition applies to Version 1 Release 5 of DFSMS/MVS (5695-DF1),Release 7 of OS/390 (5647-A01), and any subsequent releases until otherwiseindicated in new editions. Make sure you are using the correct edition for thelevel of the product.

Order publications through your IBM representative or the IBM branch officeserving your locality. Publications are not stocked at the address given below.

A form for readers' comments appears at the back of this publication. If theform has been removed, address your comments to:

International Business Machines CorporationRCF Processing Department

G26/0505600 Cottle RoadSAN JOSE, CA 95193-0001

U.S.A.

Or you can send your comments electronically to [email protected].

When you send information to IBM, you grant IBM a nonexclusive right to useor distribute the information in any way it believes appropriate without incurringany obligation to you.

Copyright International Business Machines Corporation 1973, 1999. Allrights reserved.Note to U.S. Government Users — Documentation related to restricted rights —Use, duplication or disclosure is subject to restrictions set forth in GSA ADPSchedule Contract with IBM Corp.

Contents

Notices . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vTrademarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiNotational Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Functional Commands . . . . . . . . . . . . . . . . . . . . . . . . . 1ALLOCATE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1ALTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2ALTER LIBRARYENTRY . . . . . . . . . . . . . . . . . . . . . . . . . 3ALTER VOLUMEENTRY . . . . . . . . . . . . . . . . . . . . . . . . . 4BLDINDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5CNVTCAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5CREATE LIBRARYENTRY . . . . . . . . . . . . . . . . . . . . . . . . 6CREATE VOLUMEENTRY . . . . . . . . . . . . . . . . . . . . . . . . 6DCOLLECT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7DEFINE ALIAS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7DEFINE ALTERNATEINDEX . . . . . . . . . . . . . . . . . . . . . . . 8DEFINE CLUSTER . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10DEFINE GENERATIONDATAGROUP . . . . . . . . . . . . . . . . . . 13DEFINE NONVSAM . . . . . . . . . . . . . . . . . . . . . . . . . . . 13DEFINE PAGESPACE . . . . . . . . . . . . . . . . . . . . . . . . . . 14DEFINE PATH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14DEFINE USERCATALOG|MASTERCATALOG . . . . . . . . . . . . . 15DELETE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17DIAGNOSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18EXAMINE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18EXPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19EXPORT DISCONNECT . . . . . . . . . . . . . . . . . . . . . . . . . 19IMPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19IMPORT CONNECT . . . . . . . . . . . . . . . . . . . . . . . . . . . 20LISTCAT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20PRINT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21REPRO . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22VERIFY . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23SHCDS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Modal Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25CANCEL . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25IF-THEN-ELSE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25PARM . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25SET . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Copyright IBM Corp. 1973, 1999 iii

iv DFSMS/MVS V1R3 Summary of the Access Method Services for ICF

Notices

References in this publication to IBM products, programs, or services do notimply that IBM intends to make these available in all countries in which IBMoperates.

Any reference to an IBM product, program, or service is not intended to stateor imply that only that IBM product, program, or service may be used. Anyfunctionally equivalent product, program, or service that does not infringeany of the intellectual property rights of IBM may be used instead of the IBMproduct, program, or service. The evaluation and verification of operation inconjunction with other products, programs, or services, except thoseexpressly designated by IBM, are the responsibility of the user.

IBM may have patents or pending patent applications covering subjectmatter in this document. The furnishing of this document does not give youany license to these patents. You can send license inquiries, in writing, to:

IBM Director of Licensing IBM Corporation

North Castle DriveArmonk, NY 10504-1785

USA

Licensees of this program who wish to have information about it for thepurpose of enabling: (i) the exchange of information between independentlycreated programs and other programs (including this one) and (ii) the mutualuse of the information which has been exchanged, should contact:

IBM CorporationInformation Enabling Requests

Dept. DWZ5600 Cottle RoadSan Jose, CA 95193

Such information may be available, subject to appropriate terms and condi-tions, including in some cases, payment of a fee.

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 theseWeb sites.

Copyright IBM Corp. 1973, 1999 v

TrademarksThe following terms are trademarks of the IBM Corporation in the UnitedStates, or other countries, or both:

AIXDFSMS/MVSIBM

vi DFSMS/MVS V1R3 Summary of the Access Method Services for ICF

Preface

This booklet summarizes the commands and parameters detailed inDFSMS/MVS Access Method Services for ICF, SC26-4906 which should bereferred to for detailed information on access method services.

This book does not apply to access method services commands for VSAMcatalogs, and should not be used as a substitute for DFSMS/MVS AccessMethod 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 ConventionsThe command syntax definitions in this book use the following notationalconventions:

[ ] Brackets enclose an optional entry. You may, but need not,include the entry.

| An OR sign (a vertical bar) separates alternative entries. Youmust specify one, and only one, of the entries unless you allowan indicated default.

{ } Braces enclose alternative entries. You must use one, and onlyone, of the entries.

... An ellipsis indicates that the entry immediately preceding theellipsis may be repeated.

‘ ’ A ‘ ’ indicates that a blank (an empty space) must be presentbefore the next parameter.

UPPERCASE BOLDFACEUppercase boldface type indicates entries that you must codeexactly as shown. These entries consist of keywords and the fol-lowing punctuation symbols: commas, parentheses, and equalsigns.

Copyright IBM Corp. 1973, 1999 vii

UNDERSCORED UPPERCASE BOLDFACEUnderscored uppercase boldface type indicates the default usedif you do not specify any of the alternatives.

Lowercase ItalicLowercase italic type indicates a value to be supplied by you,the user, usually according to specifications and limits describedfor each parameter.

viii DFSMS/MVS V1R3 Summary of the Access Method Services for ICF

Functional Commands

ALLOCATEDynamically allocate VSAM and non-VSAM data sets

Parameters for ALLOCATE Abbreviation

ALLOCATE ALLOC{DATASET( dsname)[FILE(ddname)]} DA, DSN,

DSNAME[ACCODE(access code)] —[ALTFILE( name)] —[AVGREC(U|K|M)] —[BFALN( F|D)] —[BFTEK( S|E|A|R)] —[BLKSIZE( value)] —[BUFL( buffer-length)] —[BUFNO(number-of-buffers)] —[BUFOFF({ block-prefix-length|L } )] —[DATACLAS( data-class-name)] —[DEN(0|1|2|3|4)] —[DIAGNS(TRACE)] —[DIR(integer)] —[DSNTYPE(LIBRARY|PDS)][DSORG(DA|DAU|PO|POU|PS|PSU)] —[EROPT(ACC|SKP|ABE)] —[EXPDT(year-day)|RETPD(no.-of-days)] —[KEEP|CATALOG] —[KEYLEN( bytes)] —[KEYOFF(offset)] —[LABEL( type)] —[LIKE( model-dsname)] —[LIMCT(search-number)] —[LRECL({ logical-record-length|(nnnnnK|X)})] [MGMTCLAS( management-class-name)] —[MAXVOL( count)] —[NEW] —[NCP(no.-of-channel-programs)] —[OPTCD(A,B,C,E,F,H,J,Q,R,T,W,Z)] —[POSITION(sequence-no.)] —[PRIVATE] —[PROTECT] —[RECFM(A,B,D,F,M,S,T,U,V)] —[RECORG(ES|KS|LS|RR)] —[REFDD(file-name)] —[RELEASE] —

Copyright IBM Corp. 1973, 1999 1

Parameters for ALLOCATE Abbreviation

[REUSE] —[ROUND] —[SECMODEL(profile-name[,GENERIC])] —[SPACE(quantity[,increment]) —{BLOCK( value)|AVBLOCK( value)| —CYLINDERS|TRACKS}] — TRK[STORCLAS( storage-class-name)] —[TRTCH(C|E|ET|T)] —[UCOUNT(count)|PARALLEL] —[UNIT(type)] —[VOLUME(serial-list)] —[VSEQ(vol-seq-no.)] —

ALTERModify attributes of previously defined catalog entries

Parameters for ALTER Abbreviation

ALTER —entryname —[ACCOUNT(account—info)] ACCT[ADDVOLUMES( volser[ volser...])] AVOL[ATTEMPTS(number)] ATT[AUTHORIZATION( entryname[ string])] AUTH[BUFFERSPACE( size)] BUFSP, BUFSPC[BUFND(number)] BFND[BUFNI(number)] BFNI[BWO( typecics|typeims|no) —[CCSID(value)] —[CODE(code)] —

| [ECSHARING|NOECSHARING]| ECS NECS[EMPTY|NOEMPTY] EMP NEMP[ERASE|NOERASE] ERAS NERAS[EXCEPTIONEXIT(entrypoint)] EEXT[FILE(ddname)] —[FILEDATA(TEXT|BINARY)] —[FREESPACE(CI-percent[ CA-percent])] FSPC[INHIBIT|UNINHIBIT] INH UNINH[KEYS( length offset)] —[LIMIT( limit)] —[LOCK|UNLOCK] —[LOG(NONE|UNDO|ALL)] —[LOGSTREAMID( dsname)] LSID[MANAGEMENTCLASS( class)] MGMTCLAS

2 DFSMS/MVS V1R3 Summary of the Access Method Services for ICF

Parameters for ALTER Abbreviation

[NEWNAME(newname)] NEWNM[NULLIFY( NULL[AUTHORIZATION(MODULE|STRING)] AUTH MDLE

STRG[BWO] —[CODE] —[EXCEPTIONEXIT] EEXT[LOG] —[LOGSTREAMID] LSID[OWNER] —[RETENTION] RETN[OWNER(ownerid)] —[RECORDSIZE(average maximum)] RECSZ[REMOVEVOLUMES(volser[volser...])] RVOL[REUSE|NOREUSE] —[ROLLIN] ROL[SCRATCH|NOSCRATCH] SCR NSCR[SHAREOPTIONS(crossregion[ crosssys tem])] SHR[STORAGECLASS( class)] STORCLAS[STRNO(number)] —[TO(date)|FOR(days)] — —[TYPE(LINEAR)] — LIN[UNIQUEKEY|NONUNIQUEKEY] UNQK NUNQK[UPDATE|NOUPDATE] UPD NUPD[UPGRADE|NOUPGRADE] UPG NUPG[WRITECHECK|NOWRITECHECK] WCK NWCK [CATALOG( catname)] CAT

ALTER LIBRARYENTRYModify attributes of previously defined tape library entries

Parameters for ALTER LIBRARYENTRY Abbreviation

ALTER —entryname — LIBRARYENTRY LIBENTRY,

LIBENT[CONSOLENAME (consolename)] CONSOLE[DESCRIPTION(desc)] DESC[LIBDEVTYPE (devtype)] LDEVT[LIBRARYID (libid)] LIBID[LOGICALTYPE{AUTOMATED|MANUAL}] LOGTYP

3

Parameters for ALTER LIBRARYENTRY Abbreviation

[NULLIFY([LIBDEVTYPE][LOGICALTYPE])] LDEVTLOGTYP

[NUMBEREMPTYSLOTS( numslots)] NUMESLT[NUMBERSCRATCHVOLUMES(MEDIA1( num)MEDIA2(num) MEDIA3(num) MEDIA4(num))]

NUMSCRV

[NUMBERSLOTS( numslots)] NUMSLT[SCRATCHTHRESHOLD(MEDIA1( num) MEDIA2(num)MEDIA3(num) MEDIA4(num))]

SCRTHR

ALTER VOLUMEENTRYModify attributes of previously defined tape volume entries

Parameters for ALTER VOLUMEENTRY Abbreviation

ALTER —(entryname) —VOLUMEENTRY VOLENTRY,

VOLENT[CHECKPOINT|NOCHECKPOINT] CHKPT

NOCHKPT[COMPACTION{YES|IDRC|NO|NONE| UNKNOWN}] COMP[ENTEREJECTDATE( eedate)] EEDATE[EXPIRATIONDATE( expdate)] EXDATE[LIBRARYNAME( libname)] LIBNAME[LOCATION{LIBRARY|SHELF}] LOC[MEDIATYPE{MEDIA1|MEDIA2 | MEDIA3|MEDIA4}] MTYPE[MOUNTDATE(mountdate)] MDATE[NULLIFY(ERRORSTATUS)] ERRSTAT, ER[OWNERINFORMATION(ownerinfo)] OWNINFO[RECORDING{18TRACK|36TRACK|128TRACK|UNKNOWN}]

REC

[SHELFLOCATION( shelf)] SHELFLOC[SPECIALATTRIBUTE{READCOMPATIBLE| NONE}] SATTR

RDCOMPAT[STORAGEGROUP(groupname)] STORGRP[USEATTRIBUTE{SCRATCH|PRIVATE}] UATTR[WRITEDATE(wrtdate)] WDATE[WRITEPROTECT|NOWRITEPROTECT] WPRT NWPRT


BLDINDEXBuild alternate indexes for existing VSAM clusters

Parameters for BLDINDEX Abbreviation

BLDINDEX BIX{INFILE(ddname )| IFILEINDATASET(entryname)} IDS{OUTFILE(ddname[ ddname...])| OFILEOUTDATASET(entryname [ entryname...])} ODS[{EXTERNALSORT|INTERNALSORT }] ESORT ISORT[{SORTCALL |NOSORTCALL}] —[SORTDEVICETYPE(device type)] SORTDVT

SDVT[SORTFILENUMBER (number)] SORTFN SFN[SORTMESSAGEDD (ddname)] SORTMDD

SMDD[SORTMESSAGELEVEL({ALL|CRITICAL | NONE})] SORTML SML[WORKFILES( ddname ddname)] WFILE [CATALOG( catname)] CAT

CNVTCATConvert VSAM catalog or OS CVOL entries into integrated catalog facilitycatalog entries

Parameters for CNVTCAT Abbreviation

CNVTCAT CNVTC{INFILE(ddname)| IFILEINDATASET(entryname)} IDS{OUTFILE(ddname)| OFILEOUTDATASET(entryname)| ODSCATALOG( catname)} CAT[CVOLEQUATES(( catname (volser CVEQU[ volser...]))[ (catname...)...])] [FILE(ddname)] —[LIST|NOLIST] — NLIST[MASTERCATALOG( catname)] MCAT

5

CREATE LIBRARYENTRYCreate tape library entries

Parameters for CREATE LIBRARYENTRY Abbreviation

CREATE —LIBRARYENTRY LIBENTRY(NAME(entryname) LIBENTLIBRARYID (libid) LIBID[CONSOLENAME (consolename)] CONSOLE[DESCRIPTION(desc)] DESC[LIBDEVTYPE( devtype)] LDEVT[LOGICALTYPE{AUTOMATED|MANUAL}] LOGTYP[NUMBEREMPTYSLOTS( numslots)] NUMESLT[NUMBERSCRATCHVOLUMES(MEDIA1( num)MEDIA2(num) MEDIA3(num) MEDIA4(num))]

NUMSCRV

[NUMBERSLOTS( numslots)] NUMSLT[SCRATCHTHRESHOLD(MEDIA1( num) MEDIA2(num)MEDIA3(num) MEDIA4(num))]

SCRTHR

CREATE VOLUMEENTRYCreate tape volume entries

Parameters for CREATE VOLUMEENTRY Abbreviation

CREATE —VOLUMEENTRY —(NAME(entryname) —[CHECKPOINT|NOCHECKPOINT] CHKPT

NOCHKPT[COMPACTION{YES|IDRC|NO|NONE| UNKNOWN}] COMP[ENTEREJECTDATE( eedate)] EEDATE[EXPIRATIONDATE( expdate)] EXDATE[LIBRARYNAME( libname)] LIBNAME[LOCATION{LIBRARY|SHELF}] LOC[MEDIATYPE{MEDIA1|MEDIA2 | MEDIA3|MEDIA4}] MTYPE[MOUNTDATE(mountdate)] MDATE[NULLIFY(ERRORSTATUS)] ERRSTAT, ER[OWNERINFORMATION(ownerinfo)] OWNINFO[RECORDING{18TRACK|36TRACK|128TRACK|UNKNOWN}]

REC

[SHELFLOCATION( shelf)] SHELFLOC[SPECIALATTRIBUTE{READCOMPATIBLE| NONE}] SATTR

RDCOMPAT[STORAGEGROUP(groupname)] STORGRP


Parameters for CREATE VOLUMEENTRY Abbreviation

[USEATTRIBUTE{SCRATCH|PRIVATE}] UATTR[WRITEDATE(wrtdate)] WDATE[WRITEPROTECT|NOWRITEPROTECT] WPRT NWPRT

DCOLLECTCollect data set, volume usage, and migration utility information

Parameters for DCOLLECT Abbreviation

DCOLLECT DCOL{OUTFILE(ddname)| OFILE OUTDATASET(entryname)} ODS{[VOLUMES( volser[ volser...])] VOL[BACKUPDATA] BACD[CAPPLANDATA] CAPD[EXCLUDEVOLUMES( volser[ volser...])] EXV[MIGRATEDATA] MIGD[SMSDATA(SCDSNAME( entryname)|ACTIVE)]} SMS[STORAGEGROUP(sgname[ sgname...])] STOG[ERRORLIMIT(value)] ELIMIT[EXITNAME(entrypoint)] EXIT[MIGRSNAPALL|MIGRSNAPERR] MSALL MSERR[NODATAINFO] NOD[NOVOLUMEINFO] NOV[REPLACE|APPEND ] REPL APP

DEFINE ALIASDefine an alternate name for a user catalog or a non-VSAM data set

Parameters for DEFINE ALIAS Abbreviation

DEFINE DEFALIAS —(NAME(aliasname) —RELATE(entryname)) REL

| SYMBOLICRELATE( entryname))| SYM[CATALOG( catname)] CAT

7

DEFINE ALTERNATEINDEXDefine a catalog entry for an alternate index

Parameters for DEFINE ALTERNATEINDEX Abbreviation

DEFINE ALTERNATEINDEX DEF AIX(NAME(entryname) —RELATE(entryname) REL{CYLINDERS(primary[ secondary])|1 CYLKILOBYTES( primary[ secondary])|1 KBMEGABYTES(primary[ secondary])|1 MBRECORDS(primary[ secondary])|1 RECTRACKS(primary[ secondary])}1 TRKVOLUMES(volser[ volser...])2 VOL[ATTEMPTS(number|2)] ATT[AUTHORIZATION( entrypoint[ string])] AUTH[BUFFERSPACE( size)] BUFSP,

BUFSPC[CODE(code)] —[CONTROLINTERVALSIZE( size)] CISZ, CNVSZ[DATACLASS( class)] DATACLAS[ERASE|NOERASE ] ERAS NERAS[EXCEPTIONEXIT(entrypoint)] EEXT[FILE(ddname)] —[FREESPACE(CI-percent[ CA-percent]|0 0)] FSPC[IMBED|NOIMBED ] IMBD NIMBD[KEYRANGES(( lowkey highkey) KRNG[(lowkey highkey)...])] [KEYS( length offset|64 0)] —[MODEL(entryname[ catname])] —[ORDERED|UNORDERED] ORD UNORD[OWNER(ownerid)] —[RECATALOG|NORECATALOG ] RCTLG

NRCTLG[RECORDSIZE(average maximum| RECSZ4086 32600)] [REPLICATE|NOREPLICATE ] REPL NREPL[REUSE|NOREUSE] RUS NRUS[SHAREOPTIONS(crossregion SHR[ crosssystem]|1 3)] [SPEED|RECOVERY] — RCVY[TO(date)|FOR(days)] — —[UNIQUEKEY|NONUNIQUEKEY ] UNQK NUNQK[UPGRADE|NOUPGRADE] UPG NUPG[WRITECHECK|NOWRITECHECK ]) WCK NWCK [DATA( —{CYLINDERS(primary[ secondary])| CYLKILOBYTES( primary[ secondary])| KB



MEGABYTES(primary[ secondary])| MBRECORDS(primary[ secondary])| RECTRACKS(primary[ secondary])} TRK[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])] FSPC[KEYRANGES(( lowkey highkey) KRNG[(lowkey highkey)...])] [KEYS( length offset)] —[MODEL(entryname[ catname])] —[NAME(entryname)] —[ORDERED|UNORDERED] ORD UNORD[OWNER(ownerid)] —[READPW] RDPW[RECORDSIZE(average maximum)] RECSZ[REUSE|NOREUSE] RUS NRUS[SHAREOPTIONS(crossregion[ crosssystem])] SHR[SPEED|RECOVERY] — RCVY[UNIQUEKEY|NONUNIQUEKEY ] UNQK NUNQK[WRITECHECK|NOWRITECHECK ])] WCK NWCK [INDEX( IX{CYLINDERS(primary[ secondary])| CYLKILOBYTES( primary[ secondary])| KBMEGABYTES(primary[ secondary])| MBRECORDS(primary[ secondary])| RECTRACKS(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


[REUSE|NOREUSE] RUS NRUS[SHAREOPTIONS(crossregion[ crosssystem])] SHR[WRITECHECK|NOWRITECHECK ])] WCK NWCK [CATALOG( catname)] CAT

Notes:

1. CYLINDERS, KILOBYTES, MEGABYTES, RECORDS, or TRACKSmust be specified either as a parameter of ALTERNATEINDEX, as aparameter 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 oras a parameter of both DATA and INDEX if MODEL is not specified or ifthe base cluster is not managed by SMS.

DEFINE CLUSTERDefine a catalog entry for a VSAM cluster

Parameters for DEFINE CLUSTER Abbreviation

DEFINE CLUSTER DEF CL(NAME(entryname) —{CYLINDERS(primary[ secondary])|1 CYLKILOBYTES( primary[ secondary])|1 KBMEGABYTES(primary[ secondary])|1 MBRECORDS(primary[ secondary])|1 RECTRACKS(primary[ secondary])}1 TRKVOLUMES(volser[ volser...])2 VOL[ACCOUNT(account—info)] ACCT[ATTEMPTS(number|2)] ATT[AUTHORIZATION( entrypoint[ string])] AUTH[BUFFERSPACE( size)] BUFSP,

BUFSPC[BWO(TYPECICS |TYPEIMS|NO) —[CODE(code)] —[CONTROLINTERVALSIZE( size)] CISZ, CNVSZ[DATACLASS( class)] DATACLAS[ERASE|NOERASE ] ERAS NERAS[EXCEPTIONEXIT(entrypoint)] EEXT[FILE(ddname)] —[FREESPACE(CI-percent[CA-percent]|0 0)]3 FSPC[IMBED|NOIMBED ]3 IMBD NIMBD[INDEXED|LINEAR|NONINDEXED| IXD, LIN, NIXD



NUMBERED] NUMD[KEYRANGES(( lowkey highkey)3 KRNG[(lowkey highkey)...])][KEYS( length offset|64 0)]3 —[LOG(NONE|UNDO|ALL)] —[LOGSTREAMID( logstream)] LSID[MANAGEMENTCLASS( class)] MGMTCLAS[MODEL(entryname [ catname])] —[OWNER(ownerid)] —[RECATALOG|NORECATALOG ] RCTLG

NRCTLG[RECORDSIZE4 (average maximum)] RECSZ[REPLICATE|NOREPLICATE ] REPL NREPL[REUSE|NOREUSE] RUS NRUS[SHAREOPTIONS(crossregion SHR[ crosssystem]|1 3)] [SPANNED|NONSPANNED ]4 SPND NSPND[SPEED|RECOVERY] — RCVY[STORAGECLASS( class)] STORCLAS[TO(date)|FOR(days)] — —[WRITECHECK|NOWRITECHECK ]) WCK NWCK [DATA( —{CYLINDERS(primary[ secondary])| CYLKILOBYTES( primary[ secondary])| KBMEGABYTES(primary[ secondary])| MBRECORDS(primary[ secondary])| RECTRACKS(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


[SHAREOPTIONS(crossregion[ crosssystem])] SHR[SPANNED|NONSPANNED ]4 SPND NSPND[SPEED|RECOVERY] — RCVY[WRITECHECK|NOWRITECHECK ])] WCK NWCK [INDEX(3 IX{CYLINDERS(primary[ secondary])| CYLKILOBYTES( primary[ secondary])| KBMEGABYTES(primary[ secondary])| MBRECORDS(primary[ secondary])| RECTRACKS(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 TRACKSmust be specified either as a parameter of CLUSTER, as a parameterof DATA, or as a parameter of both DATA and INDEX. CYLINDERS,RECORDS, or TRACKS is not required if MODEL or RECATALOG isspecified.

2. VOLUMES must be specified as a parameter of CLUSTER or as aparameter of both DATA and INDEX if MODEL is not specified or if thebase 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).


DEFINE GENERATIONDATAGROUPCreate a catalog entry for a generation data group

Parameters for DEFINE GENERATIONDATAGROUP Abbreviation

DEFINE GENERATIONDATAGROUP DEF GDG(NAME(entryname) —LIMIT(limit) LIM[EMPTY|NOEMPTY] EMP NEMP[OWNER(ownerid)] —[SCRATCH|NOSCRATCH ] SCR NSCR[TO(date)|FOR(days)]) — — [CATALOG( catname)] CAT

DEFINE NONVSAMDefine a catalog entry for a non-VSAM data set

Parameters for DEFINE NONVSAM Abbreviation

DEFINE NONVSAM DEF NVSAM(NAME(entryname) —DEVICETYPES(devtype[ devtype...])1 DEVTVOLUMES(volser[ volser...])1 VOL[COLLECTION] 1 COLLN[FILESEQUENCENUMBERS( number FSEQN[ number...])] [OWNER(ownerid)] —[RECATALOG|NORECATALOG ] RCTLG

NRCTLG[TO(date)|FOR(days)]) — — [CATALOG( catname)] CAT

Note:

1. When COLLECTION is used, DEVICETYPES and VOLUMES are notrequired and are ignored if specified.

13

DEFINE PAGESPACEDefine a catalog entry for a page space

Parameters for DEFINE PAGESPACE Abbreviation

DEFINE PAGESPACE DEF PGSPC (NAME(entryname) —{CYLINDERS(primary)| CYLKILOBYTES( primary)| KBMEGABYTES(primary)| MBRECORDS(primary)| RECTRACKS(primary)} TRKVOLUME(volser) VOL[ATTEMPTS(number|2)] ATT[AUTHORIZATION( entrypoint[ string])] AUTH[CODE(code)] —[DATACLASS( class)] DATACLAS[FILE(ddname)] —[MANAGEMENTCLASS( class)] MGMTCLAS[MODEL(entryname —[ catname])] [OWNER(ownerid)] —[RECATALOG|NORECATALOG ] RCTLG

NRCTLG[STORAGECLASS( class)] STORCLAS[SWAP|NOSWAP ] — NSWAP[TO(date)|FOR(days)] — — [CATALOG( catname)] CAT

DEFINE PATHDefine a relationship between an alternate index and its base cluster

Parameters for DEFINE PATH Abbreviation

DEFINE PATH DEF —(NAME(entryname) —PATHENTRY(entryname) PENT[ATTEMPTS(number|2)] ATT[AUTHORIZATION( entrypoint[ string])] AUTH[CODE(code)] —[MODEL(entryname [ catname])] —[OWNER(ownerid)] —[RECATALOG|NORECATALOG ] RCTLG,

NRCTLG


Parameters for DEFINE PATH Abbreviation

[TO(date)|FOR(days)] — —[UPDATE|NOUPDATE] UPD NUPD [CATALOG( catname)] CAT

DEFINE USERCATALOG|MASTERCATALOGCreate an integrated catalog facility user or master catalog

Parameters for DEFINE UCAT|MCAT Abbreviation

DEFINE USERCATALOG|MASTERCATALOG DEF UCATMCAT

(NAME(entryname) —{CYLINDERS(primary[ secondary])|1 CYLKILOBYTES( primary[ secondary])|1 KBMEGABYTES(primary[ secondary])|1 MBRECORDS(primary[ secondary])|1 RECTRACKS(primary[ secondary])}1 TRKVOLUME(volser)2 VOL[ATTEMPTS(number|2)] ATT[AUTHORIZATION( entrypoint[ string])] AUTH[BUFFERSPACE( size|3072)] BUFSP,

BUFSPC[BUFND(number)] BFND[BUFNI(number)] BFNI[CODE(code)] —[CONTROLINTERVALSIZE( size)] CISZ, CNVSZ[DATACLASS( class)] DATACLAS

| [ECSHARING|NOECSHARING]| ECS NECS[FILE(ddname)] —[FREESPACE(CI-percent[ CA-percent]|0 0)] FSPC[ICFCATALOG |VSAMCATALOG |VOLCATALOG] ICFCAT,

VOLCAT[IMBED|NOIMBED] IMBD, NIMBD[LOCK|UNLOCK ] — —[MANAGEMENTCLASS( class)] MGMTCLAS[MODEL(entryname[ catname])] —[OWNER(ownerid)] —[RECORDSIZE(average maximum| 4086 32400)] RECSZ[REPLICATE|NOREPLICATE ] REPL NREPL[SHAREOPTIONS(crossregion SHR[ crosssystem]|3 4)] [STORAGECLASS( class)] STORCLAS[STRNO(number|2)] —

15

Parameters for DEFINE UCAT|MCAT Abbreviation

[TO(date)|FOR(days)] — —[WRITECHECK|NOWRITECHECK ]) WCK NWCK [DATA —{CYLINDERS(primary[ secondary])| CYLKILOBYTES( primary[ secondary])| KBMEGABYTES(primary[ secondary])| MBRECORDS(primary[ secondary])| RECTRACKS(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])| CYLKILOBYTES( primary[ secondary])| KBMEGABYTES(primary[ secondary])| MBRECORDS(primary[ secondary])| RECTRACKS(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 TRACKSmust be specified either as a parameter of UCAT|MCAT, as a parameterof 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 aparameter of both DATA and INDEX if MODEL is not specified or if thebase cluster is not managed by SMS.


DIAGNOSEDiagnose data structures

Parameters for DIAGNOSE Abbreviation

DIAGNOSE DIAG{ICFCATALOG|VVDS} ICFCAT —{INFILE(ddname)| IFILEINDATASET(datasetname)} IDS[COMPAREDD(ddname [ ddname...])| CMPRDDCOMPAREDS(dsname [ dsname...])] CMPRDS[DUMP|NODUMP] — —[ERRORLIMIT(value)] ELIMIT[EXCLUDE EXCL({ENTRIES(entryname[ entryname...])| ENTCATALOG( catalogname[ catalogname...])| CATLEVEL( level)})| LVLINCLUDE INCL({ENTRIES(entryname[ entryname...])| ENTCATALOG( catalogname[ catalogname...])| CATLEVEL( level)})] LVL[LIST|NOLIST ] NLST[OUTFILE(ddname)] OFILE

EXAMINEInspect key-sequenced data set clusters

Parameters for EXAMINE Abbreviation

EXAMINE —NAME(clustername) —[INDEXTEST|NOINDEXTEST] ITEST,

NOITEST[DATATEST|NODATATEST ] DTEST,

NODTEST[ERRORLIMIT(value)] ELIMIT


EXPORTCreate a backup or portable copy of a VSAM cluster, alternate index, or inte-grated catalog facility user catalog

Parameters for EXPORT Abbreviation

EXPORT EXP entryname{OUTFILE(ddname)|OUTDATASET ( entryname)} OFILE, ODS[CIMODE|RECORDMODE] CIM, RECM[ERASE|NOERASE] ERAS, NERAS[INFILE(ddname)] IFILE[INHIBITSOURCE|NOINHIBITSOURCE ] INHS, NINHS[INHIBITTARGET|NOINHIBITTARGET ] INHT, NINHT[PURGE|NOPURGE] PRG, NPRG[TEMPORARY|PERMANENT ] TEMP, PERM

EXPORT DISCONNECTDisconnect a user catalog

Parameters for EXPORT DISCONNECT Abbreviation

EXPORT EXP usercatnameDISCONNECT DCON[CATALOG( catname)] CAT

IMPORTRestore a VSAM cluster, alternate index, or integrated catalog facility catalogfrom an EXPORT portable data set

Parameters for IMPORT Abbreviation

IMPORT IMP{INFILE(ddname)|INDATASET( entryname)} IFILE, IDS{OUTFILE(ddname)| OFILEOUTDATASET(entryname)} ODS[ALIAS|NOALIAS ] ALS, NALS[ERASE|NOERASE] ERAS,

NERAS[INTOEMPTY] IEMPTY

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 CONNECTConnect a user catalog

Parameters for IMPORT CONNECT Abbreviation

IMPORT CONNECT IMP CONOBJECTS((catname OBJDEVICETYPE(devtype) DEVTVOLUMES(volser))) VOL[ALIAS] ALS[VOLCATALOG] VOLCAT [CATALOG( catname)] CAT

LISTCATList entries from a catalog

Parameters for LISTCAT Abbreviation

LISTCAT LISTC[ALIAS] —[ALTERNATEINDEX] AIX[CLUSTER] CL[DATA] —[GENERATIONDATAGROUP] GDG


Parameters for LISTCAT Abbreviation

[INDEX] IX[LIBRARYENTRIES (libent)] LIBENTRIES,

LIBENT[NONVSAM] NVSAM[PAGESPACE] PGSPC[PATH] —[USERCATALOG] UCAT[VOLUMEENTRIES (volent)] VOLENTRIES,

VOLENT [CREATION(days)] CREAT[ENTRIES(entryname[ entryname...])| ENTLEVEL( level)] LVL[EXPIRATION(days)] EXPIR[FILE(ddname)] —[LIBRARY( libname)] LIB[NAME|HISTORY|VOLUME| — HIST VOLALLOCATION|ALL] ALLOC —[OUTFILE(ddname)] OFILE[CATALOG( catname)] CAT

PRINTPrint the contents of a data set

Parameters for PRINT Abbreviation

PRINT —{INFILE(ddname)| IFILEINDATASET(entryname)} IDS[CHARACTER|DUMP |HEX] CHAR — —[DBCS] —[FROMKEY(key)|FROMADDRESS(address)| FKEY, FADDRFROMNUMBER(number)|SKIP(number)] FNUM —[INSERTSHIFT((offset1 offset2) ISHFT[(offset1 offset2)...])|INSERTALL] ISALL[OUTFILE(ddname)] OFILE[SKIPDBCSCHECK(( offset1 offset2) SKDCK[(offset1 offset2)...])|NODBCSCHECK] NODCK[TOKEY(key)|TOADDRESS(address)| — TADDRTONUMBER(number)|COUNT(number)] TNUM —

21

REPROCopy data sets, copy catalogs, and split or merge catalogs

Parameters for REPRO Abbreviation

REPRO —{INFILE(ddname IFILE[ ENVIRONMENT(DUMMY)])| ENV DUMINDATASET(entryname IDS[ ENVIRONMENT(DUMMY)])} ENV DUM{OUTFILE(ddname)| OFILEOUTDATASET(entryname)} ODS[DBCS] —[ENTRIES(entryname[ entryname...])| ENTLEVEL( level)] LVL[ERRORLIMIT(value)] ELIMIT[FILE(ddname)] —[FROMKEY(key)|FROMADDRESS(address)| FKEY,

FADDRFROMNUMBER(number)|SKIP(number)] FNUM —[INSERTSHIFT((offset1 offset2) ISHFT[(offset1 offset2)...])|INSERTALL] ISALL[MERGECAT|NOMERGECAT ] MRGC,

NOMRGC[REPLACE|NOREPLACE ] REP NREP[REUSE|NOREUSE] RUS NRUS[SKIPDBCSCHECK(( offset1 offset2) SKDCK[(offset1 offset2)...])|NODBCSCHECK] NODCK[TOKEY(key)|TOADDRESS(address)| — TADDRTONUMBER(number)|COUNT(number)] TNUM —[VOLUMEENTRIES(entryname)] VOLENTRIES,

VOLENT [ENCIPHER1 ENCPHR({EXTERNALKEYNAME( keyname)| EKNINTERNALKEYNAME( keyname)| IKNPRIVATEKEY} PRIKEY[CIPHERUNIT(number|1)] CPHRUN[DATAKEYFILE( ddname)| DKFILEDATAKEYVALUE( value)] DKV[SHIPKEYNAMES( keyname[ keyname...])] SHIPKN[STOREDATAKEY|NOSTOREDATAKEY ] STRDK

NSTRDK[STOREKEYNAME( keyname)] STRKN[USERDATA( value)])] UDATA [DECIPHER1 DECPHR({DATAKEYFILE( ddname)| DKFILE


Parameters for REPRO Abbreviation

DATAKEYVALUE( value)|SYSTEMKEY} DKV,SYSKEY

[SYSTEMDATAKEY( value)] SYSDK[SYSTEMKEYNAME( keyname)])] SYSKN

Note:

1. ENCIPHER and DECIPHER apply only with IBM ProgrammedCryptographic Facility (5740-XY5) or IBM Cryptographic Unit Support(5740-XY6).

VERIFYRestore a VSAM cluster's end-of-file values

Parameters for VERIFY Abbreviation

VERIFY VFY{FILE(ddname)| —DATASET(entryname)} DS

SHCDSList SMSVSAM recovery related to online applications and spheresaccessed in RLS mode

Parameters for SHCDS Abbreviation

SHCDS {[LISTDS( base-cluster)]| LDS[LISTSUBSYS( subsystem|ALL)]| LSS[LISTSUBSYSDS( subsystem)]| LSSDSL[LISTRECOVERY(base-cluster)| LRCVY[LISTALL]| LALL[FRSETRR(base-cluster)]| SETRR[FRUNBIND(base-cluster)]| UNB[FRBIND(base-cluster)]| BIND[FRRESETRR(base-cluster)]| RESET[FRRDELETEUNBOUNDLOCKS( base-cluster)]| DUNBL[PERMITNONRLSUPDATE( base-cluster)]| PERMT[DENYNONRLSUPDATE( base-cluster)]| DENY[REMOVESUBSYS(subsystem)]| RSS[CFREPAIR({INFILE (ddname)|INDATASET (dsname)} CFREP[({LIST|NOLIST})]]| —

23

Parameters for SHCDS Abbreviation

[CFRESET({INFILE (ddname)|INDATASET (dsname)}] CFRES[({LIST|NOLIST})]]| —[CFRESETDS(base-cluster)} CFRDS[OUTFILE(ddname)] OUTDD


Modal Commands

CANCELTerminates processing of the current job step.

CANCEL

IF-THEN-ELSEControls command execution on the basis of condition codes.

IF {LASTCC|MAXCC} operator number THEN[ command|

DO command set END][ELSE[ command| DO command set END]]

PARMSpecifies 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)]

Copyright IBM Corp. 1973, 1999 25

SETResets condition codes.

SET {MAXCC|LASTCC}= number


Readers' Comments — We'd Like to Hear from You

DFSMS/MVS Version 1 Release 5Summary of Access Method Services for the Integrated Catalog Facility

Publication No. SX26-3807-05

Overall, how satisfied are you with the information in this book?

How satisfied are you that the information in this book is:

Please tell us how we can improve this book:

Thank you for your responses. May we contact you? Ø Yes Ø No

When you send comments to IBM, you grant IBM a nonexclusive right to use or dis-tribute your comments in any way it believes appropriate without incurring any obli-gation to you.

Name Address

Company or Organization

Phone No.

Very

Satisfied Satisfied Neutral DissatisfiedVery

Dissatisfied

Overall satisfaction Ø Ø Ø Ø Ø

Very

Satisfied Satisfied Neutral DissatisfiedVery

Dissatisfied

Accurate Ø Ø Ø Ø ØComplete Ø Ø Ø Ø ØEasy to find Ø Ø Ø Ø ØEasy to understand Ø Ø Ø Ø ØWell organized Ø Ø Ø Ø ØApplicable to your tasks Ø Ø Ø Ø Ø

NO POSTAGENECESSARYIF MAILED IN THEUNITED STATES

BUSINESS REPLY MAILFIRST-CLASS MAIL PERMIT NO. 40 ARMONK, NEW YORK

POSTAGE WILL BE PAID BY ADDRESSEE

International Business Machines CorporationRCF Processing DepartmentG26/0505600 Cottle RoadSAN JOSE, CA 95193-0001

Fold and Tape Please do not staple Fold and Tape

Readers' Comments — We'd Like to Hear from YouSX26-3807-05 IBM

IBM

File Number: S370/S390-30Program Number: 5695-DF1 5645-001

Printed in the United States of Americaon recycled paper containing 10%recovered post-consumer fiber.

SX26-38ð7-ð5

access method services

Documents