TXXREF PWRFLG
8.3 OPERATOR INTERACTION
TXCCAT is executed via the TXDS control program. Input and output pathnames are passed vi'l . COMMON .. Table 8-1 provides the pathname "defaults., .
The INPUT: parameters may have one to three pathnames separated by commas. The files will .be used to generate an output file. The OUTPUT: parameter contains one pathname to be used for the output file. Input files must preexist and can be either sequential or relative record. Output files are assumed to have the same characteristics as input files, although input records may be modified for output. If input is from a device, the output file is sequential and, if the output file does not exist, it is created. If no output file is specified, the default-system print device is used.
The default-system print device is defined during system generation.
Table 8-L Pathnaine Defaults
Field Input Output
DEV System Disc System Disc
FILE None First Input File Name
EXT SRC First Input Extension
At any point in the processing, the operator can terminate TXCCAT by pressing the event key on the system console. The event key is defined as follows:
820 KSR, 733 ASR, 743 KSR:
911 VDT:
913 VDT:
Control X CMD HELP
NOTE
In order to use this feature, the EVENTK task must have been included during system generation.
8-1 Digital Systems Division
~
____ 94_6_2_S8_-_97_0_1 ______________________________________________ ___8.4.1 TRUNCATE OPTION (TR). The truncate option truncates records to the size spec-:ified. The syntax is as follows:
TRnnnn
where n is a decimal number and four digits is the maximum field size. The following are examples:
TR76 TR0076
Truncate to 76 characters.
Truncate to 76 characters.
8.4.2 FIX RECORDS (FL). This option forces input records to a specified size by either padding with blanks or by truncation. The syntax is as follows:
FLnnnn
where n is a decimal number and four digits is the maximum field size. The following are examples:
, •
Fix records to size nnnn by padding with blanks or by truncation.
Skip nnnn input records, prior to output.
List me, page length
=
nn, default=
55 .Space lines on listing, nn = space count, default = O.
Number lines on listing.
Do not rewind input on open.
Do not rewind output on open.
ANSI Formatted File .
Note: n is a decimal digit and the maximum field size is given by the number of n's.
8-2 tJigital Systems Division
(
c
~---
~ 946258-9701 8.4.3 SKIP RECORDS (SK). This option skips the specified number of input records prior to output. The syntax is as follows:SKnnnn
where n is a decimal number'and four digits is the maximum field size. The following are examples:
SK200, SK0020 SK9999
8.4.4 LIST FlLE (LF). This option lists files and allows the use of the NL and SL option. The numeric field gives the printer page length. If the page length is not specified, 55 lines per page is the default. The syntax is as follows:
LFnn
where n is a decimal number and 2 digits is the maximum field size. The following are examples:
LF LF55 LF06 LF99
8.4.5 SPACE LISTING (SL). This option is only in effect with the list option LF. The syntax is as follows:
SLnn
where n is one or two decimal digits. The following are examples:
SL SLl SL2
Single Spacing . Single Spacing Double Spacing
8.4.6 NUMBER LINES (NL). This Option is only in effect with the list option LF and causes the printing of the line numbers associated with the input lines. The syntax is as follows:
NL
8.4.7 NO INPUT REWIND (RJ). When this option is selected, the input is not rewound when opened. The syntax is a's follows:
RI
8.4.8 NO OUTPUT REWIND (RO). When this option is selected, the output is not rewound when opened. The syntax is as follows:
RO
8.4.9 ANSI FORMATTED FILE (AF). This option will treat the first character of each record as r"""" an ANSI Standard Carriage Control Character. Table 8-3 describes the ANSI character accepted.
~.
Change 3 8-3 Digital Systems Division
~
____ 94_6_2_S8_-_97_0_1 ________________________________________________ ___8.5 EXAMPLES
ANSI Character Blank
o
1 +
Table 8-3. ANSI Carriage Control-£haracters Def'mition Skip one line before printing Skip two lines before printing
Skip to first line of next page before printing Suppress line spacing before printing (overprint)
The following three examples show how to use TXCCAT to: copy a file to a cassette; copy three files to another file; and list a file on a printer. Each example assumes that the TXDS Control Program is active and that a diskette containing TXCCAT is loaded.
Example I:
PROGRAM:
INPUT:
OUTPUT:
OPTIONS:
Example 2:
PROGRAM:
INPUT:
OUTPUT:
OPTIONS:
Example 3:
: TXCCAT/SYS DSC2:TXTSTI/OBJ CSl
FL80
: TXCCAT /SYS
DSC:TXTSTI/SRC,DSC2:TXTSTI/SRC,CSl DSC2 :TXTST3/SRC*
This example assumes that a line printer is included in the system.
PROGRAM:
INPUT:
OUTPUT:
OPTIONS:
8.6 ERRORS
: TXCCAT/SYS DSC2:TXTST3/SRC LP
LF66,SLl,NL
The errors generated by TXCCA T are listed in table 8-4 together with possible corrective action.
84
(
~---
~ 946258-9701 ErrorCANT GET COMMON ILLEGAL OPTION - aa nn -ILLEGAL
PATHNAME nn - READ ERROR nn - WRITE ERROR nn - OPEN ERROR nn - CLOSE ERROR
Table 8-4. TXCCAT Errors Description
System COMMON not in system Option aa not found
Input files does not exist or open error
Error in Reading File Error in Writing File
Error in opening or assigning files Error in closing a file
Note: nnis the system I/O status error_given in Appendix D.
Action
Regenerate system with COMMON Reenter correct option
Correct and Retry Retry
Retry
Correct patlmarne and retry Correct pathoarne and retry
8-5/8-6 Digital Systems Division
(
(
J2~
~_ _ _ _ _ _
946258-9701_
SECTION IX
TXDS STANDALONE DEBUG MONITOR (TXDBUG) UTILITY PROGRAM 9.1 INTRODUCTION
This section discusses the capabilities and operation of the TXDS standalone debug monitor, TXDBUG, explains how to debug under monitor control, gives detailed descriptions of the commands available to the user, and supplies debugging techniques. The following topics are covered:
• TXBUG installation procedures for 733 ASR, 820 KSR, 913 VDT or 911 VDT system consoles.
• A general description of TXDBUG, including functions, features and capabilities.
• A detailed description of the operating procedures necessary to load TXDBUG and the program to be debugged.
• A description of two modes of debugging: one in which the program being debugged executes with minimal TXDBUG intervention, and one in which TXDBUG exercises tight control of the program being debugged.
• A description of TXDBUG command structures, and the operator interface to TXDBUG.
• Detailed descriptions of each of the debug commands.
• A discussion of debugging techniques including general techniques and techniques specific to TX990.
• A discussion of methods used to patch programs (i.e., to correct them in memory rather than at the source code level.)
• A summary of errors which may occur during a debugging session.
The TXDBUG provides for debugging programs which have been designed to operate in a "stand-alone" environment with no operating system support. The debug monitor attempts to
"hide" itself from the program being debugged, using as few machine resources as possible in the performance of debug tasks.
The following minimum hardware system configuration is required to run the standalone debug monitor:
• 990/4 CPU (including 6-s10t chassis and Programmer Panel), 990/5 CPU, or 990/10 CPU.
• When a 990/4 CPU is used, 4096 words dynamic RAM Memory Expansion including Memory Write Protect and Memory Parity are needed.
• 733 ASR Data Terminal, 820 KSR, 913 VDT or 911 VDT.
•
FD Floppy Disc.9-1 Digital Systems Division