Programming Interface Information: This information is NOT intended to be used as Programming Interfaces of z/VM.

#### CSFBK

Prolog

Control Block Contents
CSFBK DSECT

Storage Layout

Cross Reference (Contains links to field and bit definitions)

#### CSFBK Prolog

     NAME       : HCPCSFBK
     DESCRIPTION: CHANGE SPOOL FILE ROUTINE COMMUNICATIONS BLOCK
     DSECT      : CSFBK
     FUNCTION   : PASSES COMMAND LINE OPTIONS FROM THE CHANGE AND
                  TRANSFER COMMANDS IN HCPCSC, TO THE ROUTINE HCPCSFCX
                  WHICH SEARCHES THE QUEUES AND EFFECTS THE CHANGES.
                  ALSO PASSES OPTIONS FROM THE SYSTEM DATA FILE CHANGE
                  ROUTINE IN HCPSDFCH TO HCPCSFCX.
     Notes      : The TRANSFER and CHANGE 'TO' commands may have
                  been entered on another system in this Cross
                  System Extensions complex.  When the command
                  is sent to 'this' system, it will run under
                  the System VMDBK.  Various fields, from the
                  issuer's VMDBK are needed by HCPCSC, HCPCSF,
                  and HCPSCO.  They are passed in the GSXBK
                  overlay of the GSDBK, and saved in the CSFBK.
     LOCATED BY : REGISTER 4
     CREATED BY : HCPCSC  - COMMAND PARSING
                  HCPSDFCH - TO CHANGE THE CHARACTERISTICS OF SYSTEM
                  DATA FILE
     DELETED BY : HCPCSC  - AFTER RETURN FROM HCPCSFCX
                  HCPSDFCH - AFTER RETURN FROM HCPCSFCX

#### CSFBK Control Block Content

#### CSFBK DSECT

    Hex   Dec Type/Val   Lng Label (dup)    Comments
    ---- ---- --------- ---- -------------- --------
    0000    0 Structure      CSFBK          CHANGE SPOOL FILE ROUTINE
                                            COMMUNICATIONS BLOCK
    0000    0 Signed       2 *              RESERVED FOR FUTURE IBM USED
    0002    2 Signed       2 CSFSPID        SPOOL ID OF FILE TO BE CHANGED
                                            MARKER
    0004    4 Bitstring    1 CSFOPTS        COMMAND OPTIONS MARKER
              1... ....      CSFSYS         X'80' SYSTEM SPECIFIED
              .1.. ....      CSFSPEC        X'40' SPECIFIC SPOOLID
              ..1. ....      CSFNACT        X'20' OPTION NOT VALID FOR ACTIVE
                                            FILE
              ...1 ....      CSFINEL        X'10' SPID FOUND, FILE NOT
                                            ELIGIBLE
              .... 1...      CSFCLASS       X'08' CLASS SPECIFIED
              .... .1..      CSFCHNG        X'04' PROCESSING "CHANGE" COMMAND
              .... ..1.      CSFXFER        X'02' PROCESSING "TRANSFER"
                                            COMMAND
              .... ...1      CSFORIG        X'01' SPFORIG DETERMINES
                                            OWNERSHIP
    0005    5 Bitstring    1 CSFOPT2        COMMAND OPTIONS
              1... ....      CSFFORM        X'80' SELECT FILES BY FORM
              .1.. ....      CSFCFNMR       X'40' IF ON, FORM IS OPERATOR
                                            FORM NUMBER. IF OFF, FORM IS USER
                                            FORM NAME
              ..1. ....      CSFPGCPY       X'20' COPY COUNT IS PAGE COPIES
                                            (*NNN)
              ...1 ....      CSFFLALL       X'10' FLASH ALL COPIES OF THE
                                            FILE
              .... 1...      CSFDESTF       X'08' SELECT FILES BY DEST
              .... .1..      CSFSIGOP       X'04' 'Unconvert' converted files
              .... ..1.      CSFALTOW       X'02' VMDALTID is the real file
                                            owner
              .... ...1      CSFFMALT       X'01' FROM ALTID was specified
    0006    6 Bitstring    1 CSFYES         POSITIVE OPTIONS
              1... ....      CSFHO          X'80' HOLD OR NOHOLD OPTION
              .1.. ....      CSFKE          X'40' KEEP OR NOKEEP OPTION
              ..1. ....      CSFMS          X'20' MSG OR NOMSG OPTION
              ...1 ....      CSFDI          X'10' DIST OPTION
              .... 1...      CSFSY          X'08' SYS OR NOSYS OPTION
              .... .1..      CSFNA          X'04' NAME OR NONAME OPTION
              .... ..1.      CSFUNCVT       X'02' UNCONVT option for PSF
              .... ...1      CSFASTER       X'01' INVOKED WITH '*' OR DEFAULT
    0007    7 Bitstring    1 CSFNO          NEGATIVE OPTIONS
              1... ....      CSFHO          X'80' HOLD OR NOHOLD OPTION
              .1.. ....      CSFKE          X'40' KEEP OR NOKEEP OPTION
              ..1. ....      CSFMS          X'20' MSG OR NOMSG OPTION
              ...1 ....      CSFDI          X'10' DIST OPTION
              .... 1...      CSFSY          X'08' SYS OR NOSYS OPTION
              .... .1..      CSFNA          X'04' NAME OR NONAME OPTION
              .... ..1.      CSFUNCVT       X'02' UNCONVT option for PSF
              .... ...1      CSFASTER       X'01' INVOKED WITH '*' OR DEFAULT
    0008    8 Bitstring    1 CSFOLDTY       QUEUE ON WHICH FILES TO BE
                                            CHANGED CURRENTLY RESIDE
              1... ....      SPFRDRQ        X'80' FILE IS ON THE RDR QUEUE
              .1.. ....      SPFPUNQ        X'40' FILE IS ON THE PUNCH QUEUE
              ..1. ....      SPFPRTQ        X'20' FILE IS ON THE PRINTER
                                            QUEUE
              ...1 ....      SPFNSSQ        X'10' FILE IS ON THE NSS/DCSS
                                            QUEUE
              .... 1...      SPFIMGQ        X'08' FILE IS ON THE IMAGE
                                            LIBRARY QUEUE
              .... .1..      SPFTRFQ        X'04' FILE IS ON THE SYSTEM TRACE
                                            FILE QUEUE
              .... ..1.      SPFUCRQ        X'02' FILE IS ON THE UCR QUEUE
              .... ...1      SPFNLSQ        X'01' file is on the NLS queue
              111. ....      SPFSTD         SPFRDRQ+SPFPUNQ+SPFPRTQ All
                                            standard files
              ...1 1111      SPFDATA        SPFNSSQ+SPFIMGQ+SPFUCRQ+SPFTRFQ+S
                                            PFNLSQ SDF
              1111 1111      SPFALLQ        SPFSTD+SPFDATA All spool files
    0009    9 Bitstring    1 CSFNEWTY       QUEUE TO WHICH FILES WILL BE SENT
                                            MARKER
              1... ....      SPFRDRQ        X'80' FILE IS ON THE RDR QUEUE
              .1.. ....      SPFPUNQ        X'40' FILE IS ON THE PUNCH QUEUE
              ..1. ....      SPFPRTQ        X'20' FILE IS ON THE PRINTER
                                            QUEUE
              ...1 ....      SPFNSSQ        X'10' FILE IS ON THE NSS/DCSS
                                            QUEUE
              .... 1...      SPFIMGQ        X'08' FILE IS ON THE IMAGE
                                            LIBRARY QUEUE
              .... .1..      SPFTRFQ        X'04' FILE IS ON THE SYSTEM TRACE
                                            FILE QUEUE
              .... ..1.      SPFUCRQ        X'02' FILE IS ON THE UCR QUEUE
              .... ...1      SPFNLSQ        X'01' file is on the NLS queue
              111. ....      SPFSTD         SPFRDRQ+SPFPUNQ+SPFPRTQ All
                                            standard files
              ...1 1111      SPFDATA        SPFNSSQ+SPFIMGQ+SPFUCRQ+SPFTRFQ+S
                                            PFNLSQ SDF
              1111 1111      SPFALLQ        SPFSTD+SPFDATA All spool files
    000A   10 Bitstring    1 CSFOLDCL       CLASS OF FILE TO BE CHANGED
    000B   11 Bitstring    1 CSFNEWCL       NEW CLASS TO BE SET ON FILE
    000C   12 Bitstring    1 CSFCOPY        NEW COPY COUNT
    000D   13 Bitstring    1 CSFFLSHC       NEW FLASH COUNT
    000E   14 Bitstring    1 CSFMODNO       NEW COPY MOD CHAR SET NUMBER
                                            (0-3)
    000F   15 Bitstring    1 CSFSPFYD       SPECIFIED 3800 OPTIONS
              1... ....      CSFFCBS        X'80' 'FCB' SPECIFIED
              .1.. ....      CSFCHRSP       X'40' 'CHARS' SPECIFIED
              ..1. ....      CSFMODS        X'20' 'MODIFY' SPECIFIED
              ...1 ....      CSFFLSHS       X'10' 'FLASH' SPECIFIED
    0010   16 Bitstring    1 * (2)          Reserved for future IBM use
    0012   18 Bitstring    1 CSFCLAFG       Command version issued
    0013   19 Bitstring    1 CSFCMDAU       VMDCMDAU of command issuer
    0014   20 Bitstring    1 CSFCMDPR       VMDCMDPR of command issuer
    0015   21 Bitstring    1 CSFCMDMC       VMDCMDMC of command issuer
    0016   22 Bitstring    1 CSFCTYPE       VMDCTYPE of command issuer
    0017   23 Bitstring    1 CSFCSESY       CSE index of the system on which
                                            the command was issued
    0018   24 Dbl-Word     8 CSFCHFLD (0)   CHARACTER FIELDS (INIT TO BLANKS)
    0018   24 Dbl-Word     8 CSFOWNER       CURRENT OWNER OF FILES
    0020   32 Dbl-Word     8 CSFRECVR       USER TO RECIEVE THE FILES
    0028   40 Dbl-Word     8 CSFFROM        USER FROM WHOM TO TAKE FILES
    0030   48 Dbl-Word     8 CSFDIST        NEW DISTRIBUTION CODE TO BE SET
    0038   56 Dbl-Word     8 CSFOLDES       DEST value of files to be changed
    0040   64 Dbl-Word     8 CSFNDEST       New DEST value for files selected
    0048   72 Dbl-Word     8 CSFFN          NEW FILE NAME, IF ANY
    0050   80 Dbl-Word     8 CSFFT          NEW FILE TYPE, IF ANY
    0058   88 Character    8 CSFOLDFM       FORM OF FILES TO BE CHANGED
    0060   96 Character    8 CSFNEWFM       NEW FORM NAME TO BE SET ON FILE
    0068  104 Character    8 CSFNEWNR       NEW FORM NUMBER TO BE SET ON FILE
    0070  112 Character    8 CSFCFNM        CONSOLE FORM NAME
    0078  120 Character    8 CSFCFMNR       CONSOLE FORM NUMBER
    0080  128 Character    8 CSFUSER        UserID of command issuer
    0088  136 Character    8 CSFDDIST       VMDDIST of command issuer
    0090  144 Character    8 CSFGRPN        VMDGRPN of command issuer
    0098  152 Character    8 CSFALTID       VMDALTID, if specified
    00A0  160 Character    4 CSFFLASH       NEW FLASH NAME
    00A4  164 Character    4 CSFFCB         NEW FCB NAME
    00A8  168 Character    4 CSFCMOD        NEW COPY MODIFICATION MODULE
    00AC  172 Character   16 CSFCHARS (0)   LENGTH ATTR TO CLEAR CHAR0-CHAR3
    00AC  172 Character    4 CSFCHAR0       NEW CHARACTER SET NAME (FIRST)
    00B0  176 Character    4 CSFCHAR1       NEW CHARACTER SET NAME (SECOND)
    00B4  180 Character    4 CSFCHAR2       NEW CHARACTER SET NAME (THIRD)
    00B8  184 Character    4 CSFCHAR3       NEW CHARACTER SET NAME (FOURTH)
              000000A4       CSFCHSIZ       *-CSFCHFLD SIZE OF CSFCHFLD FIELD
    00BC  188 Signed       4 CSFCOUNT       COUNT OF FILES PROCESSED
    00C0  192 Dbl-Word     8 CSFSRQLK       LOCK FOR Q THE FILE IS FIRST ON
    00C8  200 Dbl-Word     8 CSFTGQLK       LOCK FOR Q FILE IS CHANGED TO
    00D0  208 Character    8 CSFNWOWN       THE RECEIVER'S NAME
    00D8  216 Character    8 CSFODOWN       THE SPFUSER'S TABLE ENTRY
    00E0  224 Character    8 CSFPSYID       PROCESSED SYSTEM ID
    00E8  232 Signed       4 CSFNETRY       THE RECEIVER'S TABLE ENTRY
    00EC  236 Signed       4 CSFOETRY       THE SPFUSER'S TABLE ENTRY
    00F0  240 Signed       4 CSFWRKFT       COMMAND ISSUER'S FILEID TABLE
    00F4  244 Signed       2 CSFOSPID       OLD SPOOLID
    00F6  246 Signed       2 CSFPSPID       SAVE PROCESSED SPOOLID IN CASE
                                            THE FILE DISAPPEARS
    00F8  248 Bitstring    1 CSFCXFLG       CHANGE/TRANSFER FLAGS
              1... ....      CSFFREFL       X'80' AT LEAST 1 FILE CHGD IS
                                            NOH/NOSYS
              .1.. ....      CSFSDRSP       X'40' NEED TO SEND 'SPID CHANGED'
                                            RESP
              ..1. ....      CSFINUON       X'20' SPFINUSE TURNED ON BY
                                            CSF.CX
              ...1 ....      CSFCSELK       X'10' FILE'S LOCK OBTAINED BY
                                            HCPCSF
    00F9  249 Bitstring    1 CSFESM         FLAG USED FOR ESM PURPOSES
              1... ....      CSFCMDOK       X'80' VALID COMMAND
              .1.. ....      CSFCDNOK       X'40' INVALID COMMAND
              ..1. ....      CSFESMD        X'20' ESM HAS BEEN CALLED
              ...1 ....      CSFSYNER       X'10' COMMAND HAS SYNTAX ERROR
    00FA  250 Signed       2 CSFNSPID       NEW SPOOL ID
    00FC  252 Bitstring    1 * (4)          RESERVED
    0100  256 Character    8 CSFSCLAB       SECLABEL value
              00000021       CSFSIZE        (*-CSFBK+7)/8 SIZE IN DOUBLE
                                            WORDS

#### CSFBK Storage Layout

    *** CSFBK - CHANGE SPOOL FILE ROUTINE COMMUNICATIONS BLOCK
    *
    *     +-------------+-------------+------+------+------+------+
    *   0 |/////////////|  CSFSPID    |:OPTS |:OPT2 |CSFYES|CSFNO |
    *     +------+------+------+------+------+------+------+------+
    *   8 |:OLDTY|:NEWTY|:OLDCL|:NEWCL|:COPY |:FLSHC|:MODNO|:SPFYD|
    *     +------+------+------+------+------+------+------+------+
    *  10 |/////////////|:CLAFG|:CMDAU|:CMDPR|:CMDMC|:CTYPE|:CSESY|
    *     +-------------+------+------+------+------+------+------+
    *  18 |                       CSFOWNER                        |
    *     +-------------------------------------------------------+
    *  20 |                       CSFRECVR                        |
    *     +-------------------------------------------------------+
    *  28 |                       CSFFROM                         |
    *     +-------------------------------------------------------+
    *  30 |                       CSFDIST                         |
    *     +-------------------------------------------------------+
    *  38 |                       CSFOLDES                        |
    *     +-------------------------------------------------------+
    *  40 |                       CSFNDEST                        |
    *     +-------------------------------------------------------+
    *  48 |                        CSFFN                          |
    *     +-------------------------------------------------------+
    *  50 |                        CSFFT                          |
    *     +-------------------------------------------------------+
    *  58 |                       CSFOLDFM                        |
    *     +-------------------------------------------------------+
    *  60 |                       CSFNEWFM                        |
    *     +-------------------------------------------------------+
    *  68 |                       CSFNEWNR                        |
    *     +-------------------------------------------------------+
    *  70 |                       CSFCFNM                         |
    *     +-------------------------------------------------------+
    *  78 |                       CSFCFMNR                        |
    *     +-------------------------------------------------------+
    *  80 |                       CSFUSER                         |
    *     +-------------------------------------------------------+
    *  88 |                       CSFDDIST                        |
    *     +-------------------------------------------------------+
    *  90 |                       CSFGRPN                         |
    *     +-------------------------------------------------------+
    *  98 |                       CSFALTID                        |
    *     +---------------------------+---------------------------+
    *  A0 |         CSFFLASH          |          CSFFCB           |
    *     +---------------------------+---------------------------+
    *  A8 |         CSFCMOD           |         CSFCHAR0          |
    *     +---------------------------+---------------------------+
    *  B0 |         CSFCHAR1          |         CSFCHAR2          |
    *     +---------------------------+---------------------------+
    *  B8 |         CSFCHAR3          |         CSFCOUNT          |
    *     +---------------------------+---------------------------+
    *  C0 |                       CSFSRQLK                        |
    *     +-------------------------------------------------------+
    *  C8 |                       CSFTGQLK                        |
    *     +-------------------------------------------------------+
    *  D0 |                       CSFNWOWN                        |
    *     +-------------------------------------------------------+
    *  D8 |                       CSFODOWN                        |
    *     +-------------------------------------------------------+
    *  E0 |                       CSFPSYID                        |
    *     +---------------------------+---------------------------+
    *  E8 |         CSFNETRY          |         CSFOETRY          |
    *     +---------------------------+-------------+-------------+
    *  F0 |         CSFWRKFT          |  CSFOSPID   |  CSFPSPID   |
    *     +------+------+-------------+-------------+-------------+
    *  F8 |:CXFLG|CSFESM|  CSFNSPID   |///////////////////////////|
    *     +------+------+-------------+---------------------------+
    * 100 |                       CSFSCLAB                        |
    *     +-------------------------------------------------------+
    * 108
    *
    *** CSFBK - CHANGE SPOOL FILE ROUTINE COMMUNICATIONS BLOCK

#### CSFBK Cross Reference

    Symbol         Dspl Value
    -------------- ---- -----
    CSFALTID       0098
    CSFALTOW       0005 02
    CSFASTER       0006 01
    CSFASTER       0007 01
    CSFCDNOK       00F9 40
    CSFCFMNR       0078
    CSFCFNM        0070
    CSFCFNMR       0005 40
    CSFCHARS       00AC
    CSFCHAR0       00AC
    CSFCHAR1       00B0
    CSFCHAR2       00B4
    CSFCHAR3       00B8
    CSFCHFLD       0018
    CSFCHNG        0004 04
    CSFCHRSP       000F 40
    CSFCHSIZ       00B8 000000A4
    CSFCLAFG       0012
    CSFCLASS       0004 08
    CSFCMDAU       0013
    CSFCMDMC       0015
    CSFCMDOK       00F9 80
    CSFCMDPR       0014
    CSFCMOD        00A8
    CSFCOPY        000C
    CSFCOUNT       00BC
    CSFCSELK       00F8 10
    CSFCSESY       0017
    CSFCTYPE       0016
    CSFCXFLG       00F8
    CSFDDIST       0088
    CSFDESTF       0005 08
    CSFDI          0006 10
    CSFDI          0007 10
    CSFDIST        0030
    CSFESM         00F9
    CSFESMD        00F9 20
    CSFFCB         00A4
    CSFFCBS        000F 80
    CSFFLALL       0005 10
    CSFFLASH       00A0
    CSFFLSHC       000D
    CSFFLSHS       000F 10
    CSFFMALT       0005 01
    CSFFN          0048
    CSFFORM        0005 80
    CSFFREFL       00F8 80
    CSFFROM        0028
    CSFFT          0050
    CSFGRPN        0090
    CSFHO          0006 80
    CSFHO          0007 80
    CSFINEL        0004 10
    CSFINUON       00F8 20
    CSFKE          0006 40
    CSFKE          0007 40
    CSFMODNO       000E
    CSFMODS        000F 20
    CSFMS          0006 20
    CSFMS          0007 20
    CSFNA          0006 04
    CSFNA          0007 04
    CSFNACT        0004 20
    CSFNDEST       0040
    CSFNETRY       00E8
    CSFNEWCL       000B
    CSFNEWFM       0060
    CSFNEWNR       0068
    CSFNEWTY       0009
    CSFNO          0007
    CSFNSPID       00FA
    CSFNWOWN       00D0
    CSFODOWN       00D8
    CSFOETRY       00EC
    CSFOLDCL       000A
    CSFOLDES       0038
    CSFOLDFM       0058
    CSFOLDTY       0008
    CSFOPTS        0004
    CSFOPT2        0005
    CSFORIG        0004 01
    CSFOSPID       00F4
    CSFOWNER       0018
    CSFPGCPY       0005 20
    CSFPSPID       00F6
    CSFPSYID       00E0
    CSFRECVR       0020
    CSFSCLAB       0100
    CSFSDRSP       00F8 40
    CSFSIGOP       0005 04
    CSFSIZE        0100 00000021
    CSFSPEC        0004 40
    CSFSPFYD       000F
    CSFSPID        0002
    CSFSRQLK       00C0
    CSFSY          0006 08
    CSFSY          0007 08
    CSFSYNER       00F9 10
    CSFSYS         0004 80
    CSFTGQLK       00C8
    CSFUNCVT       0006 02
    CSFUNCVT       0007 02
    CSFUSER        0080
    CSFWRKFT       00F0
    CSFXFER        0004 02
    CSFYES         0006
    SPFALLQ        0008 FF
    SPFALLQ        0009 FF
    SPFDATA        0008 1F
    SPFDATA        0009 1F
    SPFIMGQ        0008 08
    SPFIMGQ        0009 08
    SPFNLSQ        0008 01
    SPFNLSQ        0009 01
    SPFNSSQ        0008 10
    SPFNSSQ        0009 10
    SPFPRTQ        0008 20
    SPFPRTQ        0009 20
    SPFPUNQ        0008 40
    SPFPUNQ        0009 40
    SPFRDRQ        0008 80
    SPFRDRQ        0009 80
    SPFSTD         0008 E0
    SPFSTD         0009 E0
    SPFTRFQ        0008 04
    SPFTRFQ        0009 04
    SPFUCRQ        0008 02
    SPFUCRQ        0009 02

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