Categories:

System functions (System Control)

SYSTEM$REQUEST_LISTING_AND_WAIT

Requests a listing and automatically polls for listing availability. To learn more about listings, see About sharing with listings.

Syntax

SYSTEM$REQUEST_LISTING_AND_WAIT( '<listing_global_name>' [ , <timeout_mins> ] )
Copy

Arguments

listing_global_name

The global name of the listing being requested.

timeout_mins

The time to wait for listing request fulfillment in minutes before timing out. The default is 240 minutes or 4 hours.

Returns

  • Returns Success: Listing <listing_global_name> is ready to be imported when a requested listing becomes available or is already available.

  • Returns Error: Timed out waiting for the listing to be available after <timeout_mins> min(s) when the specified timeout period is exceeded.

Usage notes

To request a listing without waiting for listing fulfillment, enter 0 (zero) for the timeout_mins value. When the value is 0 and the request is successful, the message Success: Listing <listing_global_name> requested successfully, but not waiting to confirm fulfillment is returned.

Examples

CALL SYSTEM$REQUEST_LISTING_AND_WAIT('GZ13Z1VEWIJ', 60);
Copy
Language: English