HONfYMll .
CP-6
APPLICATION PROGRAMMER HANDBOOK
SOFTWARE
SUBJECT
CONTROL PROGRAM-SIX (CP-6)
APPLICATION PROGRAMMER HANDBOOK
A Handbook for the Application Programmer
SOFTWARE SUPPORTED Release B03
ORDER NUMBER
CE55-01 January 1984
Honey",ell
Pre'ace
CESS, the Application Programmer Handbook for the CP-6 system, is a companion manual to CE40, the Programmer Reference Manual. It is intended for use by the applications programmer who is conversant with the CP-6 System language references and language guides, as well as with the Programmer Reference manual.
Documentation would like to express its appreciation to Marketing National Software Support/CP-6 for making selected documents available for inclusion in this handbook.
The Los Angeles Development Center (LADC) of Honeywell Information Systems has developed Computer Aided Publications (CAP). CAP is an advanced text
processing system providing automatic table of contents, automatic indexing, format control, automatic output of camera-ready masters, and other features.
This manual is a product of CP-6 CAP.
Readers of this document may report errors or suggest changes through a STAR on the CP-6 STARLOG system. Prompt response is made to any STAR against a CP-6 manual, and changes will be incorporated into subsequent releases and/or revisions of the manual.
The information in this publication is believed to be accurate in all
respects. Honeywell Information Systems cannot assume responsibility for any consequences resulting from unauthorized use thereof. The information
contained herein is subject to change. New editions of this publication may be issued to incorporate such changes.
The information and specifications in this document are subject to change without notice. This document contains information about Honeywell products or services that may not be available outside the United States. Consult your Honeywell Marketing Representative.
@Honeywell Information Systems Inc., 1984 FileNo.: 1W13 CE55·01
MODULE 1-0 Section - Obtaining Information MODULE 1-1 HELP • •
MODULE 1-2 Displays • • • • • • CHECK and NOTIFY - Comments.
MODULE 2-0 Section 2 - Controlling Terminals MODULE 2-1 Setting Terminal Profiles • • MODULE 2-2 Cursor/Printhead Positioning.
Moving the Cursor • • • • • • • • ESCAPE N • • • • • • • • • • • ESCAPE V - Moving to Character 'N'
Tab Stops • • • • • • • • • • • • • • • • • • • • ESCAPE I • • • • • • • • • • • • • • • • CONTROL R - Forward Positioning • • • • • •
CONTROL H - Backspacing • • • • •
ESCAPE <RET> - Position to Beginning of Record • • • • • • MODULE 2-3
ESC APE ESCAPE ESCAPE ESC APE ESCAPE
Cancelling and Recalling Input • • • • • X - Deleting Current Input Line • • • K - Deleting From Current Edit Point.
A - Setting Pagination Mode • • • •
R - Retyping the Current Input Line • • • • • D - Retrieving the Last Input Line • • • • • • • MODULE 2-4 Inserting/Replacing/Overstriking • • •
ESCAPE J, ESCAPE <CR>, ESCAPE 0, ESCAPE M • • More About ESCAPE J • •
MODULE 2-5 Platen Control.
MODULE 2-6 I M P . . .
Defining New Escape Sequences • • Setting Up Special Function Keys.
Resetting Special Function Keys.
Redefining the Keyboard.
MODULE 2-7 Dribble Files.
Displaying DRIBBLE Files at Your Terminal • •
MODULE 3-0 Section 3 - Editing and Manipulating Files • • MODULE 3-1 Creating New Files.
MODULE 3-2 EDIT Command Files • •
MODULE 3-3 Selecting Record Ranges • •
MODULE 3-4 Moving, Merging, and Copying Files • •
CE55-01 Table of Contents
Contents
Page
2 6 7
8 9 11 11 11 12 12 13 13 13 14 15 1 5 16 16 17 17 18 18 19 20 21 21 22 23 24 26 27 28 29 31 32 35
iii
Contents (cont)
MODULE 3-5 ConditionaL Execution in EDIT Command FiLes • • • • •
EDIT
MODULE 3-6 Listing and Reviewing FiLes.
Listing FiLe Attributes.
REVIEW Command (peL)
Recovering FiLes • •
MODULE 3-7 Changing FiLe Organization.
MODULE 3-8 Changing FiLe Access Attributes.
MODULE 3-9 SeLecting Files • • • • • • • • • MODULE 3-10 Wildcarding • • • • • • • • • • •
Abbreviating Account References Through Wildcarding.
MODULE 3-11 Maintaining File Accounts • • • • • • FiLe Types • • • • • •
Star Fi Les • • • • • • • • • • • • Running Out Of Space • • • • • • • • • • Conserving Disk Space • • • • • • •
Object Units. • • • • • • Source Programs • • • • • • • • •
Run Units. • • • • • • • • • • • • • • • • • Other Fi les. • • • • • •
Keyed Data Fi les • • • • •
Using Files in Other Accounts • • • • • • • • • • • MODULE 3-12 Printing Files on the Lineprinter.
MODULE 4-0 Section 4 - Creating and Running Programs.
MODULE 4-1 IBEX Programming • • • • • • • • •
IBEX Programming Conventions • • • • • • • • • • • • • • Executing Programs • • • • • • • • • • • •
Invoking Language Processors • • • • • • • • • • • • • • • •
Interrupt Processing • • • • • • • •
ALLocating Resources and Establishing Service Limits.
Execute Files. • • • • • • • • • • • Batch Jobs • • • • • • • • • • • • • • •
Command Files. • • • • • • • • • • • • • • • • • • • Data Replacement • • • • • • • • • • • • • •
IBEX Command Labels. • • • • • • • • • Command File Logic - Conditional Execution.
STEPCC • • • • • • • • • • • • • • • •
Program Exit Method • • • • • • • • • • • • • • • • • • • • • IBEX Expressions • • • • • • • • • • • • • • • • • • • • Expression Component - Precedence of IBEX Operators • •
Preprocessing of Commands. • • • • • • • • • • • • BATCH/XEQ Substitution. • • • • • • • • • •
Preprocessor Substitution • • • • • • • • • • • • • • • • • • Examples of IBEX Command Files • • • • • • • • • • • • • • • •
Command File to Read Tape. • • • • • • • • • • • Command File That Interrogates User. • • • • • Setup Fi le • • • • • • • • • • MODULE 4-2 Sample Session.
CESS-01 Table of Contents
Page
39 40 43 43 45 46
47 49 51 52 53 54 54 56 57 57 57 57 58 58 58 59 60
62
63 63 64 65 65 66 67 67 69 69 71 71 72 72 73 74 75 75 75 76 76 77 78 79
iv
Contents (cont)
MODULE 4-3 FPl: CompiLing, linking, Debugging.
MODULE 4-4 Using lINK OverLays • • • • • • • ResoLving Differences and Ambiguities.
Program Trees • • • • • • • • • • • • •
Specifying an OverLay • • • • • • • • • • • • Using lINK to BuiLd a Run Unit with OverLays.
Using lINK's PROMOTE BLANK and PROMOTE lABEL Using HELP • • • • • - • • • • • • • • • • • • MODULE 5-0 Section 5 - PracticaL AppLications.
MODULE 5-1 Creating Sorted Indexes on CP-6 • •
Options.
MODULE 5-2 How to Perform CompiLations in Batch Mode.
MODULE 5-3 A CP-6 System Program with its Own 'HELP' •
MODULE 6-0 Section 6 - Use of Magnetic Tape in the CP-6 System.
MODULE 6-1 RuLes for Tape Usage • •
Tape Management • • • • • • • • • • • • • • • • • • • • • • • • • • • PCl Commands • • • • • • • • • • • • • • • • • • Basic Types of Magnetic Tapes. • • • • • • • • • • • • ANS leveLs of Protection. • • • • • • • • • • • • • • • • Free and Managed Free Tapes. • • • • • • • • • • • • • • • Free Tapes • • • • • • • • • • • • • • Managed Free Tapes • • • • • • • • • • • Comparisons - Free and Managed Free. • • • • • • • • • ANS labeLed Format • • • • • • • • • • • • • EBCDIC labeLed Format. • • • • • • • • • • • • • • Mixing of CP-6, ANS, and EBCDIC labeLed. • • • • • • • • • • Tape Fids. • • • • • • • • • • • • • • • • • • • ANS Tape Fids. • • • • • • • • • • • • • • • Tape Fids May Need Quotes. • • • • • • • • • • • • • • MuLti-reeL Tape Fids • • • • • • • • • • • • • • • • Acquiring Tape Drives. • • • • • • • • • • •
MOUNT Command. • • • • • • • • • • • • • • • RESOURCE, ORESOURCE, and ACQUIRE Commands • •
DefauLt Tape Drive Assignments • • • • • • • • • logicaL Density • • • • • • • • • • • • • • • • • SingLe-density and Mixed-density Systems
ExampLes of OnLine Use • • • • • • • FiLe Sequence Numbers • • • • • • • Hardware limitations • •
Minimum Record Size.
lost Data • • • • • • •
Number of Bytes Stored on Tape • FiLe Management Buffers.
DC B s . • . • • • • • • • • • • • • MODULE 6-2 Tape Commands, Options,
Introduction • • • • • • • • PCl Tape ControL Commands • • • PCl and !SET Output Options.
!SET Command Options.
PCl Input Options • • • PCl Output Options.
PCl vs SET • • • • • Monitor Service CaLLs~
M$DCB~ ; • ; • ; ; •
and CaLLs.
CE55-01 TabLe of Contents
Page
88 95 97 97 98 102 103 104 105 106 109 111 113 114 114 114 115 116 117 117 117 118 118 119 119 119 119 120 120 120 121 121 121 122 122 123 125 127 127 127 127 128 128 129 129 129 130 130 132 133 135 135 136
v
Contents (cont)
M$OPEN - OPEN DCB • • • M$CLOSE - CLOSE DCB • • •
M$CVOL - CLOSE VOLUME • • • • • MSREAD - READ RECORD • •
MSWRITE - WRITE RECORD • • • • • MSPRECORD - POSITION TO RECORD MSREW - REWIND • • • • • • MSPFIL - POSITION FILE • • • • MSWEOF - WRITE END-OF-FILE • • • MSREM - REMOVE OR RELEASE VOLUME MSTRUNC - TRUNCATE BUFFERS • • • MODULE 6-3 CP-6 System Tape Processing •
Automatic Volume Recognition • • • • • • Tape Resource Management • • • • • • CP-6 Tape File Management • •
Anomalies and Errors
MODULE 6-4 How to Make Tapes That Other Machines Can Read • • Tape Types in CP-V and CP-6 • • • • • • • • • • • • • • • C reat i ng Tapes • • • • • • • • • • • • • •
ANS Tape Options at a Glance • • • • • • ANS Tape Options - Complete Description.
Block Sizes for ANS Tapes • •
MODULE 6-5 Converting Imported Tapes For CP-6 Use • • Introduction • • • • • • • •
How to Make ANS Tapes on CP-V for CP-6 Use Making ANS Tapes on Multics for CP-6 Use ANS Tapes Made On Other Systems.
MODULE 6-6 How to Copy Tapes • • • • • • • Making Tape Copies • • • • • • • • • • • •
Making Copies of Labeled Tapes • • • • • • • • • • • • Copying Managed Free Tapes • • • • • • •
Copying Free Tapes • • • • Extension of Tape Files • •
ASCII TO EBCDIC Conversion • • • • • • Making a Tape Copy for Export.
Copying Binary Data to Tape • • •
Copying ANS Tapes Made on Other Systems.
Block Size • • • • • • • • • • • • • • • • • Blocked Tapes and FPOOL Buffers • • • • • Block Size Versus Efficiency. • • • • MODULE 6-7 Multi-reel Tapes.
Creating Multi-volume Tape Sets.
Using Volume Sets • • • • • • •
Page
139 140 141 142 142 142 143 143 144 144 144 145 145 146 147 148 149 149 150 1 51 151 152 153 153 153 154 155 156 156 156 157 157 157 158 158 158 159 159 159 159 161 161 162
MODULE 6-8 Tape Formats. • • • • • • • • 164
CP-6 Tape Formats. • • • • • • • • • • • • • • 164 User Labels. • • • • • • • • • • • • • • • • 165 Additional ANS Labels.. • • • • • • • • • • • • • • • • • 166
ANS Labeled Structure. 166
CES5-01 Table of Contents vi
MODULE 6-9 TAPE ERRORS Introduction
I/O Errors
Free Tape Errors Volume End Errors.
Volume Change Errors
Data Record Structure Errors Break Error Messages
Operator-generated Errors.
Errors and Protection level.
Access limitation Errors
Tape Type and Tape Format Errors Miscellaneous Errors
Tape Error Message Summary Index.
TABLES
Types of Tape
ANS levels of Protection.
PCl Tape Commands
!SET Options (Tape) PCl Input Tape Options.
PCl Output Tape Options
MSDCB and MSOPEN Tape Options Additional MSOPEN Tape Options.
Primary ANS Tape labels User labels
Additional ANS labels I/O Errors.
Free Tape Errors.
Volume End Errors
Volume Change Error Messages.
Data Record Structure Errors.
Break Error Messages.
Operator-generated Errors Protection level Errors Access limitation Errors.
Tape Type/Format Errors
Miscellaneous Tape Error Messages Tape Error Message Summary.
FIGURES
Tape Structure.
CESS-01 Table of Contents
Contents (cont}
Page
168 168 168 169 170 171 171 173 173 174 17S 175 176 177 i-1
115 116 129 131 132 134 136 140 165 166 166 168 169 170 171 172 173 174 174 175 175 176 177
167
vii
About This Manua'
This is a user's handbook and is intended to be function oriented, i.e., to show "how to do" various tasks that represent the capabilities of the CP-6 system. It should be us~d in conjunction with the Programmer Reference Manual, CE40, which is organized as an encyclopedic manual containing all of the commands and syntaxes for various CP-6 processors, along with detailed descriptions of the CP-6 file system and terminal editing features.
Users will find the CP-6 HELP facility useful in providing on-line access to reference data such as command syntax.
This manual is organized into six sections:
Section 1 Section 2 Section 3 Section 4 Section 5 Section 6
Obtaining Information Controlling Terminals
Editing and Manipulating Files Creating and Running Programs Practical Applications
Use of Magnetic Tape in the CP-6 System
Module 4-4 and Section 6 are new additions to this revision of the manual.
The CP-6 Application Programmer Handbook is conceived as a dynamic document which can grow and be modified in future editions to reflect user needs and input.
CE55-01 About This Manual vii i
Not.tion Con"entions
Notation conventions used in command specifications and examples are listed below.
Convention
CAPITAL LETTERS
lowercase letters
Special Characters
Brackets
Braces
CE55-01
Meaning
Capital letters must be entered as shown for input, and will be printed as shown in output.
Lowercase letters identify an element that must be replaced with a user-selected value.
AP i could be entered as AP 2.
Numbers that appear on the line (i.e., not subscripts), special symbols, and underlines appear as shown in output messages and must be entered as shown when input.
#xxx could be entered as #011.
An element inside brackets is optional. Several elements separated by an "or" bar inside a pair of brackets means that the user may select anyone or none of those
elements.
[ key] means a key value may be entered.
When enclosing keywords, brackets signify that all or part of the bracketed portion may be entered.
K[EY] can appear as K, KE, or KEY.
Elements placed inside a pair of braces identify a required choice. These are always used with the Or bar
( I ) •
Notation Conventions i x
Convention
Or Bar
Ellipsis
Meaning
The Or bar also separates elements in a required choice.
{Alid} means that either the letter A or the value of id must be entered.
The horizontal ellipsis indicates that a previous
bracketed element may be repeated, or that elements have been omitted.
option(,option]... means that one or more options may be entered, with a comma inserted between each variable.
Careted Letters
Letters inside carets indicate the keys on a physical terminal device.
<ESC> <BS>
backspace key.
means press the escape key and then the
Related Manuals
The following manuals are available to users of the CP-6 System.
ORDER NUMBER CE26 CE28 CE29 CE30 CE31 CE32 CE33 CE34 CE35 CE36 CE37 CE38 CE39 CE40 CE41 CE42 CE44 CE45 CE46 CE47 CE48 CE49 CE50 CE51
CE55-01
TITLE
CP-6 Concepts and Facilities CP-6 SORT/MERGE Reference Manual CP-6 COBOL Reference Manual CP-6 lOP Reference Manual CP-6 FORTRAN Reference Manual CP-6 BASIC Reference Manual
CP-6 Monitor Services Reference Manual CP-6 Operations Reference Manual
CP-6 1-0-S/II Reference Manual CP-6 I-D-S/II DBA Reference Manual CP-6 RPG/II Reference Manual
CP-6 APL Reference Manual CP-6 DELTA Reference Manual CP-6 Programmer Reference Manual CP-6 System Support Reference Manual CP-6 Pocket Guide
CP-6 PL-6 Reference Manual CP-6 Primer
CP-6 COBOL Programmer Guide CP-6 FORTRAN Programmer Guide
CP-6 Text Processing Reference Manual CP-6 TP Applications Programmer Guide CP-6 TP Administrator Guide
CP-6 FPL Reference Manual
Related Manuals x
CE52 CE53 CE54 CE55 CE56 CE62 CE64 HA01 HA02 HA03 HA04 HA05 HA06
CP-6 Text Processing Administrator Guide CP-6 Text Processing Primer
CP-6 1-0-5/11 Guide
CP-6 Application Programmer Handbook CP-6 Pocket Guide to User Documentation CP-6 System Programmer Guide
CP-6 Operations Pocket Guide CP-6 Introduction to ARES CP-6 ARES Reference Manual CP-6 Introduction to MAIL CP-6 MAIL Reference Manual CP-6 Introduction to PCF CP-6 PCF Reference Manual Manuals may be ordered from:
Honeywell Information Systems, Inc.
Publications Distribution Center 47 Harvard Street
Westwood, Massachusetts 02090 Telephone: Customers (617) 392-5235
Honeywell (HVN) 273-5215 (HED MA06)
CE55-01 Related Manuals xi
MODULE 1-0
Section 1 - Obtaining Information
This section shows how to obtain information concerning the CP-6 system through the the HELP facility and by means of the various displays available to the user.
CE55-01 MODULE 1-0 Pag e 1
Section 1 - Obtaining Information
MODULE 1-1 HELP
SETUP: ALas. Somebody swiped my CP-6 reference manuaLs again, and I need to get some work done. I seem to recaLL a highly touted CP-6 HELP facility.
Hmmm •••
Let's see. I want to know about the LDEV command so I can set a Logical device. It wouLd be pretty LogicaL to say "HELP LDEV" to find out about LDEV.
I'LL try it.
!HELP LDEV
Syntax:
LDEV lname [fid][,optionlist]
! ?
Parameters:
Hey, it works! But I want to know what the options are.
When I get an error message on CP-6, I type a question mark to get more information. Maybe this works with this HELP faciLity, too.
lname is a user-assigned LogicaL device name, or the system logical
HE[ADER]=NO IN[DENT]=value LI[NES]=value
!HELP LDEV EXAMPLES
Examples:
There's the option I wanted, INDENT. But I'm stiLL not sure how to use the command. Maybe I can get an example.
!LDEV LP01 LPiNORDOR,COPIES=7
means, when LP is used as an output device, the system should send that output
Alright! Now I can issue my LDEV command, but I'll use my own workstation name, and the INDENT option.
!LDEV LP01 LPiINFERNO,IN=100
CESS-01 MODULE 1-1
HELP
Page 2
The other day I saw Dennis getting information about the ASCII character set on his terminal. I wonder if that's in HELP.
!HELP ASCII
To obtain information about the ASCII character set, enter:
!HELP ASCII character where character is:
A character or mnemonic (for unprintables) An octal value in the form 0'000' A decimal value in the form D'ddd' A hexadecimal value in'the form X'xx'
To list the entire ASCII character set, merely type ??<CR> at the next prompt.
I don't want the entire ASCII set, but HELP tells me that I can obtain information about an individual character.
I'll try that.
!HELP ASCII 4
4 0'064' 0'052' X'34' Four
!HELP ASCII 0'123'
S 0'123' D'083' X'53' Uppercase Letter
HELP gave me the information I requested. Now I want to ask for information about escape sequences:
!HELP ESCAPE A
<ESC> <A>
Toggles (reverses the setting) CRT pagination mode. When on, output will halt at the end of each screen full of output, relative to the last input line (depends upon whether relative pagination is on.) Hitting carriage return resumes output.
This is all very interesting. I wonder if there's an easy way to find out about all the information I can get from this HELP file. I think I'll try just a plain, old
"HELP".
!HELP
Welcome to 803 HELP!
The HELP command prints information about CP-6 and its processors (system programs).
The message you are reading tells how to use the HELP command, and a little about how the HELP information is structured.
We suggest that you read this entire message before actually issuing HELP commands.
Now type a question mark .,?" followed by a carriage return.
to get the next part of this message.
Type
! ?
<?><CR>
You have now learned an important lesson about HELP. Typing a question mark displays next part of the message.
Just for your information, typing a double question mark (??) will print all the parts of the message.
For example, if you typed ??<CR> at the next "!" prompt, the entire remaining description of HELP will be printed.
CE55-01 MODULE 1-1
HELP
Page 3
But don't type a doubLe question mark yet. Just enter a singLe question mark for more information about HELP.
Type
! ?
<?><CR>
Let's Look at the generaL ruLes about HELP. You can aLmost aLways find out how to call a processor by entering:
HELP (processor) For exampLe:
HELP (BASIC)
prints the syntax of the call to BASiC. in some processors, a description of the processor is printed instead.
That tells me a lot. I can put a processor name in
parentheses to get more information about that processor.
Like this, I suppose:
! HELP (EDIT) RR Syntax:
RR [n1[-n2]]
I wonder if I can get the same information if I'm actually in EDIT?
!EDIT
EDIT B03 HERE
*HELP RR Syntax:
RR [n1[-n2]]
*END
This is beginning to make sense. I wonder what's in the COBOL HELP facility?
!HELP(COBOL)
The COBOL compiler is invoked by using the standard CP-6 processor invocation line.
Format:
[{ON } ]
!COBOL [source[, update]] [{OVER} [object][, listout]] [(optionlist)]
[{INTO} ]
That gave me the COBOL compiler invocation. Now I'll try COBOL OVERVIEW •••
!HELP(COBOL)OVERVIEW
The following list gives an overview of the major groups of topics provided by the COBOL HELP (COBOL) facility
COBOL DIV for COBOL divisions COMPILER
IMPERATIVE VERBS VERB CATEGORIES
SEGMENTATION SAMPLE PROGRAM
Each of the above topics, when requested provides
general information and a HELP (COBOL) pointer or pointers to specific information at the end of the topic.
For a complete list of topics, enter:
HELP (COBOL) TOPICS
CE55-01 MODULE 1-1
HELP
Page 4
!HElP (PCl) TOPICS BREAK RESPONSE COpy ALL COPYSTD
WILD DESTINATION
!HElP (PCl) TOPICS BREAK RESPONSE COpy COPY All
!HElP (PCl) TOPICS BREAK RESPONSE
CE55-01
Hmmm ••• I think IILL try PCl TOPICS •••
BUILD DCBS
COMMANDS DELETE
COMPLEX COMPONENTS COPY DElETESTD DESTINATION
That seems Like a pretty reasonabLe List for the PCl processor. Too bad that the top Lines went off my screen (I forgot to set <ESC><A> for CRT pagination). IILL try tog e t, ash 0 r ten e d Lis t :
B - C BUILD COPYSTD Or maybe B
BUILD
I think
COMMANDS COMPLEX
even
I ILL
shorter:
try some more •••
MODULE 1-1 HELP
COMPONENTS COpy
(FA DE TO BLACK)
Page 5
MODULE 1-2 Displays
SETUP: You have logged on and submitted an important batch job. It is necessary to check on the status of the job continually, while
at your terminal.
!BATCH SCE32:HELP 47989 submitted.
!CHECK
You use the CHECK command to see the status of your job, and are told that it is still waiting to run in the batch queue. When using CHECK, you do not have to specify the sysid, since this was "remembered" by the system when you BATCHed the job.
47989 .XXZZYYQ waiting 0 to run at prio 7
!DI PROFILE PROFILES:
CURRENT: TTY AVAILABLE:
7802X72 CDI1203
!DI SETUP
While waiting, you display your current profile and all other available profiles are displayed as well.
SASYNC ADDS200 CDI1203S
SHDLC ADDS25 CDI1205
SRBT ADDS60 CDI1205W
SRBTD ADDS980 CTR6300 You ask for your type of setup file.
SURP BEEDM20 CUMSLV
SETUP: ! XEQ SETUP
!CHECK
You take another look at the batch job. It is still waiting in the batch job queue.
47989 .XXZZYYQ waiting 4 to run at pr;o 7
!DI USER
You decide to check your disk space. DISPLAY USER shows you what user number you have, how much disk space is left in your account, your logon, directory, and setup command f i l e •
XXZZYYQ, 473SINCLAIR SYSID
=
47984 USER NUMBER=
80 DIRECTORY=
XXZZYYQ DISK SPACE REMAINING=
501SETUP: ! XEQ SETUP
You check your job again, and find that it is running.
!CHECK
47989 .XXZZYYQ running 0:35/29:42
CE55-01 MODULE 1-2
Displays
Page 6
! D I
USERS = 75 ETMF = 1
While your job is running, you check on general system usage: DISPLAY shows number of current users, ETMF (execution time multiplication factor) which relates program CPU time to job throughput time, RESPONSE (number of milliseconds that just exceed response time of 90% of responses to terminal requests), and date/time. For a complete listing of available DISPLAY options, use the HELP facility.
90X RESPONSE < 50 MSECS FEB 03 '83 10:35
!STATUS
The STATUS command will display accounting information concerning your system usage.
CON~000:19:33 EX=000:00:04.09 SRV=000:00:23.95 PMME= 4893 CHG= 2.11
You check your job once more and are told it is printing.
You log off.
!CHECK
47989-1 .XXIIYYQ printing on LP04GlLOCAL
!OFF
CHECK and NOTIFY· Comments
The CHECK command reports the current status of jobs for the current user (i.e. waiting to run, running, printing, etc.). Once the job has finished, CHECK tells you how it was completed. A word of caution: once CHECK has reported a job as completed, it forgets the SYSID. If CHECK is used after this, the sysid must be specified.
If you use the NOTIFY command, it will call on CHECK to report on any of your jobs which have changed status since the last report. This occurs upon the completion of each job step.
CE55-01 MODULE 1-2
Displays
Page 7
AfODULE2-0
Section 2 - Controlling Terminal.
This section shows how to control terminals and terminal input, and how the user can record a terminal session through use of the DRIBBLE command.
CE55-01 MODULE 2-0 Page 8
Section 2 - Controlling Terminals
MODULE 2-1 Setting Terminal Proti/es
The CP-6 system accommodates a number of terminal types (i.e, Diablo 1550, Honeywell VIP 7802, etc.) Use the IBEX DISPLAY PROFILE command to obtain a listing of the available ~rofile types.
Immediately after logging on, you should set your terminal profile to tell the CP-6 system what terminal you are using. After logging on successfully, and receiving the IBEX prompt, use the PROFILE command:
!PROFILE DBL1620
This sets the profile for a Diablo 1620.
!PROFILE VIP7801
sets the profile for a Honeywell VIP 7801.
If you use the same terminal every time you log on (or the same terminal type) you can use the permanent form of the PROFILE command:
!PROFILE VIP7801(PERM)
Now every time you log on to the same account, your profile will be
automatically set. You can also make the PROFILE command part of a setup file, which will be executed every time you log on:
!BUILD SETUPS EDIT B03 HERE
*END
1.000 !PROFILE DBL1620 2.000
To execute the above file every time you log on, use the SETUP command:
!SETUP !XEQ SETUPS
You have now instructed the CP-6 system to execute the file SETUPS every time you log on. This will remain in effect until cleared by the SETUP command, i.e., !SETUP RESET. Of course your setup file may be expanded to perform added functions in addition to setting your profile:
!EDIT SETUPS EDIT B03 HERE
*IN 2
2.000 !DONT ECHO 3.000 !PLATEN W=80
4.000 !TABS 3,11,19,27,37,49,57,63 5.000
You have added some new instructions to your setup file, and now request to see the entire file:
CE55-01 MODULE 2-1
Setting Terminal Profiles
Page 9
*TY 1-99
1.000 !PROFILE DBL1620 2.000 ! DONT ECHO
3.000 !PLATEN W=80
4.000 !TABS 3,11,19,27,49,63
* EOF hit after 4.000
The above setup fiLe wiLL set your terminaL profiLe, inhibit the printing of commands from your setup fiLe at your terminaL, set the pLaten width, and preset tabs at your terminaL each time you Log on.
CESS-01 MODULE 2-1
Setting TerminaL ProfiLes
Pag e 10
AfODULE2-2 Cursor/Printh •• d Positioning
When editing or building a file, a quick and easy way to control the
cursor/printhead positioning is to use the many control sequences available on the CP-6 system. While it' is not necessary to memorize all of the escape and control sequences, you should familiarize yourself with some of the more useful controls. The HELP file is a handy tool to list the different
sequences and their definitions. To access the HELP File, type the following after the exclamation point (!) prompt:
!HELP ESCAPE SEQUENCES
Moving the Cursor
Following are some examples to show you how to use a few of the different control and escape keys. The underscore ( ) denotes the placement of the cursor position.
ESCAPE N
To move the cursor to the end of an input line the <ESC> N sequence is used.
1.000 The rain in_Spain falls
To move the cursor to the end of the line simply type
<ESC> N. The cursor moves to the following position and you can resume typing:
1.000 The rain in Spain falls
CE55-01 MODULE 2-2
Cursor/Printhead Positioning
Page 11
ESCAPE V - Moving to Character 'N'
<ESC> V are the first two characters of a three character sequence. The third character In' is the criteria for the search of the input record. If In' is not found, no action is taken.
Consider the foLLowing exampLe with the cursor at the end of the Line:
1.000 I have one smaLe skiLL which Type <ESC> Ve
The curSOr searches the record and stops at 'e'.
1.000 I have one smaL~ skiLL which
Then type' L' and your mistake is fixed.
1.000 I have one smaLL skiLL which
Tab Stops
Input (TAB) stops are set differentLy on the computer than on a typewriter.
Instead of manuaLLy setting the tabuLation stops, you use a "TABS" command. Up to 32 tabs can be set in a sequence. Tabs can be set after the exclamation point ( ! ) prompt or after the asterisk (*) prompt in EDIT.
• Tabs set after the excLamation point prompt (!) remain effective untiL you log off or untiL you turn the command off with the TABS {OINOIOFF}
command.
ExampLe:
!TABS 10,20,30,40
means set the tab stops at 10, 20, 30, and 40.
• Tabs set after the asterisk prompt (*) in EDIT remain effective until you end the editing session or issue the TABS OFF command.
CE55-01 MODULE 2-2
Cursor/Printhead Positioning
Page 12
ESCAPE I
If your terminal does not have a "TAB" key you have the option of moving the cursor to the next input stop with the <CNTL> I or the <ESC> I sequences.
CONTROL R • Forward Positioning
The <CNTl> R sequence is the opposite of backspacing; it moves the cursor one space to the right without altering any skipped characters.
Example:
1.000 I have one small skill which
By holding down <CNTl> and depressing R three times your terminal will display the following:
1.000 I have one small skill which
CONTROL H . Backspacing
The <BS> key moves the cursor one space to the left. If your terminal does not have a BACKSPACE key simply type <CNTl> H and the cursor will backspace.
Example:
1.000 The rain in sp~in
Hold down <CNTL> and type H twice and the cursor will move accordingly:
1.000 The rain in ~pain
CESS-01 MODULE 2-2
Cursor/Printhead Positioning
Page 13
ESCAPE <RET> -Position to Beginning of Record
After typing a Line and finding that it is not right you can return to the beginning of a Line by typing <ESC><RET>.
ExampLe:
1.000 ! don't like this
Type <ESC><RET>
1.000 I don't Like this
CESS-01
and begin typing the line over.
MODULE 2-2
Cursor/Printhead Positioning
Pag e 14
AfODULE2-3 Cancelling and Recalling Input
The CP-6 system has a series of escape keys that make life a lot easier for those programmers who change their minds in mid-s~ream. These escape
sequences allow you to cancel or recall input with ease. To obtain a complete list of the escape sequences from the HELP file, type the following after the exclamation point (!) prompt:
!HELP ESCAPE SEQUENCES
In the following examples the underscore ( ) denotes the cursor position.
ESCAPE X· Deleting Current Input Line
If you change your mind while typing a line, the <ESC> X sequence will clear the current input record to blanks and you can begin retyping the line.
Example:
1.000 Little Bo Peep has lost her ship_
If you decide this isn1t exactly what you want to say, simply type <ESC> X and your input record will look like this:
1.000 Little Bo Peep has lost her ship<X>
1.000
CE55-01
Now you can begin retyping the line.
MODULE 2-3
Cancelling and Recalling Input
Page 15
ESCAPE K - Deleting From Current Edit Point
If you want to delete only a portion of a record, you can use <ESC> K to delete from the current edit point to the end of the record.
Example:
1.000 The rain in Spain falls mainly on the plain.
You reposition the cursor by backspacing:
1.000 The rain in Spain_falls mainly on the plain.
Now you use <ESC> K
1.000 The rain in Spain falls mainly on the plain.
<K>
1.000 The rain in Spain_
As a result the line to the right of the cursor or edit point has been deleted.
ESCAPE A - Setting Pagination Mode
SETUP: You want to use TEXT to display your file named ZEBRA on your CRT. You want to check for proper page breaks, and also to look for typos, mispelled words, and other errors. You enter:
!TEXT ZEBRA
TEXT C01
The computer responds with:
The file starts printing on the CRT but the lines go by so fast that you can't read a word.
PROBLEM: How can you TEXT your file, but halt the output at the end of each full CRT screen?
SOLUTION: After referring to the HELP file under ESCAPE SEQUENCES, you find that by typing <ESC> A you can control the pagination mode on the CRT. The CRT halts at the end of each full screen of output and waits for you to hit
<CR> to resume output.
Example:
!<ESC> A
!TEXT ZEBRA
CE55-01
Since the <ESC> A toggles (reverses the setting), you need only to press <ESC> A to resume normal output.
<ESC> A may be used to control the pagination mode on the CRT for any type of display, so it may be used while in EDIT or while COPYing a file to your CRT.
MODULE 2-3
Cancelling and Recalling Input
Page 16
ESCAPE R . Retyping the Current Input Line
While editing at a hard copy terminal, a line might look like this:
1.000 AD
\BC
1.000 ABCD
If you're not sure what the record actually contains, just type <ESC> R; this cancels the insert mode, and the
current line is retyped like this:
ESCAPE 0 . Retrieving the Last Input Line
The <ESC><D> sequence retrieves the last line of input as if you had just retyped it. This is especially useful if you are typing a long line with basically the same information.
Example:
1.000
2.000 <ESC><D>
1.000
1.000 3.000
CESS-01
WRITE OUT-PUT RECORD FROM CARD-A. <CR>
The terminal displays:
WRITE OUT-PUT RECORD FROM CARD-A.
Backspace and change the 'A' to 'B', and the terminal displays:
WRITE OUT-PUT RECORD FROM CARD-B.
MODULE 2-3
Cancelling and Recalling Input Page 17
AfODULE2-4 In •• rfing/R.placing/O".r.friking
You are reviewing a file called KIWI. You realize that there are certain words that would be more distinguishable if they were underlined. You also notice that you have a few' mispelled words.
How can you insert the required letters into your mispelled words, and underline the words that you want to emphasize?
ESCAPE J, ESCAPE
<CR>,
ESCAPE 0, ESCAPE MBy using several different escape sequences, you can both underline words and insert letters.
Example:
STEP YOU ENTER
---
EDIT KIWI 2 RR 19
3 (backspace to m)
<ESC><J>
4 (Strike I i I and <CR»
5 RR 19 6 <ESC><CR>
7 <ESC><O>
(underscore I Nowl)
<ESC><M> <CR>
8 TY19
COMPUTER RESPONDS
EDIT 803 HERE
*
19.000 Now is the tme for all(carriage moves up one line and prints \)
(i is inserted)
19.000 Now is the time for all (carriage backspaces to beginning of line)
(sets overstrike mode "on") 19.000 Now is the time for all
(resetsoverstrike mode to "off") 19.000 Now is the time for all
COMMENTS: The CRT screen does not have the capacity to display the underscore as well as the overstruck character; it only displays the last character typed. However, it is possible to input the underscore first, and then use
<ESC><O> to enter text characters. In this way, you will be able to read the text on the CRT, although you wonlt see the underscore.
The overstrike mode is a useful one and it can be used for other tasks besides underlining, such as combining Ib l and III to create a I~I, or 1=1 and III to create ',#1.
When using the <ESC><J> sequence the CRT doesnlt display the 1\1 or move down a line, aLthough it stiLL aLLows you to insert a character.
CE55-01 MODULE 2-4
Inserting/Replacing/Overstriking
Page 18
When using <ESC><O> (overstrike mode), remember that you will remain in that mode until you use <ESC><M> to exit.
More About ESCAPE J
It is sometimes useful to combine <ESC><J> with <ESC><Vn>. <ESC><Vn> moves you to an insert point; <ESC><J> can then be used to insert the desired
character. In the following example, the underscore ( ) denotes the placement
of the cursor. -
STEP
2 3 4
5 6 7 8 9
CE55-01
YOU ENTER EDIT PFILE RR 1
<ESC><V.>
<ESC><J>Q
<ESC><J>
<ESC><V.>
<ESC><J>Q
<CR>
TY
COMPUTER RESPONDS
*EDIT 801 HERE 1.000 PL6 XXX.Y 1.000 PL6 XXX.Y 1.000 PL6 XXX.Y
1.000 PL6 XXX.Y 1.000 PL6 XXX.Y 1.000 PL6 XXX.Y
\Q
1.000 PL6 XXXQ.Y
MODULE 2-4
Inserting/Replacing/Overstriking OVER OVER OVER
OVER OVER OVER
OVER ZZZ.Y ZZZ.Y ZZZ.Y
\Q ZZZQ.!..Y ZZZQ.Y ZZZQ.Y
ZZZQ.Y
Page 19
MODULE 2-5 P/.ten Control
SETUP: You want a print-out of a file with the following parameters in the final print-out:
• No more than 65 characters in a terminal line.
• No more than 60 lines to a page.
• No more than 3 lines between the last printable line in the page and the page perforation.
• 0 lines between the perforation and the first printed line.
SOLUTION: You use the PLATEN command to tell the computer that you wish to define the parameters instead of using the defaults. You find that:
• WIDTH (or W) = number of characters in a terminal line.
• LENGTH (or L) = number of printable lines in a page.
• LIMBO (or LI) number of lines between the last printed line and page bottom.
• FIRST (or F) = number of lines between the top of the page and the first printed line.
You insert the following:
!PLATEN L=60,W=65,F=0,LI=3
!TEXT MYFILE
This gives you the desired results.
Determining Platen Settings
When you log on to the CP-6 system, the PROFILE setting for your terminal automatically sets the platen variables. You can use the PLATEN command, followed by a carriage return, to display your current setting. For example:
!PLATEN <CR>
PLATEN: WIDTH = 80 LENGTH = 0
Resetting PLATEN Parameters
Use the PLATEN command to reset any of the variables such as length or width:
!PLATEN W=80
The above command resets the platen width to 80 characters.
CE55-01 MODULE 2-5
Platen Control
Page 20
MODULE 2-8 IMP
You can use the Input Manipulation Processor (IMP) to redefine keystroke sequences and special characters on any terminal. The new sequences or characters may be unique c~mbinations of system escape sequences and special characters, or new special purpose functions.
You can use IMP to redefine the keyboard of one terminal so that it performs like the keyboard of another terminal. Redefined keys can perform commonly used functions or commands, or generate frequently used strings.
This module covers the following three topics:
• Defining new escape sequences
• Setting up function keys
• Redefining the keyboard
The first two show how to create temporary IMP function keys; the last shows how to create a permanently reuseable IMP function.
Defining New Escape Sequences
Try the following example at your terminal to see how IMP works:
!IMP (ADD PRIMARY I=ESC 111 TEXT='xanthocyanopia' I TY)
You now can use the new IMP keyin <ESC><1> to type the word 'xanthocyanopia ' whenever it occurs. You build a file to try this out:
!BUILD PATIENT_HISTORY EDIT B03 HERE
1.000 The patient is suffering from acute 2.000
Here you press <ESC><1>; the word 'xanthocyanopia ' is printed at the terminal. You can then enter the rest of the text.
xanthocyanopia which makes her unsuitable 3.000 as a color specialist at the paint factory.
4.000
!TEXT PATIENT HISTORY ON ME TEXT C01 -
The patient is suffering from acute xanthocyanopia which makes her unsuitable as a color specialist at the paint factory.
When you TEXT the file, the word 'xanthocyanopia ' is included as part of the text.
CE55-01 MODULE 2-6
IMP
Page 21
The above IMP command has been used to add a temporary primary escape
sequence. When this escape sequence is activated, the text of the IMP command is pLaced in the typeahead buffer. Then,.the word 'xanthocyanopia' is entered into the stream of text as if it has just been typed at the terminaL.
You can aLso use IMP to issue frequentLy used commands, such as might be used when you batch a daily report:
!IMP (ADD PRIMARY I=ESC '2' TEXT = 'BATCH DAllY_RPT', CR I TY)
!BATCH DAILY RPT
Now by touching <ESC><2> the report is entered into baten queue. Note that the presence of CR in the IMP command
resuLts in an automatic carriage return.
29859 DAILY RPT.MYACCT running 0:00/9:59
This command aLso adds a temporary primary escape
sequence. The text of the command is read immediateLy and pLaced in the typeahead buffer. The command 'BATCH
DAILY RPT' is then initiated as if it has just been entered by the user.
The above exampLes create temporary IMP function keys which are in effect onLy for the duration of the Logon session.
Setting Up Special Function Keys
If you have an often used source fiLe, the foLLowing IMP command can be used to open the fiLe in EDIT and print the desired number of Lines, in this case 0 through 10:
!IMP (ADD SPECIAL '#' TEXT='EDIT MY_FllE',CR,'TY 0-10',CR TY R
Entering the # character then executes the following sequence at your terminal:
!EDIT MY FILE EDIT B03-HERE
*TY 0-10
1.000 .**************************************************************
2.000 .* *
3.000.* Copyright (c), Honeywell Information Systems Inc., 1983 *
4.000 .* *
5.000 .**************************************************************
6.000 .*
7.000 .FBB
8.000 IIXPAGENOXII 9.000 .FBE
10.000
This example shows how IMP can be used to provide combinations of often typed keystroke sequences. The special character # is defined by the IMP command to activate many keystrokes at once. The text will be echoed to your terminal (if echoplex is on), and the series of commands will be activated using one keystroke instead of several.
The next example adds a special character' to be used in place of an escape key on the keyboard:
!IMP (ADD SPECIAL '" T=ESC R I IN)
CE55-01 MODULE 2-6
IMP
Page 22
A command such as this could be used if the escape key on a keyboard is inconvenient or nonexistent. The \ now becomes an escape key.
These examples create temporary IMP function keys which are in effect only for the duration of the logon session. See Redefining The Keyboard, below, for an example of how to create permanently reuseable IMP functions.
Resetting Special Function Keys
Once you have used IMP to set a special function key, you may need to reset the definition for that key. There are several methods you can use to accomplish this. You can use the IMP DELETE ALL to delete all user-defined input functions. You can also use the IMP DELETE command to delete the special function key, which can then be reset.
CAUTION: You cannot insert the special character as part of the DELETE
command, as this character will always trigger the IMPed substitute. The way out of this 'dilemma' is to use the ASCII octal, decimal, or hexadecimal string equivalent of the character in question.
Examples:
You have set up a special IMP function for the # character. You want to change this function.
!IMP
IMP B03 HERE ->DELETE ALL ->END
!IMP
IMP B03 HERE
->OEL SPECIAL 0'043' ->END
You invoke IMP and use the DELETE ALL to delete the special character input function. Remember, this also deletes any other user-defined IMP input function as well.
You invoke IMP and use the octal equivalent of the # character to delete the special function for that character.
Finding the ASCII Equivalent
To find the ASCII octal, decimal, or hexadecimal string equivalent of a character, use HELP to ask for information about ASCII characters:
!HELP (IBEX) ASCII
You ask HELP for information about ASCII characters, and HELP responds:
To obtain information about the ASCII character set, enter:
!HELP (IBEX) ASCII character where character is:
CESS-01 MODULE 2-6
IMP
Page 23
A character or mnemonic (for unprintables) An octal value in the form 0'000' A decimal value in the form D'ddd' A hexadecimal value in the form X'xx'
To list the entire ASCII character set, merely type ??<CR> at the next prompt.
The table has the following format:
CHAR OCTAL DECIMAL HEX MEANING
! ??
NULL 0'000' SOH 0'001' STX 0'002' ETX 0'003' ECT 0'004'
US 0'037'
SP 0'040'
0' 041' 0'042'
# 0'043'
In answer to your request, HELP has given you the format of the ASCII table. You now enter a double question mark
(??) •
0'000' X'OO' NULL of time fill character 0' 001 ' X' 01 ' St art Of Heading
D'002' X'02' Start Of Text 0'003' X'03' End Of Text
0'004' X'04' End Of Transmission
D '031 ' X'1 F ' Unit Separator 0'032' X'20' SPace
D'033' X, 21' Exclamation Point 0'034' X'22' Quotation Mark D'035' X'23' Number Sign
When you arrive at the # sign in the table, you interrupt with the BREAK key. You now see that the equivalent for # is 0'043' or 0'035' or X'23'. Any of these three strings may be used in conjunction with the IMP ADD or DELETE command in place of the # character.
Redefining the Keyboard
A series of IMP functions can be made into an IMP command file and initiated as part of a normal setup process which occurs at logon. Following is a sample IMP command file built in EDIT for a VIP7801. Notice the abbreviation of ADD (A) and PRIMARY (P) at the beginning of each command, and the
abbreviation of IMMEDIATE READ (I R) in lines 9, 13, and 14. The file name is IMP7801.
CE55-01 MODULE 2-6
IMP
Page 24
1.000 D ALL
2.000 A P I=ESC lei TEXT=ITN 10' ,CR I R TY ECH "TYPE NEXT 10"
3.000 A P I=ESC 10 1 TEXT=ESC,IV I IMMEDIATE READ TYPEAHEAD ECHO 4.000 A P I=ESC 121 TEXT=DC2 I EC READ INPUT
5.000 A P I=ESC 16 1 TEXT=ESC,CR READ INPUT 6.000 A P I=ESC 18 1 TEXT=ESC,INI READ INPUT 7.000 A P I=ESC 1:1 TEXT=ESC,IVI READ INPUT 8.000 A P I=ESC 1<1 TEXT=ESC,IJI READ INPUT
9.000 A P I=ESC 1>1 TEXT=IBATCH STAR RPTI,CR I R TYPEAHEAD ECHO 10.000 A P I=ESC Ip i TEXT=ESC,IDI READ INPUT
11.000 A P I=ESC IRI TEXT=ESC,IXI READ INPUT
12.000 A P I=ESC ITI TEXT=ESC,CR,ESC,IV I,DC2,ESC,IJ I ,DEL,DEL,DEL, DEL,DEL,DEL,DEL,DEL,DEL,DEL,DEL,DEL,DEL,DEL,DEL,DEL,DEL,DEL,
DEL,DEL,DEL,DEL,DEL,DEL,DEL,DEL,DEL,DEL,DEL~DEL,DEL,DEL,DEL,
DEL,DEL,DEL,DEL,DEL,DEL,DC2,BS IMMEDIATE READ TYPEAHEAD ECHO 13.000 A P I=ESC 1\1 TEXT=ESC,INI,ESC,IV I,ESC,IKI I R TYPEAHEAD ECHO 14.000 A P I=ESC I I TEXT=BS,ESC,IO I,ESC,IMI,BS I R TYPEAHEAD ECHO 15.000 A P I=ESC Iii TEXT=ITP 101,CR I R TY ECH "TYPE PRIOR 10"
16.000
Note that line 12.000 is actually one continuous line, limit 255 characters.
The functions provided by the IMP command file are:
EDIT LINE #
LINE 1 LINE 2 LINE 3 LINE 4 LINE 5 LINE 6 LINE 7 LINE 8 LINE 9 LINE 10 LINE 11 LINE 12 LINE 13 LINE 14 LINE 15
CODE KEY
CLEAR/RESET F1
F2 F3 F4 F5 F6 F7 F8 F9 F 1 0 F11 F12 TRANSMIT
FUNCTION
DELETES ALL IMP COMMANDS CURRENTLY EFFECTIVE TYPE NEXT 10 LINES
FIND NEXT BETWEEN WORD BLANK
FORWARD SPACE WITHOUT DELETING (CTL R) BEGINNING OF LINE (ESC CR)
END OF LINE (ESC N) FIND CHAR (ESC V) INSERTION MODE (ESC J) BATCH STAR RPT
RECALL LAST LINE (ESC D) DELETE LINE (ESC X) DELETE FIRST WORD DELETE LAST WORD UNDERSCORE BACKWARDS TYPE PREVIOUS 10 LINES
The special set of IMP commands shown above is then automatically activated each time you log on, if you insert the following IBEX command into a setup command file associated with your user logon.
!IMP IMP7801
This command initiates the IMP processor which reads the IMP commands; the commands take effect immediately. Each command is echoed to the terminal as it is read by IMP.
A second method is to create an object file with the following command:
!IMP IMP7801 OVER IMP7801 OU
!IMP IMP7801 OU
IMP then reads the object file as part of the setup process using this IBEX command:
These commands are also effective immediately, but the commands are not echoed to the terminal during the reading of the file, and are processed slightly faster.
CE55-01 MODULE 2-6
IMP
Page 25
MODULE 2-7 Dribble File.
Have you ever watched a crucial piece of information scroll beyond your view on a CRT terminal and wished you could scroll ba~kwards to see it again? Most CRT terminals do not have'this backwards scrolling capability, but with CP-6 dribble files you can capture your terminal session on a disk file for later examination.
The relevant command to accomplish this wonder is:
!DRIBBLE [(ONIOVERIINTO) fid]
The DRIBBLE command directs your terminal output into a file for later replay.
Examples of the command are:
!DRIBBLE OVER ANYFILE
which causes unconditional replacement of the existing file.
!DRIBBLE INTO OTHERFILE
which will append the forthcoming terminal session onto the end of file OTHERFILE, or create OTHERFILE if it did not already exist.
!DRIBBLE ON NEWFILE
will only start off the dribble process if NEWFILE did not exist when the DRIBBLE command was issued.
The dribble process is turned off with the command:
!DONT DRIBBLE
And after the above command you can copy the file just created to the line printer, edit the file looking for the useful piece of information that
scrolled off your screen, or delete the file because you don't need to record the terminal session any longer.
CE55-01 MODULE 2-7
Dribble Files
Page 26
Displaying DRIBBLE Files at Your Terminal
If you want to dispLay a DRIBBLE fiLe at your terminaL, a word of caution is in order. If the terminal session you recorded with DRIBBLE incLudes control functions such as IMP settings, TAB settings, etc., the DRIBBLE fiLe, when copied to your terminal, will cause these control functions to be performed again. There are a number of ways in which this can be avoided. One way ;s to use the PCL NVFC option:
<COPY DRIBBLEFILE TO ME(NVFC)
This inhibits the function of the VFC (vertical format controL) characters at your terminaL, although the VFC characters wilL be retained in the DRIBBLE fiLe. Or, PCL may be used' to copy the DRIBBLE file and delete the VFC characters:
<COpy DRIBBLEFILE OVER MYFILE(NVFC)
This results in a new fiLe, MYFILE, from which the VFC characters have been removed.
An aLternate method of removing the VFC characters from a DRIBBLE fiLe is to use ELBBIRD.X, if this capabiLity is avaiLabLe at your site:
!ELBBIRD.X DRIBBLEFILE
This copies the file named DRIBBLEFILE over itseLf as an EDIT keyed file. Now you have a keyed file, DRIBBLEFILE, with line numbers starting at 1.000, in increments of 1.000 (the defauLt).
Please note that ELBBIRD.X may not be available at alL sites.
CESS-01 MODULE 2-7
Dribble Files
Page 27
MODULE 3-0 Section 3 - Editing and Manipulating File.
This section shows how to create, edit, and manipulate files.
CE55-01 MODULE 3-0 Page 28
Section 3 - Editing and Manipulating Files
AfODULE3-1 Cr •• fing N.w FII ••
In this example, the BUILD command is used to create four files: FILE1, FILE2, FILE3 and FILE4. FILE1 is created via EDIT, using the default values.
FILE2, FILE3 and FILE4 ar~ created after the user calls EDIT.
FILE3 and FILE4 are then listed to illustrate the difference between your choosing the file type, and allowing the file type to be chosen by default.
Starting from the IBEX (!) level, you enter the BUILD command:
!BUILD FILE1 EDIT B03 HERE
1.000
EDIT responds with a message and line number prompt.
1.000 Mary had a little lamb.
2.000 Its fleas were white as snow.
3.000
You enter a line of input after each prompt and a <CR>
only after the third line prompt to indicate completion of data entry.
!EDIT
EDIT B03 HERE
*
You call EDIT in response to the prompt.
EDIT responds with a message and asterisk prompt.
*BUILD FILE2
1.000 And everywhere that Mary went, 2.000 The fleas were sure to follow.
3.000
You build FILE2.
*BUILD FILE3,10,10
* EDIT stopped
10.000 They followed her to school one day, 20.000 Which was against the rules.
30.000
*BUILD FILE4"QT
* EDIT stopped
You build FILE3, starting at line number 10 and incrementing by 10.
1.000 It made the children itch and scratch 2.000 and unteachable as mules.
3.000
CE55-01
You build FILE4, selecting file type QT.
MODULE 3-1 Creating New Files
Page 29
*L FILE4
ORG TY GRAN NGAV KEY QT 2 0
*L FILE3
ORG TY GRAN NGAV KEY SE , 0
*END
REC 2
REC 2
LAST MODIFIED
LAST MODIFIED
NAME FILE4
NAME FILE3
You list FILE3 and FILE4. Note that FILE4 has a type of QT (user selected) and F!LE3 has a type of SE (the
default).
You type END to return to IBEX.
In the following example, you create FILES consisting of two records (using the COpy ME command), list FILES to illustrate that COpy ME creates a
consecutive file, and delete all five files created during the two examples.
!COPY ME TO FILES
• RECORD1 .RECORD2 .<F>
!L FILES
ORG TY GRAN
CON 1
!DEL FILE?
You use the COPY ME command to create FILES •
You create two records, the contents of which are
"RECORD'" and "RECORD2". The COpy ME routine prompts with a period (.). After the second record is entered, you
input <ESC> <F> (end of file) to exit the routine.
NGAV
o
REC 2LAST MODIFIED NAME FILES
You list FILES, showing the organization to be consecutive.
DELETE FILE?MYACCT ?YESS
FILE1 FILE2 FILE3 FILE4 FILES
S files, 9 granules deleted
CE55-01
You use DEL FILE? to request that all your files starting with "FILE" be deleted. PCL seeks a confirmation of the deletions by asking DELETE FILE? A response of YESS
causes multiple deletions. The files are listed as they are deleted and the number of files and granules freed are listed after the deletions are complete. The use of FILE?
is an example of wildcarding. See Wildcarding module, CESS.
MODULE 3-1 Creating New Files
Page 30
