gtpg2m22General Macros

FILKW-File Keyword

This general macro enables the filing of global keypointable fields or records.

This macro allows the application programmer to request the updating of keypoint records by specifying either the keypoint record name, or a field name in a keypoint record. It also provides the option of restoring the storage protection key in the PSW for the entry to match the application working storage key.

FILKW uses the request keypoint update macro (GLOUC), optionally preceded by the Restore Protection Key macro (KEYRC).

See also the global area program material in the TPF System Installation Support Reference.

Format




Notes:

  1. keypoint1...keypoint8

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

R
Restore protection key.

N
Do not restore protection key.

keypoint1,keypoint2,...keypoint8
Names of those keypoint records to be filed,

FLD
Specify one of the following:

YES
One or more parameters keypoint1 through keypoint8 are field names.

NO
Only names of keypoint records appear in keypoint1 through keypoint8. This is the default.

Entry Requirements

Return Conditions

Programming Considerations

This macro can be executed on any I-stream.

Examples

LABX  FILKW R,@GBLCC,@VXIXV,FLD=YES

At label LABX the call to FILKW requests an update of keypoint @GBLCC at field @VXIXV. The protection key is restored to its normal value and @VXIXV is flagged by the FLD parameter as being a field (as opposed to a keypoint).

Note:
Assume that @VXIXV is a field name in keypoint @GBLCC.