Convert Authority Values to MI Value (QSYCVTA) API

Required Parameter Group:

1	Converted authority value	Output	Char(2)
2	Authority special value	Input	Char(*)
3	Number of authorities	Input	Binary(4)
4	Error code	I/O	Char(*)

Default Public Authority: *USE

Threadsafe: No

The Convert Authority Values to MI Value (QSYCVTA) API converts the special values indicating authority to the corresponding machine interface (MI) representation of that value.

Required Parameter Group

Converted authority value

OUTPUT; CHAR(2)

The MI representation of the authority special value in hexadecimal format.

Authority special value

INPUT; CHAR(*)

The authority special values that are converted. The converted value is the cumulative value of all authority special values specified. This parameter can contain up to eleven 10-character fields. Each of the 10-character fields can contain one of the following special values. The following identifies the authority special values that are converted to the corresponding MI representation of that value.

*ADD	Add authority.
*ALL	All authority.
*AUTL	Authorization list authority. If this value is specified, no other values can specified. This authority value is only valid for *PUBLIC authority on an object secured by an authorization list.
*AUTLMGT	Authorization list management authority.
*CHANGE	Change authority.
*DLT	Delete authority.
*EXECUTE	Execute authority.
*EXCLUDE	Exclude authority. If this value is specified, no other values can be specified.
*OBJALTER	Object alter authority.
*OBJEXIST	Object existence authority.
*OBJMGT	Object management authority.
*OBJOPR	Object operational authority.
*OBJREF	Object reference authority.
*READ	Read authority.
*UPD	Update authority.
*USE	Use authority.

Number of authorities

INPUT; BINARY(4)

The number of authority special values specified in the authority special value parameter. You can specify 1 through 11.

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

Message ID	Error Message Text
CPF22FA E	Authority value &1 not valid.
CPF22FB E	Must specify EXCLUDE or AUTL as only authority value.
CPF22F7 E	Number of authorities must be between 1 and &1.
CPF3C90 E	Literal value cannot be changed.
CPF3CF1 E	Error code parameter not valid.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.

Message ID

Error Message Text

CPF22FA E

Authority value &1 not valid.

CPF22FB E

Must specify *EXCLUDE or *AUTL as only authority value.

CPF22F7 E

Number of authorities must be between 1 and &1.

CPF3C90 E

Literal value cannot be changed.

CPF3CF1 E

Error code parameter not valid.

CPF9872 E

Program or service program &1 in library &2 ended. Reason code &3.