A asap_utils

This appendix describes the options available in the asap_utils script.

Overview

This section contains information that applies to multiple asap_utils functions.

Using asap_utils

To run asap_utils:

  1. Type the following at the in the $ASAP_BASE directory:

    asap_utils [-d] [option]
    

    where:

    • [option] is the asap_utils option you want to invoke. For example, for Work Order Lock States option, you would type 6.

Note:

If any asap_utils command fails, diagnostic information can be found in the ASAP_home/DATA/logs/yyyymmdd/UTILITY.diag (where yyyymmdd is the year, month, and date of the logs) for the current date when the command was run. For more information about diagnostic files, see ASAP System Administrator's Guide.

Avoiding Unexpected Write Lock Errors

Some of the asap_utils functions acquire a memory write lock while they are running. If you use any of these functions in interactive mode, or pipe the output through the more or less utilities, the function will maintain the lock until execution is complete. This may affect other users of ASAP.

If you want to look at the results of the command at leisure, direct the output of the command to a file rather than using more or less. Avoid using these options in interactive mode, or ensure that you enter the options in a timely fashion.

You must not allow any of the following asap_utils options to run for a significant length of time:

Supported asap_utils Functions

This section describes each of the supported asap_utils functions.

SARM Utilities

1. Service Requests in DB

This lists the SRQs currently resident in the ASAP database. It details the order ID, status, priority, due date, parent order, batch group, etc.

2. In Proc Requests Summary

This lists the number of requests currently in progress in the ASAP database (this is determined to be orders in a Loading or In Progress state).

3. In Proc Requests Details

This lists details of any work orders currently in progress within the SARM.

4. Work Order Queue Summary

This details the number of orders in each of the SARM order queues and includes:

  • Ready Queue – Orders currently in progress.

  • Rollback Queue – Orders currently being rolled back.

  • Auto Held Queue – Orders that are being held by the SARM and not released for some reason.

5. Work Order Queue Details

This provides the order details of each order in the SARM work order queues. Such queues are global to the SARM.

6. Work Order Lock States

This lists the orders in progress and their respective lock states. Generally, an in progress order will have a local lock. Only in the high availability configuration will orders be remotely locked.

7. ASDL/NE Queue Summary

This is one of the most commonly used utilities. It provides summary details about each NE in the system including:

  • NE, technology and software load

  • NEP managing the NE

  • Current state of the NE Down, Connecting, Available, Maintenance, Disabled

  • Whether the throughput of the NE is throttled to the configured throughput value

  • The configured throughput value

  • Time estimate (sec.) for ASDL processing to that NE

  • Number of ASDLs pending to that NE (in a prioritized queue)

  • Number of ASDLs currently in progress, the number of connections open to that NE

  • The number of ASDLs waiting to be retried to that NE.

8. ASDL/NE Queue Details

This provides details about each ASDL in the Pending, In Progress and Retry ASDL queues for each NE in the system.

10. Enable/Disable Entire NE

This utility facilitates the enabling/disabling of an entire NE from the SARM perspective. If a NE is disabled, then the SARM will hold all ASDLs queued to that NE in the ASDL pending queue for that NE.

In general, a NE is disabled for administrative purposes. It must be manually enabled for ASDLs to be transmitted to the NEP managing the NE. The current status of a NE may be viewed using option 7, "ASDL/NE Queue Summary."

12. List NEs over Err Thresh

This option allows you to view any NE/ASDL combinations that have been automatically disabled after the consecutive error threshold for that NE/ASDL was exceeded. The error threshold for a NE and ASDL combination may be specified in the ASAP error threshold database table.

13. Enable NE/ASDL over Thresh

This option allows you to logically enable NE/ASDL combinations that were logically disabled by the error threshold mechanism.

18. Set NE instance throughput

This option allows you to set the NE instance throughput value, which controls the minimum time in milliseconds an ASDL/transaction takes on an NE. A value of 0 disables NE instance throughput.

NEP Utilities

60. Clear Alarms

This option allows you to enter an alarm code and a number of hours as parameters. Alarms matching the alarm code that are older than the number of hours specified are cleared.

Use "%" as a parameter to clear all alarms.

Technical Utilities

107. Change Server Diag Level

This option allows you to dynamically change the diagnostic level of an application server when it is running. For more information on diagnostic levels, see ASAP System Administrator's Guide.

This change only has effect as long as the server is running. Upon restart, it assumes the diagnostic level specified in the database configuration.

Unsupported asap_utils Functions

Table A-1 lists the unsupported asap_utils functions.

Table A-1 Unsupported asap_utils Functions

Unsupported asap_utils Functions Utilities

11. Resend Completed ASDLs

SARM

20. WO Stats

SARM

21. CSDL Stats

SARM

22. ASDL Stats

SARM

23. NE Stats

SARM

24. NE/ASDL Stats

SARM

30. List Device States

NEP

31. Enable/Disable NE Devices

NEP

32. Enable/Disable Screen Diags

NEP

33. Enable/Disable NE Line Diags

NEP

34. Capture NE VS Screen to File

NEP

35. Enable/Disable EDD Diags

NEP

36. List NE Loopback Information

NEP

37. Set NE Loopback

NEP

100. View Server Thread Listing

Technical

101. View Server Memory Statistics

Technical

102. View Server Memory Usage

Technical

103. Flush State Table Cache

Technical

104. View Server Thread Status

Technical

105. View Server Thread Sleep Status

Technical

106. Initiate Server DB Admin Proc

Technical

108. Change Server Diag Line Flush

Technical

109. Real-time System Monitoring

Technical

110. Print System Monitor Report

Technical

112. Load New Service Configuration into Cache

Technical

113. Load New NE Configuration into Cache

Technical

114. Change JNEP Java Interpreter Diagnostic Level

Technical

115. Analyze Service Model & NEP Configuration Refresh

Technical

116. Service Model & Configuration Refresh

Technical

117. List CSDL & ASDL version information and usage referencing

Technical