Release Notes for Cisco IOS for S/390 Version 1.0 Cumulative Mainenance Level 9812

Table Of Contents

Release Notes for Cisco IOS for S/390 Version 1.0 Cumulative Maintenance Level 9812 

Installation Notes

P/390 Installations

Installing the Maintenance Tape

Applying the CUM Tape

PTF List

Known Problems and Limitations

Corresponding Technical Notes

Related Documentation

Cisco Connection Online

Cisco Documentation CD

Release Notes for Cisco IOS for S/390 Version 1.0 Cumulative Maintenance Level 9812 

---

March 1999

These Cumulative Maintenance Level (CUM) tape notes contain information about CUM9812 for the Cisco IOS for S/390 Version 1.0.

The CUM tape label is "Cisco IOS for S/390 1.0 - EPS" and contains the following PTFs:

VOL=SER=PTFTAP (NL)

•Cisco IOS for S/390 V 1.0 (PTF TP05249 plus PTFs TP05360 through TP06764)

•EPS V 1.0 (PTFs through SP06693)

---

Note   For Cisco IOS for S/390 Version 1.0, installation of CUM9712 is prerequisite to installation of CUM9812.

---

This document contains the following sections:

•Installation Notes, describes special notes about the installation.

•PTF List, describes how to get more information about the PTFs on the CUM9812 tape.

•Known Problems and Limitations, describes known problems and limitations in Cisco IOS for S/390 Version 1.0.

•Corresponding Technical Notes, lists technical notes that contain information about features and enhancements included in CUM9812.

•Related Documentation, describes the documentation for this release of Cisco IOS for S/390.

•Cisco Connection Online, describes the availability of information on the World Wide Web via the Cisco Connection Online.

•Cisco Documentation CD, describes the availability of documentation in an online format on CD.

Installation Notes

This maintenance tape is designed to be installed after CUM9712. CUM9712 must be applied before you can apply CUM9812.

With this update release, you receive a tape with the VOL=SER=PTFTAP that contains all the maintenance supplied with this update. You also receive a Release Note that describes the enhancements and amendments that the tape contains. Please review all the enclosed materials before implementing this update.

When applying cumulative maintenance, issue a P CLEAR shutdown command to ensure that all Cisco IOS for S/390 control blocks are refreshed.

---

Caution    SOC4 or SOC6 abends might occur if you apply maintenance to active libraries. Use the P CLEAR command to correct these.

---

P/390 Installations

The new P/390 systems software does not include the IEV90 assembler. To specify ASMBLR as the program name instead of IEV90, update the IEV90 options entry to point to LOAD module program name ASMBLR.

Installing the Maintenance Tape

The Cisco IOS for S/390 Version 1.0 software product is packaged for installation and maintenance using IBM's SMP/E software product.

This tape contains maintenance for Cisco IOS for S/390 Version 1.0 and Enterprise Print Services (EPS) Version 1.0.

Before installing this maintenance tape, do the following:

•Back up all SMP/E libraries, including all CSI data sets.

•Increase DIR blocks from 23 to 50 for SMPSCDS DD.

•If you do not ACCEPT PTFs, you must increase your SMPPTS DD to 250 cylinders and 25 DIR blocks.

•Compress all libraries.

