DISPLAY SELECT - USAP Command

Owned by Stonebranch
Feb 06, 2023
2 min read

Description

The DISPLAY SELECT command displays a variety of attributes for a list of SAP jobs that match the specified criteria.

Command Line Syntax

The following figure illustrates the command line syntax of the DISPLAY SELECT command, using the command line, long form of its configuration options.

-display select -jobname jobmask
    [-jobid idmask]
    [-selusername userid]
    [-fromdate date]
    [-todate date]
    [-fromtime time]
    [-totime time]
    [-nodate {yes|no}]
    [-withpred {yes|no}]
    [-released {yes|no}]
    [-scheduled {yes|no}]
    [-ready {yes|no}]
    [-running {yes|no}}]
    [-finished {yes|no}]
    [-aborted {yes|no}]
    [-output output-field-list]

Command Argument

The DISPLAY SELECT command can be expressed as either:

  • -D (Short form)
  • -display (Long form)

The DISPLAY SELECT command argument, select, requests the display of all jobs matching the jobmask and any additional selection criteria specified. The default output for this command is the job name and job ID for each job found. However, additional fields can be printed using the -output option.

Note

This command is not available on SAP 3.1 and SAP 4.0 systems.

Configuration Options

The following table describes all DISPLAY SELECT configuration options and provides the command line, long form of each option illustrated in the DISPLAY SELECT command line syntax, above.

Configuration
Option Name

Command Line
Long Form

Description

FROM_DATE

-fromdate

Earliest date to use for job selection or syslog request.

FROM_TIME

-fromtime

Earliest time to use for job selection or syslog request.

JOB_ID

-jobid

Job ID of an existing SAP job to use as a model for the new job definition.

JOB_NAME

-jobname

Name of an existing SAP job to use as a model for the new job definition.

NO_START_DATE

-nodate

Specification for whether or not to include jobs with no start date in selection criteria.

OUTPUT_FIELD_LIST

-output

Additional fields to write for the select command.

STATUS_ABORTED

-aborted

Specification for whether or not to include jobs with status aborted in selection criteria.

STATUS_FINISHED

-finished

Specification for whether or not to include jobs with status finished in selection criteria.

STATUS_READY

-ready

Specification for whether or not to include jobs with status ready in selection criteria.

STATUS_RELEASED

-released

Specification for whether or not to include jobs with status released in selection criteria.

STATUS_RUNNING

-running

Specification for whether or not to include jobs with status running in selection criteria.

STATUS_SCHEDULED

-scheduled

Specification for whether or not to include jobs with status scheduled in selection criteria.

TO_DATE

-todate

Latest date to use for job selection or syslog request.

TO_TIME

-totime

Latest time to use for job selection or syslog request.

USER_NAME

-selusername

User ID associated with a job.

WITH_PREDECESSOR

-withpred

Specification for whether or not to include jobs with start after predecessor in selection criteria.