PUTR (PUT with Reply) Macro

The macro is used if a message is to be displayed at the system console and this message requires a reply.

The message is not deleted from the display screen until the operator has issued the reply.

You can use PUTR also with the IBM® 3215 console printer-keyboard, in which case PUTR functions the same as PUT followed by GET for these devices, but provides the message non-deletion code for the display operator console. Use of PUTR for the IBM 3215 is therefore recommended for compatibility, if your program might at some time be run on a computer system with a display operator console.

Use PUTR for fixed unblocked records (messages). Issue PUTR after the record has been built.

Do not use register 2 as base register in any of the PUTR operands.

Format

Read syntax diagramSkip visual syntax diagramnamePUTRfilename(1),workname1(0),workname2(2)

Requirements for the caller

AMODE:
24
RMODE:
24
ASC Mode:
Primary

Parameters

filename | (1)
This operand must be the same as the name of the DTFCN for the file that is being built. The filename can be specified as a symbol or in either special or ordinary register notation. The latter is necessary to make your programs self-relocating.
workname1 | (0)
This operand specifies the output work area name or a register (in either special or ordinary register notation) containing the address of the output work area. The work area address should never be preloaded into registers 1 or 2. This operand is used if records are built in a work area, which you define yourself (for example, using a DS instruction). The length of the work area is defined by the BLKSIZE operand of the DTFCN macro. If workname1 is specified, workname2 must also be specified.
workname2 | (2)
This operand specifies the input work area name or a register (in either special or ordinary register notation) containing the address of the input work area. The work area address should never be preloaded into registers 0 or 1. The operand is used if records are built in a work area, which you define yourself (for example, using a DS instruction). The length of the work area is defined by the INPSIZE operand of the DTFCN macro. If workname2 is specified, workname1 must also be specified.