Browse Prior Art Database

Operator Communication Macro Instruction WTO

IP.com Disclosure Number: IPCOM000073512D
Original Publication Date: 1970-Dec-01
Included in the Prior Art Database: 2005-Feb-22
Document File: 3 page(s) / 98K

Publishing Venue

IBM

Related People

Newman, AO: AUTHOR

Abstract

WTO is a DOS macro-instruction for operator communications through a console typewriter assigned as SYSLOG. (WTO does not support any other devices, such as line printers.) WTO can perform output only or output/input, with or without new-line and audible-alarm functions, and without requiring the coding of GET, PUT, or DTFCN.

This text was extracted from a PDF file.
At least one non-text object (such as an image or picture) has been suppressed.
This is the abbreviated version, containing approximately 53% of the total text.

Page 1 of 3

Operator Communication Macro Instruction WTO

WTO is a DOS macro-instruction for operator communications through a console typewriter assigned as SYSLOG. (WTO does not support any other devices, such as line printers.) WTO can perform output only or output/input, with or without new-line and audible-alarm functions, and without requiring the coding of GET, PUT, or DTFCN.

WTO helps the DOS BAL programmer to take advantage of the console buffering, multitasking, and multiple WAIT facilities of DOS.

After the execution of WTO, general register 1 points to a SYSLOG CCB contained in the expansion of WTO. Since the CCB will be posted complete in the same way as are the DOS ECB, TECB, and DTF, the user can check for completion of any one of a mixture of DOS events, including operator communication, by storing register 1 into an ECB list after the execution of WTO. If this is not done, a WAIT-(1) should be executed after the WTO.

NOTE: WTO is not compatible with DOS/BTAM DTFBT, DECB, and WAIT.

Although the WTO macro is not reentrant, any one expansion of WTO is serially reusable provided that the same expansion is not reused before the previous use has been posted complete. If desired, multiple expansions of WTO can be attached simultaneously within the same partition.

Besides a SYSLOG CCB, each expansion of WTO contains CCW space, code to generate the required channel program, and (optionally) the user's output text. The input area and (optionally) the output area are in the user's program but outside the expansion of WTO.

All the operands of WTO can be supplied by the user in general registers 2 through 12 if he wishes, so that one expansion of WTO can perform a large variety of different operator-communication functions

The external specifications of the WTO macro are set forth in the accompanying drawing at A where: (R): Amy general register 2 through 12. C(R): The value contained in general register R. SYMBOL; The name of the expansion. After execution, register 1 points to SYMBOL+4, which is also the address of the CCE inner macro for SYSLOG. OUTAREA: The address of the user's message text. OUTLENGTH: The length (in bytes) of the user's message text. Values of 1 through 120 are permitted. If (R) is coded, C(R) is not validated. OUTTEXT: The actual user's message text in Assembler DC operand form. The text and the length are assembled in line. Character strings of length 1 through 120 are permitted. The trailing comma need be coded only if input operands are also coded. INAREA: The address of the user's input area....