Cisco Systems S/390 manual

1 Cisco Systems, Inc. All rights reser ved. 170 West Tasman Drive San Jose, CA 95134-1706 USA Cisco Systems, Inc. Corporate Headquarters Copyright © 1998 T ext P ar t Number: 1 Cisco IOS f or S/390 Release 2.0 Release Notes October , 1998 These release notes provide information for syste m administrators and installation managers who are responsib[...]

2 Cisco IOS for S/390 Release 2.0 Release Notes Enhanced Features Enhanced Features This section describes the new product features of Cisco IOS for S/390 release 2.0. Improv ed P erf or mance and Efficiency • Increased throughput, reductio n in CPU utilization, and inbou nd and outbound multip rocessing. TCP/IP processing is now multi-threaded i[...]

Cisco IOS for S/390 Release 2.0 Release Notes 3 Enhanced APIs Enhanced APIs • OS/390 OpenEdition (U NIX System Services) asynch ronous I/O (required for DB2 V 5 TCP/IP support) and SRB mode. • Multiple BIND supp ort for server applications (parallel processi ng fo r FTP , T elnet , and vendor applications). • Enhanced TLI interface—data spa[...]

4 Cisco IOS for S/390 Release 2.0 Release Notes Pro duct Ch anges • The A CPCFG00, APICFG00, and XITCFG00 config uration members have been remov ed. The TCP/IP stack conf iguration has mov ed into a new configuration me mber , TCPCFG00. The applications, such as Server FT P , Server T elnet, etc., mov ed to a new configuration member, APPCFG00. T[...]

Cisco IOS for S/390 Release 2.0 Release Notes 5 Product Ch anges As for parameters in the Cisco IO S for S/390 Release 1.0 configuration member APICFG00, the TPCB was replaced with the SPCB. Y o u will only need 3 (default) because th ere are only 3 API's. CBUFs were replaced with the set of MB U Fs. Pre viously , there were two CB UFs per ses[...]

6 Cisco IOS for S/390 Release 2.0 Release Notes Pro duct Ch anges • Most of the pref ixed messages ha ve a consistent message format of the form pppmmxxxs , where: — ppp is a letter followed b y 2 numbers whi ch identifies the component: — mm is a pair of letters that identifies the subcomponent: T00 mmxxxs Messages issued by IFS common routi[...]

Cisco IOS for S/390 Release 2.0 Release Notes 7 New Features — xxx is a number in the range of 000 - 999, uniquely identifyin g the message — s is a letter indicating the se verity le vel of t he message: • Results of using the TPOIPBR O opti on (q ue ry IP broadcast valu e) when issuing a TOPTION OPTCD=QUER Y dif fer betw een Cisco IO S for [...]

8 Cisco IOS for S/390 Release 2.0 Release Notes Cisco Connection Online Cisco Connection Online Cisco Connection Online (CCO) is Cisco System s’ primary , real-time support channel. Maintenance customers and partners can self-register on CCO to obtain additional infor mat ion and services. A v ailable 24 hours a day , 7 days a week, CCO provides [...]

Cisco IOS for S/390 Release 2.0 Release Notes 9 The Product Do cumentation Lib rary The Product Documentation Librar y 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 Gu ide Describes the Cisco IOS for S/390 architecture, ho w to prepa[...]

10 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Documentation Changes to the Documentation Set The Cisco IOS for S/390 Planning and Operations Guide and Cisco IOS for S/390 Installation Guid e of pre vious releases have been reor ganized as described below: • Cisco IOS for S/390 Planning Gu ide This guide provides information to help you pla[...]

Cisco IOS for S/390 Release 2.0 Release Notes 11 Cisco IOS for S/390 Planning Guide Exit W o rk Area If requested, the exit facility provides a work area to the exit program upon each inv ocation, except the INIT exit point. Request the work area with the EW ALENGTH parameter of the EXIT statement in member IJTCFG xx , or with a parameter re turned[...]

12 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Documentation Exit Rec ove r y Rout ine The exit program can supply the address of a recove ry routine via a paramete r returned at the INIT exit point. The exit f acility calls this routine in the event of an ABEND in the exit program. The recov ery routine is called in the same mode as the ABEN[...]

Cisco IOS for S/390 Release 2.0 Release Notes 13 Cisco IOS for S/390 System Management Guide Customizing CA-A CF2 V ersio n 6 or Later A correction is required for Chapter 3 of the Cisco IOS f or S/290 Planning Guid e. Under the heading Customizing CA-ACF2 V ersion 6 or Later (page 3-12 ), step 2 is Update GSO Record s for Cisco IOS for S/390. The [...]

