Cisco Systems S/390 manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50

Go to page of

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of Cisco Systems S/390, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of Cisco Systems S/390 one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of Cisco Systems S/390. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of Cisco Systems S/390 should contain:
- informations concerning technical data of Cisco Systems S/390
- name of the manufacturer and a year of construction of the Cisco Systems S/390 item
- rules of operation, control and maintenance of the Cisco Systems S/390 item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of Cisco Systems S/390 alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of Cisco Systems S/390, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the Cisco Systems service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of Cisco Systems S/390.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the Cisco Systems S/390 item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    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[...]

  • Page 2

    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[...]

  • Page 3

    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[...]

  • Page 4

    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[...]

  • Page 5

    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[...]

  • Page 6

    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[...]

  • Page 7

    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 [...]

  • Page 8

    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 [...]

  • Page 9

    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[...]

  • Page 10

    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[...]

  • Page 11

    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[...]

  • Page 12

    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[...]

  • Page 13

    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 [...]

  • Page 14

    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[...]

  • Page 15

    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[...]

  • Page 16

    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[...]

  • Page 17

    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[...]

  • Page 18

    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) [...]

  • Page 19

    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 [...]

  • Page 20

    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[...]

  • Page 21

    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[...]

  • Page 22

    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[...]

  • Page 23

    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[...]

  • Page 24

    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[...]

  • Page 25

    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[...]

  • Page 26

    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[...]

  • Page 27

    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 [...]

  • Page 28

    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[...]

  • Page 29

    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[...]

  • Page 30

    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 [...]

  • Page 31

    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 [...]

  • Page 32

    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[...]

  • Page 33

    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[...]

  • Page 34

    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[...]

  • Page 35

    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 [...]

  • Page 36

    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[...]

  • Page 37

    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[...]

  • Page 38

    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[...]

  • Page 39

    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[...]

  • Page 40

    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[...]

  • Page 41

    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[...]

  • Page 42

    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[...]

  • Page 43

    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 [...]

  • Page 44

    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[...]

  • Page 45

    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[...]

  • Page 46

    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[...]

  • Page 47

    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[...]

  • Page 48

    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[...]

  • Page 49

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

  • Page 50

    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, [...]