This general macro is available to file pool programs to run ancillary
functions by the Get File Storage/Replace File Storage programs. The
functions apply to file pool sections that exist in the system.
Format
- label
- A symbolic name can be assigned to the macro statement.
- CQ3STA
- To start recording each file storage address dispensed for GETLC, GETSC or
GETFC requests.
- CQ3STO
- To stop the GFS recording function.
- CQ3TAG
- To start tagging each long term file storage address returned with the
RELFC macro. The 4-byte BCD name of the program using RELFC macro is
used to tag the address.
- CQ3NAG
- To stop the returned file storage address tagging function.
Entry Requirements
R9 must contain the address of the ECB being processed.
Return Conditions
- Control is returned to the next sequential instruction (NSI).
- The contents of R14 and R15 are unknown. The contents of all other
registers are preserved across this macro call.
Programming Considerations
- This macro can be executed on the main I-stream only.
- A CQ3STO request must be used to stop the GFS logging function.
This will also initiate writing the last file storage activity file and the
last dispensing activity log record (CY6TR) on a real-time tape.
- If a system restart occurs while parameter CQ3STA is in effect, GFS will
reinstate the logging function.
- This macro is restricted for use by file pool programs. The
misuse of this macro could be detrimental to the system.
Examples
GFSCC CQ3STA
This invocation starts recording file addresses dispensed for GETLC GETSC
or GETFC macro requests.