Updates to IMS Command Control Facility V2.2 User's Guide

The most recent updates appear at the top of the list.

---

Update 1
Date of change: May 2017
Change description: Documentation changes by APAR PI41074.
Topics: Chapter 13 – Callable API: REXX example

Invoking CCFCAPI0: REXX example
You can invoke CCFCAPI0 from a REXX procedure using the following example as a
model.

CCFCAPI0 expects the caller to pass the address of the IMS Command Control
Facility API interface block by using standard linkage conventions.

See member CCFAPIRX in SCCFMACS for the source below.





The above REXX procedure can be invoke from batch using the following sample
JCL as a model:



Change description: Documentation changes.
Topics: Correction in Chapter 6. Configuring the message log – Implementing the OM exit
6. Verify the implementation by reviewing IMS Command Control Facility
messages in the IMS Operations Manager z/OS log.
If implementation was successful, message CCF8406I should be present.

Change description: Documentation changes.
Topics: New messages

CCF7448E CSLOMCMD RECEIVED RC= return code RSN= reason code
Explanation: An error was encountered while
attempting a command using the CSLOMCMD call.
The return and reason codes are contained in rc and
rsn, respectively.
System action: Depending on the MODFAIL setting,
the job terminates with a user-defined return code or
user-defined abend code.
User response: The return and reason codes can be
found in the IMS Common Service Layer Guide and
Reference. Correct the reason for the failure and run the
job again.


CCF6032W DBRC=IGNORE IN EFFECT BECAUSE RECONS ARE NOT SHARED
Explanation: DBRC was selected. However this value
was overridden by the options module because the
Group record does not have the shared RECON flag set
to "Y".
System action: DBRC value is set to IGNORE..
User response: None.

CCF6033W DBRC BYPASSED - SYSPRINT/SYSIN DDNAMES SELECTED
Explanation: Either SYSPRINT or SYSIN is selected as
the DD name. The DBRC option is set to IGNORE.
System action: DBRC value is set to IGNORE.
User response: None.

CCF6034W DBRC BYPASSED - SYSPRINT/SYSIN JCL ALLOCATED
Explanation: Either SYSPRINT or SYSIN is JCL
allocated. The DBRC option is set to IGNORE.
System action: DBRC value is set to IGNORE.
User response: None.

CCF6035W DBRC BYPASSED - RESLIB IS NOT IN STEPLIB
Explanation: IMS RESLIB is not in the standard MVS
load library search order. The DBRC option is set to
IGNORE.
System action: DBRC value is set to IGNORE.
User response: None.

CCF6036W CCFOPTS "GROUP=" ALREADY SPECIFIED
Explanation: A GROUP= statement has already been
specified.
System action: The new specification attempt is
ignored.
User response: None.

CCF6037W CCFOPTS "IMSID=" ALREADY SPECIFIED
Explanation: An IMSID= statement has already been
specified.
System action: The new specification attempt is
ignored.
User response: None.

CCF6038E NO VALID IMSID/GROUP SPECIFIED
Explanation: An IMSID/GROUP was not specified as
required.
System action: User abend is issued.
User response: Provide a valid IMSID/GROUP.

CCF6039E SETRC= VALUE MUST BE NUMERIC BETWEEN 0-4095
Explanation: The SETRC= value must be a numeric
value between 0 and 4095.
System action: Processing continues with the default
value from the options module.
User response: Provide a valid SETRC= value.

CCF6040E ABEND= VALUE MUST BE NUMERIC BETWEEN 0-4095
Explanation: The ABEND= value must be a numeric
value between 0 and 4095.
System action: Processing continues with the default
value from the options module.
User response: Provide a valid ABEND= value.

CCF6041E RETRYATT= VALUE MUST BE NUMERIC BETWEEN 1-99
Explanation: The RETRYATT = value must be a
numeric value between 1 and 99.
System action: Processing continues with the default
value from the options module.
User response: Provide a valid RETRYATT = value.

