CAIRIM Verification Utilities

CAIRIM includes utilities of CAIRIMU, CAISMFU, and CAISUBU that verify the initialization of your resources.
ccsfzos15
Resource Initialization Manager (CAIRIM) includes the following utilities. These utilities let you verify the initialization of your resources as follows:
  • CAIRIMU
    The Resource Initialization Manager Utility displays the status of all modules that are initialized by CAIRIM.
  • CAISMFU
    The Interceptor Utility displays the status of the system management facility (SMF) exits that CAIRM installs.
  • CAISUBU
    The Subsystem Utility displays the status of the subsystems that CAIRM installs.
Execute the CAIRIM utilities in one of the following ways:
  • As a batch job
    The CAW0JCL data set contains the sample JCL members for invoking each utility from a batch job.
  • As a started task
    The CAW0PROC data set contains the sample members.
  • From a TSO CLIST
    The sample CLISTS are provided in the CAI.CAW0CLS0 utilizing LIBDEF.
When you execute the utilities as started tasks or batch jobs, the output is write-to-operator (WTO) messages. These WTO messages are sent to the system console or to the batch job log. In TSO, messages are sent directly to the TSO session for the user.
CAIRIMU Utility
The Resource Initialization Manager Utility, CAIRIMU, lists the following information:
  • Product or component name
  • Version
  • Level
  • Result of each initialization routine in the form of date, time, and success or failure, based on the return code
By executing this utility, you can determine which products and components have been initialized.
Example: Typical output
Generally, CAIRIMU has the following output:
CAS9006I THE FOLLOWING PRODUCTS HAVE BEEN INITIALIZED: CAS9002I CAS9007I PRODUCT VERS INIT DATE/TIME CAS9008I
product version init date time
. . . CAS9009I INITIALIZED FROM
loadlib
CAS9002I CAS9010I NUMBER OF INTERFACES:
nn
Example: Possible error
The following message indicates a possible error:
CAS9011I NO CAI PRODUCT INTERFACES PRESENT
If CAIRIM is not expected to initialize any products upon startup, this message does not indicate an error.
If one or more of your products require CAIRIM initialization, this message indicates that CAIRIM has not been run. Or, CAIRIM has encountered a problem before initializing any products. After correcting any problems, run or rerun CAIRIM.
Example: CA LMP output
If CA LMP has encountered problems, CAIRIMU can display the following output:
CAS9012A
nnnn
License warnings/violations on CPU
@@@@@@
CAS9013A Product
%%
expired and is still in use.
This output means that CAIRIM has initialized the product, but CA LMP noted a warning or violation. The product is permitted to run. If you do not correct the problem, messages are issued. For more information, contact
Broadcom Support
.
CAIRIMU PROD Parameter (Optional)
You can use the optional PROD parameter with the CAIRIMU command to view detailed licensing information about your installed CA products.
This parameter has the following format:
CAIRIMU PROD[
V
][(
xx
-
yy
)]
  • V
    Designates that the generated list contains only those products that are in violation or that are approaching the product expiration date.
  • xx
    and
    yy
    Designates the product range.
Example: Display all products
To display extended usage/status information for all products, use the PROD parameter by itself.
CAIRIMU
PROD
Example: Display a single product
To display extended usage/status information for a single product, enter the PROD parameter with one product in the range. This example displays information for product A1.
CAIRIMU
PROD
(
A1
)
Example: Display a product range that is in violation or near expiration
To display extended usage/status information for a product range, enter the PROD parameter with products in a range. This example shows products in the range A1 through A9 that are in violation or are near expiration.
CAIRIMU
PRODV
(
A1
-
A9
)
CAISMFU Utility
The Interceptor Utility, CAISMFU, displays the status of the SMF exits that are installed by CAIRIM. The display includes the following information:
  • The product that is associated with the SMF module
  • The version of the module
  • The name of the module
  • The purpose of the module
  • The status of the module
Example: Typical output
Generally, CAISMFU has the following output:
CAS9001I INTERFACE SUMMARY: CAS9002I CAS9003I NAME VERS DESCRIPTION STATUS CAS9004I
pgmname caid caidesc caistat
CAS9002I CAS9005I NUMBER OF INTERFACES:
nn
NUMBER OF CALLS PROCESSED:
nn
Example: Possible error
The following message indicates a possible error:
CAS9011I NO CAI PRODUCT INTERFACES PRESENT
If none of your products install SMF exits using CAIRIM, this message does not indicate an error.
If one or more of your products install SMF exits using CAIRIM, this message indicates that CAIRIM has not been run or has encountered a problem. Run or rerun CAIRIM. If the problem persists, contact
Broadcom Support
.
CAISUBU Utility
The Subsystem Utility, CAISUBU, lets you display the status of the subsystems that CAIRIM installed. The utility verifies the following information:
  • The status of the subsystems
  • Their subsystem control table address
  • Their program initialization programs, if any
The status display includes the following information:
  • The four-character subsystem name
  • The SSCT address (of an internal z/OS data structure)
  • The subsystem status
  • The subsystem initialization program, if any
Example: Typical output
Generally, CAISUBU has the following output:
CAS9040I SUBSYSTEM SUMMARY: CAS9002I CAS9041I NAME SSCT ADDRESS STATUS INIT ROUTINE CAS9042I
subname @@@@@@@@ caistat initname
CAS9002I
Example: Possible error
If CAIRIM has not been run or has encountered a problem, the following output from CAIRIMU appears.
The following message indicates a possible error:
CAS9011I NO CAI PRODUCT INTERFACES PRESENT
If none of your products install subsystems using CAIRIM, this message does not indicate an error.
If one or more of your products install subsystems using CAIRIM, this message indicates that CAIRIM has not been run or has encountered a problem. Run or rerun CAIRIM. If the problem persists, contact
Broadcom Support
.