14 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Documentation The REFRESH command is described in the “Cisco IOS for S/390 Operation” chapter . P aramete rs for the SVCDUMP Command T wo parameters ha ve been added to the SVCDUMP command, ASID and JOBname. These parameters let the user request that other addre ss spaces be dumped along w it[...]

Cisco IOS for S/390 Release 2.0 Release Notes 15 Cisco IOS for S/390 Customization Guide NETST A T RTM Command The NETST A T diag nosti c comm ands are descri bed beginning on page 5-12. The NETST A T R TM command can be used b y a T elnet user to dis play a continuous activity report on all acti ve hardw are interfaces. The frequenc y is determine[...]

16 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Documentation TCP MINDEV and R T O Def aults Changed T wo of the defaults in the TCPCFG00 file hav e changed. For the TCP statement, the MINDEV parameter defaults to 40 (0.10 second). Also on the TCP statement, the R TO parameter defaults to 0; range 0 - 6000. APPEND K eyword f or LUPOOL Statemen[...]

Cisco IOS for S/390 Release 2.0 Release Notes 17 Cisco IOS for S/390 Customization Guide Note that Cisco IOS for S/390 do es not configure T OS for SNMP or DNR queri es, and NNTP is not implemented. T elnet and the FTP control connection can be configured in the Service statement. The FTP data connection can be conf igured in the FTP statement. The[...]

18 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Documentation LOGGING SPIN NO W Spins the log no w; leaves all specif ications unchanged. LOGGING SPIN(LINES(5000) MINUTES(60)) Resets spin to ev ery 5000 lines or 60 minutes, whichever comes f i rst; leaves remaining keywords unchanged. LOGGING PRINT(ALL) WT O(ALL) WRITER (TOLST O Y) SPIN(SYNC) [...]

Cisco IOS for S/390 Release 2.0 Release Notes 19 Cisco IOS for S/390 Unpref ixed Messages and Codes T01CF084W Refresh of USSTAB failed, tbl_name not used in APP task task_num Explanation There was a ne gative response to REFRESH USST AB( tbl_name ) T ASK( task_num ) operator command. tbl_name for APP task task_num was not specif ied in the activ e [...]

20 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Documentation C24Cxxxx (0Exx) T012T OPT This table r eplaces T able 67 “X’C24C’ Ins tance Codes” in the “ API Diagnostic Codes” chapter: C2450002 0702 Recursiv e error C2450003 0703 Error cop ying TPL to secondary C2450004 0704 Error cop ying exit codes to TPL C2450005 0705 VTPL abend[...]

Cisco IOS for S/390 Release 2.0 Release Notes 21 Cisco IOS for S/390 Unpref ixed Messages and Codes C25Bxxxx (1Dxx) T012TERR The following table r eplaces T able 82 “X ’C25B’ Instance Codes” in the “ API Diag nostic Codes” chapter: T able 8 X’C25B’ Instance Codes C24C0020 0E20 SA W not obtained C24C0021 0E21 TLI state in valid C24C0[...]

22 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Documentation C25Fxxxx (21xx) T01PSTUB This table replaces T able 84 “X'C25F' Instance C odes” in the “ API Diag nostic Codes” chapter: T ab le 9 X'C25F' Instance Codes C262xxxx (6Fxx) T012TPLK There is a duplicate entry in T able 85, “X'C262' Instance Code[...]

Cisco IOS for S/390 Release 2.0 Release Notes 23 Installing Cisco IOS for S/39 0 Release 2.0 T ab le 10 X'C262'Instance Codes C909xxx T01SISND The following 4-byte code has been added to T a ble 116, “X’C909’ Instan ce Codes, ” in the “ API Diagnostic Codes” chapter: T able 11 X’C909’ Instance Codes Installing Cisco IOS fo[...]

24 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Installing Cisco IOS f or S/390 Release 2.0 Media media_name is now operational with one o r more active interfaces. Callable System Ser vices Library Y ou must have the Callable System Services libra ry , SYS1.CSSLIB, av ailabl e for the installation. Modules from t his library are linked with C[...]

Cisco IOS for S/390 Release 2.0 Release Notes 25 Installation Requirements • DB2/CONNECT V5 requires Fix Pack WR09014. Do not apply F ix P a ck WR09024 . Common Inet Soc kets in OpenEdition Y ou must in st all the AP AR O W206 20 in order to use Common In et sockets in OpenEdition. RS6000 Y ou must install th e RS/6000 pat ch U432867 to use the C[...]