CCF6042E RETRYSEC= VALUE MUST BE NUMERIC BETWEEN 1-999
Explanation: The RETRYSEC= value must be a
numeric value between 1 and 999.
System action: Processing continues with the default
value from the options module.
User response: Provide a valid RETRYSEC= value.

CCF6043E DFS0488I= VALUES (UP TO 20 2-DIGIT PAIRS) MUST BE NUMERIC
Explanation: The DFS0488I= values must be up to 20
two digit pairs.
System action: Processing continues with the default
values from the options module.
User response: Provide valid DFS0488I= values.

CCF6044E TIMEOUT= VALUE MUST BE NUMERIC BETWEEN 1-1440
Explanation: The TIMEOUT= value must be a
numeric value between 1-1440.
System action: Processing continues with the default
values from the options module.
User response: Provide a valid TIMEOUT== value.

CCF5042W COMMAND BYPASSED DUE TO PRIOR SCI CONNECT FAILURE
Explanation: Due to the failure of a previous attempt
to issue a type 2 IMS command, all type 2 IMS
commands are bypassed. The reason for the previous
failure is displayed in a previous message.
System action: The record is erased from the
store/forward data set and processing continues.
Unless a more severe error is encountered, the REDO
BMP sets a return code of 4 upon completion.
User response: No action is required.

CCF8406I CCF LOGSTREAM CONNECTED
Explanation: IMS Command Control Facility message
log initialization completed successfully.
System action: Processing continues.
User response: No action is required.

CCF8407I CCF WAITING FOR LOGSTREAM FORMATTING
Explanation: To complete log stream formatting, IMS
Command Control Facility is waiting for the
"LOGGING STARTED" message to be written to the log
stream.
System action: Processing continues.
User response: No action is required.

CCF8408I CCF WAITED n OF 240 SECONDS
Explanation: IMS Command Control Facility is
waiting for the completion of log stream formatting for
n seconds of 240 seconds.
To complete log stream formatting, IMS Command
Control Facility is waiting for the "LOGGING
STARTED" message to be written to the log stream.
System action: Processing continues.
User response: No action is required.

Change description: Documentation changes by APAR PI52200.
Topics: Chapter 8. Securing the options data set
Restricting access to using a CCF Group or IMS ID for issuing commands

Restricting access to using a CCF Group or IMS ID for issuing
commands
You can use RACF to define the entity name that restricts users from using an IMS
Command Control Facility Group or IMS subsystem ID from being the target of
any command issued through IMS Command Control Facility by issuing TSO
commands that are modeled on the following sample commands:
RDEF FACILITY CCF.EXEGRP.[CCFGroup|IMSID] UACC(NONE) OWNER(securitygroup)
and / or
RDEF FACILITY CCF.EXEGRP.* UACC(NONE) OWNER(securitygroup)
PE CCF.EXEGRP.[CCFGroup|IMSID] CLASS(FACILITY) ACCESS(READ) ID(ccfuserid|groupid)
SETR REFRESH RACLIST(FACILITY)


CCF6190E USE OF GROUP/IMSID NOT AUTHORIZED
Explanation: Use of the IMS Command Control
Facility Group or the IMS subsystem is not authorized.
System action: The command is not run.
User response: See your Security Administrator.

Change description: Documentation changes by APAR PI55363.
Topics: Chap 17 Group IMSID List panel - Group IMSID List
New field for Route=IMSplex (Y|N).

Group IMSID List
The Group IMSID List panel is displayed after entering one of the following
options from the Group List panel:
A - to add a IMS Command Control Facility group record
B - to browse a IMS Command Control Facility group record
C - to copy a IMS Command Control Facility group record
E - to edit a IMS Command Control Facility group record



The following information can be specified from the Group IMSID List panel.

Press the Enter key to save any changes before entering the END command to
return to the Primary Option Menu.



CCF7413I COMMAND BEING ROUTED TO type = name {PLEX = plexname}
Explanation: The following command is routed to
Operations Manager for processing.
The destination is designated by name and the type is
either a Group name or a specific IMSID.
If the Group members are in an IMSplex, then the
IMSplex name is shown.
System action: Processing continues.
User response: N/A