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