Parameters

Work_area

The name of a 1024-byte work area for SAF and RACF® usage. The work area must be in the primary address space.

ALET

The name of a word containing the ALET for the following parameter. Each parameter must have an ALET specified. Each ALET can be different. The words containing the ALETs must be in the primary address space.

SAF_return_code

The name of a full word in which the SAF router returns the SAF return code.

RACF_return_code

The name of a fullword in which the service routine stores the return code.

RACF_reason_code

The name of a fullword in which the service routine stores the reason code.

Function_code

The name of a 1-byte area containing the function code:

X'01': Retrieve DCE fields
X'02': Replace DCE fields

RACF_userid

The name of a 9-byte area, containing a 1-byte length field, followed by a user ID up to eight characters long. It must be specified in uppercase.

Field_list

The name of an area containing the fields to be replaced or retrieved. The format of the parameter list is:

Offset	Length	Description
0	2	The length in bytes of the DCE field list
2	2	Total number of fields in the DCE field list
4	8	The name of the field
12	2	The length of the field data
14	variable	Field data

The ordered triplet (name of the field, length of the field, and field data) is a repeating data structure. This triplet can repeat for the total number of fields in the input Field_list.

If the function code is X'01' (retrieve DCE fields), the caller is expected to provide the following fields in the Field_list:
- The total length in bytes of the input field list
- The total number of fields to be retrieved
- The name of the fields to be retrieved
- The length of the data
  Note:
  For the retrieve function, there is no input field data. The caller is expected to provide a length of binary zero.
  
  The name of the field and the place holder of zero may repeat for the total number of fields to be retrieved.
If the function code is X'02' (replace DCE fields), the caller is expected to be in supervisor state and to provide the following fields in the Field_list:
- The total length in bytes of the input field list
- The total number of fields to be retrieved
- The name of the field to be retrieved
- The length of the data
- Field data
A problem-state caller is not authorized to replace DCE information.

Output_area: The name of an area that contains the fields obtained by the R_dceinfo service when the function code is X'01' (Retrieve DCE fields). The format of the output area is:

Offset	Length	Description
0	2	Total length of the output area of the retrieved data
2	2	Number of fields retrieved
4	8	Name of the retrieved field
12	2	Length of the retrieved field
14	variable	Field data

The ordered triplet (name of the field, length of the field, and field data) is a repeating data structure. This triplet can repeat for the number of times shown in the output_area 'number of fields retrieved' count.

Output_area_length: The name of a fullword that contains the length of the output_area that is supplied by the caller of this service.