gtps4m07 | System Generation |
Use this book to plan for and install a TPF system. To migrate to a
new release of the TPF system, use this book with TPF
Migration Guide: Program Update Tapes. It includes detailed
descriptions on the use of the system initialization program (SIP) for
generating the system and the facilities for generating the non-SNA
communications network.
TPF Network Control Program (NCP) support depends on:
- Subarea support (T5), which requires SNA Network Interconnection (SNI)
- T2.1 low-entry networking (LEN) support, which requires NCP Version
4 Release 3, or later
- T2.1 Advanced Peer-to-Peer Networking (APPN) support, which
requires NCP Version 6 Release 2, or later.
All subsequent occurrences of NCP in the text of this book are superseded
by the previous information, unless otherwise specified.
TPF Network Extension Facility (NEF) support depends on
either:
- The Network Extension Facility (NEF2 PRPQ P85025), or
- Airlines Line Control Interface (ALCI) feature of
ACF/NCP.
All subsequent occurrences of NEF in the text of this book are superseded
by the previous information.
In this book, abbreviations are often used instead of spelled-out
terms. Every term is spelled out at first mention followed by the
all-caps abbreviation enclosed in parentheses; for example, Systems
Network Architecture (SNA). Abbreviations are defined again at various
intervals throughout the book. In addition, the majority of
abbreviations and their definitions are listed in the master glossary in the
TPF Library Guide.
See "Communicating Your Comments to IBM" for more information about
how to contact your TPF support representative.
This book is written for system programmers responsible for the planning
and installation of a TPF system. It should be used with TPF System Installation Support Reference, which
describes closely related functions and tools that support the system
generation process.
Users of this book should have a basic understanding of the TPF system, and
the communication facilities supported by the TPF system. Familiarity
with MVS systems is also required. For a comprehensive technical
overview of the TPF system, see TPF Concepts and
Structures.
The TPF library uses the following conventions:
Conventions
| Examples of Usage
|
italic
|
Used for important words and phrases. For example:
A database is a collection of data.
Used to represent variable information. For example:
Enter ZFRST STATUS MODULE mod, where mod is the
module for which you want status.
|
bold
| Used to represent text that you type. For example:
Enter ZNALS HELP to obtain help information for the ZNALS
command.
Used to represent variable information in C language. For
example:
level
|
monospaced
| Used for messages and information that displays on a screen. For
example:
PROCESSING COMPLETED
Used for C language functions. For example:
maskc
Used for examples. For example:
maskc(MASKC_ENABLE, MASKC_IO);
|
bold italic
| Used for emphasis. For example:
You must type this command exactly as shown.
|
Bold underscore
| Used to indicate the default in a list of options. For
example:
Keyword=OPTION1 | DEFAULT
|
Vertical bar |
| Used to separate options in a list. (Also referred to as the OR
symbol.) For example:
Keyword=Option1 | Option2
- Note:
- Sometimes the vertical bar is used as a pipe (which allows you to
pass the output of one process as input to another process). The
library information will clearly explain whenever the vertical bar is used for
this reason.
|
CAPital LETters
| Used to indicate valid abbreviations for keywords. For
example:
KEYWord=option
|
Scale
| Used to indicate the column location of input. The scale begins at
column position 1. The plus sign (+) represents increments of 5
and the numerals represent increments of 10 on the scale. The first
plus sign (+) represents column position 5; numeral 1 shows column
position 10; numeral 2 shows column position 20 and so on. The
following example shows the required text and column position for the image
clear card.
|...+....1....+....2....+....3....+....4....+....5....+....6....+....7...
LOADER IMAGE CLEAR
Notes:
- The word LOADER must begin in column 1.
- The word IMAGE must begin in column 10.
- The word CLEAR must begin in column 16.
|
This section describes how to read the syntax diagrams (informally called
railroad tracks) used in this book.
- Read the diagrams from left-to-right, top-to-bottom, following the main
path line. Each diagram begins on the left with double arrowheads and
ends on the right with 2 arrowheads facing each other.
- If a diagram is longer than one line, the first line ends with a single
arrowhead and the second line begins with a single arrowhead.
- A word in all uppercase is a parameter that you must spell
exactly as shown.
- If you can abbreviate a parameter, the optional part of the parameter is
shown in lowercase. (You must type the text that is shown in
uppercase. You can type none, one, or more of the letters that are
shown in lowercase.)
- Note:
- Some TPF commands are case-sensitive and contain parameters that must be
entered exactly as shown. This information is noted in the description
of the appropriate commands.
- A word in all lowercase italics is a variable. Where you
see a variable in the syntax, you must replace it with one of its allowable
names or values, as defined in the text.
- Required parameters and variables are shown on the main path line.
You must code required parameters and variables.
- If there is more than one mutually exclusive required parameter or
variable to choose from, they are stacked vertically.
- Optional parameters and variables are shown below the main path
line. You can choose not to code optional parameters and
variables.
- If there is more than one mutually exclusive optional parameter or
variable to choose from, they are stacked vertically below the main path
line.
- An arrow returning to the left above a parameter or variable on the main
path line means that the parameter or variable can be repeated. The
comma (,) means that each parameter or variable must be separated from the
next parameter or variable by a comma.
- An arrow returning to the left above a group of parameters or variables
means that more than one can be selected, or a single one can be
repeated.
- If a diagram shows a blank space, you must code the blank space as part of
the syntax. In the following example, you must code
PARAMETER variable.
- If a diagram shows a character that is not alphanumeric (such as commas,
parentheses, periods, and equal signs), you must code the character as part of
the syntax. In the following example, you must code
PARAMETER=(begin.end).
- Default parameters and values are shown above the main path line.
The TPF system uses the default if you omit the parameter or value
entirely.
- References to syntax notes are shown as numbers enclosed in parentheses
above the line. Do not code the parentheses or the number.
Notes:
- An example of a syntax note.
- Some diagrams contain syntax fragments, which serve to break up
diagrams that are too long, too complex, or too repetitious. Syntax
fragment names are in mixed case and are shown in the diagram and in the
heading of the fragment. The fragment is placed below the main
diagram.
A list of related information follows. For information on how to
order or access any of this information, call your IBM representative.
- TPF Application Programming, SH31-0132
- TPF ACF/SNA Network Generation, SH31-0131
- TPF ACF/SNA Data Communications Reference,
SH31-0168
- TPF System Installation Support Reference,
SH31-0149
- TPF Main Supervisor Reference, SH31-0159
- TPF Operations, SH31-0162
- TPF Database Reference, SH31-0143
- TPF Data Communications Services Reference,
SH31-0145
- TPF System Performance and Measurement
Reference, SH31-0170
- TPF Migration Guide: Program Update Tapes,
GH31-0187
- TPF General Macros, SH31-0152
- TPF Concepts and Structures, GH31-0139
- TPF Program Development Support Reference,
SH31-0164
- TPF Non-SNA Data Communications Reference,
SH31-0161
- TPF C/C++ Language Support User's Guide,
SH31-0121
- TPF System Macros, SH31-0151
- TPF Transmission Control Protocol/Internet
Protocol, SH31-0120.
- IBM C/C++ for MVS/ESA C++/MVS Language Reference,
SC09-1992
- OS/390 C/C++ User's Guide,
SC09-2361.
- ES/9000, ES/3090 Input/Output Configuration Program
User's Guide and ESCON Channel-to-Channel Reference, GC38-0097
- IBM System/370 Input/Output Configurator,
GA22-7002
- 3704/3705 Control Program Generation Utilities
Guide, GC30-3008
- General Information - Binary Synchronous
Communications, GA27-3004
- IBM Extended Operations Console Facility/2 System
Administrator's Guide, SH31-0105
- 3600 Finance Communication System 3614
Programmer's Guide and Reference, GC27-0010
- IBM 3600 Finance Communication System Instructions
and Macro Reference, GC27-0003
- IBM 3600 Finance Communication System
Programmer's Guide and Component Descriptions, GC22-9045
- ESA/390 Principles of Operation, SA22-7201
- DSF User's Guide and Reference, GC35-0033
- MVS/ESA JCL Reference, (order the correct version and release
for your installation)
- EP for 3705 Generation and Utilities Guide,
SC30-3242
- OS/VS2 MVS Utilities, GC26-3902
- 3990 Transaction Processing Facility Support
RPQs, GA32-0134.
Your feedback is important in helping to provide the most accurate and
highest quality information. If you have any comments about this book
or any other TPF information, use one of the methods that follow. Make
sure you include the title and number of the book, the version of your product
and, if applicable, the specific location of the text you are commenting on
(for example, a page number or table number).
When you send comments to IBM, you grant IBM a nonexclusive right to use or
distribute your comments in any way it believes appropriate without incurring
any obligation to you.
- If you prefer to send your comments electronically, do either of the
following:
- If you prefer to send your comments by mail, address your comments
to:
IBM Corporation
TPF Systems Information Development
Mail Station P923
2455 South Road
Poughkeepsie, NY 12601-5400
USA
- If you prefer to send your comments by FAX, use this number:
- United States and Canada: 1 + 845 + 432 + 9788
- Other countries: (international code) + 845 + 432 +9788