Update User Application Information (QsyUpdateUserApplicationInfo) API

 #include <qsyusrin.h>

 void QsyUpdateUserApplicationInfo
        (char           *User_profile,
         char           *Application_information_ID,
         int            *Length_of_application_information_ID,
         char           *Application_information,
         int            *Length_of_application_information,
         char           *First_valid_release,
         void           *Error_code);

The Update User Application Information (QsyUpdateUserApplicationInfo) API updates the specified application information for a user profile. The specified information is stored in an object that is saved and restored with the user profile.

The Change User Profile exit programs are not called from this API.

Authorities and Locks

If the user profile parameter is not *CURRENT or the user profile currently running, then the user profile that calls this API must have *SECADM special authority and *OBJMGT and *USE authorities to the user profile.

Required Parameter Group

User profile

INPUT; CHAR(10)

The user profile for which the application information will be updated. The special value *CURRENT may be specified to update application information for the user profile that calls this API.

Application information ID

INPUT; CHAR(*)

The ID for the application information entry to update. IBM-supplied application information IDs are named QIBM_ccc_name, where ccc is the component identifier. User-supplied application information IDs should not preface their application information ID with QIBM. User-supplied application information IDs should start with the company name to eliminate most problems that involve unique names. Application information IDs should use an underscore (_) to separate parts of the name. Also, IDs for related applications should start with the same name.

The first character of the application information ID must be one of the following:

A-Z	Uppercase A-Z

The remaining characters in the application information ID must be made up of the following characters:

A-Z	Uppercase A-Z
0-9	Digits 0-9
.	Period
_	Underscore

Length of application information ID

INPUT; BINARY(4)

The length of the application information ID that is specified in the application information ID parameter. The length of the application information ID must be a value from 1 to 200.

Application information

INPUT; CHAR(*)

The application information to be associated with the specified user profile.

Length of application information

INPUT; BINARY(4)

The length of the application information that is specified in the application information parameter. The length of the application information must be a value from 1 to 1700.

First valid release

INPUT; CHAR(6)

The first release that this application information is valid. This field is used to determine the earliest release this user application information is valid when saving a user profile to a previous release. If the user profile is saved to a release previous to the release specified in this field, this information will not be saved with the user profile information. This field must be in the format VxRxMx (for example, V5R3M0). The release specified must be V5R3M0 or greater.

Error code

I/O; CHAR(*)

The structure in which to return error information. For the format of the structure, see Error code parameter.

Error Messages

[ Back to top | User Application APIs | APIs by category ]