A fix is available
APAR status
Closed as program error.
Error description
Problems Addressed: . - ADDED COMMAND STORE/FORWARD OPTION. IF AN IMS IS BELIEVED TO BE STOPPED (APPC ERRORS), COMMANDS WILL BE SAVED IN A VSAM DATA SET AND RETRIED AT IMS RESTART. . - ADDED RACF-BASED SECURITY FOR THE VARIOUS CCF ISPF DIALOG OPTIONS. THE CCF INTERFACE IS BEING CHANGED TO USE THE RACF FACILITY PROFILE VIA RACROUTE CALLS TO SECURE VARIOUS CCF ISPF ADMINISTRATIVE OPTIONS: . - IMS INFORMATION BROWSE PANEL ALLOWS SOME FIELDS TO BE MODIFIABLE THAT INSTEAD SHOULD BE DISPLAY-ONLY. . - IN THE EVENT THAT A TSO/ISPF CCF SESSION HANGS WHILE WAITING FOR A RESPONSE FROM APPC, THE SESSION SHOULD TIME OUT INSTEAD OF FORCING AN OPERATOR TO TERMINATE THE TSO SESSION. . - WHEN CHANGING A DATA BASE ACCESS TO RD AND USING DBRC TO ENSURE THE DATA BASE IS NOT OPEN FOR UPDATE ON ANY SYSTEM, CCF IS USING THE WRONG AUTH STATE VALUE. WHEN A DATA BASE IS OPEN WITH ACCESS=RD IT'S "HELD AUTHORIZATION STATE" IS 4. . - THE PRINTED BATCH CCF JOB OPTIONS ARE MOVED FROM DDNAME CCFLIST TO DDNAME CCFJOPRT SO THAT ONLY COMMANDS AND RESPONSES ARE DISPLAYED. . - IMS COMMAND CHARACTERS SPECIFIED AFTER A PERIOD ARE BEING TRUNCATED EVEN IF THEY ARE SPECIFIED WITHIN SINGLE QUOTES. . - THE ISPF COMMAND INTERFACE IS BEING CHANGED TO EXECUTE A LIST OF IMS COMMANDS STORED IN A DATA SET. . ========================= USERS AFFECTED: ========================= ANY USER WANTING TO USE COMMAND STORE/FORWARD OPTION. . ALL CCF ISPF INTERFACE USERS WISHING TO ADD RACF-BASED SECURITY TO THE VARIOUS ISPF DIALOG OPTIONS. . ALL CCF USERS CHANGING DATA BASE ACCESS TO RD AND USING DBRC TO ENSURE THE DATA BASE IS NOT OPENED FOR UPDATE. . ALL CCF USERS WISHING TO EXECUTE A LIST OF IMS COMMANDS STORED IN A DATA SET. . ========================= MESSAGES: ========================= ========================= CHANGED--- FROM: CCF0374I - ALL DATA BASES NOT ALLOCATED OR AT HELD AUTH STATE < 3. TO: CCF0374I - ALL DATA BASES NOT ALLOCATED OR AT HELD AUTH STATE < 5. . NEW MSG: CCF0114E - OPEN FAILED FOR STORE/FORWARD DATA SET, RC=XXXXXXXX CCF0115E - DYNALLOC FAILED FOR: XXXXXXXXXXXXXXXX CCF0377W - COMMAND FAILED ON ALL SYSTEMS, STORE/FORWARD BYPASSED CCF0378I - FOLLOWING COMMAND SAVED IN STORE/FORWARD FOR IMS: XXXX CCF5001E - CCFPRINT OPEN FAILED CCF5002E - DYNALLOC FAILED FOR DSN=XXXXXXXXXXXXXXXXXXXXXXXXXXX CCF5003E - DYNALLOC RETURN CODE = XXXXXXXX CCF5004E - LOAD FAILED FOR CCFSTFWD CCF5005E - OPEN FAILED FOR CCFSTFWD, RETURN CODE=XXXXXXXX CCF5006E - INQY CALL FAILED, AIBRETRN=XXXXXXXX, AIBREASN=XXXXXXXX CCF5007W - OPEN FAILED FOR DD CCFPRE CCF5008E - PREVIOUS RECORD IGNORED, COMMAND DOES NOT START WITH A SLASH CCF5009I - STORE/FORWARD DSN=XXXXXXXXXXXXXXXXXXXXXXX CCF5010W - ERROR DURING ICMD CALL, AIBRETRN=XXXXXXXX AIBREASN=XXXXXXXX CCF5011W - ERROR DURING ICMD CALL, AIBRETRN=XXXXXXXX AIBREASN=XXXXXXXX CCF5012W - ERROR DURING RCMD CALL, AIBRETRN=XXXXXXXX AIBREASN=XXXXXXXX CCF5013W - ERROR DURING RCMD CALL, AIBRETRN=XXXXXXXX AIBREASN=XXXXXXXX CCF5014I - CCFPRE PROCESSING STARTED CCF5015I - CCFPRE PROCESSING COMPLETED CCF5016W - OPEN FAILED FOR DD CCFPOST CCF5017I - CCFPOST PROCESSING STARTED CCF5018I - CCFPOST PROCESSING COMPLETED CCF5020E - READ ERROR ON STORE/FORWARD DATA SET, RC=XXXXXXXX RPLFDBK=XXXXXX CCF5021I - STORE/FORWARD PROCESSING STARTED CCF5022I - FOLLOWING RECORD FROM JOB XXXXXXXX DATE-TIME XXXXX-XXXXX CCF5023I - NO RECORDS FOUND ON STORE/FORWARD FOR: XXXX CCF5024I - STORE/FORWARD PROCESSING COMPLETED CCF6008I - COMMAND STORE/FORWARD ACTIVE CCF6009I - STORE/FORWARD DSN=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX CCF6039E SETRC= VALUE MUST BE NUMERIC CCF6040E ABEND= VALUE MUST BE NUMERIC CCF6041E RETRYATT= VALUE MUST BE NUMERIC CCF6042E RETRYSEC= VALUE MUST BE NUMERIC CCF6043E DFS0488I= VALUES (UP TO 20 2-DIGIT PAIRS) MUST BE NUMERIC CCF6115E YOU NEED RACF AUTHORIZATION FOR THIS FUNCTION CCF6167E YOU NEED RACF AUTHORIZATION FOR THIS FUNCTION CCF6168E DSNAME SPECIFIED FOR /DSN= NOT VALID CCF6169E DSNAME SPECIFIED FOR /DSN= NOT FOUND CCF6170E MEMBER NAME SPECIFIED FOR /DSN= NOT FOUND CCF6171E DYNALLOC ERROR FOR /DSN= CCF6217E YOU NEED RACF AUTHORIZATION FOR THIS FUNCTION CCF6315E YOU NEED RACF AUTHORIZATION FOR THIS FUNCTION CCF6415E YOU NEED RACF AUTHORIZATION FOR THIS FUNCTION CCF7101E - CCFSTFWD DDNAME MISSING CCF7102E - GENCB ACB1 ERROR CCF7103E - GENCB RPL1 ERROR CCF7104W - COMMAND STORE/FORWARD DATA SET ALREADY INITIALIZED CCF7105E - CCFVSAM INIT ERROR CCF7106I - COMMAND STORE/FORWARD DATA SET INITIALIZATION SUCCESSFUL ========================= DOC CHANGES ========================= THE USER'S GUIDE NEEDS THE FOLLOWING SECTION ADDED: +++++++++++++++++++++++++++++++++++++++++++++++++++ USING RACF TO SECURE CCF ISPF OPTIONS: . CCF USES RESOURCES DEFINED TO THE RACF FACILITY PROFILE TO SECURE CCF ISPF FUNCTIONS. . TO SECURE UPDATE ACCESS TO THE CCF GLOBAL OPTIONS PANEL, THE FOLLOWING SAMPLE COMMANDS CAN BE ISSUED: . RDEF FACILITY CCF.OPTGBL* UACC(NONE) OWNER(XXXXXXXX) SETR REFRESH RACLIST(FACILITY) PE CCF.OPTGBL* CLASS(FACILITY) ACCESS(READ) GROUP(YYYYYYYY) . TO SECURE UPDATE ACCESS TO THE CCF IMS OPTIONS PANEL, THE FOLLOWING SAMPLE COMMANDS CAN BE ISSUED: . RDEF FACILITY CCF.OPTIMS* UACC(NONE) OWNER(XXXXXXXX) SETR REFRESH RACLIST(FACILITY) PE CCF.OPTIMS* CLASS(FACILITY) ACCESS(READ) GROUP(YYYYYYYY) . TO SECURE UPDATE ACCESS TO THE CCF IMS GROUP OPTIONS PANEL, THE FOLLOWING SAMPLE COMMANDS CAN BE ISSUED: . RDEF FACILITY CCF.OPTGRP* UACC(NONE) OWNER(XXXXXXXX) SETR REFRESH RACLIST(FACILITY) PE CCF.OPTGRP* CLASS(FACILITY) ACCESS(READ) GROUP(YYYYYYYY) . TO SECURE USE OF THE IMS COMMAND PANEL, THE FOLLOWING SAMPLE COMMANDS CAN BE ISSUED: . RDEF FACILITY CCF.OPTCMD* UACC(NONE) OWNER(XXXXXXXX) SETR REFRESH RACLIST(FACILITY) PE CCF.OPTCMD* CLASS(FACILITY) ACCESS(READ) GROUP(YYYYYYYY) . TO SECURE UPDATE ACCESS TO THE CCF JOB OPTIONS PANEL, THE FOLLOWING SAMPLE COMMANDS CAN BE ISSUED: . RDEF FACILITY CCF.OPTJOB* UACC(NONE) OWNER(XXXXXXXX) SETR REFRESH RACLIST(FACILITY) PE CCF.OPTJOB* CLASS(FACILITY) ACCESS(READ) GROUP(YYYYYYYY) . NOTE: FOR THE JOB OPTIONS PANEL, SECURITY CAN BE SPECIFIED AT THE JOB NAME LEVEL AS WELL. EXAMPLES: RDEF FACILITY CCF.OPTJOB.XYZJOBNM UACC(NONE) OWNER(XXXXXXXX) . THE USER'S GUIDE NEEDS THE FOLLOWING SECTION ADDED: +++++++++++++++++++++++++++++++++++++++++++++++++++ . SPECIFYING CCF OPTIONS IN BATCH: . OPTIONS CAN BE SPECIFIED DIRECTLY IN THE BATCH JCL (OVERRIDING ANY OPTIONS SPECIFIED IN THE VSAM OPTIONS DATA SET) BY ADDING A "//CCFOPTS DD" STATEMENT REFERENCING AN INPUT DATA SET DEFINED AS RECFM=FB, LRECL=80. THE FOLLOWING OPTIONS CAN BE OVERRIDDEN: . DDNINP= A 1-9 CHARACTER DDNAME WHICH CCF USES TO READ IN THE IMS COMMANDS. . DDNOUT= A 1-8 CHARACTER DDNAME WHICH CCF USES TO WRITE ALL OUTPUT RETURNED DURING CCF COMMAND PROCESSING. . RETRYATT= A DECIMAL NUMBER FOR THE NUMBER OF TIMES A DATABASE COMMAND SHOULD BE ATTEMPTED. . RETRYSEC= A DECIMAL NUMBER FOR THE NUMBER OF SECONDS BETWEEN EVERY RETRY ATTEMPT. . ABEND= A DECIMAL USER ABEND CODE (FROM 0-4095) ISSUED AT THE END OF THE JOB STEP IN CASE ERRORS ARE DETECTED DURING CCF PROCESSING. . SETRC= A DECIMAL RETURN CODE ISSUED AT THE END OF THE JOB STEP IN CASE ERRORS ARE DETECTED DURING CCF PROCESSING. . DFS0488I= A STRING OF UP TO 20 2-DIGIT PAIRS OF ACCEPTABLE DFS0488I RETURN CODES AFTER A DATABASE COMMAND HAS BEEN ATTEMPTED. . DBRC=ABEND DBRC=SETRC DBRC=WTOR DBRC=NODBRC SPECIFY ONE OF THE ABOVE ACTIONS TO BE TAKEN IN THE EVENT A DBRC FAILURE OCCURS. . APPC=ABEND APPC=SETRC APPC=WTOR APPC=IGNORE SPECIFY ONE OF THE ABOVE ACTIONS TO BE TAKEN IN THE EVENT A APPC FAILURE OCCURS. . ERR488=ABEND ERR488=SETRC ERR488=WTOR ERR488=IGNORE SPECIFY ONE OF THE ABOVE ACTIONS TO BE TAKEN IN THE EVENT AN UNACCEPTABLE DFS0488I RETURN CODE HAS BEEN RETURNED. . GENERAL=ABEND GENERAL=SETRC GENERAL=WTOR GENERAL=IGNORE SPECIFY ONE OF THE ABOVE ACTIONS TO BE TAKEN IN THE EVENT ANY OTHER ERROR CONDITION HAS OCCURRED. . DBACCESS=SYSGEN DBACCESS=DBRC DBACCESS=ASIS SPECIFY ONE OF THE ABOVE METHODS USED BY CCF TO ISSUE A DATABASE COMMAND WITH THE CORRECT ACCESS SUBPARAMETER. . WTODBCMD= SPECIFY 'YES' OR 'NO' WHETHER ALL DATABASE RELATED COMMANDS SHOULD BE DISPLAYED IN THE SYSLOG. . . THE USER'S GUIDE SECTION NAMED 'ISSUING COMMANDS USING THE ISPF INTERFACE' FOR THE COMMAND: SUBHEADING NEEDS TO BE CHANGED AS FOLLOWS: +++++++++++++++++++++++++++++++++++++++++++++++++++ . COMMAND: SPECIFY THE IMS COMMAND OR TO EXECUTE A LIST OF COMMANDS STORED IN A DATA SET, SPECIFY A FULLY QUALIFIED DATA SET NAME PREFIXED WITH /DSN=. . . THE USER'S GUIDE NEEDS THE FOLLOWING SECTION ADDED: +++++++++++++++++++++++++++++++++++++++++++++++++++ COMMAND STORE/FORWARD (OVERVIEW) . COMMAND STORE/FORWARD (CSF) IS A FEATURE THAT IS USED TO SAVE COMMANDS THAT FAIL DUE TO AN IMS REGION BEING STOPPED, AND THEN EXECUTE THE SAVED COMMANDS WHEN THE IMS REGION IS STARTED. COMMAND STORE/FORWARD IS USED IN AN IMS PLEX TO ENSURE RESOURCES ARE IN THE SAME STATE (I.E. STOPPED, STARTED, ETC.) ACROSS ALL MEMBERS OF THE PLEX. .
Local fix
Problem summary
**************************************************************** * USERS AFFECTED: 1) ANY COMMAND CONTROL FACILITY USER WANTING * * TO USE COMMAND STORE/FORWARD OPTION. * * 2) ALL CCF ISPF INTERFACE USERS WISHING TO * * ADD RACF-BASED SECURITY TO THE VARIOUS ISPF * * DIALOG OPTIONS. * * 3) ALL CCF USERS CHANGING DATA BASE ACCESS * * TO RD AND USING DBRC TO ENSURE THE DATA BASE * * IS NOT OPENED FOR UPDATE. * * 4) ALL CCF USERS WISHING TO EXECUTE A LIST * * OF IMS COMMANDS STORED IN A DATA SET. * **************************************************************** * PROBLEM DESCRIPTION: 1) IMS COMMAND CHARACTERS SPECIFIED * * AFTER A PERIOD ARE BEING TRUNCATED EVEN * * IF THEY ARE BEING SPECIFIED WITHIN * * SINGLE QUOTES. * * 2) IMS INFORMATION BROWSE PANEL ALLOWS * * SOME FIELDS TO BE MODIFIABLE THAT * * INSTEAD SHOULD BE DISPLAY-ONLY. * * 3) WHEN CHANGING A DATA BASE ACCESS TO * * RD AND USING DBRC TO ENSURE THE DATA * * BASE IS NOT OPEN FOR UPDATE ON ANY * * SYSTEM, CCF IS USING THE WRONG AUTH- * * STATE VALUE. * * 4) IN THE EVENT THAT A TSO/ISPF CCF * * SESSION HANGS WHILE WAITING FOR A * * RESPONSE FROM APPC, THE SESSION SHOULD * * TIME OUT INSTEAD OF FORCING AN OPERATOR * * TO TEMINATE THE TSO SESSION. * **************************************************************** * RECOMMENDATION: INSTALL CORRECTIVE SERVICE FOR APAR/PTF * **************************************************************** IMS COMMAND CHARACTERS SPECIFIED AFTER A PERIOD ARE BEING TRUNCATED EVEN IF THEY ARE SPECIFIED WITHIN SINGLE QUOTES. THIS PROBLEM, AS WELL AS SEVERAL OTHERS, ARE BEING ADDRESSED IN THIS APAR. ALSO, MESSAGE CCF0374I HAS BEEN MODIFIED. SEVERAL NEW MESSAGES HAVE ALSO BEEN ADDED AND THE USERS GUIDE WILL BE UPDATED.
Problem conclusion
THERE ARE SEVERAL PROBLEMS WHICH HAVE BEEN CORRECTED IN THIS APAR, AS WELL AS NEW MESSAGES ADDED AND DOCUMENTATION CHANGES. THESE CHANGES AGE TOO LENGTHY FOR THIS FILE AND WILL BE INCLUDED IN THE ++HOLD INFORMATION. A COMMAND STORE/FORWARD OPTION HAS BEEN ADDED. IF AN IMS IS BELIEVED TO BE STOPPED (APPC ERRORS), COMMANDS WILL BE SAVED IN A VSAM DATA SET AND RETRIED AT IMS START. RACF-BASED SECURITY FOR THE VARIOUS CCF ISPF DIALOG OPTIONS WAS ADDED. THE CCF INTERFACE IS BEING CHANGED TO USE THE RACF FACILITY PROFILE VIA RACROUTE CALLS TO SECURE VARIOUS CCF ISPF ADMINISTRATIVE OPTIONS. CODE HAS BEEN MODIFIED SO THAT IN THE EVENT THAT A TSO/ISPF CCF SESSION HANGS WHILE WAITING FOR A RESPONSE FROM APPC, THE SESSION WILL NOW TIME OUT INSTEAD OF FORCING AN OPERATOR TO TERMINATE THE TSO SESSION. THE ISPF COMMAND INTERFACE HAS BEEN MODIFIED TO EXECUTE A LIST OF IMS COMMANDS STORED IN A DATA SET. THE PRINTED BATCH CCF JOB OPTIONS HAVE BEEN MOVED FROM DDNAME CCFLIST TO DDNAME CCFJOPRT SO THAT ONLY COMMANDS AND RESPONSES ARE DISPLAYED. MESSAGE CCF0374I HAS BEEN CHANGED FROM: CCF0374I - ALL DATA BASES NOT ALLOCATED OR AT HELD AUTH STATE < 3. THE MESSAGE NOW READS AS: CCF0374I - ALL DATA BASES NOT ALLOCATED OR AT HELD AUTH STATE < 5.
Temporary fix
Comments
APAR Information
APAR number
PQ70674
Reported component name
IMS COMMAND CTL
Reported component ID
5655F4000
Reported release
110
Status
CLOSED PER
PE
NoPE
HIPER
NoHIPER
Special Attention
NoSpecatt / Xsystem
Submitted date
2003-02-05
Closed date
2003-03-05
Last modified date
2003-04-03
APAR is sysrouted FROM one or more of the following:
APAR is sysrouted TO one or more of the following:
UQ74738
Modules/Macros
CCFAPPC0 CCFASMSF CCFBMP CCFCMD00 CCFDB510 CCFDB610 CCFDB710 CCFDB810 CCFEDIT0 CCFEXEC0 CCFINIT0 CCFMASK8 CCFMBLKX CCFMD510 CCFMD610 CCFMD710 CCFMD810 CCFOPRT0 CCFOPTS0 CCFPCHST CCFPCMD CCFPUOPS CCFP300 CCFREDO0 CCFSTF CCFUODI0 CCF9ATB0 CCF9A630 CCF9CMD0 CCF9GBL0 CCF9IMS0 CCF9JOB0 CCF9PLX0 H24E110J
| SC27116801 |
Fix information
Fixed component name
IMS COMMAND CTL
Fixed component ID
5655F4000
Applicable component levels
R110 PSY UQ74738
UP03/03/07 P F303
Fix is available
Select the PTF appropriate for your component level. You will be required to sign in. Distribution on physical media is not available in all countries.
[{"Line of Business":{"code":null,"label":null},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSCBTY6","label":"IMS Command Control Facility"},"Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"110"}]
Document Information
Modified date:
21 October 2020