|
NAME : HCPSPMBK
DESCRIPTION: SPOOL FILE MAP PAGE BLOCK
DSECT : SPMBK
FUNCTION : TO CONTAIN ASA'S FOR EVERY SPOOL FILE DATA
PAGE (SPDBK) IN A SPOOL FILE. THE SPMBK ALSO
CONTAINS A COPY OF THE SPFBK, SO THAT IT CAN
BE RECREATED WHEN THE SYSTEM IS WARM STARTED.
SPMBK'S ARE FILLED WITH ASA'S WHILE IN SYSTEM
VIRTUAL STORAGE, AND ARE PERIODICALLY CHECK-
POINTED TO DASD.
LOCATED BY :
(1) LOCATED IN SYSTEM VIRTUAL STORAGE BY:
SPAVSPM - SPABK ANCHOR FOR THE CURRENT SPMBK
IN A SYSTEM VIRTUAL PAGE.
(2) LOCATED ON DASD BY:
SPADSPM - SPABK ASA FOR THE SPMBK CURRENTLY
IN SYSTEM VIRTUAL STORAGE.
SPFSTART - SPFBK ASA FOR THE FIRST SPMBK OF A
SPOOL FILE. SPMNEXT CHAINS THE
ASA'S OF SUBSEQUENT SPMBK'S, IF
NECESSARY.
SFNASA - SFNASA IS A TABLE OF ASA'S. EACH
ASA IS FOR THE FIRST SPMBK OF A
SPOOL FILE. THE TABLE IS USED BY
HCPWRMST TO RECREATE THE FILES
WHEN THE SYSTEM IS WARM STARTED.
CREATED BY :
(1) CREATED IN SYSTEM VIRTUAL STORAGE BY:
HCPSFSON - ALLOCATES A PAGE OF SYSTEM VIRTUAL
STORAGE FOR THE SPMBK WHEN A
SPOOL FILE IS OPENED FOR CREATION.
HCPSFSOP - ALLOCATES A PAGE OF SYSTEM VIRTUAL
STORAGE FOR THE SPMBK WHEN A
SPOOL FILE IS PROCESSED ON A REAL
OUTPUT DEVICE.
HCPSFVOP - ALLOCATES A PAGE OF SYSTEM VIRTUAL
STORAGE FOR THE SPMBK WHEN A
SPOOL FILE IS PROCESSED ON A
VIRTUAL CARD READER.
(2) CREATED ON DASD BY:
HCPVSPPW - CHECKPOINTS THE SPMBK BY REWRITING
IT TO DASD EACH TIME A NEW DATA
PAGE (SPDBK) IS WRITTEN FOR CON-
SOLE FILES. FOR ALL OTHER SPOOL
FILES, THE SPMBK IS REWRITTEN
EACH TIME THE SPABK IS FULL.
WHEN THE SPMBK IS FULL, HCPVSPPW
WILL WRITE THE SPMBK TO DASD, AND
ALLOCATE A DASD SLOT FOR ANOTHER
SPMBK.
HCPSFRCL - WRITES OUT THE LAST SPMBK WHEN A
FILE CREATED BY A REAL READER IS
CLOSED. IT ALSO REWRITES THE
FIRST SPMBK WITH THE SPFBK.
HCPSFVCL - WRITES OUT THE LAST SPMBK WHEN
VIRTUAL OUTPUT FILES ARE CLOSED.
IT ALSO REWRITES THE FIRST SPMBK
WITH THE SPFBK AS IT IS WHEN THE
FILE IS CLOSED.
DELETED BY :
(1) DELETED IN SYSTEM VIRTUAL STORAGE BY:
HCPSFRCL - RELEASES THE SYSTEM VIRTUAL PAGE
ALLOCATED FOR THE SPMBK WHEN A
SPOOL FILE CREATED ON A REAL
READER IS CLOSED.
HCPSFVCL - RELEASES THE SYSTEM VIRTUAL PAGE
ALLOCATED FOR THE SPMBK WHEN A
VIRTUAL OUTPUT FILE IS CLOSED.
HCPSFROP - IF A PAGING ERROR OCCURS WHILE
PROCESSING AN SPDBK, THE SYSTEM
VIRTUAL PAGE FOR THE SPMBK IS
RELEASED.
HCPSFVOP - FOR THE SAME REASON AS HCPSFROP.
HCPSFSON - FOR THE SAME REASON AS HCPSFROP.
(2) DELETED ON DASD BY:
HCPSFRDL - WHENEVER A SPOOL FILE IS DELETED
FROM THE SYSTEM.
HCPWRSST - WHENEVER THERE IS A PROBLEM
RE-CREATING A SPOOL FILE DURING A
"FORCE" START. ALSO, IT WILL
DELETE THE SPMBK IF IT DETECTS
THAT THE FIRST ASA IS ZERO, WHICH
MEANS THERE ARE NO DATA PAGES
MAPPED BY THIS SPMBK.
RELOCATION CONSIDERATIONS : None
| |