Home

Translated by WordPort from WordStar 3.x - 7.0 document

1. MAINTENANCE AND CONVERSION AIDS RENAME_DBD RENAME DBD RECORD RENAME_TXN RENAME TXN RECORD RENAME_APPL RENAME APPL RECORD RENAME_RPL RENAME RPL RECORD RENAME GROUP RENAME GROUP RECORD DELETE_DDN DELETE DDN RECORDS DELETE_DBD DELETE DBD RECORDS DELETE_TXN DELETE TXN RECORDS DELETE_APPL DELETE APPL RECORDS PURGE_RPL DELETE RPL RECORDS DELETE GROUP DELETE GROUP RECORDS COPY_DDN COPY DDN RECORD TO NEW NAME COPY_DBD COPY DBD RECORD TO NEW NAME COPY_TXN COPY TXN RECORD TO NEW NAME COPY_APPL COPY APPL RECORD TO NEW NAME COPY_RPL COPY RPL RECORD TO NEW NAME COP Y_GROUP COPY GROUP RECORD TO NEW NAME PURGE_DDN DELETE DDN RECORDS PURGE_TXN DELETE TXN RECORDS PURGE_DBD DELETE DBD RECORD AND ITS COMPONENT DDN RECORDS PURGE_APPL DELETE APPL RECORD AND ITS COMPONENT DDN TXN DBD RECORDS PURGE_RPL DELETE RPL RECORD AND ITS COMPONENT DDN RECORDS PURGE_GROUP DELETE GROUP RECORD AND PURGE ITS COMPONENT APPL RECORDS DISPLAY_CTL DISPLAY FIELD VALUES FROM THE CONTROL RECORD DISPLAY_DDN DISP
2. AFCT CAFC SHUTDOWN TRANSACTION CAFC PANEL 226 MAP C SELECT OPTION gt AFCT SHUTDOWN THIS TRANSACTION PERFORMS THE FOLLOWING 1 ENQUEUES ON AFCF4000 TO RESTRICT THE BATCH INTERFACE 2 QUIESCES CAFC REQUESTS 3 REMOVES CAFC SUPPORT FOR CICS DLI DCT PCT AND FCT REQUESTS 4 RECORDS NORMAL SHUTDOWN IN AFCF4000 5 CLOSES AMD FREES AFCF4000 6 RELEASES THE ENQUEUE ON AFCF4000 7 TERMINATES AFCP2109 SERVICE PROGRAM AFCT DEQ THIS TRANSACTION PERFORMS THE FOLLOWING 1 RELEASES THE ENQUEUE ON AFCF40000 TO EXECUTE TAB TO DESIRED TRANSACTION AND ENTER s PF3 END PF4 RET To temporarily deactivate the automatic Dynamic Allocation feature of CAFC select AFCT with the SHUTDOWN operand AFCT SHUTDOWN deactivates all extended support facilities closes the CAFC file and shuts down the automatic facilities transaction AFC9 requests from CAFC wi START 1 e transaction from a CEMT 1l be unsuccessful or EXEC CICS commands perform Allocations and Frees for them Open and Close will not have CAFC All requests requiring services To reactivate CAFC simply issue the AFCT The AFCT START and AFCT SHUTDOWN requests may be issued from the Batch C or g
3. SAMPLE FCT WARM START MATRIX FCT WARM START ACTIONS IF LAST REQUEST WAS THEN WARM START ACTION WILL BE BYTE 1 VALUES BYTE 2 VALUES OPEN ENABLE gt OE xX NO ACTION xX NO ACTION CLOSE ENABLE gt CE O OPEN E ENABLE ALLOCATE ENABLE gt AE C CLOSE D DISABLE FREE ENABLE gt FE A ALLOCATE U UNENABLE RECALL ENABLE gt RE F FREE R RECALL BYTE VALUES BYTE 2 VALUES OPEN DISABLE gt OD X NO ACTION X NO ACTION CLOSE DISABLE gt CD O OPEN E ENABLE ALLOCATE DISABLE gt AD C CLOSE D DISABLE FREE DISABLE gt FD A ALLOCATE U UNENABLE RECALL DISABLE gt RD F FREE R RECALL BYTE VALUES BYTE 2 VALUES CLOSE UNENABLE gt CU X NO ACTION xX NO ACTION ALLOCATE UNENABLE gt AU O OPEN E ENABLE FREE UNENABLE gt FU C CLOSE D DISABLE RECALL UNENABLE gt RU A ALLOCATE U UNENABLE F FREE R RECALL IF LAST REQUEST WAS THEN WARM START ACTION WILL BE Page 169 CICS STARTUP CONSIDERATIONS EADONLY gt RO XX NO ACTION UPDATE gt UP RO READONLY UP UPDATE Page 170 CICS STARTUP CONSIDERATIONS DESIRED RESTART STATUS DRS TUTORIAL CONTINUED With the above
4. AFC5 CAFC TABLE FILE MAINTENANCE CAFC PANEL 226 MAP B SELECT OPTION gt AFC5 INVOKE TO APPLY MAINTENANCE TO THE CAFC TABLE FILE THE AFC5 TRANSACTION SUPPORTS THE FOLLOWING REQUESTS TYPE A ADD DDNAME RECORDS TYPE C CHANGE DDNAME ENTRY RECORD TYPE D DELETE GROUP APPLICATION DBDLIST OR DDNAME ENTRY RECORD TYPE P PURGE 1 DELETE GROUP RECORD ALL APPLICATIONS RECORDS ATTACHED TO THAT GROUP ALL DDNAME ENTRY RECORDS ATTACHED TO APPLICATION RECORD S 2 DELETE APPLICATION RECORD AND ALL DDNAME ENTRY RECORDS ATTACHED TO THE APPLICATION RECORD 3 DELETE DBDLIST RECORD AND ALL DDNAME RECORD S ATTACHED TO THE DBDLIST TYPE K COPY DDNAME RECORDS TO CREATE NEW ONES TYPE R RENAME RECORDS TYPE L LIST VALUES IN FIELDS OF RECORDS TO EXECUTE THIS TRANSACTION TAB TO gt AND ENTER s gt _ AFC5 DDNAME ENTRY MAINTENANCE FACILITY PF3 END PF4 RET REQUEST The maintenance request directs the maintenance program AFCP2040 to perform ADD A CHANGE C COPY K DELETE D or PURGE P functions A ADD DDname or TXN record Cc CHANGE DDname or TXN Entry record D DELETE Group Application DBDlist DDname or TXN Entry record K COPY an existing DDname
5. KEPSPSpEetetetetStHtStSetStaetStHtSt tS tat ataetHtHtStatatataetHtHtatatatatat 4 i EXAMPLE CONVERSATIONS FROM AFCP2016 TO CICS A x IN ALL SETUP APPLIDS FOR VTAM ARE FORMULATED AS FOLLOWS KO ee ee ee ee SS SS SS SS SS SS CAFCXY WHERE X IS CPU DOMAIN AND Y S ACB x KO ee ee ee ee SS SS SS SS SS SS SS SS K REMEMBER THAT ACB S ARE DOMAIN UNIQUE AND A APPLID S ARE NETWORK UNIQUE is KEPSPSpetetetetHtHtStetetSetStHtHt tate tStaetHtHtHtatatataetHtHtatatatatat 4 BATCH JOB AFCP2016 ON CPU1 COMMUNICATES WITH CICSA ON CPU1 AFCP2016 AFC REQUEST CICSA C D TESTOOOL AFCP2016 LOAD AFCT2016 AFCT2016 TABLE CICSID CICSA BATCHID CAFC1 SYS1 VTAMLST APPL CAFC11 ACB CAFC1 SYS1 VTAMLST APPL CICSA CICSA TCT TYPE AFCP201 AFCP20 SYSTEM NETNAME CAFC11 5 PERFO RM AFC REQUEST C D TEST0001 6 RECE VE RESPONSE FROM AFC REQUEST Page 240 BATCH TO CICS INTERFACE SAMPLE BATCH INTERFACE ENVIRONMENTS CONTINUED INSTALLATION SAMPLE 5 16 ON CPU2 COMMUNICATES WITH CICSA ON CPU1 16 REQUEST CICSA C D TESTOOO1 BATCH JOB AFCP2 AFCP2 N U N U AFCP2016 LOAD AFCT2016 AFCT2016 TABLE CPU2 CICSID CICSA BATCHID CAFC1 SYS1 VTAMLST CPU2 APPL CAFC21 ACB CAFC1 SYS1 VTAMLST CPU2 C
6. ENTRIES FOR CICSA TCT ON CPU1 DFHTCT TYPE SYSTEM X ACCMETH VTAM X NETNAME CAFC11 INSTALLATION DEFINED X RMTYPE LUTYPE62 X BUFFER 256 X RUSIZE 256 X RMSTAT TRANSCEIVE X FEATURE SINGLE DFHTCT YPE SYSTEM X ACCMETH VTAM X NETNAME CAFC21 INSTALLATION DEFINED X RMTYPE LUTYPE62 X BUFFER 256 X RUSIZE 256 X RMSTAT TRANSCEIVE X FEATURE SINGLE ENTRIES FOR AFCP2016 ON CPU1 CDRM1 APPLID TABLE AFCP2016 AFCM201 AFCM201 AFCM201 AFCM201 END 6 6 6 TYP E INITIAL E CICSID CICSA BATCHID CAFC1 CICSID CICSB BATCHID CAFC2 TYP E FINAL Page 242 BATCH TO CICS NT ERFACE SAMPLE BATCH INTERFACE ENVIRONMENTS CONTINUED INSTALLATION SAMPLE 5 k gt kx gt kx gt kx gt kx gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k gt k k k k k xk ENTRIES FOR AFCP2016 BATCH JOB RUNNI ING ON CPU2 ee et et et et et ee ee ee ee ee ed a ENTRIES FOR SYS1 VTAMLST ON CPU2 CDRM2 CAFC2 VBUILD TYPE A
7. second region running with an APPLID of B The user has defined the following profiles to the RACF class SCAFC and rules to ACF2 resource type NTC USERID RACF ACCESS ACF2 SERVICE RESOURCE PROFILE M1 CONTROL DELETE UPDATE ADD READ MASTER M2 CONTROL DELETE UPDATE ADD READ MASTER A M3 CONTROL DELETE UPDATE ADD READ MASTER B M4 UPDATE UPDATE ADD READ MASTER A Page 112 CAFC FEATURES AND CONSIDERATIONS SECURITY OPTIONS CONTINUED USERID RACF ACCESS ACF2 SERVICE RESOURCE PROFILE U1 CONTROL DELETE UPDATE ADD READ USER A DDN FILE1 Ul READ READ USER A DDN FILE2 U1 CONTROL DELETE UPDATE ADD READ USER A DDN FILE3 U1 UPDATE UPDATE ADD READ USER A DBD DATA1 Ul UPDATE UPDATE ADD READ USER A APL UFILES U1 CONTROL DELETE UPDATE ADD READ USER A MSG UFILES U2 UPDATE UPDATE ADD READ USER A DDN F U3 CONTROL DELETE UPDATE ADD READ USER B DDN U4 CONTROL DELETE UPDATE ADD READ USER A MSG U5 CONTROL DELETE UPDATE ADD READ OPER A Notice that USER M1 has a generic profile M1 has full MASTER authority to perform any CAFC function on the two CICS regions A and
8. Page 250 OPERATIONAL CONSIDERATIONS SUPPORT FOR NON 3270 DEVICES CONTINUED UNLOCK UNQUIESCE OPEN DATASETS OPEN TDQUEUES START DBDS ENABLE TXNS CLOSE DATASETS TDQUEUES STOP DBDS CLOSE amp ENABLE DATASETS TDQUEUES QUIESCE DATASETS SET DATASETS UNAVAILABLE SET DATASETS QUIESCED amp UNAVAILABLE CLOSE amp LOCK DATASETS CLOSE TDQUEUES STOP DBDS CLOSE amp QUIESCE DATASETS CLOSE TDQUEUES STOP DBDS SET DATASETS CLOSED amp UNAVAILABLE CLOSE TDQUEUES STOP DBDS SET DATASETS CLOSED QUIESCED UNAVAILABLE CLOSE TDQUEUES STOP DBDS CLOSE QUIESCE amp LOCK DATASETS CLOSE TDQUEUES STOP DBDS SET DATASETS CLOSED LOCKED amp UNAVAILABLE CLOSE TDQUEUES STOP DBDS SET DATASETS CLOSD QUIESCED LOCKD UNAVLABLE CLOSE TDQUEUES STOP DBDS DISABLE TXNS CLOSE DATASETS TDQUEUES STOP DBDS DISABLE TXNS CLOSE amp LOCK DATASETS CLOSE TDQUEUES STOP DBDS DISABLE TXNS CLOSE amp QUIESCE DATASES CLOSE TDQUEUES STOP DBDS DISABLE TXNS CLOSE QUIESCE LOCK DATASETS CLOSE TDQUEUES STOP DBDS FORCE CLOSE DATASETS RECALL DATASETS TDQUEUES DUMP DBDS PROHIBIT UPDATES ON DBDS RECOVER DBDS STOP DBDS AND SWITCH LOG SET VSAM DATASETS DBDS TO READ ONLY ACCESS SET VSAM DATASETS DBDS TO UPDATE ACCESS SET DBDS TO READ WITH INTEGRITY ACCESS SET DBDS TO EXCLUSIVE ACCESS ENABLE TRANSACTIONS DISAB
9. Page 65 CAFC FEATURES AND CONS DERAT ONS ENHANCED RESOURCE MANAGEMENT CONTINUED AUTOMATIC ALLOCATION OF NON VSAM FILES DCT or non CICS files Non VSAM files may be automatically all CLOSE request from CAFC procedural checks determin 1 File must not be alre 2 AUTOMATIC ALLOCATION AUTOMAT C SERV CES to proceed must be If a pre allocation User Exit is taken ocated freed in support of an OPEN CEMT an EXEC CICS call The following whether allocation is performed ady allocated on CAFC Edit panel 400 under the section for PY OPI R it must allow the allocation AUTOMATIC FREES ON A CLOSE REQUEST FCT and DCT files may be automatically freed in support of a CLOSE request from CAFC CEMT or any other programs that make request of CICS The following procedural checks determine whether deallocation is performed 1 File must not be already deallocated 2 FREE AT CLOSE TIME on CAFC Edit panel 400 under section for AUTOMATIC SERVICES must be Y prior to allocation 3 User Exit is taken If pre free it must allow the deallocation to proceed AUTOMATIC ENABLE DISABLE OF FCTS DCTS C ICS FCT or whe Tf wil DCT table entries may be automatical support of certain requests from CAFC ther an
10. ser Exit B I Batch Terminal Receive Data 204 ser Exit B I Control Card 204 ser Exit B I Security 196 204 250 ser Exit B I Sign on off 204 ser Exit B I Step Codes 204 ser Exit Customization Options 84 85 ser Exit DataCom DB 80 ser Exit DBCTL global exit 110 ser Exit default program name 109 ser Exit Exit Points 77 ser Exit Global 109 ser Exit Global 76 ser Exit Group Completion 77 ser Exit On line Control Points 109 ser Exit On line Requests 109 ser Exit On line Return Codes 79 ser Exit Parameter List AFCD2017 77 ser Exit Request Completion 77 ser Exit Request Completion 110 ser Exit Security Exit Area 250 SER SIGNON ser Signon Options Default 10 SERID 114 112 Utility Services 83 VSAM Allocation Option VSAM Record 60 1327 134 Level Sharing support VSAM RLS automatic gquiesce on close 6 0 VSAM RLS Automatic gquiesce option 170 VSAM RLS automatic unguiesce on open 60 VSAM RLS Automatic ungquiesce option 170 VSAM RLS commands 60 Warm Start overrides 183 VSAM RLS Propagate enable option Warm Start Overrides 176 187 60 170 W
11. x AFCTXCLD FUNCTION PROVIDE LIST OF FCT DDNAMES AND DCT DESTIDS x FOR A QUICK CHECK TO AVOID CAFC PROCESSING KKEKKKKKKKK KKK KKK KKKK KKK KKK KK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KK KKK KK KKKKKKK EJECT SPACE 3 SEXCLUDE TYPE INITIAL SEXCLUDE TYPE ENTRY TABLE DCT DESTID DT08 SEXCLUDE TYPE ENTRY TABLE FCT DDNAME QAFCT20 SEXCLUDE TYPE ENTRY TABLE FCT DDNAME QAFCT03 SEXCLUDE TYPE ENTRY TABLE PCT TRANID AFCC SEXCLUDE TYPE FINAL END CUSTOMIZATION OPTIONS The CAFC Primary Option Menu 201 pictured below allows the user to perform actions to control individual region operation CICS files DLI databases transactions FCT entries passwords and other CICS resources Enter a 5 in the SELECT OPTION field to retrieve the PRIMARY CUSTOMIZATION OPTION MENU This menu presents user controlled options that effect individual CICS region operation aSSeeres CAFC REL 4 5 00 PRIMARY OPTION PANEL CAFC PANEL 201 SELECT OPTION gt USERID MASTER TIME 29 Page 79 CAFC FEATURES AND CONSIDERATIONS
12. SEQTALLO JOB eens 2 E CICS CLASS T MSGCLASS A 3S010 EXEC PGM IEFBR14 DD1 DD DSN CICS TEST SEQTRMIN DISP NEW CATLG UNIT SYSDA SPACE TRK 1 1 DCB RECFM F LRECL 80 BLKSIZE 80 1 DD2 DD DSN CICS TEST SEQTRMOT DISP NEW CATLG UNIT SYSDA SPACE TRK 1 1 DCB RECFM F LRECL 133 BLKSIZE 133 Page 253 x x MM OPERATIONAL CONSIDERAT SEQUENTIAL TERMINAL SETUP AND USAGE CONTINUED JCL TO BE ADDED TO CICS S JOBSTREAM CICSTEST CICS A5 JOB CICS CEASSSI EXEC PGM DFHSIP PARM ONS MSGCLASS A Le ol IAS Lye eae eae SEQUENTIAL TERMINALS Le ee il Lim SEQTRMIN Wag SEQTRMOT DSN C DSN C CS TEST SEQTRMIN O SP SHR CS TEST SEQTRMOT D ISP SHR Le eel DATASET 1 PRINT SEQTRMOT IIF J XEKE KAK kkk KKK KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK KK KKK KK LIX SEQTRMOT EXEC PGM IEBPTPCH SYSPRINT DD SYSOUT SYSUT1 DD DSN CICS TEST SEQTRMOT DISP SHR JI SYSUT2 DD SYSOUT DCB BLKSIZE 133 SYSIN DD PRINT MAXFLDS 1 RECORD FIEL Page 254 OPERATIONAL CONS DERAT ONS OSCOR VSAM SHARED RESOURCES CON
13. CAFC also provides many advantages in a CICS testing environment These include Ta The ability to create FCT and DCT entries before the files ar available and when they are available have CICS access them even if CICS is already up Ze The ability to switch between test files without having to cycle your CICS regions Bie Giving the application programmers the ability to bring their applications on line and off line whenever they wish This gives them the freedom to test batch cycles during the day while CICS is up instead of at night when the test CICS system is down Page 1 NSTALLAT ON PROCEDURES The procedure for installing the CICS Release 4 5 follows installation details installations 2 install the product and 3 maintenanc level releas BE which stands for Batch The topics include general informa The information supports ations upgrading to the most installations refreshing a current Application File Control facility firs 1 tion and specific time CAFC urrent releas of releas SUMMARY OF BASE SYSTEM INSTALLATION PROCEDURE This procedure allows our users to quickly install The installat features can the full Th installation initi recommended approach for the v v v v inclusion with a new In this manual you will
14. CONNECTION TYPE gt L 1 LU6 2 E EXCI ONLINE TRANSACTION CODE BATCH INTERFACE gt AFCB CICS TRANSACTION CODE DSNAME CHANGE gt AFCM CICS TRANSACTION CODE XPGM REQUEST gt AFCX CICS TRANSACTION CODE SEQUENTIAL TERMINAL ID XPGM REQUEST gt SEQX CICS TERMINAL ID BATCH SECURITY SIGNON METHOD gt NONE NO SIGNON REQUIRED BY CICS FMH5 VTAM FUNCTIONAL MANAGEMENT HEADER SECURE CEMT TRANS gt N Y N ISSUE SECURITY CHECK ON CEMT TRANS USERID gt PASSWORD gt BATCH JOBNAME USERID gt N Y N USE BATCH JOBNAME AS USERID IN LOGS IF THE CICS ABENDED THEN BATCH INTERFACE ACTION WILL BE ACTION CODE SSPE C CONTINUE IGNORE CICS ABEND W ISSUE WTOR FOR TERMINATION OPTIONS T TERMINATE WITH FOLLOWING RETURN CODE RETURN CODE gt 16 DECIMAL VALUE MULTIPLE LU NAMES ENQUEUE WAIT INTERVAL gt 00010000 TIME VALUE HHMMSSTH MESSAGE FREQUENCY gt 02 DECIMAL VALUE TIME OUT LIMIT TIME OUT INTERVAL gt 00030000 TIME VALUE HHMMSSTH XPGM REQUEST gt 00030000 TIME VALUE HHMMSSTH LUO PROCESSING FORMAT OUTPUT DATA gt N Y N SHOW OUTPUT DATA IN SCREEN FORMAT Page 88 CAFC FEATURES AND CONSIDERATIONS B I LU6 2 CUSTOMIZATION OPTIONS CONTINUED BATCH INTERFACE TIMEOUT INTERVAL After the Batch Interface Program AFCP2016 issues a RECEIVE it sets a
15. Implicit Open support 147 Implicit Open Support 15 Implicit open support activation 144 IMS Allocation Options 85 Initial Open support 147 Initial Open Support 15 Initial Open support for CSFU 27 Initial Opens from CICS 144 Interconnected Network Environments 201 IPLs 100 103 104 ISC support required for B I 204 JCL for a sequential terminal 275 JCL required for CAFC Startup 9 JCT Warm Start 175 Limited Ddname Record maintenance with AFC5 299 Linking to CAFC from user program 278 linking to CICS programs from the B I 230 Local Shared Resources 276 Locking indicator 52 LPALIB exclusions 12 LUO ACB name for B I 242 LUO security transaction sequence 244 UO sign on description 241 U0 Terminal Definition 241 242 UTYPE62 protocol 17 UTYPE62 RDO Definition 265 Main Menu 82 Maintaining CAFC Table entries with AFC5 320 Message Facility 70 83 86 Message System Options 84 Migrate command 284 L L L L Migrated Data Set Options 141 Migration from any back release 18 Multi CPU Environments 195 201 203 205 Multiple Sign Ons 195 MVS Recall request 38 Netview Interface for error messages 153 Network Unique Vtam Resources 201 205 NOFEOV DBCTL option 168 non 3270 device for CAFC requests 270 Online Reports 83 On line S
16. TO EXECUTE TAB TO gt AND ENTER NAME OF MODULE THEN PRESS ENTER gt PF3 END PF4 RET The SRCH transaction can be run stand alone Page 295 MISCELLANEOUS CAFC UTILITIES UTILITY SERVICES MENU CONTINUED CAFC TABLE ENTRY MAINTENANCE FACILITY This function runs the AFC5 transaction which in turn presents a series of panels The panels allows maintenance to limited fields within a CAFC Table File s ddname and CICSTXN records Nodes within DSNAMES can be globally updated The panels accept generic specifications and allow mass changes to the status flags and fields The AFC5 transaction can be run from the UTILITY SERVICES MENU run as a stand alone transid linked to from a user program or run from the B I Users attempting to perform maintenance requests using this facility must have Master authority for requests to complete normally Below is the AFC5 instruction panel Saat ea Es AFC5 CAFC TABLE FILE MAINTENANCE CAFC PANEL 226 MAP B SELECT OPTION gt AFC5 INVOKE TO APPLY MAINTENANCE T
17. IFYING E EXCI TH IFYING THE BATC IONAL JCL STATEME CAE C REQUESTS VIA CAE C REQUESTS VIA CAE Qr TABIE MALN TENANCE RE QUES TS ioe cais ioe facto bcd care heeds to dears io Rate Sica or EAA ae dean s to Pa Eea rea EMT REQUESTS G X ab R Z R A S Dp WU l REQUESTS TO R N REQUESTS TO R n IR EXITS AND PRO H N ON SIGN OFF E G C N O U U URITY EXIT TROL CARD EXIT ID SEL CH STEE AUWWPANNAPHHNHAA es PnP pt TCH TE TALLATION STEPS PIE CATLON PROGRAM TNE BREACH sss 4 456 o 2 06 8 tiene iets SSR eee belie re UAE Ai OS ee se Q H O zZ n D Z ine H x H H ae ye O Q ve D Z iC XCTL AND XPGM REQUESTS TO START PROGRAMS pesee ke e eE cece eee ec eee eee ene GRAM E V NSIDER FA Oe A A D zZ w H Z iw me Z ENTIAL TERMINAL RE FOR 32 10 SDEVE CHS see EE D E E EE E E cen E E N E A S RIT FORNON 3270 DEVLCE Sienai ioa 5 EE OE Ea Bia E ale a EE eats SETUP AND USAGE s perii ae aaea Fae BE dice a Bhai de Haase tS RE de EA D O M MAN
18. TERMID NT6B CICSID CICS99P To BROWSE in wate DISPLAY BROWSE ENTRY MENU 2 BD LT iss tiee DISPLAY EDIT ENTRY MENU 3 REQUESTS DISPLAY PRIMARY REQUEST MENU S STATUS 42c64 DISPLAY STATUS REQUEST MENU R RDO REQUESTS DISPLAY PRIMARY RDO REQUEST MENU 4 PASSWORD CHANGE YOUR PASSWORD Dm OR TIONS wes 2 lt DISPLAY CUSTOMIZATION OPTIONS MENU 6 MESSAGE SEND USER MESSAGE Lo MOTLEY e 6 e028 4 DISPLAY UTILITY SERVICES MENU 8 REPORTS aie DISPLAY REPORT SERVICES MENU PRESS CLEAR KEY TO TERMINATE CAFC PF1 HLP PF2 2ND SES PF3 END PF4 RET PF9 ALT SES The eight options on the PRIMARY OPTION MENUS are briefly described below BROWSE allows you to specify a CAFC table type retrieve it and review it on line This is a read only facility Updates are not supported EDIT allows you to specify a CAFC table type retrieve it and review it and perform on line maintenance REQUESTS allow you to change the status of CICS resources registered to CAFC Requests may target individual items such as a ddname Group lists Applications lists or a generic scope applied to any of the above resources Requests may target Page 80 CAFC FEATURES AND CONSIDERATIONS CUSTOMIZATION OPTIONS CONTINUED STATUS requests present the status of the resources registered to CAFC The functions may target ind
19. CICS APPLID Association Table AFCT2016 Step 7 link edit CAFC s REVIEW AND UPDATE THE BATCH INTERFACE CUSTOM ZATION OPTIONS Review the Customization Options chapter especially panel 20T which deals with B I processing options Additional information related to the CICS EXC CS for MVS ESA External CICS Interface Version 4 Release 1 SC33 1390 01 CICS Transaction Server for OS 390 ICS External CICS Interface ie Release 1 1 SC33 1703 00 CICS Transaction Server for 0OS 390 C CS Internet and External Interfaces Guide Release 1 2 SC33 1944 00 CICS Transaction Server for 0OS 390 CICS External Interfaces Guide Release 1 3 SC33 1944 01 Page 193 in interface can be found in the following manuals contain information on the installation and use of the EXCI CI terface BATCH TO C CS NTERFACE B I EXECUTION JCL AND COMMAND LINE FORMATS BATCH INTERFACE JCL The JCL to invoke a standard execution of the CAFC Batch Interface follows The hypothetical example below demonstrates B I requests coming from both PARM and a SYSIN data set The Optional Notes 1 3 explanations begin several pages later stepname EXEC PGM AFCP2016 PARM c Gy LELLE Cty Wes
20. Blank Edit the input SAVE Edit the input SCROLL This field directs the system page display The scroll may be entered into the COMMAND If entered into the SCROLL field on the i INPUT screen then that value overwritten by the user The same is true for valid entries into the SCROLL and present the result data if ther and save the CS ar no rrors to the proper scroll amount for multiple nput screen INPUT field or into the COMMAND will remain in the COMMAND INPUT field until field are PAGE Display the next full page of dat entry after the last one on the screen page of data beginning with the current entry HALF Display a full is halfway up o Numeric Display a full r down from page of data beginning or down from the current entry M Maximum Display a full page of data first entry in the record or display where the last entry in the record is screen ENABLE ALL MESSAGES If this option is set to Y the CAFC message facilit messages to be sent via the CAFC message facility the SCROLL field The ta beginning with the next the entry that with the Nth entry up beginning with the a full page of data the last entry on the ty is enabled For any this option must be set to Y This includes both automatic and user delivered messages This is a required fie
21. MESSAGE FACILITY OPTIONS CONTINUED FUNCTION This gives the event that is to trigger the message facility The function may be entered anywhere in the function field as long as it is one of the accepted function values This is a required field The following list gives the accepted function values Open O OP OPE OPEN Close C CL CLO CLOS CLOSE Allocate A AL ALL ALLO ALLOC Free F FR FRE FREE Enable FCT DCT Entry EF Disable FCT DCT Entry DE Enable Application Transaction E EN ENA ENAB ENABL Disable Application Transaction D DI DIS DISA DISAB Open Files and Enable Transactions OE Disable Transactions and Close Files DC Enable DL I Database DBD Recover DL I Database DBR Assign Read Only RO Assign Update UP UPD UPDA UPDAT Assign Read RD READ Assign Exclusive EX EXC EXCL EXCLU Status Display S ST STA STAT STATU Display Activity Counts K Reconcatenate DFHRPL RPL Re open DFHRPL ORPL Synchronize Restart Parameters SYNCH Install FCT Entry FI Delete FCT Entry FD Default value gt none Page 144 CAFC FEATURES AND CONSIDERATIONS MESSAGE FACILITY OPTIONS CONTINUED RETURN CODE The return code defines the outcome of the event for which the message is to be sent This field is optional The valid return codes a
22. LINKING TO CAFC S DYNAMIC ALLOCATION FACILITIES CONTINUED UO UNO VUO VUNO Q X QX CL CQ CX COX COL CLX CQLX SYNCH UNLOCK amp OPEN DATASET OPEN TDQUEUES UNLOCK UNQUIESCE amp OPEN DATASETS SET DATASETS AVAILABLE UNLOCKED amp OPEN SET DATASETS AVAILABLE UNLOCKED UNQUIESCED amp OPEN QUIESCE DATASETS SET DATASETS UNAVATLABLE SET DATASETS QUIESCED amp UNAVAILABLE CLOSE amp LOCK DATASET CLOSE TDQUEUE CLOSE amp QUIESCE DATASETS SET DATASETS CLOSED amp UNAVAILABLE SET DATASETS CLOSED QUIESCED amp UNAVAILABLE CLOSE QUIESCE amp LOCK DATASETS SET DATASETS CLOSED LOCKED amp UNAVAILABLE SET DATASETS CLOSED QUIESCED LOCKED amp UNAVAILABLE SYCHRONIZES TABLE FILE S FCT DESIRED RESTART TO CURRENT STATUS OF THE CICS FCT AF7ENTYP The 1 character CAFC Table File Entry type The entry type code must be one of the following D DDname T CICSTXN A Application I DBD G Group 4 Specify G for DLI Global e g CG for Close Global AF7GLOBL The Specify G for DLI Global e g CG for Close Global 1 to 8 Character CAFC Table Entry name upon which you the function performed AF7ENTNM The want character CAFC Global Request Indicator On return from
23. Page 40 CAFC FEATURES AND CONSIDERATIONS DFHRPL LIBRARY MANAGEMENT CONTINUED USING THE CAFC RPL LIST EDITOR You invoke the CAFC RPL List Editor by entering an AR in the TABLE NAME field of the EDIT ENTRY MENU At this point you have three choices You can 1 nter the name of an existing RPL list in the NAME field 2 enter a BLANK name to retrieve a list of all of the RPL lists stored on the CAFC Table file or 3 enter a new list name to create a new RPL list Actions 1 and 3 immediately invoke the RPL LIST Editor If you entered a blank in the NAME field the EDIT TABLE display for all APPLRPL entries will be retrieved Now if you place an S for select in the cursor field preceding one of the RPL LIST names the RPL List Editor is then opened for the selected APPRPL list as shown below EDIT TABLE APPLRPL CAFC PANEL 203 COMMAND INPUT gt SCROLL gt PAGE TYPE NAME CREATED BY CREATE DATE LAST UPDATED MOD UPDATED BY _ AR RPLA MASTER 03 15 95 04 04 95 23 48 031 MASTER _ AR RPLB MASTER 03 16 95 04 01 95 19 08 002 MASTER _ AR RPLC MASTER 02 22 95 03 16 95 11 29 023 MASTER S AR RPLX MASTER 03 27 95 04 06 95 20 56 005 MASTER _ AR RPLGOOD MASTER 03 31 95 05 01 95 17 40 002 MASTER PF1 HLP PF2 2ND SES PF3 E
24. status changes AFCS CAFC STARTUP TRANSACTION CAFC PANEL 226 MAP A SELECT OPTION gt AFCT STAR THIS TRANSACTION PERFORMS THE FOLLOWING i LOCATES AND OF 1 A PENS AFCF4000 2 RECORDS NORMAL S 3 A D E TARTUP IN AFCF4000 CTIVATES CAFC SUPPORT FOR CICS D C LI DCT PCT AND FCT REQUESTS 4 ACTIVATES THE AFCP2109 SERVICE PROGRAM THIS TRANSACTION PERFORMS THE FOLLOWING 1 DISPLAY THE CURRENT STATE OF CAFC SUPPORT AND THE STATUS OF CAFC STARTUP FUNCTIONS AFCT STAT E AFCT START p a RFORM CAFC STARTUP ACTIVITIES AFCT STATUS DISPLAY CURRENT STATUS OF CAFC SUPPORT TO EXECUTE TAB TO DESIRED TRANSACTION AND ENTER S PF3 END PF4 RET Page 292 UTILITY SERVICES MENU CONTINUED CAFC SHUTDOWN AND RELATED FUNCTIONS Use the enhanced AFCT transac The panel bel AFCT SHUTDOWN system region Alternatively cleared screen and an AFCT DEQ an AFCT ISCELLANEOUS CAFC UT ES tion to modify the status of an active CAFC low describes the status changes that an transaction would have on the active SHUTDOWN can be executed to perform the same status changes and an AFCT DEQ froma
25. PROPRIETARY CICS APPLICATION FILE CONTROL FACILITY RELEASE 4 5 NSTALLATION MANUAL CICS Versions TS1 3 3 2 REVISED May 2007 Copyright C 2001 2005 NETEC International Inc P O Box 180549 Dallas Texas 75218 U S A 214 343 9744 Telefax 214 343 9009 E mail support netec2000 com All Rights Reserved Worldwide INTRODUCTION NST UMMA TABLE OF CONTENTS NSTAL IM INSTALLATION PROCE N E FOR THE CAFC BAS si A NSTAL I S ig T DETA CAFC H AR CAFC S CICS S OFT YSTEM CAFC REL EFASE MAI IGRAT EFRES ES AN EMOVI ICS S Pi CAFC F NTENACE ION PROC HING D CONSID ROM ANY BACK A CAFC E P Pi 4 5 SYST NG DD ST TARTUP U A N M R EATUR R C S ECURI USING USING HIERA DFHRP ERAR H FILE pe OC TY WITHI N THE B I s si THE BATC CH LIBRA KING RY pD ICAL ST MANAG EME PROT CAFC I VSAM R NTERFACE LS SUPPO ALTERN ATE MRO RE DSNAM RI ay TO DBCT BACT TOY goss oe tebe ehh be let
26. SAVE the modified RPL list Go to the PRI MARY REQUEST MENU Entering will cause the RPL L the REQUEST fiel in the NAME fiel U d ST REQUEST MEN d and enter RPL list Then hit ENTER an AR for TABLE TYPE to be displayed name you wish to reconcatenate Use the CEMT NEW COPY command as required Page 39 Enter RPL in CAFC FEATURES AND CONSIDERATIONS DFHRPL LIBRARY MANAGEMENT CONTINUED A CAFC RPL list known as an APPLRPL is similar to an Application list The RPL list however contains a list of symbolic ddnames that are always associated with a data set PDS load library name The RPL ddnames are symbolic because there are no real CICS resources related to them RPL ddnames are defined as type R ddname entries Normal CAFC commands will not operate against these symbolic R ddname entries Individual RPL DDname entries may be created in two ways either through a ddname edit session or through a RPL LIST EDITOR session DEFINING INDIVIDUAL RPL DDAME ENTRIES THROUGH EDIT As with normal ddnames you can create and edit symbolic RPL ddname entries from the EDIT ENTRY MENU using a DR type entry A DR entry contains a symbolic ddname a data set name a disposition of SHR and two 32 byte optional user fields Once these symbolic ddnames and their corresponding dsnames PDSs have been
27. g an generic inquiry the CAFC response may erroneously present a return code of O yet errors may have occurred on subsequent responses This erroneous return code situation may occur if the returned messages exceed the 8 000 byte limit The response is written to sysprint and to the MVS console log Batch Interface input format for CEMT requests Cc c CEMT v vV where e The 1 to 8 character VTAM Applid of the CICS on which you want the CEMT request performed CEMT The 4 byte Function Request Code CEMT representing a CEMT request v v The 1 to 44 character CEMT command you wish to perform the format of which must follow CEMT command syntax The Batch Interface supports single CEMT commands with a 44 character maximum Example CICSTST CEMT SET PR TESTPGM1 NEW Page 209 BATCH TO CICS INTERFACE EXEC XCTL AND XPGM REQUESTS TO START PROGRAMS BATCH INTERFACE EXEC XCTL and XPGM REQUESTS The Batch Interface Program offers specific request types EXEC XCTL and XPGM to execute CICS programs from execution requests in batch job steps If the target CICS region is down 1 THE EXEC XCTL and XPGM requests are ignored 2 a Batch Interface condition code is set and 3 the jobstep is terminated EXEC REQUESTS TO START A CICS PROGRAM EXEC requests generate an EXEC CICS LINK PROGRAM from either CAFC s AFCB or AFCI transaction AFCB is used when
28. B I INSTALLATION STEPS ACF VTAM LU6 2 B I Step 1 DEFINE THE BATCH INTERFACE S APPLIDS ACBS TO VTAM Determine whether the single default B I VTAM ACB CICST62 is acceptable The default ACB CICSI62 can be used to meet all of your B I needs in a low activity single or multiple CPU environments In a very active environment where many batch jobs may access files shared with CICS a single ACB may dramatically slow CAFC s response to B I requests In active environments we recommend that you use multiple ACBs to more efficiently support your B I requests In either case one or more APPL statements must be added to SYS1 VTAMLST to define each VTAM APPLID ACB that may be used by a B I The Installation Tape member CAFVT7A may be used as a sample Below is a typical VTAM APPLID statement CICSI621 VBUILD TYPE APPL CICSI621 APPL ACBNAME CICS162 AUTH ACQ PASS where ACBNAMF CICSI62 represents the domain unigue default ACB specified in the VTAM ACB of the B I CICSI621 represents the network unique APPLID which may be changed to conform to your installation s VTAM naming conventions If the APPL statement is filed in SYS1 VTAMLST as a separate member be aware that the member name is considered a VTAM Node name It MUST be unique that is the member name must not be the
29. CLOSE TDQUEUES STOP DBDS CLOSE TDQUEUES D UNAVLABL E CLOSE DATASETS DATASETS TDQUEUES S TOP DB DS CLOSE amp QUIESCE Page 203 DATASES CLOSE TDQ UE UES STOP CLOSE TDQ UEUES STOP BATCH TO C C S NTERFACE B I BATCH INTERFACE JCL AND COMMAND LINE FORMATS CONTINUED DCOL DISABLE TXNS CLOSE QUIESCE LOCK DATASETS CLOSE TDQUEUES STOP DBDS FC FORCE CLOSE DATASETS R RECALL DATASETS TDQUEUES DBD DUMP DBDS PROHIBIT UPDATES ON DBDS DBR RECOVER DBDS STOP DBDS AND SWITCH LOG RO SET VSAM DATASETS DBDS TO READ ONLY ACCESS UP SET VSAM DATASETS DBDS TO UPDATE ACCESS RD SET DBDS TO READ WITH INTEGRITY ACCESS EX SET DBDS TO EXCLUSIVE ACCESS E ENABLE TRANSACTIONS D DISABLE TRANSACTIONS NOA SET DDNAMES TO NO ALTERNATE DSNAME AVAILABLE PRI SET DDNAMES TO USE PRIMARY DSNAME FOR NEXT ALLOCATION SEC SET DDNAMES TO USE SECONDARY DSNAME FOR N
30. lowing S BLANK SAMEI DSN DISPLAY ST ATUS OF ITEMS EXPAND THE SINGLE ST ALL ITEMS MATCH GENER C NAME TEM L LIST FILES WITH MATCHING DSNAMES ALLOCATE D ATASETS TDQUEUES FREE DATAS ETS TDQUEUES U ENABLE DAT ASETS TDQUEUES U DISABLE DATASETS TDQUEUES LOCK DATAS ETS TDQUEUES U UNLOCK DAT ASETS TDQUEUES U OPEN DATAS DB DS ETS TDQUEUES START U Page 202 NG THE VN NO VO VNO UO VUO VUNO OE UOE NOE UNOE CE QX CL CQ CX COX COL CLX CQLX DC DCL DCQ 00 DI UNQUIESCE SET SET UNQU SET SET UNLOCK amp OPEN SE START SE T E BATCH TO C CS NTERFACE DATASETS AVA DATASETS DATASETS AVAI ILABLE amp UNQUI LABLE TE SCED IESCE amp OPEN DBDS DATASETS DATASETS AVAI DATASETS AVAI START LABLE amp OPEN OPEN T LABLE UNQUIESCE OPEN TDQUEUES START DBDS DQUEUES ST ART DBDS DBDS DATASETS AVA START DBDS DATASETS DATASETS AVA LABLE UNLOCKE OPEN TDQUEUES D amp OPEN OPEN T L UNLCK START D D amp OPEN OPEN TDQUEUES BDS DQ
31. FCT data set name not in fct Record already exists copy request Record already exists add request Record not Transactio Delete not found copy request n ID greater than four 4 bytes allowed Security violation nvalid VS AM type Invalid transient type Data not copy name Not in DDn Invalid me Invalid RI ntered request entry type entry name or ame table mber name Invalid automatic disable option close Invalid automatic disable option free iS flag File not RLS in fct The 3 byte message number The 2 4 byte mes sage text Parm area pointer used by AFCP2100 Userid from AFCP2100 Message number Hex Batch Interface return code Page 283 MAT NTENANCE AND CONVERS ON DS TRANSFER CAFC TABLE ENTRIES BETWEEN TABLE FILES AFCP2020 is a CAFC utility program which will between CAFC Table Files CAFC Table File that already hav transfer CAFC Table Entries i e from a test CAFC Table File to a production This eliminates the re keying of CAFC Table entries been defined to another region s CAFC Table File fil ntries will be automa A sample of the JCL ation PDS member CAFCXFER Install CAFCXFER FIF IS010 STEPLI Lie INCAFC Z gt OUTCAFC FF SYSPRI a as SYSUDUMP THA SYSIN
32. NE CAFC Function Program Issues DLI commands to DBCTL ONLI NE CAFC Initialization Program This program displays the initial CAFC sign on menu and initializes the Common Area that is used by most CAFC programs to store information between tasks It processes the AFCS transaction followed by a parameter After a user signs on AFCP2010 transfers control to the Main Supervisor Program AFCP2001 Normally this program is placed in the PETPI ONL NE AFCP2015 ONLI NE CAFC Password Program This program allows users to change their CAFC passwords if CAFC Basic Security is turned on CAFC Online Batch Interface Program This program is invoked when the Batch Interface program AFCP2016 is executed It receives the CAFC request CEMT request or the transaction to be started sent by AFCP2016 via an LUTYPE6 VTAM session builds a CAFC function request list links to either AFCP2008 for CAFC requests or AFCP2060 for CEMT requests and transactions to be started and sends the completion messages back to AFCP2016 via the LUTYPE6 session Page 327 CAFC INSTALLATION CONTENTS CAFC LOADLIB CONTINUED CAFC Batch Interface Program This program establishes a VTAM session with the appropriate CICS sends a CAFC request CEMT request or a transaction to be started across the link receives the completion messa
33. Page 299 MISCELLANEOUS CAFC UTILITIES CAFC TSO ISPF LOG VIEWER INSTALLATION AND USER INSTRUCTIONS CAFC provides the function of having log records from multiple CICS environments be merged into a single MVS system log This functionality can provide the user with a single view of all CAFC activities in a multiple CICS environment Facilities to view the combined log are provided via an ISPF Log Viewer If the user is going to use the MVS system logger to house CAFC log records the following installation steps are necessary Step x Install the CAFC TSO ISPF Log Viewer a Modify your TSO procedure to include the CAFC TSO ISPF Log Viewer libraries The following libraries should be concatenated with the libraries found with the corresponding DDNAMES Exercise caution when modifying the TSO procedure If a mistake is made that will cause a JCL error a TSO user will not be able to logon using the modified procedure DDNAME Library STEPLIB your load pds ISPPLIB your ispf ispplib ISPMLIB your ispf ispmlib ISPTLLB your ispf isptlib To determine the TSO procedure that a TSO user is currently using enter the primary option menu of ISPF The screen should look similar to the following example On the right side of the screen is a field labeled TSO logon This field contains the TSO procedure name that is most likely the one to be modified In the fo
34. CAFC PANEL 200 CICS APPLICATION FILE CONTROL NETEC INTERNATIONAL INC MARKETING ASSISTANCE 214 343 9744 TECHNICAL ASSISTANCE 214 343 9744 ENTER CICS APPLID gt CICS99A CICS 4 1 1 SYSTEM A CICS99B CICS 4 1 1 SYSTEM B EICS9IC oo CICS 3 2 1 SYSTEM C Test CICS99D CICS 3 2 1 SYSTEM D Teller Terminals CICS99E CICS 3 3 0 SYSTEM E CICS99F CICS 3 3 0 SYSTEM F CICS99G CICS 3 3 1 SYSTEM G DB2 Test CICS99H CICS 2 1 1 SYSTEM H IMS 2 2 DUMMYA DUMMY SYSTEM A DUMMYB DUMMY SYSTEM B DUMMYC DUMMY SYSTEM C DUMMYD DUMMY SYSTEM D PF3 END PF 7 BCK PF8 FOR CLEAR TERMINATE Page 61 CAFC FEATURES AND CONSIDERATIONS MRO REGION SELECTION SCREEN CONTINUED The AFCA transaction drives the screen The screen information is maintained in the optional CAFC table AFCT1000 AFCT1000 associates the CICS applid of each AOR and FOR region to the appropriate remote TRANSID AFCT1000 also includes a brief description of each region Below are some sample entries for an AFCT1000 table AFCMRO TYPE ENTRY APPLID xxxxxxC TRANSID xxCS X DESC CICS 1 7 1 SYSTEM C TEST AFCMRO YPE ENTRY APPLID xxxxxxD TRANSID xxDS X DESC CICS 1 7 1 SYSTEM D TELLER TERMINALS AFCMRO YPE ENTRY APPLID xxxxxxG TRANSID xxGS X DESC CICS 1 7 1 SYSTEM
35. RACF CLASS DESCRIPTOR UPDATE The RACF Class Descriptor Table must be updated for CAFC RACF external security to operate correctly The following RACF table entry is required for CAFC s RACF security interface SCAFC ICHERCDE CLASS S CAFC DFTRETC 4 DF TUACC NONE FIRST ANY ENLIST DISALLOWED D XXX lt USER SPECIFIC EYQUAL 0 AXLNTH 26 PER YES THER ANY OSIT XX lt USER SPECIFIC ROFDEF YES ACLIST ALLOWED ACLREQ YES RVRSMAC NO SLBLREQ NO DHAUVOORRHA MMM MM KM MM KM MXM OM KM XM OX RACF ROUTER TABLE UPDATE The RACF Router table must be updated for CAFC RACF external security to operate correctly The following RACF table entry is required for CAFC s RACF security interface SCAFC ICHRFRTB CLASS SCAFC X ACTION RACF Page 106 CAFC FEATURES AND CONSIDERATIONS SECURITY OPTIONS CONTINUED ACTIVATING THE SCAFC CLASS After the above entries have been added to your RACF tables and the MVS system has been IPLed the SCAFC class must still be activated by your RACF administrator 1 Use the following TSO commands to perform the activation SETROPTS CLASSACT S CAFC SETROPTS RACLIST S CAFC SETROPTS GENERIC CAFC 2 Add your user profiles to the RACF class SCAFC NOTE Any profiles that existed before the SCAFC class was made generic by the SET
36. Sessions EXCISESS Group EXCIGRUP DEscription gt CAFC SESSION IDENTIFIERS Connection gt EXCI SESSName gt NETnameq gt MOdename gt SESSION PROPERTIES Protocol gt Exci MAximum gt 000 000 RECEIVEPfx gt lt RECEIVECount gt 002 SENDP fx gt SENDCount gt SENDSize gt 04096 RECEIVESize gt 04096 SESSPriority gt 000 Transaction OPERATOR DEFAULTS OPERId OPERPriority 000 OPERRS1L 0 OPERSecurity 1 PRESET SECURITY USERId gt OPERATIONAL PROPERTIES Autoconnect gt No INservice Yes Buildchain gt Yes USERArealen gt 000 TOarealen gt 00000 00000 RELreq gt No DIscreq gt No NEPclass gt 000 RECOVERY RECOVOption gt Sysdefault RECOVNotify None EXCI Session Definition Lu6l1 Appc Exci 0 999 1 999 0 999 1 30720 1 30720 0 255 0 255 No Yes All Yes No 0 255 0 32767 No Yes No Yes 0 255 Sysdefault Uncondrel None Clearconv Releasesess None Message Transaction Page 190 BATCH TO C CS NTERFACE BATCH INTERFACE INSTALLATION STEPS CONTINUED Step 2 UPDATING THE C CS EXCI OPT ONS TABLE DFHXCOPT The EXCI use of of the release of Cl Assemble and link edit the modified library in the STEPLI like the program Un DFHXCOPT tab component loads the first table of STEPLIB concatenation
37. B USER M4 has no authority at all because MASTER authority requires CONTROL access USER Ul can browse edit and issue requests for FILE1 on the CICS A region Ul can do nothing in the CAFC running on the CICS B region USER U3 can do nothing on the CICS A region but can browse edit and issue requests against any DDN controlled by CAFC on the CICS B region USER Ul can browse and edit the database DATA1 on the CICS A region but he cannot open or close it USER U2 can browse and edit DDN record FILE or FILE2 and any other DDN record which has a name beginning with the letter F on CICS A region In order to update a CAFC application and its components the user must have both 1 UPDATE access to the application name and 2 UPDATE access to each DDN DBD or TXN component of that application In the same fashion to successfully update a CAFC group the user must have 1 UPDATE access to the group name and 2 UPDATE access to every application name belonging to the group Updating a DBD requires UPDATE access to each component DDN record USER Ul can edit the CAFC application UFILES and can include FILEI1 FILE3 or DATA as a component of UFILES He cannot include DDN FILE2 as part of CAFC application UFILES since he does not have UPDATE access to FILE2 USER U4 can send immediat
38. B PDS of the CUSTOM ZAT AUTHORIZAT ON for more details ON OPTIONS chapter BATCH INTERFACE SECURITY SUMMARY If yo the program name must be entered CS Command Level ternal Security Installation for in house and These parameter u install a user he NETEC supplied external security exit programs trol access to the CAFC Customization Screens uests for your external security the sample external security the distrib the section entitled See T ution tape SECURITY AUDI CAFC is distributed with two Batch Interfac xternal security exit programs AFCP2BSX and AFCP2SOX Program AFCP2SOX LU6 2 B I only monitors the sign on sign off activity by the Batch Interface whenever a job attempts to communicate with a CICS region Program AFCP2BSX monitors all commands sent to a CICS region from the CAFC Batch Interface It controls whether the Batch Interface Program will pass the request to the target CICS region The commands that make up a request include standard CAFC functions CEMT requests requests to start CICS user transactions and requests to start CICS programs The above exit programs are described in the Chapter CAFC VTAM LU6 2 BATCH TO CICS INTERFACE The logic in these two exit programs allows the modification of the request statements before they are sent to CAFC s on line
39. C017 CAFC REL 4 4 08 ISPF LOG VIE TRACE Command Complete CAFC Log ss i gt LOGGER TEST PROGRAM Trace is active Scroll gt CSR MESSAGE TEXT ID ITEM TP REQUEST MSG Indicates Trace is active 07132005 134335 CICS99Q CR NULL DO WARMSTRT Q ORS F WS F X XX 07132005 134402 CICS990 CR TEST DO WARMSTRT 0 ORS F WS F X XX 07132005 134402 CICS990 CR AFCIROR DO WARMSTRT QOG DRS A WSFA X XX 07132005 134402 CICS99Q CR AFCPLERR DT WARMSTRT 0000 DRS OE WSO E 07132005 134402 CICS99Q CR AFCPLCOR DT WARMSTRT 000A DRS OE es E CR AFCPLSEC DT WARMSTRT 020 DRS OE CR BASE DO WARMSTRT 0953 RLS FILE NiS si gt FCT CR CAFINTRA DT WARMSTRT OOOO DRS FE CR CAFF DT WARMSTRT 000 DRS OE ted F CR CAFCTRAC DO WARMSTRT DRS A_ WSFA X XX CR CAFCLSTA DT WARMSTRT OOOO ORS OE E CR CAFCLSEC DT WARMSTRT GOA DRS 0E CR CAFCLERR DT WARMSTRT OOOO DRS 0E CR CAFCLEDT DT WARMSTRT 0 DRS 0E CR CAFCLCUS DT WARMSTRT OOOO DRS OE CR CAFCLCOR DT WARMSTRT 000G ORS 0E CR BASE DO WARMSTRT 08 DRS OERO CR COUT DT WARMSTRT 020 DRS 0E CR CEEQUT DT WARMSTRT 000A DRS 0E eenected to heat 10 1 1 230 Example Command TRACE ON Results Activate the internal trace TRACE OFF Deactivate the internal trace Page 318 Reset Command The Reset command is used to reset th ISCELLANEOUS CAFC UT ES fields that have been highlighted as the results of a Find or Rfind command The command can onl
40. If you plan to use CAFC s AFCPSIPX or AFCPSI oca gacy Early Al remove the 1 PY AFCPSIP3 from your authorized STEPLIB PDS AFCF4000 in the FCT le regions tion Facilities versions of AFCPSIP1 Review and the message The AFCFMSGS message Installation Step remove th referenc through AFCPSI AFCPS IP2 to This restart exit program P and These programs are now loaded from DFHRPL This provides better downward compatibility for the AFCPSIP AFCPSIPX and AFCPSIPY programs Any application programs that are being used to link to AFCP2040 must be changed to link to AFCP2503 AFCP2040 is no longer available Refer to the section for CAFC maintenance requ or online Batch will be required successful Extended Tablefile Maintenance Facilit sts require Master authority to execut jobs performing CHG ADD Delete Purge to have Master authority for Page 21 ty All table ither from batch Copy commands these requests to be CAFC RELEASE MAINTENANCE UPGRADES REFRESHING A CAFC RELEASE 4 5 SYSTEM The recommended approach for reinstalling CAFC includes installation STEPs 1 through 6 Insure that you have completed all sub steps of STEP 6 2 for EXISTING CAFC USERS After you have successfully completed these steps
41. MESSAGE FACILITY OPTIONS CONTINUED Lock file L Close amp Lock file CL Disable Close amp Lock file DCL Unlock file U Unlock amp Open file UO Unlock Open amp Enable file UOE Inquiry about Alternate Dsname INQ Exchange Dsnames EXC Close Exchange amp Open Dsname CXO Set No Alternate Dsname NOA Set Primary Dsname PRI Set Secondary Dsname sec Recall data set R RETURN CODE The return code defines the outcome of the event for which the message is to be sent This field is optional The valid return codes are 00 Normal Return 04 Partial Completion Warning Return 08 Complete Event Failure Default value gt 00 TEXT This is the actual message text that will be sent to the specified terminals It may contain any sequence of displayable EBCDIC characters including special characters There are five 5 parameters that may be specified to direct the message facility to substitute certain values prior to the message being sent These parameters must appear as shown If any user character string matches any of these parameters then the system will substitute the proper value for the parameter before th message is routed to the terminal The parameters are listed below APPLDDN This is the Application DDNAME or Application Transaction that triggered th vent 8 characters REQUEST This is the specific function that triggered th vent The length is variable
42. eliminates CICS in itial requests to the Table File for the resource is a AFCCSSN NOTE 4 DD read and honored step has access to the B I DSN cafc cssninfo D program will s changes to the CAFC Table File le records as if CICS and CAFC had been act ization delays and the need to manual when CICS is restarted utomatically updated if required LE the target CICS target directly apply the AFCP2016 updates the ive This ly apply CAFC The warmstart value ISP SHR If the AFCCSSN D D statemen t is included the LU6 2 B I program passes the FMH5 sign on information within the data set to the Sign on Sign off exit program AFCP2SOX Alternatively the FMH5 information can be stored in the CAFC VSAM Table File via the Customization Option Panel or it can be omitted totally forcing a sign on using the userid of the job submitter stored in the RACF Accessor Environment Element ACEE B I requests are subsequently sent only if AFCP2SOX indicates that the sign on was successful This support is intended for Cl sign on prior to starting the AFCB transaction If the user chooses to communicate with same batch job step and he is providing rather than using the ACEE region The format of the Sign on Position 8 Userid for the ext Position 21 2
43. information on defining LUTYPE6 2 entries to RDO see Defining Single Session APPC Intercommunication Facilities Terminals Guide Chapter 3 1 CICS 0S VS Page 245 OPERAT SUPPORT FOR 3270 DEVICES The standard AFCS transaction utilizes C screen data streams AFCC provides a quick requests without naviga pass through normal sec 3270 devices IONAL CONS DERAT ONS CS s BMS to format The AFSQ transaci CAFC offers an alternative transaction simple method for ent ting through the standard menu system urity processing same facilities for consoles and other non 3270 devices The request format AFCC fffff tt where fffff S BLANK SAMEDSN VNO UO VUO VUNO OE for the AFCC transaction is The 1 to 5 character CAFC Request code D ISPLAY STATUS OF ITEMS EXPAND THE GENERIC NAME SINGL E ITEM LIST ALL LIST FILES WITH ALLO MATCHI NG DSNAMES CATE DATASET S TDQUE FREE DATASETS TDQUE ES U UES ENABLE DATASETS TDO U EUES DI LOCK UNLO SABLE DATASETS oT DATASETS TDQUEUES U DQUEUES CK DATASETS U TDO EUES OPEN UNQU SET SET UNQU SET SET STAR UNLOCK amp OPEN DATASETS AVA SET STAR SET STAR
44. of the component ddname records e g a Group Application individual had their CDTDSNF flags set to S or 2 CDT AF 7MXT 1 A 1 LEC flags set to P CDT N some component ddname records had their while others had their flags set to DSNF flags set to S 32 ddname set to mixed dsnames 132 would be returned if 1 ords some of the component ddname e g a Group Application individual had their CDTDSNF and other component ddname records had their DSNF flags set to S Page 60 CAFC FEATURES AND CONSIDERATIONS MRO REGION SELECTION SCREEN If you have a MRO environment you can activate CAFC s user friendly MRO interface The main component of this option is the MRO Selection Screen Your users can select the CICS region on which they wish to run the CAFC facility The first screen of this option displays 1 the file owning region DOR 2 the list of application owning regions AORs and 3 the terminal owning region TOR The screen contains a brief explanation about each region When a user requests a transfer to a region the request is scrutinized by your normal security facilities Below is a sample Region Selection Screen CAFC REGION SELECTION
45. tatement normally 2 the next statement or 3 flush the current SIGN ON PROCESS VTAM B I LU6 After each request is read th Exit Program AFCP2BSX to det and all subsequent control s 2 AND EXCI Catctements e Batch Interface program invokes a Security rmine whether th is to be processed or disallowed If t user written Security Exit Pr enqueue on two resources 1 target CICS CAFC Table File the request For multiple CPU defined to GRS MSX or to ana Oname is AFCF4000 the Rn CICS This insures the resour enqueue is obtained the Batch with the target CICS Enqueue Names Qname AFCF4000 Rname Target CICS s If the CICS session is establi a Sign on Sign off Exit Program AFCP2SOxX external security manager RAC Interface At this time the Jobname is authorized to this Function Management Header FM THROUGH A DATA SET ogram the resource request he request is allowed by an attempt is made to obtain an AFCF4000 the CAFC s or a the name of the and on 2 the CICS VTAM APPLI D receiving environments thes lternative global ame is CICS VTAM applid ces are held across CPU s nqueues should be resource manager The of the target After this Interfac Vtam Applid shed successfully LU6 2 B I atte
46. userid security is b ypassed In this case recommended becaus authenticated userid the USERID spe no password i Page 181 that the B I t surrogate user security checking DFHXCOPT options table Surrogate user checking is useful when the B I is the same as the CICS regi note on userid in a surrogate cified on the s passed program userid has specify SURROGCHK YES is the program s which case the link user check is DPL call is not an BATCH TO CICS INTERFACE BATCH INTERFACE CONTINUED SIGN ON PROCESS EXCI CONTINUED If the B I program s userid and the Cl link security checking is enforced authenticated userid passed on form a authority than allowed by the link sec only the same or less authority than allowed by the link security check For more information about Cl CICS RACF Security Guide B I LU6 2 SIGNON OFF EXIT AFCP2SOX Since the CICS EXC CESN CESF signon method the LU6 2 B I AFCP2SOX is NOT called for connections made with the CICS EXC connection method urity check CS security CS region userid are different With link security a non DPL call cannot acquire more It can acquire see the CICS ESA connection method utilizes MRO security not the program security exit Page 182 BATCH TO CICS INTERFACE
47. CAFCOVER DD statement if it is present in the region s startup JCL After CAFCOVER has completed any override request processing AFCP2010 starts AFCPWARM The CAFC request types that are valid through CAFCOVER follow A ALLOCATE F FREE O OPEN G CLOSE EF ENABLE FILE CE CLOSE amp ENABLE E ENABLE TRANSACTION DF DISABLE FILE OE OPEN amp ENABLE D DISABLE TRANSACTION DBD DATABASE DUMP DC DISABLE amp CLOSE RO SET READ ONLY DBR DATABASE RECOVERY RD SET READ WITH INT UP SET UPDATE S DISPLAY STATUS EX SET EXCLUSIVE L LOCK U UNLOCK CL CLOSE amp LOCK UO UNLOCK amp OPEN DCL DISABLE CLOSE amp LOCK UOE UNLOCK OPEN amp ENABLE ID INSTALL DCT BID BYPASS WARM INSTALL OF DCT NOA SET NO ALTERNATE DSN PRI SET PRIMARY DSNAME SEC SET SECONDARY DSNAME INQ INQUIRE ABOUT DSNAME EXC EXCHANGE DSNAMES CXO CLOSE EXCHANGE DSNAMES OPEN FC FORCE CLOSE To activate the CAFCOVER request override feature simply add the following DD statement to the region s startup JCL CAFCOVER DD CAFCOVER requests use a format very similar to B I requests except no CICS applid is specified Code your CAFCOVER requests as 80 byte records Use commas between each field The request command line format follows f EPOE iye n H HGAEC CAFC Request eg CAFC Resource Name Resource Type Dc eg eg DDI Page 158 ddname for the FCT file for a ddname in the FCT for disable and close CICS ST
48. CICSTS 1 3 MSGCLASS X CLASS A MSGLEVEL 1 1 REGION 0M J BOK RK KK KK KK A A A RA A A A A A A A A A A He THIS JOB WILL DEFINE THE DASD ONLY LOGS J BK RK RK KK KK KK A A A A A A A A A A A A A A I He LOGDEFN1 EXEC PGM IXCMIAPU SYSPRINT DD SYSOUT SYSI DD DATA TYPE LOGR REPORT NO DELETE LOGSTREAM NAME TEST LOG STREAM1 DEFINE LOGSTREAM AME TEST LOG STREAM1 DASDONLY YES HLO NETEC High level qualifier for staging datasets AXBUFSIZE 400 STG_SIZE nnnn nnnn is the number calculated above LS_SIZE nnnn nnnn is the number calculated above LOWOFFLOAD 60 HIGHOFFLOAD 80 AUTODELETE YES RETPD 7 Retention period determined abov LIST LOGSTREAM NAME TEST LOG STREAM1 DETAIL YES If a coupling facility log stream is to be used first a coupling facility list structure must be defined as part of the CFRM policy The following is an example of a CFRM Policy that contains a definition for a log stream structure for use with CAFC logging This structure definition will hold a maximum of approximately 2000 CAFC log records Coupling facility structures are usually maintained by the MVS system programming staff as part of Page 307 MISCELLANEOUS CAFC UTILITIES the CF
49. LL MMED user program ests run the user program synchronously much like The XPGM request s the The batch in y be passed with to complete Page 36 allows a batch job stream to directly execute a CICS program xecution modes the AFCB B I CAFC s on line to the user program ATELY RETURN control to the the batch the EXEC tarts the AFCX transaction on a AFCX program links to the user program terface transaction AFCB will wait 5 A 45 character CI the program to be executed CS CAFC FEATURES AN USING THE BATCH TERMINAL PROCESSOR The Batch Terminal Processor CICS conversational CICS response batch job interrogated thro Batch Interface s optional input da The Ba basic CICS batch terminal The BTP returns ugh transact The TRAN request sho uld b BTF the AFCPBTX1 user exit STRT request initiates user written transac ta that DO NOT generat tch Terminal Processor s TRAN and the B I simul ators Each wi CICS provided transac suppor facili ties can simula TRAN and STRT requests to issue s STRT requests can forward a data area with the transac than a receive data instruction to commands requests are valuable for te information is trivial time and da installation TRAN reques tion on CI ts a conversation between te function keys and the k
50. TRACE OFF The trace command can be entered from either the log viewer selection screen as well as the log viewer browse screen The status of trace will be maintained across CAFC Log Viewer sessions When trace is activated it be indicated on both the selection screen and the browse screen as indicated in the following examples Z CODFS100_MANUAL EXTRA Personal l Client Fie Edt View Tools Sesion Options Help a a CAFC REL 4 4 00 ISPF LOG VIEWER Command gt _ USERID U2TEC8 Log Stream Name to View TEST LOG STREAMI TERMINAL 3278 TIME 08 12 Specify Selection Filters DATE 05 88 27 CICS APPLID Job Name Job Number Start Date Start Time End Date End Time User id Terminal Log Tupe CR ER EC CO SV SR Indicates Trace is active Record Tupe Resource Name Trace is active A licensed proprietary product of NETEC International Copyright 2005 Bl Cl 2 Page 317 Z CDDFS1NO_ MANUAL EXTRA Person nal Client Fle Edt Wew Fools Sesion Options Hep ISCELLANEOUS CAFC UTILIT ES Command DATE m APPLID 07132005 134406 CICS990 07132005 134409 CICS99Q 07132005 134429 CICS99Q 07132005 134429 CICS990 07132005 134429 CICS990 07132005 134429 CICS990 07132005 134429 CICS990 07132005 134429 CICS99Q 07132005 134429 CICS990 07132005 134429 CICS990 07132005 134429 CICS990 07132005 134429 CICS990 07132005 134438 CICS99Q 07132005 134438 CICS990
51. The B I Customizat din GM termina the CAFC ICS TCT and provide the name of the ion Options ue is high program enough time out to allow PROGRAM with inputmsg from terminal SEOX transaction WILL WAI T until The exec the EXEC C ins A sample sequential terminal T bas for ur CLES CSI finitions input format for C XPGM p Ci hae ot 2 XPGM erein p V VvV Installation library as TCTSEQX In addition you must al the AFCX transaction and its program AFCP2110 D installation Step 3 you will the XPGM request is CAFC s The link is the user ution of condition the user t provides an optional 45 character CS PROGRAM L a long INK request tall a sequential terminal in the terminal to CAFC via the Batch definition SEQX is the lso provide a PCT and PPT Tf you already have the PCT The 1 to 8 character VTAM applid of the ta rget C X In Ln cut dicates to program request voked from the B I EX EE C es L Th re Th pr e user program nam GROAN Cada wu e optional ogram the AFCX NK PROGRAM command to execut Ram COMMAREA to pass to ICS region on which you want to the program that this is an execute The program will be transaction via an Cob in CS the This area will always be passed as
52. gt Y Y SUPPORT IMPLICIT OPENS FOR FIRST ACCESS READ WRITE DELETE UNLOCK STARTBR FROM CEMT AND PROGRAMS N IGNORE IMPLICIT OPENS INITIAL OPENS gt Y Y SUPPORT INITIAL OPENS FROM DFHFCU CSFU N IGNORE INITIAL OPENS EXEC CICS SET TDQUEUE gt Y Y SUPPORT SET TDQUEUE COMMANDS FROM CEMT AND PROGRAMS N IGNORE THESE COMMANDS EXEC CICS SET TRAN gt Y Y SUPPORT SET TRANSACTION COMMANDS FROM CEMT AND PROGRAMS N IGNORE THESE COMMANDS EXEC CICS SET ACCESS gt Y Y S UPPORT SET FILE ACCESS COMMANDS READ UPDATE ADD BROWSE DELETE FROM CEMT AND PROGRAMS GNORE THESE COMMANDS EXEC CICS PERFORM SHUT gt Y Y SHUTDOWN CAFC AUTOMATICALLY WHEN AN EXEC CICS PERFORM SHUTDOWN IS DETECTED N SHUTDOWN CAFC FROM PLTSD PGM AFCP9999 Page 132 CAFC FEATURES AN EXEC CICS INTERFACE SUPPORT CONTINUED After entering the it Customization Opt DFH The activation of region with LPA YES EG quire th the above Extended Support facilities wit removal DF and Activating st on in in in to da EX HEI tion DLI ex Oz P S S e or more NETEC s intercept tercept tercept tercepted non CAFC tabases tep programs programs because Cl points f
53. include BATCH TO C CS NTERFACE BATCH TERMINAL PROCESSOR TRAN REQUEST CONTINUED SAMPLE NON CONVERSATIONAL TRANSACTION WITH DATA In the example below the user is sending a single transaction IICC to the CICS system with the APPLID of CICS99P The transaction will include the input data set system start The transaction is not conversational i e it does not return with a response so the N in column 71 tells the BTM to bypass waiting for a receive for incoming data and immediately terminate CICS99P TRAN iico set system start N SAMPLE CONVERSATIONAL TRANSACTION Now let s look at an example of a conversational transaction CICS99P TRAN abcd allow bankl C CICS99P TRAN allow bank2 CICS99P TRAN allow bank3 E In the above example the user has coded control cards to start the conversational transaction ABCD and send in the input string allow bank1 The parameter string indicates it is a conversational transaction because of the coding of a C in column 72 of the input card Next the user sends the data string allow bank2 to the conversational transaction Again it is a conversational transaction because of the coding of a C in column 72 of the input card The user next codes another input string for the conversational transac
54. program 3 6 230 EXEC CICS CALL support serviced by CAFC 84 EXEC CICS call 67 EXEC CICS call 86 executing C B I 230 ICS s serviced by CAFC s serviced by CAFC programs from the Executing secured transaction with the LUO TRAN request 244 Extended CAFC record facility Batch 288 Extended CAFC record facility Online 28 4 Extended TIOT Option 134 External Security 34 FCT activating extended CAFC support 144 145 FCT DRS field status 180 FCT Extended CAFC Support 4 15 FCT Initial Open support 147 FCT open at startup 27 FCT Scan Options 132 FCT servic support 1 request extended 49 FCT Warm Start Matrix 183 186 FCT Warm Start FCT Warm Start Options 84 using CAFCPARM 175 File Locking description 52 File Locking Status indicator 52 FMH5 B I sign on information 195 FMH5 B I sign on Information 220 Force close option 132 Forced Closed option 173 parm to Switch Table FREEDSN B I File dsname Function Management Header 34 195 218 General Debugging Trace 313 Generating CAFC records from JCL DDstatments 309 Generic Delete Option 139 GRPLIST add CAFC entries 7 Hardware Compatibilities requirements 16 HSM customization options 86 HSM Options 84 143 EC130I Message running trace 314
55. to access CAFC tion for override 45 AFCT SHUTDOWN Transaction to disable CAFC 34 6 AFCT START Transaction for program 2 99 AFCP2BCC B APPLID Selection control 1 92 AFCP2BCC B control 2 exit program syntax 04 211 246 AFCP2BSX B I 194 204 249 program external security AFCP2BSX B I 196 246 program external security AFCP2CCX B I exit program condition codes 204 211 246 AFCP2SOX B I sign on off exit program 194 204 246 247 249 253 AFCP2SOX B I sign on off exit program 1 96 AFCP2UEX on line alloc open user exit progr am 76 109 AFCPBTX1 B requests exit program tran 246 AFCPBTX1 B requests exit program TRAN 37 204 211 252 AFCPDCOM on line DataCom DB user exit progr am 80 AFCPSIP Earl 30 176 y Allocation Program AFCPSIPY Al ocation Failure Option 13 0 AFCPSIPY Early Allocation Program 27 172 AFCPSIPY establishes DFHRPL contents 49 AFCPWARM CAFC warm start program 307 hs AFCQ Transaction for shutdown messages 345 AFCR trace transaction 345 activating allocations 346 AFCT START Transaction for activating CAFC 315 AFCT STATE Transaction to display CAFC status 347 AFCT STATUS displays CAFC statu
56. xpir Page 69 the last suffix that was DB Control connection was 1 id that This parameter is ID that is to make the in seconds DB If current connect or disconnect DB transaction AFDB_TRANSACTION CONTINUED XX iiii tt CAFC FEATURES AND CONSIDERATIONS terminates with a message to the user Wait time can be specified from 10 to 999 seconds The suffix name for the DFSPZP that is to be used to Start t The The DB his DB Control CICS Connection Control ID that this CICS is to connect to maximum amount of time in seconds that the AFDB transaction is to wait for this DB Control CICS interface connection or disconnection to complete This parameter is optional If omitted the default wait time is 30 seconds The keywords on the AF following format CONNECT DBCTLI DISCONNECT D MMED ATE SUFFIX WA EL ME DB transaction may be abbreviated to the CON DBC IMM SUF WAI Page 70 CAFC FEATURES AND CONSIDERATIONS AFDB_TRANSACTION CONTINUED Transaction Definition The AFDB transaction consists of one transaction and two programs that should be defined as follows AFDB Transaction Definition OBJECT CHARACTERISTICS CEDA View TRANSaction AFDB CICS RELEASE 0530 TRANSaction AF
57. Interface program ts return code AFCP2016 after all processing is complete and The Condition Code exit then is not modified The JCL to assemble this DS as member ASMP2BCC invokes the Condition Code the Batch has the opportunity to examine and alter the return code to be produced by the Batch Interface The exit program is invoked via a standard OS LINK with Register 1 pointing to a parameter list containing a full word pointer to a full word data area containing the binary return code for the Batch The Interface exit program may set any value into this data area Interpretation of the resulting condition code in the Batch responsibility The source code for a sample Condit NSTLIB provided in the Batch tion Code exit program Commented ALC instructions show exactly how to alter Interface return code Page 231 Interface JCL is the customers AFCP2CCX is BATCH TO CICS NTERFACE BATCH TERMINAL RECEIVE DATA EXIT The CAFC Batch Terminal Processor program AFCP2LU0 invokes the Receiv provides the user Data exit AFCPBTX1 after VTAM data has been received This exit with the opportunity to inspect the contents of the data received and to set the step completion code if desired The exit program is invoked via a st tandard OS LINK with Register 1 pointing to an area in t
58. Please refer to sample member AFCP2S02 for example of MODULE STRUCTURE The Batch Interface Program AFCP2016 always links to load modules named AFCP2SOX and AFCP2BSXK It is the responsibility of the user to ensure that the appropriate Exit load modules are available at execution time For example if all of the CAFC supplied sample Sign on Sign off Exits were to be used and they were link edited as separate load modules then the user must make AFCP2SOX at run time of AFCP2016 This method can be confusing and rror pron module uniquely n the appropriate one available as a load module named Instead a Control Stub could be written to determine which functional should be given control The result would be a load module with a unique name of AFCP2SOX which would route control to the appropriate amed subroutine CSECT or load module Page 233 BATCH TO CICS INTERFACE SAMPLE BATCH INTERFACE ENVIRONMENTS INSTALLATION SAMPLE 1 Consider the following environment a single cpu and b single CICS region named CICSP where on default acb name of CICSI62 is to be used SYS1 VIAMLST MEMBER CAFVT7A BATCH INTERFACE APPLID CICSI621 VBUILD TYPE APPL CICSI621 APPL ACBNAME CICSI62 AUTH ACQ PASS CICSP TCT ENTRY DFHTCT TYPE SYSTEM TH VTAM ME CICSI621 MUST MATCH LABEL OF
59. RENAME table file entry The 1 charac ter CAFC Entry Type code must be one of the following APPLICATION LIST DDNAME GROUP LIST DBDLIST TXN Page 280 The Ent ry Type code MAINTENANCE AND CONVERSION AIDS LINKING TO THE TABLE FILE MAINTENANCE FACILITY CONTINUED AF4ENTY2 The 1 character CAFC DDname Type code The Entry Type code must be one of the following D FCT DEFINED DATA SET J JOURNAL DATASET DEFINED IN JCL I GNORE THIS ENTRY O OTHER P DLI PHYSICAL DATABASE R RPL DATA SET T DCT DATASET DEFINED IN DCT U USER INTERFACE CONTROLLED DATASET AF4ENTNM The 1 to 8 Character CAFC Table Entry name upon which you want the function performed Entry name can be specified generically by substituting asterisks as part of the entry name Entry name ABC will process all entries that start with ABC The following fields are optional and pertain to the change request only AF4NEWNM New ddname for rename function AF4CPYNM The 1 to 8 byte new DDname or TXN for COPY function AF4LINK Link indicator B linked from CAFC Batch Interface O linked from user program U linked from AFCP2100 AF4JOBNM Batch job name AF4DSNAM The 1 to 44 byte Dataset Name to replace the Dataset Name i
60. TOP DBDS AND SWITCH LOG TO READ ONLY ACCESS TO UPDATE ACCESS SET DBDS TO READ WITH NTEGR TY ACCESS SET DBDS TO EXCLUS VE ACCESS ENABLE TRANSACTIONS DISABLE TRANSACTIONS Page 247 OPERATIONAL CONSIDERATIONS SUPPORT FOR 3270 DEVICES CONTINUED NOA SET DDNAMES TO NO ALTERNATE DSNAME AVAILABLE PRI SET DDNAMES TO USE PRIMARY DSNAME FOR NEXT ALLOCATION SEC SET DDNAMES TO USE SECONDARY DSNAME FOR NEXT ALLOCATION INQ NQUIRE ABOUT ALTERNATE DSNAME SETTING PRIMARY OR SECONDARY EXC EXCHANGE DSNAMES SWITCH PRIMARY SECONDARY DSNS FOR NEXT ALLOCATION CXO CLOSE DATASETS EXCHANGE DSNAMES RE OPEN DATASETS x Specify G with request for DLI Global e g CG for Close Global jaie The 1 character CAFC Table File Entry Type The type must be one of the following not required for the SYNCH request D DDname DD FCT DDNAMES DI IGNORE DDNAMES DJ JCT DDNAMES DO NON CICS DDNAMES DP PHYSICAL DLI DDNAMES DR RPL DDNAMES DT DCT DDNAMES DU USER EXIT DDNAMES A Application List AR RPL List I DLI DBD List G Group List T Transaction The eeh wed n The 1 to 8 Character CAFC Table Entry name upon which you want the fu
61. TXN Application Transaction records GRP Group records MSG Message records Page 111 CAFC FEATURES AND CONSIDERATIONS SECURITY OPTIONS CONTINUED OPER FUNCTIONS OPER Functions are created in the same manner as USER profiles except the fixed prefix is OPER instead of USER The OPER profile allows individuals to be designated as operation personnel These persons can issue CAFC request against or BROWSE resources that they have been permitted DELETE UPDATE ADD READ authorities via the appropriate OPER profile No other CAFC functions are allowed The check for OPER authority is performed only after the check for MASTER authority and USER authority to a resource has failed CAFC operations relate to ACF2 access levels in the following manner CAFC Operation ACF Access Level Request delete Edit update Browse read The following sample resource rule is designed to create a MASTER rule The result of this rule should be 1 USER1 can complete any CAFC master control function while 2 all other users are denied access in any CICS region where CAFC is installed and ACF2 is the active security mechanism SKEY MASTER TYPE NTC UID USER1 SERVICE READ ADD UPDATE DELETE ALLOW EXAMPLE ACF2 OR RACF SECURITY RULES PROFILES Suppose we have a CICS region running with an APPLID of A anda
62. eters to ded from eters to ded from ated wit ded from ded from iated wi ded from eters to ded from eters to ded from eters to expan ded from to AFCP2BSX Bat t programs DSECTS and the fields that were changed tch 5 bytes AFCP2SOX to 8 byt Batch 5 bytes AFCP2008 5 bytes hin the to 8 byt DSECT 6 bytes to 8 byt 3 bytes th AFCD20 76 bytes User Sec 5 bytes AFCP2UEX 5 bytes AFCP2040 3 bytes that copy any of the above to 8 byt 07 to uri Some DSECTs This is not required if you are using versus your previous release ly review and update the new Customization Options panels and DSECTS may have Interface Security Exit CES Interface Signon Exit to 8 bytes CES CES CES DSECT 79 bytes ty Program to 8 byt CES User Exit Program to 8 byt CES Maintenance Program to 8 byt CES must be reassembled Any references to the fields that have changed must be examined to insure the new values will function properly NETEC has incorporat previously distribut Customizat tion Option support si superzaps taff if yo Cont ted many new facilities into Release 4 5 that were ted as custom superzaps enhancements Special Features u have questions about refit Check the tact the NETEC customer tting your site un
63. CONTINUED CUSTOMIZATION OPTION MENU The Customization Option Menu controls a series of panels CAFC s operation for Changes to the default Table File immediately resident The user updates the various cust copy of direct or indirect the unigu irements of an requ option settin When you modify an option The target Cl programs that depend on customization parameters these customizat t CAFC requests CS region tion DERAT ONS individ that tailor C ual ICS region gs are maintained on the region s CAFC the change goes into effect DOES NOT have to be cycled interrogate a memory parameters befor All CAFC they carry out tomization options by selecting a scrollable secondary option panel from the list on the Customization Option Menu 20S pictured below CUSTOMIZATION OPTION MENU 189 SELECT OPTION gt 1 FCT WARM START _ 16 RPL 2 DCT WARM START 17 SPECIAL OPTIONS 3 PCT WARM START _ 18 MESSAGE FACILITY 4 OTR WARM START _ 19 DSNAME VARIABLES 20 COMMANDS 6 BATCH INTERFACE _ 21 PEKS 7 USER EXITS _ 22 DBCNTL _ 8 SECURITY _ 23 VSAM RLS SUPPORT 9 AUDIT 10 WTO _ 11 AFCPSIPY 12 REQUEST _ 13 EDIT _ 14 HSM 15 EXEC
64. CONTROL CARD B NT tically converted to CAFC 4 5 Tabl being moved or copied from a 3 2 02 or 4 1 01 Fil to run the AFCP2020 transfer program is provided in The AFCP2020 control cards structured as follows where tt DJ DO DP DR DT DU Entry Ty DDn FCT JOU IGN OTH PHY RPL DCT The JCL also follows below JOB acct CAFC JCL TRANSFER CLASS A MSGCLASS A EXEC PGM AFCP2020 DD DSN cafc loadlib DISP SHR DD DSN cafc tablfill DISP SHR DD DSN cafc tablfil2 DISP SHR DD SYSOUT DCB RECFM FBA LRECL 133 BLKSIZE 133 DD SYSOUT DD which are contained in the SYS tt eeeeeeee rrrr XXxXXX YYYYY pe ame Table Entry DDname Table Entry RNAL DDname Table Entry ORE DDname Table Entry ER DDname Table Entry SICAL DATABASE D DDname Table Entry DDname Table Entry USE Tra Inc R CONTROLLED D nsaction TXN Table Entry IN data set Dname Table Entry Dname Table Entry ludes both AD amp AT for an Application Page 284 Table Table File ntries are MAINTENANCE AND CONVERS ON A DS TRANSFER CAFC TABLE ENTRIES BETWEEN CAFC TABLE FILES CONTINUED NOTE AD G Application CICS DDname CAFC Applic DDname Table Entry and all associated Ta
65. GLOBAL CUSTOMIZATION 2 ACF USER MESSAGE APPLICATION CUSTOMIZATION PRESS CLEAR KEY TO TERMINATE CAFC PF1 HLP PF2 2ND SES PF3 END PF4 RET PF9 ALT SES CAFC PANEL 21L After entering the item symbol for the MESSAGE FACII Customization Menu the MESSAGE FACILITY CUSTOM Use this panel to enter one of the MESSAGE il 2 TY from GLOBAL CUSTOMIZATION APPLICAT GLOBAL CUSTOMIZATION This cont be report messages will be used if 1 2 3s 4 Th Th Th Th Th 0 e e e e message facility is enabl functional event is ZAT FAC I ON CUSTOMIZATION led nabled messages ar listed in the g any OPEN CLOSE ON panel tains the messages and their locations for all events ted on a global basis i e ENABLE obal customization panel the Primary is displayed TY customization options that are to etc These return code matches the return code generated for the event l warning return 08 event failure O normal return 04 partial ere is not an application level customization record for the application ddname or application transaction name that initiated the event Page 139 CAFC FEATURES AND CONSIDERATIONS MESSAGE FACILITY OPTIONS CONTINUED APPLICATION CUSTOMIZATION This contain
66. Generic SInglesess gt No DAtastream gt User RECordformat gt U Queuvelimit gt No OPERATIONAL PROPERTIES AUtoconnect gt No INServic gt Yes SECURITY SEcurityname gt ATtachsec gt Identify BINDPassword BINDSecurity gt No RECOVERY PSrecovery gt Sysdefault Connection EXCI Group EXCIGRUP DEscription gt CAFC EXCI Generic Connection Definition CONNECTION IDENTIFIERS Netname gt INDsys gt REMOTE ATTRIBUTES REMOTESystem gt REMOTESYsnet gt REMOTEName gt Vtam IRc INdirect Xm Appc Lu6 l Exci Generic Specific No Yes User 3270 SCs STrfield Lms U Vb No 0 9999 No Yes All Yes No Local Identify Verify Persistent Mixidpe PASSWORD NOT SPECIFIED No Yes Sysdefault None Page 187 BATCH INTERFACE INSTALLATION STEPS BATCH TO C CS NTERFACE CONTINUED The Attachsec parameter controls whether security checking will be done for the CAFC request submitted through the EXCI interface Define a generic EXCI session for use by the EXCI B I program using the following parameters Step lb DEFINING THE GENERIC EXC SESSION The following parameters sh
67. ICSAPPL TRAN AFCT SSHUTDOWN Page 293 Interface by submitting the following control cards ICSAPPL TRAN AFCT SSTART UTILITY SERVICES MENU PERFORM A CAFC WARM START CONTINUED Use the enhanced AFCT transaction system replaced AFCW transaction The enhanced AFCT transact The panel below describes the stat AFCT OVER an AFCT WARM or an perform the same status changes ISCELLANEOUS CAFC UT to modify with The AFCW transaction is tion us changes transaction would have on the active reg AFCT OVER By the stat WARM that an from a cleared screen S us of the active CAFC operand has totally no longer distributed AFCT WARM and an ion Alternatively can be executed to ir ECT OPTION gt AFCT CAFC STARTUP TRANSACTION AFCT WARM D THIS T 1 RANSACTION RFORM A CAFC E E PERFO RMS WARM D CAFC WARM STA SESSION IT DURING CICS PL RT IS NO TPI CAN p START THE FOL BE PERFORM FSCAFEG OWING ED ONLY ONCE PER CICS PANEL 226 MAP A RMAL Y INVOK PROC ESSING AFCT OVER THIS TRANSACTION p E RFORMS THE FOL ED AUTOMATICALLY BY AFCP2010 OWING 1 ROCESSES CAFC 2 APCT RM REQU Dp ERFO RM
68. TO SELECT ENTER OPTION NUMBER OR TAB TO SERVICE AND ENTER sS PRESS CLEAR KEY TO TERMINATE CAFC Page 288 MISCELLANEOUS CAFC UTILITIES UTILITY SERVICES MENU _ CONTINUED ACTIVATE DEACTIVATE TRACE FUNCTIONS This function retrieves the Trace screen The screen controls the dynamic activation of CAFC s traces Pictured below is the TRACE panel for updating CAFC s Trace options TRACE OPTIONS CAFC PANEL 226 MAP I SELECT OPTION gt THIS FUNCTION UPDATES THE FOLLOWING OPTIONS FOR THE CICS REGION 1 START STOP CAFC GENERAL DEBUGGING TRACE 2 START STOP CAFC I O SUBSYSTEM TRACE 3 START STOP CAFC DLI SUBSYSTEM TRACE 4 START STOP CAFC INTERNAL TRACE NOTE THESE TRACES WILL PRODUCE A LARGE NUMBER OF PRINT LINES TO DATA SET CAFCTRAC USE THESE TRACES ONLY WHEN ADVISED BY NETEC TECHNICAL SUPPORT TO EXECUTE TAB TO gt AND ENTER s gt _ UPDATE TRACE OPTIONS PF3 END PF4 RET After entering the item number for TRACE from the Customization Option Menu TRACE OPTIONS panel is displayed Use this panel to update the following options ii GENERAL DEBUGGING TRACE INFORM
69. U O R VSAM SHARED T RESOURCES CONSTDERATTONS 6 ara a ieee a ue dice 8 See a de eb ia Rae E KING TO CAFC S DYNAMIC ALTOCAT ION FACT EET TES so enese i ee giclee eee Ss ele SS we tele TABLE OF CONTENTS TMMED LATE SHUTDOWN sOB CIG Sere s oie oo ar Petey gies she oii oe Sg ee NSH e eye Pub oleae oe A a E AET 261 CLOSING THE CAEG SEAB Ti Bis PELE wei arere aeg a te Bice Wiles cot Bie eB lene ee Ries ide eH Reni E oI Rhee leas 261 CEMT TO SHUTDOWN CICS FROM BATCH INTERFACE 2 cece cece ee eer eee cere eeee 261 MA EN TENANCE AND CONVERS TON AT D S i t6 ste eng hate Sora told E boosh Sie aR Sten d Ea E Beene eRe alec dulg Gage de eE NEL 262 EXTENDED CAFC RECORD MAINTENANCE FACILITY E Ae ccc ec ec E E ec ee ee ee 262 HEADER RECORD SYNCHRONIZAT TON ise Beles Selene E eiee die E Was ee WES G whe ele RL OSs Soe Belew Sse 270 GENERATING DDNS AND TRANSACTIONS FROM CONTENTS IN CICS TABLES 271 RLS ACCESS UPDATE COMMAND EEE EEEE Gh iy SENN E EAE R
70. UNIT SYSDA SYSLMOI DD DISP SHR DSN IMS RESLIB NTCLIB DD DISP SHR DSN cafc loadlib RESLIB DD DISP SHR DSN IMS RESLIB SYSLIN DD DISP OLD DELETE DSN amp amp OBJ DD MODE AMODE 31 RMODE ANY INCLUDE NTCLIB DFSAOEDR INCLUDE RESLIB DFSCSI00O ENTRY DFSAOEO0O NAME DFSAOEOO R CAFC INTERFACE TO DBCTL CONTINUED SAMPLE AOEEXTNM TABLE Page 55 The return codes from the In the fol NETEC suppl codes will DFSAOEOO exit ignored CAFC FEATURES AND CONSIDERATIONS DFSAOE00 driver will next call the userexit program IMS DFSAOE00 exit will be passed on to TIAL T TYPE ENTRY MODULE DFSAOENT RETCODE IGNORE T TYPE ENTRY MODULE userexit RETCODE USE T TYPE FINAL Page 56 lowing example the DFSAOEOO driver will first call the When this exit returns it s return The CAFC FEATURES AND CONS VSAM RLS SUPPORT If can send QUIESCE Q region whether Cl VSAM control CLOSE or CAFC Customization Option parameters di wi RECORD LEVEL SHARING is set to Yes in the and UNQUIESCE N requests region will OPEN requests for every region that found o QU or vy CAFC s Warmstart will warm star IESCES respectively existing B I verifies that each file is indeed a RLS file translation menu can optionally propagat with RL
71. and post close ONS in particular DERAT that program will be linked nt except the POST FREE exit point the user ther the request is to continue nk no global user exit program active Setting this option to Y will ca to for four additional situations 1 At the completion of each reg entry 2 At the completion of each reg 3 At the completion of each req a CAFC GROUP definition 4 At the completion of each reg Default value gt N DBCTL EXIT PROGRAM PROGRAM NAME use the uest to uest to uest to uest to to Globally i e Page 102 User Exit Program to be linked a sing a sing a CAFC APPL DLI le CAFC D DName or le CAFC APPLICATION entry CATION entry within a CAFC GROUP entry If a program name is specified in this option before and after each DBCTL request that program will be linked xecuted CAFC FEATURES AND CONSIDERATIONS SECURITY OPTIONS Pictured below is the SECURITY panel for updating the CAFC Security SSS EDIT TABLE CUSTOMIZATION OPTIONS CAFC PANEL 401 COMMAND INPUT gt SCROLL gt CSR SECURITY OPTIONS SECURITY PRODUCT gt B NO SECURITY BASIC SECURITY RACF SECURITY ACF SECURITY TOP SECRET SECURITY OTHER EXTERNAL SECURITY SIGN
72. gt filter DATE TIME APPLID 71320 5 134355 CICS990 07132005 134402 CICS990 ID ITEM TP REQUEST MSGi CR NULL CR STEST DO WARMSTRT OOOO DRS F DO WARMSTRT 00GA DRS F roll gt CSR HESEALE TEXT WS F X XX WS F X XX 07132005 134402 CICS990 07132005 134402 CICS990 07132005 134402 CICS990 07132005 134406 CICS990 07132005 134409 CICS990 07132005 134429 CICS990 R CAF INTRA DT WARMSTRT 07132005 Ba CICS99Q CR CAFF DT WARMSTRT 000A DRS OE 07132005 134429 CICS990 CR CAFCTRAC DO WARMSTRT 002A DRS A 07132005 134429 CICS99Q CR CAFCLSTA DT WARMSTRT 000A ORS OE 07132005 134429 CICS990 CR CAFCLSEC DT WARMSTRT 000A ORS OE Ee 134429 CICS990 CR CAFCLERR DT WARMSTRT DRS 0E 7132085 134429 CICS990 CR CAFCLEDT DT WARMSTRT 000A DRS 0E 07132005 134429 CICS990 CR CAFCLCUS DT WARMSTRT BGA DRS 0E 07132005 134429 CICS990 CR CAFCLCOR DT WARMSTRT OBOA DRS 0E 07132005 134429 CICS99Q CR BASE DO WARMSTRT 0 DRS OERO 07132005 134430 CICS990 CR CEEMSG DT WARMSTRT 000A DRS 0E 07132005 13443A CICS99Q CR COOFAROR DT WARMSTRT BOBA DRS OE m lt 05 3 03 21 Kermctnd to how 10 1120 i J 7 T_T om CR AFCIROR DO WARMSTRT BOBA ORS A CR AFCPLERR DT WARMSTRT BAA DRS 0E WS 0 E CR AFCPLCOR DT WARMSTRT OBOA ORS 0E WS 0 ms ae u WARMSTRT BBA DRS 0E WS 0 E PERRE 0953 RLS FILE DSN SET gt FCT 2020 DRS FE WS F E WS A X XX After pressing enter the display filter criteria screen will be displayed following is an example of this scree
73. ter CAFC Table File Entry type t be one of the following not OPERATIONAL CONSIDERATIONS SEQUENTIAL TERMINAL SETUP AND USAGE DFHSG SPECIFICATIONS DFHSG PROGRAM TCP ACCMETH BSAM ACCESS METHOD SUPPORT DEVICE DASD SEQUENTIAL DEVICE SUPPORT EODI E0 BSAM END OF DATA CHARACTE TCT ENTRIES DFHTCT TYPE INITIAL ACCMETH NONVTAM TITLE SEQUENTIAL TERMINAL ENTRIES KKEKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK SEQUENTIAL TERMINALS THE FOLLOWING TCT TABLE ENTRIES ARE SUPPLIED IN THE CAFC INSTALLATION LIBRARY AS MEMBER TCTSEQT KKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKKK SPACE 3 DFHTCT YPE SDSCI DEVICE 2540 DSCNAME SEQTRMIN DFHTCT YPE SDSCI DEVICE 1403 DSCNAME SEQTRMOT DFHTCT TYPE LINE ACCMETH BSAM TRMTYPE CRLP Page 252 xK X x K K MX OPERATIONAL CONSIDERATIONS SEQUENTIAL TERMINAL SETUP AND USAGE CONTINUED DFHTCT YPE TERMINAL RMIDNT SAMA PLEN 80 ERRATT NO RMSTAT TRANSACTION JCL TO ALLOCATE DATA SETS
74. with or without keyed input and responses transfer of control to C the CAFC Table File user programs 7 8 maintenance to Review and set CAFC s Customization Options automatically default to values VSAM and IMS environments 5 6 refined to meet your region unigu EXEC CICS interface to close and continue with Step 9 install interface that intercept command ac The interfac free disable allows CAFC to automat tical against and close calls are issued against Page 3 4 the initiation of CS user transactions execution of CICS CS user programs and CS regions CAFC file and database status changes CEMT commands These options that operate properly for most The options should be reviewed and requirements If you routinely use CEMT set commands or program calls to the open transient da The procedures will tivity ta queues CAFC s DCT resources y allocate enable and DCT resources as CEMT requests and EXEC CICS open DCT resources NSTALLATION PROCEDURES INSTALLATION PROCEDURE FOR THE FULL CAFC SYSTEM CONTINUED Step 10 Step 11 Step 12 If you routinely use CEMT set commands not CAFC requests enable and disable transactions follow the instructions in step to 10 The procedures will install an interface that intercepts command activity against PCT resources The
75. with which you will replace the DSN search string The CAFC Table File must be closed to CICS when running the AFCP2020 Batch Transfer program AFCT SHUTDOWN the section on Closing the CAFC Table File entitled OPERATIONAL CONS issue the DERAT ONS Page 285 To close th transaction e Table File to CICS For more details in the chapter review MA INTENANCE AND CONVERSION AIDS GENERATE DDNAME RECORDS FROM JCL DD STATEMENTS AFCP2023 is a CAFC utility program which will create CAFC DDname Table Entries from JCL DD statements This program is a handy conversion aid Below is a description of the program and its control cards 1 AFCP2023 will reformat JCL card images located in a PDS member in a within in stream data sequential data set or 2 Installation member CAFCCVDD contains JCL to run the AFCP2023 conversion program The JCL is also listed below CAFCCVDD JOB acct CAFC DD CONVERT CLASS A MSGCLASS A JIS010 EXEC PGM AFCP2023 STEPLIB DD DSN cafc loadlib DISP SHR DER OUTCAFC DD DSN cafc tablfile DISP SHR LIF SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 BLKSIZE 133 FIE SYSUDUMP DD SYSOUT IARE SYSIN DD DATA DELIMITER S JCL DDCARD JCL DDCARD JCL DDCARD 3 The AFCP2023 control ca
76. 22 CDDFS100_MANUAL EXTRA Personal Chent a i EE CAFC REL 4 4 00 ISPF LOG VIEWER Command USERID U2ZTECS Log Stream Name to View LOGGER TEST PROGRAM ae aN Specify Selection Filters DATE 05 08 27 CICS APPLID Job Name Job Number Userid Terminal Log Type CR ER EC 00 SV SR R A licensed proprietary product of NETEC International Copyright 2005 05 9 20 05 Reermctnd to hont 10 11 20 afi a s ies P anan After the log stream has been scanned and if there were log records present that met the selection criteria the records will be displayed The following screen _is_ an example of log records being displayed Z COOFS100_ MANUAL EXTRA Personal Cheat zaxi Help Eta eae FE CAFC REL 4 4 00 ISPF LOG VIEWER CAFC Log Stream gt LOGGER TEST PROGRAM Command gt Scroll gt CSR nd gt _ DATE TIME APPLID ID ITEM TP REQUEST MSGi MESSAGE TEXT 07132005 134402 CICS990 CR AFCPLERR DT WARMSTRT OAA DRS 0E WS 0 E 07132005 134402 CICS990 CR AFCPLCOR DT WARMSTRT 8 DRS 0E WSO E 07132005 eae CICS990 CR AFCIROR DO WARMSTRT 0000 DRS A WSFA X XX 07132005 134402 CICS990 CR TEST DO WARMSTRT Q oe ee va KX 07132005 ie CICS99Q CR AFCPLSEC DT WARMSTRT 07132005 134409 CICS990 CR BASE OD WARMSTRT 0283 Rr FILE i si gt FCT 07132005 134429 CICS990 CR CAFF DT WARMSTRT 00 DRS OE 07132005 134429 CICS99Q CR CAFCLSTA DT WARMSTRT 2
77. 26 ACF2 SAFDEF STATEMENT ACF2 requires a SAFDEF statement that authorizes CAFC to issue RACROUTE or SAF calls The following represents the SAFDEF GSO statement necessary to support CAFC s use of ACF2 as the external security manager SAFDEF ATHCAFC ID CAFCDEF FUNCRET 4 FUNCRSN 0 JOBNAME MODE GLOBAL NOAPFCHK ROGRAM x ACROUTE REQUEST AUTH LASS SCAFC USERID ENTITY BiGe eX Ek REN TCODE 4 SERID GHAAaQAD NV Page 109 CAFC FEATURES AN Page 110 D CONS DERAT ONS SECURITY OPTIONS CONTINUED CREATING ACF2 RULES CAFC FEATURES AND CONSIDERATIONS You must create ACF2 resource rules that will be utilized to protect CAFC resources Access to CAFC resources is divided into 3 levels MASTER USER and OPER MASTER access is intended to be reserved to System Programming level personnel USER access is intended to be for Application Programming personnel and OPER access is intended to be used by operations personnel who issue CAFC request Separate CAFC systems running in separate regions can be uniquely identified by their CICS APPLID and thus protected individually CAFC honors ACF2 generic rules so more general rules can be created at your installation CAFC creates resources names that a user s aut
78. 2RCF ASMP 2ACF ASMP2TSS tables with the userids and operids of the adminis unique Customization Options Ss th ACF2 user written external update the Userid Table QU t be defined befor end you include all of e CAFC Customization Options access to all of the CAFC DTBL urity interface programs m to function properly L security programs nclude all of the userids that Proprietary CAFC APF N A N A ust be user ty exit program contains MSTR and the Update one or both of these cra At tors who will least one activating external are allowed to access the CAFC Customization Options not support operids Page 115 the userids that are Operids are insure you ACF2 does CAFC FEATURES AND CONSIDERATIONS SECURITY OPTIONS CONTINUED With user written Top Secret external security programs insure you update the Userid Table UIDTBL nclude all of the userids that are allowed to access the CAFC Customization Options Operids are optional 3 Include the selected external security exit program name in each of your regions PPT 4 Review and update your CICS regions Sign On Tables DFHSNT so that they conform to your external security package requirements 5 Specify EXTSEC YES in the CICS S T or in the region s CICS override parameter list This allows CIC
79. 3 3 se TC ac ees een sie Beals a STEPLIB DD DSN user batch loadlib DISP SHR DD DSN ims reslib DISP SHR Optional Note 1 The following DD statement is optional See Note 2 DD DSN cics exci loadlib disp shr SYSUDUMP DD SYSOUT CAFCTRAC DD SYSOUT See B I Trace FIP CRe BA c DD DSN cafc tablfile disp shr Optional Note 3 AFCCSSN DD DSN cafc cssninfo disp shr Optional Note 4 SYSIN DD i Optional Note 5 Celeste EEPEE EU Mier 2 Son Ny ORE ie ede eRe eben OR Bbw ate d Ce tots ls CAT PEEL ECA ees TG OS aS ee oe et eh S Komal d CAFCPARM DD Optional Note 6 Parml Parm2 B I REQUEST COMMAND LINE FORMAT Cees Cc FEE ys ov snes Ty s 5 wie eee ae CERES d New CAFC Resource Name g dsname field Target CICS only required for a dsname change request CAFC Resource Name g ddname for the FCT file CAFC Request DD t CAFC Resource Type eg FCT DDname eg DC disable and close APPLID eg CICSPROD Page 194 BATCH TO CICS INTERFACE B I EXECUTION JCL AND COMMAND LINE FORMATS CONTINUED B I TRACE FACILITIES FOR THE BATCH JOB COMPONENTS If you experience a failure within the batch job components of the B I NETEC sS customer support group will likely request a B I trace that traces activity on the batch job side There are two command formats to activate the trace PARM TRACE Y
80. 348 SHUT Transaction to gracefully terminate CICS 348 Shutdown message option 132 Shutdown Message Option 134 Shutdown options 149 Shutting down CAFC 316 Shutting down CAFC from batch 316 signon method FMH5 requirements 8 Sign on method for the B I 8 signon method NONE requirements 8 SINK Transaction resets restart stutus in CAFC 348 SIT Requirement for RACF 114 Software Compatibilities requirements 16 SONSCIP vtam parameter required 22 SONSCIP Vtam parameter required 201 sonscip yes 18 Sort Sequence for On line Displays 85 140 Sort Sequence for On line Displays 138 Special Options 86 SRCH Transaction to locate programs in DFHRPL 348 Starting CAFC 10 Starting CICS programs from the B I 230 Starting CICS Programs from the B I 36 tarting up CAFC 316 tarting up CAFC from batch 316 tarting User Transactions from the B I 37 234 237 239 Status request 83 Status request for CAFC system AFCT 347 Status request transaction AFST 349 Step Return Code override 246 STRT B I Request to start a transaction 234 STRT B I Request to start a transaction 37 Synchronize_CAFC command 284 Synchronize_Header command 284 Synchronize_RLS field 20 Synchronize_RLSFLAG command 285 SYS1 VTAMLST B I requirements 201 SYSIL VTAMLST parameter examples 254 255 256 257 258 261 SYS1 VTAMLST parameter examples for LUO ach 242 TCT entries for the B I
81. 42 PF key 8 will scroll the display one scroll increment PF key 7 will move the display one scrol PF key 3 will cause the RPL list to The available PF gt area will user specified insertion point e default insertion point is the top of the RPL concatenation list sertion point can be controlled by the edit BEFORE or AFTER line mode The CAFC FEATURES AN DFHRPL LIBRARY MANAGEMENT CONTINUED COPYING THE CURRENT DFHRPL CONCATENATION D CONSIDERATIONS The external COPY command when specified with the DFHRPL operand will create unique symbolic ddnames for all datasets contained in the current RPL concatenation With this operand the COPY command places the RPL information into the edit screen at the BEFORE or AFTER position selected by the user These ddnames are created with a prefix of SRPL followed by This implies that a maximum of 9 999 generated ddnames can be contained in the region s CAFC Table a sequential number from 0001 through 99 9 File Each of these ddnames can be alternately displayed or modified using a standard ddname edit session RPL ddnames require an entry type specification of DR from the EDIT ENTRY MENU however is generally a more convenient editing solution then a ddname edit session UTILIZING PREVIOUSLY DEFINED RPL DDNAMES The RPL List editor When a DDNAME is specified in the DDNAME field of the RP
82. AFCP2008 the contents of the remaining fields in the parmlist are as follows AF7DATE The date of the request in the form MMDDYY AF7TIME The time of the request in the form HHMM AF7REQBY The requestor id in the form OOObTTTT where OOO 3 character operid from TCTTE B Blank TTTT 4 character termed Page 257 OPERATIONAL CONSIDERATIONS LINKING TO CAFC S DYNAMIC ALLOCATION FACILITIES CONTINUED AF7RCODE The 1 byte hexadecimal return code where 0 x 00 Successful Completion 4 x 04 Partial Completion 8 x 08 Complete Failure 12 x 0C Invalid Name 16 x 10 Invalid Request 20 x 14 Read Error on Table File 24 x 18 Attach of O S Subtask Failed 28 x 1C O S Subtask has Abended 29 x UD RLS FCT Invalid 32 x 20 GETMAIN Failure 33 x 21 Exceeded error message buffer 36 x 24 Status messages follow 37 x 25 Status messages follow 38 x 26 Status messages follow 39 x 27 Status messages follow 40 x 28 Entry Onlin Returned on S status when all files are allocated to CICS ither Opened or Closed and all transactions are Enabled for a DDname an Application or a Group 44 x 2C Entry Offlin Returned on S status when at least one file is not allocated to CICS or at least one transaction is not Enabled for a DDname an Application or a Group 48 x 30 Warning messages 52 x 34 No Action T
83. APPL PE LUTYPE62 R 256 E 256 A R T TRANCEIVE GHNAKODE Hw ADaGGAE Page 234 BATCH TO CICS INTERFACE SAMPLE BATCH INTERFACE ENVIRONMENTS CONTINUED INSTALLATION SAMPLE 2 Consider the following environment a single cpu and b two CICS regions named CICST and CICSP where c default acb name of CICSI62 is to be used SYS1 VTAMLST MEMB T R CAFVT7A BATCH INTERFACE APPLID CICSI621 VBUILD TYPE APPL CICSI621 APPL ACBNAME CICSI62 AUTH ACQ PASS CIGST TCT ENTRY DFHTCT TYPE SYSTEM ACCMETH VTAM TNAME CICSI621 MUST MATCH LABEL OF APPL PE LUTYPE62 AT TRANCEIVE R ll ep H zZ Q Tj TCT ENTRY DFHTCT TYPE SYSTEM TH VTAM ME CICSI621 MUST MATCH LABEL OF APPL PE LUTYPE62 AT TRANCEIVE R Il ep H Z Q H Tj Page 235 BATCH TO CICS INTERFACE SAMPLE BATCH INTERFACE ENVIRONMENTS CONTINUED INSTALLATION SAMPLE 3 Consider the following environment a two cpus where b batch interface runs from either cpu and CICS runs ONLY on cpu 1 _CPU 1 SYS1 VTAMLST MEMBER CAFVT7A BATCH INTERFACE APPLID CICSI621 VB
84. BATCH JOBNAME AS USERID IN LOGS IF THE CICS ABENDED EN BATCH INTERFACE ACTION WILL BE ACTION CODE gt C C CONTINUE IGNORE CICS ABEND ISSUE WIOR FOR TERMINATION OPTIONS TERMINATE WITH FOLLOWING RETURN CODE RETURN CODE gt 16 ECIMAL VALUE EXCI CONNECTION PARMS WAIT INTERVAL gt 00020000 TIME VALUE HHMMSSTH FREQUENCY gt 03 DECIMAL VALUE TIME OUT LIMIT TIME OUT INTERVAL gt 00030000 TIME VALUE HHMMSSTH XPGM REQUEST gt 00010000 TIME VALUE HHMMSSTH LUO PROCESSING FORMAT OUTPUT DATA gt N Y N SHOW OUTPUT DATA IN SCREEN FORMAT BATCH INTERFACE EXCI ONLINE TRANSACTION CODE The B I ICS components C the B I desired transaction code has been assembled in the to the CSI DFHMIRS and a profile of NOTE Defa ult value D with a program of gt AFCI Insure that the TASK uses a default transaction code of AFCI If you wish to change the B I Online Transaction Code option on this panel DSNAME CHANGE ONLINE TRANSACTION CODE The B I the B I tranid in the uses a default transaction code of whenever a data set name change request is issued data set name change transaction identification Dsname Change Online Transaction Code option on this panel AFCM to communicate with its transaction simply change Ensure that the DFHPCT table or added DFHCICSA DATALOC is set to BELOW to communicate with
85. Batch D must be defined in SYS1 VTAMLST to identify the B I Each CICS region req W ICS is supplied to the Batch le exit program target Cl terminal AFCP2BCC CS VIAM Applid The batch job must wait for Interface jobs that This wait takes place even if the other batch jobsteps offers a lower Batch and the MULTIPLE LU NAME options UNIQUE VTAM ACBS FOR EACH REGION Program serialized but only for concurrently executing Batch running on are 1 In this mode can communicate a batch interface jobstep Batch In the same CPU and are 2 They ar ICS VTAM ACB If the MULTIPLE LU NAMES option is activated int same target region optimum Batch defined to Sec rleaved and processed simultaneously same time interval Page 175 Interface performance level than the invoking the Batch with a given CICS region without for the termination of other concurrently executing Batch which are talking to different CICS regions UN having rfac program COUCI uires a LUTYPE6 2 CS Interface by a user written exit program The which Interface to wait Interface jobs uests are In requests are not Interface Program performance if you have MULTI those regions that are likely to receive batch requests from multiple b
86. CAFC requests without invoking the driven full screen AFCS transid menu This from This Inter promp face AFC t response for B I requests Page 320 transaction supports executions of Cl the B I using the XCTL request CS programs started transaction is the on line component of the EXCI Batch I s priority should be set to 255 to insure CAFC SUPPORT TRANSACTI ONS CAFC SUPPORT TRANSACTIONS CONTINUED AFCM name changes through B I AFCO AFCR AFCS AFCT DEQ AFCT OVER AFCT SHUT AFCT START AFCT STATE AFCT WARM AFCZ DOWN This is a special purpose transaction that supports data set dsname change requests This is an internal transaction used to deliver CAFC shutdown messages to the terminal where the CEMT P SHUT originated Activates CAFC traces With no operand starts the full screen CAFC system This transaction operand releases the OS enqueue AFCF4000 CICS applid This transaction operand runs the CAFC requests stored in the CAFCOVER data set This transaction operand 1 enqueues on the CAFC Table File to prevent B I activity 2 quiesces currently active CAFC activities 3 removes CAFC s extemd CICS support functions 4 sets shutdown status condition to normal 5 closes and frees the CAFC Table file 6 releases th nqueue on the CAFC Table File and 7 terminates CAFC s service program AFC
87. CAFC s status stored in the CAFC support ies e g you have This installation procedure for APF Authorization as described in Installation STEP 2 EXEC CICS SET ACCESS FILE SERVICE REQUEST EXTENDED SUPPORT This support should be activated if you use CEMT commands or the EXEC CICS interface to alter the file service status LE SERV CE REQUEST interface installed the FCT CAFC will n ta CUS If you always use CAFC reques maintain the true status wilt Without CAFC s the s ES LO F stored in the CAFC Table File may differ from the true sta i s rvice request status tus stored servic change fil thout this interface EXEC CICS PERFORM SHUTDOWN CEMT P SHUT INTERCEPTION Activation of this option al lLlows CAFC to be terminated whenever a CEMT P SHUT is issued eliminating the need for placing AFCP9999 in the shutdown PLT CAFC will L intercept the P SHUT and allow CICS to continue it s PLT shutdown process while CAFC is being shutdown If you prefer Program AFCP99 to run AFCP9999 from the PLT 99 must be placed prior stage of PLT processing CAF current activity has ceased set to C will not Page 135 DFHDELI remove its support until all this option to N M to run during first CAFC FEATURES AND CONSIDERATIONS DFHRPL MANAGEMENT OPTION
88. CEMT SHUT IMMEDIATE CAFC will gracefully terminate CLOSING AND OPENING THE CAFC TABLE FILE If you need to close the AFCF4000 Table File while CICS is running use the enhanced AFCT transaction with the SHUTDOWN operand eg AFCT SHUTDOWN This will deactivate the dynamic allocation intercepts and allow all other CAFC activity B I and on line to complete You may now run batch programs against our file such as our utilities B I job steps will be locked out direct updates to the CAFC Table File during this short quiescent reopen the fil period After you have completed your updates you may by issuing the AFCT START transaction CEMT TO SHUTDOWN CICS DO NOT USE the CEMT P SHUT command through the B I to terminate your CICS regions and their associated VTAM sessions This w VTAM communications before they can be normally terminated CAFC may not terminate properly DO USE the CAFC supplied SHUT SHUT transaction through the B I will gracefully close and terminate the active CAFC resources and simul Page 261 ill likely remove th transaction The late a CEMT P SHUT command MAINTENANCE AND CONVERSION AIDS EXTENDED CAFC RECORD MAINTENANCE FACILITY The Extended Maintenance Facility can be used to alter CAFC records identified by single key generic key key list or key grouping Commands
89. CS region uest is targeted for a again invokes AFCP2SOX CAFC then to receive to more that the CS region BATCH TO CICS NTERFACE BATCH INTERFACE CONTINUED SIGN ON PROCESS EXCI For a complete discussion of EXCI security refer to the appropriate CICS EXCI manual for the proper version of CICS The CICS EXCI interface uses the CICS IRC to communicate with a CICS region The the security implications for the CAFC EXCI B I are identica 1 to any CICS MRO connection CICS applies security checks in several ways against requests received from the B I These checks fall into four areas 1 MRO logon and connect security performed by DFHIRP 2 link security performed by the CICS region 3 user security checking performed by in the CICS application program and 4 surrogate user checking performed by the CICS EXCI in the B I program address space MRO LOGON AND BIND TIME SECURITY specific DFHIRP the CICS interregion communication connections only program performs two security checks against users that want toO connect to a CICS region also referred to This logon security checking applies only to B I program executions that are utilizing CICS connections that are defined as SPECIFIC connections The MRO logon security check is not performed for generic connect
90. Closes Allocations Frees and Enabling Disabling 2S EDIT TABLE CUSTOMIZATION OPTIONS CAFC PANEL 401 COMMAND INPUT gt REQUEST OPTIONS CLOSE OPTIONS NUMBER OF FCT SCANS gt 10 WAITING FOR CICS CLOSE TO COMPLETE FCT SCAN INTERVAL gt 000005 TIME INTERVAL HHMMSS CLOSE DELAY TIME gt 01 01 99 DELAY TIME IN SECONDS AFTER A CLOSE REQUEST DISABLE CLOSE DELAY gt 01 01 99 DELAY TIME IN SECONDS AFTER A DISABLE CLOSE REQUEST FORCE CLOSE OPTION gt N Y N ALLOW FORCE CLOSE REQUEST OPEN OPTIONS VSAM ALLOCATION gt Y Y N AUTOMATICALLY ALLOCATE VSAM FILES x S Z o D TIOT gt Y Y N USE EXTENDED TIOT FOR ALLOCATIONS MESSAGE OPTIONS WARNING MESSAGES gt Y Y N DISPLAY WARNING MESSAGES SHUTDOWN MESSAGES gt B Y DISPLAY MSGS AT TERMINAL M DISPLAY MSGS AT MVS CONSOLE B DISPLAY MSGS AT TERMINAL amp MVS CONSOLE N DO NOT DISPLAY MESSAGES AUTOMATIC ENABLE DISABLE ENABLE ON
91. Copying table entries from one file to another 307 Crashed region option reset Q Q 193 CORPER program 100 103 104 Creating CAFC tablefil ntries 31 CSD entries on Install Tape 5 CSFU Transaction 30 CTLCUP CICS Region Status Indicator 98 190 CTLCUP to clear the region crash Flag 100 103 104 Customization Options 83 Customization Options summary 84 DALCLOSE option 132 DataCom DB on line user program AFCPDCOM 80 DBCTL Saoeexit 56 DBCTL activating 53 DBCTL B I Times Out DBCTL Batch Time Out xit 53 56 DBCTL Commands expire wait time 56 DBCTL_DFSAOEOO DBCTL name DBCTL options DBCTL Options DBCTL required IMS ptfs DBCTL Support DBCTL support DBNTL name DCNTL batch support DCT activa exit 53 168 84 86 147 activat 168 time out ting extended CAFC 144 DCT 84 AFC5 3125 316 12 145 3 Defaul Defaul DCT Automa 56 ion 168 DCT Warm S ta DCT Warm S Ddname Record main ta 320 Ddname Record Main AFCP2502 Deactivating Deactivating Deactivating Deactivating DEFACB B I Audit Trail B I 303 Automatic Allocation Debugging Trace 313 rt Options 8 rt using CAFCPARM tenance with 56 144 tic Allocat
92. DATASETS TDQUEUES U IESCE DATASE DATASETS AVAI DATASETS AVAI TS LABLE LABLE amp START UNQUIESCED DB DS its full AFCC for tering CAFC Requests tion offers the ITEMS MATCHING THE IESCE amp OPEN DATASETS AVAI DATASETS AVAI T DB DS DATASET S OPEN TDQUE UES START DBDS LABLE UNQUIESCE LABLE amp OPEN OPEN TDQUEUES DBDS START D amp OPEN OPEN TDQ UEUES DA T DBDS DATASETS AVA T DBDS TASETS OPEN TDO ILABLE UNLOCKE IL UNLCK D UNQUIE UEUES START DB DS SCE D amp OPEN OPEN TDQUEUES D amp OPEN OPEN TDQUEUES OPEN DATASETS TDQUEUES Page 246 START DB DS ENABLE TXNS OPERAT SUPPORT FOR 3270 DEVICES CONTINUED UOE NOE UNOE C CE Q X QX CL CQ CX COX COL CLX COLX DC DCL DCO DCQL EG DBD DBR RO UP EX UNLOCK amp OPEN D TXNS TONAL CONS DERAT ONS ATASETS OPEN TDQUEUES START DBDS ENABLE NLOCK UNQU NABLE TXNS NQUIESCE amp OPEN NABLE TXNS DATASETS OPEN TDQUEUES START DBDS ESCE OPEN DATASETS OPEN TDQUEUES START DBDS
93. DD DSN in cafcfile DISP SHR oes SYSPRINT DD SYSOUT DCB RECFM FBA LRECL 133 BLKSIZE ft REPORT DD SYSOUT DCB RECFM FBA LRECL 133 BLKSIZE J SYSIN DD CE REEERE E n EG he e See a Ges n GT eh eenaa ee n GG Poa ae ash Be ewe n SYSUDUMP DD SYSOUT where ttt The 1 3 character type code Must be one of the following D DDNAME ENTRY ALL TYPES DD DDNAME ENTRY TYPE D FCT ENTRY DT DDNAME ENTRY TYPE T DCT ENTRY DJ DDNAME ENTRY TYPE J JOURNAL DI DDNAME ENTRY TYPE GNORE DO DDNAME ENTRY TYPE O OTHER DU DDNAME ENTRY TYPE U USER DP DDNAME ENTRY TYPE P DATABASE DR DDNAME ENTRY TYPE R RPL Page 297 133 133 MISCELLANEOUS CAFC UTILITIES CAFC TABLE FILE ENTRY BATCH REPORT CONTINUED The step return codes 00 04 08 12 1 3 character type codes continued T Transaction Entry I DBD NAME ENTRY A APPLICATION ENTRY G GROUP ENTRY RL APPL Route entry SL SUBLIST entry GL GLOBAL Route entry CS GLOBAL Route Customization AC APPL Route Customization DS DDNAME ENTRY Summary list DDS FCT DDNAME ENTRY Summary list DTS DCT DDNAME ENTRY Summary list DRS RPL DDNAME ENTRY Summary list DJS JOURNAL DDNAME ENTRY Summary list DIS IGNORE DDNAME ENTRY Summary list DOS OTHER DDNAME ENTRY Summary list DPS DATABASE DDNAME
94. DFHTCT LU6 2 Terminal Definition 255 2507 254 7 258 DFHXCOPT 210 DFHXLT entries required 203 DFHXLT quiescence processing 203 DFHXLT requirement for AFCB 98 DFS250W 0410 Error Message 12 DFSPZP suffix 168 DFSPZP Suffix 53 DIRECT B I keyword 218 Disable on CAFC action 69 Disabling Options 132 Disk Management System Proc Name 142 DLI Extended CAFC support 86 Domain Unique Vtam Resources 201 205 DRS Access Status 182 Dsname change facility from the B I 98 Dsname changes to nodes with AFC5 299 300 302 320 Dynamic Allocation Exit activation 311 Dynamic Allocation Trace 313 Edit Screen Options 84 85 Effective Warm Start Status 186 enable all messages 70 enable function messages 70 Enabled Status controlled by DRS 180 Enabling Options 132 Enqueue Manager requirements 195 Enqueue Names for Multi CPU Operation 195 Engqueue on AFCF4000 345 Error condition alert messages 153 Error Message Help File 5 Error Messages MRO Selection Screen 66 Error messages sent to CICS terminals 157 EXCI required DFHSIT parameter 210 EXCIMSG parm 219 EXCITIME parm 219 Exclude Table 81 Excluding resources from cafc processing 81 EXEC B I request to start a CICS
95. DS FOR C OPTIONS e eaka led ees ie Rae re ca 8 aca No die ce ha ete Sac E a ae te daca Bate doe anes TOMIZATION PAN PRS TABLE OF CONTENTS KEYS FOR CUSTOM DSNAME VARIABLES DBC VSA CICS STARTUP AFC CAF CAF AFC TL OPTIONS M RLS SUPPORT O CONSIDERATIONS PSIPY EARLY A WHOCAT ION REOQUPREMENT Si ed 10 ue P86 ei secs Soe CUS Sue eel go Bowl Sue Wi side Buel COVER CAFC OV COVER FOR DSNAM im ry im ry ERRIDE REQUESTS AL iS LTARTUP wesie secs Se nE oa aye eee eg he eed a E STARTUP OVERRIDE Serera saa ete SS a bgp Eaa aS eae ahs ace PWARM CARG S WARM START BAG Deh TY seeiis ered ters dees cease Sate E Sees aie endo net See ce DES WAR SAM SAM BATCH TO CICS OP ERATIONAL C INS SN HH ve D gt Q NST M START OPTIONS TRED RESTART STATUS DRS TUTORIAL tess e Ee a esd oo Sad ARA a ke E E S a DE SCRIPT PON ve aire Tahid eie G eea E SNe ew E Suds pee eee e 49 SS PE BGT WARM START MATRIX ae aaa sails tee Ne Wels ete a a leis ale si E Eaa le Beate ea lene Bie a belts NTERFACE PGE PCT WARM START s OP TONS seis ae 28 ice Ea EEEE ie nd oo ON tie he aie te E ib MSs Te Lea EE oui Tele ACE VTAM DUG 2 BY Tesco he tie states hee ak Sar A See ee ee eer oes I TALL
96. ENTRY Summary list ES DBD NAME ENTRY Summary list AS APPLICATION ENTRY Summary list GS GROUP ENTRY Summary list XTS TRANSACTION ENTRY Summary list SA APPLICATION ENTRY list plus a 1 line summary print for each DDname in APPLICATION i a EE n The 1 to 8 character CAFC Table entry you want listed If omitted all of the entries in the table will be listed Generic qualifications are acceptable in entry name field will print all applications Entry name is not allowed with summary requests that AFCP2021 generates ar Correct control cards records found Correct control L cards no records found Incorrect control cards CAFC Table File not opened or not available Page 298 MISCELLANEOUS CAFC UTILIT CAFC CONTROL RECORD REPORT To print the contents of a region s CAFC Table File control record use the following JCL to exec provided in the CAFCCTLR JIS010 STEPLIB fe INCAFC IIE SYSPRINT pe REPORT fae SYSUDUMP ute program AFCP2045 ES This sample JCL is also SYSOUT DCB RECFM FBA LRECL 133 BLKSIZE 133 SYSOUT DCB RECFM FBA LRECL 133 BLKSIZE 133 NSTLIB PDS as member CAFCCTLR JOB ACCT CAFC CLASS A MSGCLASS A EXEC PGM AFCP2045 DD DSN cafc loadlib DISP SHR DD DSN in cafcfile DISP SHR DD DD DD SYSOUT
97. EXCI transaction AFCI or the transaction name specified in the system default parameters This is required for transaction attach security checking The profiles for all of the resources accessed by the CAFC EXCI transaction and programs e g files queues transient data and temporary storage programs etc This is required for resource security checking CICS ESA CICS RACF Security Guide for information about MRO link security checking USER SECURITY The CICS region performs user security checking against the userid passed by the B I program on a DPL CALL request This userid is the userid id that is obtained From the CAFC master file if specified or From the AFCCSSN DDNAME if present or From the Jobcard of the B I program execution JCL Page 180 BATCH TO C CS NTERFACE BATCH INTERFACE CONTINUED SIGN ON PROCESS EXCI CONTINUED User security checking is performed only when connections ATTACHSEC DE NT FY link security you make for link security specified on active you m the DPL If you want to run the CAFC EXC ust specify ATTACHSEC LOCAL specify User security is performed in addition to any For user security CALL request in addition t you must also authorize the B program wit SURROGATE USER CHECKING A surrogate user check is performed to verify
98. Edit entry panel AFCM208 MAP Function Menu AFCM209 MAP AFCM21L MAP AFCM21M MAP AFCM21N MAP AFCM210 MAP Message Table List AFCM21P MAP AFCM210 MAP AFCM21R MAP AFCM218S MAP AFCM21T MAP AFCM212 MAP AFCM213 MAP AFCM214 MAP AFCM218 MAP AFCM220 MAP AFCM225 MAP AFCM226 MAP AFCM227 MAP AFCM238 MAP Function Menu AFCM239 MAP AFCM250 MAP AFCP2501 Mantenanc AFCM252 MAP AFCM400 MAP Screen AFCM401 MAP Customization Options Edit amp Browse Screen Page 326 CAFC INSTALLATION CONTENTS CAFC LOADLIB CONTINUED NE AFCP2001 AFCP2002 ONLI CAFC Main Supervisor Program It directs main sub system requests to the appropriate sub system supervisor ONL NE AFCP2004 AFCP2007 AFCP2008 AFCP2009 AFCP2010 AFCP2011 ONLI NE CAFC Edit and Browse Supervisor Program This program directs browse and edit requests to the appropriate edit and browse programs CAFC Application DDname List Table APPLDDN Edit Program ONLI NE CAFC Function Display Program This program displays the CAFC Function Menu and the CAFC Selection List and from the request s entered builds Function Request Parmlist s and then links AFCP2008 to perform the function ONLI NE CAFC Function Program Based upon CAFC request type this program builds EXEC CICS Open Close list s and issues the commands to enables disables transactions ONLI
99. INPUT gt SCROLL gt PAGE REQUEST DATE 04 02 95 UPDATE DATE 04 06 95 CREATION DATE 03 27 95 REQUEST TIME 21 58 UPDATE TIME 20 56 CREATED BY MASTER REQUESTED BY CICSUSER UPDATED BY MASTER UPDATE COUNT 005 LAST REQUEST RPL STATUS MESSAGE NO ERRORS DESCRIPTION gt CAFC SECURITY gt 0 0 3 ITEM COUNT gt 8 ITEM ERRORS gt DDNAME DATASET NAME DISP a SRPLOO24 CICS330 SDFHLOAD SHR _ SRPLOO25 NTEC CICSQ TABLELIB SHR _ SRPLO026 SYS3 OCRV550 TGTII LOADLIB SHR SRPLOO027 NTEC CAFC4200 LOADLIB SHR SRPLO028 NTEC CDDF5000 LOADLIB DIST SHR _ SRPLOOO06 NTEC COQCF40QA LOADLIB DIST SHR _ RPLGOOD1 NTEC MISCAPPL LOADLIB SHR a RPLTEST2 NTEC NEWAPPLS LOADLIB SHR I nsert D elet R epeat M ove C opy A fter B efore PF1 HLP PF2 2ND SES PF3 END PF4 RET PF7 BWD PF8 FWD PF9 ALT SES USE OF PF KEYS IN THE RPL EDITOR Much like ISPF forward in the RPL list increment backward in th e RPL list be SAVEd to the CAFC Table File and exit the RPL editor keys are displayed at th COPYING OTHER RPL LISTS The external COPY comman e bottom of the screen d will copy that APPLRPL 1 COPY comman the APPRPL datasets The external place Th in commands ist d entered in the INTO THE RPL EDITOR SESSION when specified with another APPLRPL list name into the APPLRPL list currently being edited COMMAND INPUT PDSs at th Page
100. INTERFACE INSTALLATION SAMPLE 6 The RDO definition for a CONNECTION component and a SESSI the CAFC Batch ONS ENVIRONMENTS CONTINUED Interface LUTYPE6 2 featur component requires For further details see Step 3 of the DETAIL INSTALLAT THE CICS TABLES that there are minor changes in method DEFINE CONNECTION name GROUP groupname NETNAME CICSI621 ACCME TH VTAM PROTOCOL APPC DATASTREAM USER RECORDFORMAT U AUTOCONNECT NO NSERVICE YES SECURITYNAME BINDPASSWORD ATTACHSEC LOCAL if NONE ATTACHSEC IDENTIFY if FMH5 SINGLESESS Y NOTE For more ON STEPS Chapter These components should be defined the parameters based DEFI subchapter UPDATE as follows Note on the sign on NE SESSIONS csdname GROUP groupname CONNECTION name PROTOCOL APPC NEPCLASS 000 MAXIMUM 00001 00000 RECEIVEPFX RECEIVECOUNT NO if FMH5 SENDPFX SENDCOUNT NO SENDSIZE 256 RECEIVESIZE 256 OPERID OPERPRTY OPERRSL OPERSEC 01 USERID TRANSACTION SESSPRIORITY 255 AUTOCONNECT NO NSERVICE always clear this field BUILDCHAIN YES USERAREALEN 0 IOAREALEN 00000 00000 RELREQ NO DISCREQ NO
101. LOSE QAQrnaGHG DATASETS TDQUEUES STOP DBDS LOSE amp ENABLE QUIESCE SET UNAVATLABLE SET DATASETS CLOSE amp QUIESCE DATASETS DATASETS TDQUEUES DATASETS DATASETS DATASETS CLOSE amp LOCK QUIESCED amp UNAVAILABLE CLOSE TDQUEUES CLOSE TDQUEUES STOP DBDS STOP DBDS SET DATASETS CLOSED amp UNAVAILABLE CLOSE TDQUEUES STOP DBDS SET DATASETS CLOSED QUIESCED UNAVAILABLE CLOSE TDQUEUES STOP DBDS CLOSE QUIESCE amp LOCK DATASETS CLOSE TDQUEUES STOP DBDS SET DATASETS CLOSED LOCKED amp UNAVAILABLE CLOSE TDQUEUES STOP DBDS SET DATASETS CLOSD QUIESCED LOCKD UNAVLABLE CLOSE TDQUEUES STOP DBDS DISABLE TXNS CLOSE DATASETS TDQUEUES STOP DBDS Uy DBDS DBDS STOP DBDS FORCE RECALL CLOSE ISABLE TXNS C DISABLE TXNS C DISABLE TXNS C LOSE LOSE amp QU LOSE QUIESCE LOCK amp LOCK DATASETS CLOSE TDQUEUES STOP ITESCE DATASES CLOSE TDQUEUES STOP DATASETS CLOSE TDQUEUES DATASETS DATASETS TDQUEUES DUMP DBDS RECOVER DB SET VSAM SET VSAM PROH DS S DATASETS DBDS DATASETS DBDS BIT UPDATES ON DBDS
102. MODELN DDNN MODELI DDNI MODELR DDNR Create ddn records using the same model for each DCT type Migrate all types of dcts Do not replace existing records MIGRATE_DCT KEY DCTTYPE X N I R MODEL COMMON Create ddn records for the indirect dcts Use the destid prefixed by Sdct for the ddnames Replac ixising records Use a model named DDNI MIGRATE DCT KEY DCTTYPE I PREFIX S DCT MODEL DDNI REPLACE EXTENDED CAFC RECORD MAINTENANCE FACILITY CONTINUED Page 272 MAINTENANCE AND CONVERSION AIDS GENERATING DDNS AND TRANSACTION FROM THE CONTENTS OF THE CICS REGIONS TABLES CONTINUED Re create ddn records for all DCT types except remotes MIGRATE DCT KEY REPLACE DCTTYPE X N I Create ddn records using a model and particular values for security and restart status Do not replace existing records MIGRATE FCT KEY MODEL FCTX CTTSECCD 0 CTTDRSO E Re create ddn records using defaults MIGRATE_FCT KEY REPLACE Create txn records using a model and particular values for security and restart status Do not replace existing records MIGRATE PCT KEY MODEL PCTX CTTSECCD 0 CTTDRSE E Re create txn records using defaults MIGRATE PCT KEY REPLACE EXTENDED CAFC RECORD MAINTENANCE FACILITY CONTINUED Page 273 MAINTENANCE AND CONVERSION AIDS RLS ACCESS UPDATE COMMAND CAFC stores the RLS indica
103. P REQU ROGRAM p OFE ai EN CLOSE ALLOCATE rO NAME PROG E AT COM INVO RAM KE Bi gt gt N PLETION p PROG EXIT DBCTL RAM PROGRAM NAME gt TO BE CALLED BEFORE AND AFTER EVERY OR FREE ANY DDNAME DEFINED TO CAFC Y ALSO INVOKE EXIT AT COMPLETION OF CAFC REQUEST N NO ADDITIONAL INVOCATION TO BE CALLED BEFORE AND AFTER EACH EXIT MAY ALTER DBDNAME EXITS from the Customization Option After entering the item number for Menu the CAFC EXIT OPTI have no need for an ALLOCAT However if your install data sets ONS panel is displayed Most installations will ON FREE OPEN CLOSE USER EX CAFC provides exit poin pre free Review post fr pre op A n post the Chapter entitled CAFC FEATURES AN t open the Section entitled ON LIN By USER EX ES PROGRAM NAME to Globally i e requests At each exit poi exit program can control wh Default value gt Bla INVOKE EXIT AT COMPLETION If a program name is specified in this option at each of the above mentioned exit points for all file T Program ation needs to do some special processing for any ts at pre allocation pre close D CO post allocation
104. SET CAFC WARM START INDICATORS LIKE CICS TABLES SYNCHRONIZE_RLSFLAG SET CDTRLS FIELD TO MATCH CICS FCT ENTRY All the commands can be performed online from the extended maintenance facility screen or from a batch job need to submit the following jcl to execute program AFCP251 ch interface program just like AFCP2016 u must have already perforn steps for either LU62 or EXCI Installation Steps bat yo In terface ned the basic Batch To perform the commands from batch you 6 AFCP2516 is a prior to executing AFCP2516 Interface Installation Refer to the section for Batch To CICSs If you are using EXCI Specific connections So a separate connection and session must be defined for this facility The netname for the Extended Maintenance Facility connection should be AFCP2516 AFCP2516 is no downward compatible It can only run against tablefiles that are at modification level 20041001 or higher All commands require Master authority SR JOB BATCH MAINTENANCE MSGCLASS X CLASS N Tf MSGLEVEL 1 1 REGION 3M STEP1 EXEC PGM AFCP2516 STEPLIB DD DSN Your CAFC4400 loadlib DISP SHR DD DSN CICS SDFHEXCI DISP SHR lt required for EXCI AFCEMSGS DD DISP SHR DSN Your CAFC4400 AFCFMSGS fil lt required CICS99P DD DISP SHR DSN Your CAFC4400 AFCF0001 t
105. The changes have been b xample before it has indicated below The n removed to shorten the J RRR RK KKK KKK KK KK RK KK IO OR RK I IK kkk kkk k Lt ISPF FULL FUNCTION LOGON PROC J RRR RK RK KKK KK KK KR KK I OR I I I ROR KK kkk KK k ISPFPROC EXEC PGM IKJEFT01 REGION 0M DYNAMNBR 175 PARM SISPFCL SYSUADS DD DISP SHR DSN SYS1 UADS SYSLBC DD DISP SHR DSN SYS1 BRODCAST SYSPROC DD DISP SHR DSN SYS1 LOCAL CLIST ah DD DISP SHR DSN ISP SISPCLIB SYSEXEC DD DISP SHR DSN ISP SISPEXEC DD DISP SHR DSN SOMMVS SGOSREXX SYSHELP DD DISP SHR DSN SYS1 HELP DD DISP SHR DSN ISP SISPHELP ISPMLIB DD DISP SHR DSN ISP SISPMENU DD DISP SHR DSN SYS1 DFQOMLIB Page 301 ISP ISPLLIB EXE ISPPLIB ISPSLIB ISPTLIB The following been modified double dots listing DISP S DISP S DISP S DISP S DISP S DISP S DISP S DISP S DISP S DISP S MISCELLANEOUS CAFC UT DSN ISP SISP DSN SYS1 SBPX DSN GDDM SADMMO L ES EX EC EXEC DSN SYS1 LOCAL ISPFPNLS DSN ISP SISPPENU DSN SYS1 DFQPLIB DSN ISP SISPSLIB DSN GIM SGIMSENU DSN ISP SISPTENU DSN SYS1 DGTT LIB is a partial listing of the ISPFPROC from the previous example after it has to includ
106. action is performed the CAFC request is OPEN then the associated CICS table l be enabled if 1 ENABLE W is YJ and A ly Enabled or Disabled The following checks determine in FCT or DCT TH OPEN on CAFC Customization Request Options panel 401 for DCT 1 ENABLE AUTOMAT AUTOMAT If the CAFC request C ENABLE D SABLE on CAFC Edit panel 400 under the section C SERV CES is set to Yes is ALLOCATE then the associated CICS table FCT or will be enabled if WITH ALLOCATE on CAFC Customization Request Options panel 401 is Yt and 2 AUTOMA for AUTOMAT I C ENABLE D SABLE on CAFC Edit panel 400 under the section C SERV CES is set to Yes Page 66 CAFC FEATURES AND CONSIDERATIONS ENHANCED RESOURCE MANAGEMENT CONTINUED will be disabled if If the CAFC request is CLOSE then the associated CICS EXEC CICS SET EF I Options after selecting item 15 from the Cus Menu and DISABLE W TH CLOSE on CAFC Customization Reques 401 is Y and table FCT or DCT E support must be set to Y See Support tomization Options t Options panel AUTOMATIC ENABLE DISABLE on CAFC Edit panel 4 for AUTOMAT C SE RVICES is set to Yes
107. are enforced on each entry Password Maintenance Panel is accessible BASIC CAFC security is the default security type preset on the distribution tape Default SECURITY PRODUCT gt B R RACF SECURITY PRODUCT Access to various CAFC operations will be allowed or denied through the standard RACF Security facilities Terminal sign on will be handled by the standard CICS CESN transaction CAFC resource names described below should be defined to RACF using the standard RACF security administrator s interface S the section on CAFC RACF security for more information A ACF2 SECURITY PRODUCT Access to various CAFC operations will be allowed or denied through the standard ACF2 security facilities Terminal sign on will be accomplished with the standard ACF2 sign on transaction Resource names described below will be defined to ACF2 using standard ACF2 administrator functions and interfaces See the following section on ACF2 security for more information T TOP SECRET SECURITY PRODUCT Access to various CAFC operations will be allowed or denied through the standard RACF Security facilities Terminal sign on will be handled by the standard CICS CESN transaction CAFC resource names described below should be defined to RACF using the standard RACF security administrator s interface S the section on CAFC RACF security for more information X OTHER EXTERNAL SECURITY Th
108. changes tarts for CICS userid security EXCI B I PROGRAM OVERVIEW The CAFC B I EXCI interface higher the CI The mul communication PIPE maps runnin facility active MVS image Altho interface does not XCF access method provided by XCF MRO in Cl communicate across MVS images can communicate to Cl The EXCI The communicat CS region is accomplished through a facil ti region operation IRC onto one MRO session g in a sysplex under MVS ESA 5 1 with the cross system MRO e CICS region must program s use of the external CICS support the cross memory access method CS ESA 4 1 or above to ntercommunication the B I ugh the CAFC B I MRO program and th See the facility of Cl facility supports these P Unless the C interface to CAFC uses C tion of a batch request from the CAFC B I lity called a C CS interregion PE requests and B I CS CS to make CAFC request through the CI CS version 4 1 or PYrOCESSOr ation step BM C CS ESA Starts for user written responses are handled by an extension to the Interface Terminal The Batch CS program to CS PIPE and each CICS programs are XCF MRO be in the same it can use the Guide manual for information about XCF MRO Page 172 BATCH TO CICS INTERFACE BATCH TO CICS INTERFACE CONTI
109. close request AUTOMATIC DISABLE ON FREE Option to Disable file on free request or automatic free request Y Disable file on free request N Do not disable file on free request RLS ACCESS INDICATOR This field indicates whether the dataset for the ddname entry is RLS Y Dataset is RLS file N Dataset is not RLS Page 278 MAINTENANCE AND CONVERSION AIDS CAFC TABLE ENTRY MAINTENANCE FACILITY AFC5 CONTINUED CICS TRAN DATA DESTID This field alters the transient data destination ID This change can only be made to a non VSAM DDname entry record TRANSIENT DATA TYPE This field defines the DCT Transient Data Type ndirect N Intrapartition R Remote X Extrapartition PDS MEMBER PDS member name for retrieving a member from a PDS file This change can only be made to a DI MODEL NAME An existing tablefile entry to be used to base the creation of a new entry from If model is no defaults or DO table type record t used all fields not provided will be set to Page 279 MA INTENANCE AN D CONVERS ON DS LINKING TO THE TABLE FILE MAINTENANCE FACILITY Certain e AFC5 th th fu 3 Th e n2 D AFCI ions are 02 or 4 1 transac parmlist and linking to program DSECT nce noe tion or by buil D2040 available as for the ma
110. components AFCP2SOX also handles security for RACF ACF2 and Top Secret batch request sign ons for the CAFC LU6 2 B I Page 34 CAFC FEATURES AND CONSIDERATIONS ON LINE SECURITY SUMMARY CONTINUED After these exit programs allow the batch request to be passed to the target CICS region the request can be further controlled by standard CICS Sign on processing This is accomplished by passing Sign On information to the CICS region within the Function Management Header FMH5 attached to the CAFC requests USING THE B I FOR CAFC REQUESTS AND CICS TRANIDS The CAFC Batch Interface B I program allows users to issue CAFC and CICS commands to a CICS region to a DBCTL region and to a VSAM control region from a batch job stream The B I program communicates to CICS through 1 a CAFC provided ACF VTAM LU6 2 connection or 2 a native CICS connection usin tabl requ g the External CICS Interface EXCI or a direct update to the CAFC file Review and install the Batch Interface to support resource ests and confirmations for your on line and batch operations This facility s major benefits are Reduced reliance on manual procedures on CICS operators and on MVS console operators Improved batch throughput because files are made available on demand More timely information for on line applications because file
111. have questions r site unique superzaps lease 4 5 systems no longer support the sactions DCIN and DCTF The AFCD AFCW functions performed by the above are now handled by Customization Options followed by an operand support option the Utility Services Menu or by the AFCT transaction If you will be using CAFC to allocate FCT ddnames that are defined you must activate CAFC s INIT AL OPEN under the CUSTOM ZAT ON OPTI the STEPLIB PDS The new versions of AFCPSIP in this manual If you plan to use CAFC s Early Allocation Facilities AFCPSIP remove AFCPSIPI1 These programs will be loaded out the AFCPSIP2 and AFCPSIP3 from DFHRPL into your authorized STEPLIB PDS Refer Facility All table maintenanc AFCPS PX and AFCPSIPY should be copied Any Application programs that are used to link to AFCP2040 should AFCP2040 is no longer available to the section for CAFC Extended Tablefile Maintenance requests require Master authority to execut ADD authority for Delete Purge ither from batch or online Copy commands will these requests to be successful Page 23 Batch jobs performing CHG be required to have Master CAFC RELEASE MAINTENANCE UPGRADES MIGRATION CHECK LIST The following is a summary of the most common er
112. in the EXCI cal Lys SURROGCHK YES The CAFC B I DPL ue program without any security active calls for another user the de DFHXCOPT the B I reguest call to a profile named If you wish to disab SURROGCHK NO in the SURROGCHK YES userid is the same as the Cl If you spe program s use s This LUE enaable surrogate processing userid obtained from the CAFC master file or the AFCCSSN ddname will not require password authorization or checking the authority to submit CAFC request security is bypassed fault cify SURROGCHK YES rid as means the B I serid DFHEXCI W In this case recommended becaus thenticated userid d the CICS region u au an en call cannot acquire more au eck e link security check ch th th for EE ced With link It can acguir the USERI serid are different security e only the same or CS ESA C CS RAC F Security Guide Page 100 or allow it a surrogate of the userid program s userid m When surrogat a non authenticated thority than al the user checking if options table to default specified on all ust have READ access in the SURROGAT general resource class User security is performed in addition to any in addition to any authorizations you must also authorize the userid you tch region s that is is DPL
113. logger files by the batch interface jobs will be ignored Authorization is not required for CICS programs to access the system logger files This field will only display if Audit Log Destination is L Audit Log Destination is used to specify whether the audit log is to be written to a transient data queue a non cics sysout dataset referenced by a ddname or the a MVS System logger dataset N No Audit logging D Log directly to the ddname T Log to transient data destid L Log to MVS system logger Audit Option Information is specified by the Audit Flag and an associated Audit Transient Data Destid Ddname or MVS Logger dataset name The Audit Flag can have one of three values BLANK No audit trail logging Y Log this type of request to the Destid or DDname specified for Destid or Ddname or MVS system logger N Do not log this type of request Default Audit Flag gt Y For Completed and Failed Requests Default Audit Flag gt N For Customization Edit and Security requests The Audit Trail data set s must be placed in the CICS start up JCL stream If an Audit Trail data set does not exist in the JCL or is not specified in this Panel all information will be lost The default data set name is CAFCCSMT The default transient data destid is CSMT You must pla
114. may not complete quickly This parameter delays the return of the closed condition code to the invoking program Default value gt O1 FORCE CLOSE OPTION This option is provided to allow the ability to issue a force close request to an active FCT file Default value gt N OPEN OPTIONS These parameters control the way VSAM file OPENs and allocations are handled within CAFC VSAM ALLOCATION OPTION VSAM file allocation can be controlled by the VSAM Allocation Option flag This flag can have one of two values Y CAFC will automatically allocate VSAM files CAFC will deallocate VSAM files dependent upon the setting of the CLOSE FREE flag in the individual CAFC Table File DDname records N CAFC will not automatically allocate or deallocate VSAM files The CLOSE FREE flag in the CAFC Table File DDname records is ignored Default value gt Y Page 123 REQUEST OPTIONS CONTINUED EXTENDED TIOT This option controls where CAFC al the S99ACUCB parameter provided the allocation paramet for CICS TS1 1 and higher option should be set to they perform XTIOT allocations CAFC FEATURES AND CONS yl DERAT ONS Lers relea If this option is set to Llocations will be performed using This ses since N CAFC will only search the standard TIOT to allocated MESSAGE OPTIONS determine if a file
115. not already present in your DFHSIT parameters add it This parameter installs the CICS intercommunication group programs during Cl initialization Page 191 CS BATCH TO CICS INTERFACE BATCH INTERFACE INSTALLATION STEPS CONTINUED Step 4 MRO REQUIREMENTS FOR ACF2 The EXCI connection needs an ACF2 CICS parameter to tell ACF2 to Use the userid of the batch job instead of the region default id Below is an example of the parameter to be added on the ACF2PARM DD sysin MRO SYSID CAFC FORMAT CICS Step 5 CHECK YOUR CAFC LOADLIB FOR REQUIRED EXIT PROGRAMS The following default or user modified Batch Interface exit programs must be in your CICS loadlib AFCP2BCC AFCP2BSX and AFCP2CCX If you plan to use the TRAN request AFCPBTX1 must also be in your CICS loadlib 1 OPTIONAL Modify assemble and linkedit the CAFC B I Security exit program AFCP2BSX for region unique control of individual Batch Interface requests 2 OPTIONAL Modify assemble and link edit the CAFC B I Control Card exit AFCP2BCC for site unique control statement examination and modification requirements The standard exit program is pre assembled and included in the CAFC Loadlib 3 OPTIONAL Modify assemble and link edit the CAFC B I Condition Code exit program AFCP2CCX for site unique control of MVS step retur
116. or disallow any request This exit program is invoked via an OS LINK with Register 1 pointing to a parameter list containing a pointer to the BATCH INTERFACE SECURITY AREA The Installation Tape member AFCDBISA describes the security area contents The major data elements passed to the Batch Interface Security Exit include VTAM APPLID of the target CICS CAFC Request Code CAFC Table Entry Type CAFC Table Entry Name Jobname of the JOB requesting the Batch Interface Function The new DSN associated with a CHG request Return code allow or disallow function The source code for the standard Batch Interface Security Exit program is provided in the INSTLIB member Please review it and tailor it to meet your site s security requirements BATCH INTERFACE CONTROL CARD EXIT The CAFC B I Program AFCP2016 invokes the Control Card exit program AFCP2BCC after a control statement is read but before the statement is edited or processed When the exit is invoked a user written exit program may examine and modify the contents of the B I request statement thus changing the action to be taken by the B I Program The exit program is invoked via an OS LINK with Register 1 pointing to a parameter list containing a fullword pointer to the B I request statement image When the exit receives control t
117. same as the APPLID or ACBNAME In an Interconnected Network a separate APPL entry must be defined on each CPU on which the B I may execute A network unique VTAM APPLID must be defined for each CPU however the ACBNAME parameter is required to be only domain unigque See installation member CAFVT72 Step 2 UPDATE EACH CICS REGION S VTAM APPLID Add the following VTAM parameter to each CICS region s APPLID as maintained in SYS1 VTAMLST SONSCIP YES If you neglect to add this parameter you will experience a series of VTAM warning messages and various types of B I failures To reinstall the APPLID with the SONSCIP parameter you must varying the APPLID INACTIVE then ACTIVE Page 183 BATCH TO C CS NTERFACE B I INSTALLATION STEPS ACF VTAM LU6 2 B I CONTINUED Step 2 UPDATE EACH APPLID WITH SONSCIP YES CONTINUED Below is a commonly seen sequence of error messages VTAM writes these VTAM messages in response to a B I request to the CICS log whenever the SONSCIP YES parameter is omitted from a region s APPL
118. that can be performed are change display create merge change_node rename copy delete purge verify find migrate synchronize_cafc synchronize_headers and synchronize_rlsflag The diagram below shows each type of command and the entry types the command can be performed against For example the change change can be performed against a ddn ddname dbd database txn transaction appl application list group group list and the ctl control record The change_node command can only be performed against an individual ddn ddname record All commands are available via batch and online requests All commands require Master authority to execute RECORD TYPE DDN DBD TXN APPL RPL GRP CTL PCT FCT DCT DLI OTR CHANGE X X X X X X DISPLAY X X X X X X CREATE X X X X X MERGE X X CHANGE_NODE X RECORD TYPE DDN DBD TXN APPL RPL GRP CTL PCT FCT DCT DLI OTR RENAME X X X X X X CORY X X X X X X DELETE X X X X X X PURGE X X X X X X VERIFY X X X X X FIND X X X X X MIGRATE X X X SYNCHRONIZE_CAFC X X X X X SYNCHRONIZE_HEADERS SYNCHRONIZE _RLSFLAG X Page 262 MAINTENANCE AND CONVERSION AIDS EXTENDED CAFC RECORD MAINTENANCE FACILITY CONTINUED Within the extended CAFC maintenance facility there is a help facility that can be called upon
119. the ddname open enable status stored in the CAFC Table File be kept in synch with the status in the FCT Ensure that you have performed the DFHDEB70O installation procedure for APF Authorization as described in Installation STEP 2 INITIAL OPENS FCT EXTENDED SUPPORT This support should be activated if you have FCT entries defined in CICS as OPENTIME STARTUP Without CAFC s Initial Open support activated automatic allocations cannot be performed for the startup opens unless the dsname for the file is physically in the FCT or JCL nor will the ddname open enable status stored in the CAFC Table File be kept in synch with the status in the FCT Ensure that you have performed the DFHDEB70 installation procedure for APF Authorization as described in Installation STEP 2 DBCTL DBCTL EXTENDED SUPPORT This support should be activated if you wish to have CAFC control the access to IMS DBCTL databases RESOURCE LEVEL SHARING RLS EXTENDED SUPPORT This support should be activated if you wish to have CAFC control FCT ntries defined to use Resource Level Sharing Page 134 CAFC FEATURES AND CONS DERAT ONS EXEC CICS INTERFACE SUPPORT CONTINUED EXEC CICS SET TDQUEUE DCT EXTENDED SUPPORT extra partition data set queues whenever CEMT commands or EXEC CI activate If your site wishes
120. the connection type is LU 6 2 and AFCI is used when the connection type is EXCI The link is synchronous that is the AFCB AFCI transaction WILL WAIT until the user program has completed execution before returning The execution of a long duration user program may result in a B I program time out condition Check that your B I time out value is high enough to allow the user program to complete The EXEC request provides an optional 45 character CICS COMMAREA to be passed with the EXEC CICS PROGRAM LINK request The EXEC request also provides the ability to have the AFCB AFCI transaction work area TWA be formatted with user data passed on the request card before EXEC LINK PROGRAM to the user program is issued If the TWA option is utilized the AFCB or AFCI transaction must have a TWA defined in the transaction definition large enough to hold the TWA size specified in the request If it does not the CAFC1117 error message will be issued Place an X in column 72 of the request to continue it to the next card Continuing to place an X in column 72 of each continued request card can also be used to continue the TWA data Do not leave any spaces in the request String all the Commarea TWA size and TWA data together separated by commas The B I input format for the EXEC request is Cie ete lia C EXEC Diced
121. the needed interface for PCT ac the AFCP2I to see that after DFHEL t module AFCP2010 is placed in the PLTPI that it runs during the third stage IM so of CICS init tial ization is built intercept logic DCT support modules DCT53 programs STEP 10B Go to The interfac must be DCT61 AFCP201 into the Extended PCT DCT62 MARKED RES YES O transfers control DCT63 DCT mod the CUSTOM ZAT SUPPORT EXEC C CS TRAN allows CAFC to n ON OPTION MENU Enter a for Extended PCT Support nonitor PCT status change activity and yI to AFCP2I tivi ule DCT65 for ty The DCT which PCT As with Extended These support will load one of the following DCT64 or in the PPT CAFC select the symbol for EXEC C CS SET to update the CAFC Table File TXN record flags for enable disable status NOTE EXEC C CS SET TRAN You may deactivate CAFC sS ex option to an oN P tended PCT support by changing The activation of CAFC s extended removal of Cl with LPA YES DFHEIPxx from the LPALI requires th B to avoid a U601 DCT PCT support CS programs ABEND at Page 13 within a region DFHAIPxx and startup NSTALLATION PROCEDURES DETAILED INSTALLATION
122. to have CAFC automatically allocate and free program calls open and close c monitor the DFHDEB70 instal ICS Versions 3 x and 4 x do If you do not ac insure request must open with EXEC This CLES interface to support should be ac nabl tivate this option DCT resources using CAFC s explicit You must close and CAFC before it will be deallocated from Cl DCT resources NETEC wrote a described DCT CS this option not offer a documented interface to DCT open close activity to provide this interface facility lation procedure proprietary program Insure that you have performed in Installation STEP 2 you can stil allocate and free commands the resource has been allocated before issuing a CEMT ll allocate and free You then explicit CICS SET TRAN PCT EXTENDED SUPPORT tiva and PCT interface installed in the CAFC Table File may differ from the POT will should be CEMT commands performed the DFHDEB70 the true If you always use CAFC requests to change this status maintain the correct enable disable si tatus installed if you routinely use non CAFC facilit to change transaction status Ensure that ly free the resource CS ted if you use CEMT commands or the EXEC disable transactions transaction enable disable status stored Without
123. waits Optionally uring 1 CAFC s manageme on line operation uests require APF authorizat or to issuing RECALLs CAFC s DFHDEB7 the AFAC trans O APF authorization module action Page 38 be readily all when CICS oca is waiti r DFHSM to stage a nt of the CICS tion request ted This ng on an lL only request an allocation when the data set is data set they CAFC offers a RECALL ONLY facility initialization or ion therefore Verify the instal CAFC must be Ensure that you have installed lation with CAFC FEATURES AN DFHRPL LIBRARY MANAGEMENT OVERVIEW CAFC supports dynamic reconcatenation of ty to your operation DFHRPL concatenation For example flexibili static used with care CAFC s own modules should never b CAFC s support for dynamic reconcatenation of Retrieve and save the current or other versions of the CI uent modification for Add or insert a P Remove a PI Rearrange subseg DS library CAFC s dynamic DFHRPL since CICS is designed D CONS DERAT ONS This feat ture adds to operate with a reconcatena the PDSs that contain CICS s DS library removed from the DFHRPL allows a user to DFHRPL into a RPL 1 from a RPL list the order of the PDSs in a RPL ist list tion must be modules and concatena
124. your Table File will be ready to be validated against your existing CAFC environment The conversion process sets defaults for new customization options that may not have existed in the previous maintenance level All other options are left untouched Review any new default options Occasionally the new defaults may conflict with your existing operations 1 Unload the CAFC LOAD and MACRO LIBRARIES from the distribution media to DASD using the JCL stream in the INSTLIB member INSTO45 or INST45C 2 Follow the instructions in STEP 3 of the Installation Guide Update CICS Table Entries Due to NETEC s continuing enhancement program there may be new CICS resources that need to be placed in the proper CICS tables or the CSD 3 Replace your existing AFCFMSGS file with the new one created using INSTO20 or INST20C 4 Use the JCL stream in the INSTLIB member INSTO70 to perform a CAFC Table File conversion You may run the new conversion program more than once without harming your Table Files 5 Update the DFHRPL concatenation with the new CAFC load library 6 Skip this change if you are using the CAFC EXCI B I program If you haven t done so during an earlier installation add the following VTAM parameter to each CICS region s APPLID maintained in SYS1 VTAMLST SONSCIP YES Failure to add this statement
125. 0 DRS OE he 07132005 134429 CICS990 CR CAFCLSEC DT WARMSTRT OA DRS 0E WS 0E 07132005 134429 CICS99Q CR CAFCLERR DT WARMSTRT 20 DRS 0E WS 0E 07132005 134429 CICS990 CR CAFCLEDT DT WARMSTRT DRS OE WSD E 07132005 134429 CICS99Q CR CAFCLCUS DT WARMSTRT 2 DRS 0E WS OE 07132005 134429 CICS990 CR CAFCLCOR DT WARMSTRT DRS 0E WSD E 07132005 134429 CICS99Q CR BASE DO WARMSTRT OBOA DRS OERO WS 0 E RO 07132005 134429 CICS990 CR CAFINTRA DT WARMSTRT 2 DRS FE WSF E 07132005 134429 CICS990 CR CAFCTRAC DO WARMSTRT 0000 DRS A_ WSFA X XX 07132005 134439 CICS99Q CR COUT DT WARMSTRT Aea WS 0 E 07132005 134430 CICS990 CR CEEOUT DT WARMSTRT 2008 D WS 0 E 07132005 134430 CICS990 CR CEEMSG DT WARMSTRT 2000 RSE WS 0 E 08 1 03 15 Kechected to heni 10 1 1 20 ak ik a fe a7 a PF keys are now active so the user can scroll forward PF8 backward PF7 left PF10 and right PF11 in the records that have been selected for display There are several commands that may be issued from the command line at the top of the screen are Filter Find PF5 Rfind PF6 Sort Trace and Reset Page 312 The commands MISCELLANEOUS CAFC UTILIT ES Filter Command The filter command can be used to further restrict the log records to be displayed Filter command is entered as indicated below The algixi CDDFS E CAFC REL 4 4 00 ISPF LOG VIEWER CAFC Log Stream gt LOGGER TEST PROGRAM Command
126. 00 STRING NUMBER gt 05 05 32 STRING NUMBER OVERRIDE FOR THE AFCF4000 ACB MSG 108 RETURN CODE gt N Y N IGNORE MESSAGE 108 ENTRY NOT IN FCT DCT SHUTDOWN DELAY TIME gt 0004 0001 DELAY TIME IN SECONDS TO 1500 DELAY CAFC INTERCEPT SHUTDOWN After entering the item symbol for SPECIAL OPTIONS from the Customization Option Menu the SPECIAL OPT ONS parameters are displayed SECURE CUSTOMIZATION Activation of this option requires user to have master userid to browse customization options AFCF4000 STRING NUMBER This option allows user to increase the number of strings for the CAFC AFCF4000 file to eliminate any string wait problems MSG 108 RETURN CODE This option suppresses CAFC message 108 entry not found in FCT DCT with return code of zero SHUTDOWN DELAY TIME This value is used in conjunction with the automatic shutdown option when it is set to Y and is used to wait for completion of any user PLTSD programs which perform file requests which would involve CAFC Page 138 CAFC FEATURES AN MESSAGE FACILITY OPTIONS Pictured below is the MESSAGE FAC D CONS DERATION S LITY options panel for entering the CAFC Message Facility Customization MESSAGE FACILITY CUSTOMIZATION SELECT OPTION gt TABLE ENTRY gt 1 ACF USER MESSAGE
127. 1 to 5 characters depending upon the function STATUS This is the return code from the function 2 characters DATE This is the current CS date in the form MM DD YY TIME This is the current CS time in the form HH MM Cl Cl ct ct Page 149 CUSTOMIZATION OPTIONS MESSAGE FACILITY OPTIONS CONTINUED ATTRIBUTE This gives the intensity of the message when it is displayed on a CICS terminal Only the first character needs to be entered Its values and abbreviations are shown BR Highlight Bright intensity abbrev B NM Normal Normal intensity abbrev N NOTE See the USER MANUAL for instructions for defining Application Routing Lists These lists define the destination to receive the various messages COMMANDS FOR CUSTOMIZATION PANELS SAVE gt IMMEDIATELY SAVE CONTROL RECORD UPDATES CANCEL gt TERMINATE WITHOUT SAVING UPDATES FIND gt POSITION DISPLAY AT SECTION NAME PF KEYS FOR CUSTOMZATION COMMANDS PFK1 gt EXPLANATION OF ERROR MESSAGE PFK2 gt CREATE SECOND CAFC SESSION PFK3 gt TERMINATE EDIT AND SAVE UPDATES PFK4 gt RETURN TO PREVIOUS MENU PFK7 gt SCROLL UP PFK8 gt
128. 16 BATCH Update table file for 4 2 00 tablefile Called by AFCP2016 AFCP4316 BATCH Update table file for 4 3 00 tablefile Called by AFCP2016 AFCP4317 BATCH Issue DB control commands AFCP4318 BATCH Issue RLS commands quiesce unquiesce AFCP9999 ONLINE CAFC Shutdown program AFCP2BCC BATCH CAFC Batch Interface Control Card Exit AFCP2BS2 BATCH CAFC supplied sample Batch Interface Security Exit Program AFCP2BSX BATCH CAFC supplied default Batch Interface Security Exit Program AFCPBTX1 BATCH Batch Terminal Processor vtam Receive Data Exit sample AFCP2CCX BATCH CAFC Batch Condition Code Exit AFCP2DCT PLTPI CAFC Initialization driver program Determines executing CICS and transfers control to correct startup PLT program DETS 17 DETS2A or DCT33 AFCP2DL PLTP CAFC Initialization driver program Determines executing CICS and transfers control to correct startup PLT program DETS Ly DELIS 27 DLELR3 or DLAT AFCP2FAC ONLINE AFCP2FCS STRTUP AFCP2LU0 BATCH CAFC Batch User Transaction Processor This program establishes an LUO session with the appropriate CICS sends the user transaction across the link receives th completion messages back across the link and displays the messages upon the OS console AFCP2MSG ONLINE AFCP2RLS STRTUP AFCP2SG4 BATCH CICS RACF Auto Sign on Facility driver AFCP2SG5 BATCH CICS RACF Auto Sign on Facility driver for TS3 1 AFCP2SGN BATCH CICS RACF Auto Sign on facility driver AFCP2SOX BATCH CAF
129. 2S0O2 PGM Exit Program alternati AFCP2SOX PGM Source code for on Sign off AFCP2TSS PGM Source for Top Secret users AFCP2UEX PGM Source for AFCTDLI TABLE Release dep AFCT1000 TABLE MRO Applid Table AFCT2016 TABLE Source for Association AFCT2216 TABLE Source for Association Table AFCT2060 ASMPBOPG ASMPBTX1 ASMPDCOL ASMPDCOM ASMPL216 ASMP ZPOO ASMP 2ACF ASMP 2BCC ASMP 2BSX ASMP 2CCX ASMP 2RCF ASMP 2SOX ASMP2TSS ASMP 2UEX ASMTXCLD ASMT2016 the sample CAFC PLT Initialization Program CAFC External Security Program for Interface Sign on Sign off ve the CAFC supplied Batch Interface Sign am CAFC External Security Program for CAFC allocation user exit table CAFC CICS Batch Interface APPLID CAFC CICS Batch Interface APPLID TABLE CEMT return code conversion table JCL Sample Jcl to assemble the AFCPBOPG JCL Sample Jcl to assemble the Batch Receive Data Exit JCL Sample Jcl to assemble the DATACOM DB Exit JCL Sample Jcl to assemble the DATACOM DB Exit JCL Sample Jcl to assemble relink AFCP2016 JCL Sample Jcl to assemble DFSPZPOO JCL Sample JCL to assemble the ACF2 sample External Security Program JCL JCL to assemble CAFC Batch Interface Control Card Exit JCL JCL to assemble CAFC Batch Interface Secu
130. 44 Page 336 DEX AFC4 Transaction facility 344 AFC5 Transaction File maintenance AFC5 Transaction for CAFC Table File Maintenance 299 AFC5 Transaction for limited CAFC Table File Maintenance 320 AFC9 Transaction for automatic services 345 AFCA Transaction Screen 63 AFCB Transaction processing 94 AFCB Transaction priority 344 AFCC Transaction for direct requests 27 266 AFCC Transaction for direct requests 345 AFCCSSN B I sign file 220 AFCD2007 on line API parmlist AFCD2040 Table File Maintenance program Parmlist 303 for message for CAFC Table 303 344 MRO Selection for B I 95 294 required 344 CAFC CAFC D for info FON 278 AFCDBISA B I security area description 249 AFCE Transaction driver for EXEC and XCTL 36 AFCE Transaction for B I XCTL request 345 AFCF4000 enqueue name 194 AFCFMSGS Error Message Help file 5 AFCM Transaction for changing dsnames from the B I 345 AFCP2008 allocation program and on line API 278 AFCP2010 CAFC initialization Program 175 AFCP2021 batch report program for Table Fil ntries 321 AFCP2027 Crash Option reset program 100 103 104 AFCP2045 Table File control record report program 323 AFCP2109 CAFC s automatic service program 345 AFCP2502 Table Fil e maintenance AFCS Transaction 10 AFCT OVER Transact requests 317 3
131. 5 147 359 for DFHRPL management 49 for DFHSM 38 141 verification 345 245 transaction 278 192 ATTACHSEC operand for the B I 8 A A A gt D udit Trail data sets 127 udit Trail options 84 127 udit Trail types of requests logged 127 uto Save activation 139 uto Save activation 138 utomatic Allocation of DCTs 30 67 utomatic Allocation of DLI Databases 68 utomatic Allocation of Non VSAM Files 67 utomatic Allocation of VSAM Files 67 utomatic Disable on CAFC action 69 Automatic Enable on CAFC action 69 automatic frees on CAFC action 69 automatic Message Facility 70 B I ACB Name Association Table 203 B I ACEE from submitter s userid 220 B I API 245 B I CAFC Request format 222 B I CAFC Request Format 213 B I CAFC Table File Maintenance Requests 226 B I CEMT Processing 196 228 239 B I CICS region crash actions 90 97 B I Control Card Exit 249 B I Customization Options 85 90 B I ddname ADD requests 226 B I default VTAM ACB 193 B I Description 190 B I DFHTCT Sample parameters 254 B I Dsname Change Tranid 97 B I EXCI execution JCL 210 B I exit program to change CICS APPLID 251 B I exit programs 246 253 B I exit prog
132. 7 8 nn nn TERMINAL entries for the B I 8 Terminating CICS from the B I Terminating conversational transactions 239 TERMTYPE entries for the B I 8 Timeout due to long duration recall 142 Top Secret Security 33 124 248 Trace activation from B I 214 Trace Activation options 313 Trace Activation parameters 175 314 Trace B I activation parameters 215 Trace during region startup 175 314 Trace Output Data Set 314 Trace Sysout Missing 314 Trace Sysout Missing B I 214 Tracing individual B I requests 215 TRAN B I request 236 TRAN B I Request for full screen applications 239 TRAN B I Request receive data CXLE 2952 TRAN B I Request to start a transaction 37 Transact Transact 239 2 Transac securi tion Extended Support 84 tion PF Key simulation 40 tions to be excluded from ty checking 344 346 348 from t exits Unload maclib and load libraries ape 7 Unload source library from tape 7 Update CICS tables 7 User Exit Activating on line 109 User Exit Allocate Open Close Free User Exit 67 76 Application Completion 76 U U U U U U U U U U U U U
133. 8 Password for the ext Page 2 01 ternal ternal CS environments that require a more than one CICS region in the the sign on name and password he must provide a sign on for each target CI information is CS security manager security manager BATCH TO C CS NTERFACE B I BATCH INTERFACE JCL AND COMMAND LINE FORMATS CONTINUED NOTE D5 SYSIN DD Multiple CAFC Requests can be performed by placing your B I requests ina SYSIN data set The requests are coded in the same manner To tell AFCP2016 to process the request from SYSIN instead of PARM code PARM SYSIN PARM SYSIN is the default NOTE 6 CAFCPARM DD Multiple parameters can be provided through the B I CAFCPARM data set B I WITH CAFC REQUESTS VIA SYSIN stepname STEPLIB SYSUDUMP CAFCTRAC AFCCSSN CAFCPARM SYSIN sek ee Cy isk Function R EXEC D eRe e meme meme D O I D EEE st Gn eques Codes must PGM AFCP2016 PARM SYSIN DSN user batch loadlib SYSOUT SYSOUT DSN cafc tablfile disp shr DSN cafc cssninfo disp shr ISP SHR The region for the CAFC requests The be one of the fol tional tional tional to 8 byte VTAM Applid of the target CI by placing them in the No No No te 1 te 2 te 6 CS 1 5 byte CAFC Function Request Code
134. 9 2 Edit Create or change source data Terminal 3278 3 Utilities Perform utility Functions Screen 4 Foreground Interactive language processing Language ENGLISH 5 Batch Submit job for language processing App ID ISR 6 Command Enter TSO or Workstation commands TSO logon NTECTEST 7 Dialog Test Perform dialog testing TSO prefix UZTEC8 8 SOSF Spool Display and Search Facility System ID NTC1 9 IBM Products IBM program development products MVS acct NONEH 10 SCLM SW Configuration Library Manager Release ISPF 5 5 11 Workplace ISPF Object Action Workplace C CAFC CAFC Log Stream Browser I IMS OPER INMS TSO Operator Interface L Loco Logical Console Operator Interface M More Additional IBM Products Enter X to Terminate using log list defaults ea ol 04 14 Kennected to host 101 420 Modify the IKJTSOxx SYS1 PARMLIB member to add the CAFC ISPF Log Viewer authorized program AFCP2610 AFCP2610 is called through the TSO Service Facility and needs to be added to the AUTHTSF list of programs The following is an example of this addition AUTHTSF NAMES PROGRAMS TO BE AUTHORIZED WHEN CALLED THROUGH THE xf TSO SERVICE FACILITY Rife of AFCP2610 CAFC TSO ISPF Log Viewer Addition CSFDAUTH ICSF a ig IEBCOPY 7s AE ICQASLIO Ref IKJEFF76 2 Determine CAFC log record retention requirements CAFC does not supply utilities to manage CAFC log rec
135. AFC CICS TS2 3 dynamic allocation front end for EXEC CICS processing D CAFC CICS TS3 1 dynamic allocation front end for EXEC CICS processing APF Authorization Facility Component DBCTL request ICS330 DFHDLI frontend program ICS410 DFHDLI control block program CICS410 dynamic allocation front end for FCS CICS TS1 1 dynamic allocation front end for FCS CICS TS1 2 dynamic allocation front end for FCS CICS TS1 3 dynamic allocation front end for FCS CICS TS2 1 dynamic allocation front end for FCS CICS TS2 2 dynamic allocation front end for FCS CICS TS2 3 dynamic allocation front end for FCS CICS TS3 1 dynamic allocation front end for FCS CICS TS1 1 RLS intercept exit CICS TS1 2 RLS intercept exit CICS TS1 3 RLS intercept exit CICS TS2 1 RLS intercept exit CICS TS2 2 RLS intercept exit CICS TS2 3 RLS intercept exit CICS TS3 1 RLS intercept exit CICS 410 emergency backout program for DLI CICS 410 emergency backout program for FCTs trace program Page 332 CAFC MACLIB CAFC NSTALLAT ON CONTENTS perform CAFC functions tallation written dbctl user tion of maps AFCM205 and maps AFCM20F AFCM20G tion of map AFCM203 tion of map AFCM209 tion of map
136. AFCM209 to programs that update tion written program to tenance Facility the CAFC D Association Table Member Mode Description AFCD2001 DSECT Common area passed between all CAFC programs AFCD2004 DSECT All CAFC Table File records AFCD2005 DSECT Subtask Parmlist ECB used by AFCP2009 and AFCP9999 AFCD2007 DSECT Parmlist passed by AFCP2008 to AFCD2008 DSECT Parmlist for External Security Program AFCD2009 DSECT Parmlist passed to an inst exit program AFCD2010 DSECT Redefines DDname list port AFCM20M AFCD2011 DSECT Redefines the TXN list portion of map AFCM206 AFCD2012 DSECT Redefines the APPL list portion of map AFCM207 AFCD2013 DSECT Redefines the list portions of AFCM20H and AFCM20N AFCD2014 DSECT Redefines th ntry list por AFCD2015 DSECT Redefines th ntry list por AFCD2016 DSECT Redefines the message list por AFCD2017 DSECT Parmlist passed to an installation written Alloc Free Open Close User Exit Program AFCD2018 DSECT Parmlist passed from AFCP2016 the table file AFCD2032 DSECT Parmlist passed to an installa call CEMT AFCD2040 DSECT Parmlist for DDname Entry Main AFCP2050 DSECT Parmlist used to call DLI service routines AFCD2072 DSECT Maps AFCT2070 function table AFCD2074 DSECT Defines the messag ntry received by AFCP2078 message send program AFCD2110 DSECT Data block passed between AFCP2015 and AFCP2110 AFCD200E DSECT All CAFC associated error mes
137. AFCT ER TOCE ECUTE TAB TO DE 17 ESTS IN FI CAFC WA E CAFCOVER RM START ROCESS ED TRANSACTION AND PF3 END PF4 RET CAFC OV ERRIDE R EQUEST ENT ER wow S AFCT WARM performs an to initiate a CAFC warm start processing is han The AFCT WARM CICS session CAFC warm start start after CICS is Page up 294 You may wish to use the function Normally CAFC s warm dled by the CAFC initialization program AFCP2010 transaction can only be executed once during the current MISCELLANEOUS CAFC UTILITIES UTILITY SERVICES MENU _ CONTINUED DFHRPL MODULE LOCATE REQUESTS This function runs the SRCH transaction which in turn performs a DFHRPL search for the program provided Upon completion the current DFHRPL concatenation is displayed The display will show the PDS from which the program was loaded MODULE SEARCH CAFC PANE L 226 MAP J SELECT OPTION gt SEARCH THE CICS RPL FOR ALL OCCURENCES OF THE SELECTED LOAD MODULE THE RESULTING DISPLAY PRESENTS A COMPLETE LIST OF THE RPL THE ASSEMBLY TIME STAMP THE CURRE LOAD STATUS AND THE DISK VOLUME SERIAL NUMBER T H ve Z
138. AFXALOIC DS CL4 DYNAMIC ALLOCATION SVC INFO CODE AFXOPNRC DS OCLI OPEN RETURN CODE AFXCLSRC DS CL1 CLOSE RETURN CODE AFXFAILC DS H NUMBER OF DDNS THAT FAILED TO ALLOC FREE FOR A DL 1 DATABASE AFXCMTRC DS H CEMT RETURN CODE DS H AVAILABLE AFXRCDA DS F AFC TABLE FILE RECORD ADDRESS IF AFXTBLET AFXFCT gt CICSDDN IF AFXTBLET AFXDCT gt CICSDDN IF AFXTBLET AFXDLI gt CICSDBD AFXDSUPD DS CL44 DATASET NAME UPDATE FIELD AFXUSRER DS XL2 USER SUPPLIED ERROR CODE AFXUSRMS DS CL24 USER SUPPLIED ERROR MESSAGE REQUEST COMPLETION DATA AFXREQST DS CL8 REQUEST AFXENTYP DS CL2 REQUEST TYPE DD I A AFXREQBY DS CL8 REQUESTED BY REQUEST COMPLETION EXIT DATA AFXGNAME DS CL8 GROUP NAME AFXANAME DS CL8 APPL NAME AFXINAME DS CL8 ITEM NAME AFX DDNS DS H NUMBER OF DDNAMES IN ITEM APPL GROUP AFX ERRS DS H NUMBER OF ERRORS PROCESSING REQUEST AFXALOSM DS CL8 DYNAMIC ALLOCATION SVC SMS REASON CODE Page 77 CAFC FEATURES AN ON LINE USER EXIT POINTS CONTINUED To provide full support for Computer Associate s ICS C exit library AFCPI user file records CAFC supplies the exit program AFCP provided in the member ASMPDCOM in the CAFC installation is DCOM DCOM is driven by CAFC pre OPEN and pre CLOSE reques D CONS DERATIONS Datacom The JCL The exit program determines whether DB running under to as
139. AIN RESOURCES Interconnected Network Cross Domain ON feature is tes the VTAM must be B PDS members DYNAM C DEF N I Refer to the INSTL VTAM definitions D UP processing options Page DATE THE BATCH Review the Customization Options chapter INTERFACE CUSTOM especially panel ZAT TZO ON OPTI which ONS 186 BATCH TO CICS INTERFACE B I INSTALLATION STEPS EXCI Step 1 UPDATE THE TCT OR THE DFHCSD Update each region s TCT or DFH CSD with the parameters for CAFC s EXCI facility A sample connection and session definition is provided in the group CAFCONN1 in the CAFC R4300 CSDLOAD or CSDLOADS dataset EXC GENERIC CONNECTION Step la DEFINING THE Connections between the CAFC EXCI B I program and a CICS region require connection definitions in the CICS region Define thes using the CONNECTION and the SESSIONS resource definition facilities provided by CICS The following parameters should be used to define a generic EXCI connection for use by the CAFC B I program We recommend you use generic sessions CONNECTION PROPERTIES ACcessmethod gt IRc PRotocol gt Exci Conntyp gt
140. ARM D tement CS regio Page 160 is the resulting status from a overridden by CAFCWARM the CAFC and the associate Warm Start t matrices to warm start processing is initiated ls AFCPWARM during PLTPI processing You ZATION OPTIONS D JCL statement These overrid n s startup JCL statements after CAFCPARM parameters also play a role in The format for CAFCPARM Warm Start ICS STARTUP CONS DERATIONS CAFC S WARM START FACILITY CONTINUED where f equals Y where TRACE TRIO and TR traces that provide type files early in the Cl for Yes or N for No xl nsight into probl DBCTL are used to activate various types of ems during on line processing where WARMOTR Y should only be specified for CICS regions with OTHER non FCT ntries that must to be Warm Started allocated CS system initialization process SAMPLE CAFCPARM COMMAND LINES CAFCPARM input for no TRACE no WARMDCT no CAFCPARM WARMDCT N WARMF CT N WARMPCT N TRACE N TRIO N DD CAFCPARM input for full WARMSTART CAFCPARM WARMDCT Y WARMF CT Y WARMPCT Y WARMOTR Y TRACE Y TRIO N DD Page 161 WARMFCT no WARMPCT CICS STARTUP CONSIDERATIONS CAFC S WARM START FACILITY CONTINUED SYNTAX RULES FOR THE CAFCPARM INPUT The paramet
141. ARM for B I Requests 213 CAFCPARM JCL statement 176 CAFCPARM JCL statement 9 CAFCPARM Sample Warm Start values 176 CAFCPARM SYNTAX 177 CAFCPARM Trace activation parameters 314 CAFC s tranid 10 CAFCTRAC B I Trace Output Data Set 214 CAFCTRAC On line Trace Output Data Set 314 CDTDSNF Alternate Dsname flag 62 CEMT commands from the B I 196 CEMT commands serviced by CAFC 67 86 CEMT commands using B I CEMT request 228 CEMT commands using B I STRT request 234 CEMT perform shutdown interception 149 CEMT security violation 95 CEMT Set DLI Commands 68 Changing password 83 CICS abend option 100 103 104 CICS APPLID B I selection program 251 CICS Dump Display Facility 51 CICS region crash B I options 98 CICS Region crash options for B I 100 103 104 CICS Region Crash Options for B I 190 CICS region startup delay 143 ICS shutdown options 149 ICS Startup JCL statements required 9 ICS Startup under DRS 178 ICS Support Options 144 ICS162 Default VTAM ACB lose Delay Options 132 Cold Start under DRS 178 Cold Starting DCTs 30 Command Line CAFC Requests 266 COMMAREA for on line API 278 CONNECTION entries for the B I 8 CONNTYPE parm 219 Conversational Transactions from B I 236 COPY record request from the B I 227
142. ARTUP CONSIDERATIONS CAFCOVER FOR DSNAME STARTUP OVERRIDES CAFCOVER was originally developed for switching dsnames from their Primary entry names to their Secondary entry names CAFC will normally use the dsname either primary or secondary per the flag in the ddname record You may override the dsname to be used once the CICS region becomes active through CAFCOVER requests CAFCOVER override requests are processed by AFCP2010 before warm start processing Make sure a CAFCOVER DD statement is present in the region s startup JCL Code your CAFCOVER dsname switch requests on 80 byte records in the following format FREE ete i 2 n Where ce The 1 5 byte CAFCOVER request It must be one of the following NOA No alternate dsname PRI Set to Primary dsname SEC Set to Secondary dsname EXC Exchange Primary Secondary dsname TE The 2 character CAFC Entry Type code It must be one of the following D Ddname DD FCT Ddname A Application G Group Hests n The 1 to 8 character CAFC Table entry name Group or Application List name upon which you want the CAFC request performed Examples CAFCOVER DD PRI G CUST04 Switch the active dsname to the one stored in the primary dsname field when allocating or opening files belonging to the gro named CUST04 up list SEC DD CUSTMST2 Switch the active dsname to the one stored in the se
143. ATION 2 CAFC I O TRACE INFORMATION 3 CAFC DLI TRACE INFORMATION 4 CAFC INTERNAL TRACE Page 289 ISCELLANEOUS UTILITY SERVICES MENU _ CONTINUED CAFC I O TRACE INFORMATION The CAFC I O Trace Program traces all CAFC tablefile when the trace field is traces are written to the CAFCTRAC dat be turned OFF Allowable trace flags values are CAFC UT ES I O activity performed against the set on When activated these aset These traces should normally T g Activate them only to monitor suspect error situations N Trace OFF Y Trace ON Default value gt N CAFC DLI TRACE INFORMATION The CAFC DLI Trace Program traces all DLI request activity When activated these traces are written to the CAFCTRAC dataset These traces should normally be turned OFF Activate them only to monitor suspect error situations Allowable trace flags values are N Trace OFF Y Trace ON Default value gt N GENERAL DEBUGGING TRACE Every CAFC program is built around a series of trace macros When activated these macros write detailed program flow trace entries to the CAFCTRAC data set This trace will produce a large volume of print lines The trace information is not readily interpreted by the general CAFC user The trace should normally be turned OFF Use the General Debugging Trace only under the guidance of N
144. ATION EXIT AFXPSTAL EQU 2 POST ALLOCATION EXIT AFXPRFRE EQU 3 PRE FREE EXIT AFXPSTFR EQU 4 POST FREE EXIT AFXPROPN EQU 5 PRE OPEN EXIT AFXPSTOP EQU 6 POST OPEN EXIT AFXPRCLS EQU PRE CLOSE EXIT AFXPSTCL EQU 8 POST CLOSE EXIT Page 75 CAFC FEATURES AND CONS DERAT ONS ON LINE USER EXIT POINTS CONTINUED THE CAFC TABLE FILE RECORD IS NOT UPDATABLE FROM THESE EXIT POINTS AFXEXITP DS CLI EXIT POINT TYPE AFXITEM EQU 9 SINGLE ITEM COMPLETION EXIT AFXAPPL EQU 10 SINGLE APPL COMPLETION EXIT AFXAPPL2 EQU 11 APPL IN GROUP COMPLETION EXIT AFXGROUP EQU 12 GROUP COMPLETION EXIT AFXPRAPL EQU 13 PRE APPL CLOSE PROCESSING EXIT OPEN CLOSE ALLOCATE FREE DATA X EXIT RETURN CODE ONE BYTE WITH MULTIPLE NAMES x AFXRC DS OCL1 GENERAL RETURN CODE AFXCANC EQU X 80 DO NOT PERFORM REQUEST AFXBYPSS EQU X 40 BYPASS THIS OPERATION AFXDOIT EQU xX 00 DO PERFORM REQUEST AFXCANAP EQU X 20 DO NOT PERFORM APPL CLOSE REQUEST AFXPRARC DS OC
145. ATION STEPS ALLATION STEPS EXCL B Tis how Gee E E A E a a a E ela Belew S ACB ASSOCIATTON TABIGN sb axe deceisis keare a 6 Gig oar EETA i uh vee tees A AIENT E 1k eve ESUS 6 Ra EXECUTION JCL AND COMMAND LINE FORMATS 2 cece ee eee eee eee eee eee E FACILITES FO R BAT CH JOB COMPONENT Sn Ia a siege oe ese 2G ee alee Breese E E Bee al E Z vs Z Q 2 O R OU WOWHH a HWWH Q SWI FOR MOD MOD MOD OPT G G ELAYING THE STEP S S ELAYING TCHING CAFC TABLE CING DIRECT UPDAT H JEBLES LO ACTIVATE ON TENE TRAC Eira E uN ea E Site Bey See ale GR SE DS CSS eles EASIN TIMEOUT VALUECEOR A CREO UBS SS BD eect sasicnseh E 1 gh Syneeig yb yer driest re Gaye E AEE ey hs EASIN THE ENQ VEURE WALT ENTERVA D 0s ei ie ses oro Beale Beste we Biles weds os eee a a aaar Biss wide CING USE OF THE R AULT CAC Big e AE cide EOE E E Rube bo E Hae WERE E E EIN E dine EES ESSION D TERMINATION FOR LUDA Cie suche a ee eee eof E 2 E oe N E Dee ES LLE DSNAME s aussie oe E E A E E EA EE AE E E Spe E a Ese IFYING THE WAIT E Sr bO ABLE FETGE ache 21808 are inet Pub ty ERNE a is OIEI EI A REANA bee ME EOR A EXEL RECEIVE SESS LON eri aa da ae a G6 e An E EG EA SEE E
146. C supplied default Batch Interface Sign on Sign off Exit Program Page 330 CAFC NSTALLAT CAFC LOADLIB CONTINUED ON CONTENTS DATACOM DB Called by AFCPSI front end for EXEC CI L en PCI TSEN T GT d for EXEC d for EXEC d for EXEC d for EXEC INK transaction CS AFCP2SVC ONLINE AFCP2UEX ONLINE Sample Alloc Free Open Close User Exit AFCPDCOM BATCH Sample user exit program to support AFCPOVER STRTUP AFCPSHUT ONLINE CICS Shutdown Program AFCPSINK PLT optional PLT program for synchronizing FCT status at PLT time Can be executed by issuing SI AFCPSIP STRTUP DFHSIP front end program AFCPSIPX STRTUP DFHSIP front end program AFCPSIPY STRTUP DFHSIP front end program AFCPSIP3 STRTUP nitialization allocation program AFCPSTAT ONLINE AFCPSVCT ONLINE AFCPTRAC ONLINE AFCPWARM STRTUP CAFC PLT Warm Start Program AFCPXRCN STRTUP CAFC Emergency Backout Program AFCT3000 TABLE CAFC Online I O Subsystem program AFCT3041 TABLE CAFC Online I O Subsystem program AFCT3051 TABLE CAFC Online I O Subsystem program AFCT3052 TABLE CAFC Online I O Subsystem program AFCT3053 TABLE CAFC Online I O Subsystem program AFCT3061 TABLE CA
147. CICS Cold Warm or Emergency Your files and transactions and the applications they support will always be ready when CICS comes up Your restarts will be quick reliable and you may be able to eliminate all of your corrective startup procedures Carefully review the Customization Options for CICS Initialization along with the overrides at the individual resource level Review the Chapter entitled CICS STARTUP CONSIDERATIONS Once you have 1 set the region wide customization options and 2 set the individual DDname and transaction warm start overrides you will have a stable trouble free startup environment Page 32 CAFC FEATURES AND CONSIDERATIONS SECURITY WITHIN THE CAFC SYSTEM The CAFC product offers access security for both on line and Batch Interfac requests The level of on line security enforced in CAFC s main transaction AFCS is set by selecting one of four options The options are displayed on the Security Customization Options panel The default on line security value is B or Basic CAFC Security The on lin xit for external security is covered in detail in the CUSTOMIZATION OPTIONS under SECURITY AUDIT AUTHORIZATION OPTION The B I s external security exit programs are covered in the Chapter entitled CAFC VTAM LU6 2 BATCH T
148. CICS If you wish to change nter the new Page 95 CAFC FEATURES AND CONS B I EXCI CUSTOMIZATION OPTIONS CONTINUED Check that your new transaction code has been assembled in the table and is associated with the program gt AFCM Default value Tete in Note BATCH INTERFACE ACTION IF Th AFCP2015 CICS ABENDS DERAT ONS DFHPCT this transaction name is changed the transaction name specified the CICS XLT must also be changed e CICS region UP indicator CTLCUP is set on by CAFC s PLTPI program AFCP2020 The CTLCUP is set off by CAFC s shutdown program AFCP9999 This indicator is referenced each time a B I request accesses the CAFC Table file when the target CICS region is down The B I program AFCP2016 checks the CTLCUP indicator and takes the action you have specified as the Batch Interface Customization Option There are thr options C Continue Batch Interface processing without consideration of the crash indicator This is the default value W Inform the MVS console operator if CICS has crashed and issue a WIOR for GO or Cancel If GO is replied the Table File will be updated If Cancel is replied the batch job will terminate IT Terminate the Batch Interface Step with the return code specified on the Batch Option Panel The CI
149. CICS SUPPORT PRESS CLEAR KEY TO TERMINATE CAFC PF1 HLP PF2 2ND SES PF3 END PF4 RET PF9 ALT SES OPTIONS UPDATED Page 82 CAFC FEATURES AND CONSIDERATIONS CUSTOMIZATION OPTIONS SUMMARY This section provides a brief description of the type of information controlled by each panel Panel Description 1 FCT WARM START UPDATE FCT PCT WARM START These options control CAFC warm start for FCT CAFC Table Fil ntries 2 DCT WARM START UPDATE DCT WARM START These options control CAFC warm start for DCT and Type 0O Other CAFC Table Fil ntries 3 PCT WARM START UPDATE PCT WARM START These options control CAFC warm start for PCT CAFC Table fil ntries 4 OTR WARM START UPDATE OTR WARM START These options control CAFC warm start for Type 0 CAFC Table fil ntries 6 BATCH INTERFACE UPDATE BATCH INTERFACE OPTIONS These options control selection of the LU6 2 or EXCI mode and the operation of the Batch Interface program facility USER EXITS UPDATE USER EXIT OPTIONS These options control the user exit program name for the Allocation Free Open Close global user exit 8 SECURITY UPDATE SECURITY AUDIT OPTIONS These options control the level and type of on line security checking within CAFC transactions 9 AUDIT UPDATE AUDIT T
150. CS Region UP indicator can be reset to OFF by a batch program AFCP2027 Run this program with the JCL member CTLCUP in your CAFC Installation Library if 1 you have set the CICS Abend option to something other than C and 2 you want subsequent Batch Interface Requests to ignore the crash condition Remember that an IPL will set the CICS UP indicator to a crash condition in all of your previously active CICS regions If you experience an IPL you must run the CTLCUP jobstream against all of the regions you wish to reset RETURN CODE Re Op tion XPGM REQUEST TRANSACTION The B I uses a default CI this B I transaction turn code for batch job step if terminate is selected for the CICS ABEND The default return code is 176 is scheduled If you w the B I XPGM REQUEST Tr option on this panel assembled in the Ensure that DFHPCT table with the desired transaction a program of AFCP2110 Page 96 transaction code of AFCX to communicate with its ICS components when an XPGM request simply change ish to change ansaction Code code has been CAFC FEATURES AND CONSIDERATIONS B I EXCI CUSTOMIZATION OPTIONS CONTINUED L ID FOR XPGM REQUESTS SEQUENTIAL TERMINA When a XPGM reques program AFCP2110 t of SEQX for this p o run on urpose simply change th t is scheduled a sequential terminal is needed for The B I uses a default s
151. CT entry after close request CAFC Multiple Regions Operations Interface Program Completes RPL commands Completes RPL commands AFCP2016 BATCH AFCP2017 ONLINE AFCP2018 ONLINE device AFCP2019 BATCH AFCP2020 BATCH AFCP2021 BATCH AFCP2022 ONLINE AFCP2023 BATCH AFCP2032 ONLINE AFCP2035 ONLINE AFCP2038 ONLINE AFCP2503 ONLINE AFCP2043 ONLINE AFCP2045 BATCH AFCP2049 ONLINE AFCP2050 ONLINE AFCP2054 ONLINE AFCP2055 ONLINE AFCP2057 ONLINE Edit APPLRPL records Page 328 CAFC NSTALLATION CONTENTS CAFC LOADLIB CONTINUED AFCP2060 AFCP2065 AFCP2 AFCP2 AFCP2 AFCP2 AFCP2 AFCP2 AFCP2 AFCP2 AFCP2 AFCP2 AFCP2 O z S 2 fi Z Z iS Z B Z Z Z Z Zz Z CARGAR Eee ei 2 yaa CAFC Batch In Processor communication terface For CEMT requests s area Transaction program command upon containing th CAFC Online Batch In return CEMT and Transaction Interface this program builds a CEMT links to the CAFC Online CEMT AFCP2032 to execute the CEMT from AFCP2032 builds a message table returned messages and then returns to the terface program AFCP2015 For requests to s a transaction tart a transaction this program checks for identification and terminal combination If both exist the transaction is scheduled on th
152. CTS If you experience a complete failure message when using a RPL command the problem may be your CICS dump product Hit the PF 12 key to retrieve any error messages If you see a WRPLERR 0420 another CICS program has opened the RPL and left it opened CAFC cannot close the DFHRPL to begin the recontatenation process Tf you want to use CAFC s DFHRPL management you must determine which product is holding the dcb for DFHRPL and release the hold Then try the RPL request again You can use the CAFC transaction AFXX to aid in determining who is holding the DCB for DFHRPL if this OCCUrS Page 49 CAFC FEATURES AND CONSIDERATIONS FILE LOCKING PROTECTION Many batch update procedures use multiple job streams If a CICS user or operator were to enable a file belonging to a batch update procedure between job streams the file could be automatically opened allocated and prematurely taken away from batch This could happen if a user entered a CICS transaction with programs that referenced the files CAFC s File Locking option places a second level of isolation between the CICS operator and files belonging to batch If a file is locked no one can change the status of the file without first issueing an unlock request Lock status is honored across cold warm and emergency region restarts The requests that support
153. DB Group CAFCGRP DEscription TRANSACTION TO START THE BRIDGE EXIT FOR CDBC PROGram AFCPCDBC TWasize 00000 0 32767 PROFile DFHCICST PArtitionset STAtus Enabled Enabled Disabled PRIMedsize 00000 0 65520 TASKDATALoc Below Below Any TASKDATAKey Cics User Cics STOrageclear No No Yes RUnaway System System 0 500 2700000 SHutdown Disabled Disabled Enabled ISolate No Yes No Brexit REMOTE ATTRIBUTES DYnamic No No Yes ROutable No No Yes REMOTESystem REMOTEName TRProf Localq No Yes SCHEDULING PRIOrity 255 0 255 TClass No No 1 10 TRANClass DFHTCLOO ALIASES ALias TASKReq XTRanid TPName XTPname RECOVERY DTimout No No 1 6800 RESTart No No Yes SPurge Yes No Yes TPUrge Yes No Yes DUmp Yes Yes No TRACe Yes Yes No COnfdata No No Yes INDOUBT ATTRIBUTES ACtion Backout Backout Commit WAIT Yes Yes No WAITTime s 00 00 00 0 99 Days Hours Mins INdoubt Backout Backout Commit Wait SECURITY RESSec No No Yes CMdsec No No Yes Extsec No No Yes TRANSec ae 1 64 RSL 00 0 24 Public Page 71 CAFC FEATURES AND CONSIDERATIONS AFDB_TRANSACTION CONTINUED AFCPCDBC Program Definition OBJECT CHARACTERISTICS CICS RELEASE 0530 CEDA View PROGram AFCPCDBC PROGram AFCPCDBC Group CAFCGRP DEscription START TRANSACTION TO ISSUE START BRIDGE FRO CDBC Language Assembler CObol Assembler Le370 C Pli RELo
154. DBCTL_ OPTIONS SUPPORT The parame Menu DFSPZP the DBC SUFFIX 1 NAME ters pictured below options will only be displayed if the After entering the item symbol for DBCTL OPTI DBCT L BATCH TIME INCLUDE NOE EOV OPE ON DBD R ON DBR R DFSPZP The suffix of the DFSPZP DBCTL table within CI EQUEST EQUEST SUFFIX DBCTL NAME The DBCTL name specified in the DBCTL BATCH TIME OUT Default is 00 INCLUDE NOFEOV If If this option INCLUDE NOFEOV this option No wait OPERAND Is Pye OPERAND Se YS the NOFEOV operand will the NOFEOV operand will CUSTOM ZAT ON OPTI ONS activate CAFC s DBCTL 00 IVP3 DB CONTROL NAME 00 00 10 MINUTES CONFIRM REQUEST COMPLETE 00 INDICATES DO NOT WAIT FOR CONFIRMATION DFSPZP table ON DBD REQUEST ON DBR REQUEST Page 154 Cs be added be added DBCTL options DBCTL support option is activated from the Customization Option ONS parameters are displayed SUFFIX FOR DB CONTROL MODULE IN CICS TO WAIT FOR DBCTL TO to the to the These DBD request DBR request CUSTOMIZATION OPTIONS VSAM RLS SUPPORT The parameters pictured below activate various CAFC RLS control features These
155. DTAA Y CDTFREEF Y CDTDISP S CDTDSN NEW DSNAME Below are some examples of how to create transaction entries using the create_txn command Create a txn record using a model CREATE TXN KEY PCT1 MODEL PCTX CTTSECCD 1 CTTDRSE E Create a txn record altering defaults CREATE TXN KEY PCT1 CTTSECCD 1 CTTDRSO O EXTENDED CAFC RECORD MAINTENANCE FACILITY CONTINUED Create a txn record using defaults Page 267 MAINTENANCE AND CONVERSION AIDS CREATE_TXN KEY PCT1 Below are some examples of how ddnames can be created and then an application list created to contain the ddnames CREATE DDN KEY FCT02 CDTDSN VSAM FCTO02 CDTDISP S CDTTYPE D CREATE DDN KEY FCT03 CDTDSN VSAM FCT03 CDTDISP S CDTTYPE D CREATE DDN KEY FCT05 CDTDSN VSAM FCT05 CDTDISP S CDTTYPE D CREATE_APPL KEY FCTAPPL DDNLIST FCTO1 FCT02 FCT05 Below are some examples on creating groups using the create_group command Create a grp record using a model CREATE GROUP KEY NEWGRP1 MODEL OLDGROUP AGTSECCD 1 APLLIST APPL1 APPL2 APPL3 Create a grp record using defaults CREATE GROUP KEY NEWGRP1 APLLIST APPL1 APPL2 APPL3 Below are some examples on changing records using the change_ddn command Change two fields in a single ddn record CHANGE DDN KEY MYFCT1 CDTAA Y CDTFREEF Y EXTENDED CAFC RECORD MAINTENANCE FACILITY CONTINUED Change two fields in two ddn records Pa
156. E PRODUCT ON REG PAYROLL PRO SITETAX DUCTI ONS D PAYMASTR PAYROLL PROD S ON ON ITETAX PAYROLL PROD The RDO groups WO DE uld be DUCTI O TEST N PAYPROD DO group con TEST CICS region will have a separate R thr QA PROD PAYQA and PAYTEST QA PROD CAFC s taining FCTs etc Dsname In this CI CS The naming convention for the Variables provide the cabability to code the following in a CAFC ddname definition PAYROLL amp V PAYROLL amp V PAYROLL amp V DE and in the control amp V1 QA PAYMASTR SITETAX DUCTI ON Page 152 L options for dsname variables specify amp V1 TEST or amp V1 PROD or CUSTOMIZATION OPTIONS DSNAME _VARIABLES CONTINUED The CAFC ddname definition would be defined only once per environment and propagated to all other regions AFCF4000 tablefile The customization option for each region would show the appropriate value for that regions amp V1 I E amp V1 PROD for the production region and changed to say amp V1 QA for the QA regions and changed in the test regions to read amp V1 TEST When the file is open in the production region it would open with PAYROLL PROD PAYMASTR And the QA would get PAYROLL OQA PAYMASTR Page 153
157. E amp OPEN VNO SET DATASETS AVAILABLE UNQUIESCED amp OPEN UO UNLOCK amp OPEN DATASET OPEN TDQUEUES UNO UNLOCK UNQUIESCE amp OPEN DATASETS VUO SET DATASETS AVAILABLE UNLOCKED amp OPEN VUNO SET DATASETS AVAILABLE UNLOCKE Q QUIESCE DATASETS X SET DATASETS UNAVAILABLE QX SET DATASETS QUIESCED amp UNAVAILABLE CL CLOSE amp LOCK DATASET CLOSE TDQUEUE CQ CLOSE amp QUIESCE DATASETS CX SET DATASETS CLOSED amp UNAVAILABLE CQX SET DATASETS CLOSED QUIESCED amp UNAVAILABLE CQL CLOSE QUIESCE amp LOCK DATASETS CLX SET DATASETS CLOSED LOCKED amp UNAVAILABLE CQLX SET DATASETS CLOSED QUIESCED LOCKED amp UNAVAILABLE Page 58 CAFC FEATURES AND CONSIDERATIONS ALTERNATE DSNAME FACILITY Allocation requests may apply to one of two dsnames either the Primary or Secondary dsname This optional facility is active only if the Alternat Dsname Facility is activated through the CUSTOMIZATION OPTIONS for EDIT REQUESTS Alternate Dsname requests may target a Group name an Application name or an individual ddname The requests on line and B I include set primary set secondary exchange inquire and the combination of close free exchange reopen The pri sec settings can be overridden through parameters in the CAFCOVER input parm list that is processed by CAFC during region initialization Maintenance to the dsname fields setti
158. E bie 273 SYNCHRONIZE CAFC TABLE FILE WITH CICS TABLE STATUS ma gosaria o a a a E ccc wee ec E ES 274 LINKING TO THE TABLE FILE MAINTENANCE PAGILELEY GGA Peni a 2 2 2 2 2c eee eee eee 280 TRANSFER CAFC TABLE ENTRIES BETWEEN TABLE FILES eee eee ee ee ee ees 284 GENERATE DDNAME RECORDS FROM JCL DD STATEMENTS 2 2 ccc eee eee ee ee eee 286 MESCERTANBOUS CAEC SUT LT Tiley SS E E e ei ae e ate aha aaa Se pa ele ia ap a E E E 1b ler ate We ldo te doe 8 ete de we 288 ULLLL TY SERVICES MENU perie ten scene i gE I Hee dice E BIERE Seabee Beate died Bho cee dee dae td Rae due ares 288 ACTIVATE DEACTIVATE TRACE PUNCT ION Sys soiire ducted o Be E S ee RE OE oust 289 CAEG STARTUP AND RELATED FUNC ELDON S aeee te engi wine s lelse E ough eel Se E eng eine Sais SS wash oe BUSS wae 292 CAEC SHUTDOWN AND RELATED FUNC LIONS oree a A ateena g 8 a anea 68 Baay ate ana Ta 68 aa ees le 8 y 293 HEADER RECORD SYNCHRONIZATION PROGRAM odua ba a ecer ec ec ee ee ee eee tee eee ene 294 DEHRPLE MODULE LOCATE REQUESTS o praler Pa E a als vee RE A Se Be Re alee Breese E E n BUSSE lw 295 CAFC TABLE ENTRY MATNTENANCE PACT TE UY aeu sakene 4 aoue 2026 E Se E e E ET E E Ea 296 CAFC TABLE REILE ENTRY BATCH REPORT s e r AE R E E E E E E SEE S 297 CAPE CONUROE RECORD REPORT aa aoe hae E 6 Sed E a EE a RV isd a Reales a E Shae Gide 299 CAFC TSO ISPF LOG VIEWER INSTALLATION AND USER INSERUCTIONS eare ua ea e ei e ue a a e a e ea 300 CARC SU
159. ETEC s Technical Support CAFCTRAC should be 1 defined in the CICS startup JCL stream or 2 defined in the CAFC Table File as CAFCTRAC DD SYSOUT A Allowable trace flags values are N Trace OFF Y Trace ON Page 290 MISCELLANEOUS CAFC UTILITIES UTILITY SERVICES MENU CONTINUED The CAFC Trace facility writes to the sysout data set CAFCTRAC If you have not allocated this data set prior to starting the Trace no output will be generated In addition you will find an IEC1301I message written to the CICS region s JES log TRACE DURING SYSTEM INITIALIZATION To trace CAFC during CICS SIT processing you must allocate the CAFCTRAC sysout data set through the CICS region s startup JCL statements Make sure the trace operand TRACE Y is added to the CAFCPARM sysin input stream Page 291 MISCELLANEOUS CAFC UTILITIES UTILITY SERVICES MENU _ CONTINUED CAFC STARTUP AND RELATED FUNCTIONS Use the enhanced AFCT transaction to modify the status of the active CAFC system The enhanced AFCT transaction with the START operand has totally replaced the AFC1 transaction AFCl1 is no longer distributed The panel below describes the status changes that an AFCT START transaction would have on the active region Alternatively an AFCT START from a cleared screen can be executed to perform the same
160. EXEC command from a secure CICS RACF sign on transaction provides th CS interface with a single command versus the tion in tion CEDB teraction that is necessary with CI ability to start or stop CS supports CAFC requests coming from a sequential tor consoles and other non 3270 device shortcut method of entering CAFC requests ut invoking the menu driven try lowed by the entry name ld return the stat scr The en for AFSQ is een AFCS transid transaction provides a shortcut for displaying the status of any CAFC Table File ent type foll This woul try parameters are an entry example AFST S G PAYROLL tus of the group named PAYROLL This transaction provides diagnostic information regarding RPL concatenation It will attempt to display all facilities that have an the ddname DFHRPL open This transaction will issue a modify command to shut down CICS from the B I For proper execution SHUT requires the console terminal definition CJCL found in CICS group DFHSCNSL Check that this terminal is available to CICS prior to execution of this transaction This transaction runs the SINK transaction which in turn updates the desired restart status fields of CAFC table file records from the current status of corresponding CICS control tables The SINK transactio
161. EXT ALLOCATION INQ NQUIRE ABOUT ALTERNATE DSNAME SETTING PRIMARY OR SECONDARY EXC EXCHANGE DSNAMES SWITCH PRIMARY SECONDARY DSNS FOR NEXT ALLOCATION CXO CLOSE DATASETS EXCHANGE DSNAMES RE OPEN DATASETS ADD ADD DDNAME OR TXN RECORD CHG CHANGE DATASET NAME COPY CREATE DDNAME OR TXN RECORD FROM EXISTING RECORD DEL DELETE AN APPLICATION LIST DBDLIST DDNAME GROUP OR A TXN RECORD PURGE SAME AS DELETE EXCEPT THAT ALL RECORDS CONTAINED IN THE LIST ARE ALSO DELETED EX FOR AN APPLICATION LIST ANY DDNAME S DBD NAMES AND TXN NAMES WOULD ALSO BE DELETED WAIT Wait 2 minutes between requests Wait can also be specified as WAIT hhmmsstt where hhmmsstt is a user defined amount of time e Specify G with request for DLI Global e g CG FOR CLOSE GLOBAL ee The 2 byte CAFC Entry Type code BATCH INTERFACE JCL AND CAFC FUNCTIONS FORMAT CONTINUED The tt Entry Type must be one of the following D Ddname DD FCT Ddname DJ JOURNAL Ddname Page 204 DO DP DR DT DU BATCH TO CICS INTERFACE IGNORE Ddname OTHER Ddname DLI DATABASE Ddname RPL Ddname DCT Ddname USER CONTROLLED Ddname DBD Name Application RPL list Group TXN RDO Single File RSO Single DCT RDO Single Program RSO Single Map FCT Items within a RDO Group DCT Items within a RDO Group PCT Items within a RDO Group PPT Items within a RDO
162. FC Online I O Subsystem program AFCT3062 TABLE CAFC Online I O Subsystem program AFCT3063 TABLE CAFC Online I O Subsystem program AFCT3064 TABLE CAFC Online I O Subsystem program AFCT1000 TABLE AFCT2060 TABLE AFCP2070 TABLE DBC9000 ONLINE DFSAOEDR ONLINE DFSAOENT ONLINE DFSAOEDR ONLINE DCT41 FRNTEND CAFC CICS410 dynamic allocation processing DCT51 FRNTEND CAFC CICS TS1 1 dynamic allocation fron CICS processing DCT52 FRNTEND CAFC CICS TS1 2 dynamic allocation fron CICS processing DETS3 FRNTEND CAFC CICS TS1 3 dynamic allocation fron CICS processing DCT61 FRNTEND CAFC CICS TS2 1 dynamic allocation fron CICS processing Page 331 CAFC LOADLIB CONTINUED DCT62 DCT63 DCT64 DFHDEB70 DLI33 DLI41 FCS41 FCS5S1 FCS52 FCSO3 FCS61 FCS62 FCS63 FCS64 RLS5S1 RLS52 RLS53 RLS 61 RLS 62 RLS 63 RLS 64 XDBO41 XFBO41 NTCTRACE FRNTENI FRNTENI FRNTENI CAFC ONLINE CAFC ONLINE CAFC C ONLINE CAFC C FRNTENI FRNTENI FRNTEN FRNTENI FRNTEN FRNTENI FRNTEN FRNTENI FRNTENI FRNTENI FRNTENI FRNTENI FRNTENI FRNTENI FRNTENI STRTUP STRTUP ONLINE eS MD HE Ss OP DG SD CAFC CAFC CAFC CAFC CAFC CAFC CAFC CAFC CAFC CAFC CAFC CAFC CAFC CAFC CAFC CAFC CAFC NSTALLATION CONTENTS D CAFC CICS TS2 2 dynamic allocation front end for EXEC CICS processing D C
163. FCP2SG2 AFCP2SG3 AFCP2SG4 and AFCP2SG5 Page 225 BATCH TO CICS INTERFACE BATCH INTERFACE API The Batch Interface program AFCP2016 can be linked to from a user written assembly language or COBOL program The address of the parameter list data for a batch request should be passed to AFCP2016 in register 1 The format of the parameter list is identical to standard batch request card input The return code for the request will be returned to the calling program in register 15 CAFC R4400 INSTLIB PDS contains a working sample user program in member AFCPL216 The JCL to assemble AFCPL216 is provided in member ASMPL216 Page 226 BATCH INTERFACE The CAFC Batch It invokes five AFCP2BSX AFCP2BCC AFCP2S0OX AFCP2CCX AFCPBTX1 AFCP2BSX BATCH TO CICS INTERFACE EXIT SUMMARY Interface Program AFCP2016 is an LU6 2 VTAM application user modifiable specialized exit programs Security exit program individual requests Control card syntax modification exit program Region Sign on Sign off control exit program Batch step condition code control exit program Batch Terminal Processor receive data exit program This is an access control exit program that controls whether an individual request to the targeted region should be processed AFCP2BCC This is a control exit that allows the program to change the syntax of the Batch
164. FEATURES AND CONSIDERATIONS WTO OPTIONS Pictured below are the parameters for updating WTO options WTO MESSAGE PREFIX gt CAFC WTO DESTINATION gt C C CONSOLE S SEQUENTIAL FILE ROUTE CODE gt 008 001 128 DDNAME gt FILE TO RECEIVE WTO MESSAGES These options enable the user to direct CAFC normal and trace related WTOs to a particular MVS console via route codes or to a sequential file via a ddname If C for CONSOLE is selected then the ROUTE CODE entry parameter is automatically displayed If S for SEQUENTIAL FILE is selected then the DDNAME entry parameter is displayed instead of ROUTE CODE WTO MESSAGE PREFIX All CAFC message WTOs will be prefixed with the literal specified in this field Trace WTOs are not prefixed by this value Default value for message prefix gt CAFC WTO DESTINATION The destination value specifies where CAFC Message WTOs should be sent If an S for sequential file is specified but no ddname is specified or allocated the WTO messages will be written to the console Default value for destination gt C Default value for ddname gt CAFCWTOS Default value for route code gt 008 The sequential file can be either a sysout or a dataset If you specify a dataset the allocation
165. FOR USE BY CAFC The following steps must be compl 1 through 4 are necessary for all only necessary if th tep 1 tep 2 Step 3 DFSPZP Define PSBGEN Define the foll LANG ASSEMBLER PSBNAME AFCP2009 the foll owing PSB to the Through this interface IMS commands are issued to cause the user s requested interface program communicates with leted to ready installations user requires definite response from PSB s are IMS for use by CAFC Steps Steps 5 through 6 are IMS commands DB control environment OAS owing application to ZE 1000 the DB control environment APPLCTN PSB AFCP2009 PGMTYPE BATCH SCHDTYP PARALLEL Select Option 5 off the Primary Options Menu DBCTL name Save the options or press PF3 Customize CAFC by defining the DFSPZP control environment name suffix timeout value and DBCTL name Options the customization options menu Sel SUPPORT options Set the DBCTL opti support Customize the fields for s screen lines appears as follows DBCTL NAME SUFFI X gt Vv module suffix and the DB This is done by specifying the in the CAFC Customization to go to ect Option 15 for EXEC CICS Y to activate DBCTL timeout value and to save and exit on to WEE Tx The SUFFIX FOR DB CONTROL FOR DBCGL TO C
166. G DB2 TEST AFCMRO YPE ENTRY APPLID xxxxxxH TRANSID xxHS X DESC CICS 2 1 1 SYSTEM H IMS 2 2 When the user selects a CICS region from the selection screen CAFC will start the appropriate remote transaction per the TRANSID in the AFCT1000 table If the user selects the current CICS region ie the TOR itself then CAFC will start the local transaction per the TRANSID in the AFCT1000 table If the selected CICS region has not been defined to AFCT1000 CICS s MRO facility will NOT be able to start either the local or the remote transaction When a user terminates a non MRO CAFC session with a clear key or PF3 key the message AFCS SESSION TERMINATED is displayed In a MRO environment the user will not receive this message because control is first passed to the TOR region That is standard termination returns the user to the Region Selection Screen in the TOR Then when the user terminates the TOR CAFC session the user will receive the message AFCS MRO SESSION TERMINATED If your external security package controls all of the AOR and the DOR regions you should adjust the TCT entries so that CESN CSSN signon will be issued whenever the remote transaction is started CAFC s external security package interface forces the MRO screen to execute an EXEC CICS ASSIGN USERID This provides access to the associated TSO u
167. G THE BATCH issu INTERFACE CONNECTION TYPE This parameter can be used to n Specify L for LU 6 2 or E for EXCI CONNTYPE E for EXCI for LU 6 2 Page 200 a messag nodify the default The default very 3 intervals of ct ct connection type value is CONNTYPE L BATCH TO C CS NTERFACE B I BATCH INTERFACE JCL AND COMMAND LINE FORMATS CONTINUED OPTIONAL JCL STATEMENT NOTES NOTE 1 DD DSN ims reslib D ISP SHR If you will be submit ting requests to start and stop databases registered to DBCTL you must concatenate the dataset name of your IMS RESLIB on the batch STEPLIB dd statement NOTE 2 ye E AE c DD DSN cics exci loadlib DISP SHR If you will be using the EXCI B I you will need to provide the dataset name of the CICS EXCI loadlib to the batch job NOTE 3 Ay Aon eee mare c DD DSN cafc tablfile DISP SHR If 1 the dsname of the target CICS region s CAFC Table File is present in the B I s job step s JCL or 2 the dsname is placed in the AFCT2016 Table then the Customization Option settings for the B I Timeout value and other related region is down an region s CAFC Tabl parameters will be d the AFCP2016 job e File dsname the CAFC Request statu affected Table Fi
168. Group MAP Items within a RDO Group The to 8 character CAFC Table entry name upon which you want the CAFC request performed The 1 to 44 character new data set name Only needed for CHG Requests and only valid for type D entries The one The 1 character Bat tch Request return code alteration flag in column 72 B I Request return code alteration flag must be of the following to Page 20 Ignore return code from CICS set each O and continue with subsequent requests Accumulate return code from CICS and continue with subsequent requests Report highest accumulated return code at end of requests 5 BATCH TO C CS NTERFACE B I BATCH INTERFACE JCL AND COMMAND LINE FORMATS CONTINUED B I WITH CAFC REQUESTS VIA PARM communicated to the Cl The In the following example JSO400 the CAFC request DC is to be CS region identified by the VTAM Applid CICSPROD DC disable close and the subsequent OE open enabl be performed against application STARTUP1 jobname IS0400 STEPLIB SYSUDUMP CAFCTRAC CICSPROD AFCCSSN L3 IS0500 STEPLIB SYSUDUMP 1I JIS0600 STEPLIB SYSUDUMP ie ia 381200 STEPLIB SYSUDUMP CAFCTRAC CICSPROD AFCCSSN req
169. ICSA CDRSC CDRM1 SYS1 VTAMLST CPU1L APPL CICSA CICSA TCT TYPE SYSTEM NETNAME CAFC21 AFCP2015 CICSA CPUL PERFORM AFC REQUEST C D TESTOOO1 AFCP2016 CPU2 RECEIVE RESPONSE FROM AFC REQUEST a a a a a a a a a a a eS ENTRIES FOR AFCP2016 BATCH JOB RUNNING ON CPU1 a a a a a a a a a a a a hh ea he a a a ge S she aad Ss aE et fe gh Sg ae x ENTRIES FOR SYS1 VTAMLST ON CPU1 CDRM1 a ee Ce CT et pee YC P e Cae Ep E Ce C eT e ey C Eee Ce C Eee pe Ene C Ee CAFC1 VBUILD TYPE APPL CAFC11 APPL ACBNAME CAFC1 AUTH ACQ PASS CAFC12 VBUILD TYPESAPPL CAFC12 APPL ACBNAME CAFC2 AUTH ACQ PASS CICSA VBUILD TYPESAPPL CICSA APPL AUTH ACQ PASS CICSB VBUILD TYPE CDRSC CICSB CDRSC CDRM CDRM2 CAFC2 VBUILD TYPE CDRSC CAFC21 CDRSC CDRM CDRM2 CAFC22 VBUILD TYPE CDRSC CAFC22 CDRSC CDRM CDRM2 Page 241 INSTALLATION SAMPLE 5 BATCH TO CICS NTERFACE SAMPLE BATCH INTERFACE ENVIRONMENTS CONTINUED
170. ID definition DFHZC3424 E 10 01 95 11 12 02 JOBNAME TERMID CSNE SESSION FAILURE SESSION TERMINATED IMMEDIATELY 2 MODULE NAME DFHZNSP DFHZC3437 I 10 01 95 11 12 03 JOBNAME TERMID CSNE NODE CICSI621 ACTION TAKEN CLSDST ABTASK ABSEND ABRECV SIMLOGON 1 MODULE NAME DFHZNAC DFHZC3462 I 10 01 95 11 12 03 JOBNAME TERMID CSNE NODE CICSI621 SESSION TERMINATED 2 MODULE NAME DFHZCLS DFHZC2450 E 10 01 95 11 12 03 JOBNAME TERMID CSNE NODE CICSI621 NOT ACTIVATED VTAM RETURN CODE 1000 6 MODULE NAME DFHZSYX DFHZC3437 I 10 01 95 11 12 03 JOBNAME TERMID CSNE NONE CICSI621 ACTION TAKEN NOCREATE CLSDEST ABTASK ABSEND ABRECV 1 MODULE NAME DFHZNAC Step 3 UPDATE THE TCT OR THE DFHCSD Update each region s TCT or DFHCSD with the parameters for CAFC s LUTYPE6 2 entry Member CAFCTCT from the INSTLIB file contains sample entries Batch If a Cl The NETNAME keyword paramet Interface VTAM APPLI D CS region is likely to receive B I then a separate TCT must be specified for each of ter MUST match the ne twork unique columns 1 8 of the APPL statement See Step requests from multiple CPUs t ose CPUs Refer to NSTLIB member CAFCTCT2 for a sample that defines two LUTYPE6 2 TCT entries If a CICS region is likely to receive simultaneously batch requests from multiple batch jobs then the Multiple LU name feature should be cons
171. INTERFACE BATCH INTERFACE CONTINUED SIGN ON PROCESS EXCI CONTINUED BIND TIME AUTHORIZATION Authori FACILITY class profile of the target CICS server region with READ ze the B I program s userid to the DFHAPPL applid RACF authority If you fail to authorize the B I program s userid to the CICS region s DFHAPPL applid profile will cause the Open_Pipe processing to fail with with a RESPONSE SYSTEM_ERROR REASON IRC_CONNECT_FAILURE The sub reason field 1l for a bind time security check failure returns decimal 176 X BO See the CICS ESA CICS RACF Security Guide for information about the MRO logon and bind time security checks and for example definitions of RACF DF HAPPL profiles LINK SECURITY The target CICS region performs link security checking for CAFC requests received from the B I program These security checks cover transact tion attach security when attaching the mirror transaction and resource and command security checking within the CAFC transact tion program AFCP2015 The link userid that CICS uses for these security checks is the B I program s userid For these link security checks to process correctly and not cause security failures you must ensure that the link userid is authorized to the following resource profiles as appropriate See the The profile for the CAFC
172. ISR IMAG FORMAT MIX ON The changes have been indicated below ng lines of i nformation that have been removed to shorten E amp ZIMGNAM amp ZIMGROW amp ZIMGCOL ISR PRIM ENGLISH 5 0 Terminal and user parameters Page 303 Display source data or listings Create or change source data Perform utility functions Interactive language processing Submit job for language processing Enter TSO or Workstation commands Perform dialog testing MISCELLANEOUS CAFC UTIL ES 8 LM Facility Library administrator functions 9 IBM Products IBM program development products 10 SCLM SW Configuration Library Manager 11 Workplace ISPF Object Action Workplace INIT PROC IF amp ZCSTF 1 ATTR GRPBOX1 WIDTH 0O IF CURSOR TMPROWS AND amp ZCMD amp ZSAR TRANS amp ZSCREEN 1 amp ZSAREA1 2 amp ZSAREA2 3 amp ZSAREA3 4 amp ZSAREA4 IF amp ZSAR CAL UPS SES amp ZCMD SP amp ZSEL TRANS TRUNC amp ZCMD 0 PGM ISPISM SCRNAME SETTINGS 1 PGM ISRBRO PARM ISRBROO1 SCRNAME VIEW 2 PGM ISREDIT PARM P ISREDMO1 SCRNAME EDIT 3 PANEL ISRUTIL SCRNAME UTIL 4 PANEL ISRFPA SCRNAME FOREGRND 5 PGM ISRJB1 PARM ISRJPA SCRNAME BATCH NOCHECK 6 PG
173. IST FILES WITH MATCHING DSNAMES A ALLOCATE DATASETS TDQUEUES F FREE DATASETS TDQUEUES EF ENABLE DATASETS TDQUEUES DF DISABLE DATASETS TDQUEUES T LOCK DATASETS TDQUEUES U UNLOCK DATASETS TDQUEUES O OPEN DATASETS TDQUEUES START DBDS N UNQUIESCE DATASETS V SET DATASETS AVAILABLE VN SET DATASETS AVAILABLE amp UNQUIESCED NO UNQUIESCE amp OPEN DATASETS OPEN TDQUEUES START DBDS VO SET DATASETS AVAILABLE amp OPEN OPEN TDQUEUES START DBDS VNO SET DATASETS AVAILABLE UNQUIESCED amp OPEN OPEN TDQUEUES START DBDS UO UNLOCK amp OPEN DATASETS OPEN TDQUEUES START DBDS VUO SET DATASETS AVAILABLE UNLOCKED amp OPEN OPEN TDQUEUES START DBDS VUNO SET DATASETS AVAIL UNLCKD UNQUIESCED amp OPEN OPEN TDQUEUES START DBDS OE OPEN DATASETS TDQUEUES START DBDS ENABLE TXNS UOE UNLOCK amp OPEN DATASETS OPEN TDQUEUES START DBDS ENABLE TXNS NOE UNQUIESCE amp OPEN DATASETS OPEN TDQUEUES START DBDS ENABLE TXNS Page 249 UNOE G CE Q X QX CL CQ CX COX COL CLX CQLX DC DCL DCQ DCOL FC DBD DBR RO UP EX NOA PRI SEC
174. Interface control card images before they are processed AFCP2SOX This is a Sign on Sign off exit program that controls whether or not a Batch Interface job can communicate with a requested CICS region This program interfaces with commercial external security manager systems The program offers workable security checks but the user may easily add additional checks AFCP2CCX This is a control exit that allows program logic to set the batch job step condition code from the target CICS regions AFCPBTX1 The exit has access to all of the confirmations returning This is a control exit that allows program logic to interrogate responses from a TRAN request The user s logic may subsequently set the step return code by invoking AFCP2CCX Page 227 BATCH TO CICS INTERFACE BATCH INTERFACE SIGN ON SIGN OFF EXIT The CAFC Batch Interface Program AFCP2016 invokes the default Sign on Sign off Exit AFCP2SOX This exit program 1 controls all sign on transactions prior to processing the Batch Interface Request and 2 controls all sign off transactions after the Batch Interface request has been processed The exit program is invoked via an OS LINK with Register 1 pointing to a parameter list mapped by Installation Member AFCDSOXP The map includes The pointer to the SIGN ON SIGN OFF E
175. L editor the editor checks to see if this DDNAME has previously been defined to CAFC Table File If 1 the DDNAME is found and ddname entry the editor will deny use of that is found and it is a TYPE R entry and 2 the RPL editor is blank the editor will field of the editor has been supplied by ddname entry will be modified to contain a SAVE command or a PF key 3 is entered RPL EDITOR LINE MODE COMMANDS DDNAME record into the DATASET NAME field the DDNAME is found and it is a TYPE R entry the move the the RPL Editor line mode commands are entered in preceding each ddname of the Editor s RPL lis at the bottom of each editor screen Th placed in front of a ddname entry are R Repeat this RPL ddname entry CAFC Table file and user the DDNAME 2 it is not a TYPE R DDNAME If 1 the DATASET NAME field within the dsname of existing of the RPL EDITOR line If 1 2 the DATASET NAME the existing TYPE R current editor contents when he screen cursor field The valid commands appear lin Cc Copy this RPL ddname entry to position M Move this RPL ddname entry to position Page 43 mod nsert a empty RPL ddname entry after this entry the indicated before or aft the indicated before or aft co
176. LAY FIELD VALUES FROM DDN RECORDS DISPLAY_DBD DISPLAY FIELD VALUES FROM DBD RECORDS DISPLAY_TXN DISPLAY FIELD VALUES FROM TXN RECORDS DISPLAY_APPL DISPLAY FIELD VALUES FROM APPL RECORDS DISPLAY_GROUP DISPLAY FIELD VALUES FROM GROUP RECORDS FIND_DDN DISPLAY DDN RECORD WITH FIELDS SPECIFIED VALUES FIND_DBD DISPLAY DBD RECORD WITH FIELDS SPECIFIED VALUES FIND_TXN DISPLAY TXN RECORD WITH FIELDS SPECIFIED VALUES FIND_APPL DISPLAY APPL RECORD WITH FIELDS SPECIFIED VALUES FIND_GROUP DISPLAY GROUP RECORD WITH FIELDS SPECIFIED VALUES EXTENDED CAFC RECORD MAINTENANCE FACILITY CONTINUED VERIFY_DDN DISPLAY DDN RECORD WITH FIELDS NOT SPECIFIED VALUES VERIFY_DBD DISPLAY DBD RECORD WITH FIELDS NOT SPECIFIED VALUES VERIFY_TXN DISPLAY TXN RECORD WITH FIELDS NOT SPECIFIED VALUES Page 264 MAINTENANCE AND CONVERSION AIDS VERIFY_APPL DISPLAY APPL RECORD WITH FIELDS NOT SPECIFIED VALUES VERIFY_GROUP DISPLAY GROUP RECORD WITH FIELDS NOT SPECIFIED VALUES MIGRATE_FCT CREATE CAFC DDN RECORDS FOR ENTRIES IN DFHFCT MIGRATE_DCT CREATE CAFC DDN RECORDS FOR ENTRIES IN DFHDCT MIGRATE_PCT CREATE CAFC TXN RECORDS FOR ENTRIES IN DFHPCT SYNCHRONIZE_HEADERS CORRECT CAFC TABLE FILE HEADER RECORDS SYNCHRONIZE_CAFC
177. LE Page 238 SAMPLE BATCH INTERFACE ENVIRONMENTS INSTALLATION SAMPLE 5 BATCH TO C CS NTERFACE Consider the following environment a two cpus where CONTINUED b batch interface runs from either cpu c batch interface is to use ACBNAME of CAFC1 to communicate with CICSA on CPU1 and d batch interface is to use ACBNAME of CAFC2 to communicate with CICSB on CPU2 ee ee ee ee eee ee ee ee ee eee eee ee ee ee ee ee A E ee ee ee ee ee ee ee 4 4 LOGIC USED BY AFCP2016 FOR SELECTION OF ACB NAME ee ee ee ee ee ee ee ee ee ee ee ee ee eee ee ee S E ee ee ee ee ee ee 4 4 AFCP2016 REQUEST CICSA C D TESTOOOL MOVE CICSI62 TO VTAM ACB NAME FOR DEFAULT LOAD AFCT2016 ACB CICS NAME TABLE WAS LOAD SUCCESSFUL NO GOTO DEFAULT SEARCH AFCT2016 FOR CICSID CICSA WAS CICSID CICSA FOUND NO GOTO DEFAULT MOVE BATCHID TO VTAM ACB NAME DEFAULT BRANCH LABEL HERE VTAM ESTABLISHES SESSION WITH CICSA ON CPUIL1 AFC COMMAND PASSED TO AFCP2015 FOR EXECUTION Page 239 BATCH TO CICS INTERFACE SAMPLE BATCH INTERFACE ENVIRONMENTS CONTINUED INSTALLATION SAMPLE 5
178. LE TRANSACTIONS SET DDNAMES TO NO ALTERNATE DSNAME AVAILABLE SET DDNAMES TO USE PRIMARY DSNAME FOR NEXT ALLOCATION SET DDNAMES TO USE SECONDARY DSNAME FOR NEXT ALLOCATION OPERAT ONAL CONS SUPPORT FOR NON 3270 DEVICES CONTINUED DERAT ONS INQ NQUIRE ABOUT ALTERNATE DSNAME SETTING PRIMARY OR SECONDARY EXC EXCHANGE DSNAMES SWITCH PRIMARY SECONDARY DSNS FOR NEXT ALLOCATION CXO CLOSE DATASETS EXCHANGE DSNAMES RE OPEN DATASETS Specify G with request for DLI Global e g CG for Close Global et The 2 charac The type must required for the SYNCH request D DDname DD FCT DDNAMES DI IGNORE DDNAMES DJ JCT DDNAMES DO NON CICS DDNAMES DP PHYSICAL DLI DDNAMES DR RPL DDNAMES DT DCT DDNAMES DU USER EXIT DDNAMES A Application List AR RPL List I DLI DBD List G Group List T Transaction Tris fe enan n The 1 to 8 Character CAFC Table Entry name upon which you want the function performed not required for the SYNCH request NOTES If there are error messages they will be sent by BMS to the console as unformatted text If the requests came from a sequential terminal the errors will be sent to the device defined to receive output The AFSQ user must r nter the transid AFSQ with each CAFC request Page 251
179. LI1 PRE ALLOCATION EXIT RETURN CODE AFXNOALO EQU X 80 DO NOT ALLOCATE DDNAME AFXALLOC EQU X 00 ALLOCATE DDNAME AFXPSARC DS OCLI1 POST ALLOCATION EXIT RETURN CODE AFXNOOPN EQU X 80 DO NOT LET THE DDNAME BE OPENED AFXOPEN EQU X 00 LET THE DDNAME BE OPENED AFXPRFRC DS OCLI1 PRE FREE EXIT RETURN CODE AFXNOFRE EQU X 80 DO NOT FREE THE DDNAME AFXFREE EQU X 00 FREE THE DDNAME AFXPRORC DS OCLI1 PRE OPEN EXIT RETURN CODE EQU X 80 DO NOT OPEN DDNAME EQU X 00 OPEN DDNAME AFXPRCRC DS CL1 PRE CLOSE EXIT RETURN CODE AFXNOCLS EQU X 80 DO NOT CLOSE DDNAME AFXCLOSE EQU X 00 CLOSE DDNAME Page 76 ON LINE USER EXIT POINTS CAFC FEATURES AND CONSIDERATIONS CONTINUED AFXDDNAM DS _CL8 CAFC ITEM NAME DDN OR DDIRSYM AFXTBLET DS CL1 CICS TABLE ENTRY TYPE AFXFCT EQU C D FCT TABLE ENTRY AFXDCT EQU C T DCT TABLE ENTRY AFXDLI EQU C I DDIR TABLE ENTRY AFXALORC DS CL1 DYNAMIC ALLOCATION SVC RETURN CODE AFXALORS DS CL4 DYNAMIC ALLOCATION SVC REASON CODE
180. LL D SABLE gt RD CLOSE UNENABLE gt CU ALLOCATE UNENABLE gt AU FREE UNENABLE gt FU RECALL UN ENABLE gt RU REA UP DONLY DATE gt gt RO UP the Cl The default gt Y D CONS DERAT ONS ters for updating CAFC s FCT Warm Start The FCT Warm Start Option is used to enable or disabl the CAFC program AFCPWARM at PLTPI by including the operand CS startup jcl e the CAFC time WARMFCT x in your Where x is equal to value for a CAFC Warm start is NO Y AUTOMATIC WARM START PLTPI N NO WARM START THEN WARM START ACTION WILL BE BYTE 1 VALUES X NO ACTION OQ OPEN C CLOSE A ALLOCATE F FREE R RECALL X NO ACTION QO OPEN C CLOSE A ALLOCATE F FREE R RECALL X NO ACTION OQ OPEN C CLOSE A ALLOCATE F FREE R RECALL XX NO ACTI RO READONLY UP UPDATE Page 85 ON BYTE 2 VALUES X NO ACTION E ENABLE D DISABLE U UNENABLE X NO ACTION E ENABLE D DISABLE U UNENABLE X NO ACTION E ENABLE D DISABLE U UNENABLE CAFC FEATURES AND CONSIDERATIONS FCT WARM START CUSTOMIZATION OPTIONS CONTINUED The above parameters control the CAFC warm start processing for FCT entries This matrix specifies the mapping fro
181. LOCATE F FREE R RECALL X NO ACTION X NO ACTION O OPEN E ENABLE C CLOSE D DISABLE A ALLOCATE F FREE R RECALL OTR WARM START CUSTOMIZATION OPTIONS Pictured below are the parameters for updating CAFC s OTR Warm Start options The OTR Warm Start Opt can be overridden by including input stream within the C YES or WARM START OTR ENTRI N for NO the opera CS startup jcl Page 87 time nd WARMOTR x Where x is equal tion is used to enable or disable the CAFC OTR warm start processing by program AFCPWARM at PLTPI This option to in your CAFCPARM NYY TOF AUTOMATIC WARM START NO WARM START PLTPI Default Value CAFC FEATURES AND CONSIDERATIONS B I LU6 2 CUSTOMIZATION OPTIONS Pictured below are the parameters for controlling Batch Interface options The parameters presented on this screen vary with CONNECTION TYPE selected This screen displays the parameters associated with a L or an ACF VTAM LU6 2 connection LU6 2 is the default value
182. M ISRPTC SCRNAME CMD 7 PGM ISPYXDR PARM amp ZTAPPLID SCRNAME DTEST NOCHECK 8 PANEL ISRLPRIM SCRNAME LMF 9 PANEL ISRDIIS ADDPOP 10 PGM ISRSCLM SCRNAME SCLM NOCHECK 11 PGM ISRUDA PARM ISRWORK SCRNAME WORK X EXIT SP PGM ISPSAM PARM PNS ep ler amp ZTRAIL TRAIL The following is a partial listing of the modified ISPF primary option been indicated below PNT END S The double dots been removed to shorten the listing The changes have indicate missing lines of information that have 570 47 PANEL KEYLIST ISRSAB ISR IMAGE amp ZIMGNAM amp ZIMGROW amp ZIMGCOL ATTR DEFAULT FORMAT MIX ISR PRIM ENGLISH OB TYPE AB OD TYPE PS 04 TYPE ABSL GE ON AREA SAREA39 0O Settings Terminal and user parameters 1 View Display source data or listings 2 Edit Create or change source data 3 Utilities Perform utility functions 4 Foreground Interactive language processing 5 Batch Submit job for language processing 6 Command Enter TSO or Workstation commands Page 304 MISCELLANEOUS CAFC UTILITIES 7 Dialog Test Perform dialog testing 8 LM Facility Library administrator functions 9 IBM Product
183. ME T LOG TO TRANSIENT DATA DESTID L LOG TO MVS SYSTEM LOGGER DDNAME gt CAFCLERR CUSTOMIZATION OPTIONS gt D N DO NOT LOG REQUESTS D LOG DIRECT TO DDNAME T LOG TO TRANSIENT DATA DESTID L LOG TO MVS SYSTEM LOGGER DDNAME gt CAFCLCUS EDIT CAFC RECORDS gt T N DO NOT LOG REQUESTS D LOG DIRECT TO DDNAME T LOG TO TRANSIENT DATA DESTID L LOG TO MVS SYSTEM LOGGER DESTID gt LEDT SECURITY VIOLATIONS gt T N DO NOT LOG REQUESTS D LOG DIRECT TO DDNAME T LOG TO TRANSIENT DATA DESTID L LOG TO MVS SYSTEM LOGGER DESTID gt LSEC STATUS REQUESTS gt T N DO NOT LOG REQUESTS D LOG DIRECT TO DDNAME T LOG TO TRANSIENT DATA DESTID L LOG TO MVS SYSTEM LOGGER DESTID gt LCOR After entering the item number for AUDIT from the Customization Option Menu the CAFC AUDIT OPTIONS panel is displayed You may use this panel Page 117 CAFC FEATURES AND CONSIDERATIONS to update what CAFC actions are logged and to which CICS Transient Data Queue sysout dataset or MVS system logger the actions are logged Create Audit Logs activates logging If N is selected no audit logging will be performed and none of the other options will display Selecting Y activates audit logging and displays remaining options CAFC Authorization SVC is required for batch programs using the system logger files If this field is left at 000 writes to system
184. MS Version 5 1 PQ16397 UQ19415 For IMS Version 6 1 PQ10615 UQ19419 6 Install the DFSAOE00 IMS Exit and recycle U019416 UQ019420 DBCTL If a an exit If the CAFC DFSAOE00 exit already exists driver so that both CAFC s DFSAOE00 exits can co exist DFSAOE00 you must recycle DFSAOEO0O exit is the only the After instal IMS commands commands PQ21229 DFSAOEOO exit in the th then recycl environment execute the following procedur region jobcard UKED EXEC PGM IEWL Ji PARM XREF LET LIST NCAL SYSPRINT DD SYSOUT SYSLMO DD DISP SHR DSN IMS RESLIB NTCLIB DD DISP SHR DSN cafc loadlib RESLIB DD DISP SHR DSN IMS RESLIB SYSIN DD MODE AMODE 31 RMODE ANY INCLUDE NTCLIB DFSAOENT INCLUDE RESLIB DFSCSI00O ENTRY DFSAOE00 NAME DFSAOE00 R Page 53 DBDUMP a database will only complete it will be necessary to generate DFSAOE00 and the previously used ling or reinstalling DBCTL region to load the new exit DB control DBCTL CAFC FEATURES AND CONSIDERATIONS CAFC INTERFACE TO DBCTL CONTINUED If the CAFC DFSAOEO0O0 exit is not the only DFSAOEOO exit in the DB control environment it is necessary to generate the DFSAOEOO driver This is done by coding and as
185. NCHRONIZE DDN DO RECORDS WITH TIOT STATUS Synchronize warm start for FCT and DCT entries SYNCHRONIZE_CAFC TABLES FCT DCT Synchronize warm start for FCT and PCT entries SYNCHRONIZE_CAFC TABLES FCT PCT Synchronize warm start for ALL entries SYNCHRONIZE_CAFC TABLES ALL CAFC TABLE ENTRY MAINTENANCE FACILITY AFC5 Page 275 facility maintained thro execution from In addition to D Maintenanc the normal maintenance f ugh the AFC5 standalone MA INTENANCE AND CONVERS ON A DS unctions within CAFC s table edit Dname and TXN records and certain fields within them can be limited maintenance on fields in the program AFCP25 scr D 02 the Utili n is displayed below Dname or TXN records and Dname or TXN Table file records ty Services Menu D requests in CAFC Release 4 1 01 or 3 2 02 through the B I 2 The These functions are not available They are in CAFC Release 4 3 and higher transaction or through AFC5 s Transaction AFC5 s Table Entry Use this panel 1 to perform to change many of the AFC5 transaction uses as batch interface only available
186. ND PF4 RET PF7 BWD PF8 FWD PF9 ALT SES The RPL editor can be used to directly create new RPL type DR symbolic ddname entries and to include previously defined DR entries into a new APPLRPL RPL list The editor also allows load libraries included in the current CICS DFHRPL to be added to the RPL list now opened In this case the editor automatically assigns symbolic ddnames to associate each of the current CICS DFHRPL PDS load libraries The automatically generated ddnames are in the form of S RPLnnnn The order in which the symbolic RPL ddnames are listed determines their relative order within the concatenation Entries in a RPL APPLRPL list will never be sorted regardless of the Customization Sort Option setting The PF 3 key must be hit before changes are made or new entries are saved Page 41 CAFC FEATURES AND CONS DFHRPL LIBRARY MANAGEMENT CONTINUED Below is a sample editor screen that would result if you placed a before the APPRPL list named RPLX on the ED DERAT ONS gt IT TABLE of the RPL lists oe eerste tool EDIT TABLE APPLRPL ENTRY RPLX CAFC PANEL 227 COMMAND
187. NUED SELECTING A B I PROGRAM TYPE LU6 2 VERSES EXCI The LU 6 2 connection type should be chosen when e The version of CICS is version 3 3 or older or e The version of CICS is version 4 1 or higher and the B I program will not execute on the same MVS image as the CICS and MRO XCF is not active so that the B I program can connect to the CICS from any MVS image it can execute on or e The B I program will execute on an MVS image that is only accessible to the target CICS via the ACF VTAM network i e via VTAM cross domain The EXCI connection type should be chosen when e The version of CICS is version 4 1 or higher and e The B I program will execute on the same MVS image as the target CICS regions or e MRO XCF is active so that the B I program can connect to the CICS regions from any MVS image it is likely to execute on e You are running a pure TCPIP environment without an ACF VTAM network For information on CICS XCF MRO see the CICS Intercommunication Guide for the release if CICS you are executing The method that the B I will use to connect to CICS is specified via the AFCS transaction From the Primary Options Menu select Option 5 Customization Options From the Customization Option Menu select option 6 Batch Interface This will retrieve the Batch Interface Customization Option Menu To specify the LU6 2 connection for communicati
188. O CICS NTERFACE ON LINE SECURITY SUMMARY NO SECURITY CAFC users are not required to enter a userid and password on the Sign on screen prior to going to the Primary Option Menu Any user can browse edit or use any entry in any CAFC Table File except the Userid Table Access to the Userid Table requires a userid signed on with Master Password authorization BAS IC CAFC SECURITY CAFC users are required to enter userid and password on the sign on screen prior to going to the Primary Option Menu CAFC Security Codes are enforced on each entry The Password Maintenance Panel is accessible The default security value for the base CAFC product is set to BASIC SECURITY active Initially each region s security is controlled the Customization Panel SECURITY AUDIT AUTHORIZATION OPTIONs The default security values are Security Flag value gt B use CAFC s basic internal security Default Program Name gt Blank no external security program The Basic Security option does not expect to find an external security exit program specified RACF ACF2 SECURITY NETEC supplied interface program Access to all of CAFC s operations will be allowed or denied through standard RACF security facilities Terminal sign on will be accomplished with the standard CICS CESN transaction Resource names will be defined to RACF or ACF2 using the
189. O Subsystem Trace ON TRIOF Turn I O Subsystem Trace OFF Page 195 BATCH TO CICS INTERFACE Page 196 BATCH TO C NTERFACE CS B I TRACE FACILITIES TO ACTIVATE ON LINE TRACE CONTINUED The format of the on line trace command follows Target CICS APPLID Below is a sample JCL stream containing B I B I command to act deactivat eg TRACN CICSPRO1 On line Trace g commands to activate the CAFC on line general debugging trace for a single request against CAFC Group List STARTUP2 stepname EXEC STEPLIB DD SYSUDUMP DD The data defined by the following NOT available to on line CAFCTRAC DD PCG ta lad c DD AFCCSSN DD SYSIN DD CICSPRO1 DC G START CICSPRO1 TRACN CICSPRO1 DC G START CICSPRO1 TRACF CICSPRO1 DC A PAY1 CICSPRO2 DC G START PGM AFCP20 SYSOUT DSN user batch loadlib D I 16 PARM SYSIN SP SHR D D is trace facilities SYSOUT DSN cafc tablfile disp shr DSN cafc cssninfo disp shr UP1 lt Command to start on line trace UP2 lt CAFC Request to be traced lt Command to stop on line trace UP1 Page 197 BATCH TO C CS NTERFACE B I EXECUTION JCL AND COMMAND LINE FORMATS CONTINUED INCREASING THE TIMEOUT VALUE PARM FOR A REQUEST SET If you n
190. O THE CAFC TABLE FILE THE AFC5 TRANSACTION SUPPORT THE FOLLOWING REQUESTS AN ADD DDNAME OR CICSTXN RECORDS BM CHANGE DDNAME OR CICTXN ENTRY RECORDS Dp DELETE GROUP APPLICATION DBDLIST DDNAME OR CICS TXN RECORD ve PURGE 1 DELETE GROUP RECORD ALL APPLICATION RECORDS ATTACHED TO THAT GROUP ALL DDNAME AND CICSTXN RECORDS ATTACHED TO THAT APPLICATION RECORD S 2 DELETE APPLICATION RECORD AND ALL DDNAME AND CICSTXN RECORDS ATTACHED TO THE APPLICATION RECORD 3 DELETE DBDLIST RECORD AND ALL DDNAME RECORD S ATTACHED TO THE DBDLIST KY COPY DDNAME OR CICSTXN RECORDS TO CREATE NEW ENTRIES wR RENAME RECORD i LIST VALUES IN FIELDS OF RECORD TO EXECUTE THIS TRANSACTION TAB TO AFC5 AND ENTER S gt _ AFC5 DDNAME ENTRY MAINTENANCE FACILITY PR3 END PF4 RET The AFC5 transaction can be run stand alone Page 296 MISCELLANEOUS CAFC UTILITIES CAFC TABLE FILE ENTRY BATCH REPORT To list CAFC Table Fil ntries use program AFCP2021 with the following JCL Note A sample of this JCL is provided on the installation tape in member CAFCBRPT CAFCBRPT JOB ACCT CAFC CLASS A MSGCLASS A 1 JS010 EXEC PGM AFCP2021 STEPLIB DD DSN cafc loadlib DISP SHR aks INCAFC
191. ON REQUIRED SIGNON NOT REQUIRED SIGNON SCREEN INHIBITED DEFAULT TO MASTER IS BASIC CAFC SECURITY Cc C USER SIGNON gt HZKXH PVZ ll PFKS 1 HLP 2 2ND SES 3 END 4 RET 7 BKWD 8 FWRD 9 ALT SES 10 PRV SEC 11 NXT SEC After entering the item number for SECURITY from the Customization Option Menu the CAFC SECURITY OPTIONS panel is displayed You may use this panel to update the following options 1 SECURITY PRODUCT 2 USER SIGNON The SECURITY PRODUCT may be one of five values N for no security B basic CAFC Security R for external security using IBM s RACF A for for external security using CA s ACF2 T for external security using CA s Top Secret or X for OTHER user specified N NO SECURITY Users are not required to enter userid and password on the sign on screen prior to going to the CAFC Primary Option Menu Any user can browse edit or use any entry in any CAFC Table File except the Userid Table which requires a userid signed on with Master Password authorization Page 103 CAFC FEATURES AND CONSIDERATIONS SECURITY OPTIONS CONTINUED B BASIC CAFC SECURITY Users are required to enter userid and password on the sign on screen prior to going to the CAFC Primary Option Menu CAFC Security Codes
192. ONFIRM REQ DB CONTROL Page 51 UEST COMPLETE NAME CAFC FEATURES AND CONS DERATIONS CAFC INTERFACE TO DBCTL CONTINUED step If the DBCTL BATCH TI ME OUT gt 01 10 MINUTES TO WAIT FOR DBCTL TO CONFIRM REQUEST COMPLETE 00 INDICATES DO NOT WAIT FOR COMPLETION DBCTL BATCH TIME OUT value is set to 00 response will be deactivated 4 Verify IMS security CAFC is subject to standard IMS security CAFC control be allowed to manipulate DB control databases The based on RACF interface discussion interface ability to connect to the through the use of the appl module and the definition of security with the SMU input necessary to define CAFC follows AGN AGPSB AFCP2009 O IMS utilizes SIS IMS command definite issues ICMDs to DB IMS parameter AOIS must not be set to N is CAFC is to This discussion is AOIS R being used to secure the CCTL ther security systems or methods may vary from this two levels of security to protect the use of the CCTL The first level of security is to check the user s CAFCAGN DB control environment This is controlled Lication group name defined in the DFSPZP the SMU An example of In this example an application group name of CAFCAGN has been defined
193. ONTINUED STEP 6 ADD RESOURCES TO THE CAFC TABLE FILE Logon to your CICS region and enter the AFCS Transaction Respond to the request for a USERID and PASSWORD with the default values of MASTER and Page 9 PASSWORD you NSTALLAT The Primary Option Menu wil to the various CAFC facilities the CAFC Table File through the Edit entitled EDIT MAINTENANCE AND CONVERSION A NG CAFC TABLES and to the DS You may begin Refer to the INSTALL GUI ll be displayed ON PROCEDURES USER GUI Before you place your VSAM files under the control of CAFC you are using the DFHFCT TYPE SHRCTL macroinst and characteristics of your VSAM local code BUFFERS the RSCLMT parameter If you fail KEYLEN and STRNO parameters on shared for the LSR pools CICS can easily miscalculat When the LSR pool size is halted pointing When you First CI Second you dramatically reduce Cl processing overhead for FCT entries from CICS properly code the SHRCTL macro CS does not have to calculate pool sizes during CS s and CAFC s Third you move the normal allocation OPEN overhead initialization to transaction exec This is in keeping with CICS TS philosophy you must use the SHRCTL macro operations regions in error CICS region start Subsequent
194. OPEN gt Y Y N ENABLE FCT DCT ON OPEN REQUEST ENABLE ON ALLOCATE gt Y Y N ENABLE FCT DCT ON ALLOCATE REQUEST DISABLE ON CLOSE Y Y N DISABLE FCT DCT ON CLOSE REQUEST DISABLE ON FREE Y Y N DISABLE FCT DCT ON FREE REQUEST ALWAYS ENABLE TRANS gt Y Y N ALWAYS ENABLE TRANS ON OE REQUEST STATUS REQUEST SET RETURN CODE 137 gt Y Y N SET RC 137 IF DSNAME IS ALLOCATED TO ANOTHER TASK CLOSE OPTIONS These parameters control the way delayed CLOSEs are handled within CAFC NUMBER OF FCT SCANS When a CAFC request of DC Disable Close or C Close is issued against any CAFC item containing FCT entries the FCTs are first disabled then closed Page 122 CAFC FEATURES AND CONSIDERATIONS REQUEST OPTIONS CONTINUED Multiple scans of the affected FCTs are performed until all FCTs have completed the close operation This is necessary because concurrent file activity will delay the close The NUMBER OF FCT SCANS can be set to limit this process Default value gt 3 FCT SCAN INTERVAL This option works in conjunction with the Number of FCT Scans option CAFC uses the value specified in the FCT Scan Interval field to determine how many seconds to wait before it performs another scan against the FCTs The default value is 5 seconds Default value gt 000005 CLOSE DELAY TIME and DISABLE CLOSE DELAY Under various CICS workload conditions closes
195. OPTIONS CONTINUED RACF USER PROFILE For USER functions the resource is created by suffixing the USER sequence with the CICS APPLID CAFC resource type and the resource name Generically this would look like USER applid cafctype name USER is the fixed prefix APPLID is replaced by the executing region s CICS VTAM APPLID CAFCTYPE is replaced by one of the values found in the table below NAME is replaced by the CAFC resource name An example of this would be executing in a CICS system whose APPLID is TESTCICS and the resource is a DDNAME called MYFILE would create the a resource of USER TESTCICS DDN MYFILE CAFCtype Description DDN DDNAME records DBD Database Definition records APL Application DDNAME records TXN Application Transaction records GRP Group records MSG Message records TAB RDO records RACF OPER PROFILE OPER profiles are created in the same manner as USER profiles except the fixed prefix is OPER instead of USER The OPER profile allows individuals to be designated as operation personnel These persons issue CAFC requests against or BROWSE CAFC resources that they have been permitted CONTROL authority via the appropriate OPER profile No other CAFC functions are allowed The check for OPER authority is only perform after the check for MASTER authority and USER authority to a resource have fai
196. P2109 This Table Fil normal and 4 procedures are program AFCP2 transaction operand 1 allocates and opens the CAFC e AFCF4000 2 sets startup status condition to 3 activates CAFC s extended CICS support functions activates AFCP2109 CAFC s service program These normally done by CAFC s PLTPI initialization 010 This transaction operand displays the status of various CAFC facilities such as which extended facilities are active This transaction operand causes CAFC to perform a limited CAFC WARM start It can be used in lieu of the program AFCP2010 to initiate a limited CAFC WARM start after CICS is active This transaction should be followed by an AFCT OVER to process any requests residing the CAFCOVER early request queue AFC Allocation Free program This program is posted by AFCPXCS to perform Allocation Free requests Page 321 CAFC SUPPORT CAFC SUPPORT TRANSATIONS CONTINUED AFCX AFSG AFDB AESO AFST AFXX SHUT INK SRCH This AFCP2 This for Th th mu su is e This terminals an alt witho This the Bat ltiple pplied transaction O16 transaction tch Terminal Processor DB Control C transact transact transaction operat ternative is used to is used to TRANSACTI complete initiate user th ONS
197. PL That is AFCPS AFCPSIP3 can In this case the parameters do not refer to a DFHRPL concatenation in PY provides warm start capability optionally set up a specific at CICS Start Up time according to the information last failures at S previously Sel See the CAFC Control File tart up according to the failure options include Abandon Exclude RPLs which fail Abnormally terminate CICS Start Up If you use CAFC s Dynamic the re concatenation activate one of the CAFC s APF au are described in the section entit CUSTOM ZAT NOTE 3 2 02 ON OPTI must r enhanced RPL editing f of the RPL list Previous users of AFCPS the section entit request to allocate led CUSTOM P3 will handle RPL DFHRPL Customization Options you all ocation ZAT DFHRPL Library Management support thorization techniques The tled SECUR ONS chapter nt iG APPLD Page 48 TY OPTI ONS within their RPL lists through the new RPL editor unction required a major change in the key structure DNs are now referred to as APPLRPLs ON OPTIONS The you must techniques the the RPL concatenation function in CAFC Release The CAFC FEATURES AND CONSIDERATIONS DFHRPL LIBRARY MANAGEMENT CONTINUED RPL PROBLEMS CREATED BY OTHER PRODU
198. PPL CAFC21 APPL ACBNAME CAFC1 AUTH ACQ PASS CAFC22 VBUILD TYPE APPL CAFC22 APPL ACBNAME CAFC2 AUTH ACQ PASS CICSA VBUILD TYPE CDRSC CICSA CDRSC CDRM CDRM1 CICSB VBUILD TYPE APPL CICSB APPL AUTH ACQ PASS CAFC11 VBUILD TYPE CDRSC CAFC11 CDRSC CDRM CDRM1 CAFC12 VBUILD TYPE CDRSC CAFC12 CDRSC CDRM CDRM1 5 ENTRIES FOR CICSB TCT ON CPU2 X RMTYPE LUTYPE62 BUFFER 256 RUSIZE 256 RMSTAT TRANSCEIVE DFHTCT YPE SYSTEM ETH VTAM NETNAME CAFC22 FEATURE SINGLE RMTYPE LUTYPE62 BUFFER 256 RUSIZE 256 RMSTAT TRANSCEIVE FEATURE S INGLE Page 243 INSTALLATION D EEF INE INSTALLATION EF INE K K K Kx K K K K MM XM BATCH TO CICS INTERFACE SAMPLE BATCH INTERFACE ENVIRONMENTS CONTINUED INSTALLATION SAMPLE 5 z ENTRIES FOR AFCP2016 ON CPU2 CDRM2 APPLID TABLE AFCP2016 AFCM2016 TYPE INITIAL AFCM2016 CICSID CICSA BATCHID CAFC1 AFCM2016 CICSID CICSB BATCHID CAFC2 AFCM2016 TYPE F INAL END Page 244 BATCH TO C CS NTERFACE SAMPLE BATCH
199. PPORT TRANSACTIONS o eiea k eoria a EUa rE E aha Sse due E E r aE E Ga eE Ei a E 320 CAEC SINS THE BACONTENT O rE sere E E ees EE E E E EE eRe E EE EE E E a E E SE Se Oa LEO SAS 323 CAPE LOADDEB CONTENTS eie a oN E A E SS EEE NG BSR E E E EE EE EAEE E SE WAL See a a 326 TFROUB EE OS HOOT DING YEA E E sects a Sty setae Se S40 AE A kui Seat Sg SEMI E re ho SEs oe B S aie ee ates ats wae odes Shoe 334 SUBJECT INDEX ALPHABETICAL d ieg dean sie pre AE eile sneha eds Sha E a E dna Stereo EE eae 8 ears Ses ues eed d eaa 336 INTRO DUCTION CICS Application File Control facility eliminates 2 sets of the everyday CICS operational problems The first set of problems is the unfriendliness of the built in CICS resource control commands The second set of problems is associated with Cl CS applications coming on line and off line at different times during a single CICS execution especially 24 hour CICS shops Some of these problems are 1 JCL errors caused by data sets being deleted during batch and not being recreated by CICS start up time 2 Renaming CICS data sets while CICS is up 3 Taking an application off line which has many files to close and deallocate and many transactions to disable 4 Scheduling trouble free communicat tions between MVS batch jobs and the various CICS regions that own files in need of batch updates
200. R DSN ISP SISPPENU P SHR DSN SYS1 DFQPLIB L ISPFPNLS SHR DSN ISP SISPSLIB UNIT 3390 VOL SER Z1RES1 SHR DSN GIM SGIMSENU UNIT 3390 VOL SER Z1RES1 ISPTLIB DD DISP SHR DSN you ispf isptlib Addition of ISPTLIB DD DISP SHR DSN ISP SISPTENU UNIT 3390 VOL SER Z1RES1 DD DISP SHR DSN SYS1 DGTTLIB UNIT 3390 VOL SER Z1RES1 Modify your ISPF primary option panel or other appropriate panel to include the CAFC ISPF Log Viewer The fo selected An examp your ispf panel library PRIMOPT To locate your primary option panel default name for first concatenations of libraries for the default ISPF primary option panel The ISR PRIM member llowing panel L definition should be executed as a result of being e modified primary option panel is found in xamine th TSO procedure and find the ISPPLIB DDNAME the primary option member will be found in one of the this DDNAM E The following is a partial listing of furnished my IBM before modification The panel you find may be slightly different that this exampl The double dots the listing PANEL K ATTR DEFAULT OB TYPE AB OD TYPE PS 04 TYPE ABSL E T G F EFA SAREA39 Settings View Edit Utilities Foreground Batch Command Dialog Test D ve WUHNDOBPWNFO indicate missi EYLIST ISRSAB
201. RAIL OPTIONS These options control the audit trail operation 10 WTO UPDATE WTO OPTIONS 11 AFCPSIPY UPDATE AFCPSIPY EARLY ALLOCATION OPTIONS Page 83 CAFC FEATURES AN CUSTOMIZATION OPTIONS SUMMARY CONTINUED Panel 12 REQUEST 13 EDIT 14 HSM 16 RPL 15 SUPPORT EXEC CICS Ty SPEC AL OPT ONS 18 MESSAGE FACIL TY 19 DSNAME VARI 20 21 22 23 COMMANDS PFKS DBCTL TABLES VSAM RLS SUPPORT D CONS DERAT ONS Description UPDATE REQUEST OPTIONS These options control close request retries automatic allocation and the automatic enabling and disabling of ddname entries UPDATE EDIT OPTIONS These options control the automatic sorting for display purposes for the CAFC application and group components and automatic saving on edit panels UPDATE HSM OPTIONS Th al AC Th to native CEMT set commands and calls that affect the tabases and transactions along with controlling tic shutdown support da DB ese options control the interval and iteration gorithm for HSM Recall support TIVATE DCT DLI PCT FCT RLS DBCTL SUPPORT ese options extended CAFC s automatic support CTL UP Th re DATE RPL OPTIONS RLS and automa status of FCTs to EXEC CICS DCTs DLI e
202. RE recall enable R D recall disable R D recall disable R U recall unenable R U recall unenable Page 86 CAFC FEATURES AND CONS DERAT O DCT WARM COLD START CUSTOMIZATION OPTIONS Pictured below are the parameters for controlling CAFC s Start options CAFC Vy The CAFCPARM input s for YES or N for NO COLD START DCT ENTRIES gt WARM START DCT ENTRIES gt DCT WARM START ACTIONS IF LAST REQUEST WAS OPEN ENABLE gt OF CLOSE ENABLE gt CE ALLOCATE ENABLE gt AFR FREE ENABLE gt FR RECALL ENABLE gt RE OPEN DISABLE gt OD CLOSE DISABLE gt CD ALLOCATE DISABLE gt AD FREE DISABLE gt FD RECALL DISABLE gt RD DCT warm start processing by program AFCPWARM at PLTPI option can be overridden by including the operand tream within the CICS st NS DCT Warm and Cold DCT Warm Start Option is used to enable or disable the WARMDCT x Where x artup jcl time This in your is equal to N Y ALLOCATE FOR CICS DCT COLD START N NO COLD START Y Y AUTOMATIC WARM START PLTPI N NO WARM START THEN WARM START ACTION WILL BE BYTE 1 VALUES BYTE 2 VALUES X NO ACTION X NO ACTION O OPEN E ENABLE C CLOSE D DISABLE A AL
203. RECORD MAINTENANCE FACILITY CONTINUED HEADER RECORD _RESYCHRONIZATION Page 270 MAINTENANCE AN D CONVERSION AIDS Header record synchronization can be performed using the stand alone command SYNCHRONIZE _HEA record counts by type and update the CAFC each type of entry SYNCHRONIZE _HEA DERS DERS Occasionally header record counts can become corrupted through improper us of external file maintenance Execution of this command will read the CAFC table file summarize the table file header records for EXTENDED CAFC RECORD MAINTENANCE FACILITY CONTINUED Page 271 MAINTENANCE AND CONVERSION AIDS GENERATING DDNS AND TRANSACTION FROM THE CONTENTS OF THE CICS REGIONS TABLES There is a main from the current command is The MIGRATE command Below are a few examples enance command that can be used to CAFC tablefile records contents of the CICS regions FCT PCT or DCT That EEEE Create ddn records using a model and particular values for security and restart status Migrate only extra partition DCTs Do not replace existing records MIGRATE_DCT KEY MODEL DDNAME DCTTYPE X CDTSECCD 0 CDTDRSO C CDTDRSE E Create ddn records using a different model for each DCT type Migrate all types of DCTs Do not replace existing records MIGRATE_DCT KEY DCTTYPE X N I R MODELX DDNX
204. RITTEN EXTERNAL SECURITY All user writ region s PPT CICS Command Level COMMAREA modified by the users system programming staff Installation Tape in the PDS member INSTLIB NOTE Sample External batch or online extended tablefile maintenanc browsing and editing customization options browsing and editing CAFC USER IDs performing ID BID requests for DCT entries performing install and delete request for FCT entries requests tten External Security Programs must be included in the CICS The program must be able to process a parmlist passed ina Security Programs are included on to be the NETEC Intl Inc accepts no responsibility for the correctness or suitability of the logic or the instructions provided in any sample exit program on the CAFC Distribution Tape are provided solely as a basis for your in house developm customized interface programs When you update one of supplied external security exit programs yo control access to the CAFC Customiza exit reformats all CAFC requests for via a parameter list You may wish access controls Page 114 your ex to fine tion Screens ternal security package tune the built in Sample exit programs nt of the Netec ur logic will also The security SECURITY OPTIONS CONTINUED When you update one of the NETEC suppl programs your logic will Scre
205. RM policy It may be necessary to involve the MVS system programming staff in the allocation and definition of this list structure BLDCFRM2 JOB REGION 6M MSGCLASS X MSGLEVEL 1 1 CLASS A J RK RK KK KK KR A A A A A AA A AA AAA A AA A A A A A I Ok Update the administration policy in the Couple Data Set CFRM Coupling Facility Resource Manager J BK RK KK KK RR A A A A AAA A AAA A AAA A A A A A A I Ok STEP1 EXEC PGM IXCMIAPU SYSPRINT DD SYSOUT SYSI DD DATA TYPE CFRM REPORT YES DEFINE POLICY NAME POLICY2 REPLACE YES CF NAME CF01 TYPE 007060 FG IBM PLANT 02 SEQUENCE 00000001088A PARTITION 4 CPCID 00 DUMP SPACE 1000 CF NAME CF02 TYPE 007060 FG IBM PLANT 02 SEQUENCE 00000001088A PARTITION 5 CPCID 00 DUMP SPACE 1000 STRUCTURE NAME IXCCFO1 SIZE 10000 PREFLIST CF01 CFO02 STRUCTURE NAME IXCCF02 SIZE 1000 PREFLIST CF02 CFO1 STRUCTURE NAME IGWLOCKOO SIZE 1600 PREFLIST CF01 CFO02 STRUCTURE NAME RLS_CACHE SIZE 4000 PREFLIST CF02 CFO1 STRUCTURE NAME CAFC_LOG Addition for CAFC Logs SIZE 1000 Addition for CAFC Logs PREFLIST CF02 CF01 Addition for CAFC Logs The follow
206. RMING A RECONCATENATION To physically reconcatenate the DFHRPL enter the R ENTRY REQUEST MENU or from the RPL LIST REQUEST MENU of a RPL command targeting a RPL LIST named RPLGOOD LIST below was the result of 1 entering an AR on DERATIONS PL request from the Below is an example This ENTRY REQUEST the PRIMARY REQUEST MENU followed by the ENTER key on the RPL LIST REQUEST MENU without filling in any additional fields ENTRY RE TYPE AR CAFC PANEL 209 COMMAND INPUT SCROLL gt CSR Te ASAE REQUEST REQST TYPE NAME EQST COMPLETE STATUS MESSAGE DATE TIME BY _ AR RPLA AR RPLB A i E AR RPLC Jie A AR RPLX ft of RPL AR RPLGOOD PL NO ERRORS 05 01 95 20 23 MASTER PF1 HLP PF2 2ND SE END PF4 RET PF7 BWD PF8 FWD PF9 ALT SES PF12 MSG The second way to perform a RPL reconcatenation is t Menu directly user entered the RPL List the NAME field and RPL name before performing the reconcatenation RPL List containing the libraries PDSs o use RPL L ST REQUEST name RPLGOO user knew th in the REQUEST field Th list of symbolic ddnames and ll become the new DFHRPL for the region Drp an list RPLGOOD references a specific their
207. ROPTS GENERIC command will not inherit generic capabilities even though the profiles contain an CREATING RACF PROFILES MASTER USER OPER Access to CAFC resources is divided into 3 levels MASTER USER and OPER MASTER access is intended to be reserved to System Programming level personnel USER access is intended to be for Application Programming personnel and OPER access is intended to be used by operations personnel who issue CAFC requests Separate CAFC systems running in separate CICS regions can be uniquely identified by their CICS APPLID and thus protected individually CAFC honors RACF generic profile rules so more general profiles can be created at your installation CAFC creates resources names that a user s authority is checked against in the following manner RACF MASTER PROFILE For MASTER functions the resource is created by suffixing the MASTER sequence with the VTAM APPLID of the CICS system where CAFC is executing An example of this would be if CAFC was executing in a CICS region whose APPLID was TESTCICS the resource created would be MASTER TESTCICS In this example the user can 1 browse and update CAFC Table File records 2 issue CAFC requests open close allocate etc against CAFC controlled items and 3 browse and alter CAFC Customization panels Page 107 CAFC FEATURES AND CONSIDERATIONS SECURITY
208. Record 323 Batch Terminal Processor 37 236 Batch Terminal Processor DFHTCT definition 24 Batch Terminal Processor installation steps 241 Batch Terminal Processor required exit programs 204 211 CAFC record maintenance 284 CAFC Requests from a Sequential Terminal 269 CAFC Requests from an Operator Console 269 CAFC requests issued from a user program 278 CAFC requests using the AFCC Transaction 266 CAFC Requests using the AFSQ Transaction 269 CAFC special options description 151 CAFC Table Entry Maintenance Transaction AFC5 320 CAFC Table File Control Record Report 323 CAFC Table File Conversion 11 CAFC Table File Conversion FCT entries 11 CAFC Table File Entry Batch Report program AFCP2021 321 CAFC Table File Entry Summary Report 322 CAFC Table File Maintenance Tranid AFC5 299 CAFC Trace DD Statement for CICS Startup 9 CAFC TSO ISPF LOG VIEWER 324 CAFC AFCFMSGS 5 CAFC CSDLOAD 5 CAFC INSTLIB 5 CAFC LOADLIB CAFC Load libraries 5 CAFC MACLIB 5 CAFC VSAMLOAD 5 CAFCGRP PPT amp PCT entries 7 CAFCOVER JCL statement 9 174 CAFCOVER override request processing 173 174 317 345 CAFCOVER requests for Alternate Dsname switches 62 CAFCOVER requests for Alternate Dsname Switches 174 CAFCPARM Default Parameters 176 CAFCPARM DEFAULTS 177 CAFCP
209. S Pictured below are the RPL CONCATENATION OPTIONS parameters for updating the RPL management facility IF RPL ALLOCATION FAILS THEN RECOVERY ACTION WILL BE AT CICS STARTUP TIME gt 2 1 2 3 AFTER CICS IS RUNNING gt 2 1 2 1 DO NOT RECONCATENATE DFHRPL 2 OMIT FAILING DDN FROM DFHRPL 3 ABNORMALY TERMINATE CICS REGION WARM START DFHRPL gt Y Y START CICS WITH LATEST REQUESTED RPL CONCATENATION N START CICS WITH DFHRPL FROM CICS JCL WARM START RPL NAME gt RPLA NAME OF CAFC RPL RECORD FOR WARM START RECOVERY ACTION AT CICS STARTUP TIME If the reconcatenation at CICS Start Up fails CAFC uses the Recovery Action to determine how to proceed Depending upon the value specified the reconcatenation will be abandoned will proceed without the RPL in error or CICS Start Up will be abnormally terminated Default value is gt 1 RECOVERY ACTION AFTER CICS IS RUNNING If a reconcatenation function fails CAFC uses the Recovery Action to determine how to proceed Depending upon the value specified the reconcatenation will be abandoned or will proceed without the RPL in error Default value is gt 1 NAME OF RPL WARM START DFHRPL When warm start is selected this field specifies which RPL List name that will be used to determine which RPLs should be incl
210. S da optionally translate OPEN and CLOSE requ These parameters elim request jobsteams that were setu Four other customization option CS is up or down using an online or batch automatically generate and ro an enable open to the other regions where to work you mus CS SUPPORT Options menu tasets or Propagation on the EXEC CI the OPEN CLO the mechanism does not warm start the QUIESCE Warmstart RLS DERAT ONS ddname record then directly to the VSA reques i the CAFC M control Ex The uired the req target supports the n the VSAM RLS SUPPO ests to UNQUIESCES a inate the need to ch p for non RLS access before making the re parameters found on disable or free as the dataset is insta file RT menu nd ange CAFC quest this sociated lled In SED status of the RL UNQUIENCE status however does have the ability to This featur DSNAME option on the VSAM RLS SUPPORT opt totally independent from the FCT WARM START o for level SET RLS DSNAME is maintained in the CAFC It can be overridden by specifying th CAFCPARM S dataset Specify either SETRLSDSN The status field in the CAFC request list now of LD Gu and W se set the Record Level Sharing option to S file by the dsname into the FCT This action insures the dsname w
211. S field is set to latest enabled disabled status of the PCT entry CAFC and is stored in the TXN record DRS field HOW DRS FIELDS ARE SET DCT ENTRIES CAFC by NON VSAM DDN items enabled whenever an EF for any DCT category entry DCT entries have two DRS fields open closed allocated or free The ot with values of enabled or disabled DCT ent e DRS field for Enabled Whenever an E or OE equest is directly or indirectly issued by a CAFC request the DRS field to enabled Conversely whenever a D or disabled Thus the is always remembered by one is for Open Status with values of her is for Enabled Status The DRS Enabled Sta request is issued fro directly or as part group of applications This DRS field is set t DF request is issued for enabled disabled status of VSAM ddname record DRS field the DCT entry Thus the DCT entry is reme The DRS Open Status field is set to open whene issued for the DCT entry directly or as part of group of applications It is also set to open for any DCT entries within an application Ina Open Status field is set to closed for C or Tallocated for A request ts and to free for latest open closed allocat by CAFC in this DRS field ted free status of the HOW DRS FIELDS ARE SET FCT ENTRIES FCT entries have th
212. S to establish communications with your external security package 6 Insure that CAFC s APF authorization facility DFHDEB70 has been installed and is operating properly 7 Logon to CAFC with the MASTER userid and the PASSWORD pass word From the Primary Option Menu select d 5 for the CAFC Customization Options From the Customization Option menu select 7 for the SECURITY options Change the SECURI TY FLAG field to an X for EXTERNAL Now update the APF AUTHOR ZATION fields for the authorization type you have installed Carefully add the name of your user modified external security exit program to the PROGRAM NAME field Double check your updates As soon as you hit the enter key the parameters are updated When you exit the customization screen CAFC will activate your updated external security options Page 116 CAFC FEATURES AND CONSIDERATIONS AUDIT OPTIONS Pictured below is the AUDIT panel for updating Audit Trail options SS AUDIT OPTIONS CREATE AUDIT LOGS gt Y Y N CAFC AUTHORIZATION SVC gt 252 000 IF SVC NOT PROVIDED 128 255 CAFC SVC NUMBER COMPLETED REQUESTS gt D N DO NOT LOG REQUESTS D LOG DIRECT TO DDNAME T LOG TO TRANSIENT DATA DESTID L LOG TO MVS SYSTEM LOGGER DDNAME gt CAFCLCOR FAILED REQUESTS gt D N DO NOT LOG REQUESTS D LOG DIRECT TO DDNA
213. SAM CAFC2000 TESTFIL COPY REQUEST Er type of O and type of D The COPY request requires the new copy entry ddname followed by the existing entry ddname and optionally Example 1 CICSREG1 COPY D OLD Create a new DDname record with the attributes of OL l a data set name DDN NEWDDN NTEC CAFC4200 NEWFILE entry name of NEWDDN and a data set name of NTEC VSAM CAFC4200 NEWFILE Example 2 CICSA COPY DT OLDDDN NEWDDN NEWDSNAME E DTO1 Create a new DDname for an EXTRApartition attributes of the OLDDDN given an entry name of NEWD of NEWDSNAME and a destid of DTO1 Page 208 DDN given a DCT entry with the DN a dsname BATCH TO C CS NTERFACE B I BATCH INTERFACE JCL AND COMMAND LINE FORMATS CONTINUED BATCH INTERFACE CEMT REQUEST The Batch Interface Program offers a specific function to start standard CEMT requests from batch job steps The CEMT request returns CEMT Translator and Executor responses success or failure to the initiating batch job step If the target CICS region is down 1 the CEMT request is ignored 2 a Batch Interface condition code is set and 3 the jobstep is terminated CEMT processing limits the returned data to 8 000 bytes If a CEMT request generates a large amount of response data e
214. SC CDRM cdrmname Y R Y R CICSP TCT ENTRY DFHTCT TYPE SYSTEM ETH VTAM TNAME CICSI621 MUST MATCH LABEL ON APPL YPE LUTYPE62 FFER 256 SIZE 256 MSTAT TRANCEIVE URE SINGLE DFHTCT TYPE SYSTEM ACCMETH VTAM NETNAME CICSI622 MUST MATCH LABEL ON APPL RMTYPE LUTYPE62 BUFFER 256 RUSIZE 256 TRMSTAT TRANCEIVE FEATURE S INGLE Page 237 BATCH TO CICS INTERFACE SAMPLE BATCH INTERFACE ENVIRONMENTS CONTINUED INSTALLATION SAMPLE 4 CONTINUED _CPU 2 SYS1 VTAMLST MEMBER CAFVT72 BATCH INTERFACE APPLID CICSI622 VBUILD TYPE APPL CICSI622 APPL ACBNAME CICSI62 AUTH ACQ PASS CICSI621 VBUILD TYPE CDRSC CICSI621 CDRSC CDRM cdrmname CICSP VBUILD TYPE CDRSC CICSP CDRSC CDRM cdrmname CICST TCT ENTRY DFHTCT TYPE SYSTEM ACCMETH VTAM NETNAME CICSI1621 MUST MATCH LABEL ON APPL RMTYPE LUTYPE62 BUFFER 256 RUSIZE 256 RMSTAT TRANCEIVE FEATURE SINGLE DFHTCT TYPE SYSTEM ACCMETH VTAM NETNAME CICSI622 MUST MATCH LABEL ON APPL RMTYPE LUTYPE62 BUFFER 256 RUSIZE 256 TRMSTAT TRANCEIVE FEATURE S ING
215. SCROLL DOWN PFKQ9 gt SWITCH TO ALTERNATE SESSION PFK10 gt SCROLL UP TO PREVIOUS SECTION PFK11 gt SCROLL DOWN TO NEXT SECTION Page 150 CUSTOMIZATION OPTIONS DSNAME VARIABLES Dsname variables can be used in multiple region environments where the ddnames for files are the same between the regions and the dataset names are the sam xcept for special identifiers that designate the file is a test file or a production file DSNAME VARIABLES amp V1 gt DSNAME VARIABLE SYMBOL VALUE amp V2 gt DSNAME VARIABLE SYMBOL VALUE amp V3 gt DSNAME VARIABLE SYMBOL VALUE amp V4 gt DSNAME VARIABLE SYMBOL VALUE amp V5 gt DSNAME VARIABLE SYMBOL VALUE amp V6 gt DSNAME VARIABLE SYMBOL VALUE amp V7 gt DSNAME VARIABLE SYMBOL VALUE amp V8 gt DSNAME VARIABLE SYMBOL VALUE HOW TO SPECIFY VARIABLE SYMBOLS 1 There are 8 symbols named amp V1 to amp V8 2 They may be specified at CICS startup in CAFCPARM amp V1L NETEC amp V6 TEST The values are saved in the control record and will be used for this CICS execution until changed by customization options edit 3 They may be specified during CICS execution by customization options edit The variable symbols will b ffective for the next time that a file is opened It is
216. SIDERATIONS Always use the set and STRNO parameters on parameter If you fail DFHFCT TYPE SHRCTL macro ins This will reduce the drain on OSCOR the SHRCTL macro to code the full SHRCTL parame tructions f You must c DO NOT USE pool s CICS can easi negatively effect overall CI CAFC makes it so much easier to mov OSCOR fragmentation if The fragmentation is due to It has nothing to do with CAFC s ICS startup failures batch and on line that you will you continue to use the RSCLMT specification the increased CLOSE acti ly miscal CS vity operations CICS message DFHO961 When you properly code th Cc sizes ICS does not 2 ways 1 LSR pool initialization time overh you move the normal allocation overhead to transaction execution always have enough buffer space This is in keeping with CICS 3 x CICS will 4 closed during the CICS session If you strive for reliable operations philosophy A common symptom h ead e SHRCTL macro ave to delay system you substantially reduce CICS s you do not have or each VSAM data ode BUFFERS KEYLEN the RSCLMT ters for the LSR size This will culate the proper pool performance and even ca likely xperienc related to LSR pool size errors use file OPEN and files between is the initializ your regio
217. SING OPTION gt 1 1 PROCESS APPLICATION 2 PROCESS DDNAME 3 PROCESS APPLICATION AND DDNAMES LOCATION OF MSG ROW gt 01 ROW WHERE MESSAGE WILL APPEAR COLUMN gt 01 COLUMN WHERE MESSAGE WILL APPEAR LENGTH gt 56 MAXIMUM LENGTH OF MESSAGE FUNCTION RC TEXT ATTRIBUTE O 00 REQUEST FOR APPLDDN COMPLETED STATUS DATE TIME BR O 04 REQUEST FOR APPLDDN COMPLETED STATUS DATE TIME BR O 08 REQUEST FOR APPLDDN COMPLETED STATUS DATE TIME BR 00 CLOSE FOR APPLDDN COMPLETED DATE TIME NM G 04 CLOSE FOR APPLDDN COMPLETED DATE TIME NM 08 CLOSE FOR APPLDDN NOT COMPLETED DATE TIME NM PF1 HLP PF2 2ND SES PF3 END PF4 RET PF7 BWD PF8 FWD PF9 ALT SES After entering the item number for GLOBAL CUSTOMIZATION from the message facility customization menu the MESSAGE CUSTOMIZE FACILITY panel is displayed Use this panel to update the following options COMMAND INPUT SCROLL ENABLE ALL MESSAGES FUNCTION MESSAGES PROCESSING OPTION ROW COLUMN LENGTH FUNCTION 10 RETURN CODE J TEXT 12 ATTRIBUTE OMAATNAUHAWNE j Page 141 CAFC FEATURE MESSAGE FACILITY OPTIONS CONTINUED COMMAND INPUT S AND CONS DERAT ONS The command input field directs the system to perform a specific task These tasks are described below
218. STEPS CONTINUED STEP 11 Activating CAFC s Extended FCT Support There are two procedures that activate CAFC Extended FCT support STEP 11A Check to see that module AFCP2010 is placed in the PLTPI after DFHELIM so that it runs during the third stage of CICS initialization During PLT processing AFCP2010 transfers control to AFCP2DCT which will establish the needed interface for FCT activity The FCT intercept logic is built into the AFCP2DCT module As with Extended DCT PCT support the Extended FCT support will load one of the following modules DCT53 DCT61 DCT62 DCT63 DCT64 or DCT65 These CAFC programs must be marked RES YES in the PPT STEP 11B Go to the CUSTOMIZATION OPTION MENU select the symbol The interfac for SUPPORT EXEC CICS Enter a Y for EXEC CICS SET FILE to activate Extended FCT Support allows CAFC to monitor FCT status change activity and to update the CAFC Table File DDname record flags for enable disable open close status NOTE You may deactivate CAFC s extended FCT support by changing EXEC CICS SET FILE option to an N Activation of extended DCT PCT FCT support and LPA YES requires th removal of Cl avoid a U601 CS programs DFHAIPxx and DFHEIPxx from the LPALIB to ABEND at startup STEP 12 Activ
219. SYSIN or PARM TRACE y C Gy EPES EE MoE Mis ects nyGe lt d The output of the trace is directed to the SYSOUT data set CAFCTRAC This assumes you have added the following CAFCTRAC DD statement to the B I job step s JCL CAFCTRAC DD SYSOUT In the second example above the word TRACE Y is simply placed in front of the first CAFC B I request An alternative to using the execute statement to provide trace parameters is to use CAFCPARM SYSIN DD statement This is useful when you must provide multiple parameters It there are no parameters the DD statement can be omitted B I TRACE FACILITIES TO ACTIVATE ON LINE TRACE If you need to trace an individual B I request add the proper trace commands to the SYSIN request list There are thr varieties of on line traces general debugging DLI debugging and I O subsystem debugging In most cases the general debugging trace should be selected The traces are activated and deactivated by sandwiching trace commands before and after the request in question The target CICS region must have access to its own CAFCTRAC output data set Trace Command Trace Action TRACN Turn General Debugging Trace ON TRACE Turn General Debugging Trace Off TRDLN Turn DBCTL Debugging Trace ON TRDLF Turn DBCTL Debugging Trace OFF TRION Turn I
220. Sie BER aD Sea a Ble Site ER Be ee EIO hee a aa had GION S ry JECTION SC REE ENHANC G iD RESOU RC ry MANAGEMEN I ei elses ses oh Srna sl oerene re ease sub gh aes EEEE eye EAE Mh Sen fees AUTOMA START USING USING CUSTOMIZATION OP CUSTOM FCT WA DCT WA OTR WA B I LU B I EX ON LINE AN TIC STAT D STOP US DBC1 MESSAGE MANAGE TL CICS INT CAFC S U TY SERVICES T Pi EXCL Pi TABL TO EXCL BAL I ZATION OPT ONS SUMMAR T aaar sg ids 6 ie Segue eli a Oa NEE a E E Wie Nea E R RM START RM COLD G US STARTI TOMIZATION OPT POP TIONS ieee toed ls ah eho diode eo het el Baek Lo Res dice car eka a Bea bia Rates dca en 8 Lae RM START 6 2 CUSI G CIC IT F EX p SECURI TY OPT US TOMIZATION OPTIONS USTOMIZAT PTIONS TOMIZATION OPT TION OPTIONS NO SEC BASIC USER S URITY ACT CAFC IGNON SEC OP RACF O ACF2 A UDIT FCPSI TO OPT R TOE CTIV OPT PY EQU EDIT O HSM OP EXEC C DFHRPL D SE A W A R EST ECIAL OF PTIONS TIONS ICS INTE MANAG EME OPTION S M ESSAGE G FACILI COMMAN
221. T45C to copy CAFC s authorization modules to the Steplib Page 6 NSTALLATION PROCEDURES STEP 97 UPDATE THE CICS TABLES Update the CICS PLTPI XLT and TCT tables by using the members required for your version of CICS from the CAFC R4500 INSTLIB CAFCPLT PLTPI entries for CICS startup CAFCXLT XLT entries for Batch Interface CAFCTCT TCT entries for B I LU6 2 LU0 terminals CAFVT7A CICS Region VTAM APPL for B I definitions The CAFC installation tape provides the RDO definitions for transactions programs maps and terminal entries Use the jobstreams provided in CAFC R4500 INSTLIB Define a temporary DFHCSD file Load the entries from the CAFC R4500 CSDLOAD file to the temporary DFHCSD file Use the job stream members below Use either INST0O50 or INST50C depending on the type of install being performed tape or cd rom INSTO50 for tape installs for defining and loading a temporary DFHCSD file containing a group for CAFC programs and transactions and other groups defining CAFC s LU6 2 and LUO terminal T050 entries INST50C for CD installs for defining and loading a temporary DFHCSD file containing a group for CAFC programs and transactions and other groups defining CAFC s LU6 2 and LUO terminal T050 entries INSTO60 use this job to move CAFC s pre
222. TIC SAVE If this option is set to Y CAFC will automatically precode the SAVE command on the command line of the edit panels Default value gt Y DELETE OPTIONS This option controls deletion of CAFC records N no deletes allowed S allows deletion of specific entry name items G allows mass deletion of CAFC records This is accomplished by entering a wildcard character in the entry name For example an entry name of ABC D will delete all records of a specific type if the entry name on the CAFC file matches the entered entry name pattern Default value gt G Note Ddnames must be closed and deallocated for delete requests to complete successfully Open or allocated ddnames can not be deleted RENAME OPTION This option controls renaming of CAFC records N no renames allowed sa allows rename operations Ddname must be closed and deallocated prior to issueing rename operation Page 128 HSM OPTIONS Pictured below is the HSM RECALL OPT support options HSM S HSM P R UP RO ECALL PORT C EDURE CYCI E INT ERVAI RECALL RI AT PLTPI TIME IF DS WAIT MIGRATION ID ECALL SUPPRESSION N IS LIMIT ENTIFER ry MIGRATED WARM START ACTION HSM SUPPORT CAFC s specified th RECALL set mechanism and update the SECURI DFHSM PROCEDURE NAME I
223. TIONS HSM OPTIONS CONTINUED RECALL CYCLE INTERVAL After the RECALL request is issued CAFC will wait for an interval of time then check to see if the request has been satisfied This parameter specifies in seconds the amount of time CAFC will wait before again checking on the completion of the RECALL request Default value is gt 000030 RECALL WAIT TIME After the RECALL request is issued CAFC will periodically check to see if the request has been satisfied When CAFC issues a RECALL request it 1 waits for the amount of time specified for WAIT INTERVAL FOR RECALL COMPLETION and 2 then checks to see if the request has been satisfied If the RECALL request completed successfully then processing continues with normal allocation If the RECALL request has not completed as yet CAFC will continue to repeat the wait check process for the period time specified in this parameter If the RECALL has not completed after this number of seconds the allocation request is treated as if it failed Default value is gt 000300 RECALL SUPPRESSION If Y is selected for this option CAFC will NOT attempt to allocate or recall the data set if it is migrated If W is selected for this option CAFC will NOT return to the calling program until the recall is complete or the timeout value h
224. TS 1 3 and above there is no reason to pre allocate or pre open a FCT file prior to first use CAFC will insure that your FCT files are ither enabled or optionally opened by the end of PLT processing Make sure that CAFC s PLTPI program AFCP2010 runs during the third stage of PLT initialization so it can activate its processing programs AFCP2DCT AFCP2FCS and AFCPWARM These programs help to ensure that your files and databases will be set to a status that will allow CICS or CAFC to dynamically allocate or open them upon first access or at the time CSFU issues the actual open request Page 30 CAFC FEATURES AND CONSIDERATIONS REMOVING DD STATEMENTS FROM CICS S JCL CONTINUED Th re are 6 methods for defining files to CAFC 1 Use the JCL Conver ddname entries fro entitled Creating CAFC D 2 Use the Batch Tran Table File Revi sion Utility AFCP2023 This batch utility creates m your existing JCL statements Review the section Dname Table Entries from JCL Statements sfer Utility AFCP2020 This batch utility transfers ddname entries from an existing CAFC Table File to your new w the section entitled Transfer CAFC Table Entries Between CAFC Table Files 3 Use the Extended CAFC Record Maintenance Facility to create ddname nd DCT entries Review the section entitled Generate DDname Records from FCT and Generate DDn
225. The following is an example of the DFHXCO END options table specify a number of parameters that are required by the B I the external CICS interface DFHXCOPT table Le generated by the For DFHXCO macro the C CS EXC See CS you are executing cannot be suffixed TYPE CSECT CICSSVC 215 CONFDATA SHOW DURETRY 30 GTF OFF MSGCASE MIXED SURROGCHK YES IMEOUT 0 RACE OFF RACESZE 16 TRAP OFF DFHXCOPT DFHXCOPT this name VALID for TS only ICS regions and the external CICS interface that it finds in the enables you to program s more details on the creation nterface manual for the table into a load B concatenation of the job that runs B I tables you specify for C the DFHXCO table definition Add the EXCI Program Library to the B I Program s JCL the STEPLIB of the B I program JCL The following is an example of a EXCI B I job stream jobcard JOB accounting information STEP1 EXEC PGM AFCP2016 STEPLIB DD DSN your cafc loadlib DISP SHR The following DD defines the EXCI Program Library DD DSN CICS SDFHEXCI DISP SHR SYSPRINT DD SYSOUT SYSIN DD CICS99P 0 DD QAFCTO1 Step 3 CONFIRM THAT IRC SUPPORT IS ACTIVE f IRC YES is
226. UED PROGRAM FUNCTION KEY SIMULATION TABLE CHARACTER STRING PF KEY HEX AID BYTE O1 PEI F1 02 PF2 F2 03 PF3 F3 04 PF4 F4 x05 PFS F5 x06 PF 6 F6 07 PFT F7 08 PE8 F8 09 PF9 F9 10 PF10 7A 11 PF11 7B sales PF12 7C aS PF13 C1 14 PF14 C2 XLS PEPELS C3 xO PF16 C4 KE PF17 CO 18 PF18 C6 19 PF19 C7 20 PF20 C8 2 i PF21 CY 22 PF22 4A 23 PF23 4B 24 PF24 4c ENTER ENTER YD PA1 PAL 6C PA2 PA2 6E PA3 PA3 6B CLEAR CLEAR 6D Page 221 BATCH TO CICS INTERFACE BATCH TERMINAL PROCESSOR INSTALLATION STEPS SUMMARY OF BATCH TERMINAL PROCESSOR INSTALLATION STEPS Install the LUO terminal entry in the appropriate Cl Interface Terminal Processor APPLID ACB le and link the Batch Association Table or list of ACB names LUO session This step is necessary only multiple ACBs or your single ACB name is properly 1 2 Define the Batch 3 Optional Assemb with the ACB name default name of LUOTERM 4 BATCH TERMINAL PROCESSOR TRAN INSTALLATION STEPS terminal entry for the LUO detailed instructions in Step 4 STEP 1 Add the Model terminal Terminal Control Table definitions are provided in the Member LUOTCTO to be used if you choose to use something ot Insure that the LU6 2 terminal entry has been set up and is functioning CS region to VTAM AFCT2016 ins CO S defin
227. UEUES D UNQUIESCED amp OPEN OPEN NLOCK amp OPEN XNS NQUIESCE amp OPEN NABLE TXNS NLOCK UNQUIESCE NABLE TXNS CLOSE CLOSE ACGCHAaGHG DATASETS TDQUEUES START DBDS ENABLE OPEN TDQUEUES TXNS DATASETS OPEN TDQUEUES START D ENABLE BDS DATASETS OPEN TDQUEUES STAR I DBDS OPEN DATASETS DATASETS TDQUEUES STOP DBDS amp ENABLE QU SE T IESCE DATASETS UNAVAILABLE DATASETS DATASETS TI SE I DATASETS QUIESCE CLOSE amp LOCK DATASETS D amp UNAVAI DQUEUES LABLE OPEN TDQUEUES CLOSE amp QUIESCE SE SE ST DBI T DS T OP DATASETS CLOSED CLOSE TDQUEUES DATASETS DATASETS CLOSED amp UNAVAILABLE S STOP DBDS TART DBDS CLOSE TDQUEUES STOP D BDS CLOSE T QU DBDS QUIESCE amp TOCK CLOSE SE ST SE T OP T DBDS DATASETS CLOSD QU H DB DB DQUEUES ISABLE TXNS ISABLE TXNS DS DS SABLE TXNS STOP DB CLOSE CLOSE amp LOCK DS DATASETS DATASETS CLOSED LOCKED amp UNAVAILABLE ITESCED LOCK DQUEUES IESCED UNAVAILABLE STOP CLOSE TDQUEUES
228. UILD TYPE APPL CICSI621 APPL ACBNAME CICSI62 AUTH ACQ PASS CICSI622 VBUILD TYPE CDRSC CICSI622 CDRSC CDRM cdrmname CICSP TCT ENTRY DFHTCT TYPE SYSTEM ACCMETH VTAM NETNAME CICSI621 MUST MATCH LABEL ON APPL RMTYPE LUTYPE62 BUFFER 256 RUSIZE 256 TRMSTAT TRANCEIVE FEATURE SINGLE DFHTCT TYPE SYSTEM ACCMETH VTAM NETNAME CICSI622 MUST MATCH LABEL ON APPL RMTYPE LUTYPE62 BUFFER 256 RUSIZE 256 TRMSTAT TRANCEIVE FEATURE S INGLE CPU 2 SYS1 VTAMLST MEMB BATCH INTERFACE APPLID CICSI622 VBUILD TYPE APPL CICSI622 APPL ACBNAME CICSI62 AUTH ACQ PASS CICSP VBUILD TYPE CDRSC CICSP CDRSC CDRM cdrmname T R CAFVT72 Page 236 BATCH TO CICS INTERFACE SAMPLE BATCH INTERFACE ENVIRONMENTS CONTINUED INSTALLATION SAMPLE 4 Consider the following environment a two cpus where b batch interface runs from either cpu and g must be able to communicate with cics regions on both cpus CPU 1 SYS1 VTAMLST MEMB T R CAFVT7A BATCH INTERFACE APPLID CICSI621 VBUILD TYPE APPL CICSI621 APPL ACBNAME CICSI62 AUTH ACQ PASS CICSI622 VBUILD TYPE CDRSC CICSI622 CDRSC CDRM cdrmname CLEST VBUILD TYPE CDRSC CECST CDR
229. Use this panel to update the following options 1 COMMAND INPUT SCROLL FUNCTION MESSAGES ROW COLUMN LENGTH FUNCTION RETURN CODE TEXT O ATTRIBUTE Fo OANA OB WN Page 146 CUSTOM ZAT MESSAGE FACILITY OPTIONS CONTINUED COMMAND INPUT The command input field directs the system to perform a specific task These tasks are described below ON OPTI ONS Blank Edit the input and present the results SAVE Edit the input and save the data if there are no errors COPY Copy an already existing definition into this one If the edit is being performed on an existing record the data will be overlaid If not then the data fills the current work record CREATE Create a new definition from the one currently displayed REPLACE Replace a current definition with the data currently displayed SCROLL This field directs the system to page display overwritten by valid ent PAGE HALF Numeric M then tries into that value will the user Display Display a full is halfway up Display a full Maximum the proper scroll amount The scroll may be entered into the COMMAND into the SCROLL field on the input INPUT screen screen remain in the COMMAND The same is true for the SCROLL field are the next full page of data beginning with the nex entry after the
230. WED After entering the item number for EDIT from the Customization Option Menu the EDIT OPTIONS parameters are displayed Use these parameters to update the following options SORT APPLICATION DDNS SORT APPLICATION TXNS SORT DLI COMPONENTS SORT APPLS IN GROUP AUTOMATIC SAVE SORT APPLICATION DDNS If this option is set to Y CAFC will automatically sort the list of DDNames for an application the edit panel Default value gt Y SORT APPLICATION TXNS If this option is set to Y CAFC will automatically sort the list of transactions for an application on the edit panel Default value gt Y Page 127 CAFC FEATURES AND CONSIDERATIONS EDIT OPTIONS CONTINUED SORT DLI COMPONENTS If this option is set to Y CAFC will automatically sort the list of DDNames for a DLI definition on the edit panel Default value gt Y SORT APPLS IN GROUP If this option is set to Y CAFC will automatically sort the list of applications for a group definition on the edit panel Default value gt Y ALTERNATIVE DSNAME OPTION If this option is set to Y CAFC will activate the Alternative Dsname facilities This facility allows two dsnames to be entered for a single ddname The facility offers commands to switch between a primary and secondary dsname Default value gt N AUTOMA
231. XIT AREA The pointer to the Send text area The pointer to the Receive text area Refer to Installation Member AFCDSOXA for a full description of the exit area contents The data items provided in the Exit Area include A FUNCTION IN PROGRESS flag e Exit Initialization e Sign On e Sign Off A REASON FOR ENTER ING the exit flag Provide input for Sign On Sign Off Examine the response from Cl A TARGET CICS STATUS flag CS for Sign On Sign Off Target CICS is up Target CICS is down A Return Code Area Possible values request that Batch Interface processing continued because the Sign On Sign Off function was successful or bypassed The Batch Interface Request could not be performed because Sign On was unsuccessful All subsequent CAFC Batch Interface requests are to be flushed The Batch Interface Program sent the contents of the Send text area to the target CICS region and returned the response to the exit program The Batch Interface Program perform a VTAM Receive without first doing a Send Some CICS transactions require multiple Receives per Send Page 228 BATCH TO C CS NTERFACE BATCH INTERFACE SIGN ON SIGN OFF EXIT CONTINUED Please code for a sample CAFC Sign On Sign Off Exit intended purpose of this exit is to interact Program s Sign On Sign Off function exists e The Batch param
232. _request authorize DPL If surrogate o userid is specified on the userid on where userid is the userid specified on the DPL call user checking is enabled SURROGCHK YES but n the DPL call no surrogate user check is performed becaus the DPL call defaults to the batch region s userid We recommend you te processing is disable the that the B I le surrogate user security checking DFHXCOPT options table Surrogate user checking is useful when CS region userid a surrogate D specified on the no password is passed lowed by less For more information about C The default the B I in which case the link user check is DPL call If the B I link security checking is userid passed on a the link security authority than allowed by ICS security program userid has specify is set to program s is not an programs userid DPL see CAFC FEATURES AND CONSIDERATIONS B I EXCI CUSTOMIZATION OPTIONS CONTINUED AFCP2SOX B I SECURITY EXIT NOT CALLED Since the CAFC EXCI B I connection method utilizes MRO security not the CESN CESF signon method the B I program LU6 2 security exit AFCP2SOX is NOT called Page 101 ON LINE EXIT OPTIONS CAFC FEATURES AN D CONS ONS DERAT Pictured below are the parameters for updating CAFC s Exit options EXI EST USER
233. a ing CICS Version 3 3 or above the user program D2007 under C EX EC S L USING CICS GI ET R1 INITIMG X 40 US ETMAIN ERDATAK AFCD2007 EY ENGTH AL2 AF7PRML1 ET UP ADDRESSIBILITY R1 S Page 260 uch programs be performed in CI To properly obtain storage for CS Version 3 3 and above AF7MSGSA requesting program has the requesting program must free AF7MSGSA This Sample B contains sample code that successfully STG and all the storage the will prevent a program FREEMAI Ns the parmlist AFCD2007 passed calling GETMAINS will ling program runs at PLTPI in EXECKEY CICS CS DATAKEY thus follow the coding conventions OPERATIONAL CONSIDERATIONS IMMEDIATE SHUTDOWN OF CICS transactions to During an IMMEDIATE shutdown of CICS the PLT programs for CAFC shutdown will be driven However once an IMMEDIATE shutdown has been issued CICS will not allow active transactions to complete nor will allow any new execute This means any active but not completed CAFC activity will be ungracefully terminated This will likely cause some of CAFC S warm start flags to be set in error If you issue an AFCT SHUTDOWN prior to a
234. a 45 byte area padded with trailing blanks P age 214 BATCH BATCH INTERFACE STRT REQUEST BATCH INTERFACE STRT REQUEST The B I a non conversational user tran assumes that no data stream will TO C CS NTERFACE S saction on a CIC b turned when th S region r initiated The transaction will CICS region via an EXEC CICS S terminal and a data area with to start CEMT commands because target CICS region is down 1 condition code is set and 3 for transactions that issue a TART command its length CEMT requests are conversational the STRT reque the jobstep term retriev The B I input format for the S OERE c STRT XXxx rrrr 1 where ERE EETA G STRT XXXX TECE Ll vV V TRT request is l v can pass a STRT transaction request from a batch job step to start The STRT req transaction is uest be started immediately on the requested You may optionally specify a The STRT request cannot be st is ignored inates data command used If the 2 the B I STRT solely is used The 1 to 8 character VTAM applid of the the transaction Indicates to the request to run a B I tha transaction target CICS region on which you want to STRT this is a STRT CAFC will issue an EXEC CICS START command for the transaction and optionally pass a
235. a A e Z ae a a a E Z IQHH jm owooooo Z D 2 fi Z Z E Z z H 2 AFCP2402 OOCO 0 Z Fi mE E a e z CAFC RDO requ CAFC automati est display program est function program c allocation and free program Called for EXEC batch request c allocation and free program for FCS CAFC automati requests CAFC status p Program scans and tries to Ddname entry Transaction e Userid entry rogram ID RPL user edit program ntry edit program edit program Page 32 9 CAFC NSTALLAT CAFC LOADLIB CONTINUED ON CONTENTS AFCP2403 ONLINE Maintain control record options AFCP2500 ONLINE CAFC Table file maintenance program AFCP2501 ONLINE CAFC Table file maintenance driver program AFCP2502 ONLINE CAFC Table file maintenance driver program AFCP2503 ONLINE CAFC Table file maintenance translator program AFCP2516 BATCH CAFC Table file maintenance batch interface program AFCP2517 ONLINE CAFC Batch Table file maintenance program Batch version of AFCP2500 AFCP42
236. ablefil lt required SYSPRINT DD SYSOUT CAFCWTOS DD SYSOUT CAFCTRAC DD SYSOUT SYSUDUMP DD SYSOUT CAFCPARM DD SYSIN DD CONTROL CARDGS EXTENDED CAFC RECORD MAINTENANCE FACILITY CONTINUED Page 265 MAINTENANCE AND CONVERSION AIDS 1 AFCFMSGS DD CARD IS REQUIRED 2 MAINTENANCE REQUESTS COME FROM SYSIN ONLY NOT FROM PARM DUE TO THE FREE FORMAT AND SEPARATE REQUEST TO SET THE TARGET CICS 3x IS USED TO INDICATE CONTINUATION OF REQUEST TO NEXT CARD IN COLUMN 1 IS A COMMENT 4 THE TARGET CICS IS ESTABLISHED BY THE REQUEST SET_CICS APPLID XXXXXXXX AND REMAINS IN EFFECT UNTIL CHANGED BY ANOTHER SET_CICS 5 OUTPUT RESPONSES ARE ON SYSPRINT An example of a single request to create a type dd ddname record for CICS99P is provided below SET_CICS APPLID CICS99P CREATE DDN KEY NEWDDN CDTTYPE D CDTDSN NEW DDN DSN CDTDISP SHR Upon completion a new type D fct ddname dd entry with DSN NEW DDN DSN DISP SHR will be have been created and added to the CAFC tablefile The remaining fields required for the creation of the dd entry will be defaulted unless otherwise overridden with parameters on the create_ddn command T T The following example demonstrat
237. ad No No Yes RESident No No Yes USAge Normal Normal Transient USElpacopy No No Yes Status Enabled Enabled Disabled RS1 00 0 24 Public CEdf Yes Yes No DAtalocation Below Below Any EXECKey Cics User Cics COncurrency Quasirent Quasirent Threadsafe REMOTE ATTRIBUTES DYnamic No No Yes REMOTESystem CEDA View PROGram AFCPCDBC REMOTEName Transid EXECUtionset Fullapi Fullapi Dplsubset JVM ATTRIBUTES JVM No No Yes Debug JVMClass AFCPBREX Program Definition OBJECT CHARACTERISTICS CICS RELEASE 0530 CEDA View PROGram AFCPBREX PROGram AFCPBREX Group CAFCGRP DEsScription BRIDGE EXIT PROGRAM FOR AFCPCDBC Language Assembler CObol Assembler Le370 Cc Pli RELoad No No Yes RESident No No Yes USAge Normal Normal Transient USElpacopy No No Yes Status Enabled Enabled Disabled RSL OG 0 24 Public CEdf Yes Yes No DAtalocation Below Below Any EXECKey H CICS User Cics COncurrency Quasirent Quasirent Threadsafe REMOTE ATTRIBUTES DYnamic No No Yes REMOTESystem REMOTEName Transid EXECUtionset Fullapi Fullapi Dplsubset JVM ATTRIBUTES JVM No No Yes Debug JVMClass Page 72 CAFC FEATURES AND CONSIDERATIONS USING CAFC S UTILITY SERVICES MENU The CAFC Utility Services Menu is an on line interface to a collection of programs and transactions that provide CAFC Table File maintenance facil
238. ait condition 142 Request Customization Options 132 Request Screen Options 84 Requesting table entry reports online 83 RLS Access active 60 RLS Commands 60 RLS Record Level Sharing for VSAM 60 RLS Support 170 RLS Support 147 RLS support activation 144 RPL customization Options 86 RPL Customization Options 149 RPL Editor External commands 46 RPL Editor Line Mode Commands 45 RPL external COPY command 43 RSCLMT parameter 276 Saving Edit Entries Automatically 138 139 SBA information in B I TRAN Requests 239 Screen data sequence control options 138 Security Customization Options 85 Security defaults 112 Security Defaults 33 Security for TRAN requests 244 Security name for the B I 95 Security option for ACF2 RACF TOPSECRET BASIC EXTERNA Ty de TAS Security Option for NO SECURITY 112 Security Options Online 84 Security Options Panel 112 Sequential Terminal CICS definitions 273 Sequential Terminal CICS startup JCL 275 Sequential Terminal for issuing CAFC Requests 27 270 SESSION entries for the B I 8 Set File Access Support 149 Set Tdqueue Support 149 Set Tran Support 149 SETRLSDSN startup override 170 Short on Storage Condition 276 SHRCTL Macro 276 SHUT Transaction requirements
239. aken 56 x 38 DBD name not in DDIR 60 x 3C Canceled by user exit 61 x 3D No Fets 62 x 3E No pets 63 x 3F No ppts 64 x 40 No txns 65 x 41 No maps 66 x 42 No ppts maps 67 x 43 RDO group not found 68 x 44 No ddns 69 x 45 RDO resource not found 70 x 46 No dcts 71 x 47 RDO expansion exceeds buffer 72 x 48 No dbds 73 x 49 DFHEDAP translate error 74 x 50 CICS resource is remote 75 x 51 Type ignore Page 258 76 80 84 88 92 96 100 104 108 112 16 120 124 128 132 1 36 LSJ 140 144 AF7TOTXN AF7TOTDD AF7TOTER AF7TOTMS AF7MSGSA AF7STAT AF7TYPE2 OPERATIONAL CONSIDERATIONS x 4c AFCP2008 has abended x 50 Error on Function Command x 54 CICS is shutting down x 58 No Generic items x 5c Invalid type x 60 Security violation x 64 Program not authorized x 68 Program id error x 6c Commarea area length area x 70 Program abend x 74 XCTL start failed x 78 No alternate dsname x 7c No primary dsname x 80 No secondary name x 84 Mixed dsnames x 88 Unknown dsnames x 89 Dsname is allocated x 8c Request canceled internally x 90 Request rejected by CICS Total number of transactions Total number of ddnames Total number of errors Total number of error informa
240. al Normal intensity abbrev N Default value gt BR Bright Page 145 CAFC FEATURES AND CONSIDERATIONS MESSAGE FACILITY OPTIONS CONTINUED APPLICATION CUSTOMIZATION Pictured below is the APPLICATION EDIT TABLE panel for updating the Application Level messages EDIT TABLE APPLCUST ENTRY DFHFCT1 2 2 CAFC PANEL 21N COMMAND INPUT gt SCROLL gt PAGE FUNCTION MESSAGES gt Y Y MESSAGES ENABLED N MESSAGES DISABLED LOCATION OF MSG ROW gt 01 ROW WHERE MESSAGE WILL APPEAR COLUMN gt 01 COLUMN WHERE MESSE WILL APPEAR LENGTH gt 56 MAXIMUM LENGTH OF MESSAGE FUNCTION RC TEXT ATTRIBUTE FI 00 APPLDDN INSTALLATION COMPLETE DATE TIME BR FI 04 APPLDDN ENTRIES ALREADY INSTALLED DATE TIME BR FI 08 APPLDDN INSTALLATION NOT COMPLETE DATE TIME BR F 00 DFHFCT1 ENTRIES FREED NM F 04 DFHFCT1 ENTRIES ALREADY FREED NM PF1 HLP PF2 2ND SES PF3 END PF4 RET PF7 BWD PF8 FWD PF9 ALT SES After entering the item number for APPLICATION CUSTOMIZATION from the Message Facility Customization menu the APPLICATION EDIT TABLE panel is displayed
241. allocation OPEN failures will occur to LSR pool size errors is the Cl in all Page 10 DE section entit insure that tructions to define th This menu directs to add CICS files to DE sect tion tled sizes resource pools the SHRCTL macro L to code the above mentioned parameters te the proper pool size up is delayed or even CS message your regions wil You must DO NOT USE A common symptom DFHO961 ll benefit initialization initialization ution time If you strive for reliable of your production NSTALLATION PROCEDURES DETAIL INSTALLATION STEPS CONTINUED STEP 6 ADD RESOURCES TO THE CAFC TABLE FILE CONTINUED NEW CAFC USERS refer to the section CAFC FEATURES AND CONSIDERATIONS REMOVING DD STATEMENTS FROM CICS s JCL for information on setting up CAFC to control your CICS system Also review the chapter entitled MAINTENANCE AND CONVERSION AIDS EXISTING CAFC USERS if you are running a CAFC Release prior to CAFC4 5 you MUST convert your existing CAFC Table Files to the new format and replace your old AFCFMSGS file with the new one The conversion process sets several flags that are interrogated by CAFC during CICS initialization as well as initializing new option fields If your CAFC Table File happens to have already been converted t
242. ame Records from records from FCT a Der 4 Use the AFCS transaction and CAFC s online edit facility to define 5 Use the B I to add new the CAFC User Docu 6 Use CAFC s on line to the CAFC Tabl ddname entries Review the s mentation ction entitled Editing CAFC Tables in entries to the CAFC Table File maintenance transaction AFC5 to add new entries File The maintenance program AFCP2503 may also be called from you custom written maintenance applications 7 Use the Extended CAFC Record Maintenance Facility to create any type ablefile This facility can be used online or from batch to create ddname entries transaction entries application of entry for the t lists and group lists as well as a number of table management utilities Once you have defined a app ication files DD s ll applicat ion files to CAFC remove the There are two files tha Tab a D D statement in the s files We recommend yo CAFCTRAC is CAFC s on line output requests that override tart up JCL tatements from the CICS startup JCL t you cannot dynamically allocate 1 CAFC s own le File AFCF4000 and CAFC s Message File AFCFMSGS You must include for each CICS region for these two u add two o ther dds CAFCTRAC and CAFCOVER The trace data set while CAFCOVER contains
243. and the AFCP2009 PSB is part of this group The application group name is defined to RACF in the AIMS default class and the user permitted to use th RE DEF NE A PERMI The userid found on is used to determin group name T CAFCAGN MS AGN e AGN as follows CAFCAGN UACC NONE CLASS AIMS ID userl ACCESS READ the jobcard of the CCTL eit ther CICS or AFCP2016 e is the user is authorized Page 52 to use the application CAFC FEATURES AN CAFC INTERFACE TO DBCTL CONTINUED Step D CONS DERAT ONS The second level of security checking is to check the user s ability to issue commands class CIMS commands through the RACF permit command secures the START command and default RDEF NE C PERM through Users ICMD T STA CLASS C 5 Verify that necessary allows userl MS STA UACC NONE MS D userl ACCESS READ IMS commands are defined in the RACF are then permitted the use of the The following example to issue starts IMS pre reg maintenance is installed Step Without this maintenance will not work correctly that OPEN CLOSE CAFC S positive response to If this maintenance is missing DBRECOVERY or after the default wait time has expired For I
244. and transactions and other groups defining CAFC s LU6 2 and LUO terminal entries Use for CD or FTP installations AFCPBOEX PGM Source for sample CAFC Batch program which links to LUO processor AFCPBOPG PGM Source for the sample CAFC Batch program which passes batch return code to online screen AFCPBTX1 PGM Source for the sample CAFC Batch Terminal Processor Receive Data Exit AFCPDCOM PGM DATACOM DB user exit equivalent to AFCP2UEX AFCPDCOL PGM DATACOM DB command level interface to DCCOCPR AFCPLNK8 PGM Source for sample CAFC program to link to AFCP2008 AFCPL216 PGM Source for sample CAFC program to link to AFCP2016 AFCPRDAM PGM Source for the sample CAFC User Exit to support RDAM Access Method AFCP2ACF PGM Source for the sample CAFC External Security Program for ACF2 users AFCP2BCC PGM Source for the CAFC Batch Interface Control Card Exit AFCP2BS2 PGM Source code for a sample Batch Interface Security Exit Program alternative AFCP2BSX PGM Source code for a sample Batch Interface Security Exit Program AFCP2CCX PGM Source code for the sample Batch Interface Condition Code exit program Page 323 CAFC CAFC INSTLIB CONTINUED Source code for a sample Batch NSTALLAT ON CONTENTS the sample the sample Exit Progr the sample the sample ndent DLI the sample Table AFCP2PLT PGM Source for AFCP2RCF PGM Source for RACF users AFCP
245. aos PV ee aoe is dog eae aa earl a Se hale ea eats ee v nnnnn X Dieses aiei ures Se dr lee wae amp t where Cates oe Cc The 1 to 8 character VTAM applid of the target CICS region on which you want to xecute the program EXEC Indicates to the B I that this is an execute program request The program will be invoked from the AFCB transaction via an EXEC CICS LINK PROGRAM command Daenen p The user program name to execute in CICS TSGIOn Ciya S24 Ci Page 210 BATCH TO CICS INTERFACE Wo eee V The optional COMMAREA to pass to the program This area will always be passed as a 45 byte area padded with trailing blanks nnnnn This field is only required if TWA data is to be passed Size of required TWA This size will be verified against the TWA SIZE specified in the transaction definition to be sure the TWA is the size the user program expects nnnn can be from 1 to 32760 B ee E Optional data to move to the user TWA Page 211 BATCH TO CICS INTERFACE BATCH INTERFACE EXEC XCTL AND XPGM REQUESTS CONTINUED XCTL REQUESTS TO START A CICS PROGRAM XCTL requests result in CAFC s B I in LU ER Th to an th th mu th the background 6 2 and AFCI is used when th ansaction then performs an EXEC Cl e xcontrol is asynchronous and wil wait for the completion of the user program optional 45 character C XCTL PROGRAM request e AFCE tran
246. arm Start Parameters using VSAM RLS Propagate open option CAFCPARM 175 60 171 Warm Start Status Examples 186 VSAM RLS Quiesce wait option 171 187 VSAM RLS requirement 20 Warm Start under CAFC 84 VSAM RLS Set RLS DSNAME option Warm Start via the AFCT WARM 60 170 transaction 317 VSAM Shared Resources Control 276 WARMDCT DCT Warm Start Parameter Vtam ACB for the B I Samples 202 Irap AES 254 WARMFCT FCT Warm Start Parameter Vtam APPLID Default for B I 193 175 VTAM APPLID DETERMINATION 192 WARMOTR Other Type File Warm Start Vtam APPLID Override 192 Parameter 175 Vtam Cross Domain APPLID WARMPCT PCT Warm Start Parameter definitions 205 175 Vtam Naming Conventions 202 Warning Message Option 134 VTAMDEV parameters 17 Warning Message Option 132 VTAMLST requirements for B I 254 WTO Customization Options 84 85 Warm Start controlled by DRS 129 130 values 178 182 WTO receiver file 129 Warm Start DRS summary 181 XCTL B I request to start a CICS Warm Start File Lock indicators program 36 232 52 XPGM B I request to start a CICS Warm Start ignoring for a single program 233 item 183 XPGM Request for starting Warm Start Matrix Description programs 36 183 186 CICS APPLICATION FILE CONTROL FACILITY RELEASE 4 5 NSTALLATION MANUAL CICS Versions TS 1 3 3 2 REVISED May 2007
247. as been reached The W option will cause the issuing terminal to be locked until the recall completes Similar requests from other terminals that generate a recall will begin processing and also wait That is the terminals will be locked out for other input until the completion of their recalls If N is selected for this option CAFC will return to the calling program with a message indicating an HSM recall is in progress while the recall and request continue processing A return code of 08 will be set This allows other terminal activity to continue Default value is gt N Page 130 HSM OPTIONS CAFC FEATURES AND CONS CONTINUED MIGRATION IDENTIFIER The ident catalog AT PLTPI TIME IF DSN IS MIGRATED DERATIONS ifier HSM DMS etc inserts into the volume serial in the to identify data set as migrated Default value is gt MIGRAT CAFC offers several options for handling data sets that are migrated when a CI critical S CS region is started Some of these data sets may be to an application s ability to execute properly Skip the request If a CAFC request to open or allocate a data set is issued by AFCPWARM or AFCPOVER and the data set is migrated the request will be skipped Recall the dsname If a CAFC request to open or allocate a data set is issued by AFCPWARM or AFCPOVER and the data set is migrat
248. associated load Of course some number of CEMT NEW COPY commands will likely have to be performed RPL LIST REQUEST MENU PANEL 208 REQUEST TABLE TYPE SHOW TYPE MENU NAME S PLAY STATUS BLANK DISPL IST RPL ENATE DFHRPL ORPL DFHRPL NOTE CAFC will automatically ensure that the largest block size of all the RPLs is associated with the first RPL in the Page 47 DFHRPL concatenation CAFC FEATURES AN DFHRPL LIBRARY MANAGEMENT CONTINUED DISPLAYING DATA SETS IN THE CURRENT DFHRPL D CONS DERAT ONS To display the contents of the current CICS DFHRPL concatenation use the CAFC STATUS function with a TABLE TYPE of AR and a NAME of DFHRPL RPL APPLICATION REQUEST MENU PANEL 208 REQUEST gt S TABLE TYPE gt AR SHOW TYPE MENU NAME gt DFHRPL S DISPLAY STATUS BLANK DISPLAY LIST RPL RECONCATENATE DFHRPL ORPL RE OPEN DFHRPL When you use the S request the CAFC TABLE TYPE and NAME must be DFHRPL as CAFC APPLRPL shown above tion List name They refer to the effect at the time of the request WARM STARTING AN DFHRPL CONCATENATION CAFC s Early Allocation Program for the concatenation saved in DFHR
249. atch jobs during th tion entitled MULTIPLE LU NAMES terface st communicating wit req See the following CICS regions In have the termination of are running on the are This option often IQUE VTAM ACB teps that th the same serialized You will experience PLE LU names BATCH TO C CS NTERFACE BATCH INTERFACE CONTINUED MULTIPLE LU NAMES FOR EACH REGION This option is an extension of the UNIQUE VTAM ACB option described on the previous page The B I ACB table AFCT2016 can be optionally coded with a list of additional logical unit LU names to be used by AFCP2016 Before attempting to establish a session with a CICS region AFCP2016 reads the AFCT2016 table for ACBs that can be used to communicate with the target CICS region Via enqueues it searches th ligible LU names until it finds a non busy LU name The multiple LUs allow simultaneous sessions between concurrently executing B I programs and the same CICS region This allows a high level of multi processing for batch requests against the same region If the end of the LU name list is reached AFCP2016 waits for a user specified interval of time and then reprocesses th ligible LU names in the list After the list is traversed a user specified number of times AFCP2016 issues a WTO stating that it has not been able to detect a non busy LU name The Batch Interface will continuou
250. atic Disable on an FREE AF4RLS The 1 byte code to designate an RLS dataset AF4TDDES The 4 byte code for CICS DCT Destination Id Applicable for Non VSAM record only AF4TDTYP The 1 byte code to designate transient data type ndirect N Intra R Remote X Extrapartition AF4NRSUF The 2 byte suffix for non resident DCT entries Applicable to non VSAM records only Not used for CICS Version 3 AF4PDSMB The 1 to 8 byte PDS member name AF4RETCD The 2 byte numerical return code 00 Successful Completion 02 Invalid Request 04 Invalid Entry Type 06 Entry Name Not Found In Table File 08 Dataset Name Change With Oldnode Newnode Data entered 10 Oldnode Newnode not entered 11 Matching node not found 12 Invalid Disposition 16 Invalid Free at close time option 18 Invalid Automatic Allocation Option 19 Invalid automatic enable option alloc 20 Invalid Automatic enable option open Page 282 MAINTENANCE AND CONVERSION AIDS LINKING TO THE TABLE FILE MAINTENANCE FACILITY CONTINUED 22 24 26 29 30 31 32 34 36 38 40 42 44 46 48 50 52 54 59 56 58 AF4MSGNO AF4MSGTX AF4PAPTR AF4USRID AF4MSG AF4BIRC No Change Not Valid Data Entered For Vsam Records Invalid record type FCT in dsn with RLS Y New data set name greater than 44 bytes
251. ating CAFC s Extended Initial Open and Implicit Open FCT Support There are two procedures that activate CAFC Extended FCT support STEP 12A Check to see that module AFCP2010 is placed in the PLTPI after DFHELIM so that it runs during the third stage of CICS initialization During PLT processing AFCP2010 transfers control to AFCP2FCS which will establish the needed interface for FCT activity The FCT intercept logic is built into the AFCP2FCS module As with Extended support will FCS63 FCS64 the PPT DCT PCT FCT support the Extended Initial Open and Implicit Open FCT load one of the following modules FCS53 FCS61 FCS62 or FCS65 These CAFC programs must be marked RES YES in Page 14 NSTALLATION PROCEDURES DETAILED INSTALLATION STEPS CONTINUED STEP 12B Go to the CUSTOMIZATION OPTION MENU select the symbol for SUPPORT EXEC CICS Enter a Y for INITIAL OPEN to activate Extended Initial Open FCT Support Enter a Y for IMPLICIT OPEN to activiate Extended Implicit Open FCT Support The interface allows CAFC intercept Initial Open requests from CSFU and Implicit requests to open FCT entries from outside transaction and perform allocations for the associated datasets and to monitor FCT status change activity and to update the CAFC Table Fil
252. ble Entries ation Group Table Entry and all associated CAFC Application Table Entries and CAFC CICS D CAFC CICS associated RPL List Applrout Li Sublist Lis Global Rout Message Cus Userid Entr Entry Name Table Fil st ts e entry t entry ies Valid Entry Name on the Dname Entries DBD DDname Table Entry and all DDname Table Entries Input CAFC Generic specifications are valid Fases a r Replace Option REPLACE If a selected entry already exists on the Output CAFC Table File replace it with the entry from the Input CAFC Table File NOREPLACE If a selected entry already exists on the Output CAFC Table File DO NOT replace it with the entry from the Input Table File X X DSN search string 1 28 DSN character search string which you want to be replaced with the DSN replace string This string can appear anywhere within the DSN of a CAFC CICS DDname Table Entry If this search string is found it will be replaced with the DSN replace string NOTE Only the first occurrence within a DSN will be replaced However multiple DSNs may be affected by the change if the transfer request is against an application or group This is useful for doing node changes against data set names in an application or group Yey DSN replace string 1 28 DSN character replace string
253. cated disabled allocated unenabled free free enabled free disabled free unenabled Page 168 ICS STARTUP CONS DERAT ONS DESIRED RESTART STATUS DRS TUTORIAL CONTINUED WARM START OPTIONS DESCRIPTION The warm start options operates in this manner in the left column the next CAFC warmstart in the CUSTOMIZAT WARM then set the way you wish The actual warm start locate the DRS Open Status the file to be restored on options are user defined EFFECTIVE WARM START STATUS EWS The addi the tion these Screens displ lay th Thus you can immediately eval values directly on the Edit Screen customization options ffectiv ON OPTIONS panels FCT WARM START START and OTR WARM START DRS values are displayed on both the Edit and Browse Screens warm start DRS values processed through all of your CAFC warm start options DCT WARM START PCT In EWS which is luate the effect of your warm start override Whenever you change the warm start you can review the Browse Screen and see what effect your new warm start options have on a particular CAFC entry EXAMPLE CAFC WARM START MATRICES Using the following example the CAFC FCT warm start matrix will elect a rapid CAFC FCT warm start
254. ce at least one Audit Trail DD statement in the start up JCL similar to the following CAFCCSMT DD SYSOUT DCB BUFNO 1 AUDIT OPTIONS CONTINUED Page 118 If you decide to use the CAFC FEATURES AND CONSIDERATIONS system logger for the audit destination from CICS you will need to define a JOURNALMODEL for each one All 6 of the CAFC Audit logs can go to the different system logger j same system logger journal or they can each go to ournals Below is an example on how to define a JOURNALMODEL to the CSD using the CICS Resource Transaction CEDA CEDA DEF GR CSDGROUP JOURNALMODEL GROUP DESCRIPTION JOURNALNAME STREAMNAME LOGRLCOR is the journal n Option under Audit Logs JOURNALMODEL LOGRLCOR LOGRLCOR CSDGROUP LOGRLCOR LOGGER TEST PROGRAM ame you specified in the CAFC Customization Logger Test Program is the dsname of the MVS system logger file The n logger dataset can be def system logger files can b new dsname CAFC privides a facility ame here can be a maximum of 26 bytes This ined using CAFC installation member DEFLOGR New e defined by using this sample job Just use a for viewing the system log via TSO Review the section titled CAFC s TSO SPF Log Viewer for information on installation and usages of this facility Page 119 CAFC
255. ch Association Table AFCT2016 must be assembled to relate the ACB to the appropriate CICS region VTAM applid An entry MUST be coded to relate each CICS region to the correct LUO ACB name which will eventually establish a session with the appropriate LUO terminal within CICS The following is an example of the correct coding for a single LUO entry in the AFCT2016 table AFCM2016 CICSID XXXXXXXX X BATCHID YYYYYYYY x LUO Y Where XXXXXXXX is the VTAM applid of the CICS system Where YYYYYYYY is the VTAM ACBNAME from the LUO VTAM APPL LUO Y is REQUIRED to indicate this definition defines a session for the Batch Terminal LUO processor To improve Batch Interface performancem increase simultaneous processing you can provide MULTIPLE LU NAMES in the following way 1 Code a list of values for the BATCHID parameter For example AFCM2016 CICSID XXXXXXXxX x BATCHID lunamel luname2 X LUO Y Page 224 BATCH TERMINAL PROCESSOR STEP 4 BATCH TO CICS INTERFACE If you wish to secure INSTALLATION STEPS CONTINUED transactions that are initiated under the LUO Batch Terminal Processor select the appropriate method below for your specific security system RACF ACF2 CAFC will force BTP initiated transactions to executed in CICS under the security profile of the RACF userid of the initiating batch job This is controlled by a p
256. ch of the thr categories FCT DCT and PCT to its state when the previous CICS session terminated This is basically what is provided by the standard CICS START AUTO SIT parameter CAFC course can do this but it would leave you with an all or nothing warm start situation of Page 166 ICS STARTUP CONS DERAT ONS DESIRED RESTART STATUS DRS TUTORIAL CONTINUED The highest level of CAFC warm start control allows you tegories will participate in CAFC s warm start DCTs and FCTs but not PCTs Choose any combination that makes sense ON OPT resource ca can choose to warm start FCTs selections on the CAFC CUSTOM ZAT ONS screens categories you normally want to be warm started For a particular CICS sess warm start resource category selections with CAFCPARM override parameters Th CAFC should warm start particular FCT entry open unenabled started as on enabled dis lowest level CAFC warm closed allocated o and also one of e of open c abled Tran disabled An specified as X to indica or a portion of the warm The middle level globally re m DRS values conversion matrix yo startup try which was in an open en be ma DRS values As an example su ur new ion start control each individual FCT you may specify that it be warm started as one of to se
257. condary dsname when allocating or opening a vsam file in the FCT associated with CUSTMST2 Page 159 CICS STARTUP CONSIDERATIONS AFCPWARM CAFC S WARM START FACILITY AFCPWARM first interrogates 1 settings 2 any CAFCOVER requests 3 present in the CAFCPARM your WARM Start Customization Option any global warm start overrides DD statement and 4 individual any warm start overrides set at the ddname and transaction level within the CAFC Table file Then it reads very resource in the CAFC Table File AFCPWARM integrates this information and determines the proper warm start status for each resource Finally it performs the status charge s required to place each resource in proper warm start status AFCPWARM honors requests that you have placed in CAFCOVER That CAFCOVER request will not be changed CAFC will normally use the parameters you have placed in CUSTOMIZATION OPTIONS panels control CICS startup by the module AFCP2010 which call may override the gl lobal startup options set in the CUSTOM via parameters foll lowing parameters are placed in the Cl the CAFCPARM sysin dd stat AFCSIP and AFCPOVER processing The actual CAFC override parameters follows CAFCPARM WARMOTR f COLDDCT f WARMFCT f WARMDCT f WARMPCT f WARMRP L f TRACE f TRIO f D D the CAFCP
258. ction Transaction Transaction IMS VS Version 5 1 lease 1 2 lease 1 lease N W Server Server Server Server Server Server WUNNNEe NOrRPWNEF W 9 1 DBCTL Page 16 SYSTEM CONFIGURAT CICS SYSTEM CONTROL SOFTWARE REQUIREMENTS The following support the C ON REQUIREMENTS DFHSG parameters must be included in the CICS sysgen to CS Application File Control facility CICS TS Versions BMSF DFHSG PROGRAM BMS UNC STANDARD DFHSG PROGRAM TCP VTAM DEV LUTYPE2 LUTYPE6 Basic Mapping Standard or Full Support Terminal Control Program Session Type 6 LU Support NOTE LUTYPE6 only required if CAFC s vtam LU6 2 B I program is to be used Page 17 CAFC RELEASE MAINTENANCE MIGRATION PROCEDURES FROM ANY BACK RELEASE UPGRADES This section contains instructions for existing CAFC users who are upgrading to not just replacing load libraries the most current releas of CAFC The load libraries for the new release should be brought up in a test environment that parallels your existing environment You should make a backup copy of your existing CAFC Table File for this test migration The following Table File generation procedure leaves your original CAFC Table File intact Run INSTO20 or INSTO2C to create a new base Table File and Message
259. default Th llowin ccc TRAN XXxx CCCCCCCCC TRAN XXXX freeform input e control card S are freef TH ON W DATA orm input is the target APPLID of communicate signifies that this t this input processed by the 1 to 4 charact user transaction you wish to run the the CICS region transaction to card is to be terminal simulator ter tranid assigned to N input stream to lies that all executions of need to See the section on included in the SYS g format beginning in column 1 IN data stream to the The first characters the character string which will be transmitted to CICS should be the transaction code This may be followed by 51 bytes of data for the The transaction processor will transaction simulate the string as if an u had been pressed specific commarea length nformatted 3270 screen and transmission of this data the data had been typed in on the enter key If user program requires a the commarea length may be entered into columns 68 69 place an N in col lumn 71 if the transaction being started does not return back to the batch terminal processor with a response D of CICS99P ICS99P TRAN iico set sys tem start Page 218 the user is sending a single transaction CO to The transaction will
260. defined RDO entries to your DFHCSD file and to add them to the GRPLIST that is installed at CICS startup If you plan to install the TCT entries via RDO please reference the next page New programs and transactions may have been added to the release you are installing Replace your old CAFCGRP with the newly installed group to insure you have all new programs and maps Modify CAFC s RDO groups per your site s installation requirements Add the new or updated groups to your CSD GRPLIST Be sure to cold start the CICS region the first time up Page 7 NSTALLAT ON PROCE DETAIL INSTALLATION STEPS CONTINUED STORAGE PROTECTION FEATURE CAFC programs mus defined with TASKDATAKEY or TASKDATALOC predefined with EXECKEY CICS both environments C B I TCT GROUPS SIGNON METHOD B I security must be IDENT your B I s secure the LU6 2 Batch CAFCONN1 CAFCLUOL CAFCTRM1 B I TCT GROUPS SIGNON METHOD ON In A CICS TS environment that is using t be defined with EXECKEY CICS FCS All CAFC programs and and TASK ATTACHSEC operand of the TERMI a signon method of NONE CAFCONN2 CAFCLUO02 CAFCTRM2 FMH5 The following TCT groups use the FMH5 signon method for CAFC LU6 2 EXCI The ATTACHSEC operand of the TERMINAL or CONNECTION entries FY for the signon method o
261. defined you must invoke the CAFC RPL LIST EDITOR to build your RPL lists Entering an AR type from the EDIT ENTRY MENU invokes the RPL List Editor You may directly invoke the RPL LIST EDITOR before creating any DR ddname entries by entering an AR for RPL lists from the EDIT ENTRY MENU This action allows you to 1 create individual DR symbolic ddname entries and 2 create or edit an RPL LIST within a single session Below is an example of the EDIT ENTRY MENU with an AR for RPL LIST in the TABLE TYPE field This will invoke the RPL LIST EDITOR EDIT ENERY MENU 4 2 2 2 OOO SRe Seas CAFC PANEL 202 ENTER VERIFY PARAMETERS BELOW TABLE TYPE gt AR ENTRY NAME gt BLANK FOR ENTRY SELECTION LIST TYPE TABLE DESCRIPTION TYPE TABLE DESCRIPTION D ALL DDNAMES T DLI DATABASE LISTS DD FCT DDNAMES T TRANSACTIONS DT DCT DDNAMES A APPLICATION LISTS DU USER EXIT DDNAMES AR RPL LISTS DO NON CICS DDNAMES G GROUP LISTS DR RPL DDNAMES U USERIDS DI IGNORE DDNAMES RL MESSAGE FACILITY ROUTE LISTS SL MESSAGE FACILITY SUB LISTS GL MESSAGE FACILITY GLOBAL ROUTE LISTS PF1 HLP PF2 2ND SES PF3 END PF4 RET PF9 ALT SES
262. des the length value in the global definitions Default value gt 56 The fields labeled FUNCTION RC TEXT and ATTRIBUTE all define one complete message unit as they were for the global definitions There is one message unit described per line on the rest of the input screen REQUEST This gives the event that is to trigger the message facility The request may be entered anywhere in the request field as long as it is one of the accepted request values This is a required field The following list contains the valid request values Open O OP OPE OPEN Close C CL CLO CLOS CLOSE Allocate A AL ALL ALLO ALLOC Free F FR FRE FREE Enable FCT DCT Entry EF Disable FCT DCT Entry DF Enable Application Transaction E EN ENA ENAB ENABL Disable Application Transaction D DI DIS DISA DISAB Open Files and Enable Transactions OE Disable Transactions and Close Files DG Enable DL I Database DBD Recover DL I Database DBR Assign Read Only RO Assign Update UP UPD UPDA UPDAT Assign Read RD READ Assign Exclusive EX EXC EXCL EXCLU Status Display S7 oly STA STAT STATU Display Activity Counts K Reconcatenate DFHRPL RPL Re open DFHRPL ORPL Synchronize Restart Parameters SYNCH Page 148 CUSTOMIZATION OPTIONS
263. ditional DFSAOEOO exits to be called The exits will be called in the order they are found in the AOEEXTNM table Page 54 TYPE SFI NAL RETCODE GNORE RETCODE SEND The following JCL can be used to create the CAFC FEATURES Indicates this is AOEEXTNM table AND CONS DERAT ONS the last SAOEEXIT macro in the This indicates that the return code from the DFSAOEOO exit shou This indicates DFSAOEOO exit shou one RETCODE SEND c table IMS ld not be passed back to that the return code from this ld be passed back to IMS an be coded in an AOEEXTNM Only DFSAOEOO driver module See install library member DFSAOEDR for sample jcl Remember to recycle the DBCTL region once you have relinked th Xit jobcard ASM EXEC PGM ASMA90 SYSPRINT DD SYSOUT SYSLIB DD DISP SHR DSN cafc maclib SYSLIN DD DSN amp amp OBJ DISP PASS UNIT SYSDA SPACE TRK 10 1 DCB RECFM FB LRECL 80 BLKSIZE 3040 SYSUT1 DD SPACE 4096 120 120 UNIT SYSDA SYSIN DD SAOEEXIT macros go here LKED EXEC PGM HEWL PARM XREF LET LIST NCAL SYSPRINT DD SYSOUT SYSUT1 DD DISP DELETE SPACE 1024 120 120
264. ds to one or more MVS CAFC provides an ISPF based program that will give users the ability to browse these log records To invoke the CAFC Log Viewer the user must be logged on with a TSO procedure that has been modified to Log Viewer The following displays an ISPF primary option panel that has been modified to support the CAFC log viewer support the CAFC mosi wan omara Pres Menu Utilities Compilers Options Status Help ISPF Primary Option Menu Option gt _ Settings Terminal and user parameters User ID UZTECB 1 View Display source data or listings Time 08 09 2 Edit Create or change source data Terminal 3278 3 Utilities Perform utility functions Screen 4 Foreground Interactive language processing Language ENGLISH 5 Batch Submit job for language processing App ID ISR 6 Command Enter TSO or Workstation commands TSO logon NTECTEST 7 Dialog Test Perform dialog testing TSO prefix U2ZTEC8 8 SOSF Spoo Display and Search Facility System ID NICI 9 IBM Products IBM program development products MVS acct NONEX 10 SCLM SW Configuration Library Manager Release ISPF 5 5 11 Workplace ISPF Ob ject Action Workplace C CAFC CAFC Log Stream Browser I IMS OPER IMS TSO Operator Interface L Loco Logical Console Operator Interface M More Additional IBM Products Enter X to Terminate using log list defaults 00 1 04 14 Eonnectnd bo bost 10 11 20 ELI Selecting option C_ and pressing ent
265. e ENABLE WITH ALLOCATE If this option is set to Y enabl Enab e to occur e Default value Disable flag set to Y gt Y DISABLE WITH CLOSE If this option is set to Y CAFC will automat DCT whenever a CAFC close request is issued disable to occur the ddname must also have Disable flag set to Y Default value gt Y DISABLE WITH FREE If this option is set to Y the ddname must also have the Automatic Enable the ddname must also have the Automat the Aut CAFC will automatically disabl tically enable an FCT or For the automatic enable Disable flag CAFC will automatically enable an FCT or DCT whenever a CAFC allocate request is issued the automatic ELG For tically disable an FCT or For the automatic tomatic Enable e an FCT or DCT whenever a CAFC free request is issued or whenever the FCT or DCT file is freed due to a close request and the For the automatic disable to occur Automatic Enable disable flag set to Default value gt Y heh OE ALWAYS ENABLE TRAN If this option is set to Y CAFC will always associated with an OE OPEN ENABLE associated with that application request rec FREE CLOSE flag is Y the ddname must also have the enable the transactions request even if the files ived Default value gt Y REQUEST OPTIONS CONTINUED Page 125 rror
266. e AFCF4000 must be closed to the CICS region while running the AFCP2023 conversion program To close the Table File issue the AFCT SHUTDOWN transaction For more details review the section on Closing the CAFC Table File in the chapter entitled OPERATIONAL CONSIDERATIONS Page 287 MISCELLANEOUS CAFC UTILITIES UTILITY SERVICES MENU The CAFC UTILITY SERVICES MENU is an on line interface to a collection of programs and transactions that provide CAFC Table File maintenance facilities and miscellaneous operational controls functions The Menu provides convenient access to these facilities Many of these programs and transactions can be invoked directly without this menu interface After entering the item symbol for Display Utility Services option on the PRIMARY OPTION MENU the UTILITY SERIVEES MENU is displayed UTILITY S T IRVICES MENU CAFC PANEL 226 MAP P SELECT OPTION gt 1 ACT DEACTIVATE TRACE FUNCTIONS 2 CAFC STARTUP AND RELATED FUNCTIONS 3 CAFC SHUTDOWN AND RELATED FUNCTIONS PERFORM A CAFC WARM START DFHRPL MODULE LOCATE REQUESTS D T e5 DNAME ENTRY MAINTENANCE FACILITY XTENDED CAFC RECORD MAINTENANCE FACILITY T JOU A T T
267. e specified terminal transaction is scheduled with no terminal specified It then builds message table entries to indicate the If no terminal is requested the completion of the scheduling operation RPL scan program CAFC User Message Facility Supervisor Program Facility Customization Program Function Customization Program CAFC Message CAFC Message CAFC Message CAFC Messag Applicat tion Routing List Edit Program Sub Lis CAFC Message CAFC Message CAFC Message CAFC Message t Routing Edit Program Facility Message Send Edit Program Facility Message Destination List Build Application Routing Program Routing List Browse Program AFC Message Global Routine List Edit Program Z EE Z AFCP2 AFCP2 AFCP2100 CD CO ODOC e e E e e D S e O E a LO Os CO N AFCP2 CAFC EXEC XCTL User Program Initiation Program gt Z z CAFC Initial z 2 Open program CAFC Initialization program O OOTOLO OOO OO O70 0O Z wE o A A A A A a d d A a a SES 2 CAFC Function program Directs functions to appropriate program Z et Z AFCP210 AFCP210 AFCP210 AFCP210 T AFCP21 AFCP22 OOWO 00T WN AFCP2210 AFCP2300 AFCP2400 AFCP240 Z CAFC Record Report supervisor program CAFC record report program a 2 CAFC RDO requ Z Z wE
268. e DDname record flags for enable disable open close status NOTE You may deactivate CAFC s extended initial and implicit FCT support by changing the applicable options to N Activation of extended DCT PCT FCT support and LPA YES requires th removal of CICS programs DFHAIPxx and DFHEIPxx from the LPALIB to avoid a U601 ABEND at startup Page 15 SYSTEM CONFIGURATION REQUIREMENTS CAFC HARDWARE REQUIREMENTS CICS Application File Control facility can be used on an IBM processor such as the IBM System 370 303X 308X 309X 43XX 90XX systems or IBM plug compatible mainframes with main and external storage capacity and peripheral LSS S2 quipment capable of operating with OS VS2 MVS and Z OS CICS TS CAFC SOFTWARE REQUIREMENTS The CICS Application File Control facility Release 4 5 is compatible with the following OS VS2 OS VS2 OS VS2 OS VS2 OS VS2 OS VS2 OS 390 MVS SP1 MVS SP2 IBM system control software MVS Release 5 x MVS Release 3 8 MVS XA MVS SP2 2 MVS XA MVS ESA and PR SM All Releases z OS ALL Releases VSAM Rel DFEF ACF VTAM ACF VTAM ACF VTAM ICS ESA ICS ESA ICS ESA ICS ESA ICS ESA ICS ESA Oi 1 OOO DFP All DFHSMS Al ease 2 releases l release Version 2 Version 3 Version 4 Transaction Transaction Transaction Transa
269. e front of your CAFC release cartridge If you installed CAFC using a CD Rom or FTP download this step can be bypassed The install library was installed during the unpackaging process INSTLOOO JOB ACCT INFO KKEKKKKKKKKKK KK KK KK KKK KKK KKK KKK KKK KK KKK KKK KKK hfe RESTORE THE CAFC INSTALLATION LIBRARY TO DISK A e e e E a E a a a E a a a a E a a a a a E E a a a a a a E a a E STEP0001 EXEC PGM IEBCOPY SYSPRINT DD SYSOUT SYSUT1 DD DSN CAFC R4500 INSTLIB DISP OLD KEEP ea UNIT TAPE LABEL 1 SL EXPDT 98000 VOL SER XXXXXX SYSUT2 DD DSN CAFC R4500 INSTLIB DISP NEW CATLG DELETE Lf UNIT SYSDA SPACE TRK 30 5 15 RLSE DCB RECFM FB LRECL 80 BLKSIZE 3120 VOL SER usrdsk SYSIN DD COPY I SYSUT1 O SYSUT2 STEP 2 UNLOAD THE CAFC LOAD LIBRARY AND MACRO LIBRARY Restore the C both actions AFC LOAD library and MACRO library to a DASD unit Move CAFC sS internal authorization module to an authorized library in the CICS steplib Use the following member from the CAFC R4500 INSTLIB to perform INSTO45 for restoring CAFC 4 5 load libraries If you installed CAFC using a CD Rom or FTP download the loadlib and maclib libraries were installed during the unpackaging process Run INS
270. e messages using option 6 on the CAFC Message Facility from the CAFC Main Menu However U4 cannot update any defined message associated with CAFC applications or groups USER Ul may browse and update messages associated with CAFC application UFILES Page 113 CAFC FEATURES SECURITY OPTIONS CONTINUED AND CONSIDERATIONS USER U5 is an operator His profile is a generic profile or rule that allows him to issue CAFC requests in both regions and browse files in both regions He can not modify any CAFC resource U5 does not have access to definitions through the edit function the Customization Options CONTROL access in ACF2 propagates downward so that when a user has CONTROL access over a CAFC group he is considered by CAFC to have CONTROL access over the component CAFC applications whenever a request is issued for that group In the same fashion CONTROL access over a CAFC application extends to its components when requests are issued for the application Whenever a user issues a request against a CAFC group the group name is checked with ACF2 for CONTROL access and the request proceeds with no further ACF2 checking for the component applications Some operations on CAFC are reserved for MASTER access performing SYNCH requests performing RPL ORPL requests accessing utilities services menu AANA OT BWNE USER W
271. e msg facility set type at close time Automaitc enable on allocate Automatic enable on open Automatic disable on close Automatic disable on free Warm Warm Warm start override 1 start override 2 start override 3 eS See ai eer te eg Z DD REQUEST DCT ddname D requests use optional parameters following the entry name D D D STYPE TDTYPE DESTID DATA SET NAME DSTYPE is 2 bytes TDTYPE is 1 yte DESTID is 4 bytes and DATA SET NAME is 44 bytes DTYPE Transient Data Type values are ndirect N Intrapartition R Remot X Extrapartition Example 1 ADD Request CICSREG1 ADD DD NEWDDN A new ddname record would be added to the CAFC Table File using the defaults described above Page 207 BATCH TO C CS NTERFACE B I BATCH INTERFACE JCL AND COMMAND LINE FORMATS CONTINUED B I CAFC TABLE MAINTENANCE REQUESTS CONTINUED Example 2 ADD Request CICSREG1 ADD DO NEWDDN NTEC VSAM CAFC1000 TESTFILE A new ddname record would be added with a data set a data set name of NTEC VSAM CAFC1000 TESTFILE Example 3 ADD Request CICSREG1 ADD DD NEWDDN NTEC VSAM CAFC2000 TESTFILE A new ddname record would be added with a data set record type of 1 and a data set name of NTEC V
272. e tha definition for SEQX member TCTSEQX the sequential terminal in the C n urpose the Sequen t th CS via the Be su has been provided in the CAFC install turn code for batch job step if terminate is selected for the CICS ABEND The default ret urn code is mply change nsure that DFHPCT table with a program of AFCP211 The B I on tial Terminal the B I the desired transaction code has been a sequential If you wish 176 transaction code of AFCX to communicate with its is scheduled If you wish to change XPGM REQUEST Transaction Code Q terminal is needed for uses a default sequential terminal id to change this B I terminal id ID for XPGM Request option on this desired sequ DFHTCT table ntial terminal definition has been A sample sequential terminal library as re to include the input and output dd statements for XPGM REQUEST TIMEOUT VALUE CS startup JCL After the Batch Interface Program AFCP2016 schedules the AFCX transaction via the XPGM request it sets a timeout value with a default of 5 minutes If the program being started does not complete in 5 minutes the batch job will terminate with the message TIMEOUT WHILE LINKED TO XXXXXXXX where XXXXXXXX is the program being linked to The value is given in the following format 00000000 hhmmss
273. e the CAFC indicat e missing libraries The changes have been indicated below The lines of information that have been removed to shorten the J RRR RRR KKK KKK KK KR I I I I I I I OR KK OK ISPF FULL FUNCTION LOGON PROC J RRR RRR KKK KK KK KK KK I I I I RR I I A I kk KJI SIS EFTO1 R PFCL DSN IS DSN IS DSN SYS1 HEL EGION 0M DYNAMNBR 175 HR DSN your load pds Addition of CAFC STEPLIB DSN SYS1 UADS DSN SYS1 BRODCAST DSN SYS1 LOCAL CLIST P SISPCLIB p P SISPEX EC DSN SOMMVS SGOSREXX DSN IS P SIS DISP SHR DSN your ispf ispmlib Addition of ISPMLIB DISP SHR DSN ISP SISPMENU ISPFPROC EXEC PGM I PARM STEPLIB DD DISP S SYSUADS DD DISP S SYSLBC DD DISP S SYSPROC DD DISP S DD DISP S SYSEXEC DD DISP S DD DISP S SYSHELP DD DISP S DD DISP S ISPMLIB DD DD DD DISP SHR DSN SYS1 DFQMLIB Page 302 ISPEXEC DD DISP SHR DD DISP SHR ISPLLIB DD DISP SHR MISCELLANEOU DSN GDDM SADMMOD DSN ISP SISPEXEC DSN SYS1 SBPXEXEC S CAFC UTILITIES ISPPLIB DD DISP SHR DSN you ispf ispplib Addition of ISPPLIB DD DIS DD DIS DD DIS ISPSLIB DD DIS DD DIS P SHR DSN SYS1 LOCAI P SH
274. each of the target regions termines which ACBs should be u assembled your batch job steps gain direct The B CAFC Table files for two reasons the processing flag reso update procedur target region s B I S urces due to bat etc progress proper Use INSTL CICS APPLI Step 8 If the B I already install APPLI ly OPT ed nsures B member ASMT2016 as D Association Table Second IONAL STEP is to be used in an Resources must be defined UNLESS the VTAM On the CPU where the target CICS execu Ds representing the B I your B I This table has for the B I AFCF400 sed by each B I nterface First processing option it must u tch request changes WHEN THE C that CICS region a sample AFCT201 JCL code and assemble the B I two functions First it so that it can directly 0 Table Files Second it job Once AFCT2016 is access to each target CICS job steps must access the target the Batch Interface must read s eg wait times region down pdate the status of CICS CS REGION IS DOWN startup and warm start will This Assemble and link edit CAFC s VTAM defined as cross domain resources CAFVT71C and CAFVT72C for additional Step 9 deals with B I REV programs executing on different CPUs IEW ANI CROSS DOM
275. ecurity 33 Open Status controlled by DRS 180 OPENTIME STARTUP early allocations 27 OPENTIME STARTUP FCTS 20 OTH Warm Start Options 89 Other Type File Warm Start using CAFCPARM 175 Override request processing 173 174 317 overriding connection type 219 overriding exci time interval 219 overriding exci wait time 219 Overriding Warm Start Options via CAFCPARM 175 PASSWORD Default 10 PCT activating extended CAFC support 144 PCT DRS field status 180 PCT extended CAFC support 311 PCT Extended CAFC Support 4 13 PCT Warm Start Matrix 187 PCT Warm Start Options 84 PCT Warm Start using CAFCPARM 175 Performing a DFHRPL Concatenation 48 PF Key Simulation from the B I 239 240 PF Key definitions for Customization Options 84 PLTPI role in Warm Start 175 PPT RES requirements 12 15 Primary Option Menu 82 problem determination 361 Program Function Key simulation from B I 236 Programmatic interface to CAFC 282 r 34 RACF Class Descriptor entries 115 RACF Profiles MASTER 116 RACF Profiles OPER 117 RACF Profiles USER 117 RACF Router Table Entries 115 RACF Security 33 248 RACF Security for the B I 8 RDO definition for the B I 265 RDO entries for CAFC 5 RDO requests 83 Recall at startup options 143 Recall commands require APF Authorization 14 Recall timeout values 142 Recall w
276. ed the dsname will be recal or allocated Recall and allocate the dsname If J led but neither opened a CAFC request to open or allocate a data set is issued by AFCPWARM or AFCPOVER and 2 the data set is migrated then the dsname will be recalled allocated and opened This may cause region startup delays if the number of migrated data sets is substantial Obey the automatic allocation setting in the ddname record Page 131 CAFC FEATURES AND CONSIDERATIONS SUPPORT EXEC CICS The information below controls CAFC s expanded support for 1 user written program calls to the EXEC CICS interface and 2 CEMT set commands that change the status of DCT DLI PCT and FCT resources PROVIDE EXTENDED SUPPORT FOR INTERNAL CICS FUNCTIONS DBCTL gt Y Y SUPPORT CAFC REQUESTS TO DBCTL DATASETS N IGNORE THESE REQUESTS EXEC CICS SET FILE gt Y Y SUPPORT SET FILE COMMANDS OPEN CLOSE ENABLE DISABLE FROM CEMT AND PROGRAMS N IGNORE THESE COMMANDS RECORD LEVEL SHARING gt Y Y SUPPORT CAFC REQUEST PROPAGATION AGAINST RLS VSAM FILES ENABLE OPEN DISABLE FREE N DO NOT SUPPORT REQUEST PROPAGATION FOR RLS FILES IMPLICIT OPENS
277. eed to CAFC Batch increase th timeout value for a se use a sySin data set for your requests Interface with a sysin dat stepname EXEC or CAFCPARM DD TIMEOUT hhmmssth PGM AFCP2016 PARM SYS INCREASING THE ENQUEUE WAIT INTERVAL In the same fas overridden via parameters is hion the Multiple LU name enqueue wait in the LUTIME keyword parameter and th be overridden via the LUMSG keyword parameter PARM LUTIME hhmmssth LUMSG nn or CAFCPARM DD LUMSG nn Below is t of requests the JCL to invoke the ta set and an override timeout value N T MEOUT hhmmssth terval can be messag The format DELAYING THE PRESENTATION OF THE B I STEP S RETURN A time delay may be invoked by entering the DELAY is executed after the last CAFC request DELAY parameter is The format of t he PARM DELAY hhmmssth or CAFCPARM DELAY nn B I EXECUTION JCL AND COMMAND LINE FORMATS CONTINUED FORCING USE OF If you wish to THE DEFAULT ACB force the B I connect to the this parameter target C is set to yn A the B I program to use ICS regions use the Page 198 DELAY keyword parameter the default B I CICS62I you must frequency can of these ACB name to DEFACB keyword parameter will use The and the return code is zer
278. el 21M is set to Y and 2 ENABLE FUNCTION MESSAGES on CAFC Global customization panel 21M is set to SY The automatic message facility for a unique application is activated LES 1 ENABLE FUNCTION MESSAGES on CAFC Application customization panel 21N for the desired application is set to Y The CAFC user message facility only is activated if 1 ENABLE ALL MESSAGES on CAFC Global customization panel 21M is set to Y and 2 ENABLE FUNCTION MESSAGES on CAFC Global customization panel 21M is set to N Page 68 AFDB Transaction The AFDB transaction provides users the ability to start or sil e with a single command versus the mul Control C ICS interfac transaction transaction interaction DBC transa capability xecute the C actions that AFDB AFDB CONnect AFDB DISconnect AFDB DISconneci CONnect IMMedi SUFfix WA ISconnect DBCtlid Ittime the CDBC SUF con DI tra The tra con or tra CAFC FEATURES AND CONS tha fix xx WAIttime t IMMediate ect CICS to n saction DI n n n D n saction t is necessary wit The AFDB transaction utilizes that was introduced in Cl t DBCtlid iiii DERAT ONS WAIttime tt WAIttime tt Sconnect key word re
279. ens external securi tune the built in access control external security program in a CICS Command Level COMMAREA external security 1 Review Select subroutine NSTLIB PDS Security Module system__ Name RACF AFCP2RCF ACF2 AFCP2ACF Top Secret AFCP2TSS All of the above sample sec modified 2 Each sample external securit two tables UI CAFC also c FEATURES AND ontrol S Ther CONS DERAT ONS Lied external security exit access to the CAFC Customization The security exit reformats all CAFC requests for your ty package via a parameter list You may wish to fine If you elect to use your own it must be able to process a parmlist passed ar seven steps to activate the source code for the sample security exit programs below the sample program and the APF authorization type that most closely supports your security requirements the subroutine MSTR and its two tables UI Review the source for DTBL and QOI DTBL The SEC invokes your external security system The following example security exit programs are found in the main security optional Wi tain your region operid or userid mus We recomm allowed to access th These tables control Customization Option DTBL and OI DTBL Assembly JCL Member Au Me thod thorization ASMP
280. equential terminal id If you wish to change this B I terminal id Sequential Terminal ID for XPGM Request option on this panel Ensure tha defined to CICS vi definition for SEQX member TCTSEQOX B t the desired sequential terminal definition has been a the DFHTCT table A sample sequential terminal has been provided in the CAFC install library as e sure to include the input and output dd statements for the sequential terminal in XPGM REQUEST TIMEOUT VALUE After the Batch In of 5 minutes If the CICS startup JCL terface Program AFCP2016 schedules the AFCX transaction via the XPGM request it sets a timeout value with a default the program being started does not complete in 5 minutes the batch job will terminate with the message TIMEOUT WHILE LINKED TO XXXXXXXX where XXXXXXXX is the program being linked to The value is given in the following format 00000000 Default value SECURE CEMT TRANS hhmmssth Issue QUERY SECURI Default value FORMAT OUTPUT DATA When a LUO TRAN re TY check quest is displayed unformat ted just output data format ted into Default value is N 00050000 when BATCH CEMT command request is issued processed the received response data is as it is returned in the buffer To have the screen format specify Y f
281. er starts the CAFC Log Viewer and the following screen will be displayed Page 310 MISCELLANEOUS CAFC UTILITIES ziaz comeomnsrenenencoenromenmnenrnmneneomamnes CAFC REL 4 4 08 ISPF LOG VIEWER Command gt _ USERID U2TECB Log Stream Name to View TEST LOG STREAMI TERMINAL 3278 TIME 08 12 Specify Selection Filters DATE 05 08 27 CICS APPLID Job Name Job Number Start Date Start Time End Date End Time Userid Terminal Log Tupe CR ER EC CO SV SR Record Type Resource Name Trace is active A licensed proprietary product of NETEC International Copyright 2005 t 00 1 03 15 Eorna to honk 10 1 1 20 nm This screen is the main log stream selection screen for the CAFC ISPF Log stream Viewer The user must specify the name of the Log Stream that _ is to be displayed Optionally additional selection criteria can _ be specified that will limit the log records that are going to be displayed By specifying the log stream name and pressing enter the MVS log stream will be scanned and any CAFC log records that meet the selection criteria will be displayed to the user The following screen will result while the log _ stream is being scanned If there are a large number of log records this operation could take some time An activity indicator will spin on the screen as the log records are scanned Page 311 MISCELLANEOUS CAFC UTILITIES
282. ers following CAFCPARM DD may be in any order You may omit any of the parameters DEFAULT CAFCPARM PARAMETERS If you omit the CAFCPARM parameters CAFC will default to the Warm Start parameters you have specified in the various Customization Option Panels If you have not updated the Customization Options the start up parameters are all initialized to N NOTE Even if your Warm Start Customization Options are all set to N and you have omitted the CAFCPARMS CAFC WILL STILL ALLOCATE certain critical files provided you are running program AFCPSIP These are files defined to the CAFC Table File that are prefixed with DFH with their Warm Start Override 1 flag set to A Start Page 162 CICS STARTUP CONSIDERATIONS DESIRED RESTART STATUS DRS TUTORIAL CAFC offers precise control over the statuses of files transactions and trans data queues during CICS startup With CAFC s status control mechanism you can reliably set your files dct trans data queue and transactions to exactly the proper status for Cold Warm and Emergency restarts The control mechanism is based on 1 th xistence of overrides at the individual resource level i e ddname level and 2 user defined global status matrices that handle normal situations This mechanism is implemented through CAFC s WARM START facility and the concept of Desired Restart Stat
283. es how the SET_CICS control card is to be used for requests against multiple CICS regions An example of 2 requests to be performed on one region CICS99P and 1 request to be performed on another region CICS99T is provided below SET_CICS APPLID CICS99P CREATE DDN KEY NEWDDN CDTTYPE D CDTDSN NEW DDN DSN CDTDISP SHR CREATE DDN KEY NEWDDN2 CDTTYPE D CDTDSN NEW DDN DSN2 CDTDISP SHR SET CICS APPLID CICS99T CREATE DDN KEY NEWDDN CDTTYPE D CDTDSN NEW DDN DSN CDTDISP SHR EXTENDED CAFC RECORD MAINTENANCE FACILITY CONTINUED Some more examples on coding extended table mantenance commands are shown below Other examples of commands are provided in the HELP documentation Page 266 MAINTENANCE AND CONVERSION AIDS for each particular command Simply issue HELP WITH xxxxxxxxx xxx where XXXXXXXXX XXxX is the command you are requesting help with Create a ddn record using a model Model is a single record key value for a model record on which to base the new record Model is an option parameter and default values will be used if model is omitted Note that CDTDISP and CDTDSN OR CDTSYCLS are required fields If they can t be taken from the MODEL then they must be provided as parms CREATE DDN KEY NEWFCT1 MODEL OLDDDN CDTAA Y CDTFREEF Y CDTDSN NEW DSNAME Create a ddn record overriding defaults CREATE DDN KEY NEWFCT1 CDTTYPE DD C
284. est simulates many of the functions of a user 3270 terminal with a keyboard The TRAN request is the BTP s method for running complex CICS transactions From a batch job the BTP can log on to a CICS region and initiate user transactions with input data streams For example many application systems require Start of day and end of day messages and responses to be input to the system The terminal processor allows CAFC users to automate these procedures in a CAFC batch interface job The Batch Terminal Processor appears as an IBM 3270 type terminal It sends 55 byte 3270 un formatted input data streams to the target CICS region The user may include as many separate input streams as he wishes The TRAN request supports conversational non conversational and pseudo conversational transactions The simulated input can be set up to send the appropriate data stream and PF keys to terminate the conversational transaction Page 217 BATCH CS TO C NTERFACE BATCH TERMINAL PROCESSOR TRAN REQUEST CONTINUED TRAN reque invoke the the CAFC B specify SY Parm Card Use the fo ecece where SAMPLE TRANSACT In the example below the CICS region with the APPLI the input data set system start C st control cards should be provided in a SYS Batch Terminal Processor This impl atch Interface in behalf of the terminal processor SIN on the PARM card or let it
285. eters Interface Program modified default e The associated Batch Interface Request b Subsequent Batch Interfac request refer to the INSTLIB member AFCP2SOxX For example othe program includes suppressed AFCP2SOX contains program Although r data passed to with the Batch run time requests should be unaffected by this the source the Interface the potential for expanded function the Sign on Sign off exit Batch Interface Request parameters VTAM APPLID of the target CICS CAFC Request Code CAFC Table Entry Type CAFC Table Entry Name The new DSN associated with a CHG request Jobname of the JOB requesting the Batch Interface Function The LU name used to represent the Batch Interface Program In many installations this information is sufficient to secure CAFC Batch Interface Requests The CAFC Installation Tape includes the source code for the Sign on Sign off exit program AFCP2SOX The sample module on the installation tape includes some logic to handle RACF ACF2 Top Secret or no external security recognition Page 229 BATCH TO CICS INTERFACE BATCH INTERFACE SECURITY EXIT The CAFC Batch Interface Program AFCP2016 invokes the default Security Exit AFCP2BSX This exit is given control for all Batch Interface requests and provides the logic to allow
286. eying of da CS transactions ts are described in the sec CS the batch job tandard CI D CONS DERAT ONS is an extension to the B tions via the TRAN request from Dah jobs used whenever a transaction generates a the response back to the initiating terminal The response is then placed in an area which can be t routes TO In contrast a response step and C tions the us initialize CI CS app retrieve da once the CAFC LU6 2 or EXC tion ent PROCESSOR TRAN REQUEST STRT reques entitled BATCH INTERFACE STRT REQUESTS Page 37 B I is s STRT reques ll start a user written or a If necessary the BTP TRAN request TCS ta tranid ta logic rather Both TRAN and STRT can be used to set lication Systems the standard tions and ts provide a TRAN s You may use and CEMT STRT Their up and running itled BATCH TERMINAL ts are described in the section CAFC FEATURE HIERARCHICAL STORAGE MANAGER SUPPORT With the incre CICS installat ased usage of IBM s Hierarchical S AND CONS DERAT ions that are not using CAF region lockout allocated Th is allocated via SVC 99 not returned t DASD from the Therefore da ta set is su tape operator to mo subsequent all To minimize th supp
287. f FMH5 tep will experience a signon error Interface s operation CONNECT I teh Ba TERMI Ba TERMI Ba NONE These TCT groups allow use of signon method NONE NAL for CONNECTION CONNECT CAFC termi TERMI optio termi TERM tch tch In NAL In NAL In ANI Batch nal NAL nal nal CAFC CAFC Batch DETAIL INSTALLATION STEPS CONTINUED STEP 4 CREATE THE CAFC TABLE FILE To create the CAFC message file Page 8 CS FMH5 DURES the Storage Protection Feature ALL and ALL CAFC transactions No change is necessary for DATALOCATION transactions have been shipped DATAKEY Cl storage protection and non storage protection for ease in running If you specify VERIFY will allow RACF to ON and SESSION entries for CAFC terface LU6 2 amp EXCI terminal D TYPETERM entries for CAFC terface LUO terminal and TYPETERM entries for CAFC terface LU6 2 terminal for B I security The entries must be LOCAL for ON and SESSION entries for the Interface LU6 2 amp EXCI AND TYPETERM entries for the Batch Interface LUO INAL and TYPETERM entries for the Interface LU6 2 terminal CAFC table file and the submit member NSTALLATION PROCEDURES INSTO20 from the CAFC R4500 INSTLIB to perform the required VSAM DEFINEs and REPRO functio
288. f CAFC detects that a data set has been migrated by command is issued to RECALL the data set gt gt gt gt gt gt featur CAFC FEATURES AND CONS DERAT ONS ONS parameters for updating DFHSM Y Y N SUPPORT RECALLS FOR MIGRATED DSNAMES DFHSM PROCEDURE NAME OF DFHSM STARTED TASK 000030 SECONDS TO CHECK FOR RECALL COMPLETION 000300 SECONDS TO ABANDON RECALL DDNAME WILL NOT BE ALLOCATED MIGRAT VOL SER INDICATING MIGRATED DSNAMES N Y SUPPRESS ALLOCATION OF MIGRATED DSNAMES N RECALL MIGRATED DSNAMES W WAIT FOR RECALL COMPLETION THEN WARM START ACTION WILL BE R S SKIP REQUEST R RECALL THE DSNAME ONLY A RECALL AND ALLOCATE THE DSNAME F OBEY THE AUTOMATIC ALLOCATION FLAG If a Y is is Default value is LE DFHSM support can be turned ON and OFF at will nabled DFHSM migrated data sets before issuing SVC 99 to allocate the data If Y is specified you must install CAFC s APF Authorization N is gt Y command the name of the Default value is gt DFHSM TY OPTIONS for Page 129 specified CAFC will not APF Authorization DFHSM a In order to issue the DFHSM cataloged procedure is required CAFC FEATURES AND CONSIDERA
289. f your CICS application files to CAFC This will enable your installation to remove all of the application DD statements from the CICS startup JCL There are two exceptions the CAFC s Table File and the CAFC Message File Th ddnames for these two files must remain in the CICS startup JCL The VERIFY step for VSAM Base Clusters and VSAM Alternate Indexes should be removed from CICS s JCL These actions eliminate potential JCL errors initiator enqueues and the time it takes for unnecessary file verifies Before deciding to remove DD statements from the CICS jobstream your processing requirements for Emergency Restart Warm Start and Cold Start need to be reviewed In the case of a Cold Start the files marked OPEN INITIAL in the DCT must be allocated before CICS attempts to open these files If your user DCT files are not already allocated the opens will be unsuccessful If you xperience open failures for these DCT files review the section entitled AFCPSIPY Early Allocation Options Follow the installation instructions for the Early Allocation programs These modules will pre allocate all DCT entries defined to CAFC before normal SIP processing begins If a dataset is migrated a recall is issued by AFCPSIP3 and allocation is skipped With CICS
290. file Now run INSTO30 to repro your production Table File entries into the new base Table File you just created Finally run INSTO70 to convert the entries in the new base CAFC Table File to the CAFC 4 5 modlevel format This updated Table File and Message file is absolutely incompatible with all earlier releases of CAFC NOTE You cannot re map a once converted CAFC Table File back to its original format After you perform the first six steps in the Installation procedure CAFC Table File will have been converted to the new CAFC 4 5 format new CAFC system and its Table File should be carefully verified using the BROWSE command Next you should compare and test features Once you have selected th include in your full installation you have completed your the old and new optional features you wish to installation Cycle each of your CICS regions at least once before placing them into production These procedures should be performed even if you are refreshing an existing CAFC Release 4 5 system Update the DFHRPL concatenation with the new CAFC load library any other libraries that contain CAFC components Interface program AFCP2016 Program AFCP2016 in a private library such If you have placed the Batch Interface as a library specified in LINKLST you must replace it with the CAFC4500 version of AFCP2016
291. find the abbreviation Interface the basic CAFC system tion can be easily verified and many of CAFC s extensive be demonstrated and evaluated for possible later in al installation of CAFC is Review the SYSTEM CONFIGURAT ON REQUIREMENTS Chapter Review the Migration Check Li CAFC release level st chapter if Follow INSTALLATION PROCEDURE Review the chapters entitled Determine which of these opti CICS and batch operations FOR THE CAFC BASE SYSTEM you are upgrading your CAFC FEATURES AND CONSIDERA I ONS onal features wo INSTALLATION PROCEDURE FOR THE CAFC BASE SYSTEM The base system installation is a 5 st installation requires seven more optio the installation steps S S 5 tep 1 tep 2 tep 3 Step 4 ep process nal steps The complete ro libraries PPT and the PLT Unload the CAFC installation library Unload the CAFC load and mac Update the CICS entries for PCT TCT XLT and the VTAM APPLI CAFC s Batch Interface facil A file has been included on CICS RDO entries for the PCT D table if you are planning ity uld enhance your Below is a summary of Update the to use See Step 8 for more details the installa PPT and TCT Use the CSI provided on the distribution Build 1 the CAFC Table Fil file AFCFMSGS with the IDC on
292. g is set As soon as you hit the ENTER key When you exit to N and if the USER SIGNON is equal maintain the CREATED BY and UPDATED BY DBD DDNAMF entries These fields will not requested the last change to I to inhibit R or A CAFC forces the SIGNON the CAFC Sign on Panel Double check the parameters are CAFC will activate the customization screen your updated security options SETTING UP RACF FOR USE BY CAFC CAFC utilizes standard C CS external security SAF interface to accomplish security in an RACF environment VERIFY EXTERNAL SECURITY IS ACTIVE External security must be active in the Cl operation system table SET VERIFY CAFC AUTHORIZATION IS INSTALLED RACF requires APF aut authorization facilit thorization ties have been installed Page 105 Insure that CAFC s APF MVS RACROUTEs and the MVS CS region for proper This can be verified by checking for SEC YES in your CI initialization to CICS with will CS The userid that the user signs on be utilized to verify CAFC requests CAFC FEATURES AND CONSIDERATIONS SECURITY OPTIONS CONTINUED SETTING UP RACF SPECIFIC PARAMETERS CAFC uses the RACF class name of SCAFC Before CAFC will function with RACF or TOPSECRET the RACF Class Descriptor the RACF Router Table and RACF profiles must be updated as follows
293. ge 268 MAINTENANCE AND CONVERSION AIDS CHANGE DDN KEY MYFCT1 MYFCT2 CDTAA Y CDTFREEF Y Change thr fields in all ddn records CHANGE DDN KEY CDTAA Y CDTFREEF Y CDTAEA N Change thr fields in all ddn type T ddn record DCTS CHANGE DDN KEY TYPE DT CDTAA Y CDTFREEF Y CDTAEA N Change one field in all ddn records named MYFCT CHANGE_DDN KEY MYFCT CDTAA Y Change one field in the ddn records listed in APPL MYAPPL1 Notice that it is DDN records being changed as specified in the command CHANGE_DDN The target set of ddn records to be changed is the list of ddn record names in CAFC application record named MYAPPL1 CHANGE DDN KEY MYAPPL1 TYPE A CDTAA Y EXTENDED CAFC RECORD MAINTENANCE FACILITY CONTINUED Change one field in the ddn records listed in all the APPLS in all the GROUPS named ABC AND XYZ Page 269 MAINTENANCE AND CONVERSION AIDS Notice that it is ddn records being changed as specified in the command CHANGE_DDN The list of ddn records to be changed is generated by expanding all CAFC group records with names beginning with ABC and beginning with XYZ to get a list of CAFC application records Each application record in that list is expanded to generate the final target set of DDN records to be changed CHANGE DDN KEY ABC XYZ TYPE G CDTAA Y EXTENDED CAFC
294. ged the transaction name specified the CICS XLT must also be changed program AFCP9999 accesses the CAFC the Interface processing without consideration of the This is the default val and issue a File will be the batch job will terminate Page 92 the return code specified on CAFC FEATURES AND CONS DERAT ONS B I LU6 2 CUSTOMIZATION OPTIONS CONTINUED The CICS Region UP indicator can Run this program with AFCP2027 Instal lation Library if the 1 you something other than Requests to ignore the crash con the CICS UP indicator to a crash active CICS regions Gk and 2 be rese have se you want subsequent Batch dition condition If you experience an to OFF by the batch program member CTLCUP in your CAFC the CICS Abend option to Interface that an IPL will set of your previously you must run the CTLCUP JCL Remember in all IPL jobstream against all of the regions you wish to reset RETURN CODE Re po tion XPGM REQUEST TRANSACTION uses a default ICS components when an XPGM request transaction The B I C this B I option on this panel assembled in SEQUENTIAL TERMINAL ID FOR XPGM REQUESTS When a XPGM request program AFCP2110 to ru of SEQX for this p simply chang the is scheduled si E panel defined to Cl Ensur
295. ges back across the VTAM session displays the messages upon the OS console and then checks for another request If the next request is for the same CICS Applid it sends this request across otherwise it issues CSSF LOGOFF terminates the current VTAM session and initiates a VTAM session with the new CICS Applid CAFC Help Supervisor Program This program displays the Help Screens and CAFC Function Error Message Table CAFC Non 3270 Device Support Program This program 1 reads a CAFC Function Request from a non 3270 device 2 builds a request parmlist 3 links to AFCP2008 4 and then writes the completion messages back to the non 3270 CAFC Conversion Program This program initializes the CAFC Table file CAFC Transfer Program This program transfers table file records from one CAFC Table File to another CAFC Batch Report Program This program creates reports on the entries in the CAFC Table File CAFC DBD DDname List Table CICSDBD Edit Program CAFC JCL DD Card to CAFC CICS DDname Table Record Conversion Program CAFC Online CEMT Transaction Program called by AFCP2008 for open close processing CAFC Customization Subsystem Supervisor Program CAFC Trace Options Update Program CAFC Online CAFC DDname Table Change Program CAFC Message Maintenance Program CAFC Control Record Report Program Program to disable F
296. gram Connection EXCI Group EXCIGRUP DEscription gt CAFC EXCI Specific Connection Definition CONNECTION IDENTIFIERS Netname gt AFCP2016 INDsys gt REMOTE ATTRIBUTES REMOTESystem gt REMOTESYsnet gt REMOTEName gt CONNECTION PROPERTIES ACcessmethod gt IRc Vtam IRc INdirect Xm PRotocol gt Exci Appe Lu l Exci Conntyp gt Specific Generic Specific SInglesess gt No No Yes DAtastream gt User User 3270 SCs STrfield Lms RECordformat gt U U Vb Queuelimit gt No No 0 9999 OPERATIONAL PROPERTIES AUtoconnect gt No No Yes All INServic gt Yes Yes No SECURITY SEcurityname gt ATtachsec gt Identify Local Identify Verify Persistent Mixidpe BINDPassword PASSWORD NOT SPECIFIED BINDSecurity gt No No Yes RECOVERY PSrecovery gt Sysdefault Sysdefault None Note The above Attachsec parameter controls whether security checking will be done for the CAFC requests submitted through the EXC B interface Page 189 BATCH TO CICS NTERFACE BATCH INTERFACE INSTALLATION STEPS CONTINUED Step ld DEFINING THE EXC SESSION The following parameters should be used to define a specific EXCI session for use by the CAFC B I program
297. h accessible AOR DOR A normal CICS region has the two CAFC transids AFCS CAFC signon and AFC2 the main supervisor program The example below uses the third character of the transid as the system identifier and the fourth character as the unique transaction identifier The transid for the main supervisor program must end in a 2 Of course you can select your own naming conventions TRANSACTION AFCA PROGRAM AFCP2050 PROFILE DFHCICST TRANSACTION AOCS REMOTESYSTEM AORC REMOTENAME AOCS TRPROF DFHCICSS TRANSACTION AOC2 REMOTESYSTEM AORC REMOTENAME AOC2 TRPROF DFHCICSS TRANSACTION AODS REMOTESYSTEM AORD REMOTENAME AODS TRPROF DFHCICSS TRANSACTION AOD2 REMOTESYSTEM AORD REMOTENAME AOD2 TRPROF DFHCICSS TRANSACTION AOGS REMOTESYSTEM AORG REMOTENAME AOGS TRPROF DFHCICSS TRANSACTION AOG2 REMOTESYSTEM AORG REMOTENAME AOG2 TRPROF DFHCICSS TRANSACTION AOHS REMOTESYSTEM AORH REMOTENAME AOHS TRPROF DFHCICSS TRANSACTION AOH2 REMOTESYSTEM AORH REMOTENAME AOH2 TRPROF DFHCICSS The CSD group CAFCTOR on the installation tape s CSD file is provided as an example only for you
298. h commands using the Externa table file Interface to a CICS region from a batch job stream a CAFC provided ACT VTAM LU6 2 connection CS C to a The B I EXCI nterface ACF VTAM LU6 2 B I PROGRAM OVERVIEW The Batch Interface program AFCP2016 facility is comprehensiv and requires no intermediat Interface facil ur Cl DLI us changes standard CEMT commands Batch jobstreams to yo for flat file and transaction stat 4 transactions programs via information transactions Batch In that an that yet efficient do expect Interface called terface Terminal Processor is an optional CS regions runs as a VTAM application 2 program communicat a nat B I program allows users to issue CAFC and CI DBCTL region and to a VSAM control region tes t CICS through tive CICS connection or a direct update to the CAFC CS 1 The It is completely event driven database status changes 3 5 or do not expect XCTL or the EXEC facilities to secure user transactions the Batch instal files nor systems timer interrupts lity sends seven types of commands from batch The commands include 2 6 1 CAFC requests for CAFC requests for data set starts for pseudo conversational CICS a response 7 The CAFC requests name
299. have access to the region s CAFC Table File AFCP2016 will default to an internal TIMEOUT value of 2 minutes Contact Netec technical support if you wish to permanently change AFCP2016 s 2 minute internal default TIMEOUT value PROVIDING A NEW TIMEOUT VALUE FROM A BATCH JOBSTEP You may individually set or override the TIMEOUT value for a specific jobstep Place the following operand and new value TIMEOUT hhmmssth in the parm input area for the batch job The parm input area is identified by the ddname CAFCPARM The value will be honored for this single jobstep Page 89 CAFC FEATURES AND CONSIDERATIONS B I LU6 2 CUSTOMIZATION OPTIONS CONTINUED MULTIPLE LU NAMES ENQUEUE WAIT INTERVAL Before attempting to establish a session with CICS the Batch Interface Program checks via enqueues the availability of the LU names specified in AFCT2016 If the end of the list is reached without finding an available not busy LU name the program waits for an interval of time before reprocessing the list The wait value specified must be in the following format 00000000 hhmmssth Default value is gt 00020000 Please see PROVIDING ACCESS TO A NEW TIMEOUT VALUE in the BATCH INTERFACE TIMEOUT description SETTING THE ENQUEUE WAIT INTERVAL FROM A BATCH JOBSTEP You may specify a override wait interval at run ti
300. he Batch Interface step with the return code provided by the user If the region was shutdown normally the Batch Interface program will apply all requests to the CAFC Table File These updated statuses will be used for the next CAFC Warm start If the requests are successfully applied a step return code of 00 will be returned If the requests were not applied successfully a step return code of 02 will be returned Page 174 BATCH TO C CS NTERFACE BATCH INTERFACE CONTINUED VTAM B I LU6 2 APPLID REQUIREMENTS A VTAM APPLI as an legit to identify the Batch TCT entry The VTAM Applid of the target either CAFC 1 VTAM B I LU6 2 ACB MODES Interface program can be installed to operate in one of three The Batch modes 5 UN timate VTAM application Distribution tape contains the sampl allow the user to programmatically determin INGLE VTAM ACB FOR ALL C IQUE VTAM ACBS FOR EACH REGI MULTIPLE LU NAMES FOR EACH REGI Interface program as a c 2 runtime parameters and or th CS REG ON ON ONS SINGLE VTAM ACB FOR ALL CICS REGIONS A single VTAM ACB is used to communicate with different Interface program will this mode al O same CPU communicating with different target CICS systems ts requests serialized ther concurrently executing Batch any batch job invoking the
301. he CAFC4500 message file The key length for all messages has changed along with adding many new messages for CAFC Release 4 4 If you skip this step many error and warning messages will be hidden In some cases CAFC will not initialize One symptom for a missing AFCFMSGS DD statement is error message numbers appearing without the message text 6 On line security can be established at the resource level through new security interface programs for RACF TopSecret and ACF2 Page 24 CAFC RELEASE MA NTENANCE UPGRADES MIGRATION CHECK LIST CONTINUED 7 10 lil Remove AFCP2029 from the PLTPI 12 T3 If you plan to use 1 the parameters to ma control programs automa transaction 3 the SH reconcatenation facility or facilities for transactions install The Customization Options have been expanded tch each region s specific needs CAFC no longer performs explicit verifies tically handle VSAM verifies for each open DFHSM recall support UT transaction 5 transient data que 4 any of the t that you perform the DFHDEB70 Installation Step 2 CAF Change the ddname for CAFC is missing The CAFC initialization PLTPI has been replaced by AFCP2010 in your PLTPI The CAFC AFCSTART SIT override facility starting of CICS resources Start overrides a
302. he CICS systems execute that will product the merged logs If all CICS systems that will participate in the merged log execute on the same MVS image a DASDONLY log can be utilized If the CICS systems that will participate in the merged log execute on more than one MVS image the coupling facility resident log is required The information is necessary to determine the correct allocation of the log structures Determine how large of staging datasets to allocate The logger staging datasets are allocated and used by the logger to offload log records once the primary log structure has reach the HIGHOFFLOAD specified in the log stream definition The size of these data sets depends on the STG_SIZE parameter setting in the log stream definition Allocate MVS system logger log streams for use by CAFC logging If CAFC is to write log records to the MVS system logger the logger must have been activated in the MVS environment Specifics on how to activate the system logger subsystem can be found in the IBM documentation SA22 7625 MVS Setting Up a Sysplex Preparing to Use System Logger Applications Once the system logger is active and the retention requirements for CAFC log records have been determined it is necessary to allocate at least one log stream to receive log records The following example assumes that log records will be retained for a minimum of 7 days on a DASDONLY log stream U2DEFLOG JOB NTC
303. he following format WXIDATAP Full WXIDATAL Full WX1NSCC Full word set by the ex 0 4 completion code WX1RC Exits Return code Leave step comple it word address of the Vtam Data received word length of the Vtam Data received indicating the desired step ti Fullword set as follows on code unchanged Change step completion code to value in WXINSCC The source code for a sample Receive provided in INSTL the return code The Batch Terminal Da ta exit program AFCPBTX1 is B Commented ALC instructions show exactly how to alter L Processor AFCP2LU 0 always links to load module AFCPBTX1 It is the user s responsibility to ensure that this exit load module is availabl le at execution time Page 2 32 BATCH TO CICS INTERFACE BATCH EXIT PROGRAM DESIGN HINTS VTAM I O ACTIVITY The Batch the VTAM ac Interface Sign on Sign off Exit must be written to interact with tivity that CICS schedules on behalf of the transaction invoked It is the responsibility of the exit program to request the necessary VTAM I O is sent to CICS all resulting messages from CICS must be Received by the exit program data messages this situation activity at the appropriate time e g after a message This includes Non data messages in addition to true
304. he information in the request statement area has not yet been edited by the Batch Interface Program The exit program may set one of three possible return codes to the Batch Interface Program 0 Normal completion process the control statement 4 Skip processing the current control statement and continue with the next statement 8 Flush the current and all subsequent control statements Page 230 BATCH TO C CS NTERFACE DYNAMIC CICS APPLID SELECTION EXIT PROGRAM SAMPLE The distributed sample of AFCP2BCC demonstrates the dynamic selection of a new CICS APPLI D based on the current CI The sample exit program extracts from the request statement statement 1 the target region CICS APPLI CAFC item name match occurs on all three D 2 Next the program goes the exit program replaces the B I request statement with the new APPLI table If a match is not found the request statement In either case a Return Code of zero is set exit program is supplied in the CAFC INSTLIB P CS APPLI D coded in the request the CAFC Record Type and 3 the to a look up table macro Ifa the CICS APPLID in D specified in the look up BATCH STEP CONDITION CODE CONTROL EXIT The CAFC Batch exit program AFCP2CCX Interface has determined i
305. he procedures will not damage your file Step 1 Use member INSTO20 or INSTO2C iff installing from CD in CAFC INSTLIB to create and initialize a new CAFC tablefile and message fil Step 2 Use member INSTO30 to repro your existing file to the newly defined file produced by Step 1 Step 3 Use member INSTO70 in the CAFC INSTLIB to convert the newly built tablefile Step 4 Replace the old AFCFMSGS message fil in the CICS region jcl with new one created in Step 1 STEP 7 Installing CAFC s Batch Interface Facilities See the Chapter entitled CAFC BATCH TO CICS INTERFACE for installation details STEP 8 Setting the Customization Options See the Chapter entitled CUSTOMIZATION OPTIONS Update as required Page 11 DETAIL INSTALLATION STEPS CONTINUED STEP Jia Activating CAFC s Extended NSTALLATION PROCEDURES DCT Support There are two procedures tha STEP 9A Check to see PLTPI DFHELIM so that it runs during the third stage of CICS initialization t activate CAFC Extended DCT support that module AFCP2010 has been placed in the During PLT processing AFCP2010 transfers control to AFCP2DCT which in turn determines the current region s CICS version number AFCP2DCT then transfers contro
306. hority is checked against in MASTER FUNCTIONS the following manner For MASTER functions the resource is created by suffixing the MASTER sequence with the VTAM APPLID of the CICS system where CAFC is executing An example of this would be if CAFC was executing in a CICS region whose APPLID was TESTCICS the resource created would be MASTER TESTCICS In this example the user can 1 browse and update CAFC Table File records 2 allocate etc against CAFC controlled items and 3 browse and alter CAFC Customization panels USER FUNCTIONS For USER functions the reso sequence with the CICS APPLID name Generically this woul USER is the fixed prefix region s CICS VTAM APPLID found in the table below APPL issue CAFC requests open close urce is created by suffixing the USER CAFC resource type and the resource ld look like USER applid cafctype name D is replaced by the executing CAFCTYPE is replaced by one of the values NAME is replaced by the CAFC resource name An example of this would be executing in a CICS system whose APPLID is TESTCICS and the resource is a DDNAME called MYFILE would create the a resource of USER TESTCICS DDN MYFILE CAFCtype Description DDN DDNAME records DBD Database Definition records APL Application DDNAME records
307. ical support group Page 335 you to obtain this documentat the cause of the problem recently applied to either CAFC VSAM or CICS and your VTAM th the batch interface taff needs a t your site If tion Security Exit Area B I see AFCDBISA 250 FCT requirement INSTO45 INST45C abnormal occurences ACB name for B I 7 7 20 3 201 61 255 SUBJECT ACB name for CICS Region 243 26 ACB name for LUO support 243 Access Status on warm start 181 ACEE sign on for the B I 93 ACF2 CLASMAP statements 119 ACF2 Resource Rules 120 ACF2 SAFDEF statement 119 ACF2 Security 33 248 Activating Automatic Allocation 316 Activating CAFC s B I Trace 214 Activating CAFC s Extended DCT Support 12 Activating CAFC s Extended FCT support 15 145 Activating CAFC s Extended PCT support 13 Activating CAFC s On Line Trace from B I 214 Activating CAFC s On line Traces 34115 3127 313 Activating CAFC s Trace during CICS Startup 175 176 activating RLS Access 60 Activating the TRAN facility 243 ADD record request from the B I 226 Add resources to the CAFC table file 10 AF7RCODE B I request completion return code 62 AFAC Transaction to verify APF authorization 344 AFC2 Transaction for main online request processing 3
308. idered That is update AFCT2016 with multiple ACB entries associated with the regions Step 4 UPDATE THE CICS REGION S XLT XLT processing al started before CI lows CAFC to will c CS moved into shutdown processing provided in INSTL B member CAFCXLT through ceri the amount required n tain stages of shu of time B I tries and reassembl tdown request th Page ontinue processing B I allow CAFC to process This processing dramat requests that The XLT entries these requests tically reduces ts are locked out during shutdown XLT 184 Add the BATCH TO CICS INTERFACE B I INSTALLATION STEPS ACF VTAM LU6 2 B I CONTINUED Step 5 CONFIRM THAT ISC SUPPORT IS ACTIVE f ISC YES is not already present in your DFHSIT parameters add it This parameter installs the CICS intercommunication group programs during CICS initialization Step 6 CHECK YOUR CAFC LOADLIB FOR REQUIRED EXIT PROGRAMS The following default or user modified Batch Interface exit programs must be in your CAFC loadlib AFCP2SOX AFCP2BCC AFCP2BSX and AFCP2CCX If you plan to use the TRAN request AFCPBTX1 must also be in your CAFC loadlib 1 OPTIONAL Modify assemble and linkedit the CAFC B I Sign on Sign off exit program AFCP2SOX for region unique resource access requirements The standard e
309. ieu of Batch Terminal Processor s TRAN request The BTM s TRAN facility severely limits the size of the response returning from the target CICS region The B I s response area is 8 000 bytes SAMPLE FULL SCREEN TRANSACTION AFCP2LU0 TRAN requests can communicate with full screen CICS applications however the appropriate 3270 control characters e g SBA information must also be included with the transaction data You must have some knowledge of 3270 data streams to simulate full screen transactions For example if an application expects a character 1l in Row 7 Column 20 of a screen response then the transaction data should contain the SBA command x 11 the buffer address x c7f3 or c g3 followed by the character l See the example below along with its hex conversion CICS99P tran Axx g31 ccceffdb6edcd6 4cff 3932997bpb3915077770731 Buffer addresses can be determined using the IBM 3270 Information Display System Reference Summary GX20 1878 To simulate the sending of a PF key the user needs to code the appropriate character string beginning in the first column of the input card reserved for freeform input The BTM will send the appropriate hex character as an IBM 3270 short read just the aid byte will be sent to CICS Page 220 BATCH TO CICS INTERFACE BATCH TERMINAL PROCESSOR TRAN REQUEST CONTIN
310. ill be available for any subsequent PLTPI processing against the RLS files e is controlled by the SET ions men ption setting The tablefile at the reg e SETRLSDSN parm Y or SETRLSDSN N u carries ill show A information For RLS VSAM files if NOT AVAILABLE Byte 2 will show N if UNQUIESCED Byte TO i Page 57 ts f QUIESCED This feature is option ion in the two additional bytes if AVAILABLE or if QU ESC NG These two bytes are blank for non RLS VSAM files CAFC FEATURES AND CONS VSAM RLS SUPPORT CONTINUED A new file main maintenance facility DDN records RLS ACCESS fiel d se in for each region that SYNCHRONI ts the RLS flag the region s FCT DERAT ONS tenance command available within the Extended CAFC record C ZE RLSFLAG scans scans DTRLS This function should be run once and edits the CAFC to the value of the according has VSAM RLS support activate Below are the RLS requests supported by CAFC D UNQUIESCED amp OPEN N UNQUIESCE DATASETS V SET DATASETS AVAILABLE VN SET DATASETS AVAILABLE amp UNQUIESCED NO UNQUIESCE amp OPEN DATASETS VO SET DATASETS AVAILABL
311. ing example assumes that log records will be retained for a minimum of 7 days on a Coupling Facility resident log stream U2DEFLOG JOB NTC CICSTS 1 3 MSGCLASS X CLASS A MSGLEVEL 1 1 REGION 0M J BK RK RK KK KK KR A A A A A A A A A A A A A A A A A OK THIS JOB WILL DEFINE THE COUPLING FACILITY LOGS J BK RK KK IK KK RA A A A AA A A A A A A A A A A A A A Ok LOGDEFNL EXEC PGM IXCMIAPU SYSPRINT DD SYSOUT SYSI DD DATA TYPE LOGR REPORT NO DELETE LOGSTREAM NAME TEST LOG STREAM CF Page 308 MISCELLANEOUS CAFC UTILITIES DEFINE STRUCTURE NAME CAFC_LOG LOGSNUM 16 Indicate max logstreams for this structure DEFINE LOGSTREAM NAME TEST LOG STREAM CF STRUCTURE CAFC_LOG Must match the structure name defined abov STG_DUPLEX YES HLQ NETEC High level qualifier for staging datasets STG_SIZE nnnn nnnn is the number calculated above LOWOFFLOAD 60 HIGHOFFLOAD 80 AUTODELETE YES RETPD 7 Retention period determined abov LIST LOGSTREAM NAME TEST LOG STREAM CF DETAIL YES T DASDONLY NO H Page 309 As a user selectable option System Logger log streams MISCELLANEOUS CAFC UTILITIES CAFC will create log recor
312. int ba OL They are onl e requesting program must be a CI following fields must be present in the parmlist AF4REQST NOQ YP R AF 4ENTY1 A G AFCP2503 tenance function parmlist The Dname and TXN Entry Maintenance functions may be invoked ding and passing a maintenance func through tion Installation tch interfac y available in CAFC Release 4 3 and higher tape includes These requests in CAFC Release CS Command Level program The 1 byte Request code The Request code must be one of the following ADD DDname or TXN record CHANGE DDname data DELETE GROUP APPLICATION DBDLIST or DDname COPY existing DDname or TXN record creating new r cord PURGE If the ENTRY TYPE is a G GROUP LIST delete 1 GROUP record 2 all of the APPLICATION records under that GROUP and 3 all DDname records belonging to all APPL CAT ON records If the ENTRY TYPE is an A APPLICATION LIST delete 1 the APPLICATION LIST record and 2 all of the DDname records belonging to that APPLICATION LIST If the ENTRY TYPE is a D DDNAME entry delete the DDNAME record If the ENTRY TYPE is a P DBDLIST delete 1 the DBDLIST record and 2 all DDname records under that DBDLIST
313. interface allows CAFC s Transaction record status flags to remain synchronized with the PCT enable disable status As EXEC C commands change th nable disable status CAFC will automatically update its own TXN record status flags insures a more reliable region startup If you routinely use CEMT set commands not CAFC requests enable and disable fct entries follow the inst 11 The procedures will install an interface that intercepts This CS or CEMT set EO tructions in step command activity against FCT resources The interface allows CAFC to automatically allocate enable and free disable FCT resources as CEMT requests and EXEC C are issued against FCT resources If you routinely have fct entries defined with OpenTime St or need FCT entries allocated on an implicit request such read or browse to a closed enabled fil CS open and close calls tartup asa le follow the instructions l an interface that in step 12 The procedures will instal intercepts command activity against FCT resources for init allows CAFC to opens or implicit opens The interfac tial automatically allocate enable FCT resources for CSFU during CICS startup or for firstref opens Page 4 NSTALLATION PROCEDURES INSTALLATION TAPE FILES The program material needed to install the CICS Application File Control facilit
314. ion Code option on this panel data set name change transaction identification ent AFCM CONS DERAT transaction to communicate with CI If you wish to change ONS to communicate with its simply change Ensure that the DFHPCT table with a this transaction name is changed the transaction name specified the CICS XLT must also be changed is set to BELOW under C Insure that the TASKDATALOC CS Versions 3 3 and 4 1 CS E tR gt AFCM CICS ABENDS CTEGUR ach Table file when th The B I program AFCP2016 action you have specified as the Batch Ther thr ar options EEM Continue Batch crash indicator W Inform the MVS console operator WTOR for GO or Cancel If GO updated If Cancel is replied T Terminate the Batch Interface Step with the Batch Option Panel checks the time a B I CS region is down is set on by CAFC s PLTPI The CTLCUP is set off by CAFC s shutdown program This indicator is referenced target Cl CTLCUP request indicat AFCP2015 if CI CS has crashed is repl Lied the Table the tor and takes Interface Customization Option new Dsname Change Online Transaction Code option on this panel transaction code has been assembled in is associated with the program DFHPCT this transaction name is chan
315. ion return codes for error conditions have been refined Review the Message Manual If you are converting from CAFC Release 4 1 01 or an earlier release add an entry for CAFC s initialization driver program AFCP2010 to the third stage of PLTPI processing i e after the DFHDELIM This is now an installation requirement Program AFCP2010 replaces AFCP2029 If you have AFCP2029 in the PLTPI REMOVE IT t is no longer a valid program If you are converting from CAFC Release 3 2 02 remove the FCT entry for old CAFC Table File AFCF0001 Add CAFC s new Table File s ddname AFCF4000 to the region s startup JCL not to the FCT AFCF4000 must not be referenced in the FCT Page 20 CAFC RELEASE MA NTENANCE MIGRATION PROCEDURES FROM ANY BACK RELEASE CONTINUED Add DI D statements to the region s startup JCL for 1 UPGRADES the shareable Message and Help Screen text file AFCFMSGS 2 the override parameter file CAFCPARM 3 the request override file CAFCOVER 4 the trace output file CAFCTRAC and any SYSOUT files that receive on line audit trail information file AFCFMSGS must not b file can now be shared between multipl Sa AFCPXRCI from your C The CAFC Table file referenced If you are converting from CAFC Release 3 2 02 TS parameter CS S T TBEX is no longer needed
316. ions 67 DRS fields status 17 DCT extended CAFC support DCT Extended CAFC Support 9 r Sa p Br L2 4 LRS tenance with DCT Extended Support FCT Extended support PCT Extended Support keyword 2 18 options Defaul B I Defaul B I Defaul Defaul Defaul Vtam ACB VTAM ACB 195 193 127 20 VTAM ACB PASSWORD 10 Security Type USERID 10 Ce CP EE CF ner ee et Defaul 139299 Warm St 254 r 33 tart Parameters Deleting CAFC Table File records 176 Deleting CAFC Table File records with AFCP2503 303 Desired Restart Status 178 180 182 Desired Restart Status 181 DFHO961 message 276 DFHAIP RPL requirement 144 DFHCSD RDO entries 5 7 DFHDEB70 APF authorization module 145 147 DFHDEB70 APF Authorization Module 38 DFHFCU 172 DFHPCT entry for AFCB for the B I 98 DFHRPL at CICS Initialization 49 DFHRPL concatenation requirements 9 DFHRPL Display Current Concatenation 49 DFHRPL module locate requests 318 DFHRPL reconcatenation 40 DFHRPL Reconcatenation failure 50 51 DFHRPL Warm Start 50 DFHSIT requirement 203 DFHSM migrated data set volume serial 142 DFHSM options 143 DFHSM Options 86 141 DFHSM support requires APF authorization 38 DFHSM Suppressing automatic recalls 142 DFHSNT requirements for the B I 95 DFHTCT LUO Terminal Definition 241 242
317. ions The B I is treated just the same as another CICS region as far as MRO logon and connect bind time security checking is concerned This means that when the B I program logs on to the interregion communication program bind time security checks against B I program to logon successfully target CICS region ensure that yo userid within a user profile in yo defined the batch region s userid the USERID under which the B I program is running the batch region s userid To enable the EXCI to IRP that is to connect to the either logon to or as bind time security IRP performs logon and u have defined the batch region s ur security system Once you have to your security system you can give the batch region the appropriate logon and bind time authorizations LOGON AUTHORIZATION specific connections only Authorize the B I program s userid FACILITY class profile s with UPI authorize the B I program s userid specific userid the logon to the to the to the TRP will DFHAPPL AFCP2015 RACF DATE authority If you fail to DFHAPPL profile of the cause the Allocate_Pipe processing to fail with a RESPONSE SYSTEM_ERROR REASON IRC_LOGON_ FAILURE The subreason field 1 for this logon security check failure will return a decimal 204 Page 179 X CC BATCH TO CICS
318. ique MIGRATION PROCEDURES FROM ANY BACK RELEASE CONTINUED Page 19 CAFC RELEASE MAINTENANCE UPGRADES CAFC Release 4 5 systems no longer uses the following CAFC transactions AFC1 AFCD AFCW DCTN and DCTF The functions that were performed by these are now handled by the Customization Options the Utility Services Menu and by the AFCT transaction followed by an operand On line CEMT shut immediate commands are now honored but they will cause a non graceful CAFC termination If you plan to use CAFC to open and close ddnames with RLS access you should execute the Synchronize _RLS command from the Extended CAFC Record Maintenance Facility panel Execute this command the first time CAFC is started The utility will read the FCT for all files defined with RLS YES and set the CAFC ddname record RLS indicator to Yes If you plan to use CAFC to allocate FCT ddnames that are defined to CICS as OPENTIME STARTUP you must activate CAFC s INITIAL OPEN support option Review the SUPPORT EXEC CICS options in this manual under the CUSTOMIZATION OPTIONS section You CANNOT mix old and new Batch Interface programs If you plan to run a mixed environment use the CAFC4500 version of the Batch Interface program The CAFC Release 4 5 B I program is downward compatible Specify the CAFC4500 load library in your Batch JCL Note that the request complet
319. is These parameters control CAFC messages related to file OPENs and allocations WARNING MESSAGE OPTION If this option is se E tO yry CAFC will write all warning to the Cl CS messages e g ALREADY CLOSED AL log and to the JES log Default value gt Y SHUTDOWN MESSAGE OPTION the shutdown console instead of selected th If this option is set to warning and informat MY If M is selected CAFC will tional messages to the terminal that READY OPEN ETC CAFC shutdown issued write all the terminal i the MVS console Default messages will be wri If N is select value gt Y REQUEST OPTIONS CONTINUED AUTOMATIC ENABLE DISABLE Page 124 the messages will go to the MVS ssuing the shutdown If B is tten to both the terminal and ed no messages will be written CAFC FEATURES AN These flags control automatic enable disable st D CONS DERAT ONS tatus changes when opens closes and allocations frees implicitly or explicitly occur The flags also determine if transactions belonging to an application list should be automatically enabled when the application list is opened ENABLE WITH OPEN If this option is set to Y CAFC will automat DCT whenever a CAFC open request is issued to occur set to Y Default valu
320. is option assumes th xistence of a user written external security program Users may or may not be required to enter USERID and PASSWORD on CAFC Sign on screen prior to going to the Primary Option Menu depending upon the value specified in the External Security Signon Req d field Page 104 All attempts to browse will be authorized by an ins CAFC FEATURES AND CONS DERAT ONS SECURITY OPTIONS CONTINUED edit or use any entry in any CAFC Table File tallation provided program except the Userid Table which requires a userid signed on with MASTER Password Authorization program information USER SIGNON Users attemp Screens are validated against ting to update the CAFC Customization a table in your external security See the section on User written external security for more The User Signon field is used to specify whether sign on is to be required or bypassed It inhibited and the initial TED option will NHIB The is also used to specify that sign on is CAFC sign on screen is not to be displayed Default USER SIGNON set the CAFC security level to MASTER gt N none required EOvt sy document who When REQ D Flag to an your updates updated If the SECURITY PRODUCT is set then CAFC will not fields in the DDNAME and userid or jobname the Security Fla
321. ities conversion aids and miscellaneous operational controls functions Before you begin your installation review the chapter entitled CAFC UTILITIES the specific section Utility Services Menu AT UTILITY SERVICES MENU CAFC PANEL 226 MAP P SELECT OPTION gt _ 1 ACTIVATE DEACTIVATE TRACE FUNCTIONS _ 2 CAFC STARTUP AND RELATED FUNCTIONS _ 3 CAFC SHUTDOWN AND RELATED FUNCTIONS _ 4 PERFORM A CAFC WARM START _ 5 DFHRPL MODULE LOCATE REQUESTS _ 6 DDNAME ENTRY MAINTENANCE FACILITY _ 7 EXTENDED CAFC RECORD MAINTENANCE FACILITY TO SELECT ENTER OPTION NUMBER OR TAB TO SERVICE AND ENTER S PRESS CLEAR KEY TO TERMINATE CAFC PFKS 3 EN Page 73 CAFC FEATURES AND CONSIDERATIONS ON LINE USER EXIT POINTS ALLOCATE OPEN CLOSE FREE GLOBAL EXIT Most installations will have no need for a user written ALLOCATE OPEN CLOSE or FREE exit program However if your installation has a requirement for the special processing of one or more for any data sets during ALLOCATE OPEN CLOSE FREE processing CAFC provides the following User Exit points Pre request exits Post request exits Pre Allocate Post Allocate Pre Open Post Open Pre Close Post Close Pre Free Post Free Request completion exits Single Item Completion Single Application Completion Application within a Group Completion Group Completion The CAFC C
322. ition below LUOTERM1 DFHTCT LUO terminal TYPE TERMINAL ACCMETH VTAM BRACKET NO BUFFER 0 ERRATT LASTLINE INTENSIFY FEATURE DCKYBD UCTRAN NETNAME LUOTERM1 RELREQ YES YES TIOAL 128 RMIDNT TLUO TRMMODL 2 RMSTAT TRANSCEIVE RMT YPE 3270 Page 222 tablish the ther than the If a sign on is desired under RACF ACF2 or TopSecret follow the terminal to the CICS tallation library MMMM MM MMM KM XM OX BATCH TO CICS INTERFACE BATCH TERMINAL PROCESSOR INSTALLATION STEPS CONTINUED STEP 2 An APPL statement must be added to SYS1 VTAMLST to define the APPL ACB The standard B I uses the APPL information to establish the LUO session The CAFC Installation Tape member LUOAPPL may be used as an example Below is an example VTAM APPLID statement for the LUO LUOTERM1 VBUILD TYPE APPL LUOTERM1 APPL ACBNAME LUOTERM AUTH ACQ PASS where ACBNAME LUOTERM represents the domain unique acbname and LUOTERM1 the network unique APPLID Page 223 BATCH TO CICS INTERFACE BATCH TERMINAL PROCESSOR INSTALLATION STEPS CONTINUED STEP 3 Optional If MULTIPLE LU NAMES are to be used or if a single ACB other than LUOTERM is to be used to establish the VTAM session with CICS then the Bat
323. ividual items such as a transaction a DBD ddname Group lists Applications lists or a generic scope applied to any of the above resources Group and Application lists may be exploded to display the individual components and their respective status RDO REQUESTS allows you to perform requests against RDO resources directly without having the resource defined in the CAFC tablefile No automatic services are performed with the RDO requests PASSWORD allows you to change the current PASSWORD for access to the CAFC Table File The default PASSWORD is PASSWORD The default USERID is MASTER OPTIONS takes you to the CUSTOMIZATION OPTIONS MENU These options are described in the next section MESSAGE FACILITY maintains triggering events message text and list of users and terminals A message will automatically be sent to a list of users or terminals if the status of a target CAFC resource changes UTILITY SERVICES is a collection of functions that support or change the operational status of CAFC or the resources under its control REPORTS allows you to produce reports on CAFC resources online as opposed to running a batch utility Detail reports and summary reports of all resources in the CAFC table including the control record and be produced Page 81 CAFC FEATURES AND CONS CUSTOMIZATION OPTIONS
324. l to the correct DCT PLT program DCT53 DCT61 DCT62 DCT63 DCT64 and DCT65 These CAFC programs must be marked RES YES in the PPT STEP 9B Go to the CUSTOMIZATION OPTION MENU select the symbol for Enter a yY SUPPORT EXEC CICS for EXEC C CS SET TDQUEUE for Extended DCT Support The above steps will establish CAFC s interface for DCT activity The interface allows CAFC to support two functions First CAFC will perform automatic DCT allocations enables and deallocations disables triggered by CEMT or EXEC CICS open and close commands Second CAFC will synchronize DCT file status within CAFC s Table file The synchronization occurs whenever CEMT set commands or EXEC CICS calls change the status of a DCT queue that is registered to CAFC s Table file NOTE You may deactivate CAFC s extended DCT support by changing the Customization Option setting for EXEC CICS SET TDQUEUE from a Y to an BNA NOTE with DFHEIP and Page 12 DFHAIP must not be placed in LPALIB for CAFC S interface DFHEIPCN to be successful NSTALLAT DETAILED INSTALLATION STEPS CONTINUED STEP 10 Activ ON PROCE DURES ating CAFC s Extended PCT Support There are two procedures that activate CAFC Extended PCT support STEP 10A Check During PLT processing will establish
325. last one on the screen page of data or down from page of data or down from the current entry Display a full page of data for multiple INPUT field or into the COMMAND INPUT field unt the SCROLL field The If entered beginning with the entry that the current entry beginning with the Nth entry beginning with the first entry in the record where the last entry in the record is screen FUNCTION MESSAGES ROW This tells attached terminals If this option is set to Y this application is enabled is enabled Default definitions Default value gt none the message facility which row overrides This valu the message is to appear on CI th or display a full page of data the last entry ont the CAFC automatic message send facility for If set to N This is a required field value only th facilit user messag gt 01 Page 147 row value in the global il t up he y CS CUSTOMIZATION OPTIONS MESSAGE FACILITY OPTIONS CONTINUED COLUMN This tells the message facility which column the message is to appear on CICS attached terminals This value overrides the column value in the global definitions Default value gt 01 LENGTH This gives the maximum message length expected from all of the messages defined in this application record This value overri
326. ld Default value gt none FUNCTION MESSAGES enabled If set to N only th user messag only a required field if ENABLE ALL MESSAGES is set Default value gt N if ENABLE ALL MESSAGES set Page 142 Oo XS to N If this option is set to Y the CAFC automatic message send facility is facility is enabled This is else none CAFC FEATURES AND CONSIDERATIONS MESSAGE FACILITY OPTIONS CONTINUED PROCESSING OPTION This field specifies which elements are to be processed Messages may be sent from APPLICATION list and or DDname processing I 2 3 ROW This tells Process APPLICATION lists only Process DDname only Process APPLICATION and DDname the message facility which row the message is to appear on CICS attached terminals COLUMN This tells Default value gt 01 the message facility which column the message is to appear on CICS attached terminals LENGTH This gives defined in The fields Default value gt 01 the maximum message length expected from all of the messages the global record Default value gt 56 labeled FUNCTION RC TEXT and ATTRIBUTE all define one complete m ssage unit There is one message unit described per line on the rest of the input screen Page 143 CAFC FEATURES AND CONSIDERATIONS
327. lect which t process You can choose only Simply make your for the resource You you may temporarily override your standard allows you to specify exactly how r free and al losed sactions may be te start This matrix maps the exist These new values becom that CAFC is for that lso one of readonly or update allocated or free par of control provided by CAFC s warm st ap the warm start of each restart You accomplish this through CAFC DCT enabled table category s user defined warm s ting set of the basis for ppose that yo disabled state in the previous Cl warm started in a clos trix would accomplish th d unenabled state desired remapping of the Page 167 The following DRS val or TXN entry tart allows yo DRS values For a disabled or DCT entries may be warm and also one of warm started as enabled or y of the above specific warm start override values may be not to perform the warm start ticular entry u to based on its tar to CI the next CS u want every CAFC FCT category CS session to FCT warm start lues CICS STARTUP CONSIDERATIONS FCT WARM START MATRIX DRS enabled disabled unenabled open open enabled CLOSED UNENABLED closed closed enabled closed disabled closed unenabled allocated allocated enabled al lo
328. led RACF access is a hierarchical structure such that when a user has CONTROL access he has implied UPDATE and READ access When a user has UPDATE access he has implied READ access CAFC operations relate to RACF authority levels in the following manner CAFC Operation RACF Access Request control Edit update Browse read Page 108 CAFC FEATURES AND CONSIDERATIONS SECURITY OPTIONS CONTINUED SETTING UP ACF2 FOR USE BY CAFC CAFC utilizes MVS RACROUTEs and the MVS SAF interface to accomplish security in an ACF2 environment Proper support of CAFC utilizing ACF2 as an external security manager requires at least CA ACF2 Release 6 0 VERIFY CICS ACF2 SECURITY IS ACTIVE ACF2 external security must be active in the CICS region for proper operation The userid that the user sign ons to ACF2 with will be utilized to verify CAFC actions VERIFY CAFC AUTHORIZATION IS INSTALLED ACF2 requires APF authorization Insure that CAFC s APF authorization facilities have been installed ACF2 CLASMAP STATEMENTS CAFC issues RACROUTE macros to the class of SCAFC ACF2 requires that the class be defined and mapped to an ACF2 type by way of the CLASMAP statement The following represents the CLASMAP statement necessary to support CAFC s use of ACF2 as the external security manager CLASMAP CAFC RESOURCE S CAFC RSRCTYPE NTC lt user can select MUSID ENTITYLN
329. lems please gather the following items Q A detailed description of the problem symptoms Q The current CICS release level and maintenance level Q The current CAFC release level and distribution date Q The current VTAM release level if the batch interface is involved Q Knowledge of external security packages in use Q The CICS transaction dump if applicable Please make an attempt to review the dump yourself to insure that the problem is indeed CAFC related Due to our exit program processing during CICS open close requests problems related to other software are often camouflaged by abend handles and thus appear to be CAFC problems Page 334 TROUBLE SHOOTING TROUBLE SHOOTING CONTINUED D oO O O CAFC debugging traces during the problem Console logs JCL listings CICS logs for example CICS and Batch the CSMT log This log contains much information and is particularly useful in debugging batch interface problems A list of maintenanc Details of any user modifications A print out of your LU6 2 entry yo APPL definit ion if the error is wil If this is a detailed lis this informa will need to Any ideas yo newly inst tion is not work with u have of t available ur LUO TCT entry talled version of CAFC our st t of the installation steps performed at the NETEC techn
330. llowing example the TSO procedure name is ISPFPROC Page 300 J CDDF5100_MANUAL EXTRA Personal Client E Fie Edit view Tools Session Options Help Menu Utilities Compilers MISCELLANEOUS CAFC UT Options Status Help ISPF Primary Option Menu L ES Option O Settings Terminal and user parameters User ID P390 1 View Display source data or listings Time 16 04 2 Edit Create or change source data Terminal 3278 3 Utilities Perform utility functions Screen 1 4 Foreground Interactive language processing Language ENGLISH 5 Batch Submit job for language processing App ID ISR 6 Command Enter TSO or Workstation commands TSO logon ISPFPROC 7 Dialog Test Perform dialog testing TSO prefix 8 SDSF Spool Display and Search Facility System ID NIC1 9 LM Facility Library administrator functions MYS acct ACCT 10 IBM Products IBM program development products Release ISPF 5 0 11 SCLM SH Configuration Library Manager 12 Workplace ISPF Object Action Workplace Loco Logical Console Operator Interface Network Print Network Print Facility More Additional IBM Products Enter X to Terminate using log list defaults 7 00 1 19 72 Connected to host 10 1 1 20 double dots listing been modified to include the CAFC ace indicate missing libraries lines of information that hav 4 14 PM The following is a partial listing of the ISPFPROC from the previous
331. lue gt N PROPAGATE DISABLE This option when set to Y will cause all ddnames associated with the dsname being quiesced to be disabled in each CICS where they are defined to CICS and CAFC The EXEC CICS Support option for RLS Support must be set to Y and active in all regions for this option to work properly Default value gt N PROPAGATE FREE This option when set to Y will cause all ddnames associated with the dsname being quiesced to be freed in each CICS where they are defined to CICS and CAFC The EXEC CICS Support option for RLS Support must be set to Y and active in all regions for this option to work properly Default value gt N WAIT FOR QUIESCE This option when set to Y quiesce request will include a file quiesce wait Page 156 ICS STARTUP CONS DERAT ONS CICS STARTUP CONSIDERATIONS INTRODUCTION CAFC offers four facilities to enhance region start ups CAFCOVER ls and data queues that need to be available very early in AFCPSIPY is rarely needed in are AFCPSI PY allocate journal tial the CICS ini ization process and AFCPWARM AFCPSI PY is primarily used to VERSION 3 or requests tha that CAFC wo startup above environment t will override specific resource warm uld normally set through its warm s is used to change the global CAFC warm start option
332. m the status of all CAFC defined FCT entries at the termination of the previous CICS session to the initial status of these FCT entries to be established by CAFC warm start processing See CAFC WARM START FEATURES AND CONSIDERATIONS later in this manual for details and examples Files must be defined as Filstat Closed or Opentime Firstref in the FCT so that the CICS CSFU transaction which automatically runs just after the PLTPI programs will not open the files NOTE The CICS program DFHEIQDS must be defined in the PPT to enable AFCPWARM to issue CEMT inquiries and set commands successfully If the CICS program DFHEIQDS is not in the PPT an AEY9 abend will occur when CAFC issues CEMT commands DEFAULT WARM START VALUES LAST REQUEST COMBINATION WAS WARM START ACTION OE open enable O E open enable O D open disable O D open disable O U not possible X X no action CE close enable CUE close enable Cc D close disable CD close disable U close unenable G U close unenable AE allocate enable AE allocate enable A D allocate disable A D allocate disable A U allocate unenable A U allocate unenable F E free enable F E free enable F D o disable F D free disable F U unenable F U free unenable RE ee l enable
333. me by coding the LUTIME hhmmssth keyword in the parm input area of the batch job identified by the ddname CAFCPARM MULTIPLE LU NAMES MESSAGE FREQUENCY After the Batch Interface program reaches th nd of the LU names list without finding an available LU name the program checks the message frequency value Each time the number of unsuccessful searches through the list of LUs equals the message frequency value the B I program writes a message to the operator console The message frequency value must be a 2 digit numeric value Default value is gt 03 SETTING THE MESSAGE FREQUENCY FROM A BATCH JOBSTEP You may specify an override message frequency at run time by coding the LUMSG nn keyword in the parm input area of the batch job identified by the ddname CAFCPARM SIGNON METHOD If you require a CICS sign on to authorize the CAFC B I transaction AFCB the sign on information can be provided through the VTAM Function Management Header FMH5 The sign on name and password may be supplied in one of three ways 1 through a data set defined within the Batch Interface execution JCL 2 through sign on information specified on the Batch Interface Options panel and permanently stored in the CAFC Table File AFCF4000 or 3 the userid can be obtained from the Accessory Environment Element ACEE In Method 3 there is no password passed Sign on Method 3 will be used if no sign on name and passwo
334. mmands that can be D This command will result in the DDNAME being removed from the RPL list being edited It will not delete the DDNAME from the CST CSE DFHRPL LIBRARY A Mark CAFC FEATURES AN this RPL ddname ent be inserted AFTER B Mark MANAGEMENT OVERVIEW try as this RPL ddname ent be inserted BEFORE try as Page 44 the posit D CONSIDERATIONS tion moves are copies will the posit tion moves are copies will CAFC FEATURES AND CONSIDERATIONS DFHRPL LIBRARY MANAGEMENT CONTINUED RPL EDITOR EXTERNAL COMMANDS RPL Editor external commands are always entered on the COMMAND INPUT line at the top of the screen The following commands are valid in the COMMAND INPUT line CANCEL COPY RESET and SAVE CANCEL COMMAND The CANCEL or CAN command will end the current RPL editor session without saving the modified RPL list D OPERANDS PURPOSE L None Exit the RPL Editor without saving the modified Example COMMAND INPUT gt CANCEL COPY COMMAND The COPY command is used to perform an external copy of other RPL list or the active RPL into the current edit session The insertion point will be either 1 after the line where the A fter command has been issued 2 B efore the line where the before command has been issued or 3 at the top of the current RPL list if neither befo
335. mpts to establish a session program invokes AFCP2SOX The EXC B does not invoke This user exit point can be used to interfac or Top Secret whether the Userid and or F ACF2 user can determin between th and the Batch CICS applid and or transaction Interface can then communicate this Sign On information within the of the transaction request H5 The Batch You can supply a data set containing the appropriate CICS Sign on information THROUGH THE FMH5 OF THE T RANSACTION You can set up the CICS Sign on information through the CAFC Table h Interface Customization Options File by updating the Batc Page 177 BATCH TO C BATCH INTERFACE CONTINUED CS NTERFACE SIGN ON PROCESS VTAM B I LU6 2 and EXCI CONTINUED the Batch In either case information interface det CAFC function 2 user transaction 4 to the user exit program program permits communication to continue with the target CICS rmines what type of request has been issued a user defined CEMT request a request to run a Cl an interactive conversation with CICS AFCP2S0OX S For a normal CAFC function changed via the Batch For a normal CAFC function changed via the Batch the LU6 2 Batch request via an AFCB AFCM transaction code Interface Customization Options Pan the EXCI request via a
336. n The E ziajxi Pie EAR Vaw Teck Session Ootione Pab aan CAFC REL 4 4 00 ISPF LOG VIEWER Log Stream Name to View LOGGER TEST PROGRAM Specify Display Filters CICS APPLID Start Date End Date User id Log Type Record Type Resource Name 00 2 Job Name Start Time End Time Terminal CR ER EC CO SV SR A licensed proprietary product of NETEC International Copyright 2005 09 43 Keemctnd to bow 10 1 1 20 Page 313 MISCELLANEOUS CAFC UTILITIES Additional display selection filters may be input on this screen In this example the user is asking to have the displayed log records restricted to the CICS Applid CICS99Q After pressing enter the resulting display will contain only log records created by the CICS Applid CICS99Q Z CDDFS100_MANUAL EXTRA Personal Client ajz Fie Edt View Toos Session Options Hep Log Stream Name to View LOGGER TEST PROGRAM Specify Display Filters CICS APPLID CICS99Q Job Name _ Start Date Start Time End Date End Time Userid Terminal Log Type CR ER EC CO SV SR Record Tupe Resource Name A licensed proprietary product of NETEC International Copyright 2005 00 2 09 43 Eennectad to bont 10 11 20 I i Page 314 MISCELLANEOUS CAFC UTILITIES Find and Rfind Commands The Find and Rfind commands can be used to locate specific character strings found in the l
337. n Options and CAFC table entry fields controlled by the EDIT panels Remember these automatic facilities are in effect whenever a CAFC or non CAFC command changes the status of a resource or a first access read or write targets a FCT resource For example if you were to open a file with CEMT CAFC would automatically set the file status conditions to those you previously specified in the CAFC control panels Review and select the automatic facilities that meet your site s operational requirements e Automatic allocation when a data set is opened e Automatic allocation when a vsam data set is first accessed e Automatic free when a data set is closed e Automatic enable when a data set is opened or allocated e Automatic disable when a data set is closed or freed AUTOMATIC ALLOCATION OF VSAM FILES VSAM files may be automatically allocated in support of an OPEN request from CAFC CEMT EXEC CICS calls or any other means that uses DFHFCS The following procedural checks determine whether allocation is performed 1 File must not be already allocated 2 VSAM ALLOCATION OPTION on CAFC Request Options panel 401 must be Y Symbol 12 of the Customization Options Menu 3 AUTOMATIC ALLOCATION on CAFC Edit panel 400 under the section for AUTOMATIC SERVICES must be Y or R 4 If a pre allocation User Exit is taken it must allow the allocation to proceed
338. n AFCI AFCM transaction code Interface Customization Options Pan CS program 3 Batch or 2 The AFC For 1 user defined CEMT requests transactions or 3 the Batch target CICS region After th determines whether another bat are waiting they are passed AFCP2BSX Interface program will pass this Sign on LU6 2 ONLY If the Exit the B I a normal 1 a request to start a XCTL or EXEC or Interface communicates the The AFCB AFCM transid may be eiis Interface communicates the AFCM transid my be el requests to start user requests to start user conversational transactions Interface program passes your request across the link to the request is processed the Batch Interface tch request is waiting to the user exit If other requests If the request is allowed to process against the same region f request is sent across different CICS region LU6 2 only establishes a new requests one CICS region If the the link the Batch to perform any necessary clean up activity session with the next target Cl If a single batch job step communicates requests the Batch Interface checks if th J request targets If th the same CICS region next request is Interfac next req onc Page 178 the requests must include a sign on for each C
339. n CAFC components Rem If you the Batch Batch Interface program Interface Program AFCP2016 UPGRADES If you have placed AFCP2016 in a private library su library specified in the LINKLST you must replace it with including the ch as the a CAFC4500 version of AFCP2016 to insure downward compatibility There are also several other programs that are part of Interface package that need to be placed in this library th e Batch along with AFCP2016 They are AFCT3000 AFCT3053 AFCT3063 AFCT3064 AFCT3065 AFCP2LUO AFCT3061 AFCP4316 AFCP2SOX AFCP2BSX AFCP2CCX AFCP2BCC AND AFCP2BTX1 LSx AFCT30 62 AFCP4216 ati If you haven t done so during an earlier install following VTAM parameter to each CICS region s APPLI SYS1 VTAMLST SONSCIP YES eventually lead failures Skip Failure to add this update if you are using the Remove AFCP2 Release 1 4 DLI AA from the startup PLTPI 0 U Ove Lease DCT from s OsLe AFCP2 the star 4 tup PLTPI Rel need to have specific during CICS initialization AFCPSIPY in an authorized CICS manual CICS STARTUP CONSIDERAT Allocation Requirements ONS Page 26 when upgradin when upgradin on add the D maintained in this statement to a
340. n can be run stand alone This transaction requires a target program name The logic presents a screen with a list with all of the occurrences of the program within the current DFHRPL concatenation It also flags the library that contains the currently loaded copy Transaction should not be secured Page 3 22 CAFC INSTLIB CAFC NSTALLAT ON CONTENTS Member Mode Description INSTOOO JCL Restore installation library to disk INSTO45 JCL Restore CAFC distribution Maclib and Loadlib INSTO20 JCL Define VSAM cluster and restore CAFC Table File and Message Fil INSTO30 JCL Repro existing CAFC Table File to new one INSTO50 JCL Define and load a temporary DFHCSD file containing a group for CAFC programs and transactions and other groups defining CAFC s LU6 2 and LUO terminal entries INSTO60 JCL Move CAFC s RDO entries to your DFHCSD file and add them to the GRPLIST that is installed at CICS startup INSTO7O JCL Conversion step jel INST20C JCL Define VSAM cluster and restore CAFC Table File and Message Fil Use for CD or FTP installations INST45C JCL Restore CAFC distribution Maclib and Loadlib Use for CD or FTP installations INST50C JCL Define and load a temporary DFHCSD file containing a group for CAFC programs
341. n codes The standard exit program is pre assembled and included in the CAFC Loadlib 4 OPTIONAL Modify assemble and link edit the CAFC Batch Terminal Processor exit program AFCPBTX1 to interrogate full screen responses from TRAN requests Page 192 BATCH TO CICS INTERFACE BATCH INTERFACE INSTALLATION STEPS CONTINUED Step 6 OPTIONAL UPDATE AND REASSEMBLE THE AFCT2016 TABLE If you hold the dataset name for the AFCF4000 Table Fil ability to dynamically al decide to remove the dd for the CAFC Tablefile from your B I JCL code and assemble the B I ACB Association Table AFCT2016 This table can les providing the B I the llocate and access each of the target regions AFCF4000 Table Files Once AFCT2016 is assembled your batch job steps gain direct access to each target CICS region s Tabl Interface job steps must access the target CAFC Tabl reasons First the Batch Interface must read the target region s B I e File The B I e files for two processing options eg wait times region down processing flags etc Second it must update the status of CICS resources due to batch request changes WHEN THE CICS REGION IS DOWN This update procedur nsures that CICS region startup and warm start will progress properly Use INSTLIB member ASMT2016 as a sample Assemble and
342. n the DDname record AF4ONODE The 1 to 20 byte node string to be matched against the Dataset Name for replacement by the new node or string AF4NNODE The 1 to 20 byte node string which will replace the old node string data AF4DISP The 1 byte file disposition code Valid codes for VSAM w Dname records are S SHR or O OLD Codes for non VSAM Dname records are M MOD N NEW O OLD or S SHR Page 281 MAINTENANCE AND CONVERSION AIDS LINKING TO THE TABLE FILE MAINTENANCE FACILITY CONTINUED AF4FRECL The 1 byte code for Free at Close Time indicator The Free at Close Time indicator must be one of the following Y FREE this dataset if a CLOSE is issued for this dataset N Do not FREE this dataset if a CLOSE is issued for this dataset AF4AALOC The 1 byte code to perform Automatic Allocation at OPEN time The Automatic Allocation at OPEN code must be one of the following y Perform Automatic Allocation on the Dataset whenever an OPEN request is issued N Do not perform Automatic Allocation on the Dataset whenever an OPEN request is issued AF4AEA The 1 byte code to perform Automatic Enable on an ALLOC AF4AEO The 1 byte code to perform Automatic Enable on an OPEN AF4ADC The 1 byte code to perform Automatic Disable on a CLOSE AF4ADF The 1 byte code to perform Autom
343. nction performed not required for the SYNCH request NOTES If there are mor rror messages than can be displayed on one screen the user can page forward and backward Also the user can issue additional requests without entering the transaction code AFCC The AFCC Transaction cannot be used for requests performed through the OS operators console or a sequential terminal Use CAFC s AFSQ Transaction for requests from these devices Page 248 OPERAT SUPPORT FOR NON 3270 DEVICES CAFC offers an alternative transaction sequential terminals and operator consoles ONAL CONS DERAT ONS AFSQ for non 3270 devices such as AFSQ provides a quick simple method for entering CAFC requests without navigating through the standard menu system Requests pass through normal security processing The AFSQ transaction offers these same facilities for 3270 type devices The request format of the AFSQ transaction follows AFSO FEEFEE CEJN sees n where fffff The 1 to 5 character CAFC Request type S DISPLAY STATUS OF ITEMS BLANK EXPAND THE SINGLE ITEM LIST ALL ITEMS MATCHING THE GENERIC NAME SAMEDSN L
344. ngs is performed through 1 normal on line edits 2 the B I or 3 through a user written program The dsnames and the current pri sec setting are displayed on the status screens Free requests will always deallocate the dsname used by the previous allocation request The primary secondary flag is maintained at the ddname record level The requests that support the Alternate Dsname option include NOA Set no alternative dsname PRI Set primary dsname SEC Set secondary dsname NQ nquire about dsname status EXC Exchange dsnames CXO Close exchange dsnames open When the INQ request is issued from the B I the AF7RCODEs that CAFC returns are AF 7NOA 120 ddname set to no alternate dsname A 120 would be returned only if all of the component ddname records e g a Group Application individual had their CDTDSNF flags set to N AF7PRI 124 ddname set to primary dsname A 124 would be returned if 1 all of the component ddname records e g a Group Application individual had their CDTDSNF flags set to P or 2 some component ddname records had their CDTDSNF flags set to P while others had their flags set to N AF7SEC 128 ddname set to secondary dsname Page 59 CAFC FEATURES AND CONSIDERATIONS ALTERNATE DSNAME FACILITY CONTINUED A T 124 would be returned if 1 all
345. ns The MRO logon ty check is not performed for generic connections The B I is treated just the same as another CICS region as far as MRO logon and t bind time security checking is concerned This means that when program logs on to the interregion communication program IRP performs logon and bind time security checks against the USERID under the B I program is running the batch region s userid To enable program to logon successfully to IRP and to connect to the target region first ensure tha user profile to your security region s userid to your sec the appropriate logon and bind time authorizations t you define the batch region s userid in a system When you have defined the batch urity system you can then give the batch job LOGON AUTHORIATION specific connections only Authorize the B I program s userid to the DFHAPPL AFCP2015 RACF FACILITY class profile s with UPDATE authority Failure to authorize the B I program s userid to the DFHAPPL profile of the specific userid logging on causes Allocate_Pipe processing to fail with RESPONSE SYSTEM_ERROR REASON IRC_LOGON_FAILURE The subreason field 1 for a logon security check failure returns decimal 204 XCC to IRP Page 98 CAFC FEATURES AND CONS B I EXCI CUSTOMIZATION OPTIONS CONTINUED BIND TIME AUTHORIZATION Authorize the B I class profile of the authori
346. ns Use member INST20C if installing from CD ROM or FTP download STEP Gu UPDATE THE CICS STARTUP JCL Add the following DD statements to the CICS step in the CICS startup JCL 1 the CAFC Table File 2 the AFCFMSGS Messages File 3 the CAFC Trace output file 4 the CAFCPARM warm start parameter override file and 5 the CAFCOVER request override file Note The key length for all message records has changed so you must use the new CAFC4400 AFCFMSGS file in all regions where CAFC4400 is installed AFCF4000 DD DSN CAFC R4500 AFCF0001 DISP SHR AFCEMSGS DD DSN CAFC R4500 AFCFMSGS DISP SHR CAFCTRAC DD SYSOUT CAFCPARM DD CAFCOVER DD Make sure the CAFC Load library from Step 2 has been placed in the DFHRPL DD concatenation DFHRPL DD DSN CAFC R4500 LOADLIB DISP SHR NOTE DO NOT place an entry in any region s FCT for either the CAFC Table File AFCF4000 or the Message file AFCFMSGS DCB ATTRIBUTES FOR CAFC OUTPUT DATASETS DCB attributes for CAFCPARM dataset are DSORG PS LRECL 80 RECFM FB DCB attributes for CAFCTRAC dataset are DSORG PS RECFM F LRECL 132 DCB attributes for CAFCWTOS dataset are DSORG PS RECFM F LRECL 132 DCB attributes for all LOG datasets are DSORG PS RECFM F LRECL 128 DETAIL INSTALLATION STEPS C
347. ns will benefit four ation to calculate an to alloc to reope d CAFC s ate every file 3 time and n files that have SHRCTL macro in all of your production regions MVS ESA OS 390 CICS builds allocates in each respective pool initialization time on OSCOR is exactly the pool must be known to CICS before the pool try to use the SHRCTL macro as often as possible parameter PLTPI same you must use the multiple LSR pools when the first file is accessed The pools are either built at CICS system time or when CICS is fully active The affect Since the requirements for the resource or first data set is opened Do not use the RSCLMT Page 255 OPERAT ONAL LINKING TO CAFC S DYNAMIC ALLOCATION All CAFC functions shoul CONS DERAT ONS FACILITIES ld be requested through standard CAFC transactions If you have a requirement toprovide CAFC functions from a non CAFC program you can accomplish this through CAFC s on line API The user prog
348. ntial ling sequential terminal CAFC LOADLIB CAFC INSTALLATION CONTENTS Error Message List Panel Password Maintenance Panel Help Screen Page Header Panel Standalone Allocation Function Panel DBD DDname Table Edit Panel MRO CICS Selection Panel Customization Options Menu Trace Options Panel Panel Primary Option Menu Table Entry List Panel Function Entry List Panel Message Customization Option Menu Message Entry Customization Entry Edit Application Message Entry Edit Application Message Entry Edit Sub List Routing Entry Edit Application Message Entry Edit Routing List Browse Display Global Routing Screen AFCP2102 Report entry AFCP2102 table entry list AFCP2102 progress line AFCP2107 RDO request menu Table Maintenance Screen Application amp Group Table Entry Edit Screen CAFC Support Functions Menu Application amp Group Table Browse Screen Entry request menu for AFCP2103 t panel AFCP2502 tablefile change map CICSDDN CICSTXN USERID CTLRCD Table Entry Browse Member Mode Description AFCM20A MAP AFCM20B MAP Sign on Panel AFCM20C MAP AFCM20D MAP CAFC status panel AFCM20K MAP AFCM20L MAP AFCM20M MAP AFCM200 MAP AFCM20S MAP AFCM20V MAP AFCM20Y MAP Message Maintenanc AFCM201 MAP AFCM202 MAP Edit Entry Panel AFCM203 MAP AFCM204 MAP
349. ny data area The 1 to 4 chara assigned to the user start cter transaction identifier transaction you wish to Do not specify a termid if this transaction is to be executed in the background The 4 character on which the requested transaction is run If no term task will be sta not require comm optional terminal EIFLE Iden id is specified rted If a to be a separate transaction does unication with a terminal then none should be specified When a terminal is required it must be a local TCT entry The length of the data area if present with a maximum o The optional dat transaction Page 215 f 45 bytes a area to pass to the BATCH TO CICS INTERFACE BATCH INTERFACE STRT REQUEST CONTINUE The following is an example of a STRT request for the transaction USER with a 10 byte data area The transaction will run in the background of the CICS region with an APPLID of CICPROD1 Note that the comma for the missing termid is present in the command stream CICPROD1 STRT USER 10 1OBYTEAREA Page 216 BATCH TO CICS INTERFACE BATCH TERMINAL PROCESSOR TRAN REQUEST TRAN REQUESTS TO RUN COMPLEX TRANSACTIONS The B I program supports a separate mode called the Batch Terminal Processor BTP The BTP TRAN requ
350. o If to connect to all BATCH TO CICS INTERFACE regions even though specific ACB names have been coded in the B I Association Table AFCT2016 The format of the DEFACB parameter is PARM DEFACB x DELAYING THE TERMINATION OF THE VTAM SESSION FOR A LONG RUNNING TRANID A time delay for the Batch Terminal Processor LU0O may be invoked to allow the started user transaction to complete before the VTAM session is terminated The format of the TERMDLAY parameter is PARM TERMDLAY hhmmssth SWITCHING CAFC TABLE FILE DSNAMES A CAFC Table File dsname switch may be invoked by the FREEDSN keyword parameter If this parameter is set to Y the Table File data set name specified in the B I job step s JCL will be freed and the Table File data set name coded in the AFCT2016 table will be allocated and used by AFCP2016 The format of the FREEDSN is PARM FREEDSN Y FORCING DIRECT UPDATES TO THE TABLE FILE WITHOUT USING VTAM If you are certain a target CICS regions is down you feed the DIRECT parameter to CAFC through the PARM CAFC will immediately apply the requests for this region to the CAFC Table File The direct updates are performed without first checking that the CICS region is down If the region is active and the Table file is already open the requests to that region will fail with an open error Subsequen
351. o CICS or the VSAM control region from batch when any type of close is issued against a RLS file The file must be marked as RLS in CAFC Table File for the B I program to add the quiesce to a close request RLS support mus Default t also be activated value gt N AUTOMATIC UNQUIESCE This option directly to when set to Y will cause a Unquiesce command to CICS or the VSAM control region from batch when any type of open is issued against a RLS file The file must be marked as RLS in CAFC Table File for the B I program to add the unquiesce to a open request RLS support must also be activated Default value gt N Page 155 CUSTOMIZATION OPTIONS VSAM RLS SUPPORT OPTIONS CONTINUED PROPAGATE ENABLE This option when set to Y will cause all ddnames associated with the dsname being unquiesced to be enabled in each CICS where they are defined to CICS and CAFC The EXEC CICS Support option for RLS Support must be set to Y and active in all regions for this option to work properly Default value gt N PROPAGATE OPEN This option when set to Y will cause all ddnames associated with the dsname being unquiesced to be opened in each CICS where they are defined to CICS and CAFC The EXEC CICS Support option for RLS Support must be set to Y and active in all regions for this option to work properly Default va
352. ob STEPLIB concatenation Also ensure that the APPLID k parameter is specified in the SIT or SIT overrides To activa use the CICS execute statement below IP CICS EXEC where XXXXXXXX upon its completion program name DFHSIP required PGM AFCPS is the program AFCPS Normally Page 157 PY PARM SYSI XXXXXXXX The default causes AFCPS n this case no parm value other than PARM SYSI i N END XCTL XX CICS S init S CS startup JCL or through CAFC s AFCPWARM rary in the eyword te AFCPSI PY XXXXXxX PY is to transfer control to ijalization PY to transfer control TO N is ICS STARTUP CONS DERAT ONS CAFCOVER CAFC OVERRIDE REQUESTS AT STARTUP CAFCOVER and AFCPWARM run in the third stage of C Both programs are driven by the PLTPI program AFCP2010 CS PLTP processing CAFCOVER runs before AFCPWARM and processes any ad hoc CAFC requests that follow a
353. og records The Find command may be abbreviated to F The search for the specified characters will begin at the beginning of the first log record currently being displayed and move forward through all of the log records currently selected for display The Rfind command or Repeat Find command will locate the next occurrence of the character string e W u ntered as part of the Find command hen a character string is located it will be highlighted and the cursor will be placed nder the first position of the located character string Page 315 Sort Command MISCELLANEOUS CAFC UTILITIES The Sort command is used to reorder log records that are currently being displayed The sort command can only be issued from the command line of the viewer screen The format of the Sort commands is as follows Sort Field A D Field is the name of the column to sort on A D is optional and indicates whether to sort in ascending or descending order The default for this parameter is A The field and A D parameters may be repeated as many times as required to produce the desired sort results The following are the valid Field names Field DAT TIM APPLID Q A G zZ pa al R PROGRAM USERID T ti RM Example Command SORT APPLID A DATE Description Sort the records in date time sequenc Sort the records in date time sequenc Sort the records by the CICS A
354. on between the B I program and CICS specify option L in the connection type field To specify the EXCI connection for communication between the B I program and CICS specify option E in the connection type field Page 173 BATCH TO CICS INTERFACE CICS REGION STATE CHECKING Both the LU6 2 and EXCI B I programs attempt to establish a session with the target CICS regions If the target CICS region is active the on lin portion of CAFC receives the batch requests and performs the requested activities with updates to the CAFC Table File If the target CICS region s VTAM ACB is not Open Signaling that CICS region is down the B I program checks the CICS Region Up indicator CTLCUP to determine if the region was normally shutdown or if it has crashed If the region has crashed the Batch Interface program takes the action you have specified in the B I Customization Options panel There are thr options C Continue Batch Interface processing without consideration of the crash indicator CTLCUP In other words apply all requests to the CAFC Table File W Inform the MVS console operator if CICS has crashed and issue a WTOR for GO or Cancel If GO is replied the Table File will be updated If Cancel is specified the batch interface will terminate IT Terminate t
355. options will only be displayed if the RLS support option is activated After entering the item symbol for VSAM RLS SUPPORT from the Customization Option Menu the VSAM RLS SUPPORT parameters are displayed SET RLS DSNAME gt Y Y N UPDATE DSNAME IN FCT PLTPI AUTOMATIC QUIESCE gt N Y N QUIESCE RLS FILES ON CLOSE REQUEST AUTOMATIC UNQUIESCE gt N Y N UNQUIESCE RLS FILES ON OPEN REQUEST PROPAGATE ENABLE gt N Y N ENABLE ASSOCIATED FCTS WHEN RLS FILE IS UNQUIESCED PROPAGATE OPEN gt N Y N OPEN ASSOCIATED FCTS WHEN RLS FILE IS UNQUIESCED PROPAGATE DISABLE gt N Y N DISABLE ASSOCIATED FCTS WHEN RLS FILE IS QUIESCED PROPAGATE FREE gt N Y N FREE ASSOCIATED FCTS WHEN RLS FILE IS QUIESCED WAIT FOR QUIESCE gt Y Y N WAIT UNTIL QUIESCE REQUESTS COMPLETE SET RLS DSNAME If this option is selected or set to Y all FCT files defined as RLS will have there dataset names set into the FCT during CAFC initialization This option can be overridden by specifying SETRLSDSN Y or N in the CAFCPARMS st tartup override parameter file Default t value is gt Y AUTOMATIC QUIESCE This option directly to when set to Y will cause a Quiesce command t
356. or TXN record creating a new entry with the new entry name R RENAME an existing records L LIST values in fields of records Page 276 MAINTENANCE AND CONVERSION AIDS CAFC TABLE ENTRY MAINTENANCE FACILITY AFC5 CONTINUED P Delete specified record and all records specified in the list EX A PURGE of an Application list will delete the Application list and any DDname TXN and DBDLIST records specified within the Application list ENTRY TYPE The entry type which defines the type of CAFC table file record A Application record D DDname entry record G Group record P DBDlist record T Transaction record ENTRY NAME The Application list DBDlist Group list DDname or TXN entry name COPY ENTRY NAME The entry name for the COPY K request to create a new DDname or TXN record DATASET NAME The 44 byte new dataset name OLD DSN NODE Works in conjunction with NEW DATASET NODE to replace matched strings ina dataset name The Old Dataset Node is the string specified for matching against the dataset name data NEW DSN NODE This field is the string replacement data when a match is found using the Old Dataset Node TABLE TYPE This field specifies data set type of record created via ADD A request DD FCT Ddname D gnore Ddname DJ JCT Ddname DO Non CICS Ddname DP DLI Phy
357. or many tended Op intercept types for that region Pxx from tem symbol for Menu tended su All four t program of Cl ti CO the LPALI th tion dat B e C ppor funci s d ot tiviti S ta que the in NO to avoid a U601 D CONS DERAT ONS thin a DFHAIPXX tup of Cl CS programs ABEND at star SUPPORT EXEC Cl CS SUPPORT OPTI t requires a prerequisite tions drive the dynamic installation of t programs are generally compat NETEC an ther vendors have had CS s standard exit CS ac if you want CAFC to add commands that change the DCT extrapar tions are se es The transparent tatus of ues and tercept CS from the ONS menu is displ instal layed lation th other vendors to resort to these ts do not offer processing se activities must be t additional functionalit FCT resources DLI transactions If all of the programs will not be loaded tible wit Cy PROVIDE EXTENDED SUPPORT FOR INTERNAL CICS FUNCTIONS CAFC offers a variety of automatic met resulting from CEMT commands or EXEC C CS resource defined Activat ex plicit to a C command to open a file CAFC to update and maintain stat ICS inte to CAFC ting the following support types all thods for intercepting s
358. or this option Page 97 CAFC FEATURES AND CONSIDERATIONS B I EXCI CUSTOMIZATION OPTIONS CONTINUED EXCI SECURITY For a compl lete discussion of EXCI security please s the appropriate CICS EXCI manual for the versions of CICS you are executing The CICS EXC interface utilizes CICS IRC to communicate with a CICS region and the security features are the sam connections CICS applies security checks in several ways against requests received from the B I for the B I as those for CICS MRO These checks fall into one of four areas MRO logon and connect security performed by DFHIRP link security performed by the CICS region applicat user security checking done in the CICS tion program and surrogate user checking performed by the external CICS interface in the B I program address space MRO logon and bind time security specific connections only DFHIRP the CICS inter region communication program performs two security checks against users that want to either logon to or connect to a CICS region also referred to as bind time security This logon security checking applies only to B I program executions that are utilizing CICS connect securi which CICS connect the B I the B I tions that are defined as SPECIFIC connectio
359. ords that are written to the MVS system logger CAFC relies on the log stream definitions to specify archive and automatically delete CAFC log records If is recommended that a log record retention period be established and this period be included in the log stream definition via the RETPD and AUTODELETE key words The RETPD keyword should be used to specify the number of days to retain a log record and AUTODELETE YES should be specified to cause the records to be automatically deleted after the retention period has expired If should be noted that the system logger deletes log records on a log dataset bases The system logger will only delete a log data set after all log records found in the dataset have reached their RETPD period This may result in CAFC log records being retained longer than the user would expect The use of RETPD and AUTODELETE are only a recommendation and the user may architect their own solution for the archiving and deletion of CAFC log records Determine if a DASDONLY log is right for the environment Page 306 MISCELLANEOUS CAFC UTILITIES The MVS system logger will either create log streams on DASD or in a coupling facility structure If the MVS system logger will be used to merge CAFC logs from multiple CICS systems it is necessary to decide if a DASDONLY or Coupling Facility log is correct This is determined based on where t
360. ort that w request is iss its own MVS RE SVC 99 is not been staged an eliminates lon allocation truly availabl other requests for dynamic allocation are simultaneously honored if CAFC will C hav xperienc Storage Manager ONS DFHSM d delays and s whenever migrated data sets must be dynamically ese conditions normally occur whenever a migrated data set Control to allow other allocations to start is o CICS until the current data set has been fully restored to archive media SVC 99 is a it cannot be used for subsequent ccessfully processed the delay is dependent upon the length of time it tak single threaded fa allocations unti cility l the migrated If the archive media is magnetic s th unt the tape and respond to ocation requests are queued e impact SVC 99 s single thr the mount message up and CICS waits eading CAFC offer ill detect ued CALL request and postpones DFHSM migrated da ta sets before th When CAFC encounters a migrated data set the data set al loca tap All s optional HSM an allocation it schedules committed until CAFC has determined that the data set has dis ina state where it can g waits in the CICS region e While CAFC is waiting fo can execute wi that can be ru 2 MVS RECALL req authorized pri during normal tho nd ut
361. ould be used to define the generic EXCI session Sessions EXCISESS Group EXCIGRUP DEscription gt CAFC EXCI Session Definition SESSION IDENTIFIERS Connection gt EXCI SESSName gt NETnameq gt MOdename gt SESSION PROPERTIES Protocol gt Exci Appc Lu l Exci MAximum gt 000 000 0 999 RECEIVEPfx gt lt RECEIVECount gt 002 1 999 SENDP fx gt SENDCount gt 0 999 SENDSize gt 04096 1 30720 RECEIVESize gt 04096 1 30720 SESSPriority gt 000 O 255 Transaction OPERATOR DEFAULTS OPERId OPERPriority 000 0 255 OPERRS1L 0 OPERSecurity 1 PRESET SECURITY USERId gt OPERATIONAL PROPERTIES Autoconnect gt No No Yes All INservice Yes Buildchain gt Yes Yes No USERArealen gt 000 Q0 255 TOarealen gt 04096 04096 0 32767 RELreq gt No No Yes DIscregq gt No No Yes NEPclass gt 000 0 255 RECOVERY RECOVOption gt Sysdefault Sysdefault Clearconv Releasesess Uncondrel None RECOVNotify None None Message Transaction Page 188 BATCH TO C BATCH INTERFACE INSTALLATION STEPS DEF N NG THE EXCI Step lc CS NTERFACE CONTINUED CONNECTION The following parameters should be used to define a specific EXCI connection for use by the CAFC B I pro
362. own for Batch I Sample JCL to unlink DFHOCP Sample JCL to transfer CAFC Table File records from one CAFC Table File to another Table File CAFC XLT entries for Batch CAFC LU6 2 VTAMLST Cl for CPU 1 in a dual CPU environment CAFC LU6 2 VTAMLST APPL terface Syst terface Syst Interface System le Control Record CL to convert JCL DDcards to CAFC Table entries tem in a single tem in a dual CPU DRSC Entry for Batch D Entry for Batch Interface System Interface System for CPU 2 in a dual CPU environment CAFC LU6 2 VTAMLST Cl for CPU 2 in a dual CPU environment CAFC LU6 2 VTAMLST APPLI DRSC Entry for Batch D Entry for BATCH Interface System Interface System in a single CPU environment or the CAFC VTAMLST APPLID Entry for Batch Interface System for CPU 1 ina dual CPU environment le Jcl to process job to reset CTLCUP flag in ctlred DF SOAEDR DFSAOENT to AFCP2016 pport Samp J CICS EXCI options table Sample Jcl to link Sample Jcl to link Sample DFSPZP table Sample Jcl to link Sample Vtam Appl for LUO su Sample TCT Entry for LUO su Sample LU6 2 TCT entry with Sample table entries for inst terminal Sample table entries for inst X ppor FY Page 325 ing a seque
363. pplid that created the log record Sort the records by the log record type Sort the records by the item for which the log record was created Sort the records by the resorce typ Sort the records by the resource typ Sort the records by the request type Sort the records by the request type Sort the records by the message number Sort the records by the message text Sort the records by the job name that created the log records Sort the records by the job number that created the log records Sort the records by the program name that created the log records Sort the records by the userid that created the log records Sort the records by the terminal name that created the log records Results TIME Sort the display records by the Applid that created the records and in time sequence within the Applid Page 316 MISCELLANEOUS CAFC UTILITIES Trace Command The Trace command is used to activate or deactivate the NETEC International internal trace facility from either the initial selection screen or the viewer screen The trace output will go to a DD Statement of CAFCTRAC DD SYSOUT A as part of the TSO Userid job A different SYSOUT class can be specified by add a CAFCTRAC DD statement to your TSO proc To activate trace the following command is entered on the command line TRACE ON To Deactivate trace the following command is entered on the command line
364. program Indicates to the B I that this is an xcontrol program request The program will xecute under the AFCE transaction which will be started asynchronously by the AFCB transaction The user program name to execute in FEGLON Cee hence S The optional COMMAREA to pass to the program This area wi CI CS ll always be passed as a 45 byte area padded with trailing blanks This field is only required if TWA data is to be passed Size of required TWA size will be verified against the TWA SIZE Page 212 This BATCH TO CICS INTERFACE specified in the transaction definition to be sure the TWA is the size the user program expects nnnn can be from 1 to 32760 Optional data to move to the user TWA Page 213 BATCH T O C CS NTERFACE BATCH INTERFACE EXEC XCTL AND XPGM REQUESTS CONTINUED XPGM REQUESTS TO START A Cl XPGM requests generate an EXEC C AFCX transaction running on a sequential synchronous program has completed execution duration user program may result time out The XPGM request ICS COMMAREA to be passed with Check that program to G that is your B I complete CS PROGRAM CS L NK the AFCB before returning in a B I val To use this request type you mus C Interface is provide default XP definition updated yo and PPT de
365. quest that saction disconnect from the current ection in an orderly fashion ISconnect keyword is required on The CONnect key word request the AFDB trans DB Control ate Th mod Con omi IMMediat ule that is trol connect ted default cified when CT g ion s to 0 the CI Sp las The you opt specified in the con Thi the Con thi request is canceled and the AF activated DBC If o ional mitted nection s param keyword is opt this disconnect request is The SUFfix keyword species This 0 or CS f to b the s immediat to used when starting this C top the tiple th the CICS supplie the 3270 bridge transaction CS Transaction Server Version 1 3 to ction and eliminate the need for multiple user transaction normally requires transaction follows tional and species uffix for the d CDBG The format of the action Either the CONnect or ISconnect keyword is required on the AFDB the AFDB DB Control Either the CONnect the AFDB that DFSPZP ICS DB parameter is optional and if DB Contro tlid keyword specifies th wish CICS to connect with the DFSPZP table will be r species th DB Control used amount of time AFDB transaction is to wait for the request trol system to either connection or disconnect s tim s th
366. r of CAFCPARM has b Table File to AFCF4000 statement for this file must be present in CI you will experience an AFCF ABEND program AFCP20 and from your Place AFCP20 table and reassemble procedure Run the AFAC transaction C s APF authorization method is properly installed CICS and 2 the he DFHRPL extended s ues or The D upport DLI described in to verify that roi D CS startup J PPT or CSD 10 after the See the chapter entitled C If you have applications wh as READ BROWSE DELETE entry to be open on first UNLOCK access OPEN Extended Support Option for CAFC to intercept perform an automatic dynamic allocations DERAT ONS ICL AF DFH that controls the warm n replaced by CAFCPARM now specified as sysin parm data with a ddname Remove any reference to AFCSTART from your CIC ICS STARTUP CONS ich issue implicit open requests su or STARTBR and expect the FCT Review them and set the VSAM DFHRPL SRCH nsure it 29 no longer exists CP2029 DELIM Warm S JCL eh you must a Customization Options Support EXEC CI CS Page 25 ctivate the MPL CIT t the request and Review the chapter on CAFC RELEASE MA NTENANCE MIGRATION CHECK LIST CONTINUED 14 Update any other libraries that contai
367. r 3270 full screen transactions 239 B I starting user 237 Sy transactions B I starts transactions 234 B I step return code processing B I Step Return Code processing 25T 246 B I TCT entries 8 B I Timeout value B I Timeout Value B I Timeou B I Timeou A t etc parameter 92 B I TIMEOUT Values B I TIMEOUT Values B I TIMEOUT Values B I TIMEOUT Values request 90 B I to activate on B I Trace activation 92 90 94 value default 92 value override for BTP 90 for the B I 90 for the LUO 90 for XPGM line Trace 214 214 B I TRAN Request Card Format 237 B I TRAN Request Card Format SBA format 239 B I Tranid 98 B I Transaction ID Request 90 B I USERID Options B I uses 36 for for XPGM 95 B I Vtam Applid Sample parameters Interval for free LU 94 XPGM Request Timeout Value 1 XPGM Request Transaction Id 254 B I Wait B I XPGM Request Timeout Value 104 B I 100 104 B I 100 102 104 B I XPGM Sequential Terminal Id 104 B I 100 base 104 XPGM Sequential Terminal Id installation procedure summary 2 Batch CAFC Table File Entry Report program AFCP2021 321 Batch jcl for executing Extended CAFC Table Mainenance Commands 288 Batch Report for Table File Control
368. r CAFC Extended Tablefile tablefile maintenanc batch or onl Copy command will thority for these requ ine requests require Batch jobs be required ests to be successful transaction name for a The new name is AFSO instead of tion to issue CAFC requests from the sequential terminal ty has been enhanced TopSecret and RACF by passing sign on You now sec uses normal MRO security the STEPLIB PDS The new versions of AFCPSIP into your authorized STEPLI the CUSTOM AFCPS CS as OPENTIME STARTUP nction Management Header FMH5 ZAT PY remo These programs wil If you plan to use CAFC s Early Allocation Facilities The EXCI Use the AFCC tly enter 3270 CAFC requests without having to e AFCS tranid ure the If you will be using CAFC to allocate FCT ddnames that are you must activate the NITIAL in this Review the SUPPORT EXEC CICS options ON OPTIONS section A ve AFCPSIP1 B PDS Page 27 ll be loaded out the AFCPSIPX and AFCPS AFCPSIP2 and AFCPS FCPSIP P3 from DFHRPL PY should be copied CAFC FEATURES AND CONSIDERATIONS CAFC FEATURES AND CONSIDERATIONS This section deals with optional one or more of your CICS regions The topics listed are facilities that you may wish to use in Remo
369. r terminal owning region The CSD group CAFCMRO should be added to the terminal owning region This group contains the mapset program and initial AFCT1000 table Modify the transid names as necessary Page 63 CAFC FEATURES AND CONSIDERATIONS MRO REGION SELECTION SCREEN CONTINUED CSD GROUP AOR DOR Example These PCT Tabl ntries define the connections between each AOR and its corresponding TOR A normal CICS region has the two transids that are AFCS and AFC2 this example uses the third character of the transid to be the system identifier and the fourth character to be the unique transaction identifier NOTE THAT YOU CAN CHOOSE YOUR OWN NAMING STANDARDS FOR ALL OF THESE TRANSIDS TRANSACTION AOCS PROGRAM AFCP2010 PROFILE DFHCICST TRANSACTION AOC2 PROGRAM AFCP2001 PROFILE DFHCICST TRANSACTION AFCA REMOTESYSTEM TORA REMOTENAME AFCA TRPROF DFHCICSS lt lt The CSD group CAFCAOR on the installation tape s CSD file is provided as an example only for your application owning region AOR data owning region DOR This group contains the two local transactions and the one remote transaction for each AOR NOTE THAT THE TRANSID NAMES ARE CHANGEABLE Activate the termid error exit DFHXTENF for exit points XICTENF and XALTENF in the AOR DOR regions Thi
370. ram builds a CAFC function request parmlist and LINKs to AFCP2008 The B I also offers a documented API for this activity The Installation Tape includes a DSECT of the parmlist AFCD2007 The requesting program must be a command level CICS program The following fields must be present in the parmlist AF7REQST The 8 byte blank filled CAFC Request Code O OPEN DATASETS DLI DBS CLOSE DATASETS DLI DBS CE CLOSE AND ENABLE EC FORCE CLOSE DATASET A ALLOCATE DATASETS DLI DBS F FREE DATASETS DLI DBS L LOCK DATASETS DLI DBS U UNLOCK DATASETS DLI DBS D DISABLE TRANSACTIONS E ENABLE TRANSACTIONS S STATUS OE OPEN DATASETS DLI DBS AND ENABLE TRANSACTIONS DC DISABLE TRANSACTIONS AND CLOSE DATASETS DLI DBS UO UNLOCK AND OPEN DATASETS DLI DBS CL CLOSE AND LOCK DATASETS DLI DBS EF ENABLE FCT DCT EXTRAPARTITION JCT ENTRY DE DISABLE FCT DCT EXTRAPARTITION JCT ENTRY RO SET DLI VSAM ACCESS TO READ ONLY UP SET DLI VSAM ACCESS TO UPDATE RD SET DLI ACCESS TO READ WITH INTEGRITY EX SET DLI ACCESS TO EXCLUSIVE ID DYNAMIC INSTALL OF A DCT TRANSIENT DATA QUEUE DBD DLI DUMP DBR DLI RCVR UOE ENABLE OPEN AND UNLOCK DCL DISABLE CLOSE AND LOCK N UNQUIESCE DATASETS V SET DATASETS AVAILABLE VN SET DATASETS AVAILABLE amp UNQUIESCED NO UNQUIESCE amp OPEN DATASETS VO SET DATASETS AVAILABLE amp OPEN VNO SET DATASETS AVAILABLE UNQUIESCED amp OPEN Page 256 OPERATIONAL CONSIDERATIONS
371. rams required 204 211 B I exit to interrogate jobstep codes 251 B I external security 246 B I facility to change dsnames 345 B I failures from no SONSCIP parm 22 B I for initiating CICS programs 3 6 23 0 232 233 B I Job Step JCL Sample 213 B I Logic to Select ACBs 259 B I LU names 94 B I LUO Sign on 241 B I LU6 2 vs EXCI 189 B I Message Frequency 94 B I Multiple LU names for LUO terminal processor 243 B I parameters with CAFCPARM 213 B I Performance 192 193 B I RDO Definition 8 265 B I region crash actions 190 B I Region Crash Option Return CODE 97 B I request completion return code field 62 B I Request Exit Program 249 B I request updates without Vtam 218 B I requests applied directly to CAFC Table File 218 B I requests from user programs 245 B I requests to multiple CICS regions 196 B I Secure CEMT trans option 90 95 104 B I Security Exit Program 194 249 B I Security information 34 B I Security Information 27 196 B I Sequential terminal id for XPGM Request 90 B I Sign on Error 8 B I Sign on exit program 247 B I Sign on Exit Program 220 248 B I Sign on for multiple regions 196 B I Sign on format 220 B I Sign on information sources 194 B I Sign on Method 8 90 94 B I Sign on name and password 95 B I SONSCIP parameter required 201 B I starting use
372. rd are provided in either the B I job step JCL or in the AFCF4000 Table File Page 90 CAFC FEATURES AND CONS B I LU6 2 CUSTOMIZATION OPTIONS CONTINUED include a D D statement your CICS APPLI The CAFC Batch Diy inm EN Interface will The SIGNON METHO is specified as NONE parameters S Defa IGNON METHOD FOr e Batch If your sign on information is stored in the CAFC Table File the CAFC Table File DERAT ONS you must with a ddname matching L not attempt a sign on if the SIGNON METHOD D is always determined by the Interface jobstep s JCL ntered into the Customization Options IGNON NAME IGNON PASSWORD FMH5 Default value ult value SECURE CEMT TRANS gt gt Default value gt BATCH JOBNAME USERID Default value gt use VTAM s FMH5 signon If 1 the CAFC AFCB transaction requires XT rnal security or 2 a th security level grea e FMH5 sign on met ATTACHSEC DENT th authorized field is on with CI have access s defa NONE use no signon NONE DFHSNT The Operator Name may be up to 20 bytes long r thod FY parameter to the CONNECTION for e LU6 2 definition to execut left blank C
373. rds which are contained in the SYSIN data set are structured as JCL DDCARD These are the JCL dd st follows tatements you wish to be converted into CAFC ddname entries The conversion program assumes the JCL cards to be in the following format ddname dataset name in cols 1 2 beginning in col 3 and 1 8 characters long beginning after the character string DSN and ending before a comma If the JCL card does not meet the above format an error message will be printed and processing continues with the next card Page 286 MAINTENANCE AND CONVERSION AIDS GENERATE DDNAME RECORDS FROM JCL_DD STATEMENTS CONTINUED 4 A VSAM CAFC DDname Table Record created as a result of a successful conversion will have the following attributes Data set type DD Data set name NULLFILE Disposition S Data set type D Invoke msg facility N Free at close time Y Automatic allocation Y Warm start override 1 M Warm start override 2 M Warm start override 3 MM CAFC security 0 Altername Dataset name flag N Record Level Shring N Auto Enable on Allocate Y Auto Enable on Open Y Auto Disable on Close Y uto Disable on Free Y low Read Access Y low Browse Access Y A Y Y N low Update Access low Add Access low Delete Access Subsystem Flag PPPS PP 5 The CAFC Table Fil
374. re 00 Normal Return 04 Partial Completion Warning Return 08 Complete Event Failure Default value gt 00 TEXT This is the actual message text that will be sent to the specified terminals It may contain any sequence of displayable EBCDIC characters including special characters There are five 5 parameters that may be specified to direct the message facility to substitute certain values prior to the message being sent These parameters must appear as shown If any user character string matches any of these parameters then the system will substitute the proper value for the parameter before th message is routed to the terminal The parameters are listed below APPLDDN This is the Application DDNAME or Application Transaction that triggered th vent 8 characters REQUEST This is the specific function that triggered th vent The length is variable 1 to 5 characters depending upon the function STATUS This is the return code from the function 2 characters DATE This is the current CICS date in the form MM DD YY TIME This is the current CICS time in the form HH MM ATTRIBUTE This gives the intensity of the message when it is displayed on a CICS terminal Only the first character needs to be entered Its values and abbreviations are shown BR Highlight Bright intensity abbrev B NM Norm
375. re or after commands have been issued COMMANI D PURPOSE COPY rpl list Copy the RPL specified by RPL list name into this name RPL edit session COPY DFHRPL Copy the current RPL into this RPL list edit session Example COMMAND INPUT gt COPY RPLA This command will cause the contents of the RPL list RPLA to be copied into the current RPL edit session COMMAND INPUT gt COPY DFHRPL The above command will cause the datasets in the current DFHRPL concatenation to be copied into the current RPL edit session The editor will automatically assign and associate symbolic ddnames to each PDS Page 45 CAFC FEATURES AND CONSIDERATIONS DFHRPL LIBRARY MANAGEMENT CONTINUED RESET COMMAND The RESET or RES command will remove any previous pointers set by the B efore A fter M ove or C opy commands COMMAND OPERAND PURPOSE RESET None Remove previously set B efore A fter M ove or C opy pointers Example COMMAND INPUT gt RESET SAVE COMMAND The SAVE command will cause the currently edited RPL list to be saved to the CAFC control file COMMAND OPERAND PURPOSE SAVE None The contents of the current RPL edit session will be saved in the CAFC Table file Example COMMAND INPUT gt SAVE Page 46 CAFC FEATURES AND CONS DFHRPL LIBRARY MANAGEMENT CONTINUED PERFO
376. ree DRS fields the first is ries are represented in tus field is set to m the CAFC REQUEST screen of a CAFC application or o disabled whenever a the latest mbered by CAFC in the NON ver a CAFC O request is a CAFC application or for a CAFC OE request similar fashion the DRS DC requests to F requests Thus the DCT entry is remembered for Open Status the second for Enabled Status and the third to Access Status The first two FCT DRS fields are set exactly the same way as t fields of the DCT entries described above except an additional value of unenabled The unenab the FCT entry becomes unenabled as a result of a he corresponding DRS the Enabled Status has led value is set whenever close request If you must know the unenable value is set if the FCT entry was not disabled before and the CAFC close request was completed not automatically disable the entry in support o Page 164 In this case CAFC will f the close request ICS STARTUP CONS DERATIONS DESIRED RESTART STATUS DRS TUTORIAL CONTINUED The third FCT update set to screen OPENED RO and UP request readonly whenever an but you sho Therefore It is set to before the CAFC request part of a CAFC applicat obvious only set the Access CS update DRS field for Access Sta
377. registered to CICS NOTE CEMT Set commands issued from user programs running during PLTPI processing will not have any user exit processing NOTE Each CAFC record is obtained with GET for UPDATE Be sure you are working with the proper record format This exit allows you to alter any CAFC Table File record If you inadvertently damage the record key or data critical to CAFC s operation CAFC may cease to function or cause other unpredictable results NOTE The Pre Free exit point will only be driven for explicit FREE requests The following rules apply to the coding of programs that use these exits 1 The exit program must be a CICS COMMAND level program 2 The exit may use any valid program name To avoid confusion we recommend that you use the name AFCP2UEX 3 The exit program name must be specified in the CAFC EXIT OPTIONS PANEL 4 The exit program must be specified in the CICS PPT 5 Upon entry to the exit Register 1 will be pointing at a parameter list This parameter list contains only one entry which is the address of parameters defined by member AFCD2017 in the MACLIB The fields contained in the parameter list are described below THE CAFC TABLE FILE RECORD IS UPDATABLE FROM THESE EXIT POINTS AFXEXITP DS CLI EXIT POINT TYPE AFXPRALO EQU 1 PRE ALLOC
378. requirements are RECFM he LRECL 32 BLKSIZE 132 Page 120 CAFC FEATURES AND CONSIDERATIONS AFCPSIPY EARLY ALLOCATION OPTIONS Pictured below are the parameters for updating CAFC s AFCPSIPY Early Allocation option AFCPSIPY WARM START EARLY ALLOCATION OF DCT AND JCT ENTRIES ALLOCATION FAILURE gt B R ISSUE WTOR AND AWAIT REPLY B BYPASS WTOR AND CONTINUE WARM START ALLOCATION FAILURE OPTION If the allocation of a data set fails during AFCPSIPY processing at system initialization time you may control whether or not the MVS operator should receive the WTOR message AFCPSIP3 Reply Go or Cancel If prompted the operator s response will determine whether CICS initialization continues or is terminated If you elect to bypass prompting CICS initialization continues despite any allocation failures CAFC provides the following two values for this option R Require operator to reply to message B Bypass message processing and continue CICS initialization Default value is gt R NOTE Do not bypass message processing in your production regions Page 121 CAFC FEATURES AND CONSIDERATIONS REQUEST OPTIONS Pictured below is the REQUEST OPTIONS panel for updating CAFC options related to CAFC request processing These options customize the way CAFC processes Opens
379. rity Exit Program JCL Sample JCL to assemble the Batch Interface Condition Code exit program JCL Sample JCL to assemble the RACF sample External Security Program JCL Sample JCL to assemble the Batch Sign on Exit JCL Sample JCL to assemble the Top Secret ACF2 sample External Security Program JCL Sample JCL to assemble the Allocation Free Open Close User Exit Program JCL Sample JCL used to assemble AFCTXCLD exclude table JCL Sample JCL used to assemble the CAFC Batch Interface APPLID Association Table Page 324 CAFC INSTALLAT CAFC INSTLIB CONTINUED ASMT1000 JCL ASMT2060 JCL ASMT2216 JCL CAFCBRPT JCL CAFCCTLR JCL CAFCCVDD JCL CAFCPLTI TABLE CAFCPLTS TABLE CAFCTCT TABLE CAFCTCT2 TABLE CAFCUNLK JCL CAFCXFER JCL CAFCXLT TABLE CAFVT71C TABLE CAFVT72 TABLE CAFVT72C TABLE CAFVT7A TABLE CTLCUP JCL DFHXCOPT JCL DFSOAEDR JCL DFSAOENT JCL DFSPZPOO JCL LINK2016 JCL LUOAPPL TABLE LUOTCTO TABLE LUOTCT6 TABLE TCTSEQT TABLE TCTSEQX TABLE Sample Jcl to assemble AFCT1000 Sample Jcl to assemble AFCT2060 Sample Jcl to assemble AFCT2216 Sample JCL to print CAFC Tab Sample JCL to print CAFC Tab Sample J CAFC PLT Entries Init ON CONTENTS ntries tialization CAFC PLT Entries CAFC TCT Entries CPU environment CAFC TCT Entries environment for Batch Shutd
380. roprietary NETEC developed method of userid inheritance To invoke userid inheritance include the AFSG transaction as the first transaction the list of transactions to be executed through the LUO interface All transactions that are to be executed under the security provided by the AFSG transaction must be a continuous transaction stream That is you MUST PLACE a C in column 72 of the AFCP2016 control card input userid Below is an example of a series of transactions that invoke inheritance of the initiating batch job under RACF CICS99E TRAN AFSG C 1 CICS99E TRAN CEMT I TAS G 2 CICS99E TRAN I TAS c 3 CICS99E TRAN 03 G 4 CICS99E TRAN CESF LOGOFF E 5 NOTES 1 The AFSG transaction causes the RACF ACF2 userid under which the The PF Key 3 terminates batch job AFCP2016 is currently executing to be signed on to the CAFC LUO terminal under CICS The CEMT transaction is executed on the target CICS region However prior to execution the user s batch job userid ability to execute CEMT is verified by RACF Statements for additiona l CEMT syntax the CEMT transaction The CESF transaction signs off the userid that was signed on through the AFSG transaction Insure you have provided the PCT entry for transaction AFSG with AFCP2SGN as the program name Also provide PPT entries for AFCP2SGN A
381. rors our users experienced when migrating from an older version of CAFC to CAFC Release 4 5 1 Convert your CAFC Table File following the instructions in Step 6 of the DETAILED INSTALLATION STEPS Follow each sub step DON T TAKE SHORT CUTS 2 You must reassemble all of your CAFC user exit programs using the new macro libraries and the new DCECTS If you are using the standard LOADLIB supplied versions you may skip the assemblies 3 If you are using the B I to start user written CICS transactions or programs from batch not CAFC functions review the sections on the TRAN STRT EXEC and XCTL requests TRAN LUO and STRT LU6 2 were enhanced They offer an expanded control card format The improved STRT request initiates transactions that do not send confirmation responses to the initiating CICS terminal It offers a data area that can be passed with the tranid 4 If 1 you are using the AFCT2016 batch APPLID ACB association table the AFCT2016 Table MUST BE REASSEMBLED with the new macro libraries 5 CAFC error messages now have a four position number associated with them This text is stored in a separate file AFCFMSGS which can be shared across regions You may have to rewrite user documentation describing error conditions Check that a DD statement for AFCFMSGS is present in each region s startup JCL and that it references t
382. s CAFC FEATURES AND CONSIDERATIONS SET RETURN CODE 137 FOR STATUS REQUEST If this option is set to Y CAFC will set the return code to 137 on completion of a status request if the dsname for the ddname is still allocated to another task Page 126 CAFC FEATURES AND CONSIDERATIONS EDIT OPTIONS Pictured below is the EDIT OPTIONS panel for updating CAFC options related to CAFC edit processing SORT OPTIONS APPLICATIONS ITEMS gt Y JI SORT BY ITEM NAME ONLY Y SORT BY ITEM TYPE ITEM NAME N DO NOT SORT ITEMS DLI COMPONENTS gt Y Y SORT SORT DLI COMPONENTS BY NAME N DO NOT SORT DLI COMPONENTS GROUP ITEMS gt Y Y SORT GROUP ITEMS BY APPLICATION NAME N DO NOT SORT GROUP ITEMS MISCELLANEOUS OPTIONS ALTERNATE DSNAME gt Y Y PRIMARY AND SECONDARY DSNAMES ALLOWED N SINGLE DSNAME ONLY ALLOWED AUTOMATIC SAVE gt Y Y AUTOMATIC SAVE WITH PFK3 ON EDIT PANELS N EDIT UPDATES DISCARDED WITH PFK3 DELETE RECORDS gt G S SPECIFIC ITEM DELETES ALLOWED G GENERIC DELETES ALLOWED N NO DELETE OPERATIONS ALLOWED RENAME RECORDS gt Y Y RENAME OPERATIONS ARE ALLOWED N NO RENAME OPERATIONS ARE ALLO
383. s te AFCB the connection will ult userid to the AFCB transaction than O1 then you MUST USE Add the Specify a Security name If the security name be logged so this userid must in the CICS sign on Table If the operator name is used here you must supply a valid password Up to 8 bytes long specifying the Operator s Password as specified in the External Security Manager s or Cl NONE request is Issue QUERY SECURI issued USE BATCH JOBNAME AS USER N USE CS Sign on Table DFHSNT TY check when BATCH CEMT command N LOG MESSAGES D Y USE BATCH JOBNAME AS USERI D USER D N LOGS Page 91 CAFC FEATURES AN B I LU6 2 CUSTOMIZATION OPTIONS CONTINUED BATCH INTERFACE ONLINE TRANSACTION CODE The B I uses a default transact CICS components If you wish the B I desired transaction code has been assembled in the program of AFCP2015 Default value NOTE LE in gt AFCB DSNAME CHANGE ONLINE TRANSACTION CODE The B I the B I tranid in the Check that your new table and Default value Note If in BATCH INTERFACE ACTION IF The CICS region UP indicator AFCP2020 uses a default transaction code of whenever a data set name change request is issued tion code of AFCB to change the B I Online Transact
384. s 315 AFCT WARM Transaction for CAFC Warm Start 347 AFCT WARM Transaction for CAFC Warm Start 317 AFCT2016 B I CICS ACB Association Table 193 194 205 AFCT2016 B I Table entry for LUO support 243 AFCTXCLD Exclude Table 81 AFCX Transaction driver for XPGM request 36 AFDB Transaction for starting and stopping DBCTL CICS interface 349 AFSG terminal signon transaction 244 AFSG Transaction for B I Sign on 348 AFSG Transaction for LUO terminal sign on 244 AFSQ Transaction for console CAFC requests 269 AFSQ Transaction for non 3270 CAFC requests 266 349 AFST Transaction for direct status requests 349 Allocating DCTs required for CICS initialization 30 Allocating files on first access 30 BTP RACF APF Authorization APF Authorization APF Authorization APF Authorization API for the B I API to CAFC on line APPLID Selection Program locating migrated data sets 141 locating Non FCT Critical Files 176 location deactivating CAFC Automatic services 311 location Options 134 location prior to CICS SIP processing 84 130 172 location waits on DFHSM 38 ltering CAFC record fields lternate Dsname activation lternate Dsname Option 62 140 lternate 174 285 139 138 Dsname Switch Request 34 14
385. s IBM program development products 10 SCLM SW Configuration Library Manager 11 Workplace ISPF Object Action Workplace C CAFC CAFC Log Stream Viewer Addition INIT PROC IF amp ZCSTF 1 ATTR GRPBOX1 WIDTH 0O IF CURSOR TMPROWS AND amp ZCMD amp ZSAR TRANS amp ZSCREEN 1 amp ZSAREA1 2 amp ZSAREA2 3 amp ZSAREA3 4 amp ZSAREA4 IF amp ZSAR CAL UPS SES amp ZCMD SP amp ZSEL TRANS TRUNC amp ZCMD 0 PGM ISPISM SCRNAME SETTINGS 1 PGM ISRBRO PARM ISRBROO1 SCRNAME VIEW 2 PGM ISREDIT PARM P ISREDMO1 SCRNAME EDIT 3 PANEL ISRUTIL SCRNAME UTIL 4 PANEL ISRFPA SCRNAME FOREGRND 5 PGM ISRJB1 PARM ISRJPA SCRNAME BATCH NOCHECK 6 PGM ISRPTC SCRNAME CMD 7 PGM ISPYXDR PARM amp ZTAPPLID SCRNAME DTEST NOCHECK 8 PANEL ISRLPRIM SCRNAME LMF 9 PANEL ISRDIIS ADDPOP 10 PGM ISRSCLM SCRNAME SCLM NOCHECK 11 PGM ISRUDA PARM ISRWORK SCRNAME WORK L PGM AFCP2600 NEWAPPL CAFC PASSLIB Addition X EXIT SP PGM ISPSAM PARM PNS pte th amp ZTRAIL TRAIL END PNTS The modified panel should look something like the following Page 305 MISCELLANEOUS CAFC UTILITIES Penny Se aes Menu Utilities Compilers Options Status Help ISPF Primary Option Menu Option gt _ Settings Terminal and user parameters User ID U2TEC8 1 View Display source data or listings Time 08 0
386. s can easily be updated several times a day versus once at night Fewer reruns because your batch scheduling system will always have the files it needs for its batch jobs Expanded on line availability because read only applications remain concurrently active during batch updates Reduces scheduling constraints because batch updates no longer depend on available human resources Start critical CICS system and user transactions and programs from batch job streams Page 35 USING THE B I This via CAFC s B I EXEC XCTL XPGM facility requests ru Transaction returning con passed from requests ru B I compone programs which in tu CAFC FEATURES AND CONS Ther DERAT ONS TO EXECUTE A CICS PROGRAM thr n WI CEO n n ar the user program synchronously to the B I the user program asynchronously ts will start the CAFC AFCE transaction in the background rn performs an EXEC CICS XCTL PROGRAM The AFCB B B I A 45 requ es requ requ sequ with est en commarea ma tial terminal then inputmsg minutes for the user program I Transaction W character CICS commarea may be passed from t to the executing that is LL WAIT until the user program has completed befor A 45 character CICS commarea may be the batch request to the executing user program that is
387. s can be accomplished by using transaction CECI to issue the following two commands CECI EXEC CICS ENABLE PROGRAM DFHXTENF EXIT XICTENF GALENGTH 100 Execute this command then issue CECI EXEC CICS ENABLE PROGRAM DFHXTENF EXIT XALTENF START Execute this command Following the execution of both commands the exit will be enabled ERROR MESSAGES The following messages may occur if your MRO sessions and connections are not set up properly or the CAFC MRO definitions are in error ERROR TRYING TO SEND MAP CALL CICS SYSTEMS PROGRAMMING ERROR TRYING TO RECV MAP CALL CICS SYSTEMS PROGRAMMING ERROR TRYING TO LOAD PGM CALL CICS SYSTEMS PROGRAMMING ERROR TRYING TO START TRANSID CALL CICS SYSTEMS PROGRAMMING INVREQ Invalid request IOERR I O error ISCINVREQ ISC invalid request NOTAUTH Not authorized SYSIDERR SYSIDNT in error TERMIDERR ermid in error TRANS IDERR Transid in error If the user enters an applid that is not in the CAFC MRO table the following message will be displayed on the screen CICS ID NOT IN MRO TABLE RE ENTER A VALID CICS ID Page 64 CAFC FEATURES AND CONSIDERATIONS ENHANCED RESOURCE MANAGEMENT The following automatic facilities are controlled by CAFC Customizatio
388. s for the n CAFCOVER is AFCPSIPY EARLY ALLOCATION REQUIREMENTS AFCPSIPY runs before Its main function is processing your Warm Start Customization Option set any global warm start overrides controlled by a CAFCPARM and Other type file ddname records files registered to CAFC that PLTPI files 2 statement con prefixed with whe 3 allocations for thos will subsequently override an allocated status previously set by CAFCOVER AFCPSIPY You should rarely need AFCPS for CICS Version 3 or later individual tain a warm start override and DFH ther an early allocation is necessary To a Cal used start statu t processing ext CI Car ts the CICS region begins i to allocate files perform this activity DCT ttings for AFCPSIPY interrogates The facilities CS to process ad hoc CAFC s conditions AFCPWARM CS initialization process that need to be available before 1 DCT and Other type D D 4 tha are AFCPSIPY integrates this information and determines selected resources Normally Finally Overrid requests placed DCT files can be it performs direct in PY if you are running applications designed critical allocated through standard Cl When installing AFCPSIP place AFCPSIPY into an authorized lib CICS j
389. s the messages for all events that are to be reported on at an application level either DDNAME or Transaction is entered in TABLE ENTRY These messages will be displayed if 1 The global customization record has been defined and the message facility has been enabled 2 The functional message facility has been enabled in the global customization record 3 The application customization record for this application has been defined and the functional messages have been enabled 4 The event is listed in the global customization panel 5 The return code matches the return code generated for the event 00 normal return 04 partial warning return 08 event failure Page 140 CAFC FEATURES AND CONSIDERATIONS MESSAGE FACILITY OPTIONS CONTINUED GLOBAL CUSTOMIZATION Pictured below is the MESSAGE CUSTOMIZE FACILITY for updating the CAFC global messages MESSAGE CUSTOMIZE FACILITY I CAFC PANEL 21M COMMAND INPUT gt SCROLL gt ENABLE ALL MESSAGES gt Y Y MSG FACILITY ENABLED N ALL MSGS DISABLED FUNCTION MESSAGES gt Y Y MESSAGES ENABLED N MESSAGES DISABLED PROCES
390. saction work area e request card transaction AFCB or AFCI Transaction AFCB is used when th CS COMMAREA to be passed wilt The XCTL request also provides If it does not indirectly xcontrolling to a user program by starting a secondary transaction AFCE connection method is connection method is EXCI CS XCTL PROGRAM to the user program ll not cause the AFCB AFCI The AFCE transaction The XCTL request provides th the EXEC CI the ability TWA be formatted with user data passed on If the TWA option is utilized the AFCE transact st have a TWA defined in e TWA size specified in the request message will be issued CS to have tion the transaction definition large enough to hold the CAFC1118 error Place an X in column 72 of the request to continue it to the next card v nnnnn X Continuing to place an X in column 72 of each continued request card can also be used to continue the TWA data Do not leave any spaces in the request String all the Commarea TWAsize and TWA data together separated by commas The B I input format for the XCTL request is Oa ei 4 C AGOTE Da sie ees DRV SS ahs ores t ere ea ea Sos tee ee a eee a ae Ered sap ce sels pa it ei tances san faire PS Er tah ce E where Cira aie ga The 1 to 8 character VTAM applid of the XCTL nnannnn target CICS region on which you want to xecute the
391. sages AFCDBISA DSECT CAFC Batch Interface Security Exit Area AFCDSOXA DSECT CAFC Batch Interface Sign on Sign off Exit Area AFCDSOXP DSECT CAFC Batch Interface Sign on Sign off Parameter List AFCM2016 MACRO CAFC CICS Batch Interface APPLI AFCMRO MACRO CAFC MRO Transid Remote Region Association Table RCDS4300 MACRO CAFC record layouts Page 333 TROUBLE SHOOTING TROUBLE SHOOTING If you experience a problem that you believe is related to CAFC please contact NETEC and ask for technical support group A rule of thumb to consider when gathering problem documentation is to include anything that you might need to begin your own problem determination project Please consider the following recommendations Subject to the type of problem the problem description should include for example Q The frequency of the problem Q Did the problem start when a change was made to CICS MVS VTAM VSAM or CAFC Q The circumstances in which the problem occurs for example whenever CICS is under stress or whenever running a monitor Q Can you reproduce the problem at will Q The abending CAFC program and the offset within the program Q Does it occur when CAFC s CICS exit programs are deactivated The above suggestions are only guidelines and may not apply to your particular problem Too much documentation is always better than too little For possible CAFC prob
392. se options control RPL recon catenation error covery and UP DATE SPEC AL OPT DFHRPL warm start parameters ONS ue features that were ugh custom superzaps e features can now be activated and deactivated l the automatic message These options control unig originally implemented tho Th though these flags UPDATE MESSAGE FACILITY OPTIONS These options contro facility UPDATE DSNAMFE VARIABLES OPTIONS th eir values DE SCRIPT ON OF CUSTOM ZAT List of user defined variable definitions and ON COMMANDS DE SCRIPT UP UP DATE DBCTL OPT ONS DATE VSAM RLS OPTI Page 84 ON OF CUSTOM ZAT ONS ON PF KEYS CAFC FEATURES AN FCT WARM START CUSTOMIZATION OPTIONS Pictured below are the paramet options FCT warm start This option can be overridden CAFCPARM input Y for YES or processing by stream within N for NO WARM START FCT ENTRI ES FCT WARM START ACTI ONS IF LAST REQUEST WAS OPEN ENAB LE gt FE CLOSE ENABLE gt CE ALLOCATE ENABLE gt AE FREE ENAB LE gt FE RECALL ENABLE gt RE OPEN DISA CLOSE D D ISABLE gt CD BLE gt O J ALLOCATE DISABLE gt AD FREE DISA BLE gt FD RECA
393. semble this ts for Type U Datacom DB should be invoked If it should be invoked AFCPDCOM links to Datacom DB s communication module Review the source of these modules for more details Datacom Release 7 4 or previous DBCOCPR Datacom Release 7 5 or higher DCCOCPR If the USER EXIT PGM NAME gt option is left blank on the EXITS option panel under the Customization Options then the Datacom DB user exit program for Type U records must be named and linked as AFCP2UEX If a program name is specified then the user exi globally for all requests against Page 78 t program will be called t all types of files CAFC FEATURES AND CONSIDERATIONS EXCLUDE TABLE The Exclude Table provides users the ability to exclude ddnames dct entries or transactions from CAFC processing if they do not want the resource under CAFC s control Simply add the resources to the AFCTXCLD table and assemble it into the CAFC DFHRPL loadlib Sample table named AFCTXCLD and assembly jcl name ASMTXCLD are provided in the installation source pds Below is a sample which shows DCT entry DT08 FCT entries QAFCT20 and QAFCTO3 and PCT entry AFCC are to be excluded from any CAFC processing This table will be loaded during the CAFC initialization process KKEKKKKKKKK KKK KKK KK KK KKK KKK KK KKK KK KKK KKK KK KKK KKK KKKK KKK KKK KK KKK KKKKKKKKK
394. sembling a small table that defines the DFSAOE00 exits that will be called the order they are called in and which exits return codes should be passed back to IMS The name of the table to be coded is AOEEXTNM The following describe the macros that can be coded to create this table IGNORE SAOEBEXIT TYPE INITIAL AOEORPLY SEND IGNORE SAOEEXIT TYPEK ENTRY MODULE XXXXXXXX RETCODE USE SAOEFEXIT TYPE FINAL MACRO PARAMETER DESCRIPTIONS AOEORPLY IGNORE This indicates that the DFSAOEK00 driver is to always return the AOEOIGNR return code to IMS When AOKORPLY IGNORE is specified IMS will process the message as if the DFSAOE00 exit was not present AOEORPLY SEND This indicates that the DFSAOE00 driver is to always return the AOEOSEND return code to IMS f AOEORPLY SEND is specified IMS will always pass the message segment to the DFSAOUEO exit TYPE INITIAL Indicates this is the first invocation of the macro A TYPE ENTRY must be coded on the first macro in the AOKEXTNM table TYPE ENTRY Indicates this SAOEEXIT macro is defining a DFSAOEOO module to be called from the DFSAOEOO driver The first TYPE ENTRY coded in the AOEEXTNM table must specify the NETEC DFSAOEOO exit name DFSAOENT Subsequent TYPE ENTRY macros can be coded specifying ad
395. serid so that your external security system can control the user s authorization to CAFC functions in the selected region Once the user is transferred to the requested region the user must enter the userid and password for that region s signon procedure All of the CICS table entries to install the MRO Selection Screen facility are provided on the CAFC Installation Tape in file CAFC R4500 CSDLOAD in members CAFCMRO CAFCTOR and CAFCAOR Page 62 CAFC FEATURES AND CONSIDERATIONS MRO REGION SELECTION SCREEN CONTINUED TRANSIDS The TRANSID is the link between your terminal owning region and the other regions In the TOR the TRANSID must be defined with a REMOTESYSTEM REMOTENAME and a TRPROF using RDO In the AORs and in the DOR the TRANSID should be defined normally without the above specifications GOOD MORNING MESSAGES GMMSG The TCT entry for your AORs and the DOR must include GMMSG NO CSD GROUP CAFCMRO The following mapset programs and transaction activate CAFC s MRO facility These resources must be available to the TOR MAPSET AFCM200 RSL PUBLIC STATUS ENABLED PROGRAM AFCP2050 RSL PUBLIC STATUS ENABLES LANGUAGE ASSEMBLER PROGRAM AFCT1000 RSL PUBLIC STATUS ENABLED LANGUAGE ASSEMBLER TRANSACTION AFCA PROGRAM AFCP2050 CSD GROUP TOR Example These PCT Tabl ntries define the connections between the TOR and eac
396. series of warning messages followed will by B I EXCI B program g from CAFC g from CAFC DCT files allocated and available place both the CAFC modules AFCPSIP and library Review the chapter in this the paragraph titled Early CAFC MIGRATION CHECK LIST CONTINUED 19 RELEASE MA NTENANCE UPGRADES If you decide NOT TO ACTI allocation support then yo are placed in your CICS sta by AFCPSIP3 and AFCPSI u must insure rtup JCL or PY explicit CAFC close and free requests 20 Any application should be changed available Maintenance Facili Refer Master authority performing CHG A to have Master au Ziv sequential AFCC transact log on 22 Use The B I B I sign on for ACF2 information within the Fu B I 23 defined to Cl OPEN support option manual under 24 AFCPSIPX and to link t ty All to D sign on securit 2 Frees may still be performed VATE CAFC s extend DCT automatic 1 that your DCT files they are pre allocated using programs that are used to link to AFCP2040 o AFCP2503 ither from xecut Delete CAFC Release 4 5 s non 3270 support terminal has changed the AFSQ transac operators console or tion to direct to CAFC through th froma Purge AFCP2040 is no long to the section fo
397. sical Ddname DR RPL Ddname DT DCT Ddname DU User exit Ddname Default value gt DD Page 277 CAFC TABLE ENTRY MAINTENANCE FACILITY AFC5 CONTINUED MA INTENANCE AN D CONVERS ON A DS DISPOSITION This field modifies the file disposition code Disposition codes O OLD or S SHR for VSAM DDname entries Disposition codes M MOD N NEW O OLD or S SHR for NON VSAM DDname entries FREE AT CLOSE TIME Option to deallocate file at close time Y Deallocate file on close request N Do not deallocate file on close request AUTOMATIC ALLOCATION Option to perform automatic allocation on open request Y Perform automatic allocation on open request N Do not AUTOMATIC ENABLE ON ALLOC Option to Enable file on allocate request or automatic allocation Y Enable file on allocate request N Do not enable file on allocate request AUTOMATIC ENABLE ON OPEN Option to Enable file on open request Y Enable file on open request N Do not enable file on open request AUTOMATIC DISABLE ON CLOSE Option to Disable file on close request Y Disable file on close request N Do not disable file on
398. sly loop through AFCT2016 looking for a non busy LU name Each set of iterations through AFCT2016 will produce another WTO The operator may cancel the B I job step as necessary AFCT2016 MULTIPLE LU NAMES coding example AFCM2016 CICSID XXXXXXXX BATCHID ACB1 ACB2 ACB3 DSN A B C AFCM2016 CICSID XXXXXXXX BATCHID ACBX ACBY ACBZ DSN D E F LUO Y VTAM LU6 2 DEFAULT ACB The VTAM ACB provided in th used to represent the Batch Interface ACB Associat user generated Batch Interface program is normally tion Table AFCT2016 If the Batch Interface program 1 cannot find the target CICS region s VTAM APPLID in the ACB table or 2 the Batch Interface ACB table AFCT2016 does not exist then by default the Batch Interface program will use the VTAM ACB CICSI62 Page 176 BATCH INTERFACE BATCH TO C CONTINUED CS NTERFACE B I REQUEST EXIT AFCP2BCC LU6 2 AND EXCI After each CAFC request is read but befor parsed the B program AFCP2BCC The exit program can set Interface Program should skip the current control nterface Program which can examine and modify a return code to indicate 1 process the control s statement and continue with uest is edited and the req LU6 2 and EXCI the invokes an exit control statement that the Batch
399. standard security administrator s interface For more details review SECURITY AUDIT OPTIONS in the CUSTOMIZATION OPTIONS chapter Page 33 ON LINE SECURITY SUMMARY EXTERNAL CAFC FEATURES AN SECURI TY User sign on is required based upon the set Required Flag All attempts to browse any CAFC Table Fil e wi CONTINUED 1 written program D CONS edit DERAT ONS ting of the Sign on t or use any entry in be authorized by an external user Access to the CAFC Userid Table requires a userid signed on with MASTER uthorization password a User written External Security Exit Programs must be Cl ith a legitimate entry in ACF2 and TopSecret The External Security Exi CICS access cont programs w programs for RACF Tape commercial the PPT t is the interfac trol systems Sample Ext are provided on the point User written External Security Programs are passed the parameter fields in the COMMARFA fields are documen wri on the SEC When you update one of tten External Securit URITY AUD ted in y S TEG also con your logic will The security exit reform package via a parameter list exit programs is stored in ats all The source for the copy member AFCD2008 Exit Program tomization Option panel CAFC req the NSTL
400. t requests to other regions will be processed if the respective CAFC Table files are available DIRECT is useful if you need to synchronize or override the desired restart status for the next region startup The format of the DIRECT parameter is PARM DIRECT yY Page 199 BATCH TO C CS NTERFACE B I EXECUTION JCL AND COMMAND LINE FORMATS CONTINUED EXCI B I PROGRAM PARAMETERS Ther are thr execution JCL parameters that may be included in the B I jobstep These parameters and their description follow MODIFYING THE WAIT TIME FOR A EXCI RECEIVE SESSION This parameter can be used to modify the time that the B I will wait to acquire an EXCI receive session before attempting to acquire the session again The time is specified in hh hours mm minutes ss seconds tt thousandths of a second All characters of the time must be specified The default value is EXCITIME 00003000 30 seconds MODIFYING THE EXCI TIME INTERVAL This parameter can be used to modify the number of EXCITIME intervals that will be allowed to expire before a message will be issued indicating that the B I The default val ue is EXCIMSG 03 has been waiting for a receive session 30 seconds Ies 90 seconds MOD FY N
401. tatus changes rface calls For example implicit or take a CEMT OWS le tus synchronization in its Table Fil EXEC CICS SET FILE FCT EXTENDED SUPPORT This support should be activated if you use CEMT commands or the EXEC c the FCT or JCL status the in affect performed the as described ICS interface to open close and enable disable FCT files Without CAFC s FCT interface activated automatic allocations deallocations cannot be performed unless the dsname for the file is physically in nor will the ddname open close and enable disable stored in the CAFC Table File be kept in synch with the status FCT If FCT support is deactivated it will produce the same has the old AFC1 OFF transaction Ensure that you have DFHDEB70O installation procedure for APF Authorization in Installation STEP 2 This facility should not be t in very controlled instances deactivated except Page 133 CAFC FEATURES AND CONSIDERATIONS EXEC CICS INTERFACE SUPPORT CONTINUED IMPLICIT OPENS FCT EXTENDED SUPPORT This support should be activated if you use the EXEC CICS interface to implicitly open FCT files on first access requests such as READ WRITE DELETE UNLOCK or STARTBR Without CAFC s Implicit Open interface activated automatic allocations cannot be performed unless the dsname for the file is physically in the FCT or JCL nor will
402. th Default value is gt 00050000 Page 93 CAFC FEATURES AND CONSIDERATIONS B I LU6 2 CUSTOMIZATION OPTIONS CONTINUED FORMAT OUTPUT DATA When a LUO TRAN request is processed the received response data is displayed unformatted just as it is returned in the buffer To have the output data formatted into screen format specify Y for this option Default value is N Page 94 CAFC FEATURES AND CONSIDERATIONS B I EXCI CUSTOMIZATION OPTIONS The following is the customization option menu for an EXCI connection BATCH OPTIONS CONNECTION TYPE gt E VTAM LU6 2 E CICS EXCI APPL CONNECTION gt G G GENERIC APPLID ONLINE TRANSACTION CODE EXCI TRANID gt AFCI CICS TRANSACTION CODE DSNAME CHANGE gt AFCM CICS TRANSACTION CODE XPGM REQUEST gt AFCX CICS TRANSACTION CODE SEQUENTIAL TERMINAL ID XPGM REQUEST gt SEQX CICS TERMINAL ID BATCH SECURITY SECURITY CEMT TRANS gt N Y N ISSUE SECURITY CHECK ON CEMT TRANS USERID gt PASSWORD gt BATCH JOBNAME USERID gt N Y N USE
403. that the batch region s specified on to surrogate specified in SURROGCHK YES userid is authorized to issue the batch region s userid is a the the EXCI or all DPL_request call user checking if SURROGCHK YES options table ow i userid as a s calls This class where is specified performed b means userid on the urrogate of the B I a profile named userid DFHEXCI program in t to default the userid specified on DPL calls for another user uthorized as a surrogate of the userid The CAFC B I the o any authorizations userid hout any security That is program is subject default is DFHXCOPT authorize y s userid must the SURROGAT is the userid specified on If surrogate user checking is enabled DPL call th userid on th region s user enabled caus id W SURROGCHK DPL call e de If you specify the B I program s all DPL_request have READ access to general resource the DPL call YES but no userid no surrogate user check will be faults to the batch recommended you have surrogate processing When surrogate processing is disabl the userid obtained from the CAFC master file or the AFCCSSN ddname will not require password authorization or checking the authority to submit CAFC request If you don t wan SURROGCHK NO in the default
404. the CAFC Warm Start file status Page 31 CAFC FEATURES AND CONSIDERATIONS CICS STARTUP UNDER CAFC For many installations CICS restarts can cause problems that require complicated manual intervention to set files and transactions to the correct status Invariably some files end up closed or disabled when they should be opened or at least enabled VSAM files end up with improper service request status Transactions end up disabled when they should be enabled Some files end up being migrated by HSM thus causing long allocation waits and locked up application systems These problems are not necessarily human errors They are the result of CICS s own internal logic To circumvent these problems many shops cold start their regions and incur an unnecessarily long startup delay Other shops have resorted to OPENing every file that could possibly be used during a session This circumvention also wastes resources and manpower and delays the startup of CICS These circumventions unnecessarily complicate on line operations and reduce th nd user s window of uptime With CAFC s CICS startup facilities your files and transactions will always be set to their proper status It does not matter how the files were left at the end of the previous CICS session It does not matter if seldom used files have been migrated by DFHSM It does not matter how you are restarting
405. the Installation Tape tape do not use an e AFCF4000 and 2 AMS Page 2 D tion tape that contains older version the Message parameters and the JCL supplied NSTALLAT ON PROCE DURES INSTALLATION PROCEDURE FOR THE FULL CAFC SYSTEM CONTINUED Step 5 Step 6 Step 7 Step 8 Step 9 Update your CICS startup JCL per the installation instructions DCT data queues tallation routinely changes transactions with CEMT commands or program calls Once you are satisfied that the base CAFC syst installed and functioning continue with Steps 6 10 should be installed only if you wish to act support for automatic allocation of should be installed only if your inst the status of to the EXEC CICS interface Add files place under CAFC s control to the CAFC Table File Install CAFC s Batch Interface facility tem is properly Step 9 tivate CAFC s extend Step 10 databases and other CICS resources that you wish to to activate the two way communication facility between CICS and your batch jobs This file control and other facility allows your batch jobs to submit of commands to one or more local or remote Cl types The commands include 2 1 transaction status changes 3 initiation of messages to lists of users conversational and non conversational Cl
406. the Locking option include L Lock an item U Unlock an item CL Close and Lock UO Unlock and Open DCL Disable Close and Lock UOE Unlock Open and Enable The lock status is displayed on the ENTRY REQUEST EXPANSION LIST just to the right of the TYPE fields That is if a file is locked attached to the TYPE variable a will be Note Lock Status is honored only for CAFC requests or requests from applications that link to CAFC programs The Lock status is not honored by requests generated from CEMT Page 50 CAFC INTERFACE TO DBCTL CAFC can control databases that CS TS1 3 and later OPENing The CAFC onlin later under C ICMD interface of the for a positive respons response is then transl STARTing IMS databases CAFC FEATURES AND CONS after CLOSing interfac Control address space scheduled and actions to be processed IMS by acting as it s own CCTL address space CCTL communicates with interface The CAFC B I th DB are defined to CAFC issues IMS automated operator interface required act lated into a step condition code STOPping DUMPing DERAT ONS DB control for IMS 5 1 and IMS commands through the CAFC does wait ion has completed The CAFC supports the DBRECOVERYing of and IMS via CICS s Coordinator PREPARING DB CONTROL
407. the users responsibility to coordinate closing files changing variable symbols and opening files 4 The dsname for any ddname entry is specified by the ddname edit The format is amp V1 VSAM CAFC4400 QAFCTO1 The value for variable symbol amp V1 will be substituted in the dsname field in place of the amp V1 Multiple variable symbols may be specified in the dsname Th ffective dsname is displayed on the edit screen 5 Offline programs BATCH will use the latest values for the variable symbols from the control record Page 151 CUSTOM ZAT DSNAME VARIABLES CONTINUED ON OPTI ONS Below is a scenario that describes the use of the dsname variables ina multiple TEST and QA regions and mu 1 production region Each environment has it s own R environment the ddname is the same for a specific file across all The dsname will have one of the nodes With this arrangement DO group for each region regions it means every Ther The dsname is not indicating the region level i tiple CICS environment consisting of c files For exampl PAYMASTR SITETAX DEDUCTI ON and three CICS environments datasets will be TEST REGI ONS PAYROLL TEST PAYMASTR ar PAYROLL TEST SIT TAX PAYROLL TEST DEDUCT QA REGIONS PAYROLL QA PAYROLL QA D
408. timer with a default limit of 2 minutes f CICS does not respond within 2 minutes AFCP2016 will terminate with the message WAIT TIME EXPIRED CICS NO RESPONSE This situation is often related to poor CICS performance or to a data set being tied up by a user for an unusually long period of time If your site frequently encounters this problem you should increase the B I s TIMEOUT value The value is given in the following format 00000000 hhmmssth Default value is gt 00020000 premature timeout situation Depending on your operation one of the two methods below will solve the PROVIDING A NEW REGION WIDE TIMEOUT VALUE VIA THE CAFC TABLE FILE If you set a new TIMEOUT value through the B I Option Screen you must also provide the B I program AFCP2016 access to the dsname of target CICS region s CAFC Table File There are two ways to accomplish this Reassemble the ACB Association Table AFCT2016 In the AFCT2016 table make sure you record the associated dsname of the Table File on the macro statement for the CICS region s APPLID Or Include a DD statement with the CICS region s CAFC Table dsname in the B I jobstep s execution JCL CAFC File Either of these actions will provide the B I access to the current TIMEOUT value stored in the CAFC Table File If the B I program AFCP2016 does not
409. tion CS DFHRPL it becomes Once the reconcatenation process reaches a certain point necessary to reconcatenation completes schedules as much preliminary act This scheduling ensures accomplished successfully with minimal point For those modules in st the relat inhibit all G ICS loader activity for the region This can affect region performan tivity as possible before th that the reconcatenat impact on your end users the affected PPT entries to be NEW COPI does not need to be new copied E D use torage a ive concatenation number is updat these modules have been modified CS CEMT new copy commands if it was not in storage prior to If the standard Cl t the time th r ted in the tion can concatenation DASD address field of until ce CAFC is critical be occurs only and need A module reconcatenation There are four steps in the normal procedure for modifying and reconcatenating an existing RPL Invoke the RPL List editor by entering an AR for TABLE TYPE on the EDIT ENTRY MENU Enter a blank in the TABLE NAME field if you are unsure of the spelling A blank will cause a list of all of the previously defined RPL lists to be displayed Place an S for select in the cursor field preceding one of the list names This will invoke the RPL List Editor Make your changes and
410. tion This data will be sent to the transaction s program Since the user coded an E in column 72 of the input card this will b terpreted as the last input card the batch terminal processor will deliver to the conversational transaction The user has the responsibility of ensuring that the last input string on the card is coded with an E coded in column 72 This must be present to terminate the conversational transaction SAMPLE CEMT TRANSACTION USING the TRAN REQUEST CEMT is a conversational Consider the IBM supplied transaction CEMT transaction Once the transaction is executing it requires a PF3 attention identifier to end the transaction This PF3 key must be coded on the card representing the last input string CICS99P TRAN cemt set icv 00000 CICS99P TRAN 03 E The above is an example of the coding to send a PF3 key to the CEMT conversational transac to simulate PF keys 1 showed in the following paragraph titled TABLE and sends the appropriate PF key Page 219 tion to end its conversation The BTM is designed thru 24 It interprets the character strings as PROGRAM FUNCTION KEY SIMULATION BATCH TO CICS INTERFACE BATCH TERMINAL PROCESSOR TRAN REQUEST CONTINUED NOTE When using CEMT requests you must terminate the request with a PF3 key that is a 03 We recommend that you normally use the B I s CEMT request in l
411. tion This is ion AFCI or the required for transaction at The profiles for all the resources accessed by the CAFC EXCI transaction and programs storage programs security checking information about MRO link security checking User security The CICS region performs user security checking against the userid passed by the B I program on a that is either obtained From From the AFCCSSN D From the Jobcard of the B I files and so on This queues ttach security checking transient data See the C CS ESA C DPL CALL request Page 99 the CAFC master file if specified or DNAME if present or program execution JCL and temporary is required for resource CS RACF Security Guide for This userid is the userid id CAFC FEATURES AND CONS DERAT ONS B I EXCI CUSTOMIZATION OPTIONS CONTINUED User security checking is performed only when connections specify ATTACHSEC IDENT link security you make for lin specified on the FY For user security k security DPL CALL request RUNNING THE EXCI B I WITH NO SECURITY If you want to run the CAFC B I must specify ATTACHSEC LOCAL SURROGATE USER CHECKING A surrogate user check is performed to verify that the ba userid is authorized to iss authorized as a surrogate of the userid specified on program is subject to surrogate is specified
412. tional messages in message table The error and informational messages in the message table are 76 bytes long Address of error table Status message indicating the status of the request Secondary Type Field This is the second byte of the table type The first byte is st Page 259 tored in th AF7VENTYPE field OPERAT ONAL CONS DERAT LINKING TO CAFC S DYNAMIC ALLOCATION FACILITIES ON LINE API CODING HINTS AFCP2008 is a command level ALC program Command Level program and pass the parmlist in a performs a time to the requesting program in parm Therefore each back is not processed th it is GETMAIN linked to FREEMAI NE ret DA 2 urned mes for storage to hol ONS CONTINUED The requesting program m COMMAREA ust be a AFCP2008 ld error and informational messages As AFCP2008 passes the address of the messages ist field message area wh creeping short ose address sages is returned after th in on storage situation from occurring in IN STL AFCP2PLT AF7MSGSA the to AFCP2008 must be in USERDATAKEY EF AFCP2008 is defined as EXECKEY USER its DFHEI be obtained in USERDATAKEY However if the call or PLTSD time CICS will automatically run s and the DFHEISTG and all GETMAINS will causing CAFC program AFCP2008 to fail AFC below If you are runn are
413. to There are also several other programs are part of the Batch Interface package that need to be placed in this insure downward compatibility library along with AFCP2016 AFCT3062 AFCT3063 AFCT3064 AFCP2SOX AFCP2BSX AFCP2CCX AFCP2BCC and AFCPBTX1 SONSCIP YES Failure to add this statement will lead to a series of If you haven t done so during an earlier installation VTAM parameter to each CICS region s APPLI They are AFCT3000 AFCT3053 AFCT3061 AFCT3065 AFCP2LU0 AFCP4316 AFCP4216 your Your Update including the Batch the that add the following Page 18 D maintained in SYS1 VTAMLST CAF C RELEASE MA NTENANCE UPGRA DES MIGRATION PROCEDURES FROM ANY BACK RELEASE CONTINUED warning messages and B I the EXCI B I program Compare the functionality of th Carefull parameters failures new releas Review your existing external exi changed AFC BIS DBISA REQ AFCDSOXA SOXIREQ AFCD2007 AF 7REQST AF 7TYPE2 AF 7DATE AF 7MSG AFCDERRS AF 7ERRLN AFCD2008 AF 8FUNC AFCD2017 AFXREQST AFCD2040 AF 4MSG Any user programs Below is a list DSECT param expan DSECT param expan DSECT param expan reloc expan expan DSECT assoc expan DSECT param expan DSECT param expan DSECT param of the eters ded from
414. to aid in coding the command requests To request help for a certain command simply type HELP WITH XXXXXXXXX_XXX Where XXXXXXXXX_XXX is the command for which help is being requested Example To request help on how to enter the create_ddn command issue HELP WITH CREATE_DDN A screen will be presented showing how to code the create_ddn command examples of create_ddn commands plus all fields defined for the ddn record Below is a table that shows the many commands available in the extended maintenance facility CREATE DDN CREATE DDN RECORDS CREATE DBD CREATE DBD RECORDS CREATE _TXN CREATE TXN RECORDS CREATE _APPL CREATE APPL RECORDS CREATE GROUP CREATE GROUP RECORDS CHANGE_CTL CHANGE FIELDS IN THE CONTROL RECORD CHANGE_DDN CHANGE FIELDS IN DDN RECORDS CHANGE_DBD CHANGE FIELDS IN DBD RECORDS CHANGE_TXN CHANGE FIELDS IN TXN RECORDS CHANGE_APPL CHANGE FIELDS IN APPL RECORDS CHANGE_GROUP CHANGE FIELDS IN GROUP RECORDS EXTENDED CAFC RECORD MAINTENANCE FACILITY CONTINUED CHANGE_NODE CHANGE CDTDSN FIELD IN DDN RECORDS RENAME DDN RENAME DDN RECORD Page 263
415. tor at the ddnames level This indicator can t be set correctly during conversion The SYNCHRONIZE_RLSFLAG command is designed to read the current FCT and set the RLS indicator in the relevant ddname records SYNCHRONIZE RLSFLAG IN DDN RECORD FOR A SINGLE FCT SYNCHRONIZE_RLSFLAG KEY FCT01 SYNCHRONIZE RLSFLAG IN DDN RECORDS FOR A TWO FCTS SYNCHRONIZE_RLSFLAG KEY FCTO1 FCT02 SYNCHRONIZE RLSFLAG IN DDN RECORDS FOR ALL FCTS ENTRIES SYNCHRONIZE_RLSFLAG KEY EXTENDED CAFC RECORD MAINTENANCE FACILITY CONTINUED Page 274 MA INTENANCE AND CONVERS ON A DS SYNCHRONIZE CAFC TABLE FILE ENTRIES WITH CICS TABLE STATUS Synchronize the warm st art indicators in the CAFC table file records with corresponding CICS table status values FCT gt SYNCHRONIZE DDN DD RECORDS WITH DFHFCT STATUS OPEN ENABLE READ BROWSE DELETE UPDATE ADD OPN gt SYNCHRONIZE DDN DD RECORDS WITH DFHFCT ACCESS READ BROWSE DELETE UPDATE ADD DCT gt SYNCHRONIZE DDN DT RECORDS WITH DFHDCT STATUS OPEN ENABLE PCT gt SYNCHRONIZE TXN RECORDS WITH DFHPCT STATUS ENABLE DLI gt SYNCHRONIZE DBD RECORDS WITH DLI STATUS OTR gt SY
416. tus As you have probably guessed RO request whenever a stores values of readonly or he DRS Access Status field is is issued from the CAFC REQUEST UP request is issued As may be issued for the FCT entry directly or as tion or group of applications It may not be uld be aware that the Status of the FCT entry but they set th Newey CO th RO and the UP request not DRS Open Status field is also set to open by the SUMMARY OF DRS SETTINGS FCT DCT PCT The following tables summarize the settings for the various DRS fields DRS Open Status CAFC REQUEST O OE C DC A F RO UP FCTs open close alloc free open DCTs open close alloc free lt p PCTs Page 165 CICS STARTUP CONS DERAT ONS DESIRED RESTART STATUS DRS TUTORIAL CONTINUED DRS Enable Status CAFC REQUEST OE DC E D EF DF FCTs SoH wes ts pacha nabled disabled DCTs SHS nabled disabled PCTs enabled disabled enabled disabled area sse gt DRS Access Status CAFC REQUEST RO UP FCTs readonly update DCTs ears ng en PCTs ZJE zoea HOW DRS FIELDS ARE USED BY CAFC WARM START A very simplistic WARM START capability would involve re establishing each restartable item in ea
417. uded in the DFHRPL concatenation Default value is gt BLANK Page 136 CAFC FEATURES AND CONSIDERATIONS DFHRPL MANAGEMENT OPTIONS CONTINUED WARM START RPL NAME This option determines whether th should be used at CICS start up most recen CAFC automa recently requested RPL concatenation in the C specified the most recently requested DFHRPL at start up by AFCPSIPY See the chapter on tly used DFHRPL concatenation tically maintains the most AFC Table File Ef JYV IS concatenation will be loaded CICS Startup Considerations AFCPSIPY Early Allocation Requirements for instructions on how to install AFCPSIPY If N is specified CAFC will not override the external DFHRPL concatenation This value can be overridden by specifying WARMRPL Y or N in the CAFCPARMS startup Default value is gt N Page 137 override parameter file CAFC FEATURES AND CONSIDERATIONS SPECIAL OPTIONS SUPPORT The parameters pictured below activate CAFC s special options These options were originally distributed as customized zaps sent out to our users You should seldom need to activate any of these options SECURE CUSTOMIZATION gt N Y N REQUIRE MASTER USERID TO BROWSE CUSTOMIZATION OPTIONS AFCF40
418. uests are to JOB EXEC PGM AFCP2016 PARM CICSPROD DC A STARTUP1 lt DD DSN prod loadlib DISP SHR DD SYSOUT DD SYSOUT DD DSN cicsprod cafc tablfile DISP SHR DD DSN cafc cssninfo DISP SHR optional EXEC PGM BATCHPG1 COND 0 LT JS0400 DD DSN prod loadlib DISP SHR DD SYSOUT EXEC PGM BATCHPG2 COND 0 LT JS0400 DD DSN prod loadlib DISP SHR DD SYSOUT EXEC PGM AFCP2016 PARM CICSPROD OE A STARTUP1 lt COND 0 LT JS0400 DD DSN prod loadlib DISP SHR DD SYSOUT DD SYSOUT DD DSN cicsprod cafc tablfile DISP SHR DD DSN cafc cssninfo DISP SHR optional Page 206 B I BATCH BATCH TO CICS INTERFACE INTERFACE JCL AND COMMAND LINE FORMATS CONTINUED B I CAFC TABLE MAINTENANCE REQUESTS The following batch table maintenance requests have been changed to link to the CAFC Extended Table Maintenance Facility program and will request Master authority to execute S the section on CAFC Extended Table Maintenance Facility for more information and examples of requests that are available for batch and online table maintenance ADD REQUEST FCT ddname ADD requests use optional parameters following the entry name DATA SET NAME DATA SET NAME is 44 bytes The DDname record defaults are Data set type Data Disposition ULLFILE set name Data Free Invok
419. us DRS This mechanism is independent of CICS s restart procedures There are four independent categories of items defined to CAFC which can be warm started FCT entries DCT entries PCT entries OTR entries Each of these resource categories is controlled up to three Desired Restart Status DRS fields The DRS fields are maintained in the CAFC Table File They are automatically updated each time the status of a CAFC registered resource changes The DRS fields are OPEN STATUS with values of open closed allocated free recoverdb or dumpdb for FCT DCT and DLI entries ENABLED STATUS with values of enabled disabled or unenabled for FCT DCT and PCT entries ACCESS STATUS with values of readonly update for FCT entries Of course all values do not apply to all resource categories Page 163 ICS STARTUP CONSIDERAT ONS DESIRED RESTART STATUS DRS TUTORIAL CONTINUED The following sections will trace the management of the Desired Restart Status DRS fields HOW DRS FIELDS ARE SET PCT ENTRIES The simplest warm start situation is for the PCT category PCT entries represented in CAFC by TXN records have a singl Status with values of enabled or disabled E for each TXN record is set L DC request is issued the DR
420. ustomization Options section shows how to specify the User Exit Program Name and how to enable the Request Completion Exits If a User Exit Program Name is specified that program name is used for all the above user exit calls including type U User ddname records If no User Exit Program Name is specified then the above exit points are driven for type U records using the default program name of AFCP2UEX A sample program AFCP2UEX is provided in INSTLIB AFCP2UEX can be modified to update the 64 byte user field that is automatically displayed on the Ddname status screen Type U records do not require activation of the Global user exit program The exits are only driven when a request is processed against one of them These records can be used to trigger non CAFC actions when a CAFC resource is processed For instance a dummy type U record may be placed in an Application Table When the table is processed a user modified version of AFCP2UEX program will be driven The program could submit a job start a CICS program or send a scheduling request to CA 7 through a properly formatted internal reader statement Page 74 CAFC FEATURES AND CONSIDERATIONS ON LINE USER EXITS POINTS CONTINUED NOTE Use of these global exit points can affect CICS performance The exit is driven for each ALLOCATE OPEN CLOSE or FREE that is issued against ddnam ntries
421. ving application file JCL statements from your CICS startup procedures CICS startup management Security within the CAFC system Using one of CAFC s B I facilities Using one of CAFC s B I facilities for CAFC commands to execute a CICS program Using the B I Terminal Processor to execute a CICS transaction Hierarchical Storage Manager support DFHRPL Library Management File locking facilities Using CAFC On Line User Exits MRO region selection screen DBCTL requests to start and stop remote IMS databases Extended EXEC CICS interface and CEMT support for activity against DCTs FCTs DLI Databases and transactions Enhanced resource management on a status change Automatic Status Message management CAFC table file maintenance facilities DFHRPL SRCH Transaction to locate load libraries CAFC Message Facility Alternative DSNAME Facility Symbolic DSNs CAFC TSO ISPF Log Viewer CAFC System Logger Page 28 CAFC FEATURES AND CONSIDERATIONS CAFC FEATURES AND CONSIDERATIONS CONTINUTED e Extended Table Maintenance e AFDB transaction to start and stop DBCTL connection e Exclude table e Online reporting Page 29 CAFC FEATURES AND CONSIDERATIONS REMOVING DD STATEMENTS FROM CICS S JCL To take full advantage of CAFC s facilities define all o
422. warm start options the CAFC FCT entries which were either disabled or unenabled at the termination of the previous CICS session will be set the same way when CICS comes back up The entries which were enabled will be set enabled These entries will be open automatically at first access by CICS and allocated if necessary by CAFC at that time WARM START OVERRIDES Any specific CAFC FCT entries which you would like to be either allocated or opened or set to any other specific warm start status can be accommodated by simply coding the warm start override on the CAFC Edit Screen for that particular entry A typical CAFC PCT warm start options set up would set th nable disable status of transactions to the same status they held at the end of the set enabled and previous CICS session The enabled transactions will b the disabled transactions will be set disabled SAMPLE PCT WARM START OPTIONS PCT WARM START ACTIONS IF LAST REQUEST WAS THEN WARM START ACTION WILL BE ENABLE gt E X NO ACTION DISABLE gt D E ENABLE D DISABLE There are detailed descriptions of the DRS values in the edit screen instructions There are detailed descriptions of all the warm start controls in the customization options instructions Page 171 BATCH TO C CS NTERFACE BATCH TO CICS INTERFACE The CAFC Batc
423. will lead to a series of warning messages and B I failures 7 Update any other libraries that contain CAFC components including the Batch Interface program AFCP2016 If you have placed the B I program AFCP2016 in a private library such as a library specified in the LINKLST you must replace it with the CAFC4400 version of AFCP2016 to insure downward compatibility There are also several other programs that are part of the Batch Interface package that need to be placed in this library along with AFCP2016 The programs are AFCT3000 AFCT3053 AFCT3061 AFCT3062 AFCT3063 AFCT3064 AFCT3065 AFCP2LU0 AFCP4316 AFCP4216 AFCP2SOX AFCP2BSX AFCP2CCX AFCP2BCC AND AFCP2BTX1 Page 22 CAFC RELEASE UPGRADES MAINTENANCE REFRESHING A CAFC RELEASE 4 5 SYSTEM CONTINUED 8 Compare the functionality of the n 12s to CICS as OPENTIME STARTUP Review the SUPPORT EXEC CICS options ONS section 13 AFCPSIPX and AFCPS 14 be changed to link to AFCP2503 release Review your existin reassembled with th Contact the NETEC about refitting you The latest CAFC Re following CAFC tran g external e new macro libraries and tested exit w release versus your previous Carefully review and update the new Customization Options panels and parameters programs They must be AFCl customer support staff if you
424. will be disabled if 4 D is AUTOMAT Y and SABLE WITH FREE on CAFC Cust for AUTOMAT C SERV CES is set to Yes Page 67 00 under the section If the CAFC request is FREE then the associated CICS table FCT or DCT tomization Request Options panel 401 C ENABLE DISABLE on CAFC Edit panel 400 under the section CAFC FEATURES AND CONSIDERATIONS AUTOMATIC STATUS MESSAGE MANAGEMENT Status messages for end users may be sent to selected CICS and TSO terminals These messages present the status of a CAFC event eg th OPENing or CLOSEing of an application ddname or both along with user defined text The message triggering events may be any one of those allowed within the CAFC system The messages and control parameters are defined within the customization process of CAFC The messages ar associated with 1 the request that will trigger the event 2 the return code to which that message applies and 3 the intensity of the message when it is displayed on a CICS terminal normal or bright The CAFC message system also contains a facility for users who are currently signed on to CAFC and wish to immediately send messages to other CICS or TSO terminals The CAFC automatic message facility and user message facility are both activated if 1 ENABLE ALL MESSAGES on CAFC Global customization pan
425. xit program is pre assembled with no security checking and included in the CAFC Loadlib 2 OPTIONAL Modify assemble and linkedit the CAFC B I Security exit program AFCP2BSX for region unique control of individual Batch Interface requests 3 OPTIONAL Modify assemble and link edit the CAFC B I Control Card exit AFCP2BCC for site unique control statement examination and modification requirements The standard exit program is pre assembled and included in the CAFC Loadlib 4 OPTIONAL Modify assemble and link edit the CAFC B I Condition Code exit program AFCP2CCX for site unique control of MVS step return codes The standard exit program is pre assembled and included in the CAFC Loadlib 5 OPTIONAL Modify assemble and link edit the CAFC Batch Terminal Processor exit program AFCPBTX1 to interrogate full screen responses from TRAN requests Page 185 BATCH TO C CS NTERFACE B I INSTALLATION STEPS ACF VTAM LU6 2 B I CONTINUED Step 7 Whether or not OPTIONAL UP you elect to use multiple VTAM ACBs an ACB other the dd for ACB Association Table ac de region s Table File than the default the CAFC Table file in AFCT2016 DATE AN D REASSEMBLE THE AFCT2016 TABLE CS if you decide to use 62 or if you decide to not provide tivates dynamic file allocation access
426. y be issued from the CAFC log browse screen The Reset command can also be abbreviated as Res follows RESET RES Page 319 The format of the reset command is as CAFC SUPPORT TRANSACTIONS CAFC SUPPORT TRANSACTIONS The CAFC system is shipped with several built in transactions to aid in its operation AFAC AFC2 AFC4 AFC5 AFC8 AFC9 AFCB AFCC AFCE AFCI This Below is a description of their function transaction verifies that CAFC s proprietary APF authorization method has been successfully installed This This is an internal CAFC Message Facility to terminals This trans This write This transaction is action transaction is the main on line CAFC transaction transaction used to deliver messages for the the on line CAFC Table File maintenance enables disables This Inter promp This transaction provides direct requests coming from 3270 terminals transaction is the on line component face AFCB s priority should be set t response for B I requests g T transaction executes the program AFCPTRST which is used to trace records to CAFCTRAC transaction is the internal automatic services transaction It controls automatic allocates deallocates and automatic of the LU6 2 Batch to 255 to insure command line support for CAFC AFCC is an alternative shortcut method for entering
427. y is distributed on a standard labeled 3480 cartridge or CD Rom The tape media contains the nine files described below File No Data Set Name Description 1 CAFC R4500 INSTLIB Installation JCL CICS table entries VTAM definitions User exit programs 2 CAFC R4500 VSAMLOAD Table header records that are used to create a new CAFC VSAM Table File 3 CAFC R4500 AFCFMSGS Error Messages and HELP screen records 4 CAFC R4500 CSDLOAD DFHCSD RDO entries for CAFC that can be moved into your existing CSD file One group contains PCT and PPT entries Another offers example TCT groups that can be tailored to your needs 5 CAFC R4500 MACLIB CAFC Macros for assembling optional source members 6 CAFC R4500 LOADLIB CAFC On line and Batch Load Modules 7 CAFC R4500 ISPMLIB CAFC ISPF Log Viewer message fil 8 CAFC R4500 ISPPLIB CAFC ISPF Log Viewer panels 9 CAFC R4500 ISPTLIB CAFC ISPF Log Viewer table library Page 5 DETAIL INSTALLATION STEPS NSTALLATION PROCEDURES The detail installation steps for the base CAFC system follow STEP 1 UNLOAD THE INSTALLATION LIBRARY Modify the fo submit it for the tape lab llowing JCL according to your installation requirements and execution Be sure to modify the input volser number with found on th
428. ze Failure to the B I RESPONSE SYSTEM_ERROR REASON IRC_CONNECT_ FAILURE program s userid to the DFHAPPL applid RACF FACIL target CICS server region DERAT ONS TY with READ authority program s userid to the CICS region s DFHAPPL applid profile causes an Open_Pipe processing to fail with The sub reason field 1 for a bind time security check failure returns decimal 176 examples of how XBO LINK SECURITY The target Cl from the B I security program when attaching security checking within userid that Cl userid To thes nsur See the C CS region performs link securit These securit CS uses for CS ESA C DFHAPPL profiles ty checking against ty checks cover transaction the mirror transaction the CAFC transaction program AFCP2015 these security checks is link security checks do not the B I and resource CS RACF Security Guide for information about the MRO logon and bind time security checks to define the RACF and for requests attach and command The link program s cause security failures The profile for the CAFC EXCI name must be specified in you must ensure following resource profiles that the link userid is authorized as appropriate transact the system default parameters to the transac

Translated by WordPort from WordStar 3.x - 7.0 document

Contents

Download Pdf Manuals

Related Search

Related Contents