Do you have a question about the 204 and is the answer not in the manual?
Questions and answers
Summary of Contents for Rocket 204
Page 1
Rocket Model 204 Terminal User’s Guide Version 7 Release 4.0 May 2012 204-74-TERM-01...
Page 2
Computer Corporation of America is a wholly-owned subsidiary of Rocket Software, Inc. Trademarks Rocket is a registered trademark of Rocket Software, Inc. For a list of Rocket registered trademarks go to: www.rocketsoftware.com/about/legal. All other products or services mentioned in this document may be covered by the trademarks, service marks, or product names of their respective owners.
Page 3
United Kingdom/Europe +44 (0) 20 8867 6153 Alternatively, you can access the Rocket Customer Portal and report a problem, download an update, or read answers to FAQs. You will be prompted to log in with the credentials supplied as part of your product maintenance agreement.
Contents About this Guide Audience ........................xi Model 204 documentation set ...................xi Notation conventions....................xi 1 Terminal Processing In this chapter......................1 Overview ........................1 Supported terminals, access methods, and interfaces ..........2 Supported access methods..................2 Supported SNA Communications Server terminals ..........2 Supported system interfaces..................
Page 6
Recovering from an error ..................... 31 Prompting and informational messages ..............32 Counting errors ....................... 32 Severe errors ......................32 Soft restart....................... 33 Displaying messages ....................33 Closing a file......................... 34 Using the CLOSE command ................... 34 vi Rocket Model 204 Terminal User’s Guide...
Page 7
Logging out and disconnecting ..................34 Using the LOGOUT command ................34 3 SNA Communications Server Terminal In this chapter......................35 Overview ........................35 Getting online ....................... 36 Procedures ......................36 IBM 3270 terminals (IODEV = 7).................. 36 Input lines ........................ 36 End-of-page pause....................
Page 8
Input lines ........................ 71 PF keys ........................71 Disconnecting......................71 Turning off the terminal ................... 71 IBM 3270 terminals (IODEV = 41, ALTIODEV =47)............. 72 Attention key ......................72 Pausing and canceling output ................. 72 viii Rocket Model 204 Terminal User’s Guide...
About this Guide The Terminal User’s Guide describes the operation and use of the Model 204 Database Management System through a variety of terminals, access methods, and system interfaces. Audience This guide is written for both programmers and users who have no programming experience.
Page 12
In this example, select the Save As command from the File menu. EDIT Partial bolding indicates a usable abbreviation, such as E for EDIT in this example. xii Rocket Model 204 Terminal User’s Guide...
Chapter 2 provides a sample terminal session in which a user connects to Model 204, logs in, opens a file, and retrieves selected data. The rest of the chapters summarize the distinctive characteristics of each terminal type, access method, or system interface.
• IBM 3767 terminals • Terminal types supported by the IBM Network Terminal Option (NTO) Supported system interfaces Model 204 also can be accessed by means of one of the following system interfaces: • CICS (as a transaction) • TSO (as a command processor or as a called program) •...
For 3270s, INMRL and INCCC also can be reset as a result of resetting the MODEL parameter. MODEL allows for alternate screen sizes within the 3270 family and is described in detail in the Model 204 Parameter and Command Reference Manual.
For example, RETRVKEY = 3 means that PF key 3 is the Retrieve PF Key. Using the Retrieve PF key If the Retrieve PF key is pressed when Model 204 requests a new input line from the user’s terminal, Model 204 displays the user’s most recently entered input line.
Controlling output • Passwords and responses to the $READINV function • Backpage requests • Null input lines • Lines directly handled by a system interface (for example, the z/OS SUBSET string) • All but the first of a sequence of duplicate input lines (if a null input line is entered between the duplicate input lines) Retrieval example For example, if the following input lines are entered:...
Setting OUTMRL The OUTMRL parameter specifies the maximum number of characters that Model 204 can display on an output line at a particular terminal. Note, however, that the number of characters specified in OUTMRL can be greater than the physical line length of the terminal being used. If the terminal is a CRT device, a long line wraps around and some of the characters are displayed on a second line.
Input lines entered in this fashion are never saved by the CICS, TSO, CMS, or INTERCOMM interfaces. If the last line of a page is used for input, Model 204 does not pause at the bottom of the page.
For example, a user who is on page 17 and who wants to see page 16 enters: P -1 Because Model 204 prepares for a new page before pausing at the bottom of a full page, at the following backpage request, entered at the end-of-page...
Full-screen formatting The Model 204 full-screen formatting feature, described in detail in the Model 204 User Language Manual, is designed for use with display terminals (that is, IBM 3270 and compatible terminals). This feature allows an entire screen to be formatted and displayed as a single entity.
Model 204 User Language Manual. Backpaging screens and menus The Model 204 backpaging feature can be used to store and retrieve screens and menus that have been defined by the full-screen capabilities. (For more information about the backpaging feature, see “Backpaging” on page 7.) When a backpage is displayed, any display attributes (such as BLINK or BRIGHT) that originally were specified for fields on the screen are lost.
The line can be corrected only by using the Model 204 full- screen or line editor. For more information on Model 204 editors, refer to the Model 204 Editing Guide.
In User Language, an ON ATTENTION statement can be specified in a request. Through this statement, the user specifies the action that Model 204 takes (that is, the flag to be set or the branch to be executed) when an end user invokes an attention interrupt.
Echoing Echoing When echoing is enabled, Model 204 displays each input line on the user’s output device as it is entered. Three classes of input lines can be echoed: • Direct input to Model 204, either from the user’s terminal or from an included procedure (see “Examples using LECHO and CECHO”...
Model 204 echoes a given portion of input no more than once at each level. If the bits are set as follows and a given line includes editing characters and...
Echoing examples Echoing examples Examples using LECHO and CECHO In the first series of examples, LECHO and CECHO initially are set to 0, and no echoing occurs. LECHO is then set to values of 1, 4, and 5. Example 1 No echoing: LECHO = 0 BEGIN PRINT ‘CASH’...
Terminal line-edit echo: LEECHO = 1 BEGIN PRINT ‘CSL@@@CASH’ PRINT ‘CASH’ TODAT#END CASH Echoing also can be controlled for lines in which dummy string substitutes have been entered. In the echoed line, the substituted character string is displayed 16 Rocket Model 204 Terminal User’s Guide...
Page 29
For example, the following line is entered in a request: PRINT ‘??ENTER.NAME’ Model 204 responds with the prompt: ??ENTER.NAME The user can reply with: RICHARD JONES If LSECHO is properly set, Model 204 now echoes the original PRINT’??ENTER.NAME’ line as: PRINT ‘RICHARD JONES’ Terminal Processing 17...
• Getting online • Logging in • Opening a file • Viewing and changing parameter settings • Running Model 204 requests and procedures • Displaying a procedure • Deleting a procedure • Recovering from an error • Closing a file •...
This chapter is intended to serve as an introduction to Model 204 remote terminal facilities, not to describe User Language or system control commands in any detail. For more information about these facilities, refer to the Model 204 User Language Manual and the Model 204 Parameter and Command Reference Manual.
FOR EACH RECORD IN GET.POL PRINT ALL INFORMATION SKIP 1 LINE END FOR ?END Model 204 displays output from the request. FULLNAME = ADAMS, CESAR O POLICY NO = 100035 DRIVER ID = 100085 MARITAL STATUS = MARRIED SEX = M...
FOR EACH RECORD IN CATEGORY.A PRINT FULLNAME AND AGENT AT 30 END FOR Executing a procedure and viewing output The user executes the procedure and Model 204 displays output: ?INCLUDE SACRAMENTO ADAMS, KEN U GOODRICH ELLIOTT, CHRISTINE Q BATEMAN GOLDSMITH, CLAYTON C BATEMAN...
The user disconnects: ? DISCONNECT Getting online To connect to Model 204 using the Teletype device, the user must do the following: 1. Turn the power on. 2. Set the terminal mode switch to LINE and the duplex switch to HALF.
MODEL 204 Logging in LOGIN process Having established a connection to Model 204, the user must log in if the LOGIN process is required at an installation. The following command is used to log in: {LOGIN | LOGON} userid [account]...
If a user attempts to OPEN a public file, Model 204 opens it. • If a user attempts to OPEN a semipublic file, Model 204 prompts for a file password. If the user enters a valid password, the file is opened with all the file privileges that are associated with that password.
Some parameters can be set or reset only by the system manager or by a file manager. Others can be reset by the user. All the parameters have default values provided by Model 204. The parameters that affect terminal operations are summarized in the Model 204 Parameter and Command Reference Manual.
OUTPUT LINES PER PAGE PGSEP LINES BETWEEN PAGES Running Model 204 requests and procedures You can run a Model 204 User Language request in one of the following ways: • Enter User Language statements at the terminal and invoke an immediate response.
POLICY NO = 100035 DRIVER ID = 100085 MARITAL STATUS = MARRIED SEX = M STATE = NEW YORK INCIDENT = T2 INCIDENT DATE = 770513 INCIDENT = T1 INCIDENT DATE = 780614 28 Rocket Model 204 Terminal User’s Guide...
Displaying a procedure INCIDENT = T2 INCIDENT DATE = 790715 DATE OF BIRTH = 640619 The user executes a previously entered procedure: ?INCLUDE SACRAMENTO ADAMS, KEN U GOODRICH ELLIOTT, CHRISTINE Q BATEMAN GOLDSMITH, CLAYTON C BATEMAN GRIFFIN, EUGENE O BATEMAN WRIGHT, FRANK I GOODRICH The user defines a procedure named TEST.
(usually the terminal): USE ddname The Model 204 Parameter and Command Reference Manual provides a detailed description of the DISPLAY and USE commands. The user displays the available procedures:...
The basic types of error conditions, prompting messages, and informational messages in Model 204 are summarized in this section. For a detailed explanation about Model 204 messages, refer to the Model 204 Messages Manual.
If the error occurs in a system control command, the user can simply reenter the command. If the error occurs in a procedure, the user must wait for Model 204 to process the entire procedure before correcting the error.
When a prompting, informational, or error message is displayed by Model 204, a prefix associated with the message specifies the type of message (that is, Model 204 or user) and the number of the message. The system manager can Terminal Session 33...
Having completed all file operations, the user can close the file using the CLOSE command: CLOSE CENSUS Files are closed automatically when the user logs out of Model 204 or if a system failure occurs. Logging out and disconnecting Using the LOGOUT command...
SNA Communications Server Terminal In this chapter • Overview • Getting online • IBM 3270 terminals (IODEV = 7) • IBM 3767 and NTO terminals (IODEV = 37) Overview This chapter describes the procedures to be followed when using SNA Communications Server (formerly VTAM) (Virtual Telecommunications Access Method).
The user can now enter an input line. A physical input line cannot exceed 78 characters; however, using a line continuation character at the end of an input line causes Model 204 to treat the next line as a logical continuation of the previous one.
End-of-page pause Model 204 pauses at the end of each output page and waits for the user to respond before continuing. This allows the user to examine the contents of the screen. Model 204 prompts with an end-of-page prompt (>), indented 25 spaces.
IBM 3270 terminals (IODEV = 7) Logging out and disconnecting To disconnect from Model 204, the user logs out (if the LOGOFF procedure is required at the installation) by entering either: LOGOUT LOGOFF The user can then disconnect completely from the system, reconnect to Model 204, or connect to a different application by following the specific procedures defined at the installation.
IBM 3270 terminals (IODEV = 7) established by the MODEL parameter. The new settings remain in effect for the thread until the user logs out. Table 3-2. Valid MODEL settings for SNA Communications Server 3270s MODEL INMRL INCCC OUTMRL OUTCCC OUTLPP 3270 terminal type Model 1...
NTO through SNA Communications Server. Input lines When Model 204 is ready to accept input, it issues the prompt character and unlocks the keyboard. For 3767s supported by NTO, the prompt is the underscore character (_), which is backspaced over immediately after it is printed.
IODEV=37 CCAIN parameter line(s). They can be reset using the RESET command, but not to a value larger than the IODEV line setting, if any. If a value larger than an IODEV line value is specified, Model 204 automatically changes it to the IODEV line value.
Page 54
String ‘LOGON’ is placed before the first logical line of the SNA Communications Server LOGMSG. Note: A TERMOPT setting of 2 is required in order for Model 204 to send an XON character to Teletype and Teletype-compatible terminals. 42 Rocket Model 204 Terminal User’s Guide...
Overview The CICS (Customer Information Control System) interface causes a CICS terminal to appear to be a Model 204 terminal. Using the CICS interface introduces changes to the usual responses and mode of operation of a CICS-owned terminal. These changes vary according to the type of terminal and the type of CICS interface.
Selection of terminal support mode Two modes of CICS support are available to Model 204 users of IBM 3270 terminals: full-screen and line-at-a-time. Full-screen terminals allow the entire screen to be formatted and displayed as a single entity while line-at-a-time terminals print all screen inputs and outputs on a line-by-line basis.
CICS interface are described in this section. Getting online To connect to Model 204 using a CICS system interface, first log in to CICS. Check with your system manager for the login procedures defined at your site.
If so prompted, the user can also select an alternate channel name for the line-at-a-time interface. If the interface responds with any other message, control automatically returns to CICS. Refer to the Model 204 Messages Manual for a detailed description of CICS interface messages. Disconnecting To disconnect from the CICS interface, follow these steps: 1.
ENTER key and the data is transmitted from the terminal to Model 204 for processing. Program Function (PF) keys are supported by Model 204 only when you access a screen formatted through the User Language full-screen formatting feature.
Normal headers (system header showing date, time, and page number) Suppress header 0 (system header showing date, time, and page number) Suppress the blank line that normally follows header 0 for nonrequest output 48 Rocket Model 204 Terminal User’s Guide...
IBM 3270 terminals (IODEV = 11) Pausing and canceling output At the end of each page of output, Model 204 pauses to allow the user to read the contents of the screen or to cancel the current request if too much output is being received.
CICS. Output parameters As soon as the Model 204 connection is made, the CICS interface sets the following output parameters to the default values shown in “CICS interface output parameters for IODEV 29” on page 50.
At the end of each page of output, the CICS interface pauses to allow you to interrupt Model 204 or to cancel the current request if too much output is being received. The CICS interface indicates that it is in pause mode by displaying the question mark (?) prompt in the first five positions of the next line on the terminal.
Page 64
If OUTLPP = 0, there is no logical end-of-page, and the interface never executes the pause. The attention key facility is not available on Teletypes for the CICS interface. Pause mode is the only way to control requests that provide more output than desired. 52 Rocket Model 204 Terminal User’s Guide...
Overview The TSO (Time Sharing Option) interface causes a TSO terminal to appear to be a Model 204 terminal. The TSO interface program is run as a program in the TSO user region, either as a command processor (CP) or as a called program.
Selection of terminal support mode Two modes of TSO support are available to Model 204 users of IBM 3270 terminals: full-screen and line-at-a-time. Full-screen terminals allow the entire screen to be formatted and displayed as a single entity whereas line-at-a-time terminals print all screen inputs and outputs on a line-by-line basis.
Invoking and disconnecting from the TSO interface Getting online To connect to Model 204 by using the TSO system interface, the user must first log in to TSO using the procedures defined at the installation. The installation supervisor has the necessary installation-specific information. TSO normally...
CLIST that has been defined by the system manager. Input can also be passed from a TSO file (in full-screen mode only). This alternate means of input to Model 204 is valid only when the interface is executed as a TSO command processor.
Page 69
Resumes processing of the CLIST, reversing the effect of the /INPUTTERM command. If this command is sent as an output line from Model 204 and if TSO was not invoked as a CP (command processor), the TSO user receives the message...
Keyboard unlocked The user enters a line of characters and then signals the end of the line by pressing the Return or Enter key. No data is sent to Model 204 until the Return 58 Rocket Model 204 Terminal User’s Guide...
• Use the TSO input edit conventions defined in the TSO profile. • Reset the EDIT parameter to 1 or 5 (see the Model 204 Parameter and Command Reference Manual) and use the Model 204 input editing conventions. Backpaging TSO supports the Model 204 backpaging feature.
Enter key, and the data is transmitted from the terminal to Model 204 for processing. Program Function (PF) keys are supported by Model 204 only when the user accesses a screen formatted through the User Language full-screen formatting feature.
The values of the first five parameters, which determine the size of the screen, are actually established by the value of MODEL, which corresponds to the terminal model within the 3270 family. Model 204 automatically sets MODEL to the appropriate value for SNA Communications Server (formerly VTAM) 3270s used through TSO, but the user also can reset it.
Pausing and canceling output At the end of each page of output, Model 204 pauses to allow the user to read the contents of the screen and to cancel the current request if too much output is being received. A prompting greater than sign (>) is displayed, indented 25 spaces on the last line of the screen.
On the 3270, the TSO interface does not ordinarily pause at the bottom of the screen to allow the user to interrupt Model 204 or to cancel the current request if too much output is being received. The user can cause TSO to pause by specifying a page size in the OUTLPP parameter.
At the end of each page of output, the TSO interface pauses to allow the user to interrupt Model 204 or to cancel the current request if too much output is being received. The TSO interface indicates that it is in pause mode by ringing the teletype bell twice.
Page 77
Teletypes (IODEV = 29) either a single line or multiple lines of output. It cannot be used to terminate the TSO interface and return to TSO. TSO Interface 65...
(that is, an operating environment that appears to be a separate system). This chapter describes the procedures to be followed when connecting to Model 204 through the CMS terminal interface. Terminals supported The CMS terminal interface supports the use of: •...
(>) is displayed. 3. Log in to Model 204 in the usual way, if not already logged in by a com- mand file in the M204 EXEC (see the CMD option in the section “M204 EXEC options”...
LINE mode. USERID userid User ID of the virtual machine in which the Model 204 program to be accessed is executing. If userid is specified as an asterisk (*), Model 204 is invoked in single-user mode.
Page 82
RETURN command in CMS), the subset string is redisplayed on the terminal at the same point the user had entered it. The SUBSET option is ignored if Model 204 is invoked in single-user mode. CMD filename Name (1-8 characters) of a user-created file containing commands that are to be read as the initial input to Model 204.
Input lines Support is provided for two modes of operation: line-at-a-time and full-screen support. In line-at-a-time mode, when Model 204 is prepared to accept input, it issues the appropriate prompting character and unlocks the keyboard. After entering an input line, the user indicates that the line is complete and transmits the line by pressing the Enter or Return key.
Enter, PA1, PA2, CLEAR, or any PF key. Pausing and canceling output In full-screen mode, Model 204 pauses at the end of each page of output to allow the user to read the contents of the screen or to cancel the current request if too much output is being received.
IBM 3270 terminals (IODEV = 41, ALTIODEV =47) Screen-formatting parameters The screen-formatting parameters listed in Table 6-1 apply to IBM 3270 terminals used in full-screen mode through CMS. The PGSEP parameter is not used with IBM 3270 terminals. Table 6-1. Screen-formatting parameters for CMS 3270s Parameter Meaning Default...
Handling messages from other terminals When Model 204 is running in full-screen mode and one user sends a message or a file to another user’s terminal using the z/VM facilities, confusion can sometimes result. For example, suppose that user A sends a message to user B’s terminal.
The ATTN key serves as the attention key on IBM 2741 and compatible terminals. Pausing and canceling output In line-at-a-time mode, Model 204 pauses at the end of each page of output to allow the user to cancel the current request if too much output is being received.
TERMOPT consists of a series of switches that can be set independently and can be reset to the following values for Teletypes and compatible terminals: Terminal is hard copy (not CRT); no backpaging. Terminal is soft copy (CRT); save and display backpages. 76 Rocket Model 204 Terminal User’s Guide...
Teletype terminals (IODEV = 39, ALTIODEV = 45) Line-editing characters When Model 204 is being run in line-at-a-time mode, all the line-editing characters supported by z/VM can be specified. Refer to the z/VM: CMS User’s Guide for a summary of these characters.
Page 90
Alternatively, the system manager can customize CMS files as discussed in the Model 204 System Manager’s Guide. Note: If identical z/VM and Model 204 symbols are in effect at the same time, unpredictable results can occur. 78 Rocket Model 204 Terminal User’s Guide...
The INTERCOMM interface supports the use of Teletype and 3270 terminals in line-at-a-time mode (IODEV=29). Each of the different terminals that can be interfaced to Model 204 provides different output parameter settings. These are discussed below, along with a description of specific INTERCOMM connect, disconnect, and pause features.
Model 204. The INTERCOMM interface processes the subsystem ID, establishes a connection to Model 204, locks the terminal to this subsystem, and replies: CONNECTED TO M204 3. Now enter any desired system control commands. If the interface responds with any other message, control returns automatically to INTER- COMM.
At the end of each page of output, the INTERCOMM interface pauses to allow the user to interrupt Model 204 or to cancel the current request if too much output is being received. The INTERCOMM interface indicates that it is in...
Invoking and disconnecting from INTERCOMM Disconnecting To disconnect from the INTERCOMM interface, log out of Model 204 in the usual way by entering either: LOGOUT LOGOFF These commands automatically terminate the connection with Model 204. The terminal is unlocked from the subsystem, control returns to INTERCOMM,...
VTAM NTOs 40 Teletype terminals through 75 to 78 through CICS 51 CMS SUBSET mode 5, 70 through INTERCOMM 81 Connecting to Model 204 Attention keys 11 through the CMS interface 68 ATTN (Attention) key 11 using a TTY device 23...
Page 97
2 Model 204 parameters LECHO parameter 13 LANGUSER 2 LEECHO parameter 14 Model 204 procedures. see Procedures LF character 40 Model 204 requests. see Requests LFSCB parameter 9 MODEL parameter 3, 6, 8 Line editing 10 to 11...
Page 98
Physically inconsistent indicator 33 terminal emulators Printing, through CICS 44, 50 IBM code pages 2 Private files, opening 25 IBM hexadecimal codes 2 Privileges, file 25 LANGUSER parameter 2 Procedures Terminal input. see Input 86 Rocket Model 204 Terminal User’s Guide...
Page 99
TSO (Time Sharing Option) 53 to 65 3270 terminals through 60 to 63 CLIST input to 56 to 58 error codes from 58 invoking MODEL 204 from 55 running under TCAM 56 Teletype terminals through 64 to 65 terminals supported by 53...
Page 100
88 Rocket Model 204 Terminal User’s Guide...
Need help?
Do you have a question about the 204 and is the answer not in the manual?
Questions and answers