The messages described in this section are written to the CICS BAC audit log by the CICS® request server, or by the batch request utility if it services a command directly because the target CICS region is not available. Expressions such as "written by CICS BAC" , or similar, are used generically in the message explanations to mean either one of these two components. The DD name for the audit log is CBKLOG.
The CICS region and the batch request utility job step dynamically allocate the audit log, based on the audit log attributes in the CICS region properties. You can define, view, or alter the audit log attributes using the workstation administration client, opening the Region Properties window and selecting the Miscellaneous options tab.
CICS BAC is performing one of the following actions:
In all the above cases, the CICS BAC component displays the date and time of the request.
None
None
Audit log
CICS BAC has started processing, or has finished processing, a CICS BAC application list. listname shows the name of the application list being processed, and openstatus, enablestatus, and DSN show the values specified by the command.
None
None
Audit log
CICS BAC has started processing, or has finished processing, a CICS BAC application group. groupname shows the name of the application group being processed, and openstatus, enablestatus, and DSN show the values specified by the command.
None
None
Audit log
CICS BAC is processing a file state change request. A CBKxx8505I message can be written up to three times for each request, depending on the specific processing that takes place:
A file record in a CICS BAC control file can specify transactions and programs that are to be processed when a file request is being processed by a batch request utility command. If the file record does specify transactions and programs to be processed, the audit log can contain transaction ID and program name audit log records between the BEFORE and AFTER file audit log records, depending on the state changes requested.
seqnum is the command sequence number relative to one if the request is performed by the CICS BAC batch request utility. For all other cases, such as a CICS SPI request, seqnum is zero.
The various status fields (openstatus, enablestatus, and so on) contain various values depending on the type of record written (BEFORE, REQUESTED, or AFTER), and where the request is serviced (CICS BAC request server or CICS BAC batch request utility).
For BEFORE and AFTER log records, a question mark (?) status value means that CICS BAC does not know the status of the file at the time of the request. For example, if a batch request utility command is used to process a file newly defined to CICS BAC while the CICS region that owns the file is not active, CICS BAC is not able to determine the current status of the file. BEFORE and AFTER log records do not contain the processtransids or processprograms status indicators.
For REQUESTED log records, a blank status value means that the resource state change request did not attempt to change that particular state value.
The variables in the message text can have the following values:
None
None
Audit log
CICS BAC is processing a transient data queue state change request. A CBKxx8506I message can be written up to three times for each request, depending on the specific processing that takes place.
seqnum is the command sequence number relative to one if the request is performed by the CICS BAC batch request utility. For all other cases, such as a CICS SPI request, seqnum is zero.
The status fields openstatus and enablestatus contain various values depending on the type of record written (BEFORE, REQUESTED, or AFTER), and where the request is serviced (CICS BAC request server or CICS BAC batch request utility).
For BEFORE and AFTER log records, a question mark (?) status value means that CICS BAC does not know the status of the transient data queue at the time of the request. For example, if a batch request utility command is used to process a transient data queue newly defined to CICS BAC while the CICS region that owns the transient data queue is not active, CICS BAC is not able to determine the current status of the queue. BEFORE and AFTER log records do not contain the processtransids or processprograms status indicators.
For REQUESTED log records, a blank status value means that the resource state change request did not attempt to change that particular state value
The variables in the message text can have the following values:
None
None
Audit log
CICS BAC is processing a transaction ID state change request. A CBKxx8507I message can be written up to three times for each request, depending on the specific processing that takes place.
seqnum is the command sequence number relative to one if the request is performed by the CICS BAC batch request utility. For all other cases, such as a CICS SPI request, seqnum is zero.
The enablestatus field contains various values depending on the type of record written (BEFORE, REQUESTED, or AFTER), and where the request is serviced (CICS BAC request server or CICS BAC request utility).
For BEFORE log records, a question mark (?) status value means that CICS BAC does not know the status of the transaction ID at the time of the request. For example, if a batch request utility command is used to process a transaction ID newly defined to CICS BAC while the CICS region that owns the transaction ID is not active, CICS BAC is not able to determine the current status of the transaction ID.
Where the status is known, the value can be an E (enabled) or D (disabled).
None
None
Audit log
CICS BAC is processing a program state change request. A CBKxx8508I message can be written up to three times for each request, depending on the specific processing that takes place.
seqnum is the command sequence number relative to one if the request is performed by the CICS BAC batch request utility. For all other cases, such as a CICS SPI request, seqnum is zero.
For all types of record (BEFORE, REQUESTED, and AFTER) the enablestatus variable can be either E or D indicating that the program is either enabled or disabled. For BEFORE record types only, an enable status shown as a question mark (?) means that CICS BAC does not know the status of the program at the time of the request. For example, if a batch request utility command is used to process a program newly defined to CICS BAC while the CICS region that owns the program is not active, CICS BAC is not able to determine the current status of the transaction ID.
None
None
Audit log
CICS BAC is being started in the CICS region with CICSSTARTMODE parameter specified with a value of UPDATE.
With a start mode of UPDATE, CICS BAC does not set the state of any CICS resources. It does, however, update the resource records defined in the CICS BAC control file with the current state of the resource specified by resourcetype and resourcename.
None
None
Audit log
During CICS BAC startup processing in a CICS region, CICS BAC has read a resource record where the last requested status of the resource is unknown. CICS BAC is unable to set the state of the resource.
This situation can occur if you add a resource object record to a CICS BAC region control file while the CICS region is not available. In this situation, CICS BAC is unable to determine the last state of the object.
None
None
Audit log
CICS BAC has received a request to change the state of a resource, but the resource is already at the requested state. CICS BAC leaves the state of the resource unchanged.
None
None
Audit log
The CICS BAC request server is processing a batch request utility command that specifies, either by the NEWDSN or DSN parameter, a change of data set name for file filename. However, filename is defined in the CICS region startup JCL and allocated to the CICS job my MVS, thus CICS BAC cannot change the data set name. You can change the name of a data set only when CICS files are dynamically allocated by CICS, and not when they are allocated by MVS during job step initiation.
This condition can also occur during CICS BAC startup processing if a request to change the data set name was processed directly in the CICS region control file, by the batch request utility, while the target CICS region was not available. The name change request is then detected during the next execution of CICS BAC startup processing. At this point, the CICS BAC startup processor can find that the name change is not allowed, and reject the request, as described above for the CICS BAC request server.
If this occurs as a result of a batch request utility command, the batch request utility job step terminates. If it occurs during CICS BAC startup processing, the data set name is not changed, and startup processing continues.
If this occurs as a result of a batch request utility command, correct the command and rerun the job step.
Audit log
CICS BAC is processing a batch request utility command that specifies a resource (resourcetype and resourcename) that is not defined to CICS.
CICS BAC also writes this audit log message if, during CICS BAC startup processing, it finds that the control file contains a resource that is not defined in the CICS region.
If CICS BAC writes this log record as a result of processing a batch request utility command, the batch request utility job step terminates with return code 12.
If CICS BAC writes this log record during CICS BAC startup processing, startup processing continues.
If CICS BAC writes this audit log message as a result of a batch request utility command, correct the command and rerun the job step.
Audit log
During CICS BAC startup processing in the CICS region, one or more invalid status values have been detected in the control file record for the resource named by resourcename. openstatus, enablestatus, addstatus, updatestatus , deletestatus, readstatus, browsestatus, and disposition give the hexadecimal value(s) of the status field(s) in error. A blank status field value means the value is not in error, or it is not relevant for the type of resource being processed. For example, the only relevant status field for programs and transaction ID's is enablestatus.
CICS BAC does not change the status of the object. Startup processing continues.
Contact technical support.
Audit log
CICS BAC has detected that there is no data set name for a file it is about to open. Because of the NODSN parameter value specified when CICS BAC was started in the CICS region, CICS BAC sets the data set name for the file to either the primary or alternate data set name specified in the CICS BAC control file record for the file. eibresp and eibresp2 give the resulting EIBRESP and EIBESP2 values in hexadecimal format for the EXEC CICS SET FILE command that set the data set name. enablestatus is the hexadecimal representation of the value used for the ENABLE parameter when the EXEC CICS SET FILE command was issued. The meaning of the numeric values can be found in Appendix A of the CICS System Programming Reference. . datasetname is the data set name that CICS BAC set for the file.
None
None
Audit log
CICS BAC has processed a batch request utility command that specifies a resource (resourcetype and resourcename) that is not defined in the CICS region control file. You have specified in the CICS region properties that unknown objects of this type are to be added to the control file.
CICS BAC adds a record for the object resourcetype and resourcename to the CICS region control file.
None
Audit log
CICS BAC has processed a batch request utility command that specifies a resource (resourcetype and resourcename) that is not defined in the CICS region control file. You have specified in the CICS region properties that unknown objects of this type are to be processed but not added to the control file. CICS BAC has processed the command, but has not added a record for the resource to the control file.
The command is processed.
None
Audit log
CICS BAC has processed a batch request utility command that specifies a resource ( resourcetype resourcename) that is not defined in the CICS region control file. You have specified in the CICS region properties that unknown objects of this type are not to be processed.
CICS BAC does not add a record for the resource to the control file. Further action taken depends on the CICS BAC region properties for the CICS region. The command can be ignored, in which case processing continues with the next command. Alternatively, the batch request utility job step can terminate.
Correct the problem and resubmit the batch request utility job step.
Audit log
During its startup processing in the CICS region, CICS BAC has determined that a file must be closed and disabled before it can set the file to its last requested state. This is because the file is currently open and enabled, or open and disabled, or closed and enabled. Even though the last requested state might be open and enabled, or closed and enabled, it must still be set to closed and disabled first for the change to be made. For example, if CICS BAC needs to change one or more of the file access attributes (such as READ, UPDATE, and ADD), CICS requires that a file must be closed and disabled before these attributes can be changed. Note that this message can occur only during CICS BAC startup processing.
Processing continues. The file will be temporarily set to CLOSED DISABLED before setting to its last requested state.
None
Audit log
CICS BAC displays the EXEC CICS SET FILE command issued by CICS BAC startup processing if a file must be temporarily closed or disabled to set it to its last requested state. filename provides the hexadecimal representation of the file name used for the SET FILE command. openstatus and enablestatus provide the OPENSTATUS and ENABLESTATUS values used for the SET FILE command. The meaning of the two numeric values can be found in Appendix A in the CICS System Programming Reference. For additional information on the circumstances that result in this message being displayed, see message CBKxx8528I.
Processing continues.
None
Audit log
CICS BAC has processed a batch request utility command that specifies a resource type that is not allowed for this region by the CICS BAC region properties defined in the CICS region control file.
CICS BAC action depends on the CICS BAC region properties for the CICS region. The command can be ignored, in which case processing continues with the next command. Alternatively, the batch request utility job step can terminate.
Correct the problem and resubmit the batch request utility job step.
Audit log
CICS BAC is attempting to process a batch request utility command that specifies one of the following actions for an indirect transient data queue.
You cannot use CICS BAC to open, close, enable, or disable indirect transient data queues.
Processing continues and CICS BAC processes any transaction IDs or programs associated with the transient data queue.
None
Audit log
CICS BAC is attempting to process a batch request utility command to open or close an intrapartition transient data queue. You cannot use CICS BAC to open or close intrapartition transient data queues.
Processing continues and CICS BAC processes any transaction IDs or programs associated with the transient data queue.
None
Audit log
CICS BAC is attempting to process a batch request utility command to open or close a remote transient data queue. You cannot use CICS BAC to open or close a remote transient data queues.
Processing continues and CICS BAC processes any transaction IDs or programs associated with the transient data queue.
None
Audit log
CICS BAC has received a command that is not allowed in this CICS region. The message includes either the transid or the program message variable, depending on the type of command, as follows:
CICS BAC rejects the command. Further action taken depends on the CICS BAC region properties for the CICS region. The command can be ignored, in which case processing continues with the next command. Alternatively, the batch request utility job step can terminate.
Correct the problem and resubmit the batch request utility job step.
Audit log
CICS BAC is attempting to process a batch request utility command to change the state of a remote file. You cannot use CICS BAC to change the state of remote files.
Processing continues and CICS BAC processes any transaction IDs or programs associated with the named file.
None
Audit log
CICS BAC has received a request from the CICS BAC batch request utility to change the state of a file defined as using record level sharing (RLS). The RLS option for this file is set to terminate or abend such requests.
Processing is terminated for the batch request utility job step. The job step is either terminated immediately or abended depending on the settings for the target file.
Determine whether or not this action is appropriate for your environment. Change the associated CICS BAC settings if a different CICS BAC action is required.
Audit log
CICS BAC is attempting to change the quiesce status for the data set associated with filename. The data set is currently in the quiescing transient state. CICS BAC must wait for the state to change from quiescing to some other state before it can process the request. After two seconds, CICS BAC checks the data set state again. It continues to do this until the data set state is no longer quiescing, or it has waited thirty times (approximately one minute).
If the data set state changes to something other than quiescing, CICS BAC continues to process the batch request utility request. If after waiting for two seconds thirty times, the data set quiesce state is still quiescing, the batch request utility job step is terminated with a condition code of twelve.
If the batch request utility job step is terminated because the data set quiesce state remained quiescing for too long, determine why the data set is in that state. If necessary, ensure that the state has changed from quiescing and rerun the batch request utility job step.
Audit log
The CICS BAC batch request utility is trying to process a LINK, START, or RUNCEMT command at a time when it is processing requests directly because CICS BAC is not active in the target CICS region, or because the CICS region is not running. Because it cannot pass the command to the target CICS region, it cannot process commands of the type LINK, START, and RUNCEMT.
The command is ignored and because the NOTACTIVE parameter specifies CONTINUE, batch request utility processing continues with the next command.
None
Audit log
The CICS BAC batch request utility is trying to process a LINK, START, or RUNCEMT command at a time when it is processing requests directly because CICS BAC is not active in the target CICS region, or because the CICS region is not running. Because it cannot pass the command to the target CICS region, CICS BAC cannot process commands of the type LINK, START, and RUNCEMT.
The command is ignored and because the NOTACTIVE parameter specifies TERMINATE, the batch request utility terminates.
None
Audit log
CICS BAC is attempting to process a file that is defined to CICS as using record level sharing (RLS). Either the data set associated with the file has been migrated, or RLS processing in the CICS region is not allowed (by the CICS SIT RLS parameter).
If the request is for CICS BAC startup processing, the file state is not changed and processing continues with the next object. If the request originated from the CICS BAC batch request utility, the batch request utility job step is immediately terminated with a condition code of twelve.
Call technical support if the cause of this problem cannot be determined and corrected.
Audit log
CICS BAC has exceeded its time limit for waiting for a data set to change from the quiescing state. See message CBKxx8539I for more information. This message is issued only when the file is defined in CICS as using record level sharing.
If the request is for CICS BAC startup processing, the file's state is not changed and processing continues with the next object. If the request originated from the CICS BAC batch request utility, the batch request utility job step is immediately terminated with a condition code of twelve.
If you cannot determine the cause of this problem and correct it, call technical support.
Audit log
The target resource of a CICS BAC batch request utility command is defined as excluded in the CICS region control file. The resource type is resourcetype and resource name is resourcename.
If the resource is defined as EXCLUDE and TERMINATE, or EXCLUDE and ABEND, CICS BAC either terminates with termination code (CC) or abends with the abend code (AC) as defined.
None
Audit log
During startup processing in the CICS region, CICS BAC has detected a resource that is defined as excluded in the CICS region control file. The resource type and resource name are resourcetype and resourcename.
The state of the resource is not changed, even if the CICS BAC control file contains a requested state different from the current state of the resource.
None
Audit log
CICS BAC has detected that a batch request utility command is attempting to open or close a file that is defined to CICS as RLSACCESS(YES). In order to process the command, CICS BAC might have to change the quiesce state of the data set associated with the file. The data set name associated with the file is dataset. The various quiesce states, given as Q (for quiesce) or U (for unquiese), are indicated by the message as follows:
None
None
Audit log
CICS BAC has determined that a data set dataset associated with a target file filename is defined as RLSACCESS(YES) and is currently at the quiesce state necessary for CICS BAC to perform the open or close request against the target file.
None
None
Audit log
While processing an RLS data set, a failure has occurred in CICS BAC on an EXEC CICS INQUIRE DSNAME or an EXEC CICS SET DSNAME command. The CICS EIBRESP eibresp and EIBRESP2 eibresp2 values indicate the cause of the error. For an explanation of these CICS SPI error codes, see the System Programming Reference.
Processing for the command terminates and CICS BAC does not process any further commands from the batch request utility. The batch request utility job step is terminated with return code 12.
Contact technical support if you cannot determine the reason for the failure and correct it.
Audit log
The CICS BAC request server is about to process a LINK, START, or RUNCEMT command. The message includes the transid, program, or termid message variable, depending on the type of command, as follows:
None
None
Audit log
The CICS BAC request server is processing a LINK, START, or RUNCEMT command and CICS has returned an error. The message includes the transid, program, or termid message variables, depending on the type of command, as follows:
For LINK and RUNCEMT commands, eibresp and eibresp2 are the EIB response codes returned from the EXEC CICS LINK command. For START commands, eibresp and eibresp2 are the EIB response codes returned from the EXEC CICS START command.
The batch request utility job step terminates with return code 12
Correct the problem and rerun the batch request utility job step.
Audit log
When CICS BAC issues an EXEC CICS SET FILE command during startup processing or while processing a batch request utility job step command, it writes this message to the CICS BAC audit log to document the command and the parameters used. filename is the hexadecimal representation of the name of the file for which the EXEC CICS SET FILE command is being issued. openstatus, enablestatus, and disposition are the values in decimal form for the parameters used with the command. The meaning of these values are given in Appendix A in the CICS System Programming Reference. This message is followed by message CBKxx8581I and, optionally, message CBKxx8582I to provide the remainder of the EXEC CICS SET FILE command parameter values.
Processing continues.
None
Audit log
When CICS BAC issues an EXEC CICS SET FILE command during startup processing or while processing a batch request utility job step command, it writes this message following message CBKxx8580I to the CICS BAC audit log to document the command and the parameters used. addstatus, updatestatus, deletestatus, readstatus, and browsestatus are the values in decimal form for the parameters used with the command. The meaning of these values are given in Appendix A in the CICS System Programming Reference. This message can be followed by message CBKxx8582I.
Processing continues.
None
Audit log
When CICS BAC issues an EXEC CICS SET FILE command during startup processing or while processing a batch request utility job step command, and the command contains the DSNAME parameter, it writes this message following message CBKxx8581I to the CICS BAC audit log to document the data set name used with the command.datasetname contains the hexadecimal representation of the DSNAME parameter value.
Processing continues.
None
Audit log
CICS BAC writes this message CBKxx8583I to the CICS BAC audit log when CICS BAC issues an EXEC CICS SET DSNAME command to change the quiesce state of a data set associated with a file being processed by CICS BAC. This can occur during CICS BAC startup processing in the CICS region, or when CICS BAC is processing a CICS BAC batch request utility command in the CICS region.datasetname contains the hexadecimal representation of the DSNAME parameter value. This message is followed by message CBKxx8584I.
Processing continues.
None
Audit log
This message CBKxx8584I follows message CBKxx8583I on the CICS BAC audit log when CICS BAC issues an EXEC CICS SET DSNAME command to change the quiesce state of a data set associated with a file being processed by CICS BAC. This can occur during CICS BAC startup processing in the CICS region, or when CICS BAC is processing a CICS BAC batch request utility command in the CICS region. quiescestate is the value in decimal form for the QUIESCESTATE parameter used with the command. The meaning of this value is given in Appendix A in the CICS System Programming Reference.
Processing continues.
None
Audit log
CICS BAC writes message CBKxx8585I to the CICS BAC audit log when CICS BAC issues an EXEC CICS SET TDQUEUE command to change the state of a transient data queue. This can occur during CICS BAC startup processing in the CICS region, or when CICS BAC is processing a CICS BAC batch request utility command in the CICS region. tdqname contains the hexadecimal representation of the transient data queue name being processed. openstatus and enablestatus are the values in decimal form for the OPENSTATUS and ENABLESTATUS parameters, respectively, used with the command. The meaning of these values are given in Appendix A in the CICS System Programming Reference.
Processing continues.
None
Audit log
CICS BAC writes message CBKxx8586I to the CICS BAC audit log when CICS BAC issues an EXEC CICS SET PROGRAM command to change the state of a program. This can occur during CICS BAC startup processing in the CICS region, or when CICS BAC is processing a CICS BAC batch request utility command in the CICS region. programname contains the hexadecimal representation of the program name being processed. enablestatus is the value in decimal form for the STATUS parameter used with the command. The meaning of this value is given in Appendix A in the CICS System Programming Reference.
Processing continues.
None
Audit log
CICS BAC writes message CBKxx8587I to the CICS BAC audit log when CICS BAC issues an EXEC CICS SET transaction command to change the state of a transaction ID. This can occur during CICS BAC startup processing in the CICS region, or when CICS BAC is processing a CICS BAC batch request utility command in the CICS region. transid contains the hexadecimal representation of the transaction ID being processed. enablestatus is the value in decimal form for the STATUS parameter used with the command. The meaning of this value is given in Appendix A in the CICS System Programming Reference.
Processing continues.
None
Audit log
CICS BAC is performing one of the following actions:
In all the above cases, the CICS BAC component displays the date and time of the request.
None
None
Audit log
CICS BAC startup processing is beginning in the CICS region. The type of startup is designated by the mode value as follows:
None
None
Audit log
CICS BAC is shutting down in the CICS region. The log record includes the transaction ID, terminal ID, and user ID (transid, termid, and userid) associated with the shutdown request. If the shutdown is taking place as a result of CICS going through shutdown PLT processing, the transaction ID is CPLT, the terminal id is blank, and the user ID is the default user ID for the CICS region.
None
None
Audit log
CICS BAC is linking to the pre-command user exit program exitpgmname.
None
None
Audit log
CICS BAC has detected an error when linking to the user exit program exitpgmname . The errors reported by CICS from the EXEC CICS LINK request are EIBRESP eibresp and EIBRESP2 eibresp2.
The batch request utility job step terminates immediately with return code 12.
Contact technical support if you cannot determine the reason for the failure and correct it.
Audit log
CICS BAC has detected an error when attempting to acquire storage for the commarea to be passed to the user exit program. The errors from the EXEC CICS GETMAIN request are EIBRESP eibresp and EIBRESP2 eibresp2 and the storage length requested in teh exit program is stglength.
The batch request utility job step terminates immediately with return code 12.
Contact technical support if you cannot determine the reason for the failure and correct it.
Audit log
CICS BAC has received a control back from the pre-command user exit program exitpgmname. returncode, abendcode, completioncode, and errortext contain the values returned by the user exit program.
The action taken depends on the value returned in returncode. Depending on the return code, processing could continue, the current command could be ignored, the job step could be terminated, or the job step could be abended.
None
Audit log
CICS BAC is linking to the post-command user exit program exitpgmname.
None
None
Audit log
The post-command user exit program exitpgmname has returned control to CICS BAC.
None
None
Audit log
CICS BAC has detected a severe error during startup processing while processing a resource, such as a file or a transient data queue.
Processing terminates for the resource, and continues with the next resource on the CICS BAC control file. CBKxx8990E can be followed by one or more CBKxx8997E messages to provide additional diagnostic data.
Contact technical support if you cannot determine the reason for the error and correct it.
Audit log
CBKxx8997E can follow message CBKxx8990E to provide additional diagnostic data when an error has been detected during CICS BAC startup processing in the CICS region.
Processing is terminated for the resource, and continues with the next resource on the CICS BAC control file. CBKxx8997E can be followed by one or more messages providing additional diagnostic data.
Contact technical support if the reason for the error cannot be determined and corrected.
Audit log
CBKxx8998E can follow message CBKxx8990E to provide additional diagnostic data when an error has been detected during CICS BAC startup processing in the CICS region.
Processing is terminated for the resource, and continues with the next resource on the CICS BAC control file. CBKxx8998E can be followed by one or more messages providing additional diagnostic data.
Contact technical support if the reason for the error cannot be determined and corrected.
Audit log
This message can follow message CBKxx8990E to provide additional diagnostic data when an error has been detected during CICS BAC startup processing in the CICS region.
Processing is terminated for the resource, and continues with the next resource on the CICS BAC control file.
Contact technical support if the reason for the error cannot be determined and corrected.
Audit log