Skip to Main Content
IBM Power Ideas Portal

This portal is to open public enhancement requests against IBM Power Systems products, including IBM i. To view all of your ideas submitted to IBM, create and manage groups of Ideas, or create an idea explicitly set to be either visible by all (public) or visible only to you and IBM (private), use the IBM Unified Ideas Portal (

Shape the future of IBM!

We invite you to shape the future of IBM, including product roadmaps, by submitting ideas that matter to you the most. Here's how it works:

Search existing ideas

Start by searching and reviewing ideas and requests to enhance a product or service. Take a look at ideas others have posted, and add a comment, vote, or subscribe to updates on them if they matter to you. If you can't find what you are looking for,

Post your ideas
  1. Post an idea.

  2. Get feedback from the IBM team and other customers to refine your idea.

  3. Follow the idea through the IBM Ideas process.

Specific links you will want to bookmark for future use

Welcome to the IBM Ideas Portal ( - Use this site to find out additional information and details about the IBM Ideas process and statuses.

IBM Unified Ideas Portal ( - Use this site to view all of your ideas, create new ideas for any IBM product, or search for ideas across all of IBM. - Use this email to suggest enhancements to the Ideas process or request help from IBM for submitting your Ideas.

Status Delivered
Workspace IBM i
Categories PowerHA
Created by Guest
Created on Sep 6, 2016

Improve API QYASRTVINF return field Copy Progress

Improve API QYASRTVINF to provide better information in the "Copy Progess" field of format YASH0400 OR provide detailed explanation about how to use a 1-byte character field to represent percentages. The current documentation does not explain how to use this field and describing a percentage field as a 1-byte character field is very unusual. This needs better explanation or changing the field to be a binary(4) type field or at least change to Char(8) as are the other fields next to it on the output spec (which is another discussion, why are numeric fields return as character?)

Use Case:

This API is used to return critical information about existing disk pools for monitoring and alerting purposes. Knowing the current percentage of progress would be a very helpful bit of information.

Idea priority Low
  • Guest
    Apr 10, 2019

    The PowerHA team believes that the request described has been solved and updated documentation will be available in future updates to the Knowledge Center. Supplemental information is provided below.

    The updated fields are as follows:
    Copy progress. The percent of synchronization complete between source and target. This character field contains the copy progress represented as one byte of binary data. A binary value of 0x01 would represent a copy progress of 1%, and a binary value of 0x64 represents a copy progress of 100% (hexadecimal 64 equivalent to decimal 100).

    Tracking space allocated. Indicates the number of bytes of auxiliary storage that are reserved for tracking changes in a geographic mirroring environment. The maximum assignable tracking space is one percent of the total space within an independent ASP. The allocated tracking space is used to track information about the changed data, not the changed data itself. A large amount of data can be tracked without requiring a large amount of tracking space. This 8 byte character field should be interpreted as an unsigned 8-byte binary field.

    Tracking space used. Indicates the number of bytes of auxiliary storage that is currently being used to track changes in a geographic mirroring environment. This 8 byte character field should be interpreted as an unsigned 8-byte binary field.

    In addition to the API, the following CL commands may be used for retrieving the same information:
    For ASP Sessions by using the RTVASPSSN command with the ASPCPY parameter
    For SVC Sessions by using the RTVSVCSSN command with the ASPCPY parameter
    For CSM Sessions by using the RTVCSMSSN command with the ASPSSNSTS parameter

  • Guest
    Jan 24, 2017

    IBM has received the requirement and is evaluating the possibility of enhancing the documentation for the QYASRTVINF API. IBM will provide a response after evaluation is complete.

  • Guest
    Sep 7, 2016

    Creating a new RFE based on Community RFE #94077 in product IBM i.