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

#### 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

#### SPLINK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    SPBTSTAC       0FF5 40
    SPCHAR         0FD0
    SPCHAR1        0FE8
    SPCHAR2        0FEC
    SPCHAR3        0FF0
    SPCMCHR        0FF6
    SPCMOD         0FE4
    SPCOPYFG       0FF5 80
    SPCPTRAP       0006
    SPDATLEN       0FC8 00000FD0
    SPENDSIZ       0FFA 00000030
    SPFCB          0FE0
    SPFILID        0FF8
    SPFLAG1        0FF5
    SPFLSHC        0FF4
    SPLKDATA       0010
    SPLKDSZ        0FFA 00000FF0
    SPNDATLN       0FF7 00000FF8
    SPNODEID       0FC8
    SPNXTPAG       0000
    SPORIGID       0FC0
    SPPGLEN        0FF7
    SPPREPAG       0004
    SPRECMAX       0FD8
    SPRECNUM       000C
    SPRMISC        0008
    SPSIZE         0010 00000010
    SPSIZORG       0010 00000FC0
    SPSPLNKC       0FD4
    SPTAG          0006 0000000C
    SPTAGSZ        0006 00000088
    SPTIME         0FFA

This information is based on z/VM V4R3.0. Last updated on 30 Apr 2002 at 18:37:57 EDT.
Copyright IBM Corporation, 1990, 2002