NOT programming interface information
NOT programming interface information

ERB2XDGS data reduction exit routines

The exit routine specified in the exit_name parameter of the ERB2XDGS service is invoked on each system to which the ERB2XDGS request was directed. The routine is assumed to have the following attributes:
Location:
JPA
State:
Problem
Key:
Any
Amode:
31
Rmode:
Any
Dispatchable unit mode:
Task
Address space control mode:
AR
Cross Memory Mode:
PASN=SASN=HASN
Serialization:
Enabled, unlocked
Type:
Reentrant, Refreshable

The exit is called by RMF™ as shown, with the parameters in the specified order.

Table 1. ERB2XDGS Exit Routine
Service call statement Parameters

CALL exit_name

(answer_area_addr
,answer_area_alet
,answer_area_length
,output_area_length
,input_data_address
,exit_parm
,exit_parm_length)

answer_area_addr
Specifies the address of the area where the exit routine may return the selected information. The area resides in a data space owned by the RMF address space.

Answer_area_addr is defined as pointer variable of length 4.

,answer_area_alet
Specifies the ALET of the answer area provided on the answer_area_addr parameter.

Answer_area_alet is defined as unsigned integer variable of length 4.

,answer_area_length
Specifies the length of the answer area provided on the answer_area_addr parameter. RMF provides an answer area in the length of the answer area the caller provided to ERB2XDGS, rounded to the next multiple of 4096. However, the data returned by the data reduction exit routine must fit into the answer area the caller provided to ERB2XDGS, including the common header and data headers created by RMF.

Answer_area_length is defined as unsigned integer variable of length 4.

,output_area_length
Specifies the length of the data that the exit routine provided. If this value is larger than answer_area_length, a return and reason code are set, indicating that the length of the answer area was not sufficient.

Output_area_length is defined as unsigned integer variable of length 4 and must be set by the exit routine.

,input_area_address
Specifies the address of the SMF record type 79 image in storage.

Input_area_address is defined as pointer variable of length 4.

,exit_parm
Specifies the parameter that has been provided for the exit routine by the caller of ERB2XDGS.

Exit_parm is defined as character variable of variable length.

,exit_parm_length
Specifies the length of the parameter string exit_parm that was passed to the exit routine.

Exit_parm_length is defined as unsigned integer variable of length 4.

End of NOT programming interface information
End of NOT programming interface information