cc/td/doc/product/software/ioss390
hometocprevnextglossaryfeedbacksearchhelp
PDF

Table of Contents

Editing Tools For Installation

Editing Tools For Installation

This appendix describes the some edits you must make before installing Cisco IOS for S/390Cisco IOS for S/390 and how to use the tools necessary for these editions.

It covers the following subjects:

Describes how to allocate common load data sets.
Describes how to use the ISPF editor to edit the ALLOCSMP job.
Describes how to edit the TCPNAMES member in the CNTL data set to globally change strings used by the ALLOCxxx job streams.

Setting Up the SMP Environment

The first time you install Cisco IOS for S/390, you must set up the SMP environment. To do this, you must edit some of the members to allocate common load data sets.

There are two ways to allocate the common data sets:

Globally edit the following symbols using values appropriate for your system configuration:

HOLDCL DSTINDX DSTUNIT
DSTVOL LNKINDX SMPINDX
SMPUNIT SMPVOL TLBUNIT
TLBVOL TRGINDX TRGUNIT
TRGVOL

All Cisco IOS for S/390 software products require that a common environment be established for their installation. The process comprises these tasks:

Making Global Changes with the ISPF Editor

This is the format of the global change command if you are using the ISPF editor to edit the ALLOCSMP job:

c 'old_string' 'new_string' all

To change the string SMPINDX to TCPACSS, enter this command:

c 'SMPINDX' 'TCPACSS' all

If you are changing the HOLDCL symbol to an asterisk in order to use the same SYSOUT class as specified on the JOB statement MSGCLASS parameter, make sure the asterisk is enclosed in single quotes in your global change command, as this command illustrates:

c 'HOLDCL' '*' all
 
Caution Do not modify job ALLOCSMP to use a predefined Consolidated Software Inventory (CSI) in which other software products are installed. That is, Cisco IOS for S/390 software products must be installed in their own target and distribution zones.

Note Expect return code 0 from each step of ALLOCSMP.

Updating the TCPNAMES ISPF Edit Clist

TCPNAMES is an ISPF Edit Clist in the CNTL data set. TCPNAMES globally changes all the strings used by the ALLOCxxx job streams. TCPNAMES inserts a jobcard and updates the job with your local variables.

The TCPNAMES Clist requires ISPF Version 2 or higher. If the TCPNAMES Clist is used as distributed, all data sets must have the same high-level qualifier except for the LINK data set, which is prefixed by SYS1. plus the high-level qualifier used for the other data sets.

    1 . Edit the JOBCARD member in the CNTL data set, changing the JOB statement to match your site's requirements.

    2 . Copy member TCPNAMES to a fixed length record format Clist data set that is in your TSO SYSPROC DD concatenation.

    3 . As you edit the ALLOCxxx and other installation members, update the variables in the ALLOCxxx job with the parameters passed through this TCPNAMES command:

The syntax is:

TCPNAMES high_level disk_vol disk_unit tape_vol tape_unit
TCPNAMES Is the command to use to edit the TCPNAMES Clist.
high_level Indicates the data set high-level qualifier.
disk_vol Specifies the disk volume where the data sets are to be created.
disk_unit Indicates the disk unit type of the volume.
tape_vol Specifies the volume serial number of the installation tape.
tape_unit Indicates the address of the tape unit to which the installation tape will be assigned.
Usage Notes:

Always run the Clist TCPNAMES from the command line of the member for every job prior to submitting the job.

If the high-level qualifier you are using is TCPACSS, the disk volume serial number is MVS001, the disk unit type is 3390, the tape volume serial number is TCPACSS, and the tape unit is TAPE, then use this primary line command to update variables:

TCPNAMES TCPACSS.Vxxx MVS001 3390 TAPE

This changes all the strings that need to be changed in the job and replaces the JOB statement with the one in the JOBCARD member.


Note To run the ALLOCxxx jobs, it is not necessary to substitute variables for the tape_vol or tape_unit parameters. They are used in INSTSMPE.
 
Caution Whenever you make changes to any SYS1.PARMLIB member, make sure you can perform an IPL on your system using an alternate IPL volume or an alternate SYS1.PARMLIB member. Typographical errors can cause catastrophic errors during system initialization, leaving your MVS system in an unusable state.

hometocprevnextglossaryfeedbacksearchhelp
Copyright 1989-1998 © Cisco Systems Inc.