IBM Tivoli Monitoring, Version 6.3

tacmd listappinstallrecs

Description

Use the tacmd listappinstallrecs command to list the application support installation records. You can list the application support installation records specific to a monitoring server by product type or by version. You can choose to show records in an error state only and also to show detailed information. You must log in by using the tacmd login command before running the tacmd listappinstallrecs command.

The following list describes the State fields for this command:
Install Request (IR)
Indicates a product application request has been initiated.
Install Metadata (IM)
Indicates a product application request is in progress and copying JAR files.
Metadata Complete (MC)
Indicates when finishing copying the JAR files, extracting the JAR files, and autorefresh is complete.
Install Complete (IC)
Indicates when seeding has finished.
MetaData Error (ME)
Indicates a terminal SDA installation error has occurred. The tacmd listappinstallrecs command's STATUS codes, depicted in Table 1, indicate either a terminal error (STATE=ME) or a retryable condition other than for the STATE=ME value. All subsequent attempts at reinstalling this product and version will be blocked until further action is taken. To re-attempt the agent installation, clear the SDA error record containing the ME state code using the tacmd deleteappinstallrecs command. This command can be run immediately after the SDA installation failure, or after you contact IBM Support for assistance in correcting the installation problem.
Table 1. STATUS codes
Value Symbol (KFASDM_ST_*) Explanation
1001 RequestQueued = 1001 Indicates a request queued, waiting for async response.
1002 Shortage Indicates a memory shortage.
1003 BadArgument Indicates a bad input argument.
1004 KFASDM_ST_NotThere Indicates that a file was not found.
1005 SystemError Indicates an unknown system error.
1006 Duplicate Indicates that a request for same pc is already in progress.
1007 KT1_Error Indicates a KT1 error.
1008 SDM_Disabled Indicates that self-described processing is disabled at the monitoring server.
1009 HUB_NotThere Indicates that the hub monitoring server is not available.
1010 Shutdown Indicates that a monitoring server is shutting down.
1011 Manifest_Error Indicates invalid content in the manifest file.
1012 Wrong_TEMS_Version Indicates an incorrect monitoring server version.
1013 Nonsupportable_Feature Indicates a required feature (for example, a new data type) is not supported by the monitoring server.
1014 UnKnown_Error Indicates an unknown error.
1015 BadArgument_Length Indicates a bad input argument length.
1016 Manual_Install_Update Indicates a record updated by the manual installation detection process.
1017 Temp_Install_Error Indicates a temporary installation error; the agent retries the installation request.
1018 Refresh_Catalog_Error Indicates a TEMS Auto-refresh error in catalog cache processing.
1019 Refresh_Attribute_Error Indicates a TEMS Auto-refresh error in attribute cache processing
1020 Refresh_KFAOT_Error Indicates a TEMS Auto-refresh error in OTEA cache processing.
1021 Server_TimedOut Indicates that time expired at the RTEMS waiting for HUB SDA installation completion.
1022 SeedError Indicates that a TEMS SDA seeding error occurred.
1023 SDM_NotInitialized Indicates that a TEMS SDA was not properly initialized at TEMS startup.
1024 Install_Blocked Indicates that a product SDA installation was blocked by user control.

CLI syntax

tacmd listappinstallrecs  
                      [{-n|--temsname} SYSTEMS]  
                      [{-t|--type} PRODUCT_TYPE]  
                      [{-v|--version} PRODUCT_VERSION]  
                      [{-e|--errors}]  
                      [{-d|--details}]

where:
-n|--temsname
Specifies one or more monitoring server names where the records are retrieved. If this option is not specified, the records are retrieved from all found monitoring servers.
-t|--type
Specifies one or more managed system types (product codes) to be listed. Note that multiple product codes should be space-delimited. For example, UX NT LZ.
-v|--version
Specifies the product version of the records to be listed. PRODUCT_VERSION must be in the format XXXXXXXX (8 integers). For example, 06230000.
-e|--errors
Specifies showing records in error state only.
-d|--details
Shows a larger table with all the details of the installation records.

CLI example

The following example lists the application support installation records:
./tacmd listappinstallrecs

HUB/RTEMS PRODUCT VERSION  GRPID ID  IDVER SEEDSTATE STATE STATUS
RTEMS_1   A4      06300000 5655  TMS 06300000      0
RTEMS_1   HD      06300000 5655  TMS 06300000      0
RTEMS_1   UM      06230200 5655  TMS 06230200      0
The following example lists the application support installation records for the specified managed system type (UNIX):
./tacmd listappinstallrecs -t UX
HUB/RTEMS    PRODUCT VERSION  GRPID ID  IDVER SEEDSTATE STATE STATUS
HUB_TEMS     UX      06220200 5655  TMS 06220200              0
HUB_TEMS     UX      06230000 5655  TMS 06230000        MC    0
HUB_TEMS     UX      06230000 5655  TPS 06230000        IC    0
HUB_TEMS     UX      06230000 5655  TPW 06230000        IC    0
RTEMS_1      UX      06230000 5655  TMS 06230000        IC    0

Return values

See Table 1.

Related commands

tacmd addSdaInstallOptions

tacmd deleteappinstallrecs

tacmd deleteSdaInstallOptions

tacmd deleteSdaOptions

tacmd editSdaInstallOptions

tacmd editSdaOptions

tacmd listSdaInstallOptions

tacmd listSdaOptions

tacmd listSdaStatus

Return to Table 1.



Feedback