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 V4R2.0. Last updated on 17 Oct 2001 at 14:58:33 EDT.
Copyright IBM Corporation, 1990, 2001