570
z/OS DFSMS Access Method Services for Catalogs SC26-7394-03

z/OS V1R6.0 DFSMS Access Method Services for Catalogsoberhtom/mainframe/redbooks/DFSMS... · Delete Entries Associated with a Non-VSAM Object from VVDS and VTOC: Example 5 . . . 229

  • Upload
    ngonga

  • View
    221

  • Download
    0

Embed Size (px)

Citation preview

  • z/OS

    DFSMS

    Access

    Method

    Services

    for

    Catalogs

    SC26-7394-03

  • z/OS

    DFSMS

    Access

    Method

    Services

    for

    Catalogs

    SC26-7394-03

  • Note

    Before

    using

    this

    information

    and

    the

    product

    it

    supports,

    be

    sure

    to

    read

    the

    general

    information

    under

    Notices

    on

    page

    511.

    Fourth

    Edition,

    September

    2004

    This

    edition

    applies

    to

    Version

    1

    Release

    6

    of

    z/OS

    (5694-A01),

    Version

    1

    Release

    6

    of

    z/OS.e

    (5655-G52),

    and

    to

    all

    subsequent

    releases

    and

    modifications

    until

    otherwise

    indicated

    in

    new

    editions.

    This

    edition

    replaces

    SC26-7394-02.

    IBM

    welcomes

    your

    comments.

    A

    form

    for

    readers

    comments

    may

    be

    provided

    at

    the

    back

    of

    this

    publication,

    or

    you

    may

    address

    your

    comments

    to

    the

    following

    address:

    v

    International

    Business

    Machines

    Corporation

    v

    Department

    55JA,

    Mail

    Station

    P384

    v

    2455

    South

    Road

    v

    Poughkeepsie,

    NY

    12601-5400

    v

    United

    States

    of

    America

    v

    v

    FAX

    (United

    States

    &

    Canada):

    1+845+432-9405

    v

    FAX

    (Other

    Countries):

    v

    Your

    International

    Access

    Code

    +1+845+432-9405

    v

    v

    IBMLink

    (United

    States

    customers

    only):

    IBMUSM10(MHVRCFS)

    v

    Internet

    e-mail:

    [email protected]

    v

    World

    Wide

    Web:

    http://www.ibm.com/servers/eserver/zseries/zos/webqs.html

    If

    you

    would

    like

    a

    reply,

    be

    sure

    to

    include

    your

    name,

    address,

    telephone

    number,

    or

    FAX

    number.

    Make

    sure

    to

    include

    the

    following

    in

    your

    comment

    or

    note:

    v

    Title

    and

    order

    number

    of

    this

    document

    v

    Page

    number

    or

    topic

    related

    to

    your

    comment

    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.

    Copyright

    International

    Business

    Machines

    Corporation

    1973,

    2004.

    All

    rights

    reserved.

    US

    Government

    Users

    Restricted

    Rights

    Use,

    duplication

    or

    disclosure

    restricted

    by

    GSA

    ADP

    Schedule

    Contract

    with

    IBM

    Corp.

    http://www.ibm.com/servers/eserver/zseries/zos/webqs.html
  • Contents

    Figures

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . ix

    Tables

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . xi

    About

    this

    document

    .

    .

    .

    .

    .

    .

    .

    . xiii

    Required

    product

    knowledge

    .

    .

    .

    .

    .

    .

    .

    . xiii

    Referenced

    documents

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . xiii

    Accessing

    z/OS

    DFSMS

    documents

    on

    the

    Internet

    xiv

    Using

    LookAt

    to

    look

    up

    message

    explanations

    .

    . xiv

    Accessing

    z/OS

    licensed

    documents

    on

    the

    Internet

    xiv

    Notational

    conventions

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . xv

    How

    to

    code

    access

    method

    services

    commands

    xvi

    Commands

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . xvi

    Positional

    and

    keyword

    parameters

    .

    .

    .

    .

    . xvi

    How

    to

    code

    subparameters

    .

    .

    .

    .

    .

    .

    . xvii

    Alphanumeric,

    national,

    and

    special

    characters

    xx

    How

    to

    continue

    commands

    and

    parameters

    .

    . xx

    The

    terminator

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . xxi

    Summary

    of

    changes

    .

    .

    .

    .

    .

    .

    .

    . xxiii

    Summary

    of

    changes

    for

    SC26-7394-03

    z/OS

    Version

    1

    Release

    6

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . xxiii

    New

    information

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . xxiii

    Changed

    information

    .

    .

    .

    .

    .

    .

    .

    .

    . xxiii

    Library

    changes

    for

    z/OS

    Version

    1

    Release

    6

    xxiii

    Chapter

    1.

    Using

    Access

    Method

    Services

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 1

    Identifying

    Data

    Sets

    and

    Volumes

    .

    .

    .

    .

    .

    .

    . 1

    Dynamic

    Allocation

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 2

    JCL

    DD

    Statements

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 3

    Direct

    Allocation

    Using

    JCL

    .

    .

    .

    .

    .

    .

    .

    . 4

    Invoking

    Access

    Method

    Services

    .

    .

    .

    .

    .

    .

    . 5

    Using

    a

    Job

    or

    Jobstep

    to

    invoke

    Access

    Method

    Services

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 5

    From

    a

    Time

    Sharing

    Option

    Session

    .

    .

    .

    .

    . 6

    Access

    Method

    Services

    Tape

    Library

    Support

    .

    .

    . 7

    Summary

    of

    Tape

    Library

    Support

    .

    .

    .

    .

    .

    . 7

    Access

    Method

    Services

    Commands

    for

    Tape

    Library

    Support

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 7

    Order

    of

    Catalog

    Use

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 9

    Catalog

    Search

    Order

    for

    ALTER

    .

    .

    .

    .

    .

    . 10

    Catalog

    Selection

    Order

    for

    BLDINDEX

    .

    .

    .

    . 10

    Catalog

    Selection

    Order

    for

    DEFINE

    .

    .

    .

    .

    . 11

    Catalog

    Search

    Order

    for

    DELETE

    .

    .

    .

    .

    .

    . 11

    Catalog

    Selection

    Order

    for

    EXPORT

    DISCONNECT

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 12

    Catalog

    Search

    Order

    for

    LISTCAT

    .

    .

    .

    .

    . 12

    Generic

    Catalog

    Selection

    for

    DELETE

    and

    LISTCAT

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 13

    Specifying

    Attribute

    Selection

    Order

    .

    .

    .

    .

    .

    . 14

    Chapter

    2.

    Modal

    Commands

    .

    .

    .

    .

    . 17

    IF-THEN-ELSE

    Command

    Sequence

    .

    .

    .

    .

    .

    . 18

    Using

    Nested

    IF

    Commands:

    Example

    1

    .

    .

    .

    . 19

    Using

    Nested

    IF

    Commands:

    Example

    2

    .

    .

    .

    . 19

    Null

    Command

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 19

    DO-END

    Command

    Sequence

    .

    .

    .

    .

    .

    .

    .

    . 20

    Using

    the

    LASTCC

    Parameter

    .

    .

    .

    .

    .

    .

    . 20

    SET

    Command

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 20

    Using

    the

    SET

    command

    and

    MAXCC

    Parameter

    21

    CANCEL

    Command

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 21

    Using

    the

    CANCEL

    Command

    .

    .

    .

    .

    .

    .

    . 21

    PARM

    Command

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 21

    Using

    the

    PARM

    Command:

    Example

    1

    .

    .

    .

    . 23

    Using

    the

    PARM

    Command:

    Example

    2

    .

    .

    .

    . 24

    Using

    the

    PARM

    Command:

    Example

    3

    .

    .

    .

    . 24

    Condition

    Codes

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 25

    Common

    Continuation

    Errors

    in

    Coding

    Modal

    Commands

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 26

    Chapter

    3.

    Functional

    Command

    Syntax

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 27

    Functional

    Command

    Syntax

    Summary

    .

    .

    .

    .

    . 27

    Chapter

    4.

    ALLOCATE

    .

    .

    .

    .

    .

    .

    .

    . 29

    Restrictions

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 30

    Allocating

    Storage

    Management

    Subsystem

    Managed

    Data

    Sets

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 30

    Allocating

    Non-SMS

    Managed

    Data

    Sets

    .

    .

    .

    .

    . 30

    Return

    Codes

    for

    the

    ALLOCATE

    Command

    .

    .

    . 31

    Syntax

    for

    ALLOCATE

    Parameters

    .

    .

    .

    .

    .

    . 31

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 33

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 34

    ALLOCATE

    Examples

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 48

    Allocate

    a

    Data

    Set

    Using

    SMS

    Class

    Specifications:

    Example

    1

    .

    .

    .

    .

    .

    .

    .

    .

    . 48

    Allocate

    a

    VSAM

    Data

    Set

    Using

    SMS

    Class

    Specifications:

    Example

    2

    .

    .

    .

    .

    .

    .

    .

    .

    . 49

    Allocate

    a

    New

    Data

    Set:

    Example

    3

    .

    .

    .

    .

    . 50

    Allocate

    a

    non-VSAM

    Data

    Set:

    Example

    4

    .

    .

    . 50

    Allocate

    a

    Partitioned

    Data

    Set

    Extended:

    Example

    5

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 51

    Chapter

    5.

    ALTER

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 53

    Entry

    Types

    That

    Can

    Be

    Altered

    .

    .

    .

    .

    .

    .

    . 54

    ALTER

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 56

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 56

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 57

    ALTER

    Examples

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 73

    Alter

    a

    Clusters

    Attributes

    Using

    SMS

    Keywords:

    Example

    1

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 73

    Roll-In

    a

    Generation

    Data

    Set:

    Example

    2

    .

    .

    . 73

    Alter

    the

    Entry

    Names

    of

    Generically

    Named

    Clusters:

    Example

    3

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 74

    Alter

    the

    Attributes

    of

    a

    Generation

    Data

    Group:

    Example

    4

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 74

    Alter

    a

    Data

    Set

    Expiration

    Date:

    Example

    6

    .

    . 75

    Copyright

    IBM

    Corp.

    1973,

    2004

    iii

  • Migrate

    a

    DB2

    Cluster

    to

    a

    Linear

    Data

    Set

    Cluster:

    Example

    7

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 75

    Alter

    a

    Cluster

    Name

    and

    the

    Associated

    Data

    and

    Index

    Names:

    Example

    8

    .

    .

    .

    .

    .

    .

    . 75

    Chapter

    6.

    ALTER

    LIBRARYENTRY

    .

    .

    . 77

    ALTER

    LIBRARYENTRY

    Parameters

    .

    .

    .

    .

    .

    . 77

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 77

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 77

    ALTER

    LIBRARYENTRY

    Examples

    .

    .

    .

    .

    .

    . 80

    Altering

    a

    Tape

    Library

    Entry:

    Example

    1

    .

    .

    . 80

    Altering

    a

    LIBRARY

    Entry:

    Example

    2

    .

    .

    .

    . 81

    Chapter

    7.

    ALTER

    VOLUMEENTRY

    .

    .

    . 83

    ALTER

    VOLUMEENTRY

    Parameters

    .

    .

    .

    .

    .

    . 83

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 83

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 84

    ALTER

    VOLUMEENTRY

    Examples

    .

    .

    .

    .

    .

    . 88

    Altering

    a

    Volume

    Entry:

    Example

    1

    .

    .

    .

    .

    . 88

    Altering

    a

    VOLUME

    Entry:

    Example

    2

    .

    .

    .

    . 88

    Altering

    a

    VOLUME

    Entry:

    Example

    3

    .

    .

    .

    . 89

    Chapter

    8.

    BLDINDEX

    .

    .

    .

    .

    .

    .

    .

    . 91

    BLDINDEX

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 91

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 91

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 92

    Calculating

    Virtual

    Storage

    Space

    for

    an

    Alternate

    Index

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 94

    DD

    Statements

    That

    Describe

    the

    Sort

    Work

    Files

    .

    . 96

    BLDINDEX

    Examples

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 97

    Build

    an

    Alternate-Index

    over

    a

    Key-Sequenced

    Data

    Set

    (KSDS):

    Example

    1

    .

    .

    .

    .

    .

    .

    .

    . 97

    Build

    an

    Alternate-Index

    over

    a

    Key-Sequenced

    Data

    Set

    (KSDS)

    Using

    DFSORT:

    Example

    2

    .

    . 98

    Chapter

    9.

    CREATE

    LIBRARYENTRY

    .

    . 99

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 99

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 100

    CREATE

    LIBRARYENTRY

    Examples

    .

    .

    .

    .

    . 102

    Creating

    a

    Tape

    Library

    Entry:

    Example

    1

    .

    .

    . 102

    Creating

    a

    LIBRARY

    Record:

    Example

    2

    .

    .

    . 103

    Chapter

    10.

    CREATE

    VOLUMEENTRY

    105

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 105

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 106

    CREATE

    VOLUMEENTRY

    Examples

    .

    .

    .

    .

    . 110

    Creating

    a

    Tape

    Volume

    Entry:

    Example

    1

    .

    .

    . 110

    Creating

    a

    VOLUME

    Entry:

    Example

    2

    .

    .

    .

    . 110

    Chapter

    11.

    DCOLLECT

    .

    .

    .

    .

    .

    .

    . 113

    DCOLLECT

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 115

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 115

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 115

    DCOLLECT

    in

    a

    Batch

    Environment

    .

    .

    .

    .

    .

    . 119

    Generic

    Volume

    Data

    Collection:

    Example

    1

    .

    . 119

    Storage

    Group

    Data

    Collection:

    Example

    2

    .

    .

    . 119

    Migrated

    and

    Backup

    Data

    Set

    Data

    Collection:

    Example

    3

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 120

    Combination

    of

    Options:

    Example

    4

    .

    .

    .

    .

    . 121

    Collection

    of

    SMS

    Construct

    Information:

    Example

    5

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 121

    Chapter

    12.

    DEFINE

    ALIAS

    .

    .

    .

    .

    .

    . 123

    DEFINE

    ALIAS

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    . 123

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 123

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 124

    DEFINE

    ALIAS

    Examples

    .

    .

    .

    .

    .

    .

    .

    .

    . 124

    Define

    Alias

    for

    a

    non-VSAM

    non-SMS-Managed

    Data

    Set:

    Example

    1

    .

    .

    . 124

    Define

    an

    Alias

    for

    a

    User

    Catalog:

    Example

    2

    124

    Chapter

    13.

    DEFINE

    ALTERNATEINDEX

    .

    .

    .

    .

    .

    .

    .

    .

    . 127

    DEFINE

    ALTERNATEINDEX

    Parameters

    .

    .

    .

    . 128

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 128

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 131

    Data

    and

    Index

    Components

    of

    an

    Alternate

    Index

    141

    DEFINE

    ALTERNATEINDEX

    Examples

    .

    .

    .

    . 141

    Define

    an

    Alternate

    Index

    Using

    SMS

    Data

    Class

    Specification:

    Example

    1

    .

    .

    .

    .

    .

    .

    . 141

    Define

    an

    SMS-Managed

    Alternate

    Index:

    Example

    2

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 142

    Define

    an

    Alternate

    Index:

    Example

    3

    .

    .

    .

    . 143

    Define

    an

    Alternate

    Index

    with

    RECATALOG:

    Example

    4

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 144

    Chapter

    14.

    DEFINE

    CLUSTER

    .

    .

    .

    . 145

    DEFINE

    CLUSTER

    Parameters

    .

    .

    .

    .

    .

    .

    . 147

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 147

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 151

    Data

    and

    Index

    Components

    of

    a

    Cluster

    .

    .

    .

    . 166

    DEFINE

    CLUSTER

    Examples

    .

    .

    .

    .

    .

    .

    .

    . 166

    Define

    an

    SMS-Managed

    Key-Sequenced

    Cluster:

    Example

    1

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 167

    Define

    an

    SMS-Managed

    Key-Sequenced

    Cluster

    Specifying

    Data

    and

    Index

    Parameters:

    Example

    2

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 167

    Define

    a

    Key-Sequenced

    Cluster

    Specifying

    Data

    and

    Index

    Parameters:

    Example

    3

    .

    .

    .

    .

    . 168

    Define

    a

    Key-Sequenced

    Cluster

    and

    an

    Entry-Sequenced

    Cluster:

    Example

    4

    .

    .

    .

    .

    . 169

    Define

    a

    Relative

    Record

    Cluster

    in

    a

    Catalog:

    Example

    5

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 170

    Define

    a

    Reusable

    Entry-Sequenced

    Cluster

    in

    a

    Catalog:

    Example

    6

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 170

    Define

    a

    Key-Sequenced

    Cluster

    in

    a

    Catalog:

    Example

    7

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 171

    Define

    an

    Entry-Sequenced

    Cluster

    Using

    a

    Model:

    Example

    8

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 172

    Define

    a

    VSAM

    Volume

    Data

    Set:

    Example

    9

    173

    Define

    a

    Relative

    Record

    Data

    Set

    with

    Expiration

    Date:

    Example

    10

    .

    .

    .

    .

    .

    .

    . 173

    Define

    a

    Linear

    Data

    Set

    Cluster

    in

    a

    Catalog:

    Example

    11

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 174

    Chapter

    15.

    DEFINE

    GENERATIONDATAGROUP

    .

    .

    .

    .

    . 175

    DEFINE

    GENERATIONDATAGROUP

    Parameters

    175

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 175

    iv

    z/OS

    V1R6.0

    DFSMS

    Access

    Method

    Services

    for

    Catalogs

    ||

  • Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 175

    DEFINE

    GENERATIONDATAGROUP

    Examples

    177

    Define

    a

    Generation

    Data

    Group

    and

    a

    Generation

    Data

    Set

    within

    it:

    Example

    1

    .

    .

    . 177

    Use

    Access

    Method

    Services

    to

    Define

    a

    GDG

    and

    JCL

    to

    Define

    a

    GDS

    in

    that

    GDG:

    Example

    2

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 178

    Chapter

    16.

    DEFINE

    NONVSAM

    .

    .

    .

    . 181

    DEFINE

    NONVSAM

    Parameters

    .

    .

    .

    .

    .

    .

    . 182

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 182

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 184

    DEFINE

    NONVSAM

    Examples

    .

    .

    .

    .

    .

    .

    . 186

    Define

    a

    Non-VSAM

    Data

    Set

    with

    the

    RECATALOG

    Parameter:

    Example

    1

    .

    .

    .

    .

    . 186

    Define

    a

    Non-VSAM

    Data

    Set:

    Example

    2

    .

    .

    . 186

    Chapter

    17.

    DEFINE

    PAGESPACE

    .

    .

    . 189

    DEFINE

    PAGESPACE

    Parameters

    .

    .

    .

    .

    .

    . 189

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 189

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 191

    DEFINE

    PAGESPACE

    Examples

    .

    .

    .

    .

    .

    .

    . 194

    Define

    a

    NOSWAP

    Page

    Space:

    Example

    1

    .

    . 194

    Define

    a

    SWAP

    Page

    Space:

    Example

    2

    .

    .

    .

    . 194

    Define

    a

    Page

    Space

    in

    another

    Catalog:

    Example

    3

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 195

    Chapter

    18.

    DEFINE

    PATH

    .

    .

    .

    .

    .

    . 197

    DEFINE

    PATH

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    . 197

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 197

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 197

    DEFINE

    PATH

    Examples

    .

    .

    .

    .

    .

    .

    .

    .

    . 200

    Define

    a

    Path:

    Example

    1

    .

    .

    .

    .

    .

    .

    .

    . 200

    Define

    a

    Path

    (Recatalog)

    in

    a

    Catalog:

    Example

    2

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 200

    Chapter

    19.

    DEFINE

    USERCATALOG

    201

    DEFINE

    USERCATALOG

    Parameters

    .

    .

    .

    .

    . 202

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 202

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 204

    Data

    and

    Index

    Components

    of

    a

    User

    Catalog

    .

    . 211

    DEFINE

    USERCATALOG

    Examples

    .

    .

    .

    .

    .

    . 211

    Define

    a

    User

    Catalog,

    Specifying

    SMS

    Keywords:

    Example

    1

    .

    .

    .

    .

    .

    .

    .

    .

    . 211

    Define

    a

    User

    Catalog,

    Taking

    All

    Defaults:

    Example

    2

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 211

    Define

    a

    User

    Catalog,

    Using

    SMS

    Keywords

    and

    the

    VOLUME

    Parameter:

    Example

    3

    .

    .

    . 212

    Define

    a

    User

    Catalog,

    Using

    SMS

    Keywords

    and

    the

    VOLUME

    Parameter:

    Example

    4

    .

    .

    . 213

    Define

    a

    User

    Catalog:

    Example

    5

    .

    .

    .

    .

    . 213

    Define

    a

    User

    Catalog

    Using

    the

    MODEL

    Parameter:

    Example

    6

    .

    .

    .

    .

    .

    .

    .

    .

    . 215

    Define

    a

    General

    Tape

    Volume

    Catalog:

    Example

    7

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 215

    Define

    a

    Specific

    Tape

    Volume

    Catalog:

    Example

    8

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 216

    Chapter

    20.

    DELETE

    .

    .

    .

    .

    .

    .

    .

    . 217

    DELETE

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 217

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 217

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 218

    DELETE

    Examples

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 227

    Delete

    a

    Truename

    Entry

    in

    a

    Catalog:

    Example

    1

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 227

    Delete

    a

    User

    Catalog

    for

    Recovery:

    Example

    2

    228

    Delete

    VSAM

    Volume

    Records:

    Example

    3

    .

    .

    . 228

    Delete

    a

    Non-VSAM

    Data

    Sets

    Entry:

    Example

    4

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 229

    Delete

    Entries

    Associated

    with

    a

    Non-VSAM

    Object

    from

    VVDS

    and

    VTOC:

    Example

    5

    .

    .

    . 229

    Delete

    a

    Key-Sequenced

    VSAM

    Cluster

    in

    a

    Catalog:

    Example

    6

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 230

    Delete

    Two

    Key-Sequenced

    Clusters

    in

    a

    Catalog:

    Example

    7

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 230

    Delete

    a

    User

    Catalog:

    Example

    8

    .

    .

    .

    .

    . 231

    Delete

    an

    Alias

    Entry

    in

    a

    Catalog:

    Example

    9

    231

    Delete

    Generically

    Named

    Entries

    in

    a

    Catalog:

    Example

    10

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 231

    List

    a

    Generation

    Data

    Groups

    Entries,

    Then

    Delete

    the

    Group

    and

    Its

    Data

    Sets

    in

    a

    Catalog:

    Example

    11

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 232

    Delete

    a

    Generation

    Data

    Group

    with

    Recovery:

    Example

    12

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 233

    Delete

    a

    Member

    of

    a

    Partitioned

    (Non-VSAM)

    Data

    Set

    in

    a

    Catalog:

    Example

    13

    .

    .

    .

    .

    . 233

    Delete

    a

    Page

    Space:

    Example

    14

    .

    .

    .

    .

    .

    . 234

    Delete

    a

    VVDS

    with

    Recovery:

    Example

    15

    .

    . 234

    Delete

    an

    OAM

    Collection

    Name

    Catalog

    Entry:

    Example

    16

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 235

    Delete

    a

    Tape

    Library

    Entry:

    Example

    17

    .

    .

    . 235

    Delete

    a

    Tape

    Volume

    Entry:

    Example

    18

    .

    .

    . 235

    Chapter

    21.

    DIAGNOSE

    .

    .

    .

    .

    .

    .

    . 237

    DIAGNOSE

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 237

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 237

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 238

    DIAGNOSE

    Examples

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 240

    Diagnose

    a

    VVDS:

    Compare

    the

    BCS

    and

    VVDS

    Example

    1

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 240

    Diagnose

    Only

    the

    BCS:

    Example

    2

    .

    .

    .

    .

    . 241

    Diagnose

    the

    BCS:

    Compare

    the

    BCS

    and

    Certain

    VVDSs:

    Example

    3

    .

    .

    .

    .

    .

    .

    .

    . 241

    Diagnose

    a

    VVDS:

    Compare

    the

    BCS

    and

    VVDS:

    Example

    4

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 242

    Diagnose

    a

    VVDS:

    Compare

    the

    BCS

    and

    VVDS:

    Example

    5

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 242

    Diagnose

    a

    VVDS:

    Compare

    the

    BCS

    and

    VVDS:

    Example

    6

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 243

    Diagnose

    a

    VVDS:

    Compare

    the

    BCS

    and

    VVDS:

    Example

    7

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 244

    Chapter

    22.

    EXAMINE

    .

    .

    .

    .

    .

    .

    .

    . 245

    EXAMINE

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 245

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 245

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 245

    EXAMINE

    Examples

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 246

    Examine

    the

    Index

    Component

    of

    a

    User

    Catalog:

    Example

    1

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 246

    Contents

    v

  • Examine

    Both

    Components

    of

    a

    Key-Sequenced

    Data

    Set:

    Example

    2

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 246

    Examine

    the

    Data

    Component

    of

    a

    User

    Catalog:

    Example

    3

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 247

    Chapter

    23.

    EXPORT

    .

    .

    .

    .

    .

    .

    .

    . 249

    EXPORT

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 249

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 249

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 250

    EXPORT

    Examples

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 253

    Export

    a

    Catalog:

    Example

    1

    .

    .

    .

    .

    .

    .

    . 253

    Export

    a

    Key-Sequenced

    Cluster:

    Example

    2

    .

    . 254

    Export

    an

    Entry-Sequenced

    Cluster:

    Example

    3

    255

    Export

    an

    Entry-Sequenced

    Cluster

    Using

    CIMODE:

    Example

    4

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 255

    Export

    Multiple

    Data

    Sets

    Using

    Multiple

    INFILE

    Parameters:

    Example

    5

    .

    .

    .

    .

    .

    . 256

    Chapter

    24.

    EXPORT

    DISCONNECT

    257

    EXPORT

    DISCONNECT

    Parameters

    .

    .

    .

    .

    .

    . 257

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 257

    EXPORT

    DISCONNECT

    Examples

    .

    .

    .

    .

    .

    . 258

    Export

    Disconnect

    of

    a

    User

    Catalog

    from

    Another

    User

    Catalog:

    Example

    1

    .

    .

    .

    .

    . 258

    Export

    Disconnect

    of

    a

    User

    Catalog:

    Example

    2

    258

    Chapter

    25.

    IMPORT

    .

    .

    .

    .

    .

    .

    .

    . 259

    IMPORT

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 259

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 259

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 261

    IMPORT

    Examples

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 266

    Import

    a

    Cluster

    Utilizing

    SMS

    Keywords:

    Example

    1

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 267

    Import

    a

    Catalog:

    Example

    2

    .

    .

    .

    .

    .

    .

    . 268

    Import

    a

    Key-Sequenced

    Cluster:

    Example

    3

    .

    . 268

    Import

    an

    Entry-Sequenced

    Cluster

    in

    a

    Catalog:

    Example

    4

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 269

    Import

    a

    Cluster

    to

    a

    Volume

    Other

    Than

    One

    on

    Which

    It

    Was

    Originally

    Defined:

    Example

    5

    . 270

    Chapter

    26.

    IMPORT

    CONNECT

    .

    .

    .

    . 273

    IMPORT

    CONNECT

    Parameters

    .

    .

    .

    .

    .

    .

    . 273

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 273

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 273

    Import

    Connect

    Example

    .

    .

    .

    .

    .

    .

    .

    .

    . 274

    Import

    to

    Connect

    a

    User

    Catalog

    .

    .

    .

    .

    . 274

    Chapter

    27.

    LISTCAT

    .

    .

    .

    .

    .

    .

    .

    . 277

    LISTCAT

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 277

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 277

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 278

    LISTCAT

    Examples

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 283

    List

    an

    SMS-Managed

    Data

    Set:

    Example

    1

    .

    . 283

    List

    a

    Key-Sequenced

    Clusters

    Entry

    in

    a

    Catalog:

    Example

    2

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 283

    Alter

    a

    Catalog

    Entry,

    Then

    List

    the

    Modified

    Entry:

    Example

    3

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 284

    List

    Catalog

    Entries:

    Example

    4

    .

    .

    .

    .

    .

    . 285

    List

    Catalog

    Entries:

    Example

    5

    .

    .

    .

    .

    .

    . 285

    List

    a

    Tape

    Library

    Entry:

    Example

    6

    .

    .

    .

    . 285

    List

    Tape

    Volume

    Entries:

    Example

    7

    .

    .

    .

    . 286

    Chapter

    28.

    LISTDATA

    .

    .

    .

    .

    .

    .

    .

    . 287

    LISTDATA

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 287

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 287

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 288

    LISTDATA

    Examples

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 290

    Listing

    Subsystem

    Counters

    for

    a

    Particular

    Device:

    Example

    1

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 290

    Listing

    Subsystem

    Counters

    for

    All

    Devices

    within

    a

    Subsystem:

    Example

    2

    .

    .

    .

    .

    .

    . 290

    Listing

    Subsystem

    Counters

    for

    All

    Devices

    on

    Similar

    Subsystems:

    Example

    3

    .

    .

    .

    .

    .

    . 291

    Listing

    Subsystem

    Status:

    Example

    4

    .

    .

    .

    . 291

    Listing

    Pinned

    Data:

    Example

    5

    .

    .

    .

    .

    .

    . 292

    Listing

    Device

    Status:

    Example

    6

    .

    .

    .

    .

    .

    . 292

    Generating

    a

    Remote

    Support

    Access

    Code:

    Example

    7

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 293

    Chapter

    29.

    PRINT

    .

    .

    .

    .

    .

    .

    .

    .

    . 295

    PRINT

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 295

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 295

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 296

    PRINT

    Examples

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 300

    Examples

    of

    formats:

    Example

    1

    .

    .

    .

    .

    .

    . 300

    Print

    a

    Catalog:

    Example

    2

    .

    .

    .

    .

    .

    .

    .

    . 301

    Print

    a

    Key-Sequenced

    Clusters

    Data

    Records:

    Example

    3

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 301

    Copy

    Records

    from

    a

    Non-VSAM

    Data

    Set

    into

    an

    Entry-Sequenced

    VSAM

    Cluster,

    Then

    Print

    the

    Records:

    Example

    4

    .

    .

    .

    .

    .

    .

    .

    .

    . 302

    Print

    a

    Linear

    Data

    Set

    Cluster:

    Example

    5

    .

    . 303

    Print

    a

    Data

    Set

    that

    Contains

    DBCS

    Data:

    Example

    6

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 304

    Chapter

    30.

    REPRO

    .

    .

    .

    .

    .

    .

    .

    .

    . 305

    REPRO

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 306

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 306

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 307

    Cryptographic

    Parameters

    .

    .

    .

    .

    .

    .

    .

    . 314

    REPRO

    Examples

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 318

    Copy

    Records

    into

    a

    Key-Sequenced

    Data

    Set:

    Example

    1

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 318

    Copy

    Records

    into

    a

    VSAM

    Data

    Set:

    Example

    2

    319

    Merge

    an

    Integrated

    Catalog

    Facility

    User

    Catalog

    into

    Another

    Integrated

    Catalog

    Facility

    User

    Catalog:

    Example

    3

    .

    .

    .

    .

    .

    .

    .

    . 320

    Merge

    Selected

    Entries

    (Split)

    from

    a

    User

    Catalog

    into

    Another

    User

    Catalog:

    Example

    4

    . 321

    Copy

    a

    Catalog:

    Example

    5

    .

    .

    .

    .

    .

    .

    .

    . 321

    Copy

    a

    DBCS

    Data

    Set:

    Example

    6

    .

    .

    .

    .

    . 322

    Encipher

    Using

    System

    Keys:

    Example

    7

    .

    .

    . 323

    Decipher

    Using

    System

    Keys:

    Example

    8

    .

    .

    . 324

    Encipher

    Using

    Private

    Keys:

    Example

    9

    .

    .

    . 325

    Decipher

    Using

    Private

    Keys:

    Example

    10

    .

    .

    . 326

    Chapter

    31.

    SETCACHE

    .

    .

    .

    .

    .

    .

    . 327

    SETCACHE

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 328

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 328

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 328

    vi

    z/OS

    V1R6.0

    DFSMS

    Access

    Method

    Services

    for

    Catalogs

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

    |

  • Special

    Purpose

    Optional

    Parameters

    .

    .

    .

    . 330

    Using

    SETCACHE

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 333

    Setting

    Caching

    On

    for

    the

    Subsystem

    .

    .

    .

    . 333

    Setting

    Caching

    On

    for

    a

    Device

    .

    .

    .

    .

    .

    . 333

    Setting

    Cache

    Fast

    Write

    On

    for

    the

    Subsystem

    333

    Setting

    Nonvolatile

    Storage

    On

    for

    the

    Subsystem

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 333

    Setting

    DASD

    Fast

    Write

    On

    for

    a

    Volume

    .

    .

    . 334

    Creating

    a

    Duplex

    Pair

    from

    Two

    Simplex

    Volumes

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 334

    Changing

    3990

    and

    9390

    Cache

    and

    NVS

    Operating

    Modes

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 334

    Setting

    Cache

    Off

    for

    the

    Subsystem

    .

    .

    .

    .

    . 334

    Setting

    Caching

    Off

    for

    a

    Device

    .

    .

    .

    .

    .

    . 335

    Setting

    Nonvolatile

    Storage

    Off

    for

    the

    Subsystem

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 335

    Setting

    DASD

    Fast

    Write

    Off

    for

    a

    Volume

    .

    . 335

    Setting

    Cache

    Fast

    Write

    Off

    for

    the

    Subsystem

    335

    Resetting

    a

    Duplex

    Pair

    to

    Two

    Simplex

    Volumes

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 335

    Destaging

    All

    Modified

    Data

    in

    Cache

    and

    NVS

    to

    DASD

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 335

    Resetting

    All

    Cache

    and

    NVS

    Operating

    States

    to

    Defaults

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 336

    Using

    Dual

    Copy

    to

    Migrate

    Volumes

    .

    .

    .

    . 336

    Migrating

    Simplex

    Volume

    .

    .

    .

    .

    .

    .

    .

    . 336

    Migrating

    Duplex

    Volumes

    .

    .

    .

    .

    .

    .

    .

    . 337

    Dual

    Copy

    Device

    Address

    Mapping

    .

    .

    .

    . 337

    Chapter

    32.

    SHCDS

    .

    .

    .

    .

    .

    .

    .

    .

    . 339

    SHCDS

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 340

    Required

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 341

    Optional

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 341

    SCHDS

    Examples

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 347

    Using

    PERMITNONRLSUPDATE

    With

    a

    Generic

    Data

    Set

    Name

    Specification:

    Example

    1

    347

    Listing

    Data

    Sets

    With

    the

    High-Level

    Qualifier

    SYSPLEX:

    Example

    2

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 347

    Listing

    data

    sets

    with

    JOBS:

    Example

    3

    .

    .

    .

    . 348

    Listing

    shunted

    entries:

    Example

    4

    .

    .

    .

    .

    . 348

    Chapter

    33.

    VERIFY

    .

    .

    .

    .

    .

    .

    .

    .

    . 349

    VERIFY

    Parameters

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 349

    Required

    Parameter

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 349

    VERIFY

    Example

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 349

    Upgrade

    a

    Data

    Sets

    End-of-File

    Information

    350

    Appendix

    A.

    Security

    Authorization

    Levels

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 351

    Required

    RACF

    Authorization

    Tables

    .

    .

    .

    .

    . 351

    Appendix

    B.

    Interpreting

    LISTCAT

    Output

    Listings

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 357

    LISTCAT

    Output

    Keywords

    .

    .

    .

    .

    .

    .

    .

    . 357

    Alias

    Entry

    Keywords

    .

    .

    .

    .

    .

    .

    .

    .

    . 357

    Alternate-Index

    Entry

    Keywords

    .

    .

    .

    .

    .

    . 358

    Cluster

    Entry

    Keywords

    .

    .

    .

    .

    .

    .

    .

    .

    . 358

    Data

    Entry

    Keywords

    .

    .

    .

    .

    .

    .

    .

    .

    . 359

    Index

    Entry

    Keywords

    .

    .

    .

    .

    .

    .

    .

    .

    . 361

    Generation

    Data

    Group

    Base

    Entry

    Keywords

    363

    Non-VSAM

    Entry

    Keywords

    .

    .

    .

    .

    .

    .

    . 363

    Page

    Space

    Entry

    Keywords

    .

    .

    .

    .

    .

    .

    . 364

    Path

    Entry

    Keywords

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 364

    User

    Catalog

    Entry

    Keywords

    .

    .

    .

    .

    .

    .

    . 364

    Description

    of

    Keyword

    Fields

    .

    .

    .

    .

    .

    .

    . 365

    ALC:

    Allocation

    Group

    .

    .

    .

    .

    .

    .

    .

    .

    . 365

    ASN:

    Associations

    Group

    .

    .

    .

    .

    .

    .

    .

    . 366

    ATT:

    Attributes

    Group

    .

    .

    .

    .

    .

    .

    .

    .

    . 367

    GDG:

    Generation

    Data

    Group

    Base

    Entry,

    Special

    Fields

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 370

    NVS:

    Non-VSAM

    Entry,

    Special

    Field

    .

    .

    .

    . 370

    HIS:

    History

    Group

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 370

    PRT:

    Protection

    Group

    .

    .

    .

    .

    .

    .

    .

    .

    . 372

    STA:

    Statistics

    Group

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 372

    VLS:

    Volumes

    Group

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 374

    Device

    Type

    Translate

    Table

    .

    .

    .

    .

    .

    .

    . 376

    Examples

    of

    LISTCAT

    Output

    Listings

    .

    .

    .

    .

    . 376

    Job

    Control

    Language

    (JCL)

    for

    LISTCAT

    Jobs

    376

    LISTCAT

    and

    Access

    Method

    Services

    Output

    Messages

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 378

    LISTCAT

    Output

    Listing

    .

    .

    .

    .

    .

    .

    .

    . 379

    LISTCAT

    NAMES

    Output

    Listing

    .

    .

    .

    .

    . 379

    LISTCAT

    VOLUME

    Output

    Listing

    .

    .

    .

    .

    . 380

    LISTCAT

    ALL

    Output

    Listing

    .

    .

    .

    .

    .

    .

    . 385

    LISTCAT

    ALL

    Output

    Listing

    for

    a

    Non-VSAM

    Tailored

    Compressed

    Data

    Set

    .

    .

    .

    .

    .

    .

    . 396

    LISTCAT

    ALLOCATION

    Output

    Listing

    .

    .

    . 397

    LISTCAT

    HISTORY

    Output

    Listing

    .

    .

    .

    .

    . 403

    LISTCAT

    LEVEL

    Output

    Listing

    .

    .

    .

    .

    .

    . 406

    LISTCAT

    ENTRIES

    Output

    Listing

    .

    .

    .

    .

    . 406

    LISTCAT

    CREATION/EXPIRATION

    Output

    Listing

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 406

    Examples

    of

    LISTCAT

    in

    a

    TSO

    Environment

    408

    Appendix

    C.

    Interpreting

    SHCDS

    Output

    Listings

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 411

    LISTDS

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 411

    LISTDS

    with

    Data

    Set

    in

    Retained

    Lock

    State

    411

    LISTDS

    for

    Data

    Set

    Shared

    by

    Multiple

    Subsystems

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 412

    LISTDS

    for

    Data

    Set

    in

    Non-RLS

    Permitted

    State

    412

    LISTDS

    with

    Data

    Set

    in

    Non-RLS

    Update

    and

    Permit

    First

    Time

    States

    .

    .

    .

    .

    .

    .

    .

    .

    . 413

    LISTDS

    for

    Data

    Set

    in

    Lost

    Lock

    State

    .

    .

    .

    . 414

    LISTDS

    with

    JOBS

    keyword

    .

    .

    .

    .

    .

    .

    . 414

    LISTSHUNTED

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 415

    LISTSUBSYS

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 415

    LISTSUBSYS

    for

    All

    Subsystems

    Sharing

    Data

    Sets

    in

    the

    Sysplex

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 416

    LISTSUBSYSDS

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 417

    LISTSUBSYSDS

    for

    Subsystem

    Sharing

    Multiple

    Data

    Sets

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 417

    LISTSUBSYSDS

    for

    All

    Subsystems

    in

    the

    Sysplex

    and

    the

    Shared

    Data

    Sets

    .

    .

    .

    .

    .

    . 417

    LISTRECOVERY

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 419

    LISTRECOVERY

    for

    Data

    Set

    Requiring

    Recovery

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 420

    Appendix

    D.

    Invoking

    Access

    Method

    Services

    from

    Your

    Program

    .

    .

    .

    .

    . 421

    Contents

    vii

    |||||||||||||||||||||||||||||||||||||||||||||||||

  • Authorized

    Program

    Facility

    (APF)

    .

    .

    .

    .

    .

    . 421

    Invoking

    Macro

    Instructions

    .

    .

    .

    .

    .

    .

    .

    . 421

    LINK

    or

    ATTACH

    Macro

    Instruction

    .

    .

    .

    . 421

    LOAD

    and

    CALL

    Macro

    Instructions

    .

    .

    .

    . 423

    Invocation

    from

    a

    PL/I

    Program

    .

    .

    .

    .

    .

    . 424

    Processor

    Invocation

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 426

    Processor

    Condition

    Codes

    .

    .

    .

    .

    .

    .

    .

    . 427

    User

    I/O

    Routines

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 427

    VSAM

    Record-Level

    Sharing

    Considerations

    .

    . 430

    Appendix

    E.

    DCOLLECT

    User

    Exit

    .

    . 431

    User

    Exit

    Description

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 431

    User

    Exit

    Example

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 432

    Appendix

    F.

    Interpreting

    DCOLLECT

    Output

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 437

    DCOLLECT

    Output

    Record

    Structure

    .

    .

    .

    .

    . 438

    DCOLLECT

    Output

    Record

    Field

    Descriptions

    .

    . 469

    Header

    Record

    Field

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 469

    Active

    Data

    Set

    Record

    Field

    .

    .

    .

    .

    .

    .

    . 470

    VSAM

    Association

    Record

    Field

    .

    .

    .

    .

    .

    . 473

    Volume

    Record

    Field

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 475

    Data

    Class

    Construct

    Field

    .

    .

    .

    .

    .

    .

    .

    . 477

    Storage

    Class

    Construct

    Field

    .

    .

    .

    .

    .

    .

    . 481

    Management

    Class

    Construct

    Field

    .

    .

    .

    .

    . 484

    Base

    Configuration

    Field

    .

    .

    .

    .

    .

    .

    .

    . 490

    Aggregate

    Group

    Construct

    Field

    .

    .

    .

    .

    .

    . 491

    Storage

    Group

    Construct

    Field

    .

    .

    .

    .

    .

    . 492

    Volume

    Definition

    Field

    .

    .

    .

    .

    .

    .

    .

    .

    . 497

    Optical

    Drive

    Information

    Field

    .

    .

    .

    .

    .

    . 498

    Library

    Information

    Field

    .

    .

    .

    .

    .

    .

    .

    . 499

    Migrated

    Data

    Set

    Record

    Field

    .

    .

    .

    .

    .

    . 501

    Backup

    Data

    Set

    Record

    Field

    .

    .

    .

    .

    .

    .

    . 502

    DASD

    Capacity

    Planning

    Record

    Field

    .

    .

    .

    . 504

    Tape

    Capacity

    Planning

    Record

    Field

    .

    .

    .

    . 506

    Appendix

    G.

    Accessibility

    .

    .

    .

    .

    .

    . 509

    Using

    assistive

    technologies

    .

    .

    .

    .

    .

    .

    .

    . 509

    Keyboard

    navigation

    of

    the

    user

    interface

    .

    .

    .

    . 509

    z/OS

    information

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 509

    Notices

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 511

    Programming

    interface

    information

    .

    .

    .

    .

    .

    . 512

    Trademarks

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 512

    Glossary

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 513

    Index

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 527

    viii

    z/OS

    V1R6.0

    DFSMS

    Access

    Method

    Services

    for

    Catalogs

  • Figures

    1.

    ALTER

    Attributes

    That

    Can

    be

    Altered

    and

    Types

    of

    Catalog

    Entries

    .

    .

    .

    .

    .

    .

    .

    . 55

    2.

    ALTER

    Attributes

    That

    Can

    be

    Altered

    and

    Types

    of

    Catalog

    Entries

    .

    .

    .

    .

    .

    .

    .

    . 56

    3.

    Example

    of

    Character

    Format

    .

    .

    .

    .

    .

    . 300

    4.

    Example

    of

    Dump

    Format

    .

    .

    .

    .

    .

    .

    . 301

    5.

    Example

    of

    Hexadecimal

    Format

    .

    .

    .

    .

    . 301

    6.

    Example

    of

    the

    Printed

    Record

    in

    DUMP

    Format

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 302

    7.

    Example

    of

    the

    Printed

    Record

    in

    Hexadecimal

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 303

    8.

    Example

    of

    a

    Printed

    Alphanumeric

    Character

    Record

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 303

    9.

    Messages

    That

    Follow

    the

    Entry

    Listing

    378

    10.

    Example

    of

    LISTCAT

    Output

    When

    No

    Parameters

    Are

    Specified

    .

    .

    .

    .

    .

    .

    .

    . 379

    11.

    Example

    of

    LISTCAT

    NAME

    Output

    380

    12.

    Example

    of

    LISTCAT

    VOLUME

    Output

    381

    13.

    Example

    of

    LISTCAT

    ALL

    Output

    .

    .

    .

    . 386

    14.

    Example

    of

    LISTCAT

    ALL

    Output

    for

    a

    Non-VSAM

    Tailored

    Compressed

    Dataset

    .

    . 397

    15.

    Example

    of

    LISTCAT

    ALLOCATION

    Output

    398

    16.

    Example

    of

    LISTCAT

    HISTORY

    Output

    403

    17.

    Example

    of

    LISTCAT

    ENTRIES

    Output

    406

    18.

    Example

    of

    LISTCAT

    CREATION(5)

    Output

    407

    19.

    Example

    of

    LISTCAT

    EXPIRATION(365)

    Output

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 408

    20.

    LISTDS

    with

    Data

    Set

    in

    Retained

    Lock

    State

    412

    21.

    LISTDS

    for

    Data

    Set

    Being

    Shared

    by

    Multiple

    Subsystems

    .

    .

    .

    .

    .

    .

    .

    .

    . 412

    22.

    LISTDS

    for

    Data

    Set

    in

    NON-RLS

    PERMITTED

    State

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 413

    23.

    LISTDS

    for

    Data

    Set

    in

    Both

    NON-RLS

    UPDATE

    and

    PERMIT

    FIRST

    TIME

    States

    .

    . 414

    24.

    LISTDS

    for

    Data

    Set

    in

    Lost

    Lock

    State

    414

    25.

    Listing

    Data

    Sets

    with

    JOBS

    Keyword

    415

    26.

    Listing

    Shunted

    Data

    Sets

    .

    .

    .

    .

    .

    .

    . 415

    27.

    LISTSUBSYS

    for

    all

    Subsystems

    Sharing

    Data

    Sets

    in

    the

    Sysplex

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 416

    28.

    LISTSUBSYSDS

    for

    Subsystem

    Sharing

    Multiple

    Data

    Sets

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 417

    29.

    LISTSUBSYSDS

    for

    all

    Subsystems

    in

    the

    Sysplex

    and

    the

    Shared

    Data

    Sets

    .

    .

    .

    .

    . 419

    30.

    LISTRECOVERY

    for

    Data

    Set

    Requiring

    Recovery

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 420

    31.

    Processor

    Invocation

    Argument

    List

    from

    Your

    Program

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 425

    32.

    Arguments

    Passed

    to

    and

    from

    a

    User

    I/O

    Routine

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 429

    33.

    DCOLLECT

    User

    Exit

    Example

    .

    .

    .

    .

    . 433

    Copyright

    IBM

    Corp.

    1973,

    2004

    ix

  • x

    z/OS

    V1R6.0

    DFSMS

    Access

    Method

    Services

    for

    Catalogs

  • Tables

    1.

    Summary

    of

    AMS

    commands

    .

    .

    .

    .

    .

    . 27

    2.

    Allocate

    Command

    Parameters

    .

    .

    .

    .

    .

    . 31

    3.

    Data

    Class

    Attributes

    vs.

    Data

    Set

    Organization

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 37

    4.

    How

    NEWNAME

    Resolves

    When

    Change

    of

    Catalog

    is

    Required

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 65

    5.

    Required

    Security

    Authorization

    for

    Catalogs

    351

    6.

    Required

    Security

    Authorization

    for

    VSAM

    Data

    Sets

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 352

    7.

    Required

    Security

    Authorization

    for

    Non-VSAM

    Data

    Sets

    .

    .

    .

    .

    .

    .

    .

    .

    . 353

    8.

    Required

    Security

    Authorization

    for

    LISTCAT

    354

    9.

    Required

    Security

    Authorization

    for

    Data

    Set

    Operations

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 354

    10.

    Required

    Security

    Authorization

    for

    VOLCAT

    Operations

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 354

    11.

    RACF

    FACILITY

    Class

    Authorization

    for

    IDCAMS

    Commands

    .

    .

    .

    .

    .

    .

    .

    .

    . 355

    12.

    Required

    Authorization

    for

    SHCDS

    Subcommands

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 356

    13.

    Device

    Type

    Translate

    Table

    .

    .

    .

    .

    .

    .

    . 376

    14.

    DCOLLECT

    Output

    Record

    Structure

    438

    15.

    DCOLLECT

    Data

    Class

    Definition

    (Record

    Type

    DC)

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 446

    16.

    DCOLLECT

    Storage

    Class

    Definition

    (Record

    Type

    SC)

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 449

    17.

    DCOLLECT

    Management

    Class

    Definition

    (Record

    Type

    MC)

    .

    .

    .

    .

    .

    .

    .

    .

    . 451

    18.

    DCOLLECT

    Storage

    Group

    Definition

    (Record

    Type

    SG)

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 455

    19.

    DCOLLECT

    SMS

    Volume

    Information

    (Record

    Type

    VL)

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 456

    20.

    DCOLLECT

    Base

    Configuration

    Information

    (Record

    Type

    BC)

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 458

    21.

    DCOLLECT

    Aggregate

    Group

    Definition

    (Record

    Type

    AG)

    .

    .

    .

    .

    .

    .

    .

    .

    . 459

    22.

    DCOLLECT

    Optical

    Drive

    Information

    (Record

    Type

    DR)

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 460

    23.

    DCOLLECT

    Optical

    Library

    Information

    (Record

    Type

    LB)

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 461

    24.

    DCOLLECT

    Cache

    Names

    (Record

    Type

    CN)

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 462

    25.

    DCOLLECT

    Accounting

    Information

    (Record

    Type

    AI)

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    .

    . 463

    26.

    DCOLLECT

    Output

    Listing:

    CONSTANTS

    463

    Copyright

    IBM

    Corp.

    1973,

    2004

    xi

  • xii

    z/OS

    V1R6.0

    DFSMS

    Access

    Method

    Services

    for

    Catalogs

  • About

    this

    document

    This

    document

    is

    intended

    to

    help

    you

    use

    access

    method

    services

    commands.

    It

    contains

    reference

    information

    about

    the

    commands

    used

    to

    manipulate

    catalogs

    and

    the

    objects

    cataloged

    in

    them.

    It

    gives

    the

    syntax,

    a

    brief

    description,

    and

    examples

    of

    each

    access

    method

    services

    command

    used

    with

    catalogs

    and

    the

    objects

    cataloged

    in

    them.

    For

    more

    information

    on

    the

    use

    of

    commands

    related

    to

    catalog

    format

    and

    structure,

    see

    z/OS

    DFSMS:

    Managing

    Catalogs,

    SC26-7409.

    For

    information

    on

    the

    use

    of

    commands

    related

    to

    VSAM

    data

    set

    format

    and

    structure,

    see

    z/OS

    DFSMS:

    Using

    Data

    Sets,

    SC26-7410.

    In

    this

    document,

    the

    term

    CICS

    refers

    to

    the

    CICS

    Transaction

    Server

    for

    z/OS.

    Required

    product

    knowledge

    To

    use

    this

    publication

    effectively,

    you

    should

    be

    familiar

    with

    the

    following:

    v

    Catalog

    administration

    v

    Job

    control

    language

    (JCL)

    v

    VSAM

    data

    management

    Referenced

    documents

    The

    following

    publications

    are

    referenced

    in

    this

    document:

    Publication

    Title

    Order

    Number

    z/OS

    DFSMS

    Macro

    Instructions

    for

    Data

    Sets

    SC26-7408

    z/OS

    DFSMS:

    Managing

    Catalogs

    SC26-7409

    z/OS

    DFSMS:

    Using

    Data

    Sets

    SC26-7410

    z/OS

    Cryptographic

    Services

    ICSF

    System

    Programmers

    Guide

    SA22-7520

    z/OS

    MVS

    JCL

    Reference

    SA22-7597

    z/OS

    MVS

    JCL

    Users

    Guide

    SA22-7598

    z/OS

    MVS

    System

    Messages,

    Vol

    1

    (ABA-AOM)

    SA22-7631

    z/OS

    MVS

    System

    Messages,

    Vol

    2

    (ARC-ASA)

    SA22-7632

    z/OS

    MVS

    System

    Messages,

    Vol

    3

    (ASB-BPX)

    SA22-7633

    z/OS

    MVS

    System

    Messages,

    Vol

    4

    (CBD-DMO)

    SA22-7634

    z/OS

    MVS

    System

    Messages,

    Vol

    5

    (EDG-GFS)

    SA22-7635

    z/OS

    MVS

    System

    Messages,

    Vol

    6

    (GOS-IEA)

    SA22-7636

    z/OS

    MVS

    System

    Messages,

    Vol

    7

    (IEB-IEE)

    SA22-7637

    z/OS

    MVS

    System

    Messages,

    Vol

    8

    (IEF-IGD)

    SA22-7638

    z/OS

    MVS

    System

    Messages,

    Vol

    9

    (IGF-IWM)

    SA22-7639

    z/OS

    MVS

    System

    Messages,

    Vol

    10

    (IXC-IZP)

    SA22-7640

    z/OS

    TSO/E

    Command

    Reference

    SA22-7782

    Copyright

    IBM

    Corp.

    1973,

    2004

    xiii

    |

  • Accessing

    z/OS

    DFSMS

    documents

    on

    the

    Internet

    In

    addition

    to

    making

    softcopy

    documents

    available

    on

    CD-ROM,

    IBM

    provides

    access

    to

    unlicensed

    z/OS

    softcopy

    documents

    on

    the

    Internet.

    To

    view,

    search,

    and

    print

    z/OS

    documents,

    go

    to

    the

    z/OS

    Internet

    Library:

    http://www.ibm.com/eserver/zseries/zos/bkserv/

    Using

    LookAt

    to

    look

    up

    message

    explanations

    LookAt

    is

    an

    online

    facility

    that

    lets

    you

    look

    up

    explanations

    for

    most

    of

    the

    IBM

    messages

    you

    encounter,

    as

    well

    as

    for

    some

    system

    abends

    and

    codes.

    Using

    LookAt

    to

    find

    information

    is

    faster

    than

    a

    conventional

    search

    because

    in

    most

    cases

    LookAt

    goes

    directly

    to

    the

    message

    explanation.

    You

    can

    use

    LookAt

    from

    the

    following

    locations

    to

    find

    IBM

    message

    explanations

    for

    z/OS

    elements

    and

    features,

    z/VM,

    and

    VSE:

    v

    The

    Internet.

    You

    can

    access

    IBM

    message

    explanations

    directly

    from

    the

    LookAt

    Web

    site

    at

    http://www.ibm.com/eserver/zseries/zos/bkserv/lookat/.

    v

    Your

    z/OS

    TSO/E

    host

    system.

    You

    can

    install

    code

    on

    your

    z/OS

    or

    z/OS.e

    systems

    to

    access

    IBM

    message

    explanations,

    using

    LookAt

    from

    a

    TSO/E

    command

    line

    (for

    example,

    TSO/E

    prompt,

    ISPF,

    or

    z/OS

    UNIX

    System

    Services

    running

    OMVS).

    v

    Your

    Windows

    workstation.

    You

    can

    install

    code

    to

    access

    IBM

    message

    explanations

    on

    the

    z/OS

    Collection

    (SK3T-4269),

    using

    LookAt

    from

    a

    Windows

    DOS

    command

    line.

    v

    Your

    wireless

    handheld

    device.

    You

    can

    use

    the

    LookAt

    Mobile

    Edition

    with

    a

    handheld

    device

    that

    has

    wireless

    access

    and

    an

    Internet

    browser

    (for

    example,

    Internet

    Explorer

    for

    Pocket

    PCs,

    Blazer,

    or

    Eudora

    for

    Palm

    OS,

    or

    Opera

    for

    Linux

    handheld

    devices).

    Link

    to

    the

    LookAt

    Mobile

    Edition

    from

    the

    LookAt

    Web

    site.

    You

    can

    obtain

    code

    to

    install

    LookAt

    on

    your

    host

    system

    or

    Windows

    workstation

    from

    a

    disk

    on

    your

    z/OS

    Collection

    (SK3T-4269),

    or

    from

    the

    LookAt

    Web

    site

    (click

    Download,

    and

    select

    the

    platform,

    release,

    collection,

    and

    location

    that

    suit

    your

    needs).

    More

    information

    is

    available

    in

    the

    LOOKAT.ME

    files

    available

    during

    the

    download

    process.

    Accessing

    z/OS

    licensed

    documents

    on

    the

    Internet

    z/OS

    licensed

    documentation

    is

    available

    on

    the

    Internet

    in

    PDF

    format

    at

    the

    IBM

    Resource

    Link

    Web

    site

    at:

    http://www.ibm.com/servers/resourcelink

    Licensed

    documents

    are

    available

    only

    to

    customers

    with

    a

    z/OS

    license.

    Access

    to

    these

    documents

    requires

    an

    IBM

    Resource

    Link

    user

    ID

    and

    password,

    and

    a

    key

    code.

    With

    your

    z/OS

    order

    you

    received

    a

    Memo

    to

    Licensees,

    (GI10-0671),

    that

    includes

    this

    key

    code.

    1

    To

    obtain

    your

    IBM

    Resource

    Link

    user

    ID

    and

    password,

    log

    on

    to:

    http://www.ibm.com/servers/resourcelink

    To

    register

    for

    access

    to

    the

    z/OS

    licensed

    documents:

    1.

    z/OS.e

    customers

    received

    a

    Memo

    to

    Licensees,

    (GI10-0684)

    that

    includes

    this

    key

    code.

    xiv

    z/OS

    V1R6.0

    DFSMS

    Access

    Method

    Services

    for

    Catalogs

    http://www.ibm.com/servers/eserver/zseries/zos/bkserv/lookat/http://www.ibm.com/servers/resourcelinkhttp://www.ibm.com/servers/resourcelink
  • 1.

    Sign

    in

    to

    Resource

    Link

    using

    your

    Resource

    Link

    user

    ID

    and

    password.

    2.

    Select

    User

    Profiles

    located

    on

    the

    left-hand

    navigation

    bar.

    Note:

    You

    cannot

    access

    the

    z/OS

    licensed

    documents

    unless

    you

    have

    registered

    for

    access

    to

    them

    and

    received

    an

    e-mail

    confirmation

    informing

    you

    that

    your

    request

    has

    been

    processed.

    Printed

    licensed

    documents

    are

    not

    available

    from

    IBM.

    You

    can

    use

    the

    PDF

    format

    on

    either

    z/OS

    Licensed

    Product

    Library

    CD-ROM

    or

    IBM

    Resource

    Link

    to

    print

    licensed

    documents.

    Notational

    conventions

    IBM

    uses

    a

    uniform

    notation

    to

    describe

    the

    syntax

    of

    access

    method

    services

    commands.

    This

    notation

    is

    not

    part

    of

    the

    language;

    it

    is

    a

    way

    of

    describing

    the

    syntax

    of

    the

    commands,

    and

    uses

    these

    conventions:

    [

    ]

    Brackets

    enclose

    an

    optional

    entry.

    You

    can,

    but

    need

    not,

    include

    the

    entry.

    Examples

    are:

    v

    [length]

    v

    [MF=E]

    |

    An

    OR

    sign

    separates

    alternative

    entries.

    You

    must

    include

    one,

    and

    only

    one,

    of

    the

    entries

    unless

    you

    allow

    an

    indicated

    default.

    Examples

    are:

    v

    [REREAD|LEAVE]

    v

    [length|'S']

    {

    }

    Braces

    enclose

    alternative

    entries.

    You

    must

    use

    one,

    and

    only

    one,

    of

    the

    entries.

    Examples

    are:

    v

    BFTEK={S|A}

    v

    {K|D}

    v

    {address|S|O}

    Sometimes

    alternative

    entries

    are

    shown

    in

    a

    vertical

    stack

    of

    braces.

    An

    example

    is:

    MACRF={{(R[C|P])}

    {(W[C|P|L])}

    {(R[C],W[C])}}

    In

    the

    example

    above,

    you

    must

    choose

    only

    one

    entry

    from

    the

    vertical

    stack.

    ...

    An

    ellipsis

    indicates

    that

    the

    entry

    immediately

    preceding

    the

    ellipsis

    can

    be

    repeated.

    For

    example:

    v

    (dcbaddr,[(options)],.

    .

    .)

    A

    blank

    indicates

    that

    a

    blank

    must

    be

    present

    before

    the

    next

    parameter.

    UPPERCASE

    BOLDFACE

    Uppercase-boldface

    type

    indicates

    entries

    that

    you

    must

    code

    exactly

    as

    shown.

    These

    entries

    have

    keywords

    and

    the

    following

    punctuation

    symbols:

    commas,

    parentheses,

    and

    equal

    signs.

    Examples

    are:

    v

    CLOSE

    ,

    ,

    ,

    ,TYPE=T

    v

    MACRF=(PL,PTC)

    About

    this

    document

    xv

  • UNDERSCORED

    UPPERCASE

    BOLDFACE

    Underscored

    uppercase

    boldface

    type

    indicates

    the

    default

    used

    if

    you

    do

    not

    specify

    any

    of

    the

    alternatives.

    Examples

    are:

    v