IBM: SPLINK

Programming Interface Information: This page documents intended Programming
Interfaces that allow the customer to write programs to obtain the services of VM/ESA.

SPLINK

Prolog

Control Block Contents

SPLINK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

SPLINK Prolog

 NAME       : SPLINK
 DESCRIPTION: VM/SP 370 SPOOL FILE DATA BLOCK
 DSECT      : SPLINK
 FUNCTION   : THIS DSECT WHEN SPOOL FILES NEED TO BE TRANS-
              LATED TO VM/SP FORMAT.  (IT IS ANALOGOUS TO
              THE VM/XA SPDBK.)
 CREATED BY : HCPSXSPL FOR DIAGNOSE X'14' AND SPTAPE COMMANDS.
 DELETED BY : NOT APPLICABLE

SPLINK Control Block Content


SPLINK DSECT
Hex   Dec Type/Val   Lng Label (dup)    Comments
---- ---- --------- ---- -------------- --------
0000    0 Structure      SPLINK         VM/SP 370 SPOOL FILE DATA BLOCK
0000    0 Signed       4 SPNXTPAG       DASD LOC. (DCHR) OF NEXT PAGE
0004    4 Signed       4 SPPREPAG       DASD LOC. (DCHR) OF PREV PAGE
0008    8 Signed       4 SPRMISC        USE VARIES ACCORDING TO CALLER
000C   12 Signed       4 SPRECNUM       NUMBER OF DATA RECORDS IN BUFFER
0010   16 Bitstring    1 SPLKDATA (0)   START OF SPLINK DATA AREA
          00000010       SPSIZE         (*-SPLINK) SIZE IN BYTES
0010   16 Signed       4 * (1004)       AREA FOR CCW'S AND DATA
          00000FC0       SPSIZORG       (*-SPLINK) SIZE WITH ORIGINAL
                                        NODE/USERID
0FC0 4032 Character    8 SPORIGID       DIAGNOSE X'F8' ORIGINATING NODE
0FC8 4040 Character    8 SPNODEID       DIAGNOSE X'F8' ORIGINATING USERID
          00000FD0       SPDATLEN       (*-SPLINK) SIZE WITHOUT ORIGINAL
                                        NODE/USERID
0FD0 4048 Character    4 SPCHAR         3800 CHAR ARR TABLE 0 FOR FILE
0FD4 4052 Signed       4 SPSPLNKC       COUNT OF SPLINKS FOR THIS FILE
0FD8 4056 Signed       2 SPRECMAX       MAX CCW DATA LENGHT IN FILE
0FDA 4058 Character    6 *              RESERVED FOR FUTURE USE
0FE0 4064 Character    4 SPFCB          3800 FCB FOR FILE
0FE4 4068 Character    4 SPCMOD         3800 COPY MOD FOR FILE
0FE8 4072 Character    4 SPCHAR1        3800 ARR TABLE 1 FOR FILE
0FEC 4076 Character    4 SPCHAR2        3800 ARR TABLE 2 FOR FILE
0FF0 4080 Character    4 SPCHAR3        3800 ARR TABLE 3 FOR FILE
0FF4 4084 Bitstring    1 SPFLSHC        S*1 3800 FLASH COUNT
0FF5 4085 Bitstring    1 SPFLAG1        S*2 3800 FLAG BYTE
          1... ....      SPCOPYFG       X'80' MULT COPIES IN ONE
                                        TRANSMISSION
          .1.. ....      SPBTSTAC       X'40' 3800 BTS SPECIFIED
0FF6 4086 Bitstring    1 SPCMCHR        S*3 COPY MODIFICATION TRANSLATE
                                        NUM
0FF7 4087 Bitstring    1 SPPGLEN        S*4 PAPER LENGTH (1/2 - INCHES)
          00000FF8       SPNDATLN       (*-SPLINK) PTR END OF DATA UNLESS
                                        FIRST SPLINK
0FF8 4088 Signed       2 SPFILID        FILID USED FOR VERIFICATION
0FFA 4090 Character    6 SPTIME         SFBTIME- USED FOR VERIFICATION
          00000030       SPENDSIZ       *-SPCHAR END OF BUFFER SIZE IN
                                        BYTES
          00000FF0       SPLKDSZ        *-SPLKDATA Length of the data
                                        area
0004    4 Signed       2 *
0006    6 Signed       2 SPCPTRAP       CPTRAP SPANNED RECORD LENGTH
          00000088       SPTAGSZ        136 VM/SP 370 TAG RECORD LENGTH
          0000000C       SPTAG          12 OFFSET BEYOND SPDATA TO TAG
                                        DATA

SPLINK Storage Layout

*** SPLINK - VM/SP 370 SPOOL FILE DATA BLOCK
*
*     +---------------------------+---------------------------+
*   0 |         SPNXTPAG          |         SPPREPAG          |
*     +---------------------------+---------------------------+
*   8 |         SPRMISC           |         SPRECNUM          |
*     +---------------------------+---------------------------+
*  10 |///////////////////////////////////////////////////////|
*     =///////////////////////////////////////////////////////=
*     |///////////////////////////////////////////////////////|
*     +-------------------------------------------------------+
* FC0 |                       SPORIGID                        |
*     +-------------------------------------------------------+
* FC8 |                       SPNODEID                        |
*     +---------------------------+---------------------------+
* FD0 |          SPCHAR           |         SPSPLNKC          |
*     +-------------+-------------+---------------------------+
* FD8 |  SPRECMAX   |/////////////////////////////////////////|
*     +-------------+-------------+---------------------------+
* FE0 |          SPFCB            |          SPCMOD           |
*     +---------------------------+---------------------------+
* FE8 |         SPCHAR1           |         SPCHAR2           |
*     +---------------------------+------+------+------+------+
* FF0 |         SPCHAR3           |:LSHC |:LAG1 |:MCHR |:GLEN |
*     +-------------+-------------+------+------+------+------+
* FF8 |  SPFILID    |                 SPTIME                  |
*     +-------------+-----------------------------------------+
*1000
*
*** SPLINK - VM/SP 370 SPOOL FILE DATA BLOCK
*** Overlay for SPPREPAG in SPLINK
*
*                                 +-------------+-------------+
*   0 ...                       4 |/////////////|  SPCPTRAP   |
*                                 +-------------+-------------+
*   8
*
*** Overlay for SPPREPAG in SPLINK