Table Of Contents
Release Notes for Cisco IOS for S/390 Version 1.0 Cumulative Maintenance Level 9812
Installing the Maintenance Tape
Known Problems and Limitations
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)SYSTEMREASON(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:
binget HOLDbye•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.comcd pub/ptf410get INDEXbyeKnown 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 nameTo 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