Using NGTDISP

This topic describes the syntax for specific examples of NGTDISP for displaying products. The other reports available with NGTDISP have few keywords and are self-explanatory.

Displaying the status of all products

To produce a report showing the status of all products, simply specify the NGTDISP keyword without any other keywords following it.

//SYSIN DD *
NGTDISP

Related topics

NGTDISP-command

Getting-started




Displaying the status of a single utility ID (UID)

To produce a report showing the status of a single utility ID (UID), use the UTIL keyword.

//SYSIN DD *
NGTDISP UTIL(BANKSTATMNTS)
NGTDISP UTIL(WILMINGTON49)
NGTDISP UTIL(CME18)

Displaying the status of utility IDs with a common naming pattern

You can check the status of a set of similarly-named utility IDs by using a naming pattern mask. You can use the wildcards % or *.

//SYSIN DD *
NGTDISP UTIL(SWREGION%)
NGTDISP UTIL(*A320)
NGTDISP UTIL(%STREORG%)

Displaying the status of only completed products

To produce a report showing the status of only completed products, specify the COMPLETED keyword (RC = 0).

//SYSIN DD *
NGTDISP COMPLETED

You can combine this keyword with the UTIL keyword to check for completed products with a common naming pattern, as in:

Example
//SYSIN DD *
NGTDISP UTIL(AMBACKUPS%) COMPLETED

Displaying the status of only products in error

To produce a report showing the status of only products that did not complete with a return code of 0 or 4, specify the ERROR keyword.

//SYSIN DD *
NGTDISP ERROR

You can combine this keyword with the UTIL keyword to check for products in error with a common naming pattern.

Example
//SYSIN DD *
NGTDISP UTIL(COPIES909%) ERROR

Displaying the status of only restartable products

To produce a report showing the status of only restartable products, use the RESTARTABLE keyword.

//SYSIN DD *
NGTDISP RESTARTABLE

You can combine this keyword with the UTIL keyword to check for products in error with a common naming pattern.

Example
//SYSIN DD *
NGTDISP UTIL(TXREGION%) RESTARTABLE

Displaying the status of products currently running

You can run NGTDISP while products are active in other jobs. To produce a report showing the status of all active products, specify the ACTIVE keyword.

//SYSIN DD *
NGTDISP ACTIVE

You can combine this keyword with the UTIL keyword to check for active products with a common naming pattern.

Example
//SYSIN DD *
NGTDISP UTIL(COPYPACIF%) ACTIVE

You can also use the keyword RUNNING to display all running products.

Example
//SYSIN DD *
NGTDISP RUNNING

You can produce a list of all running products meeting a specific naming pattern:

Example
//SYSIN DD *
NGTDISP UTIL(%PETRO55) RUNNING

Important

The ACTIVE and RUNNING keywords are identical in meaning.

Displaying the status of products that have had QUICKEXIT used

Use the QE keyword to print the status of products that have had a QUICKEXIT run against them.

//SYSIN DD *
NGTDISP QE

You can combine this keyword with the UTIL keyword to check for products with a common naming pattern that have had a QUICKEXIT.

Example
//SYSIN DD *
NGTDISP UTIL(*BATCH*) QE

Displaying the status of products that have had QUICKEXIT used, but failed

You can use the QEFAILED keyword to print the status of products that have had a QUICKEXIT run against them, but which had a return code of greater than 4.

//SYSIN DD *
NGTDISP QEFAILED

You can combine this keyword with the UTIL keyword to check for products with a common naming pattern that have had a QUICKEXIT failure.

Example
//SYSIN DD *
NGTDISP UTIL(RRG%) QEFAILED

Displaying the status of all products that have been forced (FORCEID)

To produce a report showing the status of all products that have been forced to exit by use of the FORCEID parameter on the EXEC statement, use the FORCEID keyword.

Warning

Before restarting a BMC AMI Utility with FORCEID, always consult BMC Customer Support to avoid losing data if the product is in a must-complete state. 


//SYSIN DD *
NGTDISP FORCEID

The FORCEID keyword can be combined with the UTIL keyword to check for products with a common naming pattern that have had a forced exit.

Example
//SYSIN DD *
NGTDISP UTIL(HVY%) FORCEID


Displaying the work dataset qualifiers in the report 

The QUALIFIER/QUAL keyword can be combined with additional options for the NGTDISP command to display the work data set qualifiers in the NGTDISP report. 

Example
//SYSIN DD *
NGTDISP UTIL(HVY%) RESTARTABLE QUAL

Displaying the status of all products a certain number of days old

You can display the status of all products a certain number of days old by using the AGE parameter.

Examples

To check products that are at least a week old, or 7 days old, you would type:

//SYSIN DD *
NGTDISP AGE(7)

To check products that are at least a two weeks old, or 14 days old, you would type:

//SYSIN DD *
NGTDISP AGE(14)

The AGE keyword can be combined with the UTIL keyword to check for products with a common naming pattern that are of a certain age.

Example
//SYSIN DD *
NGTDISP UTIL(STM%) AGE(3)
NGTDISP UTIL(EEH%) AGE(5)
NGTDISP UTIL(DELIV%) AGE(21)

Displaying the status of products with multiple criteria

NGTDISP is very flexible. You can specify multiple criteria for printing products. Here are some examples combining more than two selection criteria.

Example
//SYSIN DD *
NGTDISP UTIL(R55%) QEFAILED AGE(7)

This example displays utility IDs starting with R55 for which the QUICKEXIT failed, and which are at least 7 days old.

Example
//SYSIN DD *
NGTDISP RUNNING RESTARTABLE COMPLETED

This example displays all utility IDs that are currently running, restartable, or completed.

Example

The previous example with a naming pattern would look like this:

//SYSIN DD *
NGTDISP UTIL(EASTC%) RUNNING RESTARTABLE COMPLETED

Displaying all entries from the BMCUTIL table

To produce a report showing all entries from the BMCUTIL table, simply specify the BMCUTIL keyword without any other keywords after it.

//SYSIN DD *
NGTDISP BMCUTIL

Displaying the status of utility IDs with a common naming pattern from the BMCUTIL table

To produce a report from the BMCUTIL table, specify the BMCUTIL keyword followed by the optional UID|UTILITY|UTILITYID keywords and the naming pattern mask.

//SYSIN DD *
NGTDISP BMCUTIL UID(%STREORG%)

Displaying all entries from the BMCSYNC table

To produce a report showing all entries from the BMCUTIL table, simply specify the BMCSYNC keyword without any other keywords following it.

//SYSIN DD *
NGTDISP BMCSYNC

Displaying the status of utility IDs with a common naming pattern from the BMCSYNC table

To produce a report from the BMCSYNC table, specify the BMCSYNC keyword followed by the optional UID|UTILITY|UTILITYID keywords and the naming pattern mask.

//SYSIN DD *
NGTDISP BMCSYNC UID(%STREORG%)

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*