POINTR (Point to Noted Record) Macro
The macro repositions the file that is specified by filename to the record identified by previously issuing a NOTE macro.
If a READ follows the POINTR, the record noted by NOTE is the record read (tape or DASD).
For magnetic tape, a WRITE must not follow a POINTR.
For a work file on disk, if a WRITE UPDATE follows the POINTR, the noted record is written (or overwritten). If a WRITE SQ follows the POINTR, the record after the noted one is written (or overwritten) and, on CKD DASD, the remainder of the track is erased (overwritten with zeros). On an FBA disk, the remainder of the CI is erased (overwritten with zeros) and an SEOF is written (the following CI is also overwritten with zeros).
Format
Requirements for the caller
- AMODE:
- 24
- RMODE:
- 24
- ASC Mode:
- Primary
Parameters
- filename | (1)
- The filename can be expressed either as a symbol or in register notation.
- address | (0)
- Specifies the virtual storage location of either a 4-byte record identifier or a 4-byte record identifier followed by a 2-byte track or CI capacity. The 4- or 6-byte number must be in the form that is obtained from the NOTE macro. The 2-byte track or CI capacity is required only when a WRITE SQ is to be issued following the POINTR.