26 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Installing Cisco IOS f or S/390 Release 2.0 IP Hardware , Cisco IOS Software , and CIP Microcode Compatibility The following table lists the compatibility requirements for Cisco IOS for S/390. Howe ver , we recommend that you refer to the CCO service and your Systems Engineer to choose the most a[...]

Cisco IOS for S/390 Release 2.0 Release Notes 27 Installation Process Note Some members of the CNTL library are no w under SMP/E control and some members will be loaded as part of the APPL Y process. When modifying th e ALL OCT00 JC L stream, verify that the TCPJCL DDDEF points to your CNTL library . Also, you should e xit the CNTL library as soon [...]

28 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Installing Cisco IOS f or S/390 Release 2.0 — V erify that the Linkage Ed itor/Binder attributes for th e CSI include NCAL, LET , and SIZE=(660000,160000). If you are using the linkage editor you must remove the NCAL, LET , and SIZE paramet ers fro m the ALLOCS MP JCL. Y ou must also change you[...]

Cisco IOS for S/390 Release 2.0 Release Notes 29 Installation Process Note Exit the CNTL library as soon as the INSTSMPE job st ream is submitted. Keeping the data set open in your TSO session will cause the APPL Y job to fail. 6 HOLDD A T A Before installi ng system maintenan ce, obtain the most recent HOLDD A T A file. Y ou can obtain this file t[...]

30 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Installing Cisco IOS f or S/390 Release 2.0 — If you are using JES3, a dd the following statement: //*MAIN LINES=(999,W) — V erify that the tape unit is co rrect. It is hardcoded as CAR T . Submit SMPECUMT . SMPECUMT will generate the following message: GIM34701E: SMPE expected to find ++MCS [...]

Cisco IOS for S/390 Release 2.0 Release Notes 31 Installation Process P ARM Customization The statements described in this section are all described in the Cisco IOS for S/390 Customi zation Guide . That document is the definiti ve source of inform ation for th ese members. These members are all shipped with the product. Note P ARM members are now [...]

32 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Installing Cisco IOS f or S/390 Release 2.0 TCPCFG01 : There is a new NETMASK parameter that lets the Network Info rmation Center (NIC) di vide the Class B addresses into Class C addresse s to alleviate some of the worldwide IP address shortages. If your installation is af fected you will ha ve a[...]

