Programming Interface Information:
This information is NOT
intended to be
used as Programming Interfaces of VM/ESA. It is to be used for diagnosis only. |
CSFBK
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
(contains links to field and bit definitions)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
Last updated on 3 Aug 1999 at 11:48:42 EDT.
Copyright IBM Corporation, 1990, 1999