StorageTek Host Software Component 6.0 Manuals

Manuals and User Guides for StorageTek Host Software Component 6.0. We have 1 StorageTek Host Software Component 6.0 manual available for free PDF download: System Programmer's Manual

StorageTek Host Software Component 6.0 System Programmer's Manual (718 pages)

Brand: StorageTek | Category: Software | Size: 5 MB

Table of Contents
5
What's New with this Release

25
Preface

27
- Scope
  27
- Intended Audience
  27
- Organization of this Guide
  27
- How to Use this Guide
  28
- References to HSC Product Releases
  29
- Related Publications
  29
  - Storagetek HSC Publications - VM Environment
    29
  - Miscellaneous Publications
    29
- Reader's Comments
  29
- Storagetek Product Support
  29
Chapter 1. System Description

31
Chapter 2. Host Software Component Functions

49
Chapter 3. HSC Control Statements and HSC Start Procedure

113
Chapter 4. Utility Functions

199
- Overview of Library Utilities
  199
- Table 9. Utilities Overview
  199
- Selecting a Utility
  200
- Table 10. HSC Utilities and Functions
  200
- Typical Use of Utilities
  202
- Control Statement Syntax Conventions
  203
- Utility Syntax Conventions
  203
- Utility Environmental Requirements
  203
- ACS UTIL Exec
  204
  - CMS Environment
    205
  - SCP Environment
    206
  - JCL and Control Statements
    207
  - SCP Batch Job Control Language (JCL)
    207
  - Submitting Jobs
    209
  - Utility Control Statements
    210
  - Sample SCP Batch Job File - JCL and Control Statements
    210
- Utility Administrator (SLUADMIN)
  211
  - How to Invoke SLUADMIN
    211
- How to Invoke Utility Programs
  212
- SLUADMIN Program Return Codes
  212
- Table 11. SLUADMIN Return Codes
  212
- Reports Created by Utilities
  213
  - Report Headings
    213
  - Parameters Controlling Report Headings
    213
  - Example
    214
- Stand-Alone Utilities
  215
- Activities Report Utility
  216
  - Sluactv Exec
    216
  - Syntax
    218
  - Utility Name
    218
  - Parameters
    218
  - Invoking the Activities Report Utility
    220
  - Control File Example
    220
  - Output Description
    220
  - Figure 9. Activities Report Utility Sample Output
    227
- Audit Utility
  228
  - Media Type Mismatch Conditions
    229
  - Actions Permitted During an Audit
    230
  - How the Audit Utility Functions
    230
  - Concurrent Audits
    231
  - Syntax
    232
  - Utility Name
    232
  - Parameters
    232
  - JCL Requirements
    237
  - Invoking the Audit Utility
    237
  - JCL Examples
    238
  - Output Description
    239
  - Figure 10. Audit Utility Sample Output
    240
- Backup Utility
  241
  - Prerequisites
    241
  - Reasons for Running the Backup Utility
    241
  - How the Backup Utility Functions
    242
  - Backup Procedure
    243
  - When CDS Copies Are Split Among Hosts after an Error
    243
  - Syntax
    244
  - Utility Name
    244
    
    Parameters
    244
    
    JCL Requirements
    247
    
    Invoking the Backup Utility
    248
    
    JCL Examples
    249
    
    Output Description
    250
    
    Figure 11. Backup Utility Sample Output
    252
    
    How to Restart Backup
    254
    
    Related Utilities
    254
  - Database Decompile (LIBGEN) Utility
    255
    
    Prerequisites
    255
    
    Reasons for Running the Database Decompile Utility
    255
    
    How the Database Decompile Utility Functions
    255
    
    Syntax
    256
    
    Utility Name
    256
    
    Parameters
    256
    
    JCL Requirements
    256
    
    Invoking the Database Decompile Utility
    257
    
    JCL Example
    257
    
    Output Description
    258
    
    Table 12. Label Descriptions for Devices in Output LIBGEN
    258
    
    Figure 12. Database Decompile Utility Sample Output
    259
  - Directory Rebuild Utility
    266
    
    Prerequisites
    266
    
    Reasons for Running the Directory Rebuild Utility
    266
    
    How the Directory Rebuild Utility Functions
    266
    
    Syntax
    266
    
    Utility Name
    266
    
    Parameters
    266
    
    JCL Requirements
    266
    
    Invoking the Database Decompile Utility
    267
    
    JCL Example
    268
    
    Output Description
    268
  - Eject Cartridge Utility
    269
    
    Syntax
    269
    
    Utility Name
    270
    
    Parameters
    271
    
    JCL Requirements
    276
    
    Invoking the Eject Cartridge Utility
    276
    
    JCL Examples
    277
    
    Output Description
    278
    
    Figure 13. Eject Cartridge Utility Sample Output
    278
  - Enter Cartridges Utility
    279
    
    CAP Operating Instructions
    279
    
    Syntax
    279
    
    Utility Name
    279
    
    Parameters
    279
    
    JCL Requirements
    280
    
    Invoking the Enter Cartridges Utility
    280
    
    JCL Example
    281
    
    Output Description
    281
    
    Figure 14. Enter Cartridge Utility Sample Output
    282
