# HSM Requests

The HSM Requests attributes provide detailed information about the current and queued requests for HSM functions, such as data sets queued for recall.

Aggregate Group Name: The name of an HSM aggregate group to which this data set belongs.

An aggregate group is an SMS grouping of data sets where all data sets in the group have identical backup or recovery attributes (such as medium, retention period and destination).

You can define all data sets related to an application in an aggregate group so that they all can be treated alike and at the same time by SMS.

Dataset Name: The name of the data set for which a request has been made.

Function: The type of request. Each request type has a different queue. The types are as follows: Migration, Recall, Backup, Recovery, Delete, Vol_Recover, and Dump.

Function Index: The HSM function type to which this data row pertains.

HSM Host ID: The ID associated with this HSM host.

HSM Host Name: The name of HSM host associated with the request.

Managed System: The SMS name of this system.

Queue Time: The time that the request was queued.

Request Age: The number of minutes this request has waited to be serviced. A large number of queued requests or a large wait time can be caused by an insufficient number of tasks started of this function type, a high rate of requests or this function type being held.

Requesting Jobname: The name of the job/started task/TSOUSERID that submitted this request.

Request Number: The number assigned to this request. Requests are numbered in ascending sequence by DFHSM as they are received.

Request Status: The status of request. The request status defines the state of the request. The following states are valid:

- Queued = Request has been received and is waiting for higher priority requests to complete.
- Active = Request is currently being serviced.
- Abended = The request has completed unsuccessfully.
- Complete = The request has completed successfully.
- Cancelled = The request was cancelled before it completed.

Request Time: The time that DFHSM received this request.

Request Type: Denotes whether this request is for a specific volume or specific data set.

Request Volume: The specific DASD volume related to this request.

Requesting User ID: The user ID associated with this request.

User Waiting: Specifies whether this is a synchronous (waiting) or asynchronous (not waiting) request.