•If you have applications that were compiled using the SAS C 6.0 compiler, you must apply PTF TP06256. The following is the text from PTF TP06256:

   ++HOLD(TP06256)

   FMID(T000410)

   SYSTEM

   REASON(ACTION)

   COMMENT( 

Customer applications that were compiled using the SAS C 6.0 compiler need to apply this PTF. Applications compiled using the SAS C 5.5 compiler and below are still supported. Applications needing the SAS C 6.0 version of the runtime load module (LSCNCOM) will need to concatenate the SAS C 6.0 data set ahead of SAS's linklib and Interlink's TCP/IP load and link libraries.

The following information is a sample of the UCLIN used to add a DDDEF for the SAS C 6.0 data set required to install this APAR:

 SET BOUNDARY(TCPTZN) .

 UCLIN .

 /*     MVS TCP/IP  TARGET LIBRARIES      */

 ADD DDDEF(SAS6LOAD)

 DATASET(high.level.SAS6LOAD)

 SHR .

 ENDUCL .

A SAS C 6.0 data set must be preallocated prior to installation of this APAR. The data set can be allocated with the following attributes:

 ?/SAS6LOAD DD  DSN=high.level.SAS6LOAD,

 //         DISP=(NEW,CATLG,DELETE),UNIT=unit,

 //         SPACE=(6144,(210,105,10)),VOL=SER=volser,

 //         DCB=(DSORG=PO,RECFM=U,BLKSIZE=6144)

To verify that all applied PTFs have been accepted, run an SMP/E cross-reference job using the following parameters in your SMPCNTL DD card:

SET BDY(TCPTZN)

LIST SYSMODS NOACCEPT(TCPDZN)

Review the output from this job for any USERMODS or APARS you have applied. You might need to use SMP/E to RESTORE the USERMODS and APARS and reapply them after installing CUM9812.

Contact the Interlink Technical Response Center if you need updates to any APARs on your system.

You must load the latest HOLDDATA, which you can get in any of the following ways:

•Online source

Step 1 FTP to ftp.interlink.com.

Step 2 Login as anonymous and use the password e-mail.

Step 3 Change into the pub/ptf410 directory.

Step 4 Enter the following:

bin

get HOLD

bye 

•Automatic notification

You can receive e-mail notification of changes in HOLDDATA automatically when the HOLDDATA list is changed, with a copy of the actual list text enclosed in the body of the message. This can be copied into JCL or manipulated without having to retype it.

Send e-mail to support@interlink.com with the Internet-style e-mail address of the person to receive the message at the customer site.

•Call the Interlink Technical Response Center at 510 657-1800 and ask for the latest HOLDDATA.

•Use the HOLDDATA on the CUM tape, but it may not be the most current HOLDDATA.

Applying the CUM Tape

Use the following JCL to receive and apply the maintenance. Add a SOURCEID(CUM9812) to identify the distribution level of these PTFs.

The following JCL stream is provided in the CNTL library SMPECUMT for applying CUM tapes:

//SMPECUMT JOB

//*

//*    THIS JCL IS FOR APPLYING SMP/E CUMULATIVE MAINTENANCE

//*    FOR MVS TCP/IP AND RELATED PRODUCTS.

//*

//*    REVIEW THE DOCUMENTATION THAT ACCOMPANIES THE CUM TAPE.

//*

//*    IF ANY OF THE PTFS HAVE HOLDS FOR DOC, PLEASE REVIEW

//*    THEM BEFORE STARTING TCP/IP AFTER APPLYING THIS

//*    MAINTENANCE. TO APPLY PTFS BEING HELD FOR DOC, CHANGE

//*    THE APPLY STATEMENT TO:

//*

//*     APPLY BYPASS(HOLDSYSTEM(DOC)).

//*

//*    GLOBALLY CHANGE THE FOLLOWING STRING TO REFLECT THE

//*    CORRECT SMPE DATASETS.

//*

//*    'SMPINDX'      <SMP DATASETS HIGH LEVEL QUALIFIER

//*    'TAPE'      <TAPE DEVICE TYPE

//*

//*    VERIFY THAT THE JOB CARD AND NAMING CONVENTIONS MEET

//*    YOUR SITE'S JCL REQUIREMENTS, THEN SUBMIT THIS JOB

//*

//S1       EXEC PGM=GIMSMP,REGION=4096K,DYNAMNBR=120,TIME=120,

//             PARM='PROCESS=WAIT'

//*

//SMPCSI   DD DISP=SHR,DSN='SMPINDX.CSI'     <==== UPDATE DSNAME

//SMPLOG   DD DISP=SHR,DSN='SMPINDX.SMPLOG'    <==== UPDATE DSNAME

//SMPPTFIN DD DISP=(SHR,KEEP),

//            VOL=(PRIVATE,RETAIN,SER=PTFTAP),

//            UNIT=TAPE,             <==== UPDATE IF DIFFERENT

//            LABEL=(1,NL),

//            DCB=(RECFM=FB,LRECL=80,BLKSIZE=32720),

//            DSN=SMPPTFIN

//

//SMPHOLD  DD *

//

//SMPCNTL  DD *

 SET    BOUNDARY (GLOBAL).

 RECEIVE SYSMODS SOURCEID(CUM9812).

 SET    BOUNDARY (TCPTZN).

 APPLY  BYPASS(HOLDSYSTEM(DOC)) SOURCEID(CUM9812). 

For more information on how to apply maintenance to Cisco IOS for S/390 Version 1.0, read the Cisco IOS for S/390 Version 1.0 Installation Guide.

PTF List

A tape map is included with the CUM9812 maintenance tape that lists the PTFs that are on this tape. If you would like a list of the PTFs that includes a description for each, you can obtain a copy of the current $$INDEX file. This file is available online or you can request a copy by contacting the Interlink Technical Response Center.

You can obtain the $$INDEX file via anonymous FTP by logging in to host ftp.interlink.com and requesting it, as shown in the following example:

ftp ftp.interlink.com

cd pub/ptf410

get INDEX

bye

Known Problems and Limitations

This section describes known problems and limitations in Cisco IOS for S/390 Version 1.0.

•Multicast is not supported within the Cisco IOS for S/390 Fault Tolerant feature.

•Files to be accessed by OpenEdition must reside within the hierarchical file system (HFS). To move files from a remote system to the HFS requires two steps. Two JCL streams, OPUT and OGET, are provided in the CNTL library as examples of how this can be accomplished using MVS batch jobs.

•Users with socket applications that use non-blocking I/O and check for either EWOULDBLOCK or EAGAIN errno values should consider modifying their applications to check for both.

Cisco IOS for S/390 returns EWOULDBLOCK to provide compatibility with IBM TCP/IP for MVS. Some non-MVS socket implementations may return EAGAIN as specified in POSIX documents. Check for both to ensure maximum portability.

•The MAXSTGPCT parameter of IFSPARM in member IJTCFG00 controls TCP connections only. This parameter does not currently support UDP and RAW protocol connections.

•During installation of the Cisco IOS for S/390 Version 1.0 base product on systems using IBM's Binder at DFSMS level 1.3.0, the following error may occur:

IEW2292E B403 OPTION VALUE MISSING OR INVALID FOR OPTION name 

To avoid this error, apply IBM PTF UW26269 prior to installation.

Corresponding Technical Notes

The following technical notes describe the features and enhancements included in CUM9812:

•Cisco IOS for S/390 Release 1.0 Release Note

---

Note   Make sure you have incorporated the documentation changes for CUM9712 before adding the documentation changes for CUM9812.

---

Related Documentation

The Cisco IOS for S/390 manual set has been reorganized along functional lines. The complete manual set includes these documents:

•Cisco IOS for S/390 Planning Guide

Describes the Cisco IOS for S/390 architecture, how to prepare for installation and customize system security, and how to use OpenEdition and user exits. It also includes information about editing tools, information to help configure Cisco IOS for S/390 for Cisco routers and plan storage usage, and about the CDLC driver. This manual is targeted for computer operations personnel. This document ships prior to shipment of the product.

•Cisco IOS for S/390 Customization Guide

Complete guide to customizing Cisco IOS for S/390 for your site. A copy of this document is included with the product shipment.

•Cisco IOS for S/390 System Management Guide

Describes the operator commands (start up and shut down of Cisco IOS for S/390), how to use the System Management Facility (SMF), diagnostic procedures, diagnostic commands, and Inter-User Communications Vehicle (IUCV) sockets. A copy of this document is included with the product shipment.

•Cisco IOS for S/390 User's Guide

Guide to the Cisco IOS for S/390 Client FTP2, Client FTP3, Client FTP, Server FTP, Telnet, and Mail commands, USPOOL, remote executor, API and socket applications, and programmable batch interface for Client FTP2 and Client FTP3.

•Cisco IOS for S/390 Prefixed Messages

Describes all messages that have an alphanumeric prefix and are printed to the console or the Cisco IOS for S/390 log files.

•Cisco IOS for S/390 Unprefixed Messages and Codes

Describes messages from FTP, Telnet, Mail, and general API return codes.

•Cisco IOS for S/390 Assembler API Concepts

Describes the concepts, flow, and operation of the Cisco IOS for S/390 API.

Cisco Connection Online

Cisco Connection Online (CCO) is Cisco Systems' primary, real-time support channel. Maintenance customers and partners can self-register on CCO to obtain additional information and services.

Available 24 hours a day, 7 days a week, CCO provides a wealth of standard and value-added services to Cisco's customers and business partners. CCO services include product information, product documentation, software updates, release notes, technical tips, the Bug Navigator, configuration notes, brochures, descriptions of service offerings, and download access to public and authorized files.

CCO serves a wide variety of users through two interfaces that are updated and enhanced simultaneously: a character-based version and a multimedia version that resides on the World Wide Web (WWW). The character-based CCO supports Zmodem, Kermit, Xmodem, FTP, and Internet e-mail, and it is excellent for quick access to information over lower bandwidths. The WWW version of CCO provides richly formatted documents with photographs, figures, graphics, and video, as well as hyperlinks to related information.

You can access CCO in the following ways:

•WWW:  http://www.cisco.com

•WWW:  http://www-europe.cisco.com

•WWW:  http://www-china.cisco.com

•Telnet:  cco.cisco.com

•Modem:  From North America, 408 526-8070; from Europe, 33 1 64 46 40 82. Use the following terminal settings: VT100 emulation; databits: 8; parity: none; stop bits: 1; and connection rates up to 28.8 kbps.

For a copy of CCO's Frequently Asked Questions (FAQ), contact cco-help@cisco.com. For additional information, contact cco-team@cisco.com.

---

Note   If you are a network administrator and need personal technical assistance with a Cisco product that is under warranty or covered by a maintenance contract, contact Cisco's Technical Assistance Center (TAC) at 800 553-2447, 408 526-7209, or tac@cisco.com. To obtain general information about Cisco Systems, Cisco products, or upgrades, contact 800 553-6387, 408 526-7208, or cs-rep@cisco.com.

---

Cisco Documentation CD

Cisco documentation and additional literature are available in a CD-ROM package, which ships with your product. The Documentation CD-ROM, a member of the Cisco Connection Family, is updated monthly. Therefore, it might be more current than printed documentation. To order additional copies of the Documentation CD-ROM, contact your local sales representative or call customer service. The CD-ROM package is available as a single package or as an annual subscription. You can also access Cisco documentation on the World Wide Web at http://www.cisco.com, http://www-china.cisco.com, or http://www-europe.cisco.com.

If you are reading Cisco product documentation on the World Wide Web, you can submit comments electronically. Click Feedback in the toolbar and select Documentation. After you complete the form, click Submit to send it to Cisco. We appreciate your comments.

78-6656-01 Rev. A0