5746-XX1 IBM Data Language One (DL/I DOS/VS) V1R11

EMEA                                                                          
                           PROGRAM PRODUCTS                           Sep 2001

Table of Contents

5746-XX1 IBM Data Language One (DL/I DOS/VS) V1R11

  • Abstract
  • Highlights
  • Description
  • Technical Description
  • Operating Environment
  • Hardware Requirements
  • Software Requirements
  • Planning Information
  • Security, Auditability, and Control
  • 5746-XX1 IBM Data Language One (DL/I DOS/VS) V1 R10
  • Abstract
  • Product Positioning
  • Highlights
  • Description
  • Technical Description
  • Operating Environment
  • Hardware Requirements
  • Software Requirements
  • Planning Information
  • Publications
  • Security, Auditability, and Control
  • DL/I DOS/VS Version 1 Release 9
  • No Longer Available, for IBM US as of December 18, 1992
  • Abstract
  • Product Positioning
  • Highlights
  • Description
  • Operating Environment
  • Hardware Requirements
  • Software Requirements
  • Planning Information
  • Security, Auditability, and Control
  • Publications
  • 5746-XX1 - Data Language/I DOS/VS Release 7
  • Release 7 Is No Longer Available, for IBM US as of June 28, 1991
  • Abstract
  • Product Positioning
  • Highlights
  • Description
  • Highlights
  • Use
  • Customer Responsibilities
  • Operating Environment
  • Hardware Requirements
  • Software Requirements
  • Compatibility
  • Publications
  • 5746-XX1 - IBM Data Language/I DOS/VS V1 R7 M1
  • Abstract
  • Product Positioning
  • Highlights
  • Description
  • Customer Responsibilities
  • Operating Environment
  • Hardware Requirements
  • Software Requirements
  • Compatibility
  • Conversion
  • Migration
  • Security, Auditability, and Control
  • Performance Considerations
  • Publications
  • Licensed Program Materials Availability
  • 5746-XX1 - Data Language/I DOS/VS Release 8
  • Abstract
  • Product Positioning
  • Highlights
  • Description
  • Operating Environment
  • Hardware Requirements
  • Software Requirements
  • Compatibility
  • Migration
  • Security, Auditability, and Control
  • Performance Considerations
  • Publications

  • 5746-XX1 IBM Data Language One (DL/I DOS/VS) V1R11


    Abstract

    There Is More Than One Description for This Product

    Data Language/I (DL/I) VSE is the hierarchical database management system for VSE/ESA. Release 11 runs on VSE/ESA Version 2 Release 4 and supports CICS Transaction Server for VSE/ESA Release 1 (CICS TS VSE/ESA) for online transaction processing. Release 11 is the follow-on release of DL/I designed to replace DL/I DOS/VS. It can coexist with Release 10 (together with on CICS/VSE Version 2 Release 3) on the same VSE/ESA Version 2 Release 4 system.

    What's New

    More than one Multiple Partition Support System (MPS System)

    The DL/I Master Partition Controller for the DL/I MPS function can be activated in more than one CICS/DLI online partition at the same time. This way an MPS batch job can connect to any active CICS/DLI online system and process databases defined there without needing CICS MRO (Multiregion Operation) function shipping.

    More than 4 GB for Hierarchical Direct Databases

    DL/I HD-databases can be allocated on more than one VSAM dataset to get over the 4 GB limit. Up to five datasets can be defined, increasing the maximum database size to 20 GB.

    Support of CICS storage protection

    DL/I VSE Version 1 Release 11 supports the storage protection introduced with CICS Transaction Server for VSE/ESA Release 1. This increases the availability and integrity of the overall CICS/DLI online system.


    Highlights

    DL/I VSE Version 1 Release 11:

    • Supports CICS Transaction Server for VSE/ESA (CICS TS VSE/ESA)

    • Supports CICS storage protection

    • Improves system productivity with multiple MPS systems

    • Increases performance with up to 255 HD-buffers per subpool and up to 30,720 bytes blocksize for index databases

    • Enlarges database size up to 20 GB

    • Extends 31-Bit support

    Description

    DL/I VSE Version 1 Release 11 is the follow-on release of DL/I DOS/VS Release 10.

    DL/I has been adapted to execute in the new online environment of CICS Transaction Server for VSE/ESA Release 1 on VSE/ESA Version 2 Release 4. It supports the CICS Transaction Server for VSE/ESA Release 1 storage protection.

    CICS Transaction Server for VSE/ESA Release 1 and DL/I VSE Version 1 Release 11 can run concurrently with CICS/VSE Version 2 Release 3 and DL/I DOS/VS Version 1 Release 10 on the same VSE/ESA Version 2 Release 4 system in the CICS coexistence environment. This allows to run CICS/DLI Macro Level applications in parallel with Command Level applications.

    The following functions are new in DL/I VSE Version 1 Release 11:

    More than one Multiple Partition Support System (MPS System)

    The DL/I Master Partition Controller for the DL/I MPS function can be activated in more than one CICS/DLI online partition at the same time. This way an MPS batch job can connect to any active CICS/DLI online system and process databases defined there (one connection per job step). The option to dynamically select regular batch (DLZRRC00) or MPS batch (DLZMPI00) execution via the DLZCTRL program has been adapted to the Multiple MPS environment.

    The Multiple MPS function lets you process any local online DL/I database by an MPS batch job without needing CICS MRO (Multiregion Operation) function shipping. This offers performance advantages, because no data is transferred between subsystems.

    More than 4 GB for Hierarchical Direct Databases

    The data component of DL/I HD (HDAM/HIDAM) databases can be allocated on more than one VSAM ESDS dataset. Up to five datasets can be defined, increasing the maximum database size to 20 GB (5 times 4 GB). The enhancement is transparent to user applications. The split into multiple datasets will be realized through an updated DBD definition and a reorganization or new initial load of the database.

    Support of CICS storage protection

    When CICS storage protection is active, DL/I control blocks and data buffers are allocated in storage protected with partition (CICS) key. This prevents that online applications - provided they run in user-key - from inadvertently overwriting DL/I storage affecting the availability or integrity of the CICS/DLI online system.

    To benefit from CICS storage-key protection, CICS/DLI online applications should be defined with user-key. DL/I internally switches to partition-key when processing a DL/I request.

    The following enhancements are additionally available as PTFs for DL/I DOS/VS Version 1 Release 10:

    More Buffers for Hierarchical Direct Databases

    The maximum number of HDAM/HIDAM ESDS-buffers per subpool has been increased to 255 buffers.

    Increased VSAM KSDS Blocksize

    The maximum VSAM blocksize for DL/I index database has been increased to 30,720 bytes. When the DL/I buffer pool or VSAM blocksize is enlarged, the number of I/O operations to a database will be reduced. Customers have reported performance improvements with DL/I batch applications, after allocating more buffers to HD databases and increasing the VSAM blocksize.

    Extended 31-Bit Support

    Customers can load the DL/I PSBs (Program Specification Block) and Queueing Elements of the Program Isolation Function into 31-bit storage.

    The location of the PSBs (GETVIS-31 or CICS DSA as before) is controlled through a new parameter of the DL/I ACT online nucleus generation. PSBs are temporarily copied into the CICS DSA on scheduling requests from CICS/DLI online transactions.

    The DL/I Program Isolation function will always attempt to obtain storage from the area above 16 MB. When not enough storage is available, it will be requested from the GETVIS-24 area as before. Moving DL/I applications or control blocks into 31-bit storage leaves more space below the 16 MB line. The highest value is in a CICS partition with existing virtual storage (DSA) constraints.

    Year 2000

    This product is Year 2000 ready. When used in accordance with its associated documentation, it is capable of correctly processing, providing, and/or receiving date data within and between the 20th and 21st centuries, provided all other products (for example, software, hardware, and firmware) used with the product properly exchange accurate date data with it.


    Technical Description

    Operating Environment

    Hardware Requirements

    The minimum machine requirements are the same as those for VSE/ESA Version 2 Release 4. DL/I VSE Version 1 Release 11 additionally requires at least 256 KB real storage for batch usage, and 512 KB for online usage. When configuring the system, users should refer to the publication, "IBM DL/I VSE Release Guide" (SC33-6211).

    DASD space is required for database storage files. If tape logging is to be utilized, or if Hierarchical Sequential Access Method (HSAM) or Simple HSAM (SHSAM) files are on tape, at least two additional tape units are required.

    Software Requirements

    DL/I VSE Version 1 Release 11 runs on VSE/ESA Version 2 Release 4 with CICS Transaction Server for VSE/ESA Release 1 and is supported for use with:

    • High Level Assembler MVS, VM and VSE Version 1 Release 3 (5696-234)
    • IBM COBOL for VSE/ESA Version 1 Release 1 (5686-068) (Note: DOS/VS COBOL and VS COBOL II application programs are supported when link-edited with LE/VSE.)
    • IBM PL/I for VSE/ESA Version 1 Release 1 (5686-069)
    • IBM Language Environment for VSE/ESA (LE/VSE) Version 1 Release 4 (5686-094)
    • DL/I DOS/VS Space Management Utilities program offering
    • DFSORT/VSE Version 3 Release 4 (5746-SM3)

    Planning Information

    Customer Responsibilities  Not applicable.

    Compatibility  DL/I programming interfaces have not been changed. Customer's batch applications and online applications implemented in CICS command level language will continue to run under DL/I VSE Version 1 Release 11. Online applications using CICS macro-level or accessing CICS control blocks (like TCA) directly have to be converted.

    In the CICS coexistence environment CICS TS VSE/ESA and CICS/VSE can run on the same VSE/ESA Version 2 Release 4 system:

    • DL/I DOS/VS Release 10 is supported for use with CICS/VSE Version 2 Release 3.

    • DL/I VSE Release 11 is supported for use with CICS TS VSE/ESA Release 1 only.

    This allows you to migrate DL/I online applications over time.

    Limitations  DL/I VSE Version 1 Release 11 contains some utility functions that use Interactive System Productivity Facility (ISPF) Version 1 Release 1 (5668-960). DL/I VSE Version 1 Release 11 has alternate batch interfaces that offer equivalent capabilities. Because ISPF is not supported on VSE/ESA, customers should be aware that they may need to use batch interfaces.

    Performance Considerations  DL/I VSE Version 1 Release 11 database performance depends on the individual hardware and software environment and especially on the setup of, and access to, a DL/I database.

    DL/I VSE Version 1 Release 11 includes the following performance enhancements:

    • More than 32 HD buffers per subpool up to 255
    • Maximum Index CI-size (VSAM KSDS) up to 30,720 bytes
    • Maximum size of the DL/I data component increased from 4 GB to 20 GB

    The items above may show DL/I performance improvements in terms of number of I/Os, CPU-time, and database size.


    Security, Auditability, and Control

    These programs use the existing security and auditability features of its components. The customer is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.


    5746-XX1 IBM Data Language One (DL/I DOS/VS) V1 R10


    Abstract

    DL/I DOS/VS Version 1 Release 10 is the hierarchical database management system for VSE/ESA. DL/I DOS/VS continues to be available for VSE/ESA Version 1 Release 3. 31-bit addressing is supported for application programs and index buffers. Virtual disk can be used for work files of DL/I DOS/VS utilities.

    DL/I DOS/VS Version 1 Release 10 runs on VSE/ESA Version 1 Release 3 and replaces DL/I DOS/VS Version 1 Release 9, which runs on VSE/ESA Version 1 Releases 1 and 2. No earlier release than Release 10 will be marketed after March 12, 1993. DL/I DOS/VS Version 1 Release 10 is available two weeks earlier than previously announced.


    Product Positioning

    DL/I DOS/VS is IBM's hierarchical database management system for the small and intermediate System/370* and System/390* VSE environments. Performance, capacity and structural characteristics support high transaction volumes for production data bases. Customers should continue with DL/I DOS/VS for existing transaction applications and new applications that require high transaction volumes.

    SQL/DS* is an SAA* relational database for all IBM System/370 and System/390 VM and VSE environments. Customers should be encouraged to use SQL/DS for new database applications. In addition to supporting production applications, SQL/DS is recommended for end-user queries and quick application prototyping. The SQL language enables increased productivity in application development.


    Highlights

    • DL/I DOS/VS Version 1 Release 10 supports the new CICS/VSE Version 2 Release 2, and application programs running in 31-bit mode.

    • Investment in database is protected because DL/I DOS/VS does not change its interface to the user or the data.

    • Index buffers can be moved above the 16MB line, thus increasing the space below the 16MB line and the performance by enlarging the buffer space.

    • Work files of DL/I DOS/VS utilities can reside on a virtual disk.

    Description

    31-Bit Support for Application Programs:

    DL/I DOS/VS application programs can now be executed above the 16MB line. This is possible for all applications that are implemented in a language with 31-bit capability, such as VS COBOL II and High Level Assembler.

    Growth Enablement - Increased Capacity

    Application programs above the 16MB line can call DL/I DOS/VS. This offers relief in virtual storage. The highest value is in a CICS partition with existing virtual storage constraints.

    Investment Protection - Asset Protection

    Enabling DL/I DOS/VS to support 31-bit CICS/VSE and batch application programs protects the huge investment in a DL/I DOS/VS database and its data. DL/I DOS/VS Version 1 Release 10 is the only release of DL/I DOS/VS that runs on VSE/ESA Version 1 Release 3. Existing 24-bit applications can run unmodified below the 16MB line.

    Investment Protection - Upgradeability

    Together with VSE/ESA Version 1 Release 3 and CICS/VSE Version 2 Release 2, DL/I DOS/VS Version 1 Release 10 offers the capability to upgrade the VSE/ESA DL/I DOS/VS database applications to 31-bit addressing.

    DL/I DOS/VS Index Buffers Can Reside Above the 16MB Line:

    Buffers for DL/I DOS/VS Key Sequenced Data Set (KSDS) index data files can be located above 16MB.

    Growth Enablement - Increased Capacity/Performance Improvement

    The index data typically comprise a third of the data within a DL/I DOS/VS database. Moving the buffers for these data above the 16MB line allows enlargement of the DL/I DOS/VS buffer space (more and larger buffers), thus reducing the number of I/O operations to the database and improving the performance.

    Additionally, DL/I DOS/VS Version 1 Release 10 together with the 31-bit capability of CICS/VSE Version 2 Release 2, allows either increasing the contents of a CICS/VSE partition below the 16MB line, or consolidating several CICS/VSE partitions into one (in case they were split for capacity reasons).

    Virtual Disk of VSE/ESA:

    All DL/I DOS/VS utilities can now allocate their work files on a virtual disk.

    Growth Enablement - Performance Improvement

    Using virtual disks rather than real disks for work files offers significant performance advantages by reducing the number of DASD I/Os provided that there is enough real storage.


    Technical Description

    Operating Environment

    See Hardware and Software Requirements.

    Hardware Requirements

    The minimum machine requirements are the same as those for VSE/ESA Version 1 Release 3. DL/I DOS/VS additionally requires at least 256k bytes real storage for batch usage, and 512k bytes for online usage. Users should refer to the book "IBM DL/I DOS/VS Release Guide" (SC33-6211 for DL/I DOS/VS Version 1 Release 10) when configuring the system.

    DASD space is required for database storage files. If tape logging is to be utilized or if Hierarchical Sequential Access Method (HSAM) or Simple HSAM (SHSAM) files are on tape, additionally at least two 9-track tape units are required.

    Software Requirements

    DL/I DOS/VS Version 1 Release 10 runs on VSE/ESA Version 1 Release 3 (5750-ACD) with CICS/VSE Version 2 Release 2 (5686-026). DOS/VS Sort/Merge Version 2 Release 5 (5746-SM2) is an additional requirement.

    DL/I DOS/VS Version 1 Release 10 is supported for use with:

    • DOS/VS COBOL Compiler and Library (5746-CB1) Version 1 Release 3.1
    • DOS/VS COBOL Library only (5746-LM4) Version 1 Release 3.1
    • VS COBOL II Compiler, Library, Debug (5668-958) Version 1 Release 4
    • VS COBOL II Compiler and Library (5688-023) Version 1 Release 4
    • VS COBOL II Library only (5688-022) Version 1 Release 4
    • PL/I Optimizing Compiler and Libraries (5736-PL3) Version 1 Release 6
    • PL/I Optimizing Compiler (5736-PL1) Version 1 Release 6
    • PL/I Resident Library (5736-LM4) Version 1 Release 6
    • PL/I Transient Library (5736-LM5) Version 1 Release 6
    • High Level Assembler (5696-234) Version 1 Release 1
    • RPG II - DOS/VS (5746-RG1) Version 1 Release 3

    Cross System Product/Application Development (CSP/AD, 5668-813) and CSP/Application Execution (CSP/AE, 5668-814) support DL/I DOS/VS. They help to simplify and manage the creation and maintenance of definitions or descriptions of the data in the system and their use by the application programs.

    Query DL/I (5666-351) Licensed Program provides query facilities for the operational databases. With its easy-to-use menus, it offers functions to get up-to-the-minute information.

    DL/I DOS/VS Space Management Utilities (5796-PKF) Program Offering is designed to help improve system performance and programmer productivity. These utilities detect and report DL/I hierarchical direct (HD) pointer discrepancies, provide statistics and information for HD tuning, and assist with segment restructuring and reloading during database reorganization.

    Data Management System/CICS (5746-XC4) helps to inquire, insert, update, and delete database records. Access into the database may be via primary or secondary indexes.

    Compatibility  Customer's application programs running under DL/I DOS/VS Version 1 Release 9 will also run under DL/I DOS/VS Version 1 Release 10.

    Limitations  DL/I DOS/VS Version 1 Release 10 contains some utility functions which use Interactive System Productivity Facility (ISPF) Version 1 Release 1 (5668-960). DL/I DOS/VS Version 1 Release 10 has alternate batch interfaces which offer equivalent capabilities. Because ISPF is not supported on VSE/ESA, customers should be aware that they may need to use batch interfaces.

    DL/I DOS/VS Version 1 Release 10 does not support 31-bit addressing itself. This means that 31-bit applications calling DL/I DOS/VS must keep their parameters below the 16MB line.


    Planning Information

    Customer Responsibilities  The customer is responsible for the evaluation of the adequacy of the offering to address individual customer requirements. The manuals "IBM DL/I DOS/VS Release Guide" (SC33-6211 for DL/I DOS/VS Version 1 Release 10) and "IBM DL/I DOS/VS General Information" (GH20-1246) will serve as an aid for this task.

    Performance Considerations  Performance improvements may be achieved through more and larger index buffers above the 16 MB line, provided that there is enough real storage.


    Publications

    A memo, a program directory, and one copy of the following publications are supplied automatically with the basic machine-readable material:

     
     Title                                             Order Number
     
     General Information                               GH20-1246
     Reference Summary:  CALL Programming Interface    SX24-5103
     Reference Summary:  System Programming            SX24-5104
     Reference Summary:  HLPI Interface                SX24-5120
     DL/I DOS/VS Release Guide                         SC33-6211
     DL/I DOS/VS Messages and Codes                    SH12-5414
     DL/I DOS/VS Resource Definition and Utilities     SH24-5021
     Licensed Program Specifications                   GH24-5031
     Guide for New Users                               SH24-5001
     Application Programming: HLPI                     SH24-5009
     Database Administration                           SH24-5011
     Application and Database Design                   SH24-5022
     Interactive Resource Definition and Utilities     SH24-5029
     Application Programming:  Call+RQDLI Interfaces   SH12-5411
     Library Guide and Master Index                    GH24-5008
     Diagnostic Guide                                  SH24-5002
     Recovery Restart Guide                            SH24-5030
     Low Level Code/Continuity Check in DL/I           SH20-9046
     
    

    Licensed Documentation

    The following licensed material is available from IBM. To order, contact your IBM marketing representative.

    The first copy is available at no charge to licensees of basic material. Additional copies can be ordered for a fee.

     
     Title                                             Order Number
     
     Logic Volume 1                                    LY12-5016
     Logic Volume 2                                    LY24-5215
     DL/I DOS/VS Logic Extensions                      LY33-9123
     
    

    Microfiche material is no longer offered. Viewing Program Listings (VPL) onine has replaced the need for microfiche. With the VPL system entitled users all around the world are able to view both program trouble fix (PTF) and base product program listings electronically, 24 hours a day. VPL can be accessed via ServiceLink and Dial IBM. For details, ask your IBM representative.


    Security, Auditability, and Control

    This program uses the same security and auditability features as the previous DL/I DOS/VS Version 1 Releases 7, 8, and 9:

    Segment expansion/compression exits are provided for HD-organized data bases, permitting user-written encode/decode routines to improve utilization of direct access storage space or to strengthen security of stored confidential data.

    Database integrity and security is provided through the concept of sensitivity, a description of a program's intended access to a database.

    This program can serve as an aid in reviewing data processed by, or stored in the system for validity and accuracy. DL/I DOS/VS may be of interest to auditors and system designers for its logging capability.

    User management is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.


    DL/I DOS/VS Version 1 Release 9


    No Longer Available, for IBM US as of December 18, 1992


    Abstract

    DL/I DOS/VS Version 1 Release 9 is the hierarchical database management system for VSE/ESA* Version 1 Release 1. DL/I DOS/VS Version 1 Release 8 continues to be available for VSE/SP Version 3 Release 2.2 and VSE/SP Version 4.


    Product Positioning

    DL/I DOS/VS is IBM's hierarchical data base management system for the small and intermediate System/370 environment. Performance, capacity, and structural characteristics support high-volume operational data bases.

    SQL/DS is IBM's SAA relational data base for the small and intermediate System/370 environment. It supports end-user queries, quick application prototyping, and application development. It is also viable as a production data base system.


    Highlights

    • DL/I DOS/VS Version 1 Release 9 runs on VSE/ESA Version 1 Release 1, supporting Enterprise Systems Architecture and System/370 processors.

    • DL/I DOS/VS Version 1 Release 9 supports the new CICS XRF function.

    • Investment in data base is protected because DL/I DOS/VS Version 1 Release 9 does not change its interface to the user or the data.

    • Improved database input and output error handling.

    Description

    Growth Enablement  DL/I DOS/VS Version 1 Release 9 is an optional product for VSE/ESA Version 1 Release 1. VSE/ESA offers higher capacity and support for Enterprise Systems Architecture processors. DL/I DOS/VS Version 1 Release 9 supports CICS/VSE* Version 2 Release 1 with its extended recovery facility (XRF). Several DL/I functions can now run in dynamic partitions like multiple partition support (MPS) jobs. Restrictions are described in the DL/I Release Guide.

    Investment Protection  Current data base investment of users running DL/I DOS/VS Version 1 Release 8 and DL/I DOS/VS Version 1 Release 7 is protected.

    System Management  Reliability is enhanced by a new SIT parameter in CICS/VSE Version 2 Release 1, which in case of data base input or output problems offers to:

    • either abend the CICS DL/I system,

    • or continue to run with a closed data base.

    Operating Environment

    Hardware Requirements

    The minimum machine requirements are the same as those for VSE/ESA Version 1 Release 1. DL/I DOS/VS Version 1 Release 9 additionally requires at least 256KB real storage for batch usage, and 512KB for online usage. Users should refer to the release guide for DL/I DOS/VS Version 1 Release 9 (SC33-6211) when configuring the system.

    DASD space is required for data base storage files. If tape logging is to be utilized or if hierarchic sequential access method (HSAM) or SHSAM files are on tape, additionally at least two 9 track tape units are required.

    Software Requirements

    DL/I DOS/VS Version 1 Release 9 runs on VSE/ESA Version 1 Release 1 (5750-ACD) with CICS/VSE Version 2 Release 1 (5686-026). DOS/VS Sort/Merge Version 2 Release 5 (5746-SM2) is an additional requirement.

    DL/I DOS/VS Version 1 Release 9 is supported for use with

    • DOS/VS COBOL Compiler and Library (5746-CB1)

    • DOS/VS COBOL Library only (5746-LM4)

    • COBOL II Compiler and Library (5688-023)

    • COBOL II Library only (5688-022)

    • PL/I Optimizing Compiler and Libraries (5736-PL3)

    • PL/I Optimizing Compiler (5736-PL1)

    • PL/I Resident Library (5736-LM4)

    • PL/I Transient Library (5736-LM5)

    • RPG II - DOS/VS (5746-RG1)

    Cross System Product/Application Development (CSP/AD, 5668-813) and CSP/Application Execution (CSP/AE, 5668-814) support DL/I DOS/VS Version 1 Release 9. They help to simplify and manage the creation and maintenance of definitions or descriptions of the data in the system and their use by the application programs.

    Query DL/I (5666-351) Licensed Program provides query facilities for the operational databases. With its easy-to-use menus, it offers functions to get up-to-the-minute information.

    DL/I DOS/VS Space Management Utilities (5796-PKF) Program Offering is designed to help improve system performance and programmer productivity. These utilities detect and report DL/I hierarchical direct (HD) pointer discrepancies, provide statistics and information for HD tuning, and assist with segment restructuring and reloading during data base reorganization.

    Limitations  DL/I DOS/VS Version 1 Release 9 contains some utility functions which use Interactive System Productivity Facility (ISPF) Version 1 Release 1 (5668-960). DL/I DOS/VS Version 1 Release 9 has alternate batch interfaces which offer equivalent capabilities. Because ISPF is not supported on VSE/ESA, customers should be aware that they may need to use batch interfaces.

    Compatibility  Customer's application programs running under DL/I DOS/VS Version 1 Release 8 will also run under DL/I DOS/VS Version 1 Release 9.


    Planning Information

    Customer Responsibilities  The customer is responsible for the evaluation of the adequacy of the offering to address individual customer requirements. The manuals 'DL/I General Information' and 'DL/I Release Guide' will serve as an aid for this task.


    Security, Auditability, and Control

    This program uses the same security and auditability features as previous DL/I DOS/VS Version 1 Release 7 and DL/I DOS/VS Version 1 Release 8.

    User management is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.


    Publications

    For a current list of publications, refer to the appropriate publications option on your respective HONE system, or contact your local IBM representative.


    5746-XX1 - Data Language/I DOS/VS Release 7


    Release 7 Is No Longer Available, for IBM US as of June 28, 1991


    Abstract

    DL/I DOS/VS is a data base management control system developed to help improve the user's ability to implement data base processing applications. It provides data organization methods that are useful in the creation, interrelation and maintenance of large common data bases. DL/I DOS/VS executes as an application program in a virtual storage environment under VSE or SSX/VSE.


    Product Positioning

    DL/I DOS/VS is a general-purpose system application intended for a wide variety of customers.

    The major objectives of DL/I DOS/VS provide a cornerstone for selling customers a structured foundation upon which they can implement data base/data communication application systems. The marketing representative should be cautioned that developing a customer data base and placing it online can be a significant undertaking. Complete understanding of the applications and the programming systems is essential. The key to successful installation of DL/I DOS/VS is the development of a thorough and effective implementation plan by the customer. The normal implementation is a phased approach. The initial phase permits batch processing against the data base. Once data base experience is gained and application needs dictate, the telecommunications phase can be initiated in conjunction with CICS/DOS/VS.

    A simple application should be implemented first, preferably in a test environment. The power of DL/I DOS/VS can be appreciated and effectively employed only as experience is gained in the use of its basic capabilities. Particular emphasis must be placed on system design to allow movement from batch processing to online processing with a minimum of difficulty. In addition, application program design, data base organization and access techniques require thorough analysis. Poor application design can result in excessive use of main storage and degraded performance.

    VM/370 CMS/DOS can be utilized to shorten the DL/I application development cycle by using it for program debugging.


    Highlights

    Application Programming  High-Level Programming Interface (HLPI) provides a high-level source language interface for the programmer using DL/I DOS/VS in a COBOL or PL/I (Optimizing Compiler) application program. This consists of a set of commands which enable the application programmer to access DL/I function. These commands are translated by a translator into call statements. DL/I and CICS/VS HLPI commands may be used in the same application program.

    Boolean Qualifications Statements in Segment Search Arguments (SSAs) or HLPI commands can decrease the application program logic necessary for complex data retrieval by permitting multiple Boolean logic tests within a single DL/I CALL. The qualification statements are logically related by the Boolean AND and OR operators.

    Segment expansion/compression exits are provided for HD-organized data bases, permitting user-written encode/decode routines to improve utilization of direct access storage space or to strengthen security of stored confidential data.

    Generation and support of low-level codes along with continuity check are functions provided in application support programs for the manufacturing industry user. These are techniques that permit the user to specify hierarchical levels within a data structure and to ensure that a structure is not dependent upon itself. Although primarily provided for manufacturing industry applications, they can also be utilized in other environments.

    Application Environments  There are three application environments:

    1. Batch

    2. Multiple partition support

    3. Online

    Batch  Under CMS/DOS, batch DL/I application programs can be coded, compiled and tested to load, retrieve and update data bases.

    Multiple Partition Support  Multiple Partition Support (MPS) can execute in several VSE or SSX/VSE partitions and/or VSE/ICCF pseudo partitions and may access the same data base concurrently with online users. For example, one or more online applications can retrieve information from a data base while a batch program updates that same data base. MPS, following DL/I conventions, uses DL/I resources and the multitasking facilities of DL/I and CICS/VS. (CICS/VS, therefore, is a prerequisite for running MPS.)

    Online  DL/I uses CICS/VS facilities for multitasking and terminal control.

    DL/I DOS/VS users may move to the Information Management System/VS (IMS/VS, 5740-XX1), which accesses the DL/I data bases of IMS/VS.

    Alternate Accessing  Secondary indexing provides an alternate path to the data. It provides indexed access to root or dependent segments within an HD-organized data base. Fields within most segments of a data base may be indexed.

    The ACCESS Macro is designed to help the data base administrator more easily define data base indexes. It is an alternative to the index definition supplied by the LCHILD and XDFLD macros and the /SX and /CK named types of the FIELD statements.

    HD-organized data bases may be defined such that relationships are established between segments of different hierarchical structures stored within the same or different data bases. This support is called 'Logical Relations'.

    Extended Logical Relations for HDAM or HIDAM data bases include the ability to switch directions from an inverted sequence to a normal sequence (up to down).

    Data Security  Data base integrity and security is provided through the concept of sensitivity, a description of a program's intended access to a data base.

    Field Level Sensitivity gives the user the ability to have different views of a physical segment on an application basis. The basic support allows a user to specify those fields from the physical definition to be included in his view of the segment, including the location in the new view. DL/I will map the fields from the physical segment into the user's view.

    The following items are also supported under Field Level Sensitivity:

    • Virtual Fields - The ability to identify a field in the application's view of a segment that doesn't exist in the physical view.

    • Automatic Data Format Conversion - The ability to change the format of the physical data without re-compiling the application programs.

    • User Field Exit Routine - The ability to specify a routine to get control any time a field is retrieved or stored.

    • Dynamic Segment Expansion - The ability to add fields to a segment without reloading the data base or re-compiling the application programs.

    • No Sequence Field Order Restrictions - Sequence fields need no longer be the first fields defined by field statements, allowing the user to define his fields in the order in which they appear in his segment. Scheduling of multiple online application programs for concurrent execution is based on their sensitivity.

    Logging Capabilities  Data base recovery is facilitated through the use of data base activity logging. Disk logging is an option to allow the disk-only user to take advantage of data integrity features of DL/I DOS/VS; these features are primarily BACKOUT, RECOVERY, and CHANGE ACCUMULATION. In an online environment, the Shared Log option eliminates the need for separate tape drives to be assigned to CICS/DOS/VS Journal and DL/I DOS/VS Log by optionally directing all DL/I DOS/VS log information to the CICS/DOS/VS tape journal. Module identifiers and a system log print utility enhance serviceability. For debugging purposes, the Log Print Utility will selectively print log records by:

    DBD name
    CICS task ID
    VSAM relative block number (RBM)

    Support is provided for multiple logs on a single tape, as well as a multiple volume log file. Unload sequence checking is provided.

    Reorganization Utilities  Reload Restart enables the user to restart the reloading of an HD-organized data base that failed before completion. The data base can be reloaded without rerunning the entire job by resubmitting the job with an additional JCL statement identifying the job as a restart of the Reload Utility. The system operator needs only to supply a checkpoint identification number obtained from a console message as a restart point.

    The HD Reorganization utility permits specification of the number of data base records to be unloaded between each DL/I checkpoint.

    • Partial Data Base Reorganization Utility

      The Partial Data Base Reorganization Utility allows the customer to reorganize only that portion of his data which needs it.

    • Separate Index Reorganization

      Separate Index Reorganization permits reorganization of an index without requiring concurrent reorganization of the associated data base.

    • Selective Unload

      The user can reformat a data base through the use of the HD Unload Utility and program (PSB) views of the original data. This allows the Data Base Administrator to, for example, delete or rearrange fields within a segment, and produce a revised physical data base.

    • Rewind Option - Reorganization Utilities

      A Tape Rewind Option is available for HISAM and HD Reorganization Utilities. Several unload data bases may be stacked on a single tape reel when these utilities are used.

    Performance Considerations  Through optional parameters, the tuning facility allows DL/I DOS/VS to be adapted to specific environments and/or application characteristics. The tuning facility provides flexible control mechanisms for buffer and main storage allocation. Two facilities used to capture tuning data are CMF and RUN and Buffer Statistics.

    • CICS/VS Monitoring Facility (CMF) Hooks

      DL/I performance statistics may be optionally gathered in an online (including MFS) environment using CMF for data capture and recording.

    • Run and Buffer Statistics

      This facility captures DL/I system statistics pertaining to the online environment, and writes them to a CICS/VS data set. This data can then be printed by CICS/VS during its shutdown.

    Users may reserve Free Space in the Hierarchical Direct-organized data bases (HDAM and HIDAM) at load or reload time in order to reduce instances of extensive processing during space management search, and also to reduce access time for retrieving related segments.

    A processing option (PROCOPT=0) is also supported on the PCB statement that provides a performance improvement by inhibiting any locking (enqueuing) by the program isolation function during retrievals of the same segments type in a data base.

    Debugging Aids  VSE IDUMP Support provides a mechanism for obtaining standardized IDUMP-format dumps instead of DL/I dumps on a DL/I-initiated abnormal termination of an application program. These dumps can be used to assist the system user with problem determination. These dumps are captured on disk storage devices using a logical unit called SYSDMP.

    DL/I provides a trace facility for both batch and online environments.

    A PL/I user may use the PL/I diagnostic information to 'debug' an error condition, before the error is returned to DL/I DOS/VS.

    A sample problem utilizing more advanced function to demonstrate the capability of DL/I DOS/VS for broader application usage is included. The examples are discussed in the "Guide for New Users" (SH24-5001). The sample problem shows examples of variable-length segments.

    The HLPI user can use CICS Execution Diagnostic Facility in online DL/I applications to trap and study DL/I and CICS HLPI commands during execution.


    Description

    DL/I DOS/VS has been designed to permit the concurrent scheduling of multiple programs requesting DL/I DOS/VS services, thereby allowing access by more than one user to the same or different data bases at the same time. Application programs may utilize this design concept in conjunction with the Customer Information Control System/DOS/VS (CICS/DOS/VS), program product 5746-XX3, to access DL/I DOS/VS data bases in either an online environment or batch environment.

    Application programs call upon the data base management services through DL/I DOS/VS. DL/I DOS/VS provides the application program with access to the data base management services which is independent of storage media programming considerations. Through installation management tools provided by DL/I DOS/VS, storage media programming considerations may be manipulated independent of application programs. Existing DL/I DOS/VS application programs can be insensitive to the reorganization of stored data, the addition of new applications or data, changes in access methods, organization or access strategy, and the introduction of new storage devices.

    The data base management services of DL/I DOS/VS help the user:

    Describe data base structures
    Create data bases
    Reorganize data bases
    Recover and reconstruct data

    Using DL/I DOS/VS utilities supplied with the system, the user describes the structure of the data base from two viewpoints: The stored data structure as seen by the system and the logical data structure as seen by the application. Only one description of the stored data exists. However, multiple logical descriptions may exist. These data base descriptions are external to application programs. They exist as physical data themselves and are referenced by the system when it is processing access requests for application programs.

    Data base descriptions define symbolic names for data items (fields), segments and data bases. Within a single data base, the system description defines a hierarchic relationship among segments of the stored data structure. It also contains information about organization, access strategy, the physical attributes of the data (length, format, etc.), the physical structure of the stored data segments and storage device characteristics.

    To access or maintain stored data, the application program issues a CALL or an EXEC command for data base management services. As part of the functional request, the application program supplies symbolic names which identify the data (segment type) to be processed. Through data base descriptions, the system relates the application-supplied logical data names to corresponding stored data names, and performs the requested function against the stored data.

    A data base may be stored in two general organizations: Hierarchical Sequential (HS) or Hierarchical Direct (HD). For HS-organized data, the access method and basic processing strategy may be sequential or indexed sequential. For HD-organized data, it may be direct or indexed direct.

    Application programs may process data bases independent of physical organization or storage device used. Data management services are provided by the DOS/VS Virtual Storage Access Method (VSAM) or VSE Virtual Storage Access Method (VSE/VSAM) for data bases of the Hierarchical Direct (HD) organization and indexed sequential data bases of the Hierarchical Sequential (HS) organization. Sequential Access Method (SAM) provides data management services for SHSAM and HSAM data bases.

    Data bases may be shared between DL/I subsystems in one host or across hosts; one system having update capability concurrent with multiple read- only subsystems. DL/I's use of the CICS/DOS/VS Intercommunication Facility, or equivalent, permits access to both local and remote DL/I data bases within the same CICS/VS logical unit of work.

    Interactive Macro Facility (IMF) is a tool that helps reduce the complex task of defining and generating DL/I Data Base Definition (DBD), Program Specification Block (PSB) and online program, its view and authorization. It provides formatted displays on a 3270-type terminal and prompts the user, who can then choose either the appropriate activity and enter the required information in interactive mode, or accept defaults.

    Reorganization and recovery of stored data bases are supported by a set of DL/I DOS/VS utilities supplied with the system.


    Highlights

    Interactive Generation of Utility Job Streams  Interactive dialogs have been added to support all DL/I utilities. These dialogs are designed to make it easier to generate DL/I utility job streams. Utilities will be automatically generated in their correct execution order with all required parameters.

    Easy-to-use menus will assist users in generating utility jobs. Information such as data base names will be saved when entered for an early step in the generating process, and automatically used in later steps. Future job stream generations will also use this saved information, eliminating the need for the user to re-enter data. Data base information can also be entered by choosing the menu option for this function. This makes it unnecessary to enter detailed data base information when generating a utility job stream.

    Defaults are used extensively for many specifications such as size, number of records and utility parameters. What was entered previously will be the default value the next time a similar job stream is created. This will reduce the amount of data the user must actually enter.

    VSE job control statements will be generated, including JOB, EXEC, ASSGN, DLBL, EXTENT and TLBL. The VSE/VSAM 'Space Management for SAM Feature' will be used whenever possible for SAM disk files. This reduces the amount of data required because specific track locations need not be specified. Also, because VSAM supports secondary allocation, jobs are less likely to abnormally end from lack of sufficient space.

    HLPI Support for Boolean Operators  The DL/I High-Level Programming Interface (HLPI) is an easy-to-use method for processing DL/I data bases. It provides commands similar in syntax to those in CICS/VS command language.

    Boolean operators 'AND' and 'OR' provide HLPI users with logic capability in segment selection through the WHERE clause. Application program logic necessary for complex data retrieval is easier with this added function.

    HLPI Key Feedback  Segment keys and key length may optionally be made available in an area provided by the application program using HLPI to retrieve data.

    Variable-Length Index Source Segments  Dynamic segment expansion provides the ability to add fields to a segment in the application program's view without recompiling other programs that access the segment. This feature requires variable-length segments.

    Index source segments were previously restricted to fixed-length. Index source segments may now be defined in the DBD as variable-length. This provides customers with more flexibility in data base design, especially those who use dynamic segment expansion.

    Recovery/Restart Guide  This new document consolidates the information necessary to plan for and conduct data base recovery in a data systems environment.

    The Recovery/Restart information is presented for the batch, MPS batch, and the online environments. Also included, therefore, is information about CICS/VS as it applies to the user's DL/I DOS/VS recovery/restart procedures.

    Utilities Operational Improvements  Control statements are added to several utilities to eliminate, in many cases, manual intervention. For example, multi-file tape capability is added to the Change Accumulation, Forward Recovery, Log Print, Backout, and Image Copy utilities.

    DL/I Documentation Aid  The DL/I Documentation Aid is intended to provide an ease-of-use facility in documenting DL/I definitions that can be accessed by ISQL, the interactive facility of SQL/Data Systems (5748-XXJ).

    The DL/I Application Control Blocks Creation and Maintenance utility (ACBGEN) is intended to create and store, at the user's request, the DBD and PSB definitions into predefined SQL/DS tables. These tables can then be accessed and displayed in various views using ISQL. Sample ISQL query routines will be provided with this function.

    This function furthers the complementary relationship between DL/I and SQL/DS.

    Automatic Extract Definitions  This is a utility that provides an automatic creation of an ISQL routine of EXTRACT DEFINE commands that identifies a DL/I data base to the ISQL EXTRACT facility.

    It uses the SQL/DS tables created by the DL/I Documentation Aid.

    Low-Level Code/Continuity Checking Improvement  Low-level code/continuity checking is used extensively in a manufacturing product structure.

    The algorithm to generate the low-level codes and do the continuity checking is changed to increase efficiency.

    MPS Restart  DL/I is extended so that its checkpoint capability can be used in conjunction with the VSE checkpoint/restart facility in a Multiple Partition Support (MPS) batch environment. Through this extension, the application programmer will be able to checkpoint an MPS batch job and subsequently restart it if it fails.

    IMF Adaptation to ISPF  The Interactive Macro Facility (IMF) has been changed to run with Interactive System Productivity Facility (ISPF).

    An option to convert existing IMF tables from Interactive Productivity Facility to ISPF is provided.


    Use

    The DL/I DOS/VS program is distributed in a RESTORE format and must be restored to a scratch pack using the VSE or SSX/VSE library restore program. The restored DL/I DOS/VS libraries may then optionally be merged with user libraries.


    Customer Responsibilities

    A customer installing DL/I DOS/VS must:

    • Meet the minimum configuration (see "Operating Environment").

    • See to it that appropriate hardware training (especially direct access storage device education be given to system analysts, system programmers and system operators.

    • Have VSE or SSX/VSE successfully installed (no customer should attempt to implement DL/I DOS/VS until the installation has achieved proficiency in the use of VSE or SSX/VSE).

    • Have personnel schooled in DL/I DOS/VS (a thorough knowledge and understanding of data base concepts and DL/I DOS/VS before installation is essential).

    • Provide adequate protection against the accidental loss or misuse of his data (functions exist within DL/I DOS/VS to assist him in providing data security.).

    • Have VSE or SSX/VSE personnel trained in COBOL, PL/I, RPG II, or Assembler language.

    • Design the structure of each data base and its program views.

    • Specify and implement application programs.

    In addition to the above, additional time considerations should be given if the user wishes to process in an online environment in conjunction with CICS/DOS/VS.

    If DL/I DOS/VS is to be used under CMS/DOS, refer to pages on VM/370 and VM/BSE or VM/SP as appropriate for additional considerations.


    Operating Environment

    Hardware Requirements

    The minimum machine requirements for DL/I DOS/VS are the same as those needed for conventional operation of VSE or SSX/VSE. Because of virtual storage support, the minimum machine configuration is dependent on application characteristics and performance requirements. Central processing unit performance may be traded off against main storage size. DL/I DOS/VS will operate on any IBM machine currently supported by VSE or SSX/VSE that has sufficient real storage to meet the combined requirements of DL/I DOS/VS, VSE or SSX/VSE, and other customer-required applications. Batch DL/I DOS/VS has a recommended real storage requirement of 256KB (including VSE/VSAM). Online DL/I DOS/VS, using CICS/DOS/VS, for example, has a recommended minimum real storage requirement of 512KB (including VSE/VSAM and CICS/DOS/VS). See the manuals, "General Information for DL/I DOS/VS" (GH20-1246) and "CICS/VS" (GC33-0066) when configuring these systems. VM /370 storage requirements must be considered if CMS/DOS is to be used.

    When using DL/I DOS/VS in conjunction with CICS/DOS/VS in a VM/370 virtual machine, (under control of VSE or SSX/VSE), the following considerations apply:

    1. CICS/VS operating in a virtual machine has the same requirements as CICS/VS operating in a real machine. Other software components (e.g., access methods, compilers and the release of VSE or SSX/VSE under which CICS/VS runs) must be valid for that release of CICS/VS).

    2. The minimum hardware requirements of CICS operating in a VM/370 virtual machine are the same as those for CICS/VS running in a real machine, and should be considered as additional to the minimum requirements for VM/370 itself, and any other virtual machines within the VM/370 environment.

    3. Processor utilization and possibly terminal response times will be greater when CICS/VS is running under VM/370 than when it is running in a real machine. The effect on performance will be most noticeable when VM/370 is introduced into an installation where processor and main storage resources are already substantially committed to existing CICS/VS and other work. General guidance on the performance considerations associated with the running of CICS/VS under VM/370 is contained in the "CICS/VS System Programmer's Reference."

    Data base storage files may be on any of the following:

    2314 Direct Access Storage Facilities
    2319 Disk Storage
    3330-1/3330-11 Disk Storage
    3340/3344 Direct Access Storage Facilities
    3310 Direct Access Storage
    3350 Direct Access Storage
    3370 Direct Access Storage
    3375 Direct Access Storage
    3380 Direct Access Storage

    If DL/1 is used in conjunction with SSX/VSE, the data base storage files must be either on 3310 Direct Access Storage or on 3370 Direct Access Storage.

    In addition, at least two 9-track 2400, 3400 or 8809 series tape units and control are required, if tape logging is to be utilized or HSAM or SHSAM files are on tape.

    Any terminal device supported by CICS/DOS/VS, or equivalent product, may be used for online DL/I DOS/VS. IMF requires an IBM 3270-type terminal.

    Software Requirements

    DL/I DOS/VS will operate on DOS/VSE (Release 34) or VSE with Advanced Functions (VSE/AF) program product. The following chart cross-references DL/I releases to various operating system releases and CICS/VS:

     
    +--------------------------------------+
    |     |   VSE/AF    |  VSE/SP    | SSX/|
    |DL/I |-------------|------------|VSE  |
    |Rel. | 1.3.5| 2.1  | 1.1  | 2.1 | 1.4 |
    |-----|------|------|------|-----|-----|
    | 1.6 |CICS/ |  No  |CICS/ | No  | No  |
    |     |VS 1.6|      |VS 1.6|     |     |
    |-----|--------------------------------|
    | 1.7 |        CICS/VS 1.6             |
    +--------------------------------------+
     
    

    DL/I 1.7 works with the following Licensed Programs (or their equivalents):

    • VSE/Advanced Functions, 5746-XE8, Release 3.5 or VSE/Advanced Functions, 5666-301, Version 2 Release 1, or

      VSE/System Package, 5666-316, Version 2 Release 1, or

      SSX/VSE, 5666-265, Release 4

    • CICS/DOS/VS, 5746-XX3, Version 1 Release 6

    • VSE/VSAM with Storage Management for SAM Feature, 5746-AM2, Release 2 or later

    • Structured Query Language/Data System (SQL/DS), 5748-XXJ, Release 1 or later

    • DOS/VS Sort/Merge, 5746-SM2, Version 2 Release 3 or later

    • VSE/Power, 5746-XE3, Version 2 Release 1 or later

    • Interactive System Productivity Facility (ISPF), 5668-009, Release 1

    • VSE/Interactive Computing and Control Facility (VSE/ICCF), 5746-TS1, Release 3.5, or

      VSE/Interactive Computing and Control Facility, 5666-302, Version 2 Release 1.0

    VM/370 SCP, 5749-010, supports IMF and IUG through CMS and the following Licensed Programs (or their equivalents):

    • Interactive System Productivity Facility, 5668-009

    • VM/Basic Systems Extensions, 5748-XX8

    • VM/Systems Extensions, 5748-XE1

    • VM/Systems Product, 5664-167

    DL/I 1.7 is supported for use with:

    • DOS/VS COBOL Compiler and Library, 5746-CB1, or DOS/VS Library, 5736-LM4

    • PL/I Optimizing Compiler and Libraries, 5736-PL3

    • PL/I Optimizing Compiler, 5736-PL1

    • PL/I Resident Library, 5736-LM4

    • PL/I Transient Library, 5736-LM5

    • RPG II - DOS/VS 5746-RG1

    • VM/Basic Systems Extensions, 5748-XX8

    • VM/Systems Extensions, 5748-XE1

    • VM/Systems Product, 5664-167

    The following programs or equivalent products are prerequisites for the installation of DL/I 1.7:

    • VSE/Advanced Functions (5746-XE8) Release 3.5, or

      VSE/Advanced Functions (5666-301) Version 2 Release 1, or

      SSX/VSE (5666-265) Release 4, or

      VSE/SP (5666-316) Version 2 Release 1

    • VSE/VSAM (5746-AM2) Release 2 or later

    • DOS/VS Sort/Merge (5746-SM2), Version 2 Release 3 or later

    DL/I DOS/VS is designed to run in batch or Multiple Partition Support (MPS) mode in VSE/Interactive Computing and Control Facility (VSE/ICCF), 5746-TS1, pseudo partitions. VSE/ICCF can also be the host environment for the Interactive Productivity Facility (IFP), 5748-MS1, under which the DL/I DOS/VS Interactive Macro Facility runs.

    DL/I DOS/VS uses the Virtual Storage Access Method (VSAM), Sequential Disk IOCS, and Magnetic Tape IOCS data management facilities.

    DB/DC Data Dictionary DOS/VS (5746-XXC) enhances DL/I DOS/VS by helping to simplify and manage the creation, maintenance and reporting definitions of the data in the system and its use by the application programs.

    Development Management System/CICS/VS (5746-XC4) provides DL/I DOS/VS support for inquiry, insertion, update and deletion of data base records. Access into the data base may be via primary or secondary indexes.

    DL/I DOS/VS Space Management Utilities IUP (5746-PKF) is designed to help improve system performance and programmer productivity. They are designed to detect and report DL/I hierarchical direct (HD) pointer discrepancies, to provide statistics and information for HD tuning, and to assist with segment restructuring and reloading during data base reorganization.

    If the customer wants to use the functions of DL/I DOS/VS 1.7 IMF or IUG, the Program Product ISPF (5666-960) is required.


    Compatibility

    • The following facilities in DL/I DOS/VS are not supported by IMS/VS:

      • Interactive Generation of Utility Job Streams.

      • MPS Restart.

      • Variable-Length Index Source Statements.

      • DL/I Documentation Aid.

      • Automatic Extract Definitions.

      • Field Level Sensitivity Extensions.

      • Fixed Block Architecture (FBA) DASD Devices.

      • Interactive Macro Facility.

      • High Level Programming Interface (HLPI).

      • Application programs written in RPG.

      • The concept and implementation of Extended Remote PSB.

      • ACCESS Macro.

    • The following facilities in DL/I DOS/VS are supported in IMS/VS in a different manner:

      • Checkpoint.

      • Operational aspects of certain DL/I DOS/VS utilities.

    • Certain utility-generated files may only be processed by the system under which they were created.

    Data set portability and alternate access between DL/I DOS/VS and IMS/VS are provided by the IMS Compatibility Support facility in DL/I.

    DL/I DOS/VS Version 1 Release 7 is upward compatible from DL/I DOS/VS Version 1 Release 6, and from DL/I SSX/VSE Version 1 Release 2.

    No application programming changes are required.


    Publications

    GH24-5025 Licensed Program Specifications

    DL/I is shipped in four versions, dependent on the installed operating environment:

    1. VSE/AF 1.3.5 (5748-XE8)

    2. VSE/AF 2.1.0 (5666-301)

    3. VSE/SP 2.1.0 (5666-301)

    4. SSX/VSE 1.4.0 (5666-265)

    Make sure that the right DL/I 1.7 distribution tape format is ordered, because the tapes are not interchangeable. For VSE/SP Version 2 it should be ordered as a feature of VSE/SP Version 2.


    5746-XX1 - IBM Data Language/I DOS/VS V1 R7 M1


    Abstract

    IBM DL/I DOS/VS 1.7.1 is based on DL/I 1.7.0. It enables the IBM DL/I customer to exploit the Virtual Address Extension offered with Virtual Storage Extended/System Package (VSE/SP) Version 3.1 and Virtual Storage Extended/Advanced Function (VSE/AF) Version 2.1. Existing DL/I 1.7.0 users may receive the new function via PTF.


    Product Positioning

    DL/I DOS/VS 1.7.1 is IBM's hierarchical data base management system for the small and intermediate System/370 environment. Performance-, capacity-, and structural-characteristics support high-volume operational databases. SQL/DS is IBM's relational data base for the small and intermediate System/370 environment. It supports end user queries, quick application prototyping, and application development. Recent enhancements have made SQL/DS also viable as a production data base system.

    DL/I DOS/VS 1.7.1 should be marketed to existing users of DL/I 1.7.0 and to installed or potential users of the VSE operating system who have a need for an operational, hierarchical data base management system to support existing or new applications.


    Highlights

    • Exploitation of VSE/AF V2 Virtual Address Extension function for Multi Partition Support (MPS) jobs.

    • New GSTA Call Function

    • Updated Documentation

    Description

    Exploitation of VSE/AF V2 Virtual Address Extension (VAE) function for MPS jobs:

    DL/I DOS/VS 1.7.1 is enhanced to allow an online batch job to run in an address space other than the one in which CICS/DOS/VS and DL/I DOS/VS 1.7.1 reside. In conjunction with Virtual Storage Extend/Advanced Functions (VSE/AF) V2.1, a component program of Virtual Storage Extended/System Package (VSE/SP) V2.1 and VSE/SP V3.1, DL/I DOS/VS 1.7.1 can now exploit multiple address spaces supported by VSE Virtual Address Extension with Multiple Partition Support.

    New GSTA Call function  A new call function, Get STAtistics (GSTA) is added to retrieve run- and buffer-statistics. GSTA returns a fixed block to the application containing statistics related to both, the system operations and the job from which the call was issued. This function is not supported for the HLPI interface, for RPG II, and remote PSB processing.

    Updated Documentation  Updated documentation, describing the new functions added with DL/I DOS/VS 1.7.1 will be available with the DL/I DOS/VS Program Installation Directory (SC33-6211) and DL/I DOS/VS Messages and Codes (SH12-5414).


    Customer Responsibilities

    The customer must provide at least the minimum hardware and software environments on which DL/I DOS/VS 1.7.1 will operate and assign a systems administrator who has responsibility for planning, installing, maintaining and administering of DL/I DOS/VS 1.7.1.


    Operating Environment

    Hardware Requirements

    The minimum machine requirements for DL/I DOS/VS 1.7.1 are the same as those for VSE/SP Version 3 Release 1, or VSE/AF Version 2 Release 1, VSE/VSAM Release 3, and CICS/DOS/VS 1.7.0 (for online operations). The machine requirements for DL/I DOS/VS 1.7.0 will not change if the new function is installed via PTF. Because of virtual storage support, the minimum machine configuration is dependent on application characteristics and performance requirements. Central processing unit performance may be traded off against main storage size. DL/I DOS/VS 1.7.1 will operate on any IBM machine currently supported by VSE/SP Version 3 Release 1, or VSE/AF Version 2 Release 1 that has sufficient main storage to meet the combined requirements of DL/I DOS/VS, VSE, and other customer required applications. Batch DL/I DOS/VS has a recommended real storage requirement of 256KB (including VSE/VSAM). Online DL/I DOS/VS, using CICS/DOS/VS for example, has a recommended minimum real storage requirement of 512KB (including VSE/VSAM and CICS/DOS/VS). Users should refer to the Program Installation Directory for DL/I DOS/VS (SC33-6211) when configurating the system.

    When using DL/I DOS/VS in conjunction with CICS/DOS/VS in a VM/SP virtual machine (under control of VSE), the following considerations apply:

    • CICS/DOS/VS operating in a virtual machine has the same requirements as CICS/DOS/VS operating in a real machine, provided that the functions it requires are supported by VM. Other software components (such as access methods, compilers) must be valid for that release of CICS/DOS/VS.

    • The minimum hardware requirements of CICS/DOS/VS operating in a VM/SP virtual machine, are the same as those for CICS/DOS/VS running in a real machine, and should be considered in addition to the minimum requirements for VM/SP itself and any other virtual machines within the VM/SP environment.

    • CPU utilization and, possibly, terminal response time will be greater when CICS/DOS/VS is running under VM/SP than when it is running in a real machine.

    Data base storage files may be on any of the following DASD. Fixed Block Architecture Devices:

    • IBM 3310 Direct Access Storage

    • IBM 3370 Direct Access Storage
    Count Key Data Devices:

    • IBM 3330 Direct Access Storage

    • IBM 3340 Direct Access Storage

    • IBM 3350 Direct Access Storage

    • IBM 3375 Direct Access Storage

    • IBM 3380 Direct Access Storage

    In addition, at least two 9-track 2400, 3400, 8809 series tape units , or 3480 cartridge drives are required if tape logging is to be utilized or if hierarchic sequential access method (HSAM) or SHSAM files are on tape.

    Any terminal device supported by CICS/DOS/VS, or an equivalent product, may be used for online DL/I DOS/VS. Interactive Macro Facility and interactive generation of utility job streams require a 3270-type terminal.

    Software Requirements

    DL/I DOS/VS 1.7.0 has been designed to operate on VSE/AF 1.3.5 (5746-XE8) or VSE/AF Version 2 Release 1 (5666-301) with CICS/DOS/VS 1.6.0 (5746-XX3), or VSE/SP 1.1 (5666-297, 5666-296), or VSE/SP V2.1 (5666-316). DL/I DOS/VS 1.7.1 has been designed to operate on VSE/SP Version 3 Release 1 (5666-345) or VSE/AF Version 2 Release 1 (5666-301) with CICS/DOS/VS (5746-XX3) 1.7.0.

    In addition VSE/VSAM Release 3 (5746-AM2) (a component program of VSE/SP), and DOS/VS Sort/Merge Version 2 Release 5 (5746-SM2) or later, or equivalent are required to perform DL/I functions.

    Interactive System Productivity Facility (ISPF) Version 1 Release 1 (5668-960) is required for the DL/I DOS/VS Interactive Macro Facility and interactive generation of utility job streams.

    The following chart provides a cross-reference for DL/I DOS/VS with CICS/DOS/VS and the various operating system environments.

     
               |   VSE/AF    |   VSE/AF    |
               |   1.3.5  *  |   V2.1      |
    -----------|-------------|-------------|
    DL/I DOS/VS| CICS/DOS/VS | CICS/DOS/VS |
    1.7.0      | 1.6.0       | 1.6.0       |
               | (part of    | (part of    |
               | VSE/SP 1.1) | VSE/SP V2.1)|
               |             |             |
    DL/I DOS/VS|             | CICS/DOS/VS |
     1.7.1     |             | 1.7.0       |
               |             |  (part of   |
               |             | VSE/SP V3.1)|
     
    

    Note: * Only GSTA function is available for VSE/AF 1.3.5.

    The new DL/I DOS/VS 1.7.1 will be delivered with a new product tape.

    Existing DL/I DOS/VS 1.7.0 users may receive the new functions by installing a PTF. The reference APAR number is PL01931.

    To install the new functions, the following prerequisite VSE/AF PTFs must be on the system, depending on the VSE System Package level:

    • VSE/SP 1.1 Production (5666-296) requires PTF UD36970

    • VSE/SP 1.1 Generation (5666-297) requires PTF UD36914

    • VSE/SP V2.1 requires PTF UD36952.

    • VSE/SP V3.1 no PTFs required.

    Non-VSE System Package users require the following prerequisite PTFs depending on the VSE/AF level:

    • VSE/AF 1.3.5 requires PTF UD36914

    • VSE/AF V2.1 requires PTF UD36951

    In addition to the above, DL/I DOS/VS 1.7.1 is designed to work with the following licensed programs:

    • VSE/VSAM Space Management for SAM feature (5746-AM2), which is a component program of VSE/SP.

    • Structured Query Language/Data System (SQL/DS) Release 3 or later (5746-XXJ), (DOS/VSE only)

    • VSE/ICCF (VSE/Interactive Computing and Control Facility) Version 2 Release 1 (5666-302), which is a component program of VSE/SP.

    DL/I DOS/VS is supported for use with:

    • DOS/VS COBOL Compiler (5746-CB1) or Library Only (5746-LM4).

    • PL/I Optimizing Compiler and Libraries (5736-PL3).

    • PL/I Optimizing Compiler (5736-PL1)

    • PL/I Resident Library (5736-LM4)

    • PL/I Transient Library (5736-LM5)

    • RPG II - DOS/VS (5746-RG1)

    DL/I DOS/VS is designed to run in batch or multiple partition support batch mode in a VSE batch partition or in VSE/Interactive Computing and Control Facility pseudo partitions.

    IBM's primary fourth generation language application generator, Cross System Product/Application Development (CSP/AD) Version 3 (5668-813) and Cross System Product/Application Execution (CSP/AE) Version 3 (5668-814), supports DL/I DOS/VS. With CSP/AD and CSP/AE, application programs can be defined, tested, generated and executed. CSP/AD and CSP/AE simplify and manage data definition or description creation, maintenance, and use by application programs.

    File definitions in the form of COBOL data structures and DL/I Program Specification Block (PSB) and Data Base Description (DBD) definitions may be imported to relieve the customer from data redefinition and to permit a wide variety of source definitions to be used by CSP/AD.

    Query DL/I (5785-EDA) is a Program Offering which provides query facilities for the operational databases. With its easy-to-use menus, it offers functions to get up-to-the-minute information.

    DL/I DOS/VS Space Management Utilities Program Offering (5796-PFK) is designed to help improve system performance and programmer productivity. These utilities detect and report DL/I hierarchical direct (HD) pointer discrepancies, provide statistics and information for HD tuning, and assist with segment restructuring and reloading during data base reorganization.


    Compatibility

    DL/I DOS/VS 1.7.1 is compatible with previous releases (1.6.0 and 1.7.0). IMS - DL/I data base compatibility is not affected.

    The following facilities in DL/I DOS/VS are not supported by IMS/VS (5740-XX2):

    • Interactive generation of utility job streams (IUG)

    • MPS restart

    • Variable-length index source segments

    • DL/I documentation aid

    • Automatic extract definitions

    • Fixed Block Architecture (FBA) DASD

    • Interactive Macro Facility

    • Application programs written in RPG

    • The concept and implementation of extended remote program specification blocks.

    • ACCESS macro

    • GSTA call

    The following facilities in DL/I DOS/VS are supported in IMS/VS in a different manner:

    • Field-level sensitivity extensions

    • Checkpoint call

    • Operational aspects of certain DL/I DOS/VS utilities

    In addition, certain utility-generated files may only be processed by the system under which they were created.

    For more details on the above compatibility items please refer to the DL/I DOS/VS 1.7.1 Program Installation Directory (SC33-6211).

    Data set portability and alternate access between DL/I DOS/VS and IMS/VS are provided by the IMS compatibility support facility in DL/I.


    Conversion

    The ISAM to DL/I Bridge Program Offering (5798-CYT) is an execution- time interface between DL/I and ISAM application program. Data in a DL/I data base may be accessed by DL/I or ISAM programs. No modification to source programs, recompilation, or re-link editing will be required. Application programs will run under the bridge program and all languages that support ISAM or DL/I are supported.

    The CICS/DOS/VS ISAM to DL/I Bridge Program Offering (5798-DBH) is an execution-time interface between CICS-ISAM application programs and a DL/I database. It is a migration aid designed for DOS/VSE, and OS/VS users that gives ISAM-based applications access to DL/I data bases without the need for modifying existing ISAM programs. This Program Offering is the DOS/VS/VSE or OS/VS online (CICS) version for the above program offering. (5798-CYT)


    Migration

    Migration from DL/I DOS/VS 1.7.0 to DL/I DOS/VS 1.7.1

    There are no changes required to DL/I user application programs, except for the following cases:

    All online users must re-assemble the online nucleus with the DL/I DLZACT macro.

    DL/I DOS/VS call function GSCD is supported only for applications operating in the same non-shared address space as DL/I DOS/VS. Applications operating in address spaces different from the one in which DL/I is operating, must be converted to use the new GSTA call to retrieve buffer statistics.

    ACBGEN must be rerun for any PSBs for which the user wishes to issue GSTA calls.

    'PATH' sensitivity must be specified for all segments for which the user does path inserts from MPS jobs running in separate address spaces. (Currently 'PATH' sensitivity is only required for path retrieves or replaces, but not for path inserts).


    Security, Auditability, and Control

    This program can serve as an aid in reviewing data processed by, or stored in the system for validity and accuracy. DL/I DOS/VS may be of interest to auditors and system designers for its logging capability.

    User management is responsible for evaluation, selection, and implementation of security features, administration procedures, and appropriate controls in application systems and communication facilities.


    Performance Considerations

    General DL/I DOS/VS 1.7.1 performance will not differ noticeably from DL/I DOS/VS 1.7.0. The use of XPCC for Virtual Address Extension Support may impact performance in a multiple address space MPS environment.


    Publications

    One copy of the following publications will be shipped with the basic package.

    Unlicensed Documentation  Additional copies are now available from for a fee

    • GH24-5031 Program Product Specifications
    • SH24-5001 Guide for New Users
    • SH24-5009 Application Programming: HLPI
    • SH24-5011 Data Base Administration
    • SH24-5021 Resource Definition and Utilities
    • SH24-5022 Application Data Base Design
    • SH24-5029 Interactive Resource Definition and Utilities
    • SH12-5411 Application Program: Call and RQDLI Interfaces
    • SH12-5414 Messages and Codes
    • SC33-6211-01 Program Installation Directory

    The following additional documentation is also available for a fee.

    • GH20-1246 General Information
    • GH24-5008 Library Guide and Master Index
    • SH24-5002 Diagnostic Guide
    • SH24-5030 Recovery/Restart Guide
    • SH20-9046 Low-Level Code/Continuity Check in DL/I
    • SX24-5103 Ref. Summary: Call Program Interface
    • SX24-5104 Ref. Summary: System Programming
    • SX24-5120 Ref. Summary: HLPI Interface

    Licensed Documentation 

    • LY12-5016 Logic Volume 1
    • LY24-5215 Logic Volume 2
    • LY33-9123 DL/I DOS/VS 1.7.1 Logic Extension
    • LYC7-0502 DL/I DOS/VS 1.7.1 Microfiche

    Licensed Program Materials Availability

    This licensed program is available with some licensed program materials designated as "Restricted Materials of IBM." The remaining licensed program materials are available and are not designated as "Restricted Materials of IBM."


    5746-XX1 - Data Language/I DOS/VS Release 8


    Abstract

    IBM DL/I DOS/VS Version 1 Release 8 provides enhancements designed to improve usability and to enhance upward compatibility with IMS/VS.


    Product Positioning

    DL/I DOS/VS is IBM's hierarchical data base management system for the small and intermediate System/370 environment. Performance, capacity, and structural-characteristics support high-volume operational databases.

    SQL/DS is IBM's relational database for the small and intermediate System/370 environment. It supports end-user queries, quick application prototyping and application development. Recent enhancements have made SQL/DS also viable as a production data base system.


    Highlights

    • Conditional JCL support
    • New status code for read-only programs
    • Literal string in the HLPI WHERE clause
    • Date and time stamps on reports
    • Partial data base load
    • CI-size support up to 30K
    • Increased block size on tape

    Description

    Conditional JCL Support  The conditional Job Control Language of VSE is supported for utilities and application programs by providing a return code. All DL/I utility programs pass a return code to VSE. Return codes provided by user- written DL/I application programs can also be passed on to VSE. This allows to control the flow of job-streams by using the conditional JCL statements of the VSE/Advanced Functions program.

    New Status Code for Read-only Programs  A new program processing option (PROCOPT) is provided for read-only programs to give the application a chance to react on an invalid pointer situation and to reduce the number of abnormal terminations.

    Literal String in the HLPI WHERE Clause  The High Level Programming Interface (HLPI) is extended to allow a literal string in the WHERE clause for PL/I programs.

    Date and Time Stamps on Reports  Date and time of execution will be printed on all reports and statistics produced by DL/I utility programs.

    Partial Data Base Load  DL/I DOS/VS is enhanced to allow a data base load in several steps using the processing option 'load' (PROCOPT=L/LS). Between any of these load steps read-only access to the data base is possible.

    CI-size Support up to 30K  DL/I DOS/VS is enhanced to support CI-sizes up to a maximum of 30K.

    Increased Block Size on Tape  DL/I DOS/VS allows to use a larger block size on tape (up to a maximum of 32K) for DL/I Backup/Restore processing.

    Updated Documentation  Updated documentation, describing the new functions added with DL/I DOS/VS 1.8.0 will be available with the DL/I DOS/VS Release Guide (SC33-6211), DL/I DOS/VS Resource Definition and Utilities (SH24-5021), DL/I DOS/VS Messages and Codes, (SH12-5414), and DL/I DOS/VS Logic Extensions (LY33-9123).


    Operating Environment

    Hardware Requirements

    The minimum machine requirements for DL/I DOS/VS 1.8.0 are the same as those for VSE/SP Version 4 Release 1, and/or VSE/AF Version 4 Release 1, VSE/VSAM Release 4, and CICS/DOS/VS 1.7.0 (for online operations). DL/I DOS/VS 1.8.0 will operate on any IBM machine currently supported by VSE/SP Version 4 Release 1, or VSE/AF Version 4 Release 1, that has sufficient main storage to meet the combined requirements of DL/I DOS/VS , VSE, and other customer required applications. Batch DL/I DOS/VS has a recommended real storage requirement of 256KB (including VSE/VSAM). Online DL/I DOS/VS, using CICS/DOS/VS for example, has a recommended minimum real storage requirement of 512KB (including VSE/VSAM and CICS/DOS/VS). Users should refer to the Release Guide for DL/I DOS/VS 1.8.0 (SC33-6211) when configurating the system.

    Data base storage files may be on any of the following DASD:

    • Fixed Block Architecture Devices:
      • IBM 3310 Direct Access Storage
      • IBM 3370 Direct Access Storage
      • IBM 9332 Direct Access Storage
      • IBM 9335 Direct Access Storage
    • Count Key Data Devices:
      • IBM 3330 Direct Access Storage
      • IBM 3340 Direct Access Storage
      • IBM 3350 Direct Access Storage
      • IBM 3375 Direct Access Storage
      • IBM 3380 Direct Access Storage

    In addition, at least two 9 track tape units are required if tape logging is to be utilized or if hierarchic sequential access method (HSAM or SHSAM) files are on tape.

    The following tape units are supported:

    • 2400 series tape drive
    • 3400 series tape drive
    • 9347 tape drive
    • 3480 cartridge device

    Any terminal device supported by CICS/DOS/VS, or an equivalent product, may be used for online DL/I DOS/VS . Interactive macro facility and interactive generation of utility job streams require a 3270-type terminal.

    Software Requirements

    DL/I DOS/VS 1.8.0 operates on VSE/SP Version 4 Release 1 (5750-ABF) and/or VSE/AF Version 4 Release 1 (5686-007) with CICS/DOS/VS 1.7 (5746-XX3).

    In addition VSE/VSAM Version 1 Release 4 (5746-AM2) or later (a component program of VSE/SP), and DOS/VS Sort/Merge Version 2 Release 5 (5746-SM2) or later, or equivalent are required to perform DL/I functions.

    DL/I DOS/VS 1.8.0 will also run on VSE/SP 3.1 and VSE/AF 2.1.6 with CICS DOS/VS 1.7 and VSE/VSAM 1.3 and follow-on releases of these products.

    Note: No prerequisite PTFs are required for

    VSE/System Package users of Version 3 or Version 4 and for
    Non VSE/System Package users with VSE/AF 2.1.6 and later.
    Non VSE System Package users with VSE/AF Version 2 Release 1 program levels prior to modification level 6, require PTF UD36951.

    In addition to the above, DL/I DOS/VS 1.8.0 is designed to work with the following licensed programs:

    • VSE/VSAM Space Management for SAM feature (5746-AM2), which is a component program of VSE/SP.
    • Structured Query Language/Data System (SQL/DS) Version 1 Release 3 or later (5746-XXJ), (DOS/VSE only)
    • Interactive System Productivity Facility Release 1 (5668-960)
    • VSE/ICCF (VSE/Interactive Computing and Control Facility) Version 2 Release 1 (5666-302), which is a component program of VSE/SP.

    DL/I DOS/VS is supported for use with:

    • DOS/VS COBOL Compiler (5746-CB1) or Library Only (5746-LM4).
    • PL/I Optimizing Compiler and Libraries (5736-PL3).
    • PL/I Optimizing Compiler (5736-PL1)
    • PL/I Resident Library (5736-LM4)
    • PL/I Transient Library (5736-LM5)
    • RPG II - DOS/VS (5746-RG1)

    DL/I DOS/VS is designed to run in batch or multiple partition support batch mode in a VSE batch partition or in VSE/Interactive Computing and Control Facility pseudo partitions. VSE/ICCF can also be the host environment for the Interactive System Productivity Facility, under which the DL/I DOS/VS Interactive Macro Facility and interactive generation of utility job streams run.

    Cross System Product/Application -Development and -Execution (CSP/AD,AE) support DL/I DOS/VS starting with Version 2. (5668-824, 5668-825). They help to simplify and manage the creation and maintenance of definitions or descriptions of the data in the system and their use by the application programs. Query DL/I (5666-351) is a Program Product which provides query facilities for the operational databases. With its easy to use menus, it offers functions to get up-to-the-minute information.

    DL/I DOS/VS Space Management Utilities Program Offering (5796-PKF) is designed to help improve system performance and programmer productivity. These utilities detect and report DL/I hierarchical direct (HD) pointer discrepancies, provide statistics and information for HD tuning, and assist with segment restructuring and reloading during data base reorganization.


    Compatibility

    DL/I DOS/VS 1.8.0 is upward compatible with previous releases and refreshes (1.6.0 , 1.7.0 , 1.7.1).

    IMS - DL/I data base compatibility is not affected with the exception, that a data base, which is in partial load state, cannot be accessed by IMS/VS.

    The following enhancements of DL/I DOS/VS Version 1 Release 8 remove incompatibilities to IMS/VS and/or reduce the effort necessary for migration to IMS/VS:

    • Conditional JCL support
    • New status code for read-only programs
    • Literal string in the HLPI WHERE clause
    • CI-size support up to 30K

    The following facilities in DL/I DOS/VS are not supported by IMS/VS (5740-XX2):

    • Interactive generation of utility job streams (IUG)
    • MPS restart
    • Variable-length index source segments
    • DL/I documentation aid
    • Automatic extract definitions
    • Fixed Block Architecture (FBA) DASD
    • Interactive Macro Facility
    • Application programs written in RPG
    • The concept and implementation of extended remote program specification blocks.
    • ACCESS macro
    • GSTA call

    The following facilities in DL/I DOS/VS are supported in IMS/VS in a different manner:

    • Field-level sensitivity extensions
    • Checkpoint call
    • Operational aspects of certain DL/I DOS/VS utilities
    • Partial data base load

    In addition, certain utility-generated files may only be processed by the system under which they were created.

    For more details on the above compatibility items, please refer to the DL/I DOS/VS 1.8.0 Release Guide (SC33-6211).

    Data set portability and alternate access between DL/I DOS/VS and IMS/VS are provided by the IMS compatibility support facility in DL/I.

    Currently running programs will continue to run as documented in the individual software compatibility sections for the licensed program announcement letters. There are no known changes to existing externals of these products.

    DL/I DOS/VS 1.8.0 is a licensed program, intended to use the existing externals of the licensed programs it is supporting. Functional capability and usability improvements, which do not affect attachment externals have been made. Information relating to these improvements for both new and enhanced products will be published no later than General Availability.


    Migration

    Following effort is required for migration to DL/I DOS/VS Version 1 Release 8:

    • Re-assemble and re-link of the DL/I nucleus if online processing is performed

    • Programs containing DLZTRACE macro calls with OUTPUT=SYSLST must be re-assembled and re-linked.

    • User programs which reference the partition specification table (PST ) must be re-assembled and re-linked.

    • If the SQL Extract/Defines part of the DL/I DOS/VS 1.8.0 is used and running an SQL/DS version prior to SDL/DS 2.2 following programs must be re-preprocessed, re-assembled and re-linked:
      • DLZEXDF
      • DLZDLBP
      • DLZDLBD

    Sample job-streams for this processing are provided in the DL/I DOS/VS 1.8.0 Release Guide.


    Security, Auditability, and Control

    This program can serve as an aid in reviewing data processed by, or stored in the system for validity and accuracy. DL/I DOS/VS may be of interest to auditors and system designers for its logging capability.

    User management is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.


    Performance Considerations

    General DL/I DOS/VS 1.8.0 performance will not differ considerably from DL/I DOS/VS 1.7.1. Performance improvements may be achieved through the increased CI-size and for DL/I Backup/Restore processing through the increased block size on tape.


    Publications

    Unlicensed Documentation  A memo, program directory, and one copy of the following publications are supplied automatically with the basic machine-readable material:

    • SC33-6211 DL/I DOS/VS Release Guide
    • SH12-5414 DL/I DOS/VS Messages and Codes
    • SH24-5021 DL/I DOS/VS Resource Definition and Utilities
    • GH24-5031 Licensed Program Specifications
    • SH24-5001 Guide for New Users
    • SH24-5009 Application Programming: HLPI
    • SH24-5011 Data Base Administration
    • SH24-5022 Application and Data Base Design
    • SH24-5029 Interactive Resource Definition and Utilities
    • SH12-5411 Application Program: Call+RQDLI Interfaces
    • GH24-5008 Library Guide and Master Index
    • SH24-5002 Diagnostic Guide
    • SH24-5030 Recovery/Restart Guide
    • SH20-9046 Low Level Code/Continuity Check in DL/I

    Additional copies of unlicensed publications will be available for a fee. These copies may be ordered from your IBM marketing representative through the system library subscription service (SLSS) or by direct order.

    The following, additional documentation will also be available from IBM. To order, contact your IBM marketing representative.

    • GH20-1246 General Information
    • SX24-5103 Ref. Summary: CALL Programming Interf.
    • SX24-5104 Ref. Summary: System Programming
    • SX24-5120 Ref. Summary: HLPI Interface

    All of the above publications may be ordered by using one bill of forms number, XBOF-XXXX.

    Licensed Documentation  The following licensed material and microfiche will be available from IBM after general availability. To order, contact your IBM marketing representative.

    The first copy is available at no charge to licensees of basic material by specifying the 7XXX feature number. Use the 8XXX feature number to order additional copies for a fee.

    • LY12-5016 Logic Vol. 1 Single Copy Feature #7340, Additional Copies Feature #8016
    • LY24-5215 Logic Vol. 2 Single Copy Feature #7340, Additional Copies Feature #8075
    • LY33-9123 DL/I DOS/VS Logic Extension Single Copy Feature #7440, Additional Copies Feature #8544
    • LYC7-0503 DL/I DOS/VS Microfiche Single Copy Feature #7550, Additional Copies Feature #8093

    Subsequent updates (technical newsletters or revisions between releases) to the publications shipped with the product will be distributed to the user of record for as long as a license for this software remains in effect. A separate publication order or subscription is not needed.

    Trademarks  (R), (TM), * Trademark or registered trademark of International Business Machines Corporation.

    ** Company, product, or service name may be a trademark or service mark of others.

    Share this page

    Digg Linked In

    Contact IBM

    Feedback