1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
|
; $SALUT (4,25,30,41)
;******************* START OF SPECIFICATIONS ***********************************
;
; MODULE NAME: PRINT.COM
;
; DESCRIPTIVE NAME: DOS PRINT program for background printing of
; text files to the list device.
;
; FUNCTION: DOS PRINT program for background printing of
; text files to the list device. The utility is
; constructed of 3 .SAL files. They are:
;
; PRINT_R.SAL - The resident portion of PRINT
; PRINT_T.SAL - The transient portion of PRINT
; PRINT_SR.SAL - The service routines of PRINT
;
; NOTE: The Link order is VERY important for this module.
; This is due to the Resident/Transient nature of
; PRINT.
;
; INT 28H is a software interrupt generated by the
; DOS in its I/O wait loops. This spooler
; can be assembled for operation using only this
; interrupt which is portable from system to
; system. It may also be assembled to use a
; hardware timer interrupt in addition to the
; software INT 28H. The purpose of using
; hardware interrupts is to allow printing to
; continue during programs which do not enter
; the system and therefore causes the INT 28H to
; go away. A timer interrupt is chosen in
; preference to a "printer buffer empty" interrupt
; because PRINT in the timer form is generic. It
; can be given the name of any currently installed
; character device as the "printer", this makes it
; portable to devices which are installed by the
; user even in the hardware case. It could be
; Revised to use a buffer empty interrupt (no
; code is given for this case), if this is done
; the PROMPT and BADMES messages and their
; associated code should be removed as PRINT will
; then be device specific.
;
; NOTE From Aaron Reynolds
;
; BEWARE ALL YEE WHO ENTER HERE.
; PRINT is an amazingly complex program. MS-DOS versions below 3.00 are
; NOT re-entrant, this means that this utility is basically not a
; possibility. It gets by on the fact that it is written by the same
; person who wrote the OS. Since you are not that person, you must be very
; careful about making any modification to this utility. There are a
; number of things which may seem to be unnecessary on first examination.
; BEWARE, almost every line of code is there for a very good reason. The
; order of things is very carefully chosen. PRINT is full of potential
; windows, make sure that you do not open one by careless modification. Do
; not look for a lot of help from the comments, a complete explanation
; would probably fill a book. A succesful modifier will have an in-depth
; knowledge of the internal function of MS-DOS, and of the PRINT utility
; itself through in depth study of the comments AND the code.
;
; ENTRY POINT:
;
; INPUT:
;
; EXIT NORMAL:
;
; EXIT ERROR:
;
; INTERNAL REFERENCES:
;
; ROUTINES:
;
; DATA AREAS:
;
; EXTERNAL REFERENCES:
;
; ROUTINES:
;
; DATA AREAS:
;
; NOTES:
;
; REVISION HISTORY: Ax000 Version 4.0 05/01/87 - first release FG
; Ax001 DCR D201 - Extended Atrib change FG
; Ax002 P 1175 - move msgs back to TRANS FG
; Ax003 P 1487 - PARSE error message problemFG
; Ax004 P 1546 - PARSE error trailing : FG
; Ax005 P 1717 - multiples of same switch FG
; Ax006 P 1996 - Extended open error FG
; Ax007 P 2052 - [PRN] prompt lpt1 error FG
; Ax008 P 2053 - CPSW prints empty file FG
; Ax009 P 2229 - filename truncation FG
; Ax010 D 389 - use transname /server DOS FG
; Ax011 P 3122 - attrib missing /server DOS FG
; Ax012 P 3949 - Error in opening an open FG
; Ax013 P 3949 - open mode - second attempt FG
; Ax014 P 4396 - some messages need STDOUT FG
; Ax015 P 4880 - DRIVERS not recognized FG
;
; PRE-VERSION 4.0 HISTORY:
;
; V1.00 07/03/82
; V2.00 07/05/83 A.R
; New INT 2FH interface, Pathnames, context switch.
; V2.50 09/14/83 M.A.U
; Turned it back to a print
; 11/21/83 M.A.U
; Repaired bug in file cancel code
; 11/28/83 M.A.U
; Added int 23 and 24 handlers to transient.
; 01/27/84 M.A.U
; Allways checks for valid drive.
; V3.00 02/03/84 M.A.U
; Partitioned so as to assemble on a PC
; By the by, it is V3.00 now.
; 05/23/85 K.G.S
; Chains into INT19 (bootstrap) to unhook
; INT_1C (timer) and INT_15 (AT's Wait On Event)
;
; COPYRIGHT: "The DOS PRINT Utility"
; "Version 4.00 (C) Copyright 1988 Microsoft
; "Licenced Material - Program Property of Microsoft"
;
;
;******************* END OF SPECIFICATIONS *************************************
subttl PRINT - Program Organization
page
;******************* START PROGRAM ORGANIZATION *******************************
;
;
;Group / Label Contents File
; �����������������Ŀ Ŀ
;CODER � Data buffer � � PRINT_RM
; �����������������ʹ ��
; � � Ŀ
; � Resident � �
; � Code � �
; � � �
;filequeue --- �����������������Ĵ �
; � Resident � �
; � Initalization� �� PRINT_R
; � Code � �
; �����������������Ĵ �
; �����������������ʹ ��
; � CL1 data � �
; �����������������Ĵ �
; � CL2 data �
; �����������������Ĵ �
; � CLB data � �
; �����������������Ĵ �� PRINT_TM
; � CLC data � �
; �����������������Ĵ �
; � CLD data � �
; �����������������ʹ ��
;DG � Transient � Ŀ
; � code � �
; �����������������Ĵ �
; � DispMsg � �
; �����������������Ĵ �
; � SYSMSG � �
; � Code � �
; � Parser � �
; �����������������Ĵ �
; � Transient � �� PRINT_T
; � data � �
; �����������������Ĵ �
; � Stack � �
;transsize --- ������������������� ��
;
;
;******************* END ROGRAM ORGANIZATION ********************************
subttl PRINT - Data Space
page
INCLUDE SYSVAR.INC
FALSE EQU 0
TRUE EQU NOT FALSE
IBM EQU IBMVER
;IBMVER EQU IBM
;MSVER EQU FALSE
IF MSVER
HARDINT EQU FALSE ;No hardware ints
AINT EQU FALSE ;No need to do interrupt acknowledge
ENDIF
IF IBM
HARDINT EQU TRUE
INTLOC EQU 1CH ;Hardware interrupt location (Timer)
REBOOT EQU 19H ;ROM BIOS "Bootstrap"
AINT EQU TRUE ;Acknowledge interrupts
EOI EQU 20H ;End Of Interrupt "instruction"
AKPORT EQU 20H ;Interrupt Acknowledge port
ENDIF
; The following values have to do with the ERRCNT variable and the CNTMES
; message. The values define levels at wich it is assumed an off-line error
; exists. ERRCNT1 defines the value of ERRCNT above which the CNTMES message
; is printed by the transient. ERRCNT2 defines the value of ERRCNT above
; which the resident will give up trying to print messages on the printer, it
; is much greater than ERRCNT1 because a much tighter loop is involved. The
; bounding event which determines the correct value is the time required to
; do a form feed.
IF IBM
ERRCNT1 EQU 1500
ERRCNT2 EQU 20000
ELSE
ERRCNT1 EQU 1500
ERRCNT2 EQU 20000
ENDIF
;WARNING DANGER WARNING:
; PRINT is a systems utility. It is clearly understood that it may have
; to be entirely re-written for future versions of MS-DOS. The following
; TWO vectors are version specific, they may not exist at all in future
; versions. If they do exist, they may function differently.
; ANY PROGRAM WHICH IMITATES PRINTS USE OF THESE VECTORS IS ALSO A SYSTEMS
; UTILITY AND IS THEREFORE NOT VERSION PORTABLE IN ANY WAY SHAPE OR FORM.
; YOU HAVE BEEN WARNED, "I DID IT THE SAME WAY PRINT DID" IS NOT AN REASON
; TO EXPECT A PROGRAM TO WORK ON FUTURE VERSIONS OF MS-DOS.
SOFTINT EQU 28H ;Software interrupt generated by DOS
ComInt EQU 2FH ;Communications interrupt used by PSPRINT
; Multiplex number 0 and 1
;----- Default (and Maximal / Minimal) Print queue length
MinQueueLen equ 4 ; 4 files worth min
MaxQueueLen equ 32 ; 32 files worth max.
DefQueueLen equ 10 ; 10 files worth
;----- Default (and Maximal / Minimal) Print buffer length
MinBufferLen equ 512 ; set minimum to 512 bytes
MaxBufferLen equ 1024 * 16 ; maximum is 16 K bytes
DefBufferLen equ MinBufferLen ; set default to minimum
;----- Default (and Maximal / Minimal) Time Slice
MinTimeSlice equ 1 ; set minimum to 1
MaxTimeSlice equ 255 ; maximum is 255
DefTimeSlice equ 10 ; set default to 10
;----- Default (and Maximal / Minimal) Busy Tick
MinBusyTick equ 1 ; set minimum to 1
MaxBusyTick equ 255 ; maximum is 255
DefBusyTick equ MinBusyTick ; set default to minimum
;----- Default (and Maximal / Minimal) Max Tick
MinMaxTick equ 1 ; set minimum to 1
MaxMaxTick equ 255 ; maximum is 255
DefMaxTick equ 2 ; set default to 2
;----- Maximum length of a file name (incl nul)
MaxFileLen equ 64
; **************** Bogosity Warning *****************
; Below is the equate that MaxFile SHOULD be. Since the 3.0/3.1 documentation
; documents each queue entry as being 64 chars long. Yes it is known that
; that causes Print to misbehave on files deep in trees. But for
; compatibilities sake, IBM insisted that we change the code back to the
; way it was.
;MaxFileLen equ 63 + 2 + 12 ; 63 characters as Command.com's
; max. path length
; 2 character for the Drive ext.
; 12 characters for the max. valid
; DOS filename
;----------------------------------------
; definition of the MODE bits
; for an extended open
;----------------------------------------
; BITS DEFINED FOR THE MODE WORD
; FORMAT = 0WF00000ISSS0AAA
; Write �����������ٳ �� ���� Access code
; 0 = no commit � �� 0 = read
; 1 = auto commit � �� 1 = write
; � �� 2 = read/write
; Fail action ������������� �� 3 = execute
; 0 = INT 24h �� 4 = FCB
; 1 = return error ��
; ����� Sharing mode
; � 0 = compatability
; � 1 = deny read/write
; � 2 = deny write
; � 3 = deny read
; � 4 = deny none
; Inherit
; 0 = pass handle to child
; 1 = no inherit
;
MODE_COM equ 0100000000000000b ; Auto Commit
MODE_NO24 equ 0010000000000000b ; No 24 - return error
MODE_NOINH equ 0000000010000000b ; No child procees access
; Sharing mode
MODE_SH_COMP equ 0000000000000000b ; 0 = compatability
MODE_SH_D_RW equ 0000000000010000b ; 1 = deny read/write
MODE_SH_D_W equ 0000000000100000b ; 2 = deny write
MODE_SH_D_R equ 0000000000110000b ; 3 = deny read
MODE_SH_D_NONE equ 0000000001000000b ; 4 = deny none
; Access code
MODE_AC_R equ 0000000000000000b ; 0 = read
MODE_AC_W equ 0000000000000001b ; 1 = write
MODE_AC_RW equ 0000000000000010b ; 2 = read/write
MODE_AC_EXE equ 0000000000000011b ; 3 = execute
MODE_AC_FCB equ 0000000000000100b ; 4 = FCB
GET_CPSW equ 3 ; Get state of CPSW
CPSW_on equ 1 ; CPSW is active
major_code equ 0ADh ; INT 2F PRINT semaphore
minor_code equ 040h ; INT 2F PRINTER set and lock CP
;
; The Extended Open mode is set as:
; Shareing Mode - Compatability
; Access - Read
; Inharitance - yes
; -- WARNING ----
; These MUST be set this way
; in order to do a second open
; of a file accross the network
open_mode equ MODE_NO24+MODE_SH_COMP+MODE_AC_R ;AC013;
ignore_cp equ 1 ; dont validate CP - it may be different
; than CON
openit equ 1 ; extended open 'exsists' action
failopen equ 0 ; extended open 'does not exsist' action
Cap_ASCIIZ equ 22h ; Capitalize ASCIIZ string (INT 21 - 65)
;----- Message related information
;================================================
; PRINT Message Skeleton File
;================================================
;util PRINT
;class 1
;use EXTEND19
;use EXTEND20
;use EXTEND21
;use EXTEND22
;use EXTEND23
;use EXTEND24
;use EXTEND25
;use EXTEND26
;use EXTEND27
;use EXTEND28
;use EXTEND29
;use EXTEND30
;use EXTEND31
;class 2
;1 - Too many operands
;2 - Required operand missing
;use PARSE3 ;3 - Not in switch list provided
;4 - Not in keyword list provided
;use PARSE6 ;6 - Out of range specified
;7 - Not in value list provided
;8 - Not in string list provided
;use PARSE9 ;9 - Invalid Parameter
;class A
;def 6 " error reading file",CR,LF,"$"
;def 7 "File not found",CR,LF,"$"
;def 8 CR,LF,LF,"File $"
;def 9 " canceled by operator$"
;def 10 CR,LF,LF,"All files canceled by operator$"
;def 11 "File allocation table bad drive "
;def 12 "A.",CR,LF,"$"
;def 13 "List output is not assigned to a device",CR,LF
;def 14 "Resident part of PRINT installed",CR,LF
;class B
;use 1 COMMON1
;def 2 CR,LF
;def 15 "Cannot use PRINT - Use NET PRINT",CR,LF
;def 17 "PRINT queue is full",CR,LF
;def 18 "PRINT queue is empty",CR,LF
;def 19 "Access denied",CR,LF
;def 20 "Invalid drive specification",CR,LF
;def 21 "Errors on list device indicate that it",CR,LF
; "may be off-line. Please check it.",CR,LF
;class C
;def 22 CR,LF,LF," %1 is currently being printed",CR,LF
;def 23 " %1 is in queue",CR,LF
;use 24 EXTEND2
;def 25 "Pathname too long",CR,LF
;def 26 "File not in PRINT queue",CR,LF
;class D
;def 27 "Name of list device [PRN]: "
;end
;--------------------------------------
; PRINT Equates
;--------------------------------------
MesSerCLASS equ 0 ; Message Service class
DOS_error equ 1 ; DOS extended error
Parse_error equ 2 ; Parse error
CLASS_A equ 0Ah ; PRINT_R message
CLASS_B equ 0Bh ; PRINT_T message
CLASS_C equ 0Ch ; PRINT_T message with insert
CLASS_D equ 0Dh ; PRINT_T message with input buffer where:
CLASS_Util equ 0FFh ; PRINT utility message (Class A - D)
buffered_input equ 0Ah ; Buffered keyboard input
; CLASS 1
ERR0 equ 19
ERR12 equ 31
; CLASS 2
INVPARM equ 9 ; Invalid parameter (PARSE)
; CLASS A
ERRMEST equ 6 ; error reading file
ErrMesT2 equ 7 ; File not found
CanMes equ 8 ; File
CanFilNam equ 9 ; canceled by operator
AllCan equ 10 ; All files canceled by operator
FATMES equ 11 ; File allocation table bad drive
BADDRVM equ 12 ; A.
BADMES equ 13 ; List output is not assigned to a device
GOODMES equ 14 ; Resident part of PRINT installed
; CLASS B
NEXT_LINE equ 2 ; advance to next line
CONFLICTMES equ 15 ; Cannot use PRINT - Use NET PRINT
FULLMES equ 17 ; PRINT queue is full
NoFils equ 18 ; PRINT queue is empty
AccDen equ 19 ; Access denied
InvDrvMes equ 20 ; Invalid drive specification
CNTMES equ 21 ; Errors on list device indicate that it
; may be off-line. Please check it.
; CLASS C
FstMes equ 22 ; %1 is currently being printed
SecMes equ 23 ; %1 is in queue
BadNameMes equ 24 ; %1 File not found
NamTMes equ 25 ; %1 Pathname too long
BadCanMes equ 26 ; %1 File not in PRINT queue
; CLASS D
PROMPT equ 27 ; Name of list device [PRN]:
DOLLAR equ "$"
Std_Out_Dev equ 1
; $SALUT (0,41,46,52)
.xlist
.xcref
BREAK MACRO subtitle
SUBTTL subtitle
PAGE
ENDM
SaveReg MACRO reglist ;; push those registers
IRP reg,<reglist>
PUSH reg
ENDM
ENDM
.xcref SaveReg
RestoreReg MACRO reglist ;; pop those registers
IRP reg,<reglist>
POP reg
ENDM
ENDM
; $SALUT (4,25,30,41)
INCLUDE DEVSYM.INC
INCLUDE SYSCALL.INC
INCLUDE ERROR.INC
INCLUDE FIND.INC
include dpl.asm
INCLUDE PDB.INC
INCLUDE SYSCALL.INC
INCLUDE MI.INC
INCLUDE SYSMSG.INC
include versiona.inc
.list
.cref
MSG_UTILNAME <PRINT>
error_busy EQU 9
error_queue_full EQU 8
error_name_too_long EQU 12
get_ea_by_handle equ 2
IF1
IF IBM
; %out IBM VERSION
ELSE
%out MS-DOS VERSION
ENDIF
ENDIF
BREAK <Segment Definitions>
CodeR Segment public para
CodeR EndS
Code Segment public para
Code EndS
Data Segment public byte
Data EndS
Stack Segment Stack
Stack Ends
DG group Code,Data,Stack
|
