gtps2m07 | ACF/SNA Data Communications Reference |
This book describes the functions provided for the Systems Network
Architecture (SNA) data communications area.
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 TPF Concepts and Structures for an overview
of the TPF system.
See IBM Systems Network Architecture Concepts and
Products and IBM Systems Network Architecture
Technical Overview for information about SNA concepts and
terminology.
This book is intended for systems programmers who are responsible for SNA
data communications support.
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 ACF/SNA Network Generation, SH31-0131
- TPF C/C++ Language Support User's Guide,
SH31-0121
- TPF Concepts and Structures, GH31-0139
- TPF Data Communications Services Reference,
SH31-0145
- TPF General Macros, SH31-0152
- TPF System Installation Support Reference,
SH31-0149
- TPF Main Supervisor Reference, SH31-0159
- TPF Migration Guide: Program Update Tapes,
GH31-0187
- TPF Operations, SH31-0162
- TPF Program Development Support Reference,
SH31-0164
- TPF System Performance and Measurement
Reference, SH31-0170
- TPF System Generation, SH31-0171
- TPF System Macros, SH31-0151.
- ACF, NCP, ALCI General Information, GH33-7012
- CICS/DOS/VS Intercommunication Facilities
Guide, SC33-0133
- Communications Manager/2 Network Administration
and Subsystem Management Guide, SC31-6168
- Communications Manager/2 Workstation Installation
and Configuration Guide, SC31-7169
- NCP/SSP/EP Resource Definition Reference (order the correct
version and release for your installation)
- NPSI Host Programming, SC30-3502
- NPSI Planning and Installation, SC30-3270
- OS/2 Extended Edition APPC Programming
Reference, S01F-0295
- OS/2 Extended Edition System Administration Guide
for Communications, G01F-0302
- IBM Systems Network Architecture Advanced
Peer-to-Peer Networking Architecture Reference, SC30-3422
- IBM Systems Network Architecture Concepts and
Products, GC30-3072
- IBM Systems Network Architecture Format and Protocol
Reference Manual: Architectural Logic, SC30-3112
- IBM Systems Network Architecture Format and Protocol
Reference Manual: Architecture Logic for LU Type 6.2,
SC30-3269
- IBM Systems Network Architecture LU 6.2
Reference: Peer Protocols, SC31-6808
- IBM Systems Network Architecture Network Product
Formats, LY43-0081
- IBM Systems Network Architecture Technical
Overview, GC30-3073
- IBM Systems Network Architecture Transaction
Programmer's Reference Manual for LU Type 6.2, GC30-3084
- IBM SNA Formats, GA27-3136
- Systems Application Architecture Common Programming
Interface Communications Reference, SC26-4399
- VTAM Network Implementation Guide (order the correct version
and release for your installation)
- VTAM Resource Definition Reference (order the correct version
and release for your installation)
- 3270 Data Stream Programmer's Reference,
GA23-0059
- 3600 Finance Communication System 3614
Programmer's Guide and Reference, GC27-0010
- 3600 Finance Communication System 3624
Programmer's Guide, GC66-0008.
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