AM3270 and TR3271 Configuration and Management Manual Abstract This manual shows you how to configure an AM3270 or TR3271 line and subdevices for use with an HP NonStop™ S-series server or an HP Integrity NonStop™ NS-series server. This manual is written for system managers and operators. Product Version AM3270 G03.00 and TR3271 G03.00 Supported Release Version Updates (RVUs) This manual supports G03.00 and all subsequent G-series RVUs, and H06.
Document History Part Number Product Version Published 142535 AM3270 G03.00 and TR3271 G03.00 August 1998 529993-001 AM3270 G03.00 and TR3271 G03.
AM3270 and TR3271 Configuration and Management Manual Index Figures What’s New in This Manual Manual Information xi Tables xi About This Manual xiii Who Should Use This Manual xiii What’s in This Manual xiii Where to Get More Information xiv Notation Conventions xvii 1. Configuration Quick Start Task Summary 1-1 Assumptions 1-1 Task 1: Add The PROFILE 1-1 Task 2: Add The DEVICE 1-2 Task 3: Start The DEVICE 1-2 Task 4: Add The Subdevices (SU) 1-2 2.
3. Configuring the AM3270 and TR3271 Subsystems Contents 3. Configuring the AM3270 and TR3271 Subsystems Object Hierarchy 3-2 Subdevice Access 3-2 Profile Object Files 3-2 The PAM3PROF PROFILE 3-3 The PTR3PROF PROFILE 3-4 Configuring an AM3270 or TR3271 Line-Handler Process ADD PROFILE Command 3-6 ADD DEVICE Command 3-7 START DEVICE Command 3-9 3-4 4.
Contents 4. SCF Interface to AM3270 and TR3271 (continued) 4.
4. SCF Interface to AM3270 and TR3271 (continued) Contents 4.
Contents 4. SCF Interface to AM3270 and TR3271 (continued) 4.
4. SCF Interface to AM3270 and TR3271 (continued) Contents 4.
4. SCF Interface to AM3270 and TR3271 (continued) Contents 4. SCF Interface to AM3270 and TR3271 (continued) TRACE Command 4-85 Considerations for the TRACE Command 4-85 Command Syntax for the TRACE Command 4-85 Examples of the TRACE Command 4-88 VERSION Command 4-88 Command Syntax for the VERSION Command 4-88 Examples of the VERSION Command 4-89 5.
5. Modifier Profiles (continued) Contents 5. Modifier Profiles (continued) RVIIFNOREAD or EOTIFNOREAD — AM Only 5-13 SLOWPOLLMSG or NOSLOWPOLLMSG — AM Only 5-13 SPEED — AM Only 5-14 SYNCS — AM and TR 5-14 TESTINT— AM and TR 5-14 THRESHOLD — AM and TR 5-15 TIMEOUT — AM and TR 5-15 WACKDELAY — TR Only 5-15 6.
6. Attribute Descriptions for AM3270 and TR3271 (continued) Contents 6. Attribute Descriptions for AM3270 and TR3271 (continued) TIMEOUT 6-12 TRANSLATE 6-12 TRANSPARENT 6-12 TYPE 6-13 WACKDELAY 6-14 WACKIFNOREAD 6-14 XLATEIN 6-14 XLATEOUT 6-15 7. PTrace for AM3270 and TR3271 About PTrace 7-1 Recording and Displaying Trace Data Determining the Subsystem 7-3 PTrace Commands 7-3 Trace Example 7-4 7-1 A.
Index Contents Index Figures Figure 2-1. Figure 2-2. Figure 2-3. Figure 2-4. Figure 4-1. Figure 4-2. Figure 7-1. Typical AM3270 Configuration 2-2 Example of AM3270 Pass-Through Configuration 2-2 TR3271 Process Configuration 2-5 Starting AM3270 and TR3271 DEVICE Objects 2-7 SCF Overview 4-2 AM3270 and TR3271 Object-Type Hierarchy 4-11 Recording and Displaying Trace Data 7-2 Tables Table i. Table ii. Table 3-1. Table 3-2. Table 4-1. Table 4-2. Table 4-3. Table 4-4. Table 4-5. Table 4-6. Table 7-1.
What’s New in This Manual Manual Information AM3270 and TR3271 Configuration and Management Manual Abstract This manual shows you how to configure an AM3270 or TR3271 line and subdevices for use with an HP NonStop™ S-series server or an HP Integrity NonStop™ NS-series server. This manual is written for system managers and operators. Product Version AM3270 G03.00 and TR3271 G03.00 Supported Release Version Updates (RVUs) This manual supports G03.00 and all subsequent G-series RVUs, and H06.
What’s New in This Manual Manual Information AM3270 and TR3271 Configuration and Management Manual—529993-001 xii
About This Manual This manual shows you how to configure an AM3270 or TR3271 line and subdevices for use with a NonStop S-series server or an Integrity NonStop NS-series server. Who Should Use This Manual This manual is primarily for system operators and managers who configure and manage AM3270 and TR3271 subsystems on NonStop S-series servers or networks and on Integrity NonStop NS-series servers or networks.
Where to Get More Information About This Manual Table i. Summary of Contents Section Title This section . . . C SCF Command Summary for TR3271 Summarizes the SCF syntax for TR3271 commands. D Error Messages for AM3270 Describes network-related operator console and file-system error messages for AM3270. E Error Messages for TR3271 Describes network-related operator console and file-system error messages for TR3271.
Where to Get More Information About This Manual Table ii. NonStop S-Series and Integrity NonStop NS-Series Manuals Category Purpose SCF subsystem configuration manuals Describes SCF commands that you use to configure and manage objects in a specific subsystem. HP NonStop™ Open System Management (OSM) manuals and online help OSM manuals and online help provide information about using the OSM package to bring up and maintain NonStop S-series servers and Integrity NonStop NS-series servers.
About This Manual Where to Get More Information the operation of and command syntax for NSKCOM, the NonStop OS command interface to KMSF. • SCF Reference Manual for G-Series RVUs This manual describes the operation of SCF on G-series RVUs and how it is used to configure, control, and inquire about supported subsystems. • System Generation Manual for G-Series RVUs This manual describes how to use the SYSGENR program on G-series RVUs to create a new set of operating system files.
About This Manual • • Notation Conventions Access the main help interface by selecting Download OSM Help from the Help menu on the OSM toolbar. OSM Migration Guide This guide introduces the NonStop OSM Interface. It is intended for anyone who uses OSM to monitor or service an Integrity NonStop NS-series server. It describes OSM requirements; how to migrate from TSM to OSM; and how to install, configure, and start OSM components and processes.
About This Manual General Syntax Notation UPPERCASE LETTERS. Uppercase letters indicate keywords and reserved words; enter these items exactly as shown. Items not enclosed in brackets are required. For example: MAXATTACH lowercase italic letters. Lowercase italic letters indicate variable items that you supply. Items not enclosed in brackets are required. For example: file-name computer type. Computer type letters within text indicate C and Open System Services (OSS) keywords and reserved words.
General Syntax Notation About This Manual … Ellipsis. An ellipsis immediately following a pair of brackets or braces indicates that you can repeat the enclosed sequence of syntax items any number of times. For example: M address-1 [ , new-value ]... [ - ] {0|1|2|3|4|5|6|7|8|9}... An ellipsis immediately following a single syntax item indicates that you can repeat that syntax item any number of times. For example: "s-char..." Punctuation.
Notation for Messages About This Manual !i:i. In procedure calls, the !i:i notation follows an input string parameter that has a corresponding parameter specifying the length of the string in bytes. For example: error := FILENAME_COMPARE_ ( filename1:length , filename2:length ) ; !i:i !i:i !o:i. In procedure calls, the !o:i notation follows an output buffer parameter that has a corresponding input parameter specifying the maximum length of the output buffer in bytes.
Notation for Management Programming Interfaces About This Manual { } Braces. A group of items enclosed in braces is a list of all possible items that can be displayed, of which one is actually displayed. The items in the list might be arranged either vertically, with aligned braces on each side of the list, or horizontally, enclosed in a pair of braces and separated by vertical lines. For example: LBU { X | Y } POWER FAIL process-name State changed from old-objstate to objstate { Operator Request.
About This Manual Change Bar Notation margin of changed portions of text, figures, tables, examples, and so on. Change bars highlight new or revised information. For example: The message types specified in the REPORT clause are different in the COBOL85 environment and the Common Run-Time Environment (CRE). The CRE has many new message types and some new message type codes for old message types. In the CRE, the message type SYSTEM includes all messages except LOGICAL-CLOSE and LOGICAL-OPEN.
1 Configuration Quick Start This section is a configuration quick start for the AM3270 and TR3271 subsystems. This procedure explains how to set up the initial AM3270 or TR3271 processes on a NonStop S-series server or on an Integrity NonStop NS-series server. For an overview of the AM3270 or TR3271 subsystem, see the Section 2, Overview of AM3270 and TR3271.
Configuration Quick Start Task 2: Add The DEVICE You can view the contents of the PROFILE using the INFO PROFILE command. For more details on PROFILE, please refer to Section 3, Configuring the AM3270 and TR3271 Subsystems. Task 2: Add The DEVICE DEVICE is the SCF object name given to the line handler, the process used to control transmission of information on a single communications line. Use the ADD DEVICE command to configure your line handler process with the modifiers in the PROFILE.
2 Overview of AM3270 and TR3271 The AM3270 Access Method supports communications with IBM 3270 terminals that are connected to one or more byte-synchronous 3x74-type cluster controllers. The TR3271 Tributary Access Method supports communications with IBM mainframes where the NonStop S-series server or Integrity NonStop NS-series server appears to be one or more 3270-type terminals connected to one or more byte-synchronous 3x74-type cluster controllers.
AM3270:Typical Configuration Overview of AM3270 and TR3271 AM3270:Typical Configuration Figure 2-1, Typical AM3270 Configuration shows a typical 3270 configuration for an AM3270 line connected to the SWAN concentrator. A program ($SYSTEM.CSSnn.C0039P00) downloads the AM3270 protocol to the Communications Line Interface Protocol (CLIP) in the SWAN concentrator. Figure 2-1.
Overview of AM3270 and TR3271 AM3270:Pass-Through Configuration AM3270 treats a successful SCF CONNECT as a combination of OPEN and READ. File-system requests such as OPEN, READ, and WRITE are not accepted, because all communication between an AM3270 subdevice and a TR3271 subdevice goes through the message system. The following section discusses these programs and interfaces in more detail. For information about specific SCF commands, refer to later sections of this manual.
Overview of AM3270 and TR3271 Overview of TR3271 Communications Subsystem Error Handling in Pass-Through Mode A pass-through subdevice has no application process initiating requests, so PTP must handle errors itself. For PTP, when a request is initiates and completes without error, an error counter is cleared. If the request generates an error report greater than 3 to the subdevice, PTP disables the subdevice. PTP reports the disabled status to the local-system operator console.
Line and Subdevice Configuration Overview of AM3270 and TR3271 Line and Subdevice Configuration All tributary subdevices configured inside the TR3271 line are controlled by the IBM host connected to the multipoint line. Other physical devices (3x74 cluster controllers and their subordinates) present in the multipoint line are directly controlled by the IBM host.
Overview of AM3270 and TR3271 Supported Concentrator Supported Concentrator On G-series systems, the only supported concentrator is the SWAN concentrator. For detailed information on how to configure the SWAN concentrator, refer to the WAN Subsystem Configuration and Management Manual. WAN Subsystem For G-series systems, use SCF to define and start the AM3270/TR3271 line-handler from the WAN subsystem.
Monitoring an AM3270 and TR3271 Subsystem Overview of AM3270 and TR3271 Figure 2-4. Starting AM3270 and TR3271 DEVICE Objects Terminal OBEY File SCF Log File SCP SPI SPI AM3270 or TR3271 Subsystems WAN Subsystem Configuration Database AM/TR LineHandler Device WAN Manager Process Process_Launch _It AM3270 or TR3271 LineHandler Process VST004.vsd The WAN subsystem SCF commands that are relevant to AM3270/TR3271 configuration are described in Section 3, Configuring the AM3270 and TR3271 Subsystems.
Overview of AM3270 and TR3271 Open System Management (OSM) Event Management Service (EMS) The Event Management Service is a standard DSM interface that provides event collection, logging, and distribution facilities. The AM3270/TR3271 subsystem reports events to EMS. AM3270/TR3271 subsystem events are described in the Operator Messages Manual.
3 Configuring the AM3270 and TR3271 Subsystems The SCF objects used in configuration for either AM3270 or TR3271 are: • • PROCESS. Process refers to the AM/TR I/O process. The PROCESS name is the same as the line it controls. DEVICE. Device refers to the AM/TR device/IOP added using WANMgr ADD DEVICE command. All device-specific modifiers are given in the ADD DEVICE command.
Configuring the AM3270 and TR3271 Subsystems Object Hierarchy Object Hierarchy The hierarchy of the object type is: 1. PROCESS. An AM3270 or TR3271 process 2. LINE. A communication line 3. SU. A subdevice A PROCESS controls a LINE. Under any LINE, there are SUs associated with it. Subdevice Access For AM3270, each subdevice corresponds to a physical device (terminal or printer). For TR3271, each subdevice corresponds to a tributary station configured in the TR3271 process.
The PAM3PROF PROFILE Configuring the AM3270 and TR3271 Subsystems Table 3-1. AM3270/TR3271 Object Files Object File Name Profile Name Supported Device $SYSTEM.SYS.PAM3PROF PAM3PROF AM3270 devices $SYSTEM.SYS.PTR3PROF PTR3PROF TR3271 devices The PAM3PROF PROFILE The following profile contains a list of the device-specific modifiers that are used in the AM3270 profile. These are the default settings supplied with the system. If you need to make temporary changes, use SCF commands.
The PTR3PROF PROFILE Configuring the AM3270 and TR3271 Subsystems The PTR3PROF PROFILE The following profile contains a list of the device-specific modifiers that are used in the TR3271 profile. These are the default settings supplied with the system. If you need to make temporary changes, use SCF commands. -> ADD PROFILE $ZZWAN.#PTR3PROF, -> INFO PROFILE $ZZWAN.#PTR3PROF FILE $SYSTEM.SYS00.PTR3PROF WAN MANAGER Info profile \WILLOW.$ZZWAN.#PTR3PROF No devices or processes are using this profile.
Configuring an AM3270 or TR3271 Line-Handler Process Configuring the AM3270 and TR3271 Subsystems Dynamic Changes to the PROFILE You can make dynamic changes to the AM3270 and TR3271 LINE objects and SU objects through the AM3270 or TR3271 SCF subsystems. The AM3270 and TR3271 subsystems support the LOAD LINE command, which causes the data link control (DLC) task to be downloaded to the SWAN concentrator WAN port on the CLIP that the specified LINE is configured to use.
ADD PROFILE Command Configuring the AM3270 and TR3271 Subsystems Table 3-2. WAN Subsystem and AM3270 and TR3271 Subsystem SCF Commands Compared WAN Subsystem Object SCF Command Line-handler DEVICE AM3270 and TR3271 Subsystem Object Linehandler PROCESS LINE SWITCH ✔ TRACE ✔ VERSION ✔ SUBDEVICE ✔ null ✔ * You must use SUB ONLY to delete a line; you cannot delete a line by any other method.
Configuring the AM3270 and TR3271 Subsystems ADD DEVICE Command Example The following command adds the PAM3PROF profile to the WAN subsystem: ADD PROFILE $ZZWAN.#PROFAM3, FILE $SYSTEM.SYS00.PAM3PROF For information about the syntax of these SCF commands, see the ADD command in the WAN Subsystem Configuration and Management Manual. ADD DEVICE Command To create an AM3270/TR3271 line-handler process, use the WAN subsystem SCF ADD DEVICE command.
Configuring the AM3270 and TR3271 Subsystems ADD DEVICE Command obj_file_name is the name of the HP-supplied object file for the specified line type. This will be either $SYSTEM.SYSnn.AM3SOBJ (for AM3270) or $SYSTMEM.SYSnn.TR3SOBJ (for TR3271). line_num is the line number on the selected CLIP to be used by this device. line_num must not have been previously selected for use by another device.
Configuring the AM3270 and TR3271 Subsystems START DEVICE Command START DEVICE Command To start an AM3270/TR3271 line-handler process, use the WAN subsystem SCF START DEVICE command. The START DEVICE command has the following syntax: START DEVICE $ZZWAN.#device_name device_name is the device name of the AM3270/TR3271 line-handler process. Example The following command starts a DEVICE in the WAN subsystem: START DEVICE $ZZWAN.
Configuring the AM3270 and TR3271 Subsystems START DEVICE Command AM3270 and TR3271 Configuration and Management Manual—529993-001 3- 10
4 SCF Interface to AM3270 and TR3271 This section contains: • • • • A description of the features and operation of the Subsystem Control Facility (SCF) A description of the objects on which SCF operates A description of the general format of SCF commands Detailed information about each SCF command: • • • • A description of the command function Considerations you should know before you use the command The command syntax, including the supported object types and object names Command examples Note.
Subsystem Control Point (SCP) SCF Interface to AM3270 and TR3271 Figure 4-1. SCF Overview SCF SCP ($ZNET) AM3270 or TR3271 Command (OBEY) File VST005.vsd SCF automatically opens and closes SCP. In most cases, the default SCP is the only one you will ever need. If you should need to establish an SCF session through a specific SCP other than the default SCP, you can start additional SCPs by using either the SCF RUN command or the TACL RUN command.
SCF Interface to AM3270 and TR3271 Sensitive and Nonsensitive Commands Several commands are available for displaying and changing SCF session parameters. For example, the SYSTEM and VOLUME commands control the default system, volume, and subvolume names used for expanding file names. The OBEY and OUT commands control the files used for command input and display output. The ASSUME command defines a default object to be used when the object is omitted from an SCF command.
SCF Interface to AM3270 and TR3271 States The object name for an SU object usually has two parts: the name of the line to which the SU has been added, and the unique name of the subdevice itself. The subdevice part of the name begins with a pound sign (#) and includes up to seven alphanumeric characters. For example, an SU object might have the name $AMTR.#PC, where $AMTR is the name of the line. There are many other object types and object names used in SCF.
SCF Interface to AM3270 and TR3271 How SCF Works How SCF Works For commands that relate only to the SCF session (such as VOLUME), SCF takes the appropriate action without communicating with SCP. For commands that relate to a subsystem or its objects, SCF translates the command into a formatted message for SCP, which then communicates with the appropriate subsystem to perform the specified task. SCF accepts commands from a terminal, a disk file, or an application process.
SCF Interface to AM3270 and TR3271 Setting the Initial Input Source Setting the Initial Input Source To specify an initial input source for an SCF session, use the IN option of the RUN command. You can specify a terminal (identified by its logical-device name) or a disk file. For example, the following TACL RUN command initiates SCF and directs it to read commands from a disk file named $DATA.SCF.
SCF Interface to AM3270 and TR3271 General Command Format General Command Format An SCF command always begins with a keyword identifying the command (such as START, VOLUME, or TRACE). If the command applies only to the current SCF session, the keyword is followed immediately by whatever additional parameters are required to specify the action to be taken by SCF. For example, the SYSTEM command can be entered as SYSTEM \newsys, where newsys is the name of the system that is to become the default system.
SCF Interface to AM3270 and TR3271 Configuration Prerequisites In addition to getting general SCF information, you can obtain information about your particular subsystem. Note. The online help facility is interactive; it cannot be invoked from a command file.
SCF Interface to AM3270 and TR3271 Object-Type Hierarchy Object-Type Hierarchy The AM3270 and TR3271 object types supported by SCF, PROCESS, LINE, and SU are in hierarchical order. The VERSION command implicitly assumes the null object type. The NAMES command requires no object type. The hierarchy is important when issuing commands to the AM3270 or TR3271 subsystems for processing.
SCF Interface to AM3270 and TR3271 null TR3271 Object Types The null object is not an actual object type. The term null is used to represent the lack of a specified object. Any SCF command that supports the null object type is issued without the specification of an object type. Commands support the null object type if an object type is irrelevant (as is the case with the VERSION command), or if they refer to a collection of objects (as is the case with the NAMES command).
Summary States SCF Interface to AM3270 and TR3271 null The null object is not an actual object type. The term null is used to represent the lack of a specified object. Any SCF command that supports the null object type is issued without the specification of an object type. Commands support the null object type if an object type is irrelevant (as is the case with the VERSION command), or if they refer to a collection of objects (as is the case with the NAMES command).
Wild-Card Support SCF Interface to AM3270 and TR3271 Wild-Card Support The wild-card characters are the asterisk (*) and the question mark (?). * denotes any number of characters; ? denotes any single character. When you use wild-card notation, the first character of the name must be an alphabetic character, *, or ?. The second, and any subsequent characters, can be any alphabetic or numeric character, an *, or a ?. For a more complete description of wild-card notation, see the TACL Reference Manual.
Commands Supported by AM3270 SCF Interface to AM3270 and TR3271 Commands Supported by AM3270 This manual describes only those SCF commands that are supported by the AM3270 or the TR3271 subsystems. Table 4-3 shows the SCF commands supported by AM3270. For information about commands supported by other subsystems, see the SCF manual for the specific subsystem.
Sensitive Commands SCF Interface to AM3270 and TR3271 Table 4-3. AM3270 Commands and Object Types Command LINE SU STATS X X STATUS X X STOP X X SWITCH X TRACE X VERSION PROCESS X X null X * You must use SUB ONLY if you delete a line; you cannot delete the line itself. Sensitive Commands Many commands in this section are designated as sensitive commands. A sensitive command is one that can be issued only by a user with super-group access (that is, SUPER.
SCF Interface to AM3270 and TR3271 ABORT Command ABORT Command The ABORT command halts the operation of objects as quickly as possible—only enough processing is done to ensure the security of the subsystem. The object is left in the STOPPED summary state. This is a sensitive command. Considerations for the ABORT Command • • • • • • • • For more controlled termination of lines and subdevices, use the STOP command. To initiate the operation of lines and subdevices, use the START command.
SCF Interface to AM3270 and TR3271 Examples of the ABORT Command LINE line-name | SU su-name designates the line or subdevice to be aborted. If you omit line-name or su-name, the assumed object is aborted. The objects that you can abort are lines and subdevices. SUB [ ONLY | ALL ] directs the command to a set of subordinate objects. ONLY specifies that only the subordinate objects are affected. ALL specifies that the named object and all the subordinate objects are affected.
SCF Interface to AM3270 and TR3271 Command Syntax for the ADD Command do not have default values; these attributes must be specified in the ADD command. • If you have added and started an SU and realize that you have made an error, use the STOP command to stop the SU, and then use the ALTER command. Once you fix the problem, use the START command to restart the SU. • The names #ZSPI and #DEBUG are reserved names and should not be used as subdevice (SU) names.
SCF Interface to AM3270 and TR3271 ALTER Command The following AM3270 command adds an SU named $AM3270.#TERM and uses the INFO command to verify that the changes were implemented: ADD SU $AM3270.#TERM, ADDRESS (0,1), PROTOCOL ITI, & TYPE (6,6), RECSIZE 80 INFO SU $AM3270.#TERM, DETAIL The following series of commands adds an SU with the PTP protocol, alters the RECSIZE of the SU, then lets you verify that your change was made: ADD SU $AM3270.
SCF Interface to AM3270 and TR3271 Command Syntax for the ALTER Command Command Syntax for the ALTER Command The ALTER command has the following syntax: ALTER [ / OUT file-spec / ] [ LINE line-name | SU su-name ] { , attribute-spec }... OUT file-spec causes any SCF output generated for this command to be directed to the specified file. LINE line-name | SU su-name designates the line or subdevice whose attributes that you want to alter.
SCF Interface to AM3270 and TR3271 Examples of the ALTER Command The attribute-spec for an SU object is one of the following attribute name and value combinations. The attributes are listed alphabetically and described in Section 6, Attribute Descriptions for AM3270 and TR3271.
SCF Interface to AM3270 and TR3271 Example of the BOOT Command LINE line-name designates the line affected by the BOOT command. If you omit the line-name, SCF alters the attributes of the assumed line. Example of the BOOT Command The following command boots a programmable controller associated with line $AM3270: BOOT LINE $AM3270 CONNECT Command The CONNECT command connects an AM3270 pass-through subdevice to a TR3271 pass-through subdevice.
SCF Interface to AM3270 and TR3271 Examples of the CONNECT Command OUT file-spec causes any SCF output generated for this command to be directed to the specified file. SU su-name, su-name designates the subdevices affected by the CONNECT command. If you omit the su-name, SCF connects the assumed AM3270 subdevice. Examples of the CONNECT Command The following command connects the subdevice $AM3270.#TERM0 to the TR3271 subdevice \CS5.$TR3271.#TERM0: CONNECT SU $AM3270.#TERM0,\CS5.$TR3271.
SCF Interface to AM3270 and TR3271 Examples of the DELETE Command LINE line-name | SU su-name designates the subdevices or the line whose subdevices are to be deleted. If you omit line-name or su-name, SCF deletes the assumed object. SUB ONLY directs the command at a subordinate object. ONLY specifies that only the subordinate objects are affected. You must use the SUB ONLY keywords with lines and only with lines.
SCF Interface to AM3270 and TR3271 Examples of the DISCONNECT Command SU su-name, su-name designates the subdevices to be disconnected from each other. If you omit su-name, SCF disconnects the assumed object. Examples of the DISCONNECT Command The following command disconnects an AM3270 subdevice from a remote TR3271 subdevice: DISCONNECT SU $AM3270.#TERM0, \CS5.$TR3271.#TERM0 The following command disconnects an AM3270 subdevice from a local TR3271 subdevice: DISCONNECT SU $AM3270.#TERM0,$TR3271.
Display for the INFO LINE Command SCF Interface to AM3270 and TR3271 SUB [ ONLY | ALL | NONE ] directs the command to a set of subordinate objects. ONLY specifies that only the subordinate objects are affected. ALL specifies that the named object and all the subordinate objects are affected. NONE specifies that none of the subordinate objects are affected. If you omit a value for SUB, ALL is assumed.
SCF Interface to AM3270 and TR3271 Display for the INFO LINE Command The format of the display for the INFO LINE command with the DETAIL option is: AM3270 Detailed info line \CS5.$AM3270 *Autoload.......... ON *Bcctype........... CRC16 *Consolemsg........ ON *Controlrts........ OFF *Confirm Write..... OFF *Controlset........ EBCDIC *Droprts........... OFF Opclass........... BISYNC *EOT if no read.... OFF *Pace.............. 0 *No Poll after WACK OFF *Polltype.......... GENERAL *Pollint........... 00:00.
Display for the INFO SU Command SCF Interface to AM3270 and TR3271 Display for the INFO SU Command The format of the display for an SU object without the DETAIL option is given below. Alterable attributes are preceded by an asterisk. The attributes are listed alphabetically and described in Section 6, Attribute Descriptions for AM3270 and TR3271. AM3270 INFO SU Name $AM3270.
SCF Interface to AM3270 and TR3271 LOAD Command LOAD Command The LOAD command is used to download the microcode into the CLIP. The name of the microcode file is assumed to be known to the AM3270 subsystem, and the file name can be modified using the ALTER command. This is a sensitive command. Considerations for the LOAD Command • • • • • The SUB option and SEL option are not supported. The LOAD command is valid only when the LINE is in the STOPPED summary state.
SCF Interface to AM3270 and TR3271 NAMES Command NAMES Command The NAMES command returns a list of the subordinate object types and names for the specified object. Considerations for the NAMES Command • • The SEL option is not supported. Wild cards are not supported at the subdevice level.
SCF Interface to AM3270 and TR3271 PRIMARY Command AM3270 Names -- SU $AM3270.#TERM1 PRIMARY Command The PRIMARY command is used only when AM3270 is running as a NonStop process pair. It causes the backup CPU to become the primary CPU and the primary CPU to become the backup CPU. This is a sensitive command. Considerations for the PRIMARY Command • • • There is no summary state change associated with the PRIMARY command.
SCF Interface to AM3270 and TR3271 START Command START Command The START command initiates the operation of an object. The successful completion of the START command leaves the object in the STARTED summary state. This is a sensitive command. Considerations for the START Command • • • For a given LINE object, no SU object can enter the STARTED summary state until the LINE object has entered the STARTED summary state.
SCF Interface to AM3270 and TR3271 Examples of the START Command Examples of the START Command The following command starts the line $AM3270. START LINE $AM3270 The following command starts the subdevice $AM3270.#TERM1: START SU $AM3270.#TERM1 STATS Command The STATS command displays statistical information for the specified object. For each statistical counter returned, an associated timestamp is also returned indicating when the sample was taken. Note.
Display for the STATS LINE Command SCF Interface to AM3270 and TR3271 RESET is a sensitive option. That is, it can be specified in a STATS command only by a user with super-group access, the owner of a subsystem, or a member of the same group as the owner of the subsystem. The owner of the subsystem is the user who started the subsystem or any user whose application ID is the same as the server ID. SUB [ ONLY | ALL | NONE ] directs the command at a set of subordinate objects.
SCF Interface to AM3270 and TR3271 Display for the STATS LINE Command The statistics are described below in the order in which they appear on the screen. The information listed in the statistics display applies only after the last RESET and/or cold start. ResetTime is the date and time that the last reset operation was performed. SampleTime is the time at which this sample of statistics was taken.
SCF Interface to AM3270 and TR3271 Display for the STATS LINE Command ERRORS (level-2 error statistics from the CLIP) Errors is the total number of errors that occurred at level 2 for the specified line. NAKs is the number of negative acknowledgments (NAKs) that were received by the AM3270 subsystem on the specified line. BCC Error is the number of Block Check Character (BCC) errors that occurred at level 2 for the specified object. This is a combination of LRC and CRC errors received.
Display for the STATS SU Command SCF Interface to AM3270 and TR3271 Invalid Responses is the number of invalid text messages received. Misc is the number of unknown errors (none of the above Level-2 Error Statistics). The remainder of the STATS LINE display shows the number of messages sent and received (refers to the size of the messages): Less Than 256 Bytes Sent is the number of messages less than 256 bytes long that were sent by the AM3270 subsystem to the specified line.
SCF Interface to AM3270 and TR3271 Examples of the STATS Command ResetTime is the time at which the statistics were last reset. SampleTime is the time at which this sample of statistics was taken. This time indicates the end of the sample period. Name is the subdevice name. Sent is the number of messages that were sent by the subsystem to the specified subdevice. Rcvd is the number of messages that were received by the subsystem from the specified subdevice.
SCF Interface to AM3270 and TR3271 Command Syntax for the STATUS Command Command Syntax for the STATUS Command The STATUS command has the following syntax: STATUS [ / OUT file-spec / ] [ LINE line-name | SU su-name ] [ , DETAIL ] [ , SUB [ ONLY | ALL | NONE ] ] [ , SEL [ STARTED | STOPPED ] ] OUT file-spec causes any SCF output generated for this command to be directed to the specified file. LINE line-name | SU su-name designates the line or subdevice whose status information is to be displayed.
SCF Interface to AM3270 and TR3271 Display for the STATUS LINE Command Display for the STATUS LINE Command The display for a LINE object without the DETAIL option is given below. The attributes are listed alphabetically and described in Section 6, Attribute Descriptions for AM3270 and TR3271. AM3270 STATUS LINE Name $AM3270 State STARTED I/O ADDR(p) I/O ADDR(b) 6,0,%35,%0 5,0,%31,%0 LDEV 032 PPID BPID 06,32 05,32 Name is the name of the LINE object. State is the summary state of the LINE object.
SCF Interface to AM3270 and TR3271 Display for the STATUS LINE Command The display for a LINE object with the DETAIL option has the following format. Alterable attribute are preceded by an asterisk. AM3270 DETAILED STATUS LINE $AM3270 State........... PPID............ Path............ I/O ADDR(P)..... CONMgr Name..... Preferred IP.... Alternate IP.... Total SU........ *Debug........... STARTED Ldev............ 6,32 BPID............ B CMG Ldev........ 6,0,%35,%0 I/O ADDR(B)..... $ZZW03 Track Id........
Display for the STATUS SU Command SCF Interface to AM3270 and TR3271 Track Id is the unique, six character configuration track ID that identifies the SWAN concentrator to the WAN subsystem. Track Id is case sensitive. Preferred IP is the IP address assigned to path A of the CLIP used by AM3270. Alternate IP is the IP address assigned to path B of the CLIP used by AM3270. Total SU is the total number of subdevices on the line. SU Opened is the number of subdevices opened.
SCF Interface to AM3270 and TR3271 Display for the STATUS SU Command The display for an SU object with the DETAIL option has the following format: AM3270 Detailed Status SU Name............. $AM3270.#TERM1 State............. STARTED Status........... %0000000 LastError......... 0 Flags............ %0000000 SDN............... 1 Name is the name of the AM3270-queried subdevice. State is the current summary state of the queried subdevice.
SCF Interface to AM3270 and TR3271 Bit (continued) Meaning (continued) 13 Not used. 14 Internal use only. 15 Internal use only. Display for the STATUS SU Command SDN is the number of the subdevice. The next portion of the STATUS SU, DETAIL display appears when the connection is active. The STATUS SU, DETAIL display can appear in three different forms.
SCF Interface to AM3270 and TR3271 Examples of the STATUS Command DA is the device address of the connected TR3271 subdevice. This field applies to PTP subdevices only. Examples of the STATUS Command The following command displays the status of the subdevice $AM3270.#TERM1: STATUS SU $AM3270.
SCF Interface to AM3270 and TR3271 Command Syntax for the STOP Command Command Syntax for the STOP Command The STOP command has the following syntax: STOP [ / OUT file-spec / ] [ LINE line-name | SU su-name ] [ , SUB [ ONLY | ALL | NONE ] OUT file-spec causes any SCF output generated for this command to be directed to the specified file. LINE line-name | SU su-name designates the line or subdevice to be stopped. If you omit the line-name or suname, the assumed object is stopped.
SCF Interface to AM3270 and TR3271 SWITCH Command SWITCH Command The SWITCH command causes a backup path to become the primary path and the primary path to become the backup path. This is a sensitive command. Considerations for the SWITCH Command • • The SUB and SEL options are not supported. For details about the different effects of the SWITCH command, refer to the SCF Reference Manual for G-Series RVUs or the SCF Reference Manual for the Storage Subsystem.
TRACE Command SCF Interface to AM3270 and TR3271 TRACE Command The TRACE command requests the capture of target-defined data items, alters trace parameters, and ends tracing. This is a sensitive command. An SCF trace produces a trace file that can be displayed using the commands available in the PTrace utility. The trace file is created by SCF. The PTrace utility is described in Section 7, PTrace for AM3270 and TR3271.
SCF Interface to AM3270 and TR3271 Command Syntax for the TRACE Command process continues. However, in this case, most events being traced before the process switch are no longer traced because the process being traced is no longer the primary process. If you omit BACKUP, SCF assumes the primary process. COUNT count specifies the number of trace records that you want to capture. count is an integer in the range -1 through 32767.
Examples of the TRACE Command SCF Interface to AM3270 and TR3271 WRAP specifies that when the trace file end-of-file mark is reached, trace data will wrap around to the beginning of the file and overwrite any data there. Table 4-4 lists and defines the keywords and mask bits for the LINE object. Table 4-4. Keywords and Mask Bits for the TRACE LINE command Keyword Mask Meaning ALL 0-31 Traces all items. L0 0 Communications Access Process (CAP) request tracing. L1 1 CAP level-1 tracing.
SCF Interface to AM3270 and TR3271 VERSION Command The following command stops the trace of the line $AM3270: TRACE LINE $AM3270, STOP VERSION Command The VERSION command displays the version level of the specified object. Command Syntax for the VERSION Command The VERSION command has the following syntax: VERSION [ / OUT file-spec / ] [ LINE
Examples of the VERSION Command SCF Interface to AM3270 and TR3271 Guardian - T9050 - (G04) T9050 shows the version number of the NonStop OS. The G04 is an internal version number. SCF Kernel - T9082G02 - (31MAY97) (31MAY97) T9082G02 shows the product and version number of the SCF kernel. 31MAY97 is the VPROC (version process) date. 31MAY97 is the binder stamp date. AM3270 PM - T9325G03 - (15JUL97) (0.0) T9325G03 shows the product and version number of the AM3270 SCF Product Module.
Sensitive Commands SCF Interface to AM3270 and TR3271 HELP TR3271 error The commands supported by the TR3271 subsystem and the object types they apply to are listed in Table 4-5. Table 4-5.
SCF Interface to AM3270 and TR3271 ABORT Command The following SCF commands for TR3271 are sensitive: ABORT LOAD ADD PRIMARY ALTER START BOOT STOP CONNECT SWITCH DELETE TRACE DISCONNECT The remaining SCF commands are nonsensitive. You can typically use nonsensitive commands to determine the status of SCF or to display information about an object. Anyone can use nonsensitive commands.
SCF Interface to AM3270 and TR3271 Command Syntax for the ABORT Command If the DISCONNECT command fails because the AM3270 subdevice already is in the STOPPED summary state, the ABORT command finishes processing successfully, but with the connection broken at the TR3271 end. In this case, there is a risk of losing data from the AM3270 PTP subdevice because it considers the connection to exist.
SCF Interface to AM3270 and TR3271 ADD Command ADD Command The ADD command defines an object to the subsystem. Objects are in the STOPPED summary state after being added. This is a sensitive command. Considerations for the ADD Command • • • • • • • • • • The SEL and LIKE options are not supported. You cannot use the ADD command to add an TR3271 line. Use the SCF ADD DEVICE command. Wild cards are not supported at the subdevice level.
SCF Interface to AM3270 and TR3271 Examples of the ADD Command attribute-list is a specification of an attribute and a value to be assigned to that attribute. The attribute-list for an SU object is one of the following attribute name and value combinations. Note that TRANSPARENT is the only optional attribute. The attributes are listed alphabetically and described in detail in Section 6, Attribute Descriptions for AM3270 and TR3271.
SCF Interface to AM3270 and TR3271 ALTER Command ALTER Command The ALTER command changes the values of the attributes of an existing object. This command changes only the specified attributes of the target object. This is a sensitive command. Considerations for the ALTER Command • • • • • • The SEL and LIKE options are not supported. Wild cards are not supported at the subdevice level. There are no summary state changes associated with the ALTER command.
SCF Interface to AM3270 and TR3271 Examples of the ALTER Command LINE line-name | SU su-name designates the line or subdevice whose attributes you want to alter. If you omit the line-name or su-name, SCF alters the attributes of the assumed line or subdevice. attribute-spec is a specification of an attribute and a value to be assigned to that attribute. The attribute-spec for a LINE object is one of the following attribute name and value combinations.
SCF Interface to AM3270 and TR3271 BOOT Command BOOT Command The BOOT command prepares a programmable controller for loading. The specified object must be in the STOPPED summary state when this command is issued. The line is left in the STOPPED summary state after the command has finished processing. This is a sensitive command. Considerations for the BOOT Command • • • This command resets Communications Line Interface Processor (CLIP) software. The SUB option and SEL option are not supported.
SCF Interface to AM3270 and TR3271 CONNECT Command CONNECT Command The CONNECT command connects a TR3271 pass-through subdevice to an AM3270 pass-through subdevice. A pass-through subdevice can be added anytime, but is not available for message transfer until a CONNECT command is executed. This is a sensitive command. Considerations for the CONNECT Command • • An SU object must be in the STARTED summary state before it can be connected.
SCF Interface to AM3270 and TR3271 Example of the CONNECT Command Example of the CONNECT Command The following command connects the subdevice $TR3271.#TERM1 to the AM3270 subdevice $AM3270.#TERM2: CONNECT SU $TR3271.#TERM1, \SYS06.$AM3270.#TERM2 DELETE Command The DELETE command removes objects from the subsystem. Only SU objects that were added with the ADD command can be deleted. This is a sensitive command.
SCF Interface to AM3270 and TR3271 Examples of the DELETE Command Examples of the DELETE Command The following command deletes the subdevices on the line $TR3271 (but does not delete the line itself): DELETE LINE $TR3271, SUB ONLY The following command deletes the subdevice $TR3271.#TERM: DELETE SU $TR3271.#TERM DISCONNECT Command The DISCONNECT command breaks the connection between a TR3271 pass-through subdevice and an AM3270 pass-through subdevice.
SCF Interface to AM3270 and TR3271 INFO Command The following command disconnects an AM3270 subdevice from a local TR3271 subdevice: DISCONNECT SU $AM3270.#TERM0,$TR3271.#TERM028 INFO Command The INFO command displays the current attribute values for the specified objects. Considerations for the INFO Command • • The SEL option, DEFAULT option, and attribute-name option are not supported. Wild cards are not supported at the subdevice level.
SCF Interface to AM3270 and TR3271 Display for the INFO LINE Command Display for the INFO LINE Command The format of the display for the INFO LINE command without the DETAIL option is: TR3271 INFO LINE Name $TR3271 *Program Name $SYSTEM.TR3271.C0040P00 Name is the name of the LINE object. Program Name is the name of the program file.
Display for the INFO LINE Command SCF Interface to AM3270 and TR3271 The format of the display for the INFO LINE command with the DETAIL option is: TR3271 DETAILED INFO LINE \A17.$TR3271 *Bcctype.......... *Controlrts....... *Debug............ *Initstatus....... *Multiblock....... *Opclass.......... *Retries.......... *Testint.......... *Timeout.......... *Transparent...... *Program..........
Display for the INFO SU Command SCF Interface to AM3270 and TR3271 Display for the INFO SU Command The format of the display for an SU object without the DETAIL option is given below. Alterable attributes are preceded by an asterisk. The attributes are listed alphabetically and described in Section 6, Attribute Descriptions for AM3270 and TR3271. TR3271 INFO SU Name $TR3271.
SCF Interface to AM3270 and TR3271 LOAD Command LOAD Command The LOAD command is used to download the microcode into the CLIP. The name of the microcode file is assumed to be known to the TR3271 subsystem, and the file name can be modified using the ALTER command. This is a sensitive command. Considerations for the LOAD Command • • • • • The SUB and SEL options are not supported. The LOAD command is valid only when the LINE object is in the STOPPED summary state.
SCF Interface to AM3270 and TR3271 NAMES Command NAMES Command The NAMES command returns a list of the subordinate object types and names for the specified object. Considerations for the NAMES Command • • The SEL option is not supported. Wild cards are not supported at the subdevice level.
PRIMARY Command SCF Interface to AM3270 and TR3271 TR3271 NAMES SU $TR3271.#TERM1 $TR3271.#TERM2 PRIMARY Command The PRIMARY command is used only when TR3271 is running as a NonStop process pair. It causes the backup CPU to become the primary CPU and the primary CPU to become the backup CPU. This is a sensitive command. Considerations for the PRIMARY Command • • • There is no summary state change associated with the PRIMARY command.
SCF Interface to AM3270 and TR3271 START Command START Command The START command initiates the operation of an object. The successful completion of the START command leaves the object in the STARTED summary state. This is a sensitive command. Considerations for the START Command • • For a given LINE object, no SU object can enter the STARTED summary state until the LINE object has entered the STARTED summary state.
SCF Interface to AM3270 and TR3271 STATS Command The following command starts the subdevice $TR3271.#TERM1: START SU $TR3271.#TERM1 STATS Command The STATS command displays statistical information for the specified object. For each statistical counter returned, an associated timestamp is also returned indicating when the sample was taken. Note. To issue the STATS command, you must first know the name of the line or subdevice.
Display for the STATS LINE Command SCF Interface to AM3270 and TR3271 The owner of the subsystem is the user who started the subsystem or any user whose application ID is the same as the server ID. SUB [ ONLY | ALL | NONE ] directs the command at a set of subordinate objects. ONLY specifies that only the subordinate objects are affected. ALL specifies that the named object and the subordinate objects are affected. NONE specifies that none of the subordinate objects are affected.
SCF Interface to AM3270 and TR3271 Display for the STATS LINE Command ResetTime is the date and time that the last reset operation was performed. SampleTime is the time at which this sample of statistics was taken. CLB Level Total Frames is the number of CIU-to-LIU bus (CLB) frames that were sent from and received by the TR3271 subsystem for the specified line. BCC Error is the number of Block Check Character (BCC) errors that occurred at the CLB level for the specified line.
SCF Interface to AM3270 and TR3271 Display for the STATS LINE Command ERRORS (level-2 error statistics) Errors is the total number of all line related errors, protocol errors, and buffer overruns that occurred at level 2 for the specified line. NAKs is the number of negative acknowledgments (NAKs) that were received by the TR3271 subsystem on the specified line. BCC Error is the number of Block Check Character (BCC) errors that occurred at level 2 for the specified object.
Display for the STATS SU Command SCF Interface to AM3270 and TR3271 Invalid Responses is the number of invalid text messages that were received. Misc is the number of unknown errors (none of the above level-2 error statistics). The remainder of the STATS LINE display shows the number of messages sent and received (refers to the size of the messages). Less Than 256 Bytes Sent is the number of messages, less than 256 bytes long, that were sent by the TR3271 subsystem to the specified line.
SCF Interface to AM3270 and TR3271 Examples of the STATS Command ResetTime is the time at which the statistics were last reset. SampleTime is the time at which this sample of statistics was taken. This time indicates the end of the sample period. Name is the subdevice name. Messages Sent is the number of messages that were sent by the subsystem to the specified subdevice. Messages Rcvd is the number of messages that were received by the subsystem from the specified subdevice.
SCF Interface to AM3270 and TR3271 STATUS Command STATUS Command The STATUS command displays status information about an object, such as the dynamic summary state, the last error, and modifiable values of the specified object. It also displays specific subsystem attributes and values. Considerations for the STATUS Command • • Wild cards are not supported at the subdevice level. If the SEL option is specified, object-type can be LINE or SU.
SCF Interface to AM3270 and TR3271 Display for the STATUS LINE Command SEL [ STARTED | STOPPED ] directs the command only at objects in the specified state. Valid states are STARTED and STOPPED. Display for the STATUS LINE Command The display for a LINE object without the DETAIL option is given below: TR3271 STATUS LINE Name $TR3271 State STARTED I/O ADDR(P) I/O ADDR(B) 6,0,%35,%0 5,0,%31,%0 LDEV 32 PPID 6,32 BPID 5,32 Name is the name of the LINE object.
SCF Interface to AM3270 and TR3271 Display for the STATUS LINE Command The display for a LINE object with the DETAIL option has the following format. Alterable attributes are preceded by an asterisk. TR3271 DETAILED STATUS LINE $TR3271 State........... PPID............ Path............ I/O ADDR(P).... CONMgr Name..... Preferred IP.... Alternate IP.... Total SU........ *Debug........... STARTED Ldev............ 6,32 BPID............ B CMG Ldev........ 6,0,%35,%0 I/O ADDR(B)..... $ZZW03 Track Id........
Display for the STATUS SU Command SCF Interface to AM3270 and TR3271 Track Id is the unique, six character configuration track ID that identifies the SWAN concentrator to the WAN subsystem. Track Id is case sensitive. Preferred IP is the IP address assigned to path A of the CLIP used by TR3271. Alternate IP is the IP address assigned to path B of the CLIP used by TR3271. Total SU is the total number of subdevices on the line. SU Opened is the number of subdevices opened.
SCF Interface to AM3270 and TR3271 Display for the STATUS SU Command The display for an SU object with the DETAIL option has the following format: TR3271 DETAILED STATUS SU Name............. $TR3271.#TERM2 State............. STARTED IBM Status/Sense. %0000000 LastError......... 0 Flags............ %0000002 SDN............... 2 Name is the name of the TR3271 subdevice. State is the current summary state of the subdevice. IBM Status/Sense is the IBM status/sense word.
SCF Interface to AM3270 and TR3271 Bit (continued) Meaning (continued) 13 Not used. 14 Internal use only. 15 Internal use only. Display for the STATUS SU Command SDN is the number of the subdevice. The STATUS SU, DETAIL display can appear in three different forms.
SCF Interface to AM3270 and TR3271 Examples of the STATUS Command Examples of the STATUS Command The following command displays the status of the subdevice $TR3271.#TERM1: STATUS SU $TR3271.
SCF Interface to AM3270 and TR3271 Examples of the STOP Command OUT file-spec causes any SCF output generated for this command to be directed to the specified file. [ LINE line-name | SU su-name ] designates the line or subdevice to be stopped. If you omit the line-name or suname, the assumed object is stopped. SUB [ ONLY | ALL | NONE ] directs the command at a set of subordinate objects. ONLY specifies that only the subordinate objects are affected.
Example of the SWITCH Command SCF Interface to AM3270 and TR3271 OUT file-spec causes any SCF output generated for this command to be directed to the specified file. LINE line-name designates the line to be switched. If you omit line-name, SCF switches the assumed line. PATH { A | B | a | b } causes the specified line or process to switch to the specified path.
SCF Interface to AM3270 and TR3271 Command Syntax for the TRACE Command OUT file-spec causes any SCF output generated for this command to be directed to the specified file. LINE line-name designates the line to be traced. If you omit line-name, SCF traces the assumed line. STOP [ , BACKUP ] discontinues the trace currently in progress. If you specify BACKUP, SCF stops the trace of the backup process only. BACKUP specifies that the backup process should receive the trace request.
Command Syntax for the TRACE Command SCF Interface to AM3270 and TR3271 { keyword } { (keyword [ , keyword ]...) } { number } { (number [ , number ]... ) } keyword is subsystem-specific. See Table 4-6 for a list of the keywords that can be used with TR3271. number is the numeric value represented by a keyword. TO file-spec specifies the file to which SCF writes trace information. SCF purges any old data before it initiates a trace.
Examples of the TRACE Command SCF Interface to AM3270 and TR3271 Table 4-6. Keywords and Mask Bits for the TRACE LINE Command (page 2 of 2) Keyword Mask Meaning CLIPL4 23 CLIP level-4 tracing . CLIPREQ 25 CLIP request tracing . CLIPCTLI 28 CLIP control-input tracing . CLIPCTLO 29 CLIP control-output tracing . Note. Trace options can be specified as either keywords or corresponding numeric values. SCF accepts a combination of keywords and numeric values within a TRACE command.
SCF Interface to AM3270 and TR3271 Examples of the VERSION Command The display for a VERSION command without the DETAIL option has the following format: VERSION \SYS6.$TR32A: TR3270 - T9372G03 - 15JUL97 - 15JUL97 The display for a VERSION command with the DETAIL option has the following format: Detailed VERSION \SYS6.$TR32A System \SYS6 TR3271 - T9372G03 - 15JUL97 - 15JUL97 Guardian - T9050 - (G04) SCF Kernel - T9082G02 - (31MAY97) (31MAY97) TR3271 PM - T9326G03 - (15JUL97) (0.
SCF Interface to AM3270 and TR3271 Examples of the VERSION Command AM3270 and TR3271 Configuration and Management Manual—529993-001 4- 90
5 Modifier Profiles This subsection describes all modifiers contained in the AM3270/TR3271 profiles. For detailed information about using SCF to alter the default values for the duration of a current session, refer to Section 4, SCF Interface to AM3270 and TR3271. For detailed information on permanently altering the modifier default values contained in the profiles or creating a new profile, refer to the WAN Subsystem Configuration and Management Manual.
CLBRETRIES — AM and TR Modifier Profiles CLBRETRIES — AM and TR Application: All Cluster Controllers (AM), SWAN Concentrator (TR) Default: 3 Units: na Range: 0 through 15 SCF Equivalent: none This modifier specifies the number of retries for CAPCLIP requests between the IOP and the CLIP. It does not affect the cluster controllers on a multipoint line. The default value allows optimum resource use. A larger value may result in excessive retries.
CSMLDEV — AM and TR Modifier Profiles CSMLDEV — AM and TR Application: none Default: 0 Units: na Range: na SCF Equivalent: none Do not use this modifier. CRC16 — AM and TR Application: All Cluster Controllers (AM), SWAN Concentrator (TR) Default: CRC16 Units: na Range: na SCF Equivalent: BCCTYPE This modifier specifies the type of block-check character algorithm used, that is the error detection modifier typically used for EBCDIC code transmissions. CRC16 is a 2byte sequence.
EBCDIC or ASCII — AM and TR Modifier Profiles EBCDIC or ASCII — AM and TR Application: All Cluster Controllers (AM), SWAN Concentrator (TR) Default: EBCDIC Units: na Range: na SCF Equivalent: CHARSET for AM3270 and CHARACTERSET for TR3271 The EBCDIC or ASCII modifier specifies the transmission code. Alternate choice is ASCII. When specifying ASCII transmission, you must also specify LRC8.
INITSTATUS — TR Only Modifier Profiles • • • %20—Send an IR status to the host. This prevents the host andTR3271 from entering a SELCT-WACK loop when TR3271 is brought up and the host selects the device before it has been opened. %177776—Send no response to SELECTs and send an EOT to POLLs. %177777—Send an ACK to SELECTs and send an EOT to POLLs. If data arrives, send an ACK, discard data, and log error message 112.
INTERFACELEVEL — AM and TR Modifier Profiles INTERFACELEVEL — AM and TR Application: SWAN Concentrator Default: 1 Units: na Range: na SCF Equivalent: none This modifier specifies the CLIP interface level which is supplied to the CONMgr while downloading the modules. It must be set to the default value of 1. This modifier is needed for compatibility purposes: do not change it.
NOCLEARCA or CLEARCA — AM and TR Modifier Profiles NOCLEARCA or CLEARCA — AM and TR Application: All Cluster Controllers (AM), SWAN Concentrator (TR) Default: NOCLEARCA for AM, CLEARCA for TR Units: na Range: na SCF Equivalent: [NO] DROPRTS The NOCLEARCA modifier specifies that the request-to-send signal is not dropped when switching from a write to a read operation.
NODROPRTS or DROPRTS — AM and TR Modifier Profiles NODROPRTS or DROPRTS — AM and TR Application: All Cluster Controllers (AM), SWAN Concentrator (TR) Default: NODROPRTS Units: na Range: na SCF Equivalent: same name This modifier specifies that the request-to-send signal is not dropped when switching from a write to a read operation. (Used in a constant carrier, continuous carrier, or point-to-point connection.
NOREADMODAFTERPOLL or READMODAFTERPOLL —TR Only Modifier Profiles NOREADMODAFTERPOLL or READMODAFTERPOLL —TR Only Application: All tributary programs using TR Default: NOREADMODAFTERPOLL Units: na Range: na SCF Equivalent: none The NOREADMODAFTERPOLL modifier specifies that TR3271 does not resend data in response to a READ MODIFIED command sent by the host after TR3271 has sent the data in response to a poll. If NOREADMODAFTERPOLL is in effect, the READ MODIFIED command is rejected.
NOWACKIFNOREAD or WACKIFNOREAD — TR Only Modifier Profiles NOWACKIFNOREAD or WACKIFNOREAD — TR Only Application: SWAN Concentrator Default: NOWACKIFNOREAD Units: na Range: na SCF Equivalent: same name This modifier enables or disables the sending of a waited acknowledgment (WACK )to a SELECT when the subdevice is open but no READ is posted. WACKIFNOREAD enables the sending of a WACK; NOWACKIFNOREAD disables it. OFFLINETIMER — TR Only Application: SWAN Concentrator Default: 0 Units: 0.
PACE — AM Only Modifier Profiles PACE — AM Only Application: All Cluster Controllers Default: 0 Units: Number of SELECTs Range: 0 through 100 SCF Equivalent: same name This modifier specifies the number of consecutive selects that are allowed on the line before subdevices are polled for data. If the value of this modifier is 0, output (selection) is favored over input (polling). However, if heavy output is being performed on a line, no input is taken until the output has completed.
PROGRAM name — AM and TR Modifier Profiles PROGRAM name — AM and TR Application: SWAN Concentrator Default: $SYSTEM.CSSnn.C0039P00 for AM3270 $SYSTEM.CSSnn.C0040P00 forTR3271 Units: na Range: na SCF Equivalent: same name PROGRAM is the microcode file that is downloaded from a NonStop S-series server or an Integrity NonStop NS-series server to the SWAN concentrator.
RVIIFNOREAD or EOTIFNOREAD — AM Only Modifier Profiles RVIIFNOREAD or EOTIFNOREAD — AM Only Application: All Cluster Controllers Default: RVIIFNOREAD Units: na Range: na SCF Equivalent: same name The RVIIFNOREAD modifier specifies that after RETRIES of POLL/SELECT operation are exhausted, AM3270 sends a reverse interrupt (RVI). Note that AM3270 does not acknowledge the text if there is no READ outstanding.
SPEED — AM Only Modifier Profiles SPEED — AM Only Application: All Cluster Controllers Default: 0 Units: Bits per second divided by 100 Range: One of the following values:3, 24, 48, 72, 96, 112 or 192. SCF Equivalent: none This modifier specifies the data rate of the line. For example, specify 96 for a rate of 9600 bits per second. When SPEED is set to a non-zero value, CSS 3270 calculates the time it takes to send a text block and adds that value to the timeout value.
THRESHOLD — AM and TR Modifier Profiles THRESHOLD — AM and TR Application: All Cluster Controllers (AM), SWAN Concentrator (TR) Default: Off Units: na Range: na SCF Equivalent: same name This modifier specifies the statistics threshold values. If the DLC task running in the CLIP detects line errors which exceed this THRESHOLD value, it sends the updated statistics to the IOP. You can display the updated statistics by using the SCF STATS LINE command.
Modifier Profiles WACKDELAY — TR Only AM3270 and TR3271 Configuration and Management Manual—529993-001 5- 16
6 Attribute Descriptions for AM3270 and TR3271 This section contains a description of each SCF attribute used for the AM3270 or TR3271 subsystems. The attributes are listed in alphabetical order. Most of the attributes in this section are common to both the AM3270 and TR3271 subsystems. Only the attributes unique to one subsystem are noted.
Attribute Descriptions for AM3270 and TR3271 BCCTYPE BCCTYPE Default: CRC16 Range: CRC16, LRC8, or CCITT Objects: Lines Profile Equivalent: CRC16, CCITT or LRC8 The BCCTYPE attribute specifies the Block Check Character (BCC) type.
Attribute Descriptions for AM3270 and TR3271 CONFIRMWRITE CONFIRMWRITE Note: This is an AM3270 attribute. Default: Off Range: On or Off Objects: Lines Profile Equivalent: CONFIRMWRITE CONFIRMWRITE On means that a job sent to the printer will be confirmed after the DEVICE END status message is received. Off means that AM3270 ensures only that the text will be delivered successfully to a cluster controller. CONSOLEMSG Note: This is an AM3270 attribute.
Attribute Descriptions for AM3270 and TR3271 DEBUG DEBUG Default: Off Range: On or Off Objects: Lines Profile Equivalent: None The DEBUG attribute enables or disables the CLIP debug interface. This attribute is not intended for customer use and should be left in the Off state. DROPRTS Default: Off for AM3270.
Attribute Descriptions for AM3270 and TR3271 INITSTATUS INITSTATUS Note: This is a TR3271 attribute. Default: 0 Range: 0, %177776, %177777, or any 16-bit octal value other than 0, %177776, or %177777 Objects: Lines Profile Equivalent: INITSTATUS The INITSTATUS attribute specifies the initial IBM status that will be used to determine the response when the subdevice is selected but not opened or connected. Refer to Appendix G in this manual for more information about device status.
Attribute Descriptions for AM3270 and TR3271 status = value MULTIBLOCK where value represents any meaningful 16-bit octal value. These values are used by the TR3271 subsystem as IBM status/sense bytes. TR3271 responds to SELECTs with an RVI that signifies a status/sense condition. Any subsequent POLL will result in the transfer of the status/sense bytes to the host. The user must ensure that the status/sense information is in the correct format for the host.
Attribute Descriptions for AM3270 and TR3271 OFFLINETIMER OFFLINETIMER Note: This is a TR3271 attribute. Default: 0 Range: 0 through 5:27.67 Objects: Lines Profile Equivalent: OFFLINETIMER The OFFLINETIMER attribute specifies the amount of time to wait before reporting a timeout error. The range of values is 0 through 5:27.67. The value 0 means wait indefinitely. PACE Note: This is an AM3270 attribute.
Attribute Descriptions for AM3270 and TR3271 POLLTYPE POLLTYPE Note: This is an AM3270 attribute. Default: General Range: General or Specific Objects: Lines Profile Equivalent: GP or SP The POLLTYPE attribute specifies the polling type. General means a poll of the controller itself is performed. Specific means a poll of subdevices associated with the controller is performed. PROGRAM Default: $SYSTEM.CSSnn.C0039P00 for AM3270 $SYSTEM.CSSnn.
Attribute Descriptions for AM3270 and TR3271 READCOMMAND PTP provides the ability to interconnect a TR3271 subdevice directly to an AM3270 subdevice without an intervening application process (pass-through protocol). A type of communications protocol, the QUOTRON protocol is used only in those environments that have devices attached to a special controller concentrator.
Attribute Descriptions for AM3270 and TR3271 RECSIZE RECSIZE Default: Not applicable Range: 512 through 4096 bytes Objects: Subdevices Profile Equivalent: None The RECSIZE attribute specifies the record size, in bytes, that the subdevice can support. However, for terminal subdevices and printer subdevices the RECSIZE attribute is for reference only. For a terminal subdevice, the record size is for reference only.
Attribute Descriptions for AM3270 and TR3271 RETRIES RETRIES Default: 3 Range: 1 through 15 for both AM3270 and TR3271. Objects: Lines Profile Equivalent: RETRIES The RETRIES attribute specifies the number of retransmissions that will be made for data link errors until the data link is flagged as inoperative and all appropriate sessions are terminated. The range of values is 1 through 15.
Attribute Descriptions for AM3270 and TR3271 TIMEOUT TIMEOUT Default: 350 (3.5 seconds) for AM3270. 270 (2.7 seconds) for TR3271. Range: 0 through 5:27.67 Objects: Lines Profile Equivalent: TIMEOUT The TIMEOUT attribute specifies the time interval that the I/O process will wait for a response to a request before retrying the request. The range of values is 0 through 5:27.67.
TYPE Attribute Descriptions for AM3270 and TR3271 TYPE Default: Not applicable Range: (5,0), (6,x), (10,x), or (60,0) for AM3270 (10,x) or (60,x) for TR3271 Objects: Subdevices Profile Equivalent: None The TYPE attribute specifies the subdevice type and subtype. The TYPE attribute must be specified for the ADD command.
WACKDELAY Attribute Descriptions for AM3270 and TR3271 Device Type and Subtype Meaning 10,6 CRT subdevice with a 27 x 132 screen size 60,1 TR3271 PTP CRT subdevice 60,2 TR3271 PTP printer subdevice WACKDELAY Note: This is a TR3271 attribute. Default: 0 Range: 0 through 5:27.67 Objects: Lines Profile Equivalent: WACKDELAY The WACKDELAY attribute specifies the time to wait before sending a WACK, in 0.01 second units. The range of values is 0 through 5:27.67.
Attribute Descriptions for AM3270 and TR3271 XLATEOUT XLATEOUT Default: On Range: 0 through 255 Objects: Lines Profile Equivalent: None If the TRANSLATE attribute is On, this table is used as a translate table for inbound (or outbound) data. If this attribute is used to define a translate table, all 256 bytes must be specified.
Attribute Descriptions for AM3270 and TR3271 AM3270 and TR3271 Configuration and Management Manual—529993-001 6- 16 XLATEOUT
7 PTrace for AM3270 and TR3271 This section describes the PTrace interface, command syntax, and fields of sample trace records.
PTrace for AM3270 and TR3271 Recording and Displaying Trace Data display and examine the trace files. The PTrace program formats the data stored in the unstructured trace files for output to terminals, printers, or disk files. Figure 7-1 shows the four general steps involved in recording and displaying trace data. Figure 7-1. Recording and Displaying Trace Data Start the trace with the SCF TRACE command. Collect trace data. Stop the trace ith the SCF TRACE command. Display the trace file with P Trace.
PTrace for AM3270 and TR3271 Determining the Subsystem Determining the Subsystem PTrace uses the line device types and subtypes 60,10 to indicate the AM3270 subsystem and 60,11 to indicate the TR3271 subsystem. PTrace reads this information when it opens the trace file. The device type for AM3270 is 60. The only possible subtype is 10. The device type for TR3271 is 60. The only possible subtype is 11. PTrace Commands You use PTrace commands to format trace files generated by a subsystem.
PTrace for AM3270 and TR3271 Trace Example Table 7-1. Summary of PTrace Commands for AM3270 or TR3271 (page 2 of 2) Command Description LOG Directs a copy of PTrace input and output to a file. NEXT Displays the next trace data record(s) in the trace file. OBEY Causes commands to be read from a different input file. OCTAL Displays numbers in octal notation. OUT Redirects the PTrace output. PAGESIZE Sets the terminal screen size for interactive mode.
PTrace for AM3270 and TR3271 Trace Example 6. Use PTrace to format and display the trace records. Note. Depending on the nature of the problem you are investigating, you may wish to start the trace before starting the line. The following example of trace allows you to examine the trace file after you recreate the original problem: 1. Assume the line and then trace the line. ASSUME LINE $am1 TRACE, TO AMTRACE,PAGES 200, RECSIZE 2048 2. Recreate the original error that you want to capture. 3.
PTrace for AM3270 and TR3271 AM3270 and TR3271 Configuration and Management Manual—529993-001 7 -6 Trace Example
A Moving to G-Series Systems This appendix discusses the differences between the AM3270 and TR3271 subsystems on G-series systems and the AM3270 and TR3271 subsystems on D-series and earlier releases. In addition to this appendix, the following conversion information is available to help you: • • The MIGSCF program can automatically convert to SCF any COUP commands entered at the TACL prompt or found within a command or an OBEY file.
CONFTEXT Paragraph Information Moving to G-Series Systems CONFTEXT Paragraph Information Table A-1 lists the CONFTEXT paragraphs that are relevant to AM3270/TR3271 configuration and how the information in each paragraph is defined on G-series systems. Table A-1.
Moving to G-Series Systems Managing AM3270/TR3271 lines Managing AM3270/TR3271 lines The Peripheral Utility Program (PUP), Dynamic System Configuration (DSC), and ViewPoint Console application of Distributed Systems Management (DSM) are not supported on G-series systems. The OSM package is a client-server application that provides troubleshooting, maintenance, and service tools for your system.
Moving to G-Series Systems Managing AM3270/TR3271 lines AM3270 and TR3271 Configuration and Management Manual—529993-001 A- 4
B SCF Command Summary for AM3270 This appendix summarizes the syntax of the commands described in Section 4, SCF Interface to AM3270 and TR3271. ABORT [ / OUT file-spec / ] [ LINE line-name | SU su-name ] [ , SUB [ ONLY | ALL | NONE ] ] ADD [ / OUT file-spec / ] [ SU su-name ] [ , attribute-spec ] ALTER [ / OUT file-spec / ] [ LINE line-name | SU su-name ] [ , attribute-spec ]...
SCF Command Summary for AM3270 START [ / OUT file-spec / ] [ LINE line-name | SU su-name ] [ , SUB [ ONLY | ALL | NONE ] ] STATS [ / OUT file-spec / ] [ LINE line-name | SU su-name ] [ , RESET ] [ , SUB [ ONLY | ALL | NONE ] ] STATUS [ / OUT file-spec / ] [ LINE line-name | SU su-name ] [ , DETAIL ] [ , SUB [ ONLY | ALL ] ] [ , SEL [ STARTED | STOPPED ] ] STOP [ / OUT file-spec / ] [ LINE line-name | SU su-name ] [ , SUB [ ONLY | ALL | NONE ] ] SWITCH [ / OUT file-spec / ] [ LINE line-name ] , PATH { A |
C SCF Command Summary for TR3271 This section summarizes the syntax of the commands described in Section 4, SCF Interface to AM3270 and TR3271 ABORT [ / OUT file-spec / ] [ LINE line-name | SU su-name ] [ , SUB [ ONLY | ALL | NONE ] ] ADD [ / OUT file-spec / ] [ SU su-name ] [ , attribute-spec ] ALTER [ / OUT file-spec / ] [ LINE line-name | SU su-name ] [ , attribute-spec ]...
SCF Command Summary for TR3271 START [ / OUT file-spec / ] [ LINE line-name | SU su-name ] [ , SUB [ ONLY | ALL | NONE ] ] STATS [ / OUT file-spec / ] [ LINE line-name | SU su-name ] [ , RESET ] [ , SUB [ ONLY | ALL | NONE ] ] STATUS [ / OUT file-spec / ] [ LINE line-name | SU su-name ] [ , DETAIL ] [ , SUB [ ONLY | ALL | NONE ] ] [ , SEL [ STARTED | STOPPED ] ] STOP [ / OUT file-spec / ] [ LINE line-name | SU su-name ] [ , SUB [ ONLY | ALL | NONE ] ] SWITCH [ / OUT file-spec / ] [ LINE line-name ] , PAT
D Error Messages for AM3270 This appendix describes network-related operator console error messages and common file-system error messages. Cause and recovery information for each error message is included. This appendix includes messages issued only by the AM3270 subsystem. The user can receive, through SCF, error messages generated by the file system, SCP, and so on.
Message Descriptions Error Messages for AM3270 Table D-2. File-System Error Summary for AM3270 (page 2 of 2) Error Number Description 177 Text overrun. 179 Application buffer is improper. 180 Unknown device status received. 181 Status receipt currently enabled for subdevice. * After a line ownership change has occurred, there is a period of time during which an application can receive this error. Note that the application should retry its request when this error is received.
Error Messages for AM3270 Message Descriptions Cause. The target object cannot be found. This usually happens on a CONNECT or DISCONNECT command. It means that the specified TR3271 subdevice does not exist. Effect. Command could not be completed. Recovery. Specify a PTP TR3271 SU that has been defined. 00004 AM3270 00004 Conflicting attributes for a LINE. Cause. One or more of the specified line attributes conflicts with a transparent SU. This usually happens on an ALTER LINE command.
Error Messages for AM3270 Message Descriptions Cause. There is no object in the selected summary state. This usually happens on a STATUS LINE, SUB ONLY, SEL state command. Effect. Command could not be completed. Recovery. None. This error can be considered an informational message. 00008 AM3270 00008 Opened SUs exist. Cause. A STOP command has been issued for the line, but there are SUs which are currently opened by applications. Effect. Command could not be completed. Recovery.
Error Messages for AM3270 Message Descriptions 00012 AM3270 00012 PTP connection present. Cause. A STOP command has been sent to a PTP subdevice that is connected. Effect. Command could not be completed. Recovery. Disconnect the subdevice before trying to stop it, or use the ABORT command. 00013 AM3270 00013 Opener present. Cause. A STOP command has been issued to a non-PTP SU that is currently opened by an application. Effect. Command could not be completed. Recovery.
Error Messages for AM3270 Message Descriptions 00503 AM3270 00503 Less than 256 characters specified. Cause. Not enough characters were specified for the XLATEIN and XLATEOUT attributes. See Section 6, Attribute Descriptions for AM3270 and TR3271 for information about the XLATEIN and XLATEOUT attributes. Effect. Command could not be completed. Recovery. Make sure that 256 characters have been specified. 00506 AM3270 00506 Invalid Value: \* for \* Cause.
Error Messages for AM3270 Message Descriptions Effect. Command could not be completed. Recovery. Use the STATUS LINE , DETAIL command and find out the path that is currently being used. Provide the alternate path in the ALTER LINE command (if the STATUS LINE shows path A, use path B and vice versa).
Error Messages for AM3270 Message Descriptions AM3270 and TR3271 Configuration and Management Manual—529993-001 D- 8
E Error Messages for TR3271 This appendix describes network-related operator console error messages and common file-system error messages. Cause and recovery information for each error message is included. This appendix includes messages issued only by the TR3271 subsystem. The user can receive, through SCF, error messages generated by the file system, SCP, and so forth.
Message Descriptions Error Messages for TR3271 In general, a data communications line can incur file-system errors of the types shown in Table E-3. Table E-3. File-System Error Types Error Numbers Description 10-30 Coding or access problem 30-33 System configuration problem 120-199 Device hardware problem 200-255 Path error Message Descriptions The TR3271 error messages are listed by message number, from lowest to highest. 00002 TR3271 00002 The CLIP program encountered a problem. Cause.
Error Messages for TR3271 Message Descriptions Cause. One or more of the specified line attributes conflicts with a transparent SU. This usually happens on an ALTER LINE command. In order to have a transparent SU, the line must be configured as follows: CHARACTERSET = EBCDIC CONTROLSET = EBCDIC TRANSLATE = ON TRANSPARENT = ON An attempt was made to change one of these attributes. Effect. Command could not be completed. Recovery. Do not change any of the attributes listed above.
Error Messages for TR3271 Message Descriptions Cause. A STOP command has been issued for a line, but at least one SU is currently opened by applications. Effect. Command could not be completed. Recovery. Close all SUs before stopping the line. 00009 TR3271 00009 SU is not connected to target SU. Cause. A STOP command has been issued for a line, but at least one SU is currently opened by applications. Effect. Command could not be completed. Recovery. Close all SUs before stopping the line.
Error Messages for TR3271 Message Descriptions 00013 TR3271 00013 Opener present. Cause. A STOP command has been issued to a non-PTP SU that is currently opened by an application. Effect. Command could not be completed. Recovery. Close the SU before trying to stop it, or use the ABORT command. 00500 TR3271 00500 Duplicate attribute. Cause. An attribute was entered more than once. For example, TRANSLATE ON and TRANSLATE OFF were entered for the same command. Effect. Command could not be completed.
Error Messages for TR3271 Message Descriptions Recovery. Make sure that 256 characters have been specified. 00506 TR3271 00506 Invalid Value: \* for \*. Cause. An invalid value was received for the object name in an ALTER command. The first wild card shows the attribute. For example, PACE or TRANSLATE. The second wild card shows the object name. For example, $AM32S1. If you entered the command ALTER LINE $AM32S1...TRANSLATE 2, and SCF required an On or an Off, you would receive this error. Effect.
F Object-Oriented Commands for AM3270 and TR3271 This appendix describes the following topics: • • Objects supported by AM3270 and TR3271 A table of AM3270 and TR3271 object types and command descriptions Objects Supported by AM3270 and TR3271 Table F-1 shows the SCF objects supported by AM3270 and TR3271. For information about objects supported by other subsystems, see the SCF manual for the specific subsystem.
Object-Oriented Commands for AM3270 and TR3271 Objects Supported by AM3270 and TR3271 The objects supported by the AM3270 and TR3271 subsystems and the commands to which they apply are listed in Table F-1. Table F-1. AM3270 and TR3271 Object Types and Command Descriptions (page 1 of 2) Object Commands Description of Command Function PROCESS PRIMARY Causes the backup CPU to become the primary CPU and the primary CPU to become the backup CPU. VERSION Displays the version level of the process.
Object-Oriented Commands for AM3270 and TR3271 Objects Supported by AM3270 and TR3271 Table F-1. AM3270 and TR3271 Object Types and Command Descriptions (page 2 of 2) Object Commands Description of Command Function INFO Displays the current attribute values for the specified subdevice. NAMES Returns a list of subdevices and names for the specified line. START Initiates the operation of a subdevice. STATS Displays statistical information for the specified subdevice.
Object-Oriented Commands for AM3270 and TR3271 Objects Supported by AM3270 and TR3271 AM3270 and TR3271 Configuration and Management Manual—529993-001 F-4
G 3174 Device Status/Sense Bytes This appendix contains the following items: • • A description of the IBM 3174 device status/sense bytes A table with device status/sense bytes Description of Device Status/Sense Bytes Table G-1 shows the status and sense bytes for the IBM 3174. To use Table G-1, take the number %040140 in the STATUS SU display for the AM3270 subsystem, as an example: AM3270 Status SU Name $AM3270.
Description of Device Status/Sense Bytes 3174 Device Status/Sense Bytes 7. Intervention Required (IR) indicates one of the following: • • • • A command attempted to start a printer but found it not ready, so the printout is suppressed. The 3174 has received a command for a device that has been logged as unavailable. The 3174 has received an addressing or poll sequence for a device that is unavailable during a printout.
Description of Device Status/Sense Bytes 3174 Device Status/Sense Bytes Table G-1.
3174 Device Status/Sense Bytes Description of Device Status/Sense Bytes AM3270 and TR3271 Configuration and Management Manual—529993-001 G- 4
Index A ABORT command AM3270 4-15 syntax B-1 TR3271 4-53 ADD command AM3270 4-16 SU attribute-spec 4-17 syntax B-1 TR3271 4-55 SU attribute-spec 4-56 ADDRESS attribute 6-1 ALTER command AM3270 4-18 syntax B-1 syntax 4-19, 4-57 TR3271 4-57 LINE attribute-spec 4-58 AM3270 error messages D-1 error messages help D-1 file-system error summaries D-1 INFO LINE command 4-25 AM3270 and TR3271 ADD DEVICE command 3-7 ADD PROFILE command 3-6 object files 3-2 START DEVICE command 3-9 subsystem configuration 3-4 subsyste
B Index ASCII 5-4 Attribute specifications AM3270 ADD SU command 4-17 TR3271 ADD SU command 4-56 ALTER LINE command 4-58 attribute-spec AM3270 ADD SU command 4-17 TR3271 ADD SU command 4-56 ALTER LINE command 4-58 AUTOLOAD attribute 6-1 B BCCTYPE attribute 6-2 BOOT command AM3270 4-20 TR3271 4-59 C CHARACTERSET attribute 6-2 CHARSET attribute 6-2 CLBFRAMESIZE 5-1 CLBRETRIES 5-2 CLBTIMEOUT 5-2 CLBWINDOW 5-2 CLEARCA 5-7 Command overview 4-13, 4-51 Commands ABORT syntax B-1 ADD attribute-spec 4-17, 4-56 sy
D Index Commands (continued) VERSION syntax B-2 Commands, SCF replacement for COUP A-2 Communication Concentrators 2-6 concentrators supported 2-6 configuration 4-1 configuration process AM3270 and TR3271 subsystem ADD DEVICE syntax 3-7 START DEVICE syntax 3-9 CONFIRMWRITE attribute 6-3 CONNECT command AM3270 4-21 TR3271 4-60 CONTROLRTS 5-7 CONTROLRTS attribute 6-3 CONTROLSET attribute 6-3 CRC16 5-3 CSMLDEV 5-3 CTRLCF 5-7 D DEBUG attribute 6-4 DELETE command AM3270 4-22 TR3271 4-61 Device names defined 4
L Index L Line names finding 4-32, 4-71 LINE object TR3271 4-10 LISTDEV to find subdevice or line names 4-32 LOAD command AM3270 4-28 TR3271 4-67 LOCALPOOLPAGES 5-6 Logical states 4-4 M Modes interactive 4-5 noninteractive 4-5 modifiers printer 1-1, 5-1 monitoring See subsystem monitoring 2-7 MULTIBLOCK attribute 6-6 N Names device 4-3 LINE 4-3 object 4-3 PROCESS 4-3 SU 4-3 NAMES command AM3270 4-29 TR3271 4-68 NOAUTOLOAD 5-6 NOCLEARCA 5-7 NOCONTROLRTS 5-7 NOCTRLCF 5-7 NODROPRTS 5-8 NOGPAFTERWACK attrib
P Index OFFLINETIMER attribute 6-7 OPERATIONCLASS 5-10 Output destinations setting 4-6 Overview SCF 4-2 SCP 4-2 P PACE 5-11 PACE attribute 6-7 POLLINT 5-11 POLLINT attribute 6-7 POLLTYPE attribute 6-8 PRIMARY command AM3270 4-30 TR3271 4-69 PROCESS object AM3270 4-9 TR3271 4-10 PROFILE permanent changes to 3-4 temporary changes to 3-5 Profile Equivalent ASCII 6-2, 6-3 CCITT 6-2 CLEARCA 6-4 CONFIRMWRITE 6-3 CONTROLRTS 6-3 CRC16 6-2 CTRLCF 6-3 DROPRTS 6-4 EBCDIC 6-2, 6-3 EOTINFOREAD 6-4 GP 6-8 INITSTATUS 6
Q Index PTrace (continued) displaying trace data 7-2 formatting trace files 7-3 generating a trace file 7-1 recording trace data 7-2 Q QUOTRON 6-9 R READCOMMAND 5-8 READCOMMAND attribute 6-9 READMODAFTERPOLL 5-9 RECSIZE attribute 6-10 REPOLLINT attribute 6-10 RETRIES 5-12 RETRIES attribute 6-11 RVIIFNOREAD 5-13 S SCF 4-8 command overview 4-2/4-3 configuration 4-1 input source 4-5 operation 4-5 output destinations 4-6 SCF commands AM3270 /TR3271 and WAN SCF commands compared 3-5 SCF Object hierarchy 3-2
T Index Status/sense byte description G-1 STOP command AM3270 4-44 TR3271 4-83 SU object AM3270 4-9 TR3271 4-10 SUB parameter 4-4/4-7 Subdevice names finding 4-32, 4-71 Subordinate object 4-4 Subsystem Control Facility See SCF Subsystem Control Point See SCP subsystem monitoring Distributed Systems Management (DSM) Event Management Service (EMS) 2-8 Subsystem Control Facility (SCF) 2-7 SWITCH command AM3270 4-46 TR3271 4-84 SYNCS 5-14 SYNCS attribute 6-11 Syntax rules object-specs 4-12 system configuratio
V Index TR3271 commands (continued) VERSION 4-88 syntax C-2 TR3271 objects types 4-10 TR3271 Profile Listing 3-4 TR3271 Programmed Passthrough 2-4 TR3271 subsystem described 2-4 TRACE command AM3270 4-47 LINE select-spec 4-49 TR3271 4-85 LINE select-spec 4-87 Trace data displaying with PTrace 7-2 generating with PTrace 7-2 Trace file generating with PTrace 7-1 TRANSLATE attribute 6-12 TRANSPARENT 5-9 TRANSPARENT attribute 6-12 TYPE attribute 6-13 for AM3270 6-13 for TR3271 6-13 X XLATEIN attribute 6-14 X
