CUSTOMER INFORMATION CONTROL SYSTEM/ CONVERSATIONAL MONITOR SYSTEM
(CICS/CMS) RELEASE 1 ANNOUNCED AND PLANNED TO BE AVAILABLE JUNE 1986

Contents


Announcement Letter Number 285-385 dated October 15, 1985
US - Last Revised on October 15, 1985



Brief Description of Announcement, Charges, and Availability

     CICS/CMS Release 1 is a new IBM licensed program that provides
the ability to edit interactively, translate, compile or assemble,
and initially test CICS command-level COBOL, PL/I, and Assembler
application programs in a Virtual Machine/CMS system.  CICS/CMS is a
single-user system that operates in the CMS environments of an IBM
host running Virtual Machine/System Product (VM/SP) with or without
the High Performance Option (VM/SP HPO), and, after downloading from
the host, an IBM Personal Computer AT/370, Personal Computer XT/370,
or an IBM Personal Computer AT or XT with an AT/370 or XT/370 option
kit (IBM Personal Computer/370), running Virtual Machine/Personal
Computer (VM/PC).  CICS/CMS Release 1 assists with the development of
applications that are intended for use in host-based CICS/OS/VS or
CICS/DOS/VS systems.


Customer Letter Section

HIGHLIGHTS
o   Improved CICS program development process
o   COBOL, PL/I, and Assembler language translators
o   Full command-level CICS application programming interface (API)
    for translate and compile
o   Extensive CICS/VS functions for unit testing
o   File support under CMS, which simulates VSAM functions
o   Access to host CICS/VS data during unit testing
o   Dialog support and comprehensive debugging aids
o   Simple CICS resource definition and customization
o   Load-and-go installation
DESCRIPTION
IMPROVED CICS PROGRAM DEVELOPMENT PROCESS
       Using the CMS environment, CICS/CMS provides the opportunity
to implement an uninterrupted CICS application development process
while using one workstation. From program entry to completed program
unit test, the programmer can remain in the CMS environment and is
able to concentrate, serially, on a single unit of work without the
distractions of:
o   Packaging and submitting work to the CICS/VS test environment
o   Unpredictable batch turnaround times (waiting for the work to
    finish)
o   The unavailability of a test CICS/VS system
o   The dependence on others to schedule and perform CICS/VS table
    updates.
       CICS/CMS can help to change CICS program development from a
parallel process, where a programmer may often have many programs in
different stages of development at the same time, to a serial
process, where the programmer can concentrate on a single program.
COBOL, PL/I AND ASSEMBLER LANGUAGE TRANSLATORS
       The three CICS/CMS translators execute directly under CMS.
Their output is written onto a local CMS minidisk that is accessible
by the CICS/CMS user, allowing user errors to be corrected
immediately.
FULL COMMAND-LEVEL CICS API FOR TRANSLATE AND COMPILE
       During program translation and compilation or assembly, the
complete command-level API of CICS/OS/VS 1.7 is available.
       Those programmers who are developing for a CICS/OS/VS 1.6.1 or
CICS/DOS/VS 1.6 system should use a subset of this API that is
appropriate to their host CICS/VS environment.
       Those programmers who are developing for CICS/DOS/VS 1.6
should note that OS compilers and assemblers, as provided by VM/CMS,
are used by CICS/CMS.  These programmers should use language subsets
that are common to both DOS and OS. After completing unit testing
under CICS/CMS, source programs should be compiled in the target
CICS/DOS/VS environment.
EXTENSIVE CICS/VS FUNCTIONS FOR UNIT TESTING
       During program unit testing, CICS/CMS executes CICS/OS/VS 1.7
command-level API functions that are meaningful in the single-user
CMS environment. API functions that are not meaningful, for example;
calls to industry-specific terminals, journaling, and
recovery/restart are accepted, but ignored by CICS/CMS.
       FILE SUPPORT UNDER CMS WHICH SIMULATES VSAM FUNCTIONS
       CICS/CMS provides a pseudo-VSAM capability for test data which
includes support for key-sequential data sets, and a subset of
entry-sequential data sets and relative-record data set support.
Browse and generic key requests are supported. No alternate index
support is provided. This pseudo-VSAM support makes it possible to
test the validity of VSAM requests that are valid in the target
CICS/OS/VS or CICS/DOS/VS environments.  To this end, CICS/CMS
provides two utilities:  one converts VSAM files that are stored on
the host system into CICS/CMS pseudo-VSAM files and the other
converts existing CMS files into CICS/CMS pseudo-VSAM files.
       Once the programmer has set up these pseudo-VSAM files on a