Cisco IOS for S/390 Release 2.0 Release Notes 33 Diagnosis and Problem Reporting — If you are using JES2 add: /*JOBPARM LINES=9999 — If you are using JES3, add: //*MAIN LINES=(999,W) • T o prepare RUNTCP as a batch job: — Complete your RUNTCP J OBCARD and add the following JCL statements to the end of the R UNTCP JCL stream: // PEND //label[...]

34 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes SAS/C Usage Notes F RUNTCP ,TC P SNAP ALL Obtaining a TCPEEP Read the Cisco IOS for S/39 0 Sys tem Mana g ement for information to help you set up and submit your trace address space and su bmit the TCPEEP TSO command. Obtaining an SVC Dump Read the IBM document MVS/ESA System Comma nds Refer enc[...]

Cisco IOS for S/390 Release 2.0 Release Notes 35 ACPCFG00 HOST Statement For complete information on the Cisco IOS for S/ 390 product, please refer to your documentation set. This section contains the following topics: • A CPCFG00 HOST Statement • Application Statement Mappings • TCP Protocol Parameters • UDP Protoc ol Pa rameters • RA W [...]

36 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Con ve r ting from Cisco IOS for S/390 Rele ase 1.0 to Cisco IOS for S/390 Release 2.0 Figure 1 HOST parameters SSN( subsys ) DNR( subsys ) A CBNAME( acbname ) GREETING(YES|NO|APPL) JES(2|3|[ ssn ] [ luname ] [ c ] ) LOGST AMP | NO LOGST AMP LOOPBUF( nu mb er ) LUP ARM(ACPLUP00) MIGV OL( vo ls er[...]

Cisco IOS for S/390 Release 2.0 Release Notes 37 Application Stateme nt Mappings Application Statement Mappings The application statements in the former A CPC FG00 fi le can be ma pped to the same statements in the APPCFG00 member , alth ough the SMF statement has been moved to IJTCFG00. These release 1.0 statements hav e been removed: • VT AM Ne[...]

38 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Con ve r ting from Cisco IOS for S/390 Rele ase 1.0 to Cisco IOS for S/390 Release 2.0 There are ne w parameters for the TCP statement in release 2.0: • IPNOTIFY • KEEP ALIVECOUNT • RT D • RT O • TIMEW AIT • TIMEW AIT The following diagram sho w s the par ameter s. Figure 3 TCP Pa ram[...]

Cisco IOS for S/390 Release 2.0 Release Notes 39 UDP Protocol Parameters UDP Protocol P ar ameters The A CPCFG0 0 TIB and UDP mappings have been moved to TPPCFG00. Parameters remov ed from release 1.0: • PR OT OC OL(UDP) • UDP IDLE, RABLIM, WRELIM Parameters renamed for release 1.0: • T ADDRASSIGN -> POR T ASSIGN • T ADDRUSE -> POR TU[...]

40 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Con ve r ting from Cisco IOS for S/390 Rele ase 1.0 to Cisco IOS for S/390 Release 2.0 New parameters for release 2.0. • (None) Figure 5 RA W Pr otocol P arameters NETW ORK P arameters NETWORK parameters hav e been moved to TCPCFG00 NETWORK and MEDIA statements. Parameters remov ed from release[...]

Cisco IOS for S/390 Release 2.0 Release Notes 41 ROUTE Parameters Figure 6 NETWORK P arameters R OUTE P ar ameters The following diagram shows the routing statements from Cisco IOS for S/390 release 1.0 and their usage in Cisco IOS for S/390 release 2.0. Most important to notice is that the old ROUTE NET parameter is no w a ROUTE MEDIAN AME paramet[...]

42 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Con ve r ting from Cisco IOS for S/390 Rele ase 1.0 to Cisco IOS for S/390 Release 2.0 Figure 7 ROUTE P arameters Driver Configur ation Driv er configuration has been moved to TCPCFG00. CETI Driver CETI dri ver commands ha ve been moved to TCPCFG00. Parameters remov ed from release 1.0: • LOGOU[...]

Cisco IOS for S/390 Release 2.0 Release Notes 43 Driver Configuration Figure 8 CETI Driver Pa rameters LNICLA W A CPCFG00 LNICLA W parameters ha ve been mov ed to the TCPCFG00 CLA W statement. Parameters remov ed from release 1.0: • TRA CE • NA M E • ERR OR Parameters changed: • LNICLA W -> CLA W • RETR Y has been changed to REST AR T [...]

44 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Con ve r ting from Cisco IOS for S/390 Rele ase 1.0 to Cisco IOS for S/390 Release 2.0 Figure 9 CLA W Driver P arameters LNICDLC A CPCFG00 LNICDLC parameters hav e been mo ved to the TCPCFG00 CDLC statement. Parameters remov ed from release 1.0: • TRA CE • NA M E • ERR OR Parameters changed[...]

Cisco IOS for S/390 Release 2.0 Release Notes 45 Driver Configuration Figure 10 CDLC Driver Parameters LNIHYPR A CPCFG00 LNIHYPR parameters ha ve been mov ed to the TCPCFG00 HYPER state ment. Parameters remov ed from release 1.0: • TRA CE • NA M E • ERR OR Parameters changed: • LNIHYPR -> HYPR • RETR Y has been changed to REST AR T New[...]

46 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Con ve r ting from Cisco IOS for S/390 Rele ase 1.0 to Cisco IOS for S/390 Release 2.0 Figure 11 HYPR Dr iver P arameters LNILCS and LNIL INK A CPCFG 00 LNILCS and LN ILINK parameters have been mov ed to T CPC FG00 LCS and LINK statements. Parameters remov ed from release 1.0: • TRA CE • NA M[...]

Cisco IOS for S/390 Release 2.0 Release Notes 47 IJTCFG00 Changes Figure 12 LCS and LINK P arameters IJTCFG00 Changes There ha ve been minimal changes to the IJTCFG00 IFSP ARM and A UTH statements. The LOGGING statement haas b een added to IJTCFG00. Parameters remov ed from release 1.0: • (none) Parameters changed: • (none) New parameters for r[...]

48 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Con ve r ting from Cisco IOS for S/390 Rele ase 1.0 to Cisco IOS for S/390 Release 2.0 Figure 13 IFSP ARM and A UTH Statements LOGGING Statement One of the design goals of Cisco IOS for S/390 release 2.0 w as to reduce the volume of message output printed. SMF recordi ng was enhanced to allow man[...]

Cisco IOS for S/390 Release 2.0 Release Notes 49 LOGGING Sta t ement[...]

50 Cisco IOS f or S/390 Release 2.0 Rel e as e Notes Con ve r ting from Cisco IOS for S/390 Rele ase 1.0 to Cisco IOS for S/390 Release 2.0 T his document is to be used in conjunction with the Cisco IOS for S/390 publ ications. A ccessPath, AtmDirector, the CCIE logo, CD-PAC , Centri, the Cisco Capital logo, CiscoL ink , the Ci sco Net Works logo, [...]