Skip to Content

SYSIN syntax option description

The following table describes the SYSIN options:

Keyword

Definition

NGTDISP

The statement identifier.

ACTIVE

Selects products that are currently executing.

AGE

Selects products older than the specified number of days.

COMPLETED

Selects products that have completed with a return code of 0.

FORCEID

Selects products for which a FORCEID has been run.

GENDELETES

Invokes the XSUTDISP automation control point to generate DELETE statements.

GENQE

Invokes the XSUTDISP automation control point to generate a QUICKEXIT.

MUSTCOMPLETE

Selects products that are in must complete status.

NOREPORT

Inhibits generation of report.

NORESTART

Selects products that have undergone a cleanup or failed before starting any work that can be restarted.

ORDER BY

Sorts the report by the specified field.

You can sort by:

  • UID
  • STATUS
  • STARTED
  • ENDED
  • JOBNAME

QE

Selects products where a QUICKEXIT has been run.

QEFAILED

Selects products where a QUICKEXIT has been run, but which completed with a return code of greater than 4.

QUALIFIER|QUAL

If specified, the work data set qualifiers are displayed in the NGTDISP report.

RESTARTABLE

Selects products that are not currently running and can be restarted with either RESTART or QUICKEXIT.

These include products that are in must complete status.

RPT

(default) Sends report results to the NGTDISP-DD-statements.

RUNNING

Identical to ACTIVE. Selects products that are currently executing.

TYPE(utilityType)

Use this keyword to filter the NGTDISP report by utility. For example, NGTDISP TYPE(LOAD) produces a report that only contains utility IDs for LOAD. The utility type can be a single name or a naming pattern using wildcards.

If no value is specified for TYPE, the NGTDISP report provides utility types for all utility IDs listed in the report. For a sample report, see NGTDISP-reports.

TERMBMCUTIL

If specified, any orphaned rows for the utility ID in the BMCUTIL and BMCSYNC tables are deleted. Verify you have the correct checkpoint data set by running a report before using this option.

UNMATCHEDUIDS

Searches for all incomplete utility IDs and displays all unmatched utility IDs in the system. Unmatched utility IDs are utility IDs that exist in either the BMCUTIL report or the checkpoint data set, but not in both.

The unmatched utility IDs appear in the following reports:

  • BMCUTIL UNMATCHEDUIDS report—displays a list of utility IDs that appear in the BMCUTIL report but not in the checkpoint data set
  • CHECKPOINT UNMATCHED report—displays a list of utility IDs that appear in the checkpoint data set but not in the BMCUTIL report

For a sample of both reports, see BMCUTIL-report.

If this keyword is coded with GENQE, BMC AMI Utilities call the XSUTDISP automation control point to generate FORCEID steps to remove the unmatched utility IDs.

UTIL

A utility ID, either a single name or a naming pattern using wildcards.

Related topics

NGTDISP-syntax-option-descriptions

NGTDISP-syntax-diagrams


 

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

BMC AMI Check for Db2 13.1