local CMS disk, they may be used immediately. CICS/CMS automatically
creates the appropriate file control table entries for all such local
files on first use; a manual table update and assembly is not
required.
ACCESS TO HOST CICS/VS DATA DURING UNIT TESTING
       If unit testing requires access to data that is owned by a
host CICS/VS system, CICS/CMS provides a remote server facility which
obtains the data transparent to the program being tested. Once the
user establishes the interconnection, the remote server facility
passes requests to the host CICS/VS system that owns the resource. At
the remote resource-owning host, a CICS/VS remote server transaction
sends the request to DOS/DLI, IMS file control, temporary storage,
transient data or interval control, as appropriate, and ensures that
any data or message is returned to the program being tested.
       CICS/CMS uses existing VM facilities to provide this data
transfer to and from interconnected CICS/VS systems.  Users of
CICS/CMS may use the remote server facility to connect to a CICS/VS
system running as a guest in the same processor, or to a CICS/VS
system running natively, or as a guest in another processor.
DIALOG SUPPORT AND COMPREHENSIVE DEBUGGING AIDS
       Dialogs are provided to assist the programmer in using
CICS/CMS facilities. Each dialog panel has a corresponding HELP panel
to assist new users to become familiar with CICS/CMS.
       CICS/CMS messages are presented using a common format and each
message is shown on a separate panel. The panel identifies the source
of the error and gives a description, in plain language, of the
nature and, where possible, the likely cause of the error. In many
cases, programmers will be able to diagnose errors without referring
to a manual.
       The CICS/CMS programmer has both CICS/CMS and CMS facilities
available at the same time. At any time a CICS/CMS terminal-read is
outstanding, the programmer can, with a single keystroke, display an
'escape' panel on the screen. A second single keystroke takes the
programmer back to the exact point where CICS/CMS was interrupted.
       The escape panel offers a variety of services, including
access to the temporary-storage browse facility (CEBR), the
execution-diagnostic facility (EDF), the command-level interpreter
(CECI), the opportunity to execute a single CMS command, and access
to the SUBSET mode of CMS. A programmer may, therefore, suspend a
program in the middle of a test and do a variety of useful things;
for example, check the validity of a CICS statement using CECI, check
that the program is writing to temporary storage correctly using
CEBR, exit temporarily to the CMS subset to inspect or even edit
files, or other chosen activities.  If testing shows the need for
changes to the source code, the programmer may easily return to
program editing without leaving the CICS/CMS environment.
       CICS/CMS provides three CICS/VS program testing aids:
o   EDF to 'step through' the program, command by command
o   CECI to check CICS statement syntax and/or execute CICS
    statements one-by-one conversationally
o   CEBR to check the contents of temporary storage and transient
    data queues.
       CICS/CMS allows the programmer to take advantage of the
debugging options provided by CMS, COBOL, and PL/I.
SIMPLE CICS RESOURCE DEFINITION AND CUSTOMIZATION
       Resource definition (CICS table updates) has been simplified
in CICS/CMS. Some tables are transparent to the programmer and are
automatically updated by CICS/CMS during program testing.  Only
entries that define remote resources, extrapartition data, new output
files, and programs need to be updated by the programmer. All of
these definitions are stored as CMS files that are accessible to the
CICS/CMS user.
       When CICS/CMS has been installed, it may be changed to suit an
installation's particular requirements before making it available to
application programmers. For example, one CICS/CMS EXEC contains
parameters such as, common work area, transaction work area, and
programming language default, that define the CICS/CMS working
environment.  These parameters may be changed, as required.
LOAD-AND-GO INSTALLATION
       CICS/CMS does not require a system generation.  When the
CICS/CMS tape has been installed (and, in the case of the Personal
Computer/370, CICS/CMS has been down-loaded), the installation
verification procedure has been successfully executed, and default
parameters have been reviewed, CICS/CMS is ready for use.  The

CICS/CMS User's Guide, which is designed to be understood and used by
those application programmers who will use the system, is supplied
with the program tape. When used in conjunction with the CICS
Application Programming Primer, the CICS/CMS User's Guide is all that
the programmer should need to get started.
PUBLICATIONS
       The following publications are available through your IBM
marketing representative.
o   CICS/CMS General Information Brochure (GC33-0284)
o   CICS Application Programming Primer (SC33-0139)
       The following publications will be provided at availability:
