QUIP Software Logo

QGEN keywords and directives

Data directives (files to read and write):

INTAP[n] Input data files (read)
INDATA[n] Data insert files (read)
OUTAP[n] Output data files (write)
LISTING Spec listing file name (write)
REPORT Printed report file name (write)

Run options:

RUNOPS Identifies the run options line.
CC Card ID location in inserted data.
CLEAR Clear sections of work area between records.
ID Case ID in input data.
IDIN Case ID in insert data.
INSTART Start location in work area for input data.
LENGTH Number of lines per page for printed output.
MAXERR Maximum number of cleaning/error messages allowed.
NOMATCH Turn off file mismatch messages on insert.
OUTSTART Start location in work area for output data.
RECYCLE Request additional spec pass after the last record.
SEQ Check ID sequence of input data.
TEST Limit run to spec test or limited number of cases.
WIDTH Set width of report file.
ZCOUNTER Set decimal places in listing for counters.

Keywords relating to spec compilation:

SETUP ADDRMODE Select data addressing mode.
INSERT Identifies data insert instructions.
DICT Indicates the start of a dictionary. 
TABLE Indicates the start of a lookup table.
END Indicates the end of a lookup table, dictionary or spec file.
STOPLIST Stop listing specs.
STARTLIST Resume listing specs.
STOPSPEC Stop compiling specs.
STARTSPEC [IF...] Resume compiling specs. 
#INCLUDE Include specs from another file.

QGEN instructions

Instructions take from 0 to 4 operands.
Logical instructions cause the data modification or action specified in the result field to take place.
Arithmetic and data conversion instructions place their output in the result field.
Prefixing the letter "C" to any instruction (except LOOP and NOP) makes it conditional on operand A evaluating true.


Logical instructions:

Code Ops Meaning
ALL None Do for all records
AND 1-4 A [and B [and C [and D]]] must be true
IF 1-4 Identical to AND
OR 1-4 A [or B [or C [or D]]] must be true
EOR 2-4 One and only one of A or B [or C [or D]] must be true

Arithmetic instructions:

Code Ops Meaning
ADD 1-4 add A[+B[+C[+D]]] and place sum in result field
DIV 2 divide A by B
MPY 2-4 multiply A*B[*C[*D]]
MPD 3 multiply A*B and divide by C
SUB 2 subtract B from A
SQ 1 square root of A

Comparison instructions (logical):

Code Ops Meaning (F=field compare/N=numeric compare)
FEQ/NEQ 2-4 A equal to B [and C [and D]]
FNE/NNE 2-4 A not equal to B [and C [and D]]
FHE/NHE 2-4 A higher than or equal to B [and C [and D]]
FHI/NHI 2-4 A higher than B [and C [and D]]
FLE/NLE 2-4 A lower than or equal to B [and C [and D]]
FLE/NLO 2-4 A lower than B [and C [and D]]
FRN/NRN 3 A is in range [B to C] inclusive
FNR/NNR 3 A is not in range [B to C] inclusive

Punch instructions (for column binary data only):

Code Ops Meaning
MP 1-4 test for more than one punch present
NEN 2-4 Bit-wise AND of A and B [and C [and D]]]
NET 2-4 Bit-wise OR of A and B [and C [and D]]]
NEX 2 Bit-wise Exclusive OR of A and B
SHI 1 save only highest punch
SLO 1 save only lowest punch
SPB 1-4 test for single punch or blank
TAL 1-4 tally (count) the number of punches

Data conversion instructions:

Code Ops Meaning
ATB 1 translate ASCII to column-binary
BTA 1 translate column-binary to ASCII
DEC 1-4 decode column-binary punches into an ASCII string of 1's and 0's
ED 1 edit a field with a mask
ATE 1 translate ASCII to EBCDIC
ETA 1 translate EBCDIC to ASCII
STR 1-4 convert column-binary punches to a string of ASCII characters

Other instructions:

Code Ops Meaning
LOOP 1-4 repeat instruction, with increments
MOV 1 copy data to another location
NOP None dummy instruction (use as place marker)
TLU 2 Table lookup
TLN 2 Table lookup (numeric)
TLR 2 Table lookup (numeric range)

QGEN actions

Actions are specified with keywords in the result field of a specification line.


File output actions:

DRPn Drop from output stream n (OUTAPn).
GET'prompt' Get (prompted) user input from the keyboard.
LST Print the data area specified to listing file.
PRT Print the data area specified to report file.
SAY Output text to the screen.
SELn Select file n for output.
WRT Write current record immediately to open stream(s).
?<message> Print message if condition is NOT met.

Program control actions:

BCH Branch to subroutine, loop increments are not carried.
EOJ End job after processing current record.
LNK Link to subroutine, loop increments are carried.
RET Return from a subroutine.
SKP Go to another specification line.
SKPEND Skip remaining processing for the current record.

Download a pdf version of this page.