IBM United States
Software Announcement 202-349
December 17, 2002
IBM Session Manager for z/OS Provides Simple and Secure Access to Multiple Systems and Applications from One Terminal
(Corrected on December 18, 2002)
The Prices section was corrected.
At a Glance
Session Manager enables a user at a single 3270 terminal to access applications running on any machine in a network of servers running z/OS or OS/390. It offers a wide range of facilities, including:
For ordering, contact:
Your IBM representative or the Americas Call Centers at 800-IBM-CALL (Reference: LE001).
IBM Session Manager for z/OS V1.1 is a session manager for VTAM® and TCP/IP that provides a secure and user-friendly method of accessing multiple OS/390® or z/OS systems from a single 3270 terminal. Session Manager provides a password-protected single menu from which users can access all applications running on any z/OS or OS/390 machine in the network. It also provides logoff procedures, security checking, audit logging and centralized administration, operations, and monitoring. Its advantages include:
It can also reduce cost and effort associated with network administration and bring benefits to helpdesk and operations personnel who can easily view user problems. In addition, it offers centralized user ID administration and the ability to broadcast messages to end users.
Moreover, Session Manager provides additional value beyond basic session management with facilities for viewing the screens of remote users, compressing data streams between terminals and applications, and building new applications by integrating existing applications.
Session Manager for z/OS V1.1 is a VTAM or TCP/IP session manager, providing secure and user-friendly access to multiple z/OS or OS/390 systems from a single 3270 terminal. Many users in the course of their work need to switch between applications. Session Manager acts as an intermediary between the end user and the applications. It provides the user with a single secure signon, and then allows access to all their applications from multiple concurrent virtual sessions. Users can switch between sessions with ease, or from the menu the user can point and click to create a new session to another VTAM or TCP/IP application. Session Manager includes all the tools and facilities required to provide administration, security, systems and performance management, as well as problem determination. It provides many features and facilities which enable end users to improve their productivity, including:
The Script Facility
The Script facility is provided by the SCRIPT statement. Each script has a unique name, and defines a set of executable parameters which can be thought of as a small program. There are numerous parameters that can be used, and scripts are in consequence very flexible and can perform many different functions. In general, however, most scripts fall into one of the following categories:
Session Manager provides a special language, the Panel and Script Language, which enables logic to be added to scripts. Scripts can be paused until certain output is received, for example from an application, and continuation of the script can be made conditional. Input from the terminal may be mapped into variables, passed onto an application, or passed to another script. Scripts can also be nested up to any level.
Session Scripts: Session Manager can pass data streams to an application automatically. This can be done without any terminal input from the user. A session script, as its name suggests, relates to a specific application session, or session parameter. There are two other scripts associated with sessions, which run before a session start and after a session end. These scripts do not communicate with the application. Session scripts are subdivided into six categories:
Any of the above can also carry out Application Builder functions (see below) by use of certain Application Builder verbs. These verbs enable a script to selectively combine data output from one or more sessions and present it on a single panel.
Exit Scripts: Exit scripts can be defined to run in place of many of the exit points of the Session Manager User Exit. It can be defined to run in place of, or in addition to, most assembler/COBOL exit points of the Session Manager User Exit. This is achieved by specifying the exit point name and the option "S" on the OPTION statement. A script of the form EXITxx must be defined for the relevant exit, where xx is the exit point. For example, if "E33 S" is specified on the OPTION statement, a script EXIT33 will be called.
Command Scripts: Command scripts can be defined to run in place of Session Manager defined commands. Therefore, a Command script can be run in place of Session Manager logic to action the command. This is enabled by the CMDSCRIPT parameter of the COMMAND statement. If CMDSCRIPT is specified but no scriptname is provided, Session Manager attempts to run a script with the same name as the command. If a scriptname is provided, it is this script that is run in place of the command.
Windows Scripts: A windows script relates to the Session Manager windows feature, and is not session-specific. Depending on the contents of the script, the terminal screen is divided into areas. Each area usually contains its own command input field, so that each area can perform its own function. Typically, several sessions can be active and viewable simultaneously.
Application Builder Scripts: An Application Builder script relates to the Application Builder feature. These scripts are session scripts, but they have special parameters that enable output from multiple sessions to be combined selectively and presented on a single panel. Additionally, output from one or more sessions may be used as input to any other session or sessions.
This is achieved by running Application Builder scripts on each of the
sessions concerned. In addition to the normal session script processing,
an Application Builder script can start and stop a session, run a script
on a specified session, and halt scripts that are in progress on any
session. Details from any part of an application screen can be copied to
a variable and data can be sent to, and received from, a script running
on another session.
Support for TCP/IP in Session Manager uses the TELNET application server support via the TN3270 protocol; client support is via the TN3270, VT100/VT200, ANSI, or Network Virtual Terminal (NVT) protocols of TELNET.
Any TN3270 client can access Session Manager as a server using the TN3270 Telnet server support within the TCP/IP stack (which creates a virtual LU in VTAM for Session Manager). For users of Session Manager running TCP/IP interfaces, Session Manager TN3270 Server Support provides an alternative method which can be more efficient and also enables Session Manager to operate without VTAM. With Session Manager TN3270 Server Support, TCP/IP users running TN3270 can connect directly to a Session Manager signon or menu panel. Session manager then acts as a TCP/IP Telnet server.
TELNET/TN3270 Client Support: This provides access to remote applications running on any host connected over a TCP/IP network. It allows a Session Manager user to have one or more TCP/IP Telnet Client connections. These appear as conventional Session Manager sessions that are configurable in the normal way and which coexist with any other conventional sessions. NVT is supported by most Telnet Servers and is a line mode interface. If the Server can support the full screen TN3270 connection, then this is used by default in preference to the line mode NVT connection. NVT provides simple "line-by-line" terminal support using the Telnet NVT protocol. The TN3270 session appears identical to a conventional Session Manager session.
This facility allows a Session Manager user to access and run any Server
application that is available to the TCP/IP network. The host on which
that application runs must have a Telnet Server supporting NVT. The
Session Manager user interacts with the remote application using the 3270
terminal (or PC emulated 3270) in line-by-line mode.
The Performance Monitor
Session Manager provides two types of performance monitoring routine. The first is a monitoring routine to gather performance data on itself. The second provides session level statistics on network and application response times.
Session Manager's monitoring routine to gather performance data about itself is part of the User Exit module and is invoked every ten minutes. The length of an interval may vary on a low-activity system because the exit may not be invoked. The records are held in storage in a wrap-around table containing 100 records. The exit can be amended to write the records to a file. In MVS, for example, SMF records could be written.
The performance data obtained by Session Manager on the network and
applications can be viewed from the Menu panel. The panel can be paged
forwards and backwards and, because the records are wrapped, the latest
record is always highlighted. Data does not appear during the first 20
minutes after Session Manager initiation, but from that point on, it is
produced at 10-minute intervals. The data displayed includes the date
and time that each record has been created and the elapsed time of the
interval. On a system where the exit is regularly invoked, each interval
will be approximately 600 seconds. For each interval, it shows the
average number of inputs and outputs per second to all the active
sessions. The session outputs figure includes non-visible outputs, even
those that are discarded.
The other principal functions offered by Session Manager are:
Accessibility by People with Disabilities
The Hummingbird® HostExplorer terminal emulator was used for
screenreaders testing. A WindowEyes set file for the Hummingbird
emulator or a Jaws script for the Hummingbird emulator is needed. Set
and script files may be obtained from the screen reader vendor. Testing
has not been carried out with other emulators; however, they are likely
to work if the relevant set file or script file is available.
Section 508 of the U.S. Rehabilitation Act
The following features support use by people with disabilities:
Session Manager has been tested for use by people with visual impairment using both Jaws and WindowEyes screen readers.
Softcopy documentation in .pdf format is shipped for use with the
product. This documentation supports optional font enlargement and
high-contrast display settings, and may be operated by the keyboard
alone. Alternative text is not provided for screen-reader users;
however, fully accessible softcopy documentation, with alternative text
for diagrams, will be made available on request.
Value Unit Based Pricing
Value Unit based pricing will help to align the prices of this product to the principle of the PSLC pricing curve which provides for a lower price per MSU (millions of service units per hour) for larger capacities.
There is also a price benefit when customers grow their capacity. Additional capacity will based on the number of Value Units (MSUs) the customer has already installed, for example, additional capacity will not be priced starting at the base with a higher price per unit but on the capacity that is already installed.
IPLA and Subscription and Support Considerations
IPLA licenses can be transferred from one machine to another within, but not limited to, an enterprise. The customer may aggregate the capacity for all the processors the product is operated on to achieve a more economic price. This will result in a single Proof of Entitlement (PoE). It is the customer's responsibility to manage the distribution of Value Units within the limits of the entitlement of the product license.
Subscription and Support must cover the same capacity as the product license entitlement. Subscription and Support will be available in the country in which the agreement is made.
Session Manager is intended for customers running a range of applications on mainframe systems, with end users accessing these applications at 3270 terminals or workstations running 3270 emulators. The customers may be using VTAM, typically with LU6.2 or 3270 connections, or TCP/IP. It provides the end users with a simple way of accessing these applications seamlessly, together with a wide range of other valuable facilities.
No education is provided specific to this product.
Visit the following Web site for educational information:
See also the IBM Learning Services Web site for available courses in your country:
Call IBM Education and Training at 800-IBM-TEACH (426-8322) for catalogs, schedules, and enrollments.
Product information is available through Offering Information (OITOOL) at:
The following hardcopy publication is shipped with this product:
Title Order Number Session Manager for z/OS(TM) -- GI10-2562 Program Directory
The following publications are available only in softcopy, in PDF format:
Title Order Number Session Manager for z/OS -- GC34-6285 Installation and Getting Started Session Manager for z/OS -- SC34-6286 Technical Reference Session Manager for z/OS -- SC34-6287 Facilities Reference Session Manager for z/OS -- SC34-6288 Panels, Scripts and Variables Session Manager for z/OS -- GC34-6289 Messages and Codes Session Manager for z/OS -- SC34-6290 Quick Reference
The softcopy publications in PDF format are provided by download from the IBM Publications Center Web site at:
Specified Operating Environment
Session Manager requires:
Security, Auditability, and Control
Session Manager for z/OS V1.1 uses the security and auditability features of the base operating system under which it is operating. It also produces its own audit logs, providing a full audit trail for all users.
The customer is responsible for evaluation, selection, and implementation of security features, administrative procedures, and appropriate controls in application systems and communication facilities.
Session Manager for z/OS V1.1 is licensed under the IBM International Program License Agreement (IPLA). It has a single charge unit, based on Value Units.
Value Unit Exhibit VUE007
MSUs MSUs Value Minimum Maximum Units/MSU Base 1 3 1 Tier A 4 45 0.45 Tier B 46 175 0.36 Tier C 176 315 0.27 Tier D 316 + 0.2
Value Units for Non-MSU-Based S/390 Processors
Value Hardware Units/Machine MP3000 H30 6 MP3000 H50 8 MP3000 H70 12 ESL Models 2
OTC Medium Program Feature Feature Description Number Number Number Medium Per Value Unit 5655-K01 0001 5802 3480 tape
OTC = One-Time Charge
The product in this announcement has one charge unit Value Units.
Value Units for IBM 9672 Processors will be based upon the full capacity of these systems. This is applicable to all S/390-based systems that are measured on MSU capacity. Information on MSU capacities can be found in the IBM System/370, System/390® and zSeries Machine Exhibit (Z125-3901).
Value Units for zSeries will be based upon full MSU capacity as defined in the Machine Exhibits.
There will be a tool available that provides support for transforming the MSU-based capacities of S/390 systems to new Value Units by calculating the applicable number of Value Units for a given number of MSUs.
If the customer has installed 1,500 MSUs, the applicable Value Units would be:
Translation from MSUs to Value Units Value MSUs * Units/MSU = Value Units Base 3 * 1.00 = 3.00 Tier A 42 * .45 = 18.90 Tier B 130 * .36 = 46.80 Tier C 140 * .27 = 37.80 Tier D 1,185 * .20 = 237.00 Total 1,500 343.50
When calculating the total number of Value Units, the sum is to be rounded up to the next integer.
Value Units for Non-MSU-Based S/390 Processors
MP3000 Models H30 = 6.00 Value Units H50 = 8.00 Value Units H70 = 12.00 Value Units P/390, R/390, IBM 3006 = 2.00 Value Units
Basic License: To order, specify the program number and the OTC feature number. Also specify the feature number of the desired distribution medium. To suppress shipment of media, select the license-only option in CFSW.
Medium Program Feature Description Number Number Medium Session Manager 5655-K01 5802 3480 1/2-inch for z/OS V1 Tape Cartridge Session Manager 5655-J98 6000 Paper for z/OS V1 -- Software Subscription and Support
Translation from MSUs to Value Units Value MSUs Units/MSU Base 1-3 1.00 Tier A 4-45 0.45 Tier B 46-175 0.36 Tier C 176-315 0.27 Tier D 316+ 0.20
OTC Program Feature Description Number Number Session Manager for z/OS 5655-K01 1 Value Unit 0001 250 Value Units 0002
Subscription and Support: To receive voice technical support via telephone during normal business hours and future releases and versions at no additional charge, order Subscription and Support. The capacity of Subscription and Support (Value Units) must be the same as the capacity ordered for the product licenses.
To order, specify the support program number. IBM is also providing Subscription and Support for this product via a separately purchased offering under the terms of the IBM International Agreement for Acquisition of Support (IAAS). This offering:
Once Subscription and Support is ordered, the charges will renew automatically annually unless cancelled by the customer.
Annual Support Charge Program Feature Description Number Number Subscription and Support for 5655-J98 Session Manager for z/OS 1 Value Unit 0001 250 Value Units 0002 Decline SW Subscription and 0003 Support (no charge)
Feature Description 3445 Local IBM Office Expedite (for IBM use only) 3446 Customer Expedite Process Charge ($30 charge for each product)
Expedite shipments will be processed to receive 72-hour delivery from the
time IBM Software Delivery and Fulfillment (SDF) receives the order. SDF
will then ship the order via overnight air transportation.
Product media is shipped only via Customized Offerings (for example, CBPDO, ServerPac, Systempac®). Non-customized items (CDs, diskettes, source media, media kits) will continue to be shipped via the stand-alone product.
Terms and Conditions
Sub-Capacity Charges Terms and Conditions
IBM zSeries software charges at less than full machine capacity for eligible z/OS Tools apply when z/OS is running in z/Architecture (64 bit) mode on a zSeries 900, no other MVS-based operating system is licensed to that server, and the required information is provided by the customer in accordance with the applicable terms.
Sub-capacity charges for an eligible z/OS Tool are based on the z/OS product defined capacity. To obtain charges at less than full machine capacity for eligible z/OS Tools, the customer is required to:
Sub-Capacity Charges for z/OS Tools
To be eligible for sub-capacity charges for z/OS Tools, the machine on which the z/OS Tools are running must be eligible for WLC sub-capacity charges terms and conditions. The customer must have signed the Attachment for zSeries Workload License Charges-Pre-ILM (Z125-6516) and submitted at least one Sub-Capacity Report to IBM as defined in the attachment.
With sub-capacity charges, the charge for an eligible z/OS Tool is based on the z/OS product defined capacity. To obtain charges at less than full machine capacity for each eligible z/OS Tool for each machine, the customer should:
Management of the Value Unit entitlements continues to be a customer responsibility. If one of the following occur on a machine to which z/OS Tools are licensed, the customer must determine if additional Value Units and Subscription and Support need to be ordered for those tools to cover the increase:
The following agreement applies for maintenance and does not require customer signatures:
This product is licensed under the IBM Program License Agreement (IPLA), the associated Agreement for Acquisition of Support, and the Addendum for Support (Z125-6435), which provides for support with ongoing access to releases and versions of the program. This program has a one-time license charge for use of the program and an ongoing recurring charge for the enhanced support that includes telephone assistance (voice support for defects during normal business hours) as well as access to updates, releases, and versions of the program while support is in effect. S/390 and zSeries IBM Operational Support Services Support Line is an option for those customers who desire added services.
Program Support: Enhanced Support, called Subscription and Support, includes telephone assistance (voice support for defects during normal business hours) as well as access to updates, releases, and versions of the program as long as support is in effect. The customer will be notified of discontinuance of support with 12 months' notice.
Money-Back Guarantee: If for any reason you are dissatisfied with the program, return it for a refund within 30 days from the invoice date to the party (either IBM or its reseller) from whom you acquired it. This applies only to your first acquisition of the program.
For operating system software, the revised IBM Operational Support Services Support Line offering will provide support for those operating systems and associated products that are not available with the newly announced Software Maintenance offering. This will ensure total support coverage for your enterprise needs, including IBM and selected non-IBM products. For complete lists of products supported under both the current and revised Support Line offering, refer to our Web site at:
For additional information on the revised IBM Operational Support Services, refer to Services Announcement 601-023 , dated July 10, 2001.
The prices provided in this announcement are suggested retail prices for the U.S. only and are provided for your information only. Dealer prices may vary, and prices may also vary by country. Prices are subject to change without notice. For additional information and current prices, contact your local IBM representative.
Program Name: Session Manager for z/OS Version 1
OTC One- Program Feature Time Description Number Number Charge Session Manager for z/OS 5655-K01 V1.1 1 Value Unit 0001 $ 2,500 250 Value Units 0002 625,000
Subscription and Support
Annual Support Charge One- Program Feature Time Description Number Number Charge Session Manager for z/OS 5655-J98 V1.1 -- Subscription and Support 1 Value Unit 0001 $ 375 250 Value Units 0002 93,750
IBM Global Financing offers competitive financing to credit-qualified customers to assist them in acquiring IT solutions. Our offerings include financing for IT acquisition, including hardware, software, and services, from both IBM and other manufacturers or vendors. Offerings (for all customer segments: small, medium, and large enterprise), rates, terms, and availability can vary by country. Contact your local IBM Global Financing organization or visit the Web at:
To order, contact the Americas Call Centers or your local IBM representative.
To identify your local IBM representative, call 800-IBM-4YOU (426-4968).
Phone: 800-IBM-CALL (426-2255) Fax: 800-2IBM-FAX (242-6329) Internet: firstname.lastname@example.org Mail: The Americas Call Centers Dept. LE001 P.O. Box 2690 Atlanta, GA 30301-2690 Reference: LE001
The Americas Call Centers, our national direct marketing organization, can add your name to the mailing list for catalogs of IBM products.
Note: Shipments will begin after the planned availability date.