o   CICS/CMS User's Guide
o   CICS/CMS Messages and Codes
o   CICS/CMS Application Programmer's Reference Summary
SCHEDULE
       Planned availability is June 1986.
TECHNICAL INFORMATION
SPECIFIED OPERATING ENVIRONMENT
HARDWARE REQUIREMENTS: CICS/CMS Release 1 runs on any IBM processing
system that supports one of the operating system releases listed
below and has enough real storage to meet the combined requirements
of CICS/CMS, the operating system, access methods, and user
applications.
IBM PERSONAL COMPUTER/370 CONSIDERATIONS: The IBM 3277 Emulation
Adapter or the IBM 3278/79 Emulation Adapter in the Personal
Computer/370 that will provide a coaxial connection to the System/370
VM host licensed to run CICS/CMS is needed to download CICS/CMS to a
Personal Computer/370 and to apply service to CICS/CMS in a Personal
Computer/370.
       The 3278/79 Emulation Adapter is also needed to use the remote
server facility from a Personal Computer/370.  Note that the remote
server facility may not be used via the 3277 Emulation Adapter.
       When running CICS/CMS Release 1 on an IBM Personal Computer
XT/370, 20Mb of fixed-disk storage is required.
SOFTWARE REQUIREMENTS: CICS/CMS is designed to run with the following
operating system releases:
o   VM/SP Version 1 Release 3 (5664-167) with or without the
    corresponding release of VM/SP HPO. PTF UV90076 must be
    installed.
o   VM/PC Release 1 Modification Level 1 (part number 6024175 feature
    number 4175).
       CICS/CMS will also run on subsequent upwardly compatible
releases or modifications of these operating systems, unless
otherwise stated. CICS/CMS does not support prior releases of these
operating systems.
       COBOL support includes:
o   VS COBOL II Compiler and Library Release 1 Modification Level 1
    (5668-958)
o   OS/VS COBOL Compiler and Library Version 1 Release 2 Modification
    Level 4 (5740-CB1)
       Subsequent, upwardly compatible releases or modifications of
these programs may be used, unless otherwise stated.
       PL/1 support includes the PL/I Optimizing Compiler and
Libraries Version 1 Release 4 (5734-PL3) or subsequent upwardly
compatible releases or modifications, unless otherwise stated.
       A System/370 assembler is required for source programs that
are written in assembler and for BMS maps.  Assembler support
includes:
o   For VM/SP: The assembler component of VM/SP or Assembler H
    Version 2 Release 1 (5668-962)
o   For VM/PC: Assembler H Version 2 Release 1 (5668-962)
           Subsequent, upwardly compatible releases or modifications
    of these programs may be used, unless otherwise stated.
       The remote server facility requires one of the following
programs running in either native or guest mode:
o   CICS/OS/VS Version 1 Release 7 (5740-XX1)
o   CICS/OS/VS Version 1 Release 6 Modification Level 1 (5740-XX1)
    with the PTFs for APARs PP46794 and PP38484.
o   CICS/DOS/VS Version 1 Release 6 (5746-XX3) with the PTFs for
    APARs PP41513 and PP46810.
o   CICS/CMS supports EXEC DL/I calls to the DL/I services of IMS/VS
    Version 1 Release 3 (5740-XX2) or DL/I DOS/VS Version 1 Release 7
    (5746-XX1) or subsequent upwardly compatible releases or
    modifications, unless otherwise stated.
       If the remote server facility is used from host CICS/CMS to
access CICS/VS on a processor other than the local VM/SP host, then
VM/Pass-Through Facility Version 1 Release 2 (5748-RC1) is required.
       The remote server facility, when invoked from host CMS, uses
the logical device support facility, a VM/SP facility that may be
used by other application programs running under VM/SP. A maximum of
eight virtual machines may use the logical device support facility
concurrently.
       A virtual machine of at least 1.5Mb is recommended for
CICS/CMS.
SECURITY, AUDITABILITY, AND CONTROL
       The single-user environment of CICS/CMS operates within the
security and data integrity functions that are provided by the VM/SP
and VM/PC environments.  The end user is responsible for protecting
data from unintended modification, destruction, or disclosure, and
for the accuracy of results. Care must be exercised when the Personal
Computer/370 is used in personal computer mode to insure that
CICS/CMS data, files, and programs are not destroyed.
       User management is responsible for evaluation, selection, and
implementation of security features, for administrative procedures,
and for appropriate controls in application development systems.
       If sensitive data is sent over external communication
facilities, user management may wish to pursue the application of
cryptography.
PLANNING INFORMATION
       The table below shows the approximate Personal Computer/370
fixed-disk storage used by CICS/CMS and associated programs that may
be downloaded for permanent residence.
                                                   Required
Program                                            DASD
                                                   (see note)
CICS/CMS (5668-795)                                2.4Mb
VS COBOL II Compiler and Library
 (5668-958)                                        2.4Mb
OS/VS COBOL Compiler and Library
 (5740-CB1)                                        1.0Mb
PL/I Optimizing Compiler & Libraries
 (5734-PL3)                                        2.1Mb
Assembler H (5668-962)                             0.2Mb
       Note: The required DASD estimate does not include space for
data.
PERFORMANCE: The performance of CICS/CMS on a Personal Computer/370
is affected by storage and paging constraints.  Specifically,
extended execution times may be experienced, as compared to an IBM
System/370 processor. The exact performance of CICS/CMS on a Personal
Computer/370 is dependent upon the nature of specific tasks.  It is,
therefore, recommended that customers consider performance when
determining the potential role of the Personal Computer/370 in their
program development plans.  Information to aid customers in
evaluating Personal Computer/370 performance will be available at
CICS/CMS availability.
CUSTOMER RESPONSIBILITY: The installation of CICS/CMS requires a
properly configured System/370 or Personal Computer/370, as required
for the desired operating system.  Also, appropriate language
processing programs must be installed to use the compile or assemble
function. Program developers must be familiar with CMS and
appropriate programming languages.  Personal Computer/370 users of
CICS/CMS should consider fixed-disk-storage capacity when planning
program and test dataset placement.
       Personal Computer/370 users of CICS/CMS are encouraged to
identify a VM/PC designated support contact at the CICS/CMS-licensed
host location. The contact should be the first level of end-user
assistance and should be knowledgeable in the CICS/CMS and VM
environments. The contact will have access to the IBM Support Center
for defect reporting and resolution.
ORDERING INFORMATION
       Ordering information will be provided at availability.
CHARGES, TERMS, AND CONDITIONS
CHARGES
                                                  Personal
                                                  Computer
                                                  License
                                                  Option

                            Basic      DSLO       Amendment
MONTHLY CHARGE:
Host:                       $835       $750       N/A
Personal Computer/370:      N/A        N/A        $50
ONE-TIME CHARGE:
Host:                       $15,000    $13,500    N/A
Personal Computer/370:      N/A        N/A        $900
       Customers who pay the one-time charge for CICS/CMS Release 1
receive enhancements and future releases, if any. Significant new
function may be offered as an option and charged for separately. If a
new version of CICS/CMS Release 1 is announced and the customer
elects to license the new version to replace the prior version, an
upgrade charge may be required.
TERMS AND CONDITIONS
WARRANTED:
Basic License - Yes, in accordance with the terms and conditions of
the Agreement for IBM Licensed Programs.
DSLO - Not applicable.
LICENSED PROGRAM MATERIALS AVAILABILITY: Restricted Materials - Yes.
This licensed program will be available with source licensed program
materials for some modules designated as RESTRICTED MATERIALS OF IBM.
In addition, some modules will be available without source licensed
program materials. These modules will be available in object code.
TESTING PERIOD:
Basic License - Two months.
DSLO - None.
PROGRAM SERVICES: Central service, including the IBM Support Center,
for the basic license, will be available until discontinued by IBM
upon six months' written notice under the terms and conditions of the
Agreement for IBM Licensed Programs.  Central Service, including the
IBM Support Center, will be provided only through the customer
location designated for the basic license.
IBM PERSONAL COMPUTER LICENSE OPTION AMENDMENT: CICS/CMS Release 1
(5668-795) may also be licensed to a designated IBM Personal Computer
XT/370 or AT/370 under the terms and conditions of the IBM Personal
Computer License Option Amendment to Agreement for IBM Licensed
Programs (Z125-3445-01), which must be signed prior to ordering
eligible programs under the license option amendment. A host license
must exist in the same enterprise to serve as the source of the
machine-readable licensed-program materials.
INTERFACE: This program uses only existing attachment interfaces.
INSTALLATION LICENSE OR LOCATION LICENSE APPLIES: No. A separate
license is required for each designated machine on which the licensed
program materials will be used, except as otherwise provided by IBM.
USAGE LICENSE APPLIES: No.
EDUCATIONAL ALLOWANCE: An educational allowance of 15% is available
to qualifying institutions.  The educational allowance is not
additive to any other discount or allowance.
VOLUME LICENSE DISCOUNT: Not applicable.