- Journal Offload Utility
  283
  - Syntax
    283
  - Utility Name
    283
  - Parameters
    283
  - JCL Requirements
    283
  - Invoking the Journal Offload Utility
    284
  - JCL Example
    285
  - Output Description
    285
  - Figure 15. Journal Offload Utility Sample Output
    286
- Move Utility
  287
  - Move Considerations
    287
  - Syntax
    288
  - Utility Name
    288
  - Parameters
    288
  - JCL Requirements
    290
  - Invoking the Move Utility
    290
  - JCL Examples
    291
  - Output Description
    291
  - Figure 16. Move Utility Sample Output
    292
- Performance Log Reblocker Utility
  293
  - Syntax (CMS Statement)
    293
  - Parameters
    293
  - Invoking the Performance Log Reblocker Utility in CMS
    294
  - Invoking the Performance Log Reblocker Utility in MVS
    294
  - JCL Requirements
    295
- Reconfiguration Utility
  296
- Restore Utility
  306
  - Prerequisites
    306
  - Reasons for Running the Restore Utility
    306
  - How the Restore Utility Functions
    306
  - Special Considerations for Control Data Sets Processing Independently
    307
  - Utility Name
    307
  - Parameters
    307
  - JCL Requirements
    308
  - Invoking the Restore Utility
    309
  - JCL Examples
    309
  - Output Description
    311
  - Figure 17. Restore Utility Sample Output
    312
  - How to Handle Backup/Restore Discrepancies
    313
- Scratch Redistribution Utility
  314
  - How the Scratch Redistribution Utility Functions
    314
  - Syntax
    315
  - Utility Name
    315
  - Parameters
    316
    
    JCL Requirements
    322
    
    Invoking the Scratch Redistribution Utility
    322
    
    JCL Examples
    322
    
    Output Description
    324
    
    Figure 18. Scratch Redistribution Utility Sample Output
    324
  - Scratch Update Utilities
    325
    
    Syntax
    325
    
    Utility Names
    325
    
    Parameters
    326
    
    JCL Requirements
    326
    
    Invoking the Scratch Update Utilities
    326
    
    JCL Example
    327
    
    Output Description
    327
    
    Figure 19. Scratch Update Utilities Sample Output
    328
  - SET Utility
    329
    
    How the SET Utility Functions
    330
    
    Table 14. HSC State to Run SET Options
    330
    
    Considerations before Running the SET Utility
    331
    
    Summary of SET Utility Options
    331
    
    Table 15. SET Utility Options
    332
    
    Syntax
    333
    
    Utility Name
    334
    
    Parameters
    334
    
    Table 16. Mapping of Command Prefix Codes to Characters
    336
    
    Table 17. HSC State/Set SLIDRIVS Operation
    343
    
    JCL Requirements
    346
    
    Invoking the Set Utility
    347
    
    JCL Examples
    348
    
    Output Description
    349
  - Unselect Utility
    350
    
    Syntax
    350
    
    Utility Name
    351
    
    Parameters
    351
    
    JCL Requirements
    351
    
    Invoking the Unselect Utility
    351
    
    JCL Example
    352
    
    Output Description
    352
    
    Figure 20. Unselect Utility Sample Output
    353
  - Volume Report Utility
    354
    
    Media Type and Recording Technique Considerations
    355
    
    Syntax
    357
    
    Utility Name
    358
    
    Parameters
    358
    
    Jcl/Parameter File Requirements
    363
    
    Jcl/Parameter File Syntax
    364
    
    Table 18. SLSVA Effect on Volume Report
    364
    
    Invoking the Volume Report Utility
    367
    
    JCL Example
    368
    
    Output Description
    369
    
    Figure 21. Volume Report Summary(Total) Sample Output
    373
    
    Figure 22. Volume Report Utility Summary(Subpool) Sample Output
    375
Chapter 5. Problem Determination, Diagnostics, and Recovery

377
- Overview
  377
- Messages
  377
  - HSC Messages
    377
  - SCP Messages
    377
- Abend Codes
  377
  - HSC ABEND Codes
    377
  - SCP ABEND Codes
    377
- Software Trace Facilities
  378
  - CP Trace Table
    378
  - Ccwtrace
    378
  - VM (CP) Debug Commands
    379
  - SCP SET TRACE Command
    379
  - SCP Internal Trace Table
    379
  - IPARML (IUCV Parameter List)
    383
  - Table 19. IUCV Functions
    383
  - IUCV Interrupt Buffer
    390
- Diagnostic Capabilities
  396
  - SCP Trace Facility
    396
  - Supervisor Call and Abnormal End Dumps
    396
  - Error Recording Data Set Records
    396
  - SCP External Trace Facility
    397
  - SCP Trace Formatter Utility
    398
  - Supervisor Call (SVC) Functions
    400
  - Table 20. SVC Functions
    401
  - SCP GTRACE Emulation
    402
  - Table 21. Fids Used by SCP
    402
  - HSC Internal Trace Table
    404
  - Table 22. Format of HSC Internal Trace Table
    404
  - Figure 23. HSC Internal Trace Table Example
    405
  - HSC TRACE Command
    406
  - Table 23. HSC GTRACE USR Records
    406
- Diagnostic Commands
  407
  - VM (CP) Commands
    407
  - SCP Debug Mode
    407
  - Setting Initialization Sequence Break-Points
    407
  - SCP Diagnostic Subsystem Commands
    409
  - HSC Diagnostic Commands
    413
- CDS Recovery Capabilities
  415
  - Control Data Set Recovery
    415
  - Figure 24. Control Data Set Recovery Scheme
    417
- Dump Processing
  421
  - Type of Dumps Supported
    421
  - How to Request a Dump
    421
  - What to Do When a Dump Occurs
    422
  - Dump Analysis Using SLUIPCS
    424
  - Table 24. Subcommands for the SCAN Environment
    424
  - Table 25. VIEW-Able SCP Data Structures
    426
  - Table 26. VIEW-Able HSC Data Structures
    427
  - Major SCP Data Relationships
    430
  - Table 27. SLLUIPCS Print Options
    430
  - Figure 25. Command, Message and Trace Processing
    431
  - Diagnostic Techniques
    432
  - Figure 26. SCP Task/Job Data Relationship
    433
  - Figure 27. Subsystem Data Relationships
    434
  - Common Dump Analysis Tasks
    435
Chapter 6. Performance Considerations

441
Appendix A. Macros, Control Statements, Utilities, and Commands Syntax Reference

459
- Syntax Flow Diagrams
  459
  - Specifying Commands
    459
  - Variables
    459
  - Delimiters
    459
  - Flow Lines
    460
  - Single Required Choice
    460
  - Single Optional Choice
    461
  - Defaults
    461
  - Repeat Symbol
    461
  - Syntax Continuation (Fragments)
    462
- Library Identification
  463
- How to Specify a Capid
  464
- Capid Formats
  464
- Ranges and Lists
  466
- Control Statement Syntax Conventions
  469
- Media, Rectech, and Model Parameters
  471
- Table 29. Media, Rectech, and Model Cross-Reference
  471
- LIBGEN Macros
  474
  - SLIACS Macro
    475
  - SLIALIST Macro
    475
  - SLIDLIST Macro
    475
  - SLIDRIVS Macros
    475
  - SLIENDGN Macro
    475
  - SLILIBRY Macro
    476
  - SLILSM Macro
    477
  - SLIRCVRY Macro
    477
  - SLISTATN Macro
    477
- HSC Control Statements
  478
- Utilities
  487
  - Activities Report Utility
    487
  - Audit Utility
    487
  - Backup Utility
    488
  - Database Decompile (LIBGEN) Utility
    488
  - Directory Rebuild (DIRBLD) Utility
    488
  - Eject Utility
    488
  - Eject Utility (Continued)
    489
  - Enter Cartridges Utility
    489
  - Journal Offload Utility
    490
  - Move Utility
    490
    
    Reconfiguration Utility
    490
    
    Replace Utility
    490
    
    Restore Utility
    491
    
    Scratch Utility
    491
    
    Scratch Redistribution (Scredist) Utility
    492
    
    SET Utility
    493
    
    Unscratch Utility
    494
    
    Unselect Utility
    494
    
    Volume Report (Volrpt) Utility
    495
  - Operator Commands
    496
    
    CAP Preference (Cappref) Command and Control Statement
    496
    
    Cds Enable/Disable Command
    496
    
    Clean Command
    496
    
    Communications Path (Commpath) Command and Control Statement
    497
    
    Dismount Command
    497
    
    Display Command
    498
    
    Drain CAP Command
    506
    
    Eject Command
    506
    
    Enter Command
    508
    
    Journal Command
    508
    
    Modify Command
    508
    
    MONITOR Command
    508
    
    Mount Command
    509
    
    Mount/Dismount Options (MNTD) Command and Control Statement
    510
    
    Move Command
    511
    
    Option Command and Control Statement
    512
    
    Recover Host Command
    512
    
    Release CAP Command
    512
    
    Senter Command
    513
    
    Srvlev (Service Level) Command
    513
    
    Stop Monitoring (STOPMN) Command
    513
    
    Switch Command
    513
    
    Trace Command
    514
    
    TRACELKP Command
    514
    
    Vary Station Command
    514
    
    View Command
    515
    
    Warn Command
    516
  - HSC Diagnostic Commands
    517
    
    List Command
    517
    
    Trace Command
    517
  - SCP Operator Commands
    518
    
    (Comment) Statement
    518
    
    Authorize Command
    518
    
    CANCEL Command
    518
    
    CP Command
    518
    
    Define Command
    518
    
    DUMP Command
    518
    
    FILE Command
    519
    
    HELP Command
    519
    
    Modify Command (SCP)
    519
    
    Query Command
    519
    
    Reply Command
    520
    
    SET Command
    520
    
    SLK Command
    522
    
    Start Command
    522
    
    STOP Command
    522
    
    STOPSCP Command
    522
    
    SUBSYS Command
    522
  - GCS Component Server Commands
    523
    
    SLKGCS Command
    523
  - CMS Operator Commands
    524
    
    Acs Exec
    524
    
    Cms Help
    524
Appendix B. CP Commands and DIAGNOSE Codes

525
- Overview
  525
- CP Commands
  525
- CP Programming Services
  525
- Iucv
  526
Appendix C. Record Formats

527
- Overview
  527
- SMF Records
  529
  - SMF Mapping Macros
    529
  - Table 31. Mapping Macros for SMF Records
    529
- SMF Record Formats
  530
  - Slsdvar
    530
  - Table 32. SLSDVAR Record Format
    530
  - Slssfhdr
    531
  - Table 33. SLSSFHDR Record Format
    531
  - Slssblos
    536
  - Table 34. SLSSBLOS Record Format
    536
  - Slsscapj
    538
  - Table 35. SLSSCAPJ Record Format
    538
  - Slsscapn
    539
  - Table 36. SLSSCAPN Record Format
    539
  - Slssvsta
    540
  - Table 37. SLSSVSTA Record Format
    540
  - Slssmlsm
    542
  - Table 38. SLSSMLSM Record Format
    542
  - Slsslsb
    543
  - Table 39. SLSSLSB Record Format
    543
  - Slssmf07
    545
  - Table 40. SLSSMF07 Record Format
    545
  - Slssmf08
    553
  - Table 41. SLSSMF08 Record Format
    553
- LOGREC Records
  555
  - LOGREC Mapping Macros
    555
  - Table 42. Mapping Macros for LOGREC Records
    555
- LOGREC Record Formats
  556
  - Slsslhdr
    556
  - Table 43. SLSSLHDR Record Format
    556
  - Slssvlg1
    561
  - Table 44. SLSSVLG1 Record Format
    561
  - Slssblog
    563
  - Table 45. SLSSBLOG Record Format
    563
  - Slssllg1
    565
  - Table 46. SLSSLLG1 Record Format
    565
  - Slssllg2
    570
  - Table 47. SLSSLLG2 Record Format
    570
  - Slssllg3
    572
  - Table 48. SLSSLLG3 Record Format
    572
  - Slssllg4
    573
  - Table 49. SLSSLLG4 Record Format
    573
  - Slssllg5
    575
  - Table 50. SLSSLLG5 Record Format
    575
  - Slssllg6
    578
  - Table 51. SLSSLLG6 Record Format
    578
  - Slssdjlr
    583
  - Table 52. SLSSDJLR Record Format
    583
  - Slsspswi
    585
  - Table 53. SLSSPSWI Record Format
    585
  - Slssrl00
    587
  - Table 54. SLSSRL00 Record Format
    587
  - Slssrl01
    588
  - Table 55. SLSSRL01 Record Format
    588
  - Slsshlg1
    589
  - Table 56. SLSSHLG1 Record Format
    589
- Volume Report and Batch API Records
  592
  - Volume Report and Batch API Mapping Macros
    592
  - Table 57. Mapping Macros for Volume Report and Batch API Records
    592
- Volume Report and Batch API Record Formats
  593
  - Sluvadat
    593
  - Table 58. SLUVADAT Record Format
    593
  - Sluvcdat
    601
  - Table 59. SLUVCDAT Record Format
    601
  - Sluvhdat
    604
  - Table 60. SLUVHDAT Record Format
    604
  - Sluvidat
    607
  - Table 61. SLUVIDAT Record Format
    607
  - Sluvsdat
    610
  - Table 62. SLUVSDAT Record Format
    610
  - Sluvvdat
    612
  - Table 63. SLUVVDAT Record Format
    612
- Batch API Records
  623
  - Batch API Mapping Macros
    623
  - Table 64. Mapping Macros for Batch API Records
    623
- Batch API Record Formats
  624
  - Sluvddat
    624
  - Table 65. SLUVDDAT Record Format
    624
  - Sluvpdat
    628
  - Table 66. SLUVPDAT Record Format
    628
Appendix D. Logging ACS Robotics Motion

633
Appendix E. Remote-Linked Libraries

651
- Overview
  651
  - Configuration 1
    652
  - Figure 29. Configuration 1
    652
  - Configuration 2
    653
  - Configuration 3
    654
  - Figure 30. Configuration 3
    654
  - Configuration 4
    655
  - Figure 31. Configuration 4
    655
  - Configuration 5
    656
  - Figure 32. Configuration 5
    656
  - Programming and Operational Considerations
    657
  - Table 80. Programming and Operation Precautions for Remote-Linked Libraries
    657
Appendix F. Batch Application Program Interface (API) 629

659
- Overview
  659
- QCDS Request
  659
  - How QCDS Functions
    659
  - Invoking QCDS (SLSUREQ Macro)
    659
  - Addresses and Registers
    660
  - Syntax
    661
  - Parameters
    661
  - QCDS Programming Considerations
    663
  - Return Codes
    664
  - Table 81. Batch API Return Codes
    664
  - Sample QCDS Requests
    665
  - Figure 33. Sample 1 - Automatic CDS Allocation
    666
  - Mapping Macros
    669
  - Figure 34. Sample 2 - Reading ACS and DRV Together
    671
  - Output Description
    674
  - Table 82. Library Element Record Mapping
    674
- SLSUREQM Macro
  675
  - Syntax
    675
  - Parameters
    675
  - Batch API Mapping (SLSUREQM) Macro
    676
  - Table 83. SLSUREQM Record Format
    676
Glossary

685
Index

701

StorageTek Categories

Storage Network Hardware Software Tape Deck UPS

More StorageTek Manuals

StorageTek Host Software Component 6.0 Manuals

StorageTek Host Software Component 6.0 System Programmer's Manual (718 pages)

Table of Contents

What's New with this Release

Preface

Chapter 1. System Description

Chapter 2. Host Software Component Functions

Chapter 3. HSC Control Statements and HSC Start Procedure

Chapter 4. Utility Functions

Chapter 5. Problem Determination, Diagnostics, and Recovery

Chapter 6. Performance Considerations

Appendix A. Macros, Control Statements, Utilities, and Commands Syntax Reference

Appendix B. CP Commands and DIAGNOSE Codes

Appendix C. Record Formats

Appendix D. Logging ACS Robotics Motion

Appendix E. Remote-Linked Libraries

Appendix F. Batch Application Program Interface (API) 629

Glossary

Index

Related Products

StorageTek Categories