gtpg2m3nGeneral Macros

RLCHA-Release Chain

This general macro releases the file address of a record and any records chained to it.

Given a file address, record id and RCC character it checks the record found at the address given by comparing the ID and RCC there for agreement with those given. If the record matches, it releases the file address.

If a forward chain is found, it attempts to find the chained record, and repeats the above procedure. The forward chain address field of the record contains F'0' if there is no chained record.

If a hardware error, an ID/RCC discrepancy or an invalid file address occur, it issues a system error.

This macro generates a CREMC macro. The CREMC macro may cause depletion of main core storage.

Format




label
A symbolic name can be assigned to the macro statement.

HDR=
The standard header. Valid values are:

4
Release the chain by using 4-byte file addresses.

8
Release the chain by using 8-byte file addresses.

Entry Requirements

Return Conditions

Programming Considerations

Examples

RLCHA

The RLCHA invocation uses the address in R15 to refer to a data field containing the record id, record code check, and file address of the record to be released. The record is released and any records chained to it are released as well.