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:
- 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,
- as they appear in the GLOBA macro, GLOBY macro or
- as they appear in 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
- The global fields must be defined, and have a valid base, by the use of
the GLOBZ macro.
- If the field name facility (FLD=YES) is to be used, the field names must
appear in a table in the FILKW macro definition and must be equated to the
corresponding keypoint record name.
Return Conditions
- Control is returned to the next sequential instruction.
- If the R parameter is used, the application program protection key will
have been restored. The N parameter will not alter the protection
key.
- If keypointing is active, those keypoints referenced as parameters
(keypoint1 through keypoint8) will have been updated on file.
- The contents of R14 and R15 are unknown. The contents of all other
registers are preserved across this macro call.
- The condition code is unchanged.
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.