|
Programming Interface Information:
This information is NOT intended to be used as Programming Interfaces of z/VM. |
CSFBK
Control Block Contents
CSFBK DSECT
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
Copyright IBM Corporation, 